@rt-tools/agent-kit 0.9.1 → 0.10.0

package/assets/skills/agent-kit.md

@@ -27,6 +27,7 @@ description: Переносимый слой правил агента — за
 | какие признаки единообразия дерево берёт       | `checks.json`, ключи `reuse.bundles` и `reuse.signals` |
 | раздел разложенного текста                     | `.claude/rt-kit/overrides/<идентификатор ресурса>`     |
 | что брать, а от чего отказаться                | `.claude/rt-kit.json`, ключи `only` и `skip`           |
+| какие роли зовутся не обязательно, а руками    | `.claude/rt-kit.json`, ключ `rolesOff`                 |
 | что у дерева есть: хранилище, админка, пакеты  | `.claude/rt-kit.json`, ключ `has`                      |
 | сам механизм — гард, проверка, текст правила   | ресурс в пакете                                        |
 
@@ -156,8 +157,40 @@ npx agent-kit propose       # отправить груз в приём: сво
 - **Свойство, которого пакет не объявлял, роняет раскладку** — что в `has` дерева, что в имени
   ресурса. Объявлены свойства перечнем при пакете, рядом с осями различия.
 
+## Выключенная роль
+
+Роль, при которой стоит гард, зовётся не по усмотрению исполнителя: гард держит работу, пока
+роль не сказала своё. Дерево, которому такая роль в эту минуту мешает, называет её ключом
+`rolesOff` — именем файла роли без расширения.
+
+```json
+{ "rolesOff": ["strict-teacher"] }
+```
+
+- **Выключается обязательность вызова, а не роль.** Файл роли остаётся разложенным, и позвать её
+  руками можно в любую минуту. Список читают сами гарды — помощником, который лежит с ними
+  рядом; собственного объявления события у него нет, к действиям агента он не подключается.
+- **От отказа ключом `skip` это отличается тем, что ничего не убирает.** Отказ не кладёт файл
+  роли вовсе: звать становится некого, а гард при ней остаётся лежать и продолжает отбивать.
+  Здесь наоборот — роль на месте, молчит гард.
+- **Настройка, которую не прочитать, роль не выключает.** Не нашлось `jq`, нет настройки, в
+  настройке сломан разбор — гард судит, как судил. Обратный выбор гасил бы слой правил молча, и
+  заметить это было бы нечем.
+- **Ключ, написанный не списком, ловит раскладка, а не гард.** Гарду виден только список имён:
+  строка вместо списка читается им как «роль включена», и роль работает, хотя дерево считает её
+  выключенной. Отказывает на этом разбор настройки — первой же раскладкой, называя ключ.
+- **Выключение живёт в настройке дерева, а не в настройке агента.** Строка, вырезанная из
+  настроек агента руками, теряется на первой же правке того файла, и вернуть роль будет нечем.
+  Здесь оно объявлено в одном месте и видно всякому, кто читает настройку дерева.
+
 ## Ловушки
 
+- **Набор, проверяющий гард, читает настройку того дерева, из которого его запустили.** Помощник
+  берёт настройку по каталогу проекта, а его агент выставляет своим — и `cd` в прогонщике этого
+  не перебивает. Набор, не заведший своего одноразового дерева, зеленеет от строки в чужой
+  настройке: шесть сценариев гарда экзамена прошли ровно так, потому что роль была выключена в
+  дереве, где их гоняли. Своё дерево объявляется на каждый сценарий, а не один раз на файл.
+
 - **Надстройка замещает раздел целиком, и пакетные пункты в нём приходится держать копией.**
   Дописать в раздел одну статью нечем: слияние идёт по заголовку `## `. Дерево, которому нужен
   один свой пункт, копирует к нему все пакетные — и с этого дня правка любого из них,

package/assets/templates/project.sh

@@ -19,10 +19,26 @@ RT_PROD_DSN='<хост боевого хранилища>'
 # Пути, у которых якорь для сквозных тестов не требуется.
 RT_QA_SKIP_RE='<выражение путей>'
 
+# Имя клиента хостинга в строке запуска: по нему гард перезапуска узнаёт вызов перезапуска
+# задания. Умолчание пакета — под самый распространённый вид хостинга.
+RT_HOST_CLI='<имя клиента хостинга>'
+
 # Команды, которые обязаны пройти перед пушем. По одной на строку; первая упавшая отбивает пуш.
+#
+# Тяжёлый шаг — стенд, снимки витрин, сборка образов — печатается только тогда, когда ветка
+# тронула не только тексты: иначе пуш коммита с одной правленой строкой markdown занимает
+# минуты, и владелец читает его как зависший. Признак даёт `rt_push_docs_only <база>`; при
+# пустой базе он молчит, и гоняется весь набор — той же пустой базой зовёт эту функцию сверка
+# полноты набора, и список она обязана видеть целиком.
 rt_push_checks() {
     rt_push_checks_default
     # printf '%s\n' '<своя проверка>'
+
+    # Тяжёлые шаги — по составу правки, а не подряд.
+    # if [ -n "$1" ] && rt_push_docs_only "$1"; then
+    #     return 0
+    # fi
+    # printf '%s\n' '<шаг, поднимающий стенд или собирающий образ>'
 }
 
 # Какой документ обязан ехать тем же коммитом, что и этот файл. Печатает образец пути или молчит.

package/lib/config.d.ts

@@ -60,6 +60,14 @@ export interface IConfig {
      * что разборщика конфига у него нет.
      */
     readonly observe: boolean;
+    /**
+     * Роли слоя правил, которые дерево выключило, именами файлов без расширения:
+     * `["strict-teacher"]`. Выключается обязательность вызова, а не сама роль: файл роли
+     * остаётся разложенным и зовётся руками, а гард при выключенной роли выходит молча.
+     * Ключ читают двое: сводка — отсюда, гард — тем же именем прямо из файла, потому что
+     * разборщика конфига у него нет.
+     */
+    readonly rolesOff: readonly string[];
     /**
      * Адрес приёма, куда уезжает груз: `https://…`. Пусто — отправлять некуда, и отправка
      * отказывает вместо молчания. Зашитый в код адрес назвал бы чужое дерево в текстах пакета.

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,GACX,MAAM,GACN,OAAO,GACP,UAAU,GACV,QAAQ,GACR,OAAO,GACP,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,WAAW,GACX,WAAW;AACb,4EAA4E;GAC1E,MAAM;AACR;;;;;;;GAOG;GACD,SAAS,CAAC;AAEhB,eAAO,MAAM,KAAK,EAAE,SAAS,KAAK,EAcjC,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;IACpD;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAChC;AAED,eAAO,MAAM,WAAW,EAAE,MAA8B,CAAC;AACzD,qGAAqG;AACrG,eAAO,MAAM,UAAU,EAAE,MAAyB,CAAC;AACnD,eAAO,MAAM,aAAa,EAAE,MAAmC,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAA2B,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,4FAA4F;AAC5F,eAAO,MAAM,UAAU,EAAE,MAAyB,CAAC;AAEnD,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,CAgB1D,CAAC;AAEF,qBAAa,WAAY,SAAQ,KAAK;CAAG;AA4CzC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA0CjD;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,GACX,MAAM,GACN,OAAO,GACP,UAAU,GACV,QAAQ,GACR,OAAO,GACP,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,WAAW,GACX,WAAW;AACb,4EAA4E;GAC1E,MAAM;AACR;;;;;;;GAOG;GACD,SAAS,CAAC;AAEhB,eAAO,MAAM,KAAK,EAAE,SAAS,KAAK,EAcjC,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;IACpD;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAChC;AAED,eAAO,MAAM,WAAW,EAAE,MAA8B,CAAC;AACzD,qGAAqG;AACrG,eAAO,MAAM,UAAU,EAAE,MAAyB,CAAC;AACnD,eAAO,MAAM,aAAa,EAAE,MAAmC,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAA2B,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,4FAA4F;AAC5F,eAAO,MAAM,UAAU,EAAE,MAAyB,CAAC;AAEnD,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,CAgB1D,CAAC;AAEF,qBAAa,WAAY,SAAQ,KAAK;CAAG;AA4CzC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA2CjD;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAUvD"}

package/lib/config.js

@@ -159,6 +159,7 @@ export function parseConfig(text) {
         has: idList(raw['has'], 'has'),
         // Выключателем считается только явное «нет»: ключа нет — запись идёт, как и у гарда.
         observe: raw['observe'] !== false,
+        rolesOff: idList(raw['rolesOff'], 'rolesOff'),
         intake: textOf(raw['intake'], 'intake'),
         token: textOf(raw['token'], 'token'),
         tree: textOf(raw['tree'], 'tree'),

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     * Адрес приёма, куда уезжает груз: `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        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\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"]}

package/package.json

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