@rt-tools/agent-kit 0.2.0 → 0.4.0

package/lib/config.d.ts

@@ -1,6 +1,24 @@
 /** Род ресурса. Он же имя каталога в `assets/` пакета и ключ раскладки. */
-export type TKind = 'laws' | 'hooks' | 'checks' | 'agents' | 'templates';
+export type TKind = 'laws' | 'rules' | 'patterns' | 'skills' | 'hooks' | 'defaults' | 'checks' | 'agents' | 'commands' | 'workflows' | 'templates';
 export declare const KINDS: readonly TKind[];
+/**
+ * Роды, которые ложатся не файлом в каталог, а каталогом по имени ресурса: скил читается как
+ * `<имя>/SKILL.md`, и рядом с ним лежит то, что пишет проект.
+ *
+ * `skills` — скил, у которого нет закона над собой: он не про то, что должно быть верно в
+ * продукте, а про то, как здесь делается работа. Правилом его называть нельзя — тогда придётся
+ * выдумать ему закон, — а паттерном тем более: паттерн стоит при правиле.
+ */
+export declare const SKILL_KINDS: readonly TKind[];
+/** Имя файла скила: так его ищет агент, и другого имени у него быть не может. */
+export declare const SKILL_FILE: string;
+/**
+ * Файл-компаньон правила: чем названо в этом дереве то, о чём правило говорит приёмом.
+ *
+ * Пакет знает приём, но не знает ни путей, ни имён — их пишет проект. Черновик кладётся один
+ * раз и дальше не сверяется: это единственный файл раскладки, который принадлежит проекту.
+ */
+export declare const COMPANION_FILE: string;
 export interface IConfig {
     /** Значения дырок `{{имя}}`. */
     readonly vars: Readonly<Record<string, string>>;
@@ -11,11 +29,33 @@ export interface IConfig {
      * Ограничивает только те роды, которые сам называет; как именно — `isChosen`.
      */
     readonly only: readonly string[];
-    /** Ресурсы, от которых проект отказался, идентификаторами: `laws/money.md`. */
+    /** Ресурсы, от которых проект отказался, идентификаторами: `laws/application/money.md`. */
     readonly skip: readonly string[];
+    /**
+     * Выбор проекта по осям различия: `{ "host": "gitlab" }`. Оси объявлены пакетом в
+     * `assets/variants.json`, а ресурс с вариантом в имени берётся, только если проект выбрал
+     * его значение; как именно — `isChosen`.
+     */
+    readonly variants: Readonly<Record<string, string>>;
 }
 export declare const CONFIG_PATH: string;
 export declare const OVERRIDES_DIR: string;
+/**
+ * Карта «что правится — какое правило» и профиль дерева: команды, стенды, пары «правка —
+ * документ». Оба лежат в двух видах, и это не дублирование, а разделение ответственности.
+ *
+ * Умолчание везёт пакет: проекты этой мастерской устроены одинаково — Nx, те же расширения, те
+ * же имена каталогов, — и переписывать одну и ту же карту в каждом дереве заново значило бы
+ * заводить пятнадцать её редакций, расходящихся молча. Оно разложено, под шапкой, и правится
+ * не на месте.
+ *
+ * Надстройку пишет проект, и она необязательна: витрина, свой род файлов, другой запускатель
+ * тестов есть не у всех. Объявленная в ней функция замещает умолчание целиком и вправе позвать
+ * его обратно суффиксом `_default` — так дерево дописывает своё, не теряя общего.
+ */
+export declare const DEFAULTS_DIR: string;
+export declare const GATE_MAP_FILE: string;
+export declare const PROFILE_FILE: string;
 /**
  * Умолчания раскладки. Это не единственно возможные пути, но менять их без нужды не стоит:
  * агент ищет законы в `docs/constitution`, потому что так написано в правилах, которые пакет

package/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/config.ts"],"names":[],"mappings":"AAUA,2EAA2E;AAC3E,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEzE,eAAO,MAAM,KAAK,EAAE,SAAS,KAAK,EAAuD,CAAC;AAE1F,MAAM,WAAW,OAAO;IACpB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,eAAO,MAAM,WAAW,EAAE,MAA8B,CAAC;AACzD,eAAO,MAAM,aAAa,EAAE,MAAmC,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAM1D,CAAC;AAEF,qBAAa,WAAY,SAAQ,KAAK;CAAG;AAgCzC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA6BjD;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAUvD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/config.ts"],"names":[],"mappings":"AAUA,2EAA2E;AAC3E,MAAM,MAAM,KAAK,GACb,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAEnI,eAAO,MAAM,KAAK,EAAE,SAAS,KAAK,EAYjC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,KAAK,EAAoC,CAAC;AAE7E,iFAAiF;AACjF,eAAO,MAAM,UAAU,EAAE,MAAmB,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAA4B,CAAC;AAE1D,MAAM,WAAW,OAAO;IACpB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD;AAED,eAAO,MAAM,WAAW,EAAE,MAA8B,CAAC;AACzD,eAAO,MAAM,aAAa,EAAE,MAAmC,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,EAAE,MAAkC,CAAC;AAC9D,eAAO,MAAM,aAAa,EAAE,MAAsB,CAAC;AACnD,eAAO,MAAM,YAAY,EAAE,MAAqB,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAY1D,CAAC;AAEF,qBAAa,WAAY,SAAQ,KAAK;CAAG;AAgCzC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAmCjD;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAUvD"}

package/lib/config.js

@@ -7,9 +7,55 @@
  */
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-export const KINDS = ['laws', 'hooks', 'checks', 'agents', 'templates'];
+export const KINDS = [
+    'laws',
+    'rules',
+    'patterns',
+    'skills',
+    'hooks',
+    'defaults',
+    'checks',
+    'agents',
+    'commands',
+    'workflows',
+    'templates',
+];
+/**
+ * Роды, которые ложатся не файлом в каталог, а каталогом по имени ресурса: скил читается как
+ * `<имя>/SKILL.md`, и рядом с ним лежит то, что пишет проект.
+ *
+ * `skills` — скил, у которого нет закона над собой: он не про то, что должно быть верно в
+ * продукте, а про то, как здесь делается работа. Правилом его называть нельзя — тогда придётся
+ * выдумать ему закон, — а паттерном тем более: паттерн стоит при правиле.
+ */
+export const SKILL_KINDS = ['rules', 'patterns', 'skills'];
+/** Имя файла скила: так его ищет агент, и другого имени у него быть не может. */
+export const SKILL_FILE = 'SKILL.md';
+/**
+ * Файл-компаньон правила: чем названо в этом дереве то, о чём правило говорит приёмом.
+ *
+ * Пакет знает приём, но не знает ни путей, ни имён — их пишет проект. Черновик кладётся один
+ * раз и дальше не сверяется: это единственный файл раскладки, который принадлежит проекту.
+ */
+export const COMPANION_FILE = 'implementation.md';
 export const CONFIG_PATH = '.claude/rt-kit.json';
 export const OVERRIDES_DIR = '.claude/rt-kit/overrides';
+/**
+ * Карта «что правится — какое правило» и профиль дерева: команды, стенды, пары «правка —
+ * документ». Оба лежат в двух видах, и это не дублирование, а разделение ответственности.
+ *
+ * Умолчание везёт пакет: проекты этой мастерской устроены одинаково — Nx, те же расширения, те
+ * же имена каталогов, — и переписывать одну и ту же карту в каждом дереве заново значило бы
+ * заводить пятнадцать её редакций, расходящихся молча. Оно разложено, под шапкой, и правится
+ * не на месте.
+ *
+ * Надстройку пишет проект, и она необязательна: витрина, свой род файлов, другой запускатель
+ * тестов есть не у всех. Объявленная в ней функция замещает умолчание целиком и вправе позвать
+ * его обратно суффиксом `_default` — так дерево дописывает своё, не теряя общего.
+ */
+export const DEFAULTS_DIR = '.claude/rt-kit/defaults';
+export const GATE_MAP_FILE = 'gate-map.sh';
+export const PROFILE_FILE = 'project.sh';
 /**
  * Умолчания раскладки. Это не единственно возможные пути, но менять их без нужды не стоит:
  * агент ищет законы в `docs/constitution`, потому что так написано в правилах, которые пакет
@@ -17,9 +63,15 @@ export const OVERRIDES_DIR = '.claude/rt-kit/overrides';
  */
 export const DEFAULT_LAYOUT = {
     laws: 'docs/constitution',
+    rules: '.claude/skills',
+    patterns: '.claude/skills',
+    skills: '.claude/skills',
     hooks: '.claude/hooks',
+    defaults: DEFAULTS_DIR,
     checks: 'tools',
     agents: '.claude/agents',
+    commands: '.claude/commands',
+    workflows: '.claude/workflows',
     templates: '.claude/rt-kit/templates',
 };
 export class ConfigError extends Error {
@@ -73,7 +125,13 @@ export function parseConfig(text) {
     for (const kind of KINDS) {
         derived[`${kind.replace(/s$/, '')}sDir`] = layout[kind];
     }
-    return { vars: { ...derived, ...stringMap(raw['vars'], 'vars') }, layout: layout, only, skip };
+    return {
+        vars: { ...derived, ...stringMap(raw['vars'], 'vars') },
+        layout: layout,
+        only,
+        skip,
+        variants: stringMap(raw['variants'], 'variants'),
+    };
 }
 /** Конфиг проекта; его отсутствие — не отказ, а повод сказать про `agent-kit init`. */
 export function readConfig(root) {

package/lib/config.js.map

@@ -1 +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    /**\n     * Ресурсы, которые проект выбрал, идентификаторами: `laws/access.md`. Пусто — берётся всё.\n     * Ограничивает только те роды, которые сам называет; как именно — `isChosen`.\n     */\n    readonly only: readonly 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\nfunction idList(value: unknown, where: string): readonly string[] {\n    const list: unknown = value ?? [];\n    if (!Array.isArray(list) || list.some((entry: unknown): boolean => typeof entry !== 'string')) {\n        throw new ConfigError(`${where}: ожидается список идентификаторов ресурсов`);\n    }\n\n    return list as string[];\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 only: readonly string[] = idList(raw['only'], 'only');\n    const skip: readonly string[] = idList(raw['skip'], 'skip');\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>, only, skip };\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"]}
+{"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 =\n    'laws' | 'rules' | 'patterns' | 'skills' | 'hooks' | 'defaults' | 'checks' | 'agents' | 'commands' | 'workflows' | 'templates';\n\nexport const KINDS: readonly TKind[] = [\n    'laws',\n    'rules',\n    'patterns',\n    'skills',\n    'hooks',\n    'defaults',\n    'checks',\n    'agents',\n    'commands',\n    'workflows',\n    'templates',\n];\n\n/**\n * Роды, которые ложатся не файлом в каталог, а каталогом по имени ресурса: скил читается как\n * `<имя>/SKILL.md`, и рядом с ним лежит то, что пишет проект.\n *\n * `skills` — скил, у которого нет закона над собой: он не про то, что должно быть верно в\n * продукте, а про то, как здесь делается работа. Правилом его называть нельзя — тогда придётся\n * выдумать ему закон, — а паттерном тем более: паттерн стоит при правиле.\n */\nexport const SKILL_KINDS: readonly TKind[] = ['rules', 'patterns', 'skills'];\n\n/** Имя файла скила: так его ищет агент, и другого имени у него быть не может. */\nexport const SKILL_FILE: string = 'SKILL.md';\n\n/**\n * Файл-компаньон правила: чем названо в этом дереве то, о чём правило говорит приёмом.\n *\n * Пакет знает приём, но не знает ни путей, ни имён — их пишет проект. Черновик кладётся один\n * раз и дальше не сверяется: это единственный файл раскладки, который принадлежит проекту.\n */\nexport const COMPANION_FILE: string = 'implementation.md';\n\nexport interface IConfig {\n    /** Значения дырок `{{имя}}`. */\n    readonly vars: Readonly<Record<string, string>>;\n    /** Куда класть каждый род ресурса, путями от корня проекта. */\n    readonly layout: Readonly<Record<TKind, string>>;\n    /**\n     * Ресурсы, которые проект выбрал, идентификаторами: `laws/access.md`. Пусто — берётся всё.\n     * Ограничивает только те роды, которые сам называет; как именно — `isChosen`.\n     */\n    readonly only: readonly string[];\n    /** Ресурсы, от которых проект отказался, идентификаторами: `laws/application/money.md`. */\n    readonly skip: readonly string[];\n    /**\n     * Выбор проекта по осям различия: `{ \"host\": \"gitlab\" }`. Оси объявлены пакетом в\n     * `assets/variants.json`, а ресурс с вариантом в имени берётся, только если проект выбрал\n     * его значение; как именно — `isChosen`.\n     */\n    readonly variants: Readonly<Record<string, 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 * документ». Оба лежат в двух видах, и это не дублирование, а разделение ответственности.\n *\n * Умолчание везёт пакет: проекты этой мастерской устроены одинаково — Nx, те же расширения, те\n * же имена каталогов, — и переписывать одну и ту же карту в каждом дереве заново значило бы\n * заводить пятнадцать её редакций, расходящихся молча. Оно разложено, под шапкой, и правится\n * не на месте.\n *\n * Надстройку пишет проект, и она необязательна: витрина, свой род файлов, другой запускатель\n * тестов есть не у всех. Объявленная в ней функция замещает умолчание целиком и вправе позвать\n * его обратно суффиксом `_default` — так дерево дописывает своё, не теряя общего.\n */\nexport const DEFAULTS_DIR: string = '.claude/rt-kit/defaults';\nexport const GATE_MAP_FILE: string = 'gate-map.sh';\nexport const PROFILE_FILE: string = 'project.sh';\n\n/**\n * Умолчания раскладки. Это не единственно возможные пути, но менять их без нужды не стоит:\n * агент ищет законы в `docs/constitution`, потому что так написано в правилах, которые пакет\n * же и везёт.\n */\nexport const DEFAULT_LAYOUT: Readonly<Record<TKind, string>> = {\n    laws: 'docs/constitution',\n    rules: '.claude/skills',\n    patterns: '.claude/skills',\n    skills: '.claude/skills',\n    hooks: '.claude/hooks',\n    defaults: DEFAULTS_DIR,\n    checks: 'tools',\n    agents: '.claude/agents',\n    commands: '.claude/commands',\n    workflows: '.claude/workflows',\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\nfunction idList(value: unknown, where: string): readonly string[] {\n    const list: unknown = value ?? [];\n    if (!Array.isArray(list) || list.some((entry: unknown): boolean => typeof entry !== 'string')) {\n        throw new ConfigError(`${where}: ожидается список идентификаторов ресурсов`);\n    }\n\n    return list as string[];\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 only: readonly string[] = idList(raw['only'], 'only');\n    const skip: readonly string[] = idList(raw['skip'], 'skip');\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 {\n        vars: { ...derived, ...stringMap(raw['vars'], 'vars') },\n        layout: layout as Record<TKind, string>,\n        only,\n        skip,\n        variants: stringMap(raw['variants'], 'variants'),\n    };\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/freshness.d.ts

@@ -0,0 +1,14 @@
+export interface IStaleBuild {
+    /** Каталог ресурсов в исходниках. */
+    readonly source: string;
+    /** Файл ресурса, правленный позже сборки, — по нему видно, чего именно не хватает в дереве. */
+    readonly newest: string;
+}
+/**
+ * Правлены ли ресурсы позже, чем собран пакет, из которого идёт раскладка.
+ *
+ * `null` значит «сверять не с чем или сверка сошлась»: у потребителя исходников нет вовсе, а у
+ * того, кто запускает пакет прямо из исходников, собранное и исходное — один и тот же каталог.
+ */
+export declare function staleBuild(packageRoot: string, name: string): IStaleBuild | null;
+//# sourceMappingURL=freshness.d.ts.map

package/lib/freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/freshness.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,WAAW;IACxB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAmFD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAiBhF"}

package/lib/freshness.js

@@ -0,0 +1,116 @@
+/**
+ * Свежесть собранного пакета относительно его исходников.
+ *
+ * Строка запуска читает собранное, а правка ресурса идёт в исходники. Между ними стоит сборка,
+ * и пока её не прогнали, `sync` отвечает «всё уже разложено» — притом что в дереве лежит
+ * прежняя редакция ресурса. Неправда эта дороже отказа: её замечают, когда правленое правило не
+ * действует, и ищут причину в раскладке, а не в том, что её не собрали.
+ *
+ * Исходники ищутся только там, где они есть: у того, кто пакет разрабатывает. У потребителя
+ * рядом с установленным пакетом нет ни рабочего пространства, ни каталога проектов, и проверка
+ * молчит — сверять не с чем и нечего.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/** Признаки корня рабочего пространства: по ним ищется дерево, в котором пакет разрабатывают. */
+const WORKSPACE_MARKS = ['nx.json', 'pnpm-workspace.yaml', 'lerna.json'];
+/** Каталоги, в которых рабочее пространство держит проекты. */
+const PROJECT_DIRS = ['projects', 'packages', 'libs', 'apps'];
+/** Самое позднее время правки в поддереве и файл, которому оно принадлежит. */
+function newestIn(dir) {
+    let found = null;
+    const walk = (current) => {
+        let entries;
+        try {
+            entries = readdirSync(current);
+        }
+        catch {
+            return;
+        }
+        for (const name of entries) {
+            const path = join(current, name);
+            let stats;
+            try {
+                stats = statSync(path);
+            }
+            catch {
+                continue;
+            }
+            if (stats.isDirectory()) {
+                walk(path);
+            }
+            else if (!found || stats.mtimeMs > found.at) {
+                found = { at: stats.mtimeMs, path };
+            }
+        }
+    };
+    walk(dir);
+    return found;
+}
+/**
+ * Корень рабочего пространства над этим каталогом.
+ *
+ * Подъём заканчивается на корне файловой системы, а не на отсчитанном числе шагов: глубина, на
+ * которой лежит установленный пакет, у каждого дерева своя, и отсчитанный предел молчал бы ровно
+ * там, где вложенность оказалась глубже придуманной.
+ */
+function workspaceOf(start) {
+    let dir = start;
+    for (;;) {
+        if (WORKSPACE_MARKS.some((mark) => existsSync(join(dir, mark)))) {
+            return dir;
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            return null;
+        }
+        dir = parent;
+    }
+}
+/** Каталог исходников пакета с этим именем внутри рабочего пространства. */
+function sourceOf(workspace, name) {
+    for (const group of PROJECT_DIRS) {
+        let entries;
+        try {
+            entries = readdirSync(join(workspace, group));
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const candidate = join(workspace, group, entry);
+            try {
+                if (JSON.parse(readFileSync(join(candidate, 'package.json'), 'utf8')).name === name) {
+                    return candidate;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Правлены ли ресурсы позже, чем собран пакет, из которого идёт раскладка.
+ *
+ * `null` значит «сверять не с чем или сверка сошлась»: у потребителя исходников нет вовсе, а у
+ * того, кто запускает пакет прямо из исходников, собранное и исходное — один и тот же каталог.
+ */
+export function staleBuild(packageRoot, name) {
+    const workspace = workspaceOf(packageRoot);
+    if (workspace === null) {
+        return null;
+    }
+    const source = sourceOf(workspace, name);
+    if (source === null || source === packageRoot) {
+        return null;
+    }
+    const built = newestIn(join(packageRoot, 'assets'));
+    const written = newestIn(join(source, 'assets'));
+    if (!built || !written || written.at <= built.at) {
+        return null;
+    }
+    return { source: join(source, 'assets'), newest: written.path };
+}
+//# sourceMappingURL=freshness.js.map

package/lib/freshness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/freshness.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Свежесть собранного пакета относительно его исходников.\n *\n * Строка запуска читает собранное, а правка ресурса идёт в исходники. Между ними стоит сборка,\n * и пока её не прогнали, `sync` отвечает «всё уже разложено» — притом что в дереве лежит\n * прежняя редакция ресурса. Неправда эта дороже отказа: её замечают, когда правленое правило не\n * действует, и ищут причину в раскладке, а не в том, что её не собрали.\n *\n * Исходники ищутся только там, где они есть: у того, кто пакет разрабатывает. У потребителя\n * рядом с установленным пакетом нет ни рабочего пространства, ни каталога проектов, и проверка\n * молчит — сверять не с чем и нечего.\n */\nimport { existsSync, readdirSync, readFileSync, statSync, Stats } from 'node:fs';\nimport { dirname, join } from 'node:path';\n\n/** Признаки корня рабочего пространства: по ним ищется дерево, в котором пакет разрабатывают. */\nconst WORKSPACE_MARKS: readonly string[] = ['nx.json', 'pnpm-workspace.yaml', 'lerna.json'];\n\n/** Каталоги, в которых рабочее пространство держит проекты. */\nconst PROJECT_DIRS: readonly string[] = ['projects', 'packages', 'libs', 'apps'];\n\nexport interface IStaleBuild {\n    /** Каталог ресурсов в исходниках. */\n    readonly source: string;\n    /** Файл ресурса, правленный позже сборки, — по нему видно, чего именно не хватает в дереве. */\n    readonly newest: string;\n}\n\ninterface INewest {\n    readonly at: number;\n    readonly path: string;\n}\n\n/** Самое позднее время правки в поддереве и файл, которому оно принадлежит. */\nfunction newestIn(dir: string): INewest | null {\n    let found: INewest | null = null;\n\n    const walk: (current: string) => void = (current: string): void => {\n        let entries: readonly string[];\n        try {\n            entries = readdirSync(current);\n        } catch {\n            return;\n        }\n        for (const name of entries) {\n            const path: string = join(current, name);\n            let stats: Stats;\n            try {\n                stats = statSync(path);\n            } catch {\n                continue;\n            }\n            if (stats.isDirectory()) {\n                walk(path);\n            } else if (!found || stats.mtimeMs > found.at) {\n                found = { at: stats.mtimeMs, path };\n            }\n        }\n    };\n    walk(dir);\n\n    return found;\n}\n\n/**\n * Корень рабочего пространства над этим каталогом.\n *\n * Подъём заканчивается на корне файловой системы, а не на отсчитанном числе шагов: глубина, на\n * которой лежит установленный пакет, у каждого дерева своя, и отсчитанный предел молчал бы ровно\n * там, где вложенность оказалась глубже придуманной.\n */\nfunction workspaceOf(start: string): string | null {\n    let dir: string = start;\n    for (;;) {\n        if (WORKSPACE_MARKS.some((mark: string): boolean => existsSync(join(dir, mark)))) {\n            return dir;\n        }\n        const parent: string = dirname(dir);\n        if (parent === dir) {\n            return null;\n        }\n        dir = parent;\n    }\n}\n\n/** Каталог исходников пакета с этим именем внутри рабочего пространства. */\nfunction sourceOf(workspace: string, name: string): string | null {\n    for (const group of PROJECT_DIRS) {\n        let entries: readonly string[];\n        try {\n            entries = readdirSync(join(workspace, group));\n        } catch {\n            continue;\n        }\n        for (const entry of entries) {\n            const candidate: string = join(workspace, group, entry);\n            try {\n                if (JSON.parse(readFileSync(join(candidate, 'package.json'), 'utf8')).name === name) {\n                    return candidate;\n                }\n            } catch {\n                continue;\n            }\n        }\n    }\n\n    return null;\n}\n\n/**\n * Правлены ли ресурсы позже, чем собран пакет, из которого идёт раскладка.\n *\n * `null` значит «сверять не с чем или сверка сошлась»: у потребителя исходников нет вовсе, а у\n * того, кто запускает пакет прямо из исходников, собранное и исходное — один и тот же каталог.\n */\nexport function staleBuild(packageRoot: string, name: string): IStaleBuild | null {\n    const workspace: string | null = workspaceOf(packageRoot);\n    if (workspace === null) {\n        return null;\n    }\n    const source: string | null = sourceOf(workspace, name);\n    if (source === null || source === packageRoot) {\n        return null;\n    }\n\n    const built: INewest | null = newestIn(join(packageRoot, 'assets'));\n    const written: INewest | null = newestIn(join(source, 'assets'));\n    if (!built || !written || written.at <= built.at) {\n        return null;\n    }\n\n    return { source: join(source, 'assets'), newest: written.path };\n}\n"]}

package/lib/hooks-map.d.ts

@@ -0,0 +1,24 @@
+/** Настройка агента, в которой живёт карта. Путь от корня дерева. */
+export declare const SETTINGS_PATH: string;
+export interface IHookBinding {
+    /** Событие агента: `PreToolUse`, `PostToolUse`, `SessionStart`. */
+    readonly event: string;
+    /** Образец, по которому событие достаётся этому гарду. */
+    readonly matcher: string;
+    /** Путь разложенного гарда от корня дерева. */
+    readonly path: string;
+}
+/** Что гард говорит о себе. Молчит — он не подключается к агенту вовсе. */
+export declare function bindingOf(text: string, path: string): IHookBinding | null;
+/**
+ * Раздел `hooks` для настройки агента: событие → образец → команда.
+ *
+ * Гарды с одинаковым образцом внутри события собираются в одну запись — так же, как это пишут
+ * руками, и так же, как читает агент.
+ */
+export declare function hooksSection(bindings: readonly IHookBinding[]): Record<string, unknown>;
+/** Пути гардов, названные в настройке агента этого дерева. Нет файла — ни одного. */
+export declare function boundInSettings(root: string): readonly string[];
+/** Разложенные гарды, которых в настройке агента нет: они лежат, но их никто не позовёт. */
+export declare function unboundHooks(bindings: readonly IHookBinding[], root: string): readonly IHookBinding[];
+//# sourceMappingURL=hooks-map.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-map.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/hooks-map.ts"],"names":[],"mappings":"AAmBA,qEAAqE;AACrE,eAAO,MAAM,aAAa,EAAE,MAAgC,CAAC;AAI7D,MAAM,WAAW,YAAY;IACzB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAIzE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBvF;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAkB/D;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAIrG"}

package/lib/hooks-map.js

@@ -0,0 +1,72 @@
+/**
+ * Карта хуков: чем разложенные гарды подключаются к агенту.
+ *
+ * Раскладка кладёт файлы, а зовёт их запись в настройке агента — чужом JSON, которым пакет не
+ * владеет. Пока о ней молчали, свежее дерево получало два десятка гардов, ни один из которых не
+ * срабатывал, и узнавало об этом, когда что-нибудь проходило мимо.
+ *
+ * Пакет не пишет в чужую настройку сам: файл держит проект, в нём лежит и то, о чём пакет не
+ * знает вовсе, а слияние чужого JSON молча теряет несовпавшее. Вместо этого он собирает готовый
+ * кусок и проверяет, что он вставлен. Это дешевле и честнее: правку в свою настройку делает тот,
+ * кто за неё отвечает.
+ *
+ * Событие и образец вызова гард несёт сам — строкой `# rt-hook: <событие> <образец>` во второй
+ * строке файла. Карта, выписанная отдельным списком, разошлась бы с набором гардов на первом же
+ * добавленном, и заметить это было бы нечем: гард просто не звался бы.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Настройка агента, в которой живёт карта. Путь от корня дерева. */
+export const SETTINGS_PATH = '.claude/settings.json';
+const DECLARATION = /^#\s*rt-hook:\s*(\S+)\s+(\S.*)$/m;
+/** Что гард говорит о себе. Молчит — он не подключается к агенту вовсе. */
+export function bindingOf(text, path) {
+    const found = text.match(DECLARATION);
+    return found ? { event: found[1], matcher: found[2].trim(), path } : null;
+}
+/**
+ * Раздел `hooks` для настройки агента: событие → образец → команда.
+ *
+ * Гарды с одинаковым образцом внутри события собираются в одну запись — так же, как это пишут
+ * руками, и так же, как читает агент.
+ */
+export function hooksSection(bindings) {
+    const events = new Map();
+    for (const binding of bindings) {
+        const byMatcher = events.get(binding.event) ?? new Map();
+        byMatcher.set(binding.matcher, [...(byMatcher.get(binding.matcher) ?? []), binding.path]);
+        events.set(binding.event, byMatcher);
+    }
+    const section = {};
+    for (const [event, byMatcher] of [...events].sort()) {
+        section[event] = [...byMatcher].sort().map(([matcher, paths]) => ({
+            matcher,
+            hooks: paths.map((path) => ({ type: 'command', command: `$CLAUDE_PROJECT_DIR/${path}` })),
+        }));
+    }
+    return section;
+}
+/** Пути гардов, названные в настройке агента этого дерева. Нет файла — ни одного. */
+export function boundInSettings(root) {
+    const path = join(root, SETTINGS_PATH);
+    if (!existsSync(path)) {
+        return [];
+    }
+    let text;
+    try {
+        text = readFileSync(path, 'utf8');
+    }
+    catch {
+        return [];
+    }
+    // Настройка читается текстом, а не разбором: у неё нет объявленной формы, и дерево вправе
+    // держать её так, как ему удобно, — вплоть до комментариев, которых JSON не разбирает. Ищется
+    // одно: назван ли путь гарда хоть где-нибудь в ней.
+    return [...text.matchAll(/[\w./$-]*\.claude\/hooks\/[\w.-]+\.sh/g)].map((found) => found[0].replace(/^.*?(\.claude\/)/, '$1'));
+}
+/** Разложенные гарды, которых в настройке агента нет: они лежат, но их никто не позовёт. */
+export function unboundHooks(bindings, root) {
+    const bound = new Set(boundInSettings(root));
+    return bindings.filter((binding) => !bound.has(binding.path));
+}
+//# sourceMappingURL=hooks-map.js.map

package/lib/hooks-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-map.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/hooks-map.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Карта хуков: чем разложенные гарды подключаются к агенту.\n *\n * Раскладка кладёт файлы, а зовёт их запись в настройке агента — чужом JSON, которым пакет не\n * владеет. Пока о ней молчали, свежее дерево получало два десятка гардов, ни один из которых не\n * срабатывал, и узнавало об этом, когда что-нибудь проходило мимо.\n *\n * Пакет не пишет в чужую настройку сам: файл держит проект, в нём лежит и то, о чём пакет не\n * знает вовсе, а слияние чужого JSON молча теряет несовпавшее. Вместо этого он собирает готовый\n * кусок и проверяет, что он вставлен. Это дешевле и честнее: правку в свою настройку делает тот,\n * кто за неё отвечает.\n *\n * Событие и образец вызова гард несёт сам — строкой `# rt-hook: <событие> <образец>` во второй\n * строке файла. Карта, выписанная отдельным списком, разошлась бы с набором гардов на первом же\n * добавленном, и заметить это было бы нечем: гард просто не звался бы.\n */\nimport { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\n/** Настройка агента, в которой живёт карта. Путь от корня дерева. */\nexport const SETTINGS_PATH: string = '.claude/settings.json';\n\nconst DECLARATION: RegExp = /^#\\s*rt-hook:\\s*(\\S+)\\s+(\\S.*)$/m;\n\nexport interface IHookBinding {\n    /** Событие агента: `PreToolUse`, `PostToolUse`, `SessionStart`. */\n    readonly event: string;\n    /** Образец, по которому событие достаётся этому гарду. */\n    readonly matcher: string;\n    /** Путь разложенного гарда от корня дерева. */\n    readonly path: string;\n}\n\n/** Что гард говорит о себе. Молчит — он не подключается к агенту вовсе. */\nexport function bindingOf(text: string, path: string): IHookBinding | null {\n    const found: RegExpMatchArray | null = text.match(DECLARATION);\n\n    return found ? { event: found[1], matcher: found[2].trim(), path } : null;\n}\n\n/**\n * Раздел `hooks` для настройки агента: событие → образец → команда.\n *\n * Гарды с одинаковым образцом внутри события собираются в одну запись — так же, как это пишут\n * руками, и так же, как читает агент.\n */\nexport function hooksSection(bindings: readonly IHookBinding[]): Record<string, unknown> {\n    const events: Map<string, Map<string, string[]>> = new Map();\n\n    for (const binding of bindings) {\n        const byMatcher: Map<string, string[]> = events.get(binding.event) ?? new Map();\n        byMatcher.set(binding.matcher, [...(byMatcher.get(binding.matcher) ?? []), binding.path]);\n        events.set(binding.event, byMatcher);\n    }\n\n    const section: Record<string, unknown> = {};\n    for (const [event, byMatcher] of [...events].sort()) {\n        section[event] = [...byMatcher].sort().map(([matcher, paths]: [string, readonly string[]]): unknown => ({\n            matcher,\n            hooks: paths.map((path: string): unknown => ({ type: 'command', command: `$CLAUDE_PROJECT_DIR/${path}` })),\n        }));\n    }\n\n    return section;\n}\n\n/** Пути гардов, названные в настройке агента этого дерева. Нет файла — ни одного. */\nexport function boundInSettings(root: string): readonly string[] {\n    const path: string = join(root, SETTINGS_PATH);\n    if (!existsSync(path)) {\n        return [];\n    }\n    let text: string;\n    try {\n        text = readFileSync(path, 'utf8');\n    } catch {\n        return [];\n    }\n\n    // Настройка читается текстом, а не разбором: у неё нет объявленной формы, и дерево вправе\n    // держать её так, как ему удобно, — вплоть до комментариев, которых JSON не разбирает. Ищется\n    // одно: назван ли путь гарда хоть где-нибудь в ней.\n    return [...text.matchAll(/[\\w./$-]*\\.claude\\/hooks\\/[\\w.-]+\\.sh/g)].map((found: RegExpMatchArray): string =>\n        found[0].replace(/^.*?(\\.claude\\/)/, '$1')\n    );\n}\n\n/** Разложенные гарды, которых в настройке агента нет: они лежат, но их никто не позовёт. */\nexport function unboundHooks(bindings: readonly IHookBinding[], root: string): readonly IHookBinding[] {\n    const bound: ReadonlySet<string> = new Set(boundInSettings(root));\n\n    return bindings.filter((binding: IHookBinding): boolean => !bound.has(binding.path));\n}\n"]}

package/lib/integrity.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Целостность самих ресурсов пакета: у правила есть закон, у паттерна — правило.
+ *
+ * Проверка нужна не проекту, а пакету. Закон переименовали, а `law:` у правила осталось
+ * прежним — раскладка от этого не падает: она кладёт файлы, а не читает их шапки. Промах уезжает
+ * к проектам, и находит его тот, кто пошёл за законом по ссылке из правила и не нашёл его.
+ *
+ * Разбирается только вступление между `---`: остальное в файле — проза, и `law:` посреди неё
+ * означает пример, а не объявление.
+ */
+import { IEntryOfCatalog } from './catalog.js';
+/** Что объявила шапка ресурса. Пустое поле и отсутствующее здесь одно и то же. */
+export interface IFrontMatter {
+    readonly name: string;
+    readonly kind: string;
+    /** Закон, под которым стоит правило. */
+    readonly law: string;
+    /** Правило, при котором стоит паттерн. */
+    readonly rule: string;
+}
+/** Вступление между `---` в начале файла; его нет — вернётся пустая шапка. */
+export declare function frontMatterOf(text: string): IFrontMatter;
+/** Расхождение в ресурсах пакета: кто ссылается, на что и чего не нашлось. */
+export interface IBrokenLink {
+    readonly id: string;
+    readonly field: 'law' | 'rule';
+    readonly wanted: string;
+}
+/**
+ * Ссылки шапок, которым в каталоге ничего не отвечает.
+ *
+ * Закон ищется по короткому имени: слой в ссылке не отражается, и переезд закона между слоями
+ * шапок правил не переписывает — так же, как этого не делают ни таблицы законов, ни спеки.
+ */
+export declare function brokenLinks(catalog: readonly IEntryOfCatalog[]): readonly IBrokenLink[];
+//# sourceMappingURL=integrity.d.ts.map

package/lib/integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/integrity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,kFAAkF;AAClF,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAID,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAiBxD;AAED,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,WAAW,EAAE,CAoBvF"}

package/lib/integrity.js

@@ -0,0 +1,44 @@
+const FIELD = /^([a-z]+):\s*(\S.*?)\s*$/;
+/** Вступление между `---` в начале файла; его нет — вернётся пустая шапка. */
+export function frontMatterOf(text) {
+    const lines = text.split('\n');
+    const found = {};
+    if (lines[0]?.trim() === '---') {
+        for (const line of lines.slice(1)) {
+            if (line.trim() === '---') {
+                break;
+            }
+            const match = line.match(FIELD);
+            if (match) {
+                found[match[1]] = match[2];
+            }
+        }
+    }
+    return { name: found['name'] ?? '', kind: found['kind'] ?? '', law: found['law'] ?? '', rule: found['rule'] ?? '' };
+}
+/**
+ * Ссылки шапок, которым в каталоге ничего не отвечает.
+ *
+ * Закон ищется по короткому имени: слой в ссылке не отражается, и переезд закона между слоями
+ * шапок правил не переписывает — так же, как этого не делают ни таблицы законов, ни спеки.
+ */
+export function brokenLinks(catalog) {
+    const shortOf = (entry) => entry.name.split('/').pop() ?? entry.name;
+    const laws = new Set(catalog.filter((entry) => entry.kind === 'laws').map(shortOf));
+    const rules = new Set(catalog.filter((entry) => entry.kind === 'rules').map(shortOf));
+    const broken = [];
+    for (const entry of catalog) {
+        if (entry.kind !== 'rules' && entry.kind !== 'patterns') {
+            continue;
+        }
+        const head = frontMatterOf(entry.text);
+        if (entry.kind === 'rules' && !laws.has(head.law)) {
+            broken.push({ id: entry.id, field: 'law', wanted: head.law });
+        }
+        if (entry.kind === 'patterns' && !rules.has(head.rule)) {
+            broken.push({ id: entry.id, field: 'rule', wanted: head.rule });
+        }
+    }
+    return broken;
+}
+//# sourceMappingURL=integrity.js.map

package/lib/integrity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/integrity.ts"],"names":[],"mappings":"AAsBA,MAAM,KAAK,GAAW,0BAA0B,CAAC;AAEjD,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAAC,IAAY;IACtC,MAAM,KAAK,GAAsB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,KAAK,GAA2B,EAAE,CAAC;IAEzC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;gBACxB,MAAM;YACV,CAAC;YACD,MAAM,KAAK,GAA4B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACzD,IAAI,KAAK,EAAE,CAAC;gBACR,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC/B,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;AACxH,CAAC;AASD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAmC;IAC3D,MAAM,OAAO,GAAuC,CAAC,KAAsB,EAAU,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC;IAClI,MAAM,IAAI,GAAwB,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAsB,EAAW,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACnI,MAAM,KAAK,GAAwB,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAsB,EAAW,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAErI,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACtD,SAAS;QACb,CAAC;QACD,MAAM,IAAI,GAAiB,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC","sourcesContent":["/**\n * Целостность самих ресурсов пакета: у правила есть закон, у паттерна — правило.\n *\n * Проверка нужна не проекту, а пакету. Закон переименовали, а `law:` у правила осталось\n * прежним — раскладка от этого не падает: она кладёт файлы, а не читает их шапки. Промах уезжает\n * к проектам, и находит его тот, кто пошёл за законом по ссылке из правила и не нашёл его.\n *\n * Разбирается только вступление между `---`: остальное в файле — проза, и `law:` посреди неё\n * означает пример, а не объявление.\n */\nimport { IEntryOfCatalog } from './catalog.js';\n\n/** Что объявила шапка ресурса. Пустое поле и отсутствующее здесь одно и то же. */\nexport interface IFrontMatter {\n    readonly name: string;\n    readonly kind: string;\n    /** Закон, под которым стоит правило. */\n    readonly law: string;\n    /** Правило, при котором стоит паттерн. */\n    readonly rule: string;\n}\n\nconst FIELD: RegExp = /^([a-z]+):\\s*(\\S.*?)\\s*$/;\n\n/** Вступление между `---` в начале файла; его нет — вернётся пустая шапка. */\nexport function frontMatterOf(text: string): IFrontMatter {\n    const lines: readonly string[] = text.split('\\n');\n    const found: Record<string, string> = {};\n\n    if (lines[0]?.trim() === '---') {\n        for (const line of lines.slice(1)) {\n            if (line.trim() === '---') {\n                break;\n            }\n            const match: RegExpMatchArray | null = line.match(FIELD);\n            if (match) {\n                found[match[1]] = match[2];\n            }\n        }\n    }\n\n    return { name: found['name'] ?? '', kind: found['kind'] ?? '', law: found['law'] ?? '', rule: found['rule'] ?? '' };\n}\n\n/** Расхождение в ресурсах пакета: кто ссылается, на что и чего не нашлось. */\nexport interface IBrokenLink {\n    readonly id: string;\n    readonly field: 'law' | 'rule';\n    readonly wanted: string;\n}\n\n/**\n * Ссылки шапок, которым в каталоге ничего не отвечает.\n *\n * Закон ищется по короткому имени: слой в ссылке не отражается, и переезд закона между слоями\n * шапок правил не переписывает — так же, как этого не делают ни таблицы законов, ни спеки.\n */\nexport function brokenLinks(catalog: readonly IEntryOfCatalog[]): readonly IBrokenLink[] {\n    const shortOf: (entry: IEntryOfCatalog) => string = (entry: IEntryOfCatalog): string => entry.name.split('/').pop() ?? entry.name;\n    const laws: ReadonlySet<string> = new Set(catalog.filter((entry: IEntryOfCatalog): boolean => entry.kind === 'laws').map(shortOf));\n    const rules: ReadonlySet<string> = new Set(catalog.filter((entry: IEntryOfCatalog): boolean => entry.kind === 'rules').map(shortOf));\n\n    const broken: IBrokenLink[] = [];\n    for (const entry of catalog) {\n        if (entry.kind !== 'rules' && entry.kind !== 'patterns') {\n            continue;\n        }\n        const head: IFrontMatter = frontMatterOf(entry.text);\n        if (entry.kind === 'rules' && !laws.has(head.law)) {\n            broken.push({ id: entry.id, field: 'law', wanted: head.law });\n        }\n        if (entry.kind === 'patterns' && !rules.has(head.rule)) {\n            broken.push({ id: entry.id, field: 'rule', wanted: head.rule });\n        }\n    }\n\n    return broken;\n}\n"]}