@rt-tools/agent-kit 0.11.0 → 0.12.0

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 =\n    | 'laws'\n    | 'rules'\n    | 'patterns'\n    | 'skills'\n    | 'hooks'\n    | 'defaults'\n    | 'checks'\n    | 'agents'\n    | 'commands'\n    | 'workflows'\n    | 'templates'\n    /** Документы дерева, которые читает и человек, и агент: словарь проекта. */\n    | 'docs'\n    /**\n     * Образцы, которые копируют в рабочий файл и заполняют: папка задачи, спек домена.\n     *\n     * От шаблонов отличаются читателем и местом. Шаблон ложится в каталог слоя правил, и с него\n     * пишут ресурс этого слоя; образец ложится туда, где идёт работа, и копирует его тот, кто\n     * работу ведёт. Одним родом их не свести: дерево вправе отказаться от одних, оставив\n     * другие, и назвать им разные каталоги.\n     */\n    | 'samples';\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    'docs',\n    'samples',\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     * Что у дерева есть: `[\"packages\", \"app\"]`. Свойства объявлены пакетом в `assets/traits.json`,\n     * а ресурс, требующий свойства именем файла, дереву без него не кладётся вовсе — ни сам, ни\n     * черновик его компаньона. Пусто — дерево о себе ничего не сказало, и помеченного не получает.\n     */\n    readonly has: readonly string[];\n    /**\n     * Пишут ли гарды наблюдения о слое правил. Умолчание — да; выключает дерево, и целиком, а\n     * не частями. Ключ читают двое: сводка — отсюда, гард — тем же именем прямо из файла, потому\n     * что разборщика конфига у него нет.\n     */\n    readonly observe: boolean;\n    /**\n     * Роли слоя правил, которые дерево выключило, именами файлов без расширения:\n     * `[\"strict-teacher\"]`. Выключается обязательность вызова, а не сама роль: файл роли\n     * остаётся разложенным и зовётся руками, а гард при выключенной роли выходит молча.\n     * Ключ читают двое: сводка — отсюда, гард — тем же именем прямо из файла, потому что\n     * разборщика конфига у него нет.\n     */\n    readonly rolesOff: readonly string[];\n    /**\n     * Адрес приёма, куда уезжает груз: `https://…`. Пусто — отправлять некуда, и отправка\n     * отказывает вместо молчания. Зашитый в код адрес назвал бы чужое дерево в текстах пакета.\n     */\n    readonly intake: string;\n    /**\n     * Файл с токеном дерева — путь от корня дерева или от домашнего каталога (`~/…`). Сам токен\n     * в конфиге не лежит: конфиг коммитится, а токен обязан остаться вне истории.\n     */\n    readonly token: string;\n    /**\n     * Признак дерева, когда удалённого репозитория нет. При нём — считается из адреса\n     * репозитория: две рабочие копии одного репозитория обязаны дать один признак.\n     */\n    readonly tree: string;\n    /** Где дерево держит разборы происшествий. Путь от корня дерева. */\n    readonly postmortems: string;\n}\n\nexport const CONFIG_PATH: string = '.claude/rt-kit.json';\n/** Каталог, в котором дерево держит своё при пакете: надстройки, умолчания, свою карту и профиль. */\nexport const RT_KIT_DIR: string = '.claude/rt-kit';\nexport const OVERRIDES_DIR: string = '.claude/rt-kit/overrides';\n\n/**\n * Где разборы происшествий лежат, когда конфиг не сказал иначе. Роды ресурсов сюда не годятся:\n * разборы пишет дерево про себя, пакет их не раскладывает и не сверяет.\n */\nexport const DEFAULT_POSTMORTEMS_DIR: string = 'docs/postmortems';\n\n/**\n * Карта «что правится — какое правило» и профиль дерева: команды, стенды, пары «правка —\n * документ». Оба лежат в двух видах, и это не дублирование, а разделение ответственности.\n *\n * Умолчание везёт пакет: проекты этой мастерской устроены одинаково — Nx, те же расширения, те\n * же имена каталогов, — и переписывать одну и ту же карту в каждом дереве заново значило бы\n * заводить пятнадцать её редакций, расходящихся молча. Оно разложено, под шапкой, и правится\n * не на месте.\n *\n * Надстройку пишет проект, и она необязательна: витрина, свой род файлов, другой запускатель\n * тестов есть не у всех. Объявленная в ней функция замещает умолчание целиком и вправе позвать\n * его обратно суффиксом `_default` — так дерево дописывает своё, не теряя общего.\n */\n/** Каталог правил дерева: законы туда не идут, а правила, паттерны и скилы лежат вместе. */\nexport const SKILLS_DIR: string = '.claude/skills';\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: SKILLS_DIR,\n    patterns: SKILLS_DIR,\n    skills: SKILLS_DIR,\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    docs: 'docs',\n    // Внутри рода путь повторяет раскладку дерева — папки задач и спеки, — поэтому одного\n    // умолчания хватает всем образцам сразу.\n    samples: 'docs',\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\n/** Строковый ключ конфига. Ключа нет — пустая строка: значение необязательное у всех четырёх. */\nfunction textOf(value: unknown, where: string): string {\n    if (value === undefined || value === null) {\n        return '';\n    }\n    if (typeof value !== 'string') {\n        throw new ConfigError(`${where}: ожидается строка`);\n    }\n\n    return value.trim();\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        only,\n        skip,\n        vars: { ...derived, ...stringMap(raw['vars'], 'vars') },\n        layout: layout as Record<TKind, string>,\n        variants: stringMap(raw['variants'], 'variants'),\n        has: idList(raw['has'], 'has'),\n        // Выключателем считается только явное «нет»: ключа нет — запись идёт, как и у гарда.\n        observe: raw['observe'] !== false,\n        rolesOff: idList(raw['rolesOff'], 'rolesOff'),\n        intake: textOf(raw['intake'], 'intake'),\n        token: textOf(raw['token'], 'token'),\n        tree: textOf(raw['tree'], 'tree'),\n        postmortems: textOf(raw['postmortems'], 'postmortems') || DEFAULT_POSTMORTEMS_DIR,\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"]}
+{"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'\n    | 'rules'\n    | 'patterns'\n    | 'skills'\n    | 'hooks'\n    | 'defaults'\n    | 'checks'\n    | 'agents'\n    | 'commands'\n    | 'workflows'\n    | 'templates'\n    /** Документы дерева, которые читает и человек, и агент: словарь проекта. */\n    | 'docs'\n    /**\n     * Образцы, которые копируют в рабочий файл и заполняют: папка задачи, спек домена.\n     *\n     * От шаблонов отличаются читателем и местом. Шаблон ложится в каталог слоя правил, и с него\n     * пишут ресурс этого слоя; образец ложится туда, где идёт работа, и копирует его тот, кто\n     * работу ведёт. Одним родом их не свести: дерево вправе отказаться от одних, оставив\n     * другие, и назвать им разные каталоги.\n     */\n    | 'samples'\n    /**\n     * `pitfalls` — холодная часть правила: ловушки и поведение по разборам происшествий. Ложится\n     * третьим файлом рядом с правилом и грузится не вместе с ним, а по требованию: при обычном\n     * решении она не нужна — она нужна тому, кто разбирает промах или спорит с гардом.\n     *\n     * От спутника отличается хозяином. Спутник пишет проект, и пакет кладёт его черновиком один\n     * раз; холодная часть принадлежит пакету целиком, поэтому перекладывается на каждой\n     * раскладке и сверяется наравне с правилом.\n     */\n    | 'pitfalls';\n\nexport const KINDS: readonly TKind[] = [\n    'laws',\n    'rules',\n    'pitfalls',\n    'patterns',\n    'skills',\n    'hooks',\n    'defaults',\n    'checks',\n    'agents',\n    'commands',\n    'workflows',\n    'templates',\n    'docs',\n    'samples',\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\n/**\n * Файл холодной части правила. Имя одно на все деревья: правило называет её строкой, и строка\n * эта переносима ровно потому, что имя не выбирается на месте.\n */\nexport const PITFALLS_FILE: string = 'pitfalls.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     * Что у дерева есть: `[\"packages\", \"app\"]`. Свойства объявлены пакетом в `assets/traits.json`,\n     * а ресурс, требующий свойства именем файла, дереву без него не кладётся вовсе — ни сам, ни\n     * черновик его компаньона. Пусто — дерево о себе ничего не сказало, и помеченного не получает.\n     */\n    readonly has: readonly string[];\n    /**\n     * Пишут ли гарды наблюдения о слое правил. Умолчание — да; выключает дерево, и целиком, а\n     * не частями. Ключ читают двое: сводка — отсюда, гард — тем же именем прямо из файла, потому\n     * что разборщика конфига у него нет.\n     */\n    readonly observe: boolean;\n    /**\n     * Роли слоя правил, которые дерево выключило, именами файлов без расширения:\n     * `[\"strict-teacher\"]`. Выключается обязательность вызова, а не сама роль: файл роли\n     * остаётся разложенным и зовётся руками, а гард при выключенной роли выходит молча.\n     * Ключ читают двое: сводка — отсюда, гард — тем же именем прямо из файла, потому что\n     * разборщика конфига у него нет.\n     */\n    readonly rolesOff: readonly string[];\n    /**\n     * Адрес приёма, куда уезжает груз: `https://…`. Пусто — отправлять некуда, и отправка\n     * отказывает вместо молчания. Зашитый в код адрес назвал бы чужое дерево в текстах пакета.\n     */\n    readonly intake: string;\n    /**\n     * Файл с токеном дерева — путь от корня дерева или от домашнего каталога (`~/…`). Сам токен\n     * в конфиге не лежит: конфиг коммитится, а токен обязан остаться вне истории.\n     */\n    readonly token: string;\n    /**\n     * Признак дерева, когда удалённого репозитория нет. При нём — считается из адреса\n     * репозитория: две рабочие копии одного репозитория обязаны дать один признак.\n     */\n    readonly tree: string;\n    /** Где дерево держит разборы происшествий. Путь от корня дерева. */\n    readonly postmortems: string;\n}\n\nexport const CONFIG_PATH: string = '.claude/rt-kit.json';\n/** Каталог, в котором дерево держит своё при пакете: надстройки, умолчания, свою карту и профиль. */\nexport const RT_KIT_DIR: string = '.claude/rt-kit';\nexport const OVERRIDES_DIR: string = '.claude/rt-kit/overrides';\n\n/**\n * Где разборы происшествий лежат, когда конфиг не сказал иначе. Роды ресурсов сюда не годятся:\n * разборы пишет дерево про себя, пакет их не раскладывает и не сверяет.\n */\nexport const DEFAULT_POSTMORTEMS_DIR: string = 'docs/postmortems';\n\n/**\n * Карта «что правится — какое правило» и профиль дерева: команды, стенды, пары «правка —\n * документ». Оба лежат в двух видах, и это не дублирование, а разделение ответственности.\n *\n * Умолчание везёт пакет: проекты этой мастерской устроены одинаково — Nx, те же расширения, те\n * же имена каталогов, — и переписывать одну и ту же карту в каждом дереве заново значило бы\n * заводить пятнадцать её редакций, расходящихся молча. Оно разложено, под шапкой, и правится\n * не на месте.\n *\n * Надстройку пишет проект, и она необязательна: витрина, свой род файлов, другой запускатель\n * тестов есть не у всех. Объявленная в ней функция замещает умолчание целиком и вправе позвать\n * его обратно суффиксом `_default` — так дерево дописывает своё, не теряя общего.\n */\n/** Каталог правил дерева: законы туда не идут, а правила, паттерны и скилы лежат вместе. */\nexport const SKILLS_DIR: string = '.claude/skills';\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: SKILLS_DIR,\n    // Холодная часть ложится в каталог своего правила, поэтому путь у неё тот же.\n    pitfalls: SKILLS_DIR,\n    patterns: SKILLS_DIR,\n    skills: SKILLS_DIR,\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    docs: 'docs',\n    // Внутри рода путь повторяет раскладку дерева — папки задач и спеки, — поэтому одного\n    // умолчания хватает всем образцам сразу.\n    samples: 'docs',\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\n/** Строковый ключ конфига. Ключа нет — пустая строка: значение необязательное у всех четырёх. */\nfunction textOf(value: unknown, where: string): string {\n    if (value === undefined || value === null) {\n        return '';\n    }\n    if (typeof value !== 'string') {\n        throw new ConfigError(`${where}: ожидается строка`);\n    }\n\n    return value.trim();\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        only,\n        skip,\n        vars: { ...derived, ...stringMap(raw['vars'], 'vars') },\n        layout: layout as Record<TKind, string>,\n        variants: stringMap(raw['variants'], 'variants'),\n        has: idList(raw['has'], 'has'),\n        // Выключателем считается только явное «нет»: ключа нет — запись идёт, как и у гарда.\n        observe: raw['observe'] !== false,\n        rolesOff: idList(raw['rolesOff'], 'rolesOff'),\n        intake: textOf(raw['intake'], 'intake'),\n        token: textOf(raw['token'], 'token'),\n        tree: textOf(raw['tree'], 'tree'),\n        postmortems: textOf(raw['postmortems'], 'postmortems') || DEFAULT_POSTMORTEMS_DIR,\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/hooks-map.d.ts

@@ -25,7 +25,20 @@ export declare function bindingsOf(text: string, path: string): readonly IHookBi
  * Гарды с одинаковым образцом внутри события собираются в одну запись — так же, как это пишут
  * руками, и так же, как читает агент.
  */
+/** Диспетчер событий: одна запись в настройке вместо списка гардов. Путь от корня дерева. */
+export declare const DISPATCH_PATH: string;
+/**
+ * Кусок настройки агента: по строке на событие, и каждая зовёт диспетчер с именем события.
+ *
+ * Прежде здесь стоял список гардов — по записи на образец вызова, — и агент запускал каждый
+ * своим процессом, подавая всем один и тот же ввод. Восемнадцать гардов на вызове инструмента
+ * разбирали его восемнадцать раз; замер дерева, где это считали, дал восемьсот двадцать шесть
+ * миллисекунд на вызов против четырёхсот сорока одной после. Образец вызова никуда не делся:
+ * его по-прежнему несёт шапка самого гарда, только сверяет его теперь диспетчер, а не агент.
+ */
 export declare function hooksSection(bindings: readonly IHookBinding[]): Record<string, unknown>;
+/** Прежний вид куска настройки: по записи на образец вызова. Остаётся ради разбора чужих настроек. */
+export declare function hooksSectionByMatcher(bindings: readonly IHookBinding[]): Record<string, unknown>;
 /** Пути гардов, названные в настройке агента этого дерева. Нет файла — ни одного. */
 export declare function boundInSettings(root: string): readonly string[];
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"hooks-map.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/hooks-map.ts"],"names":[],"mappings":"AAoBA,qEAAqE;AACrE,eAAO,MAAM,aAAa,EAAE,MAAgC,CAAC;AAI7D,MAAM,WAAW,YAAY;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAM9E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBvF;AAiDD,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAsB/D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAIrG;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAa5E;AAED,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAczG"}
+{"version":3,"file":"hooks-map.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/hooks-map.ts"],"names":[],"mappings":"AAoBA,qEAAqE;AACrE,eAAO,MAAM,aAAa,EAAE,MAAgC,CAAC;AAI7D,MAAM,WAAW,YAAY;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAM9E;AAED;;;;;GAKG;AACH,6FAA6F;AAC7F,eAAO,MAAM,aAAa,EAAE,MAAoC,CAAC;AAUjE;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASvF;AAED,sGAAsG;AACtG,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBhG;AAiDD,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAsB/D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAYrG;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAa5E;AAED,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAczG"}

package/lib/hooks-map.js

@@ -40,7 +40,34 @@ export function bindingsOf(text, path) {
  * Гарды с одинаковым образцом внутри события собираются в одну запись — так же, как это пишут
  * руками, и так же, как читает агент.
  */
+/** Диспетчер событий: одна запись в настройке вместо списка гардов. Путь от корня дерева. */
+export const DISPATCH_PATH = '.claude/hooks/dispatch.sh';
+/**
+ * Стоит ли в настройке диспетчер этого события. Он зовётся с именем события доводом, поэтому
+ * найденный путь без довода — не он: так стояла бы запись, зовущая диспетчер на всём подряд.
+ */
+function dispatchesEvent(text, event) {
+    return text.includes(`${DISPATCH_PATH} ${event}`);
+}
+/**
+ * Кусок настройки агента: по строке на событие, и каждая зовёт диспетчер с именем события.
+ *
+ * Прежде здесь стоял список гардов — по записи на образец вызова, — и агент запускал каждый
+ * своим процессом, подавая всем один и тот же ввод. Восемнадцать гардов на вызове инструмента
+ * разбирали его восемнадцать раз; замер дерева, где это считали, дал восемьсот двадцать шесть
+ * миллисекунд на вызов против четырёхсот сорока одной после. Образец вызова никуда не делся:
+ * его по-прежнему несёт шапка самого гарда, только сверяет его теперь диспетчер, а не агент.
+ */
 export function hooksSection(bindings) {
+    const events = new Set(bindings.map((binding) => binding.event));
+    const section = {};
+    for (const event of [...events].sort((left, right) => left.localeCompare(right))) {
+        section[event] = [{ hooks: [{ type: 'command', command: `$CLAUDE_PROJECT_DIR/${DISPATCH_PATH} ${event}` }] }];
+    }
+    return section;
+}
+/** Прежний вид куска настройки: по записи на образец вызова. Остаётся ради разбора чужих настроек. */
+export function hooksSectionByMatcher(bindings) {
     const events = new Map();
     for (const binding of bindings) {
         const byMatcher = events.get(binding.event) ?? new Map();
@@ -126,7 +153,12 @@ export function boundInSettings(root) {
  */
 export function unboundHooks(bindings, root) {
     const bound = new Set(boundInSettings(root));
-    return bindings.filter((binding) => !bound.has(`${binding.event} ${binding.path}`) && !bound.has(binding.path));
+    const path = join(root, SETTINGS_PATH);
+    const text = existsSync(path) ? readFileSync(path, 'utf8') : '';
+    // Событие, отданное диспетчеру, подключает все свои гарды разом: их пути в настройке не
+    // стоят вовсе — диспетчер собирает ветки по объявлениям в шапках. Искать там имя каждого
+    // гарда значило бы называть неподключённым весь набор.
+    return bindings.filter((binding) => !dispatchesEvent(text, binding.event) && !bound.has(`${binding.event} ${binding.path}`) && !bound.has(binding.path));
 }
 /**
  * Образцы, под которыми гарды стоят в настройке агента: ключ — «событие и путь».

package/lib/hooks-map.js.map

@@ -1 +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';\nimport { byKey } from './order.js';\n\n/** Настройка агента, в которой живёт карта. Путь от корня дерева. */\nexport const SETTINGS_PATH: string = '.claude/settings.json';\n\nconst DECLARATION: RegExp = /^#\\s*rt-hook:\\s*(\\S+)(?:[ \\t]+(\\S.*))?$/gm;\n\nexport interface IHookBinding {\n    /** Событие агента: `PreToolUse`, `PostToolUse`, `SessionStart`, `Stop`. */\n    readonly event: string;\n    /**\n     * Образец, по которому событие достаётся этому гарду. Пустой у события, которое не про\n     * инструмент: завершение хода приходит целиком, и выбирать в нём нечего.\n     */\n    readonly matcher: string;\n    /** Путь разложенного гарда от корня дерева. */\n    readonly path: string;\n}\n\n/**\n * Что гард говорит о себе. Молчит — он не подключается к агенту вовсе.\n *\n * Объявлений бывает несколько: гард, который сперва напоминает, а потом отбивает, стоит на двух\n * событиях сразу. Разводить его по двум файлам значило бы держать два разбора одной записи и\n * два места, где правится один порог.\n */\nexport function bindingsOf(text: string, path: string): readonly IHookBinding[] {\n    return [...text.matchAll(DECLARATION)].map((found: RegExpMatchArray): IHookBinding => ({\n        event: found[1],\n        matcher: (found[2] ?? '').trim(),\n        path,\n    }));\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(byKey)) {\n        section[event] = [...byMatcher].sort(byKey).map(([matcher, paths]: [string, readonly string[]]): unknown => {\n            const hooks: unknown[] = paths.map((path: string): unknown => ({\n                type: 'command',\n                command: `$CLAUDE_PROJECT_DIR/${path}`,\n            }));\n\n            // Запись без образца — не запись с пустым образцом: агент читает пустую строку как\n            // образец, которому не соответствует ни один вызов, и гард молча не зовётся.\n            return matcher ? { matcher, hooks } : { hooks };\n        });\n    }\n\n    return section;\n}\n\n/** Одна команда гарда в настройке агента: событие, путь и образец, под которым она стоит. */\ninterface ISettingsHook {\n    readonly event: string;\n    readonly path: string;\n    readonly matcher: string;\n}\n\n/** Команды одной записи настройки: у всех у них общий образец — он объявлен записью, а не командой. */\nfunction hooksOfRecord(event: string, record: unknown): readonly ISettingsHook[] {\n    const asked: unknown = (record as Record<string, unknown> | null)?.['matcher'];\n    const matcher: string = typeof asked === 'string' ? asked.trim() : '';\n    const commands: unknown = (record as Record<string, unknown> | null)?.['hooks'];\n    const found: ISettingsHook[] = [];\n\n    for (const command of Array.isArray(commands) ? commands : []) {\n        const line: unknown = (command as Record<string, unknown> | null)?.['command'];\n\n        if (typeof line === 'string') {\n            const at: number = line.indexOf('.claude/');\n\n            found.push({ event, matcher, path: at < 0 ? line : line.slice(at) });\n        }\n    }\n\n    return found;\n}\n\n/** Все команды гардов из настройки агента плоским списком. Текст не разбирается — отказ разбора. */\nfunction hooksInSettings(text: string): readonly ISettingsHook[] {\n    const settings: unknown = JSON.parse(text);\n    const hooks: unknown = (settings as Record<string, unknown> | null)?.['hooks'];\n    const found: ISettingsHook[] = [];\n\n    for (const [event, records] of Object.entries((hooks ?? {}) as Record<string, unknown>)) {\n        for (const record of Array.isArray(records) ? records : []) {\n            found.push(...hooksOfRecord(event, record));\n        }\n    }\n\n    return found;\n}\n\n/** Ключ, которым гард узнаётся: событие и путь вместе — на двух событиях он стоит дважды. */\nfunction keyOf(hook: ISettingsHook): string {\n    return `${hook.event} ${hook.path}`;\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    // одному имени файла этого не увидеть — подключённый к первому событию выглядел бы\n    // подключённым и ко второму.\n    try {\n        return hooksInSettings(text).map(keyOf);\n    } catch {\n        // Настройку дерево вправе держать так, как ему удобно, — вплоть до комментариев, которых\n        // JSON не разбирает. Тогда ищется одно: назван ли путь гарда хоть где-нибудь в ней.\n        return [...text.matchAll(/\\.claude\\/hooks\\/[\\w.-]+\\.sh/g)].map((found: RegExpMatchArray): string => found[0]);\n    }\n}\n\n/**\n * Разложенные гарды, которых в настройке агента нет: они лежат, но их никто не позовёт.\n *\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.event} ${binding.path}`) && !bound.has(binding.path));\n}\n\n/**\n * Образцы, под которыми гарды стоят в настройке агента: ключ — «событие и путь».\n *\n * Настройку, которую не разобрать, читать здесь нечем: образец лежит полем объекта, и вынуть его\n * из текста поиском значило бы гадать. Тогда карта пуста, и расхождений не находится ни одного —\n * это честнее, чем назвать расхождением то, чего не прочитали.\n */\nexport function matchersInSettings(root: string): ReadonlyMap<string, string> {\n    const path: string = join(root, SETTINGS_PATH);\n    if (!existsSync(path)) {\n        return new Map();\n    }\n\n    try {\n        return new Map(\n            hooksInSettings(readFileSync(path, 'utf8')).map((one: ISettingsHook): [string, string] => [keyOf(one), one.matcher])\n        );\n    } catch {\n        return new Map();\n    }\n}\n\n/** Гард, чьё объявление разошлось с образцом, под которым его зовут. */\nexport interface IMatcherDrift {\n    readonly event: string;\n    readonly path: string;\n    /** Что гард объявляет о себе строкой `# rt-hook:`. */\n    readonly declared: string;\n    /** Под чем он на самом деле стоит в настройке агента. */\n    readonly bound: string;\n}\n\n/**\n * Расхождения объявления гарда с образцом, под которым его зовут.\n *\n * Гард, подписанный не на то, что объявляет, хуже неподключённого: снаружи он выглядит\n * работающим — путь его в настройке назван, файл разложен, набор сценариев зелёный, — а вызов,\n * ради которого его тело и написано, до него не доходит никогда. Так гейт правил и разбирал\n * вызовы браузера веткой, которая не исполнялась ни разу: набор звал гард напрямую с\n * подставленным вводом и объявления не читал вовсе.\n *\n * Судятся только подключённые гарды: о неподключённых говорит своя строка, и назвать их дважды\n * значило бы спрятать настоящее расхождение среди повторов.\n */\nexport function driftedMatchers(bindings: readonly IHookBinding[], root: string): readonly IMatcherDrift[] {\n    const bound: ReadonlyMap<string, string> = matchersInSettings(root);\n    const drifts: IMatcherDrift[] = [];\n\n    for (const binding of bindings) {\n        const key: string = `${binding.event} ${binding.path}`;\n        const inSettings: string | undefined = bound.get(key);\n        if (inSettings === undefined || inSettings === binding.matcher) {\n            continue;\n        }\n        drifts.push({ event: binding.event, path: binding.path, declared: binding.matcher, bound: inSettings });\n    }\n\n    return drifts;\n}\n"]}
+{"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';\nimport { byKey } from './order.js';\n\n/** Настройка агента, в которой живёт карта. Путь от корня дерева. */\nexport const SETTINGS_PATH: string = '.claude/settings.json';\n\nconst DECLARATION: RegExp = /^#\\s*rt-hook:\\s*(\\S+)(?:[ \\t]+(\\S.*))?$/gm;\n\nexport interface IHookBinding {\n    /** Событие агента: `PreToolUse`, `PostToolUse`, `SessionStart`, `Stop`. */\n    readonly event: string;\n    /**\n     * Образец, по которому событие достаётся этому гарду. Пустой у события, которое не про\n     * инструмент: завершение хода приходит целиком, и выбирать в нём нечего.\n     */\n    readonly matcher: string;\n    /** Путь разложенного гарда от корня дерева. */\n    readonly path: string;\n}\n\n/**\n * Что гард говорит о себе. Молчит — он не подключается к агенту вовсе.\n *\n * Объявлений бывает несколько: гард, который сперва напоминает, а потом отбивает, стоит на двух\n * событиях сразу. Разводить его по двум файлам значило бы держать два разбора одной записи и\n * два места, где правится один порог.\n */\nexport function bindingsOf(text: string, path: string): readonly IHookBinding[] {\n    return [...text.matchAll(DECLARATION)].map((found: RegExpMatchArray): IHookBinding => ({\n        event: found[1],\n        matcher: (found[2] ?? '').trim(),\n        path,\n    }));\n}\n\n/**\n * Раздел `hooks` для настройки агента: событие → образец → команда.\n *\n * Гарды с одинаковым образцом внутри события собираются в одну запись — так же, как это пишут\n * руками, и так же, как читает агент.\n */\n/** Диспетчер событий: одна запись в настройке вместо списка гардов. Путь от корня дерева. */\nexport const DISPATCH_PATH: string = '.claude/hooks/dispatch.sh';\n\n/**\n * Стоит ли в настройке диспетчер этого события. Он зовётся с именем события доводом, поэтому\n * найденный путь без довода — не он: так стояла бы запись, зовущая диспетчер на всём подряд.\n */\nfunction dispatchesEvent(text: string, event: string): boolean {\n    return text.includes(`${DISPATCH_PATH} ${event}`);\n}\n\n/**\n * Кусок настройки агента: по строке на событие, и каждая зовёт диспетчер с именем события.\n *\n * Прежде здесь стоял список гардов — по записи на образец вызова, — и агент запускал каждый\n * своим процессом, подавая всем один и тот же ввод. Восемнадцать гардов на вызове инструмента\n * разбирали его восемнадцать раз; замер дерева, где это считали, дал восемьсот двадцать шесть\n * миллисекунд на вызов против четырёхсот сорока одной после. Образец вызова никуда не делся:\n * его по-прежнему несёт шапка самого гарда, только сверяет его теперь диспетчер, а не агент.\n */\nexport function hooksSection(bindings: readonly IHookBinding[]): Record<string, unknown> {\n    const events: Set<string> = new Set(bindings.map((binding: IHookBinding): string => binding.event));\n    const section: Record<string, unknown> = {};\n\n    for (const event of [...events].sort((left: string, right: string): number => left.localeCompare(right))) {\n        section[event] = [{ hooks: [{ type: 'command', command: `$CLAUDE_PROJECT_DIR/${DISPATCH_PATH} ${event}` }] }];\n    }\n\n    return section;\n}\n\n/** Прежний вид куска настройки: по записи на образец вызова. Остаётся ради разбора чужих настроек. */\nexport function hooksSectionByMatcher(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(byKey)) {\n        section[event] = [...byMatcher].sort(byKey).map(([matcher, paths]: [string, readonly string[]]): unknown => {\n            const hooks: unknown[] = paths.map((path: string): unknown => ({\n                type: 'command',\n                command: `$CLAUDE_PROJECT_DIR/${path}`,\n            }));\n\n            // Запись без образца — не запись с пустым образцом: агент читает пустую строку как\n            // образец, которому не соответствует ни один вызов, и гард молча не зовётся.\n            return matcher ? { matcher, hooks } : { hooks };\n        });\n    }\n\n    return section;\n}\n\n/** Одна команда гарда в настройке агента: событие, путь и образец, под которым она стоит. */\ninterface ISettingsHook {\n    readonly event: string;\n    readonly path: string;\n    readonly matcher: string;\n}\n\n/** Команды одной записи настройки: у всех у них общий образец — он объявлен записью, а не командой. */\nfunction hooksOfRecord(event: string, record: unknown): readonly ISettingsHook[] {\n    const asked: unknown = (record as Record<string, unknown> | null)?.['matcher'];\n    const matcher: string = typeof asked === 'string' ? asked.trim() : '';\n    const commands: unknown = (record as Record<string, unknown> | null)?.['hooks'];\n    const found: ISettingsHook[] = [];\n\n    for (const command of Array.isArray(commands) ? commands : []) {\n        const line: unknown = (command as Record<string, unknown> | null)?.['command'];\n\n        if (typeof line === 'string') {\n            const at: number = line.indexOf('.claude/');\n\n            found.push({ event, matcher, path: at < 0 ? line : line.slice(at) });\n        }\n    }\n\n    return found;\n}\n\n/** Все команды гардов из настройки агента плоским списком. Текст не разбирается — отказ разбора. */\nfunction hooksInSettings(text: string): readonly ISettingsHook[] {\n    const settings: unknown = JSON.parse(text);\n    const hooks: unknown = (settings as Record<string, unknown> | null)?.['hooks'];\n    const found: ISettingsHook[] = [];\n\n    for (const [event, records] of Object.entries((hooks ?? {}) as Record<string, unknown>)) {\n        for (const record of Array.isArray(records) ? records : []) {\n            found.push(...hooksOfRecord(event, record));\n        }\n    }\n\n    return found;\n}\n\n/** Ключ, которым гард узнаётся: событие и путь вместе — на двух событиях он стоит дважды. */\nfunction keyOf(hook: ISettingsHook): string {\n    return `${hook.event} ${hook.path}`;\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    // одному имени файла этого не увидеть — подключённый к первому событию выглядел бы\n    // подключённым и ко второму.\n    try {\n        return hooksInSettings(text).map(keyOf);\n    } catch {\n        // Настройку дерево вправе держать так, как ему удобно, — вплоть до комментариев, которых\n        // JSON не разбирает. Тогда ищется одно: назван ли путь гарда хоть где-нибудь в ней.\n        return [...text.matchAll(/\\.claude\\/hooks\\/[\\w.-]+\\.sh/g)].map((found: RegExpMatchArray): string => found[0]);\n    }\n}\n\n/**\n * Разложенные гарды, которых в настройке агента нет: они лежат, но их никто не позовёт.\n *\n * Разбор настройки называет пару «событие и путь», а падение назад — один путь. Поэтому\n * подключённым считается и то, и другое: иначе дерево с настройкой, которую не разобрать,\n * получало бы список из всех гардов разом.\n */\nexport function unboundHooks(bindings: readonly IHookBinding[], root: string): readonly IHookBinding[] {\n    const bound: ReadonlySet<string> = new Set(boundInSettings(root));\n    const path: string = join(root, SETTINGS_PATH);\n    const text: string = existsSync(path) ? readFileSync(path, 'utf8') : '';\n\n    // Событие, отданное диспетчеру, подключает все свои гарды разом: их пути в настройке не\n    // стоят вовсе — диспетчер собирает ветки по объявлениям в шапках. Искать там имя каждого\n    // гарда значило бы называть неподключённым весь набор.\n    return bindings.filter(\n        (binding: IHookBinding): boolean =>\n            !dispatchesEvent(text, binding.event) && !bound.has(`${binding.event} ${binding.path}`) && !bound.has(binding.path)\n    );\n}\n\n/**\n * Образцы, под которыми гарды стоят в настройке агента: ключ — «событие и путь».\n *\n * Настройку, которую не разобрать, читать здесь нечем: образец лежит полем объекта, и вынуть его\n * из текста поиском значило бы гадать. Тогда карта пуста, и расхождений не находится ни одного —\n * это честнее, чем назвать расхождением то, чего не прочитали.\n */\nexport function matchersInSettings(root: string): ReadonlyMap<string, string> {\n    const path: string = join(root, SETTINGS_PATH);\n    if (!existsSync(path)) {\n        return new Map();\n    }\n\n    try {\n        return new Map(\n            hooksInSettings(readFileSync(path, 'utf8')).map((one: ISettingsHook): [string, string] => [keyOf(one), one.matcher])\n        );\n    } catch {\n        return new Map();\n    }\n}\n\n/** Гард, чьё объявление разошлось с образцом, под которым его зовут. */\nexport interface IMatcherDrift {\n    readonly event: string;\n    readonly path: string;\n    /** Что гард объявляет о себе строкой `# rt-hook:`. */\n    readonly declared: string;\n    /** Под чем он на самом деле стоит в настройке агента. */\n    readonly bound: string;\n}\n\n/**\n * Расхождения объявления гарда с образцом, под которым его зовут.\n *\n * Гард, подписанный не на то, что объявляет, хуже неподключённого: снаружи он выглядит\n * работающим — путь его в настройке назван, файл разложен, набор сценариев зелёный, — а вызов,\n * ради которого его тело и написано, до него не доходит никогда. Так гейт правил и разбирал\n * вызовы браузера веткой, которая не исполнялась ни разу: набор звал гард напрямую с\n * подставленным вводом и объявления не читал вовсе.\n *\n * Судятся только подключённые гарды: о неподключённых говорит своя строка, и назвать их дважды\n * значило бы спрятать настоящее расхождение среди повторов.\n */\nexport function driftedMatchers(bindings: readonly IHookBinding[], root: string): readonly IMatcherDrift[] {\n    const bound: ReadonlyMap<string, string> = matchersInSettings(root);\n    const drifts: IMatcherDrift[] = [];\n\n    for (const binding of bindings) {\n        const key: string = `${binding.event} ${binding.path}`;\n        const inSettings: string | undefined = bound.get(key);\n        if (inSettings === undefined || inSettings === binding.matcher) {\n            continue;\n        }\n        drifts.push({ event: binding.event, path: binding.path, declared: binding.matcher, bound: inSettings });\n    }\n\n    return drifts;\n}\n"]}

package/lib/ship.d.ts

@@ -1,5 +1,4 @@
 import { IIntakeAccepted } from './cargo.js';
-import { TMarkCall } from './cargo-state.js';
 /**
  * Предел ожидания приёма. Без него молчащая — не отказавшая — служба держит отправку до
  * умолчания среды, а это минуты: человек, позвавший команду, видит не отказ, а зависший запуск.
@@ -37,6 +36,6 @@ export declare function intakeUrl(intake: string, operation: string): string;
 export declare function readToken(root: string, spoken: string): string;
 /** Запрос приёма. Токен уезжает заголовком и в теле не появляется ни разу. */
 export declare const httpShip: TShip;
+/** Два числа и отбитые строки из ответа приёма. Ответ не тем — пусто. */
 /** Запрос правки состояния. Токен уезжает заголовком и в теле не появляется ни разу. */
-export declare const httpMark: TMarkCall;
 //# sourceMappingURL=ship.d.ts.map

package/lib/ship.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ship.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/ship.ts"],"names":[],"mappings":"AAcA,OAAO,EAA2D,eAAe,EAAsC,MAAM,YAAY,CAAC;AAC1I,OAAO,EAAW,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAe,CAAC;AAE9C,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACtB,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CAC1B;AAED,+FAA+F;AAC/F,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAC7C;AAED,wDAAwD;AACxD,MAAM,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAa9F,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ9D;AAqCD,8EAA8E;AAC9E,eAAO,MAAM,QAAQ,EAAE,KAiBtB,CAAC;AAwCF,wFAAwF;AACxF,eAAO,MAAM,QAAQ,EAAE,SAsBtB,CAAC"}
+{"version":3,"file":"ship.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/ship.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,eAAe,EAAqB,MAAM,YAAY,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAe,CAAC;AAE9C,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACtB,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CAC1B;AAED,+FAA+F;AAC/F,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAC7C;AAED,wDAAwD;AACxD,MAAM,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAa9F,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ9D;AAqCD,8EAA8E;AAC9E,eAAO,MAAM,QAAQ,EAAE,KAiBtB,CAAC;AAEF,yEAAyE;AAEzE,wFAAwF"}

package/lib/ship.js

@@ -92,60 +92,6 @@ export const httpShip = async (intake, token, shipment) => {
     const text = await answer.text();
     return { ok: answer.ok, status: answer.status, said: saidOf(text), accepted: answer.ok ? acceptedOf(text) : null };
 };
-/** Отбитые строки из ответа приёма. Не список — пусто: своё устройство приём не пересказывает. */
-function deniedOf(raw) {
-    if (!Array.isArray(raw)) {
-        return [];
-    }
-    return raw
-        .filter((one) => typeof one === 'object' && one !== null)
-        .map((one) => {
-        const line = one;
-        return {
-            at: typeof line['at'] === 'number' ? line['at'] : 0,
-            kind: String(line['kind']),
-            key: String(line['key']),
-            denial: String(line['denial']),
-        };
-    });
-}
 /** Два числа и отбитые строки из ответа приёма. Ответ не тем — пусто. */
-function stateAcceptedOf(text) {
-    try {
-        const said = JSON.parse(text);
-        return typeof said['tree'] === 'string' && typeof said['changed'] === 'number'
-            ? {
-                tree: said['tree'],
-                changed: said['changed'],
-                same: typeof said['same'] === 'number' ? said['same'] : 0,
-                denied: deniedOf(said['denied']),
-            }
-            : null;
-    }
-    catch {
-        return null;
-    }
-}
 /** Запрос правки состояния. Токен уезжает заголовком и в теле не появляется ни разу. */
-export const httpMark = async (intake, token, body) => {
-    let answer;
-    try {
-        answer = await fetch(intakeUrl(intake, 'states'), {
-            method: 'POST',
-            headers: { 'content-type': 'application/json', [TREE_TOKEN_HEADER]: token },
-            body: JSON.stringify(body),
-            signal: AbortSignal.timeout(SHIP_TIMEOUT_MS),
-        });
-    }
-    catch (error) {
-        return { ok: false, status: 0, said: error.message, accepted: null };
-    }
-    const text = await answer.text();
-    return {
-        ok: answer.ok,
-        status: answer.status,
-        said: saidOf(text),
-        accepted: answer.ok ? stateAcceptedOf(text) : null,
-    };
-};
 //# sourceMappingURL=ship.js.map

package/lib/ship.js.map

@@ -1 +1 @@
-{"version":3,"file":"ship.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/ship.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Отправка груза в приём: единственное место пакета, которое ходит в сеть.\n *\n * Ходит оно только по команде человека — ни один гард в сеть не ходит вовсе. Вынесено отдельно,\n * чтобы сборка груза осталась проверяемой: спека подставляет двойник и никуда не стучится.\n *\n * Груз уезжает в закрытый приём, а не в открытую очередь работ: сводка говорит о рабочих\n * привычках команды — чем пользуются, обо что спотыкаются, сколько раз признавали промах, — и в\n * открытой очереди это выложено всему свету.\n */\nimport { existsSync, readFileSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\n\nimport { ICargoStateAccepted, ICargoStateBody, ICargoStateDenied, IIntakeAccepted, TCargoStateKind, TREE_TOKEN_HEADER } from './cargo.js';\nimport { IMarked, TMarkCall } from './cargo-state.js';\n\n/**\n * Предел ожидания приёма. Без него молчащая — не отказавшая — служба держит отправку до\n * умолчания среды, а это минуты: человек, позвавший команду, видит не отказ, а зависший запуск.\n */\nexport const SHIP_TIMEOUT_MS: number = 15_000;\n\n/** Что уезжает одним запросом: род груза словом, операция приёма и тело. */\nexport interface IShipment {\n    /** Род груза словами — его называет отказ: дерево шлёт три рода и должно знать, какой отбит. */\n    readonly kind: string;\n    /** Последнее звено адреса операции: `summary`, `proposals`, `postmortems`. */\n    readonly operation: string;\n    readonly body: unknown;\n}\n\n/** Чем кончился один запрос. Отказ — такой же ответ, как принятое: его печатает вызывающий. */\nexport interface IShipped {\n    readonly ok: boolean;\n    /** Код ответа. Ноль — приём не ответил вовсе: не дозвонились, оборвалось, вышло время. */\n    readonly status: number;\n    /** Что сказал приём. У неотвеченного запроса — причина, по которой он не состоялся. */\n    readonly said: string;\n    /** Дерево и месяц записи. Пусто у отказа: приём их называет только у принятого груза. */\n    readonly accepted: IIntakeAccepted | null;\n}\n\n/** Чем груз уезжает. Двойник в спеке — того же вида. */\nexport type TShip = (intake: string, token: string, shipment: IShipment) => Promise<IShipped>;\n\n/** Адрес без косых черт в конце: их считает сам вызывающий, а не движок разбора образцов. */\nfunction withoutTrailingSlash(address: string): string {\n    let end: number = address.length;\n\n    while (end > 0 && address[end - 1] === '/') {\n        end -= 1;\n    }\n\n    return address.slice(0, end);\n}\n\n/** Адрес операции приёма. Косая черта в конце адреса приёма второй не становится. */\nexport function intakeUrl(intake: string, operation: string): string {\n    return `${withoutTrailingSlash(intake)}/api/intake/${operation}`;\n}\n\n/**\n * Токен дерева из файла, названного настройкой.\n *\n * Путь читается и от корня дерева, и от домашнего каталога: токен обязан лежать вне дерева —\n * конфиг коммитится, а токен переживать историю не должен. Файла нет — пустая строка, и отказ\n * об этом скажет словами.\n */\nexport function readToken(root: string, spoken: string): string {\n    if (!spoken) {\n        return '';\n    }\n\n    const path: string = spoken.startsWith('~/') ? join(homedir(), spoken.slice(2)) : join(root, spoken);\n\n    return existsSync(path) ? readFileSync(path, 'utf8').trim() : '';\n}\n\n/** Число из ответа приёма. Не число — пусто: поля есть только у предложений и не у всякого приёма. */\nfunction countOf(said: Record<string, unknown>, field: string): number | undefined {\n    return typeof said[field] === 'number' ? said[field] : undefined;\n}\n\n/** Дерево и месяц из ответа приёма. Ответ не тем — пусто: своё устройство приём не пересказывает. */\nfunction acceptedOf(text: string): IIntakeAccepted | null {\n    try {\n        const said: Record<string, unknown> = JSON.parse(text) as Record<string, unknown>;\n\n        return typeof said['tree'] === 'string' && typeof said['month'] === 'string'\n            ? {\n                  tree: said['tree'],\n                  month: said['month'],\n                  created: said['created'] === true,\n                  added: countOf(said, 'added'),\n                  known: countOf(said, 'known'),\n              }\n            : null;\n    } catch {\n        return null;\n    }\n}\n\n/** Что сказал приём: его собственное сообщение, а если тело не разбирается — тело как приехало. */\nfunction saidOf(text: string): string {\n    try {\n        const said: Record<string, unknown> = JSON.parse(text) as Record<string, unknown>;\n\n        return typeof said['message'] === 'string' ? said['message'] : text.trim();\n    } catch {\n        return text.trim();\n    }\n}\n\n/** Запрос приёма. Токен уезжает заголовком и в теле не появляется ни разу. */\nexport const httpShip: TShip = async (intake: string, token: string, shipment: IShipment): Promise<IShipped> => {\n    let answer: Response;\n\n    try {\n        answer = await fetch(intakeUrl(intake, shipment.operation), {\n            method: 'POST',\n            headers: { 'content-type': 'application/json', [TREE_TOKEN_HEADER]: token },\n            body: JSON.stringify(shipment.body),\n            signal: AbortSignal.timeout(SHIP_TIMEOUT_MS),\n        });\n    } catch (error: unknown) {\n        return { ok: false, status: 0, said: (error as Error).message, accepted: null };\n    }\n\n    const text: string = await answer.text();\n\n    return { ok: answer.ok, status: answer.status, said: saidOf(text), accepted: answer.ok ? acceptedOf(text) : null };\n};\n\n/** Отбитые строки из ответа приёма. Не список — пусто: своё устройство приём не пересказывает. */\nfunction deniedOf(raw: unknown): readonly ICargoStateDenied[] {\n    if (!Array.isArray(raw)) {\n        return [];\n    }\n\n    return raw\n        .filter((one: unknown): boolean => typeof one === 'object' && one !== null)\n        .map((one: unknown): ICargoStateDenied => {\n            const line: Record<string, unknown> = one as Record<string, unknown>;\n\n            return {\n                at: typeof line['at'] === 'number' ? line['at'] : 0,\n                kind: String(line['kind']) as TCargoStateKind,\n                key: String(line['key']),\n                denial: String(line['denial']),\n            };\n        });\n}\n\n/** Два числа и отбитые строки из ответа приёма. Ответ не тем — пусто. */\nfunction stateAcceptedOf(text: string): ICargoStateAccepted | null {\n    try {\n        const said: Record<string, unknown> = JSON.parse(text) as Record<string, unknown>;\n\n        return typeof said['tree'] === 'string' && typeof said['changed'] === 'number'\n            ? {\n                  tree: said['tree'],\n                  changed: said['changed'],\n                  same: typeof said['same'] === 'number' ? said['same'] : 0,\n                  denied: deniedOf(said['denied']),\n              }\n            : null;\n    } catch {\n        return null;\n    }\n}\n\n/** Запрос правки состояния. Токен уезжает заголовком и в теле не появляется ни разу. */\nexport const httpMark: TMarkCall = async (intake: string, token: string, body: ICargoStateBody): Promise<IMarked> => {\n    let answer: Response;\n\n    try {\n        answer = await fetch(intakeUrl(intake, 'states'), {\n            method: 'POST',\n            headers: { 'content-type': 'application/json', [TREE_TOKEN_HEADER]: token },\n            body: JSON.stringify(body),\n            signal: AbortSignal.timeout(SHIP_TIMEOUT_MS),\n        });\n    } catch (error: unknown) {\n        return { ok: false, status: 0, said: (error as Error).message, accepted: null };\n    }\n\n    const text: string = await answer.text();\n\n    return {\n        ok: answer.ok,\n        status: answer.status,\n        said: saidOf(text),\n        accepted: answer.ok ? stateAcceptedOf(text) : null,\n    };\n};\n"]}
+{"version":3,"file":"ship.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/ship.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Отправка груза в приём: единственное место пакета, которое ходит в сеть.\n *\n * Ходит оно только по команде человека — ни один гард в сеть не ходит вовсе. Вынесено отдельно,\n * чтобы сборка груза осталась проверяемой: спека подставляет двойник и никуда не стучится.\n *\n * Груз уезжает в закрытый приём, а не в открытую очередь работ: сводка говорит о рабочих\n * привычках команды — чем пользуются, обо что спотыкаются, сколько раз признавали промах, — и в\n * открытой очереди это выложено всему свету.\n */\nimport { existsSync, readFileSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\n\nimport { IIntakeAccepted, TREE_TOKEN_HEADER } from './cargo.js';\n\n/**\n * Предел ожидания приёма. Без него молчащая — не отказавшая — служба держит отправку до\n * умолчания среды, а это минуты: человек, позвавший команду, видит не отказ, а зависший запуск.\n */\nexport const SHIP_TIMEOUT_MS: number = 15_000;\n\n/** Что уезжает одним запросом: род груза словом, операция приёма и тело. */\nexport interface IShipment {\n    /** Род груза словами — его называет отказ: дерево шлёт три рода и должно знать, какой отбит. */\n    readonly kind: string;\n    /** Последнее звено адреса операции: `summary`, `proposals`, `postmortems`. */\n    readonly operation: string;\n    readonly body: unknown;\n}\n\n/** Чем кончился один запрос. Отказ — такой же ответ, как принятое: его печатает вызывающий. */\nexport interface IShipped {\n    readonly ok: boolean;\n    /** Код ответа. Ноль — приём не ответил вовсе: не дозвонились, оборвалось, вышло время. */\n    readonly status: number;\n    /** Что сказал приём. У неотвеченного запроса — причина, по которой он не состоялся. */\n    readonly said: string;\n    /** Дерево и месяц записи. Пусто у отказа: приём их называет только у принятого груза. */\n    readonly accepted: IIntakeAccepted | null;\n}\n\n/** Чем груз уезжает. Двойник в спеке — того же вида. */\nexport type TShip = (intake: string, token: string, shipment: IShipment) => Promise<IShipped>;\n\n/** Адрес без косых черт в конце: их считает сам вызывающий, а не движок разбора образцов. */\nfunction withoutTrailingSlash(address: string): string {\n    let end: number = address.length;\n\n    while (end > 0 && address[end - 1] === '/') {\n        end -= 1;\n    }\n\n    return address.slice(0, end);\n}\n\n/** Адрес операции приёма. Косая черта в конце адреса приёма второй не становится. */\nexport function intakeUrl(intake: string, operation: string): string {\n    return `${withoutTrailingSlash(intake)}/api/intake/${operation}`;\n}\n\n/**\n * Токен дерева из файла, названного настройкой.\n *\n * Путь читается и от корня дерева, и от домашнего каталога: токен обязан лежать вне дерева —\n * конфиг коммитится, а токен переживать историю не должен. Файла нет — пустая строка, и отказ\n * об этом скажет словами.\n */\nexport function readToken(root: string, spoken: string): string {\n    if (!spoken) {\n        return '';\n    }\n\n    const path: string = spoken.startsWith('~/') ? join(homedir(), spoken.slice(2)) : join(root, spoken);\n\n    return existsSync(path) ? readFileSync(path, 'utf8').trim() : '';\n}\n\n/** Число из ответа приёма. Не число — пусто: поля есть только у предложений и не у всякого приёма. */\nfunction countOf(said: Record<string, unknown>, field: string): number | undefined {\n    return typeof said[field] === 'number' ? said[field] : undefined;\n}\n\n/** Дерево и месяц из ответа приёма. Ответ не тем — пусто: своё устройство приём не пересказывает. */\nfunction acceptedOf(text: string): IIntakeAccepted | null {\n    try {\n        const said: Record<string, unknown> = JSON.parse(text) as Record<string, unknown>;\n\n        return typeof said['tree'] === 'string' && typeof said['month'] === 'string'\n            ? {\n                  tree: said['tree'],\n                  month: said['month'],\n                  created: said['created'] === true,\n                  added: countOf(said, 'added'),\n                  known: countOf(said, 'known'),\n              }\n            : null;\n    } catch {\n        return null;\n    }\n}\n\n/** Что сказал приём: его собственное сообщение, а если тело не разбирается — тело как приехало. */\nfunction saidOf(text: string): string {\n    try {\n        const said: Record<string, unknown> = JSON.parse(text) as Record<string, unknown>;\n\n        return typeof said['message'] === 'string' ? said['message'] : text.trim();\n    } catch {\n        return text.trim();\n    }\n}\n\n/** Запрос приёма. Токен уезжает заголовком и в теле не появляется ни разу. */\nexport const httpShip: TShip = async (intake: string, token: string, shipment: IShipment): Promise<IShipped> => {\n    let answer: Response;\n\n    try {\n        answer = await fetch(intakeUrl(intake, shipment.operation), {\n            method: 'POST',\n            headers: { 'content-type': 'application/json', [TREE_TOKEN_HEADER]: token },\n            body: JSON.stringify(shipment.body),\n            signal: AbortSignal.timeout(SHIP_TIMEOUT_MS),\n        });\n    } catch (error: unknown) {\n        return { ok: false, status: 0, said: (error as Error).message, accepted: null };\n    }\n\n    const text: string = await answer.text();\n\n    return { ok: answer.ok, status: answer.status, said: saidOf(text), accepted: answer.ok ? acceptedOf(text) : null };\n};\n\n/** Два числа и отбитые строки из ответа приёма. Ответ не тем — пусто. */\n\n/** Запрос правки состояния. Токен уезжает заголовком и в теле не появляется ни разу. */\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rt-tools/agent-kit",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Переносимый слой правил для агента: законы, хуки, проверки и агенты, раскладываемые в репозиторий одной командой",
   "author": "RT Team",
   "license": "Apache-2.0",

package/assets/commands/agent-kit-digest.md

@@ -1,89 +0,0 @@
----
-description: Свести накопленные предложения и наблюдения в правки ресурсов пакета правил
-argument-hint: '[пусто | --days N]'
----
-
-Собери предложения, пришедшие из деревьев, и скажи, что из них становится правкой пакета.
-Отрезок от пользователя: `$ARGUMENTS` (без довода — три дня).
-
-Зовётся **в репозитории самого пакета**, а не в дереве, где он стоит: здесь лежат ресурсы,
-которые предстоит править, и видно всех потребителей сразу. В чужом дереве команда бессмысленна
-— там есть только своя половина картины.
-
-## 1. Собери, что пришло
-
-Чем груз читается и что значит взять его в работу, говорит правило `cargo-triage`: здесь этот
-порядок не повторяется, а зовётся. Сведению от него нужен один шаг — список неразобранного,
-суженный отбором по состоянию «новое».
-
-Записи, заведённые прежним порядком, лежат в очереди работ и никуда не делись:
-
-```bash
-gh issue list --label agent-kit-feedback --state all --limit 100 \
-    --json number,title,body,createdAt
-```
-
-Помощник хостинга и учётная запись машинной работы у каждого дерева свои — как их звать здесь,
-сказано в компаньоне правила `git-workflow`.
-
-В каждой записи — ресурс, место, повод и готовый текст. Признак дерева, приехавший с грузом,
-адреса дерева не выдаёт: он считается хешем и по нему различают деревья, а не находят их.
-
-Своё дерево тоже потребитель — его наблюдения читаются прямо:
-
-```bash
-npx agent-kit stats --days <отрезок> --json
-```
-
-## 2. Раздели повторившееся и разовое
-
-Это и есть работа сведения; всё остальное — оформление.
-
-- **Пришло об одном ресурсе из двух и более записей** — правка пакета. Разные деревья
-  споткнулись об одно и то же место, и чинить его надо там, откуда оно к ним приехало.
-- **Пришло однажды и называет то, чего у других нет** — надстройка того дерева, а не пакет.
-  Скажи это прямо и назови, куда именно: `overrides/<ресурс>` для текстов, карта гейта и
-  профиль — для родов файлов и команд.
-- **Пришло однажды, но верно любому дереву** — правка пакета. Числа записей мало: правило,
-  которое молчит о важном, молчит у всех, а споткнулся о него пока один.
-
-Ресурс, о котором пришли **противоречащие** предложения, в правку не идёт вовсе: неси оба
-владельцу. Слой правил, который говорит два разных, хуже слоя, который молчит.
-
-## 3. Посмотри, что говорят наблюдения
-
-Сводка отвечает на то, чего в предложениях нет:
-
-- **правило, разложенное и не загруженное ни разу** — кандидат на сокращение или на запись в
-  карте гейта: правило, которого гейт не требует, никто и не откроет;
-- **правило, которое гейт отбивает чаще прочих** — его либо забывают, либо оно требуется не
-  там; посмотри род правки в той же сводке;
-- **гард, отказывающий чаще прочих** — либо место поставки раз за разом делают не так, либо
-  отказ не называет, чем он снимается.
-
-## 4. Принеси правки
-
-По каждой — ресурс, место, готовый текст и число записей, из которых она вышла. Не правь ничего
-сам: решение принимает владелец, а работа идёт обычным ходом — задача, ветка, папка задачи.
-
-Заведи задачу на то, что владелец принял, и тем же ходом отметь вошедшие в неё записи груза —
-как именно, говорит паттерн `cargo-triage-mark`:
-
-```bash
-npm run task:new -- --title '<что не так>' --slug <короткое-имя> --label enhancement < тело.md
-```
-
-Записи, заведённые в очереди работ прежним порядком, закрываются там же ссылкой на задачу:
-
-```bash
-gh issue close <номер> --comment 'Вошло в #<номер задачи>.'
-```
-
-## 5. Черновик записи в журнал изменений
-
-Собери его сразу, пока видно, из чего правка выросла: заголовок коммита по формату дерева и
-одна фраза о том, что менялось и почему. Журнал изменений при выпуске собирается из заголовков,
-и переписывать их задним числом — работа заново.
-
-**Выпуск отсюда не запускается.** Это отдельное решение владельца: слияние PR пакета не
-публикует. Скажи, что накопилось на выпуск, и остановись.