@rt-tools/agent-kit 0.2.0 → 0.3.0

package/assets/templates/implementation.md

@@ -0,0 +1,38 @@
+# <имя-правила> — как это устроено здесь
+
+Имена этого дерева при правиле `SKILL.md` рядом. Отдельный файл потому, что правило говорит
+приёмом и переносится между репозиториями целиком, а всё, что ниже, верно только здесь и
+устаревает при каждом переименовании.
+
+Пока в файле стоит `<!-- заполняет проект -->`, правило считается неразвёрнутым: `agent-kit
+sync --check` отказывает, а агент читает указание, которому здесь нечего назвать.
+
+## Как это называется здесь
+
+| В правиле         | Здесь                                       |
+| ----------------- | ------------------------------------------- |
+| <понятие правила> | <имя в этом коде> <!-- заполняет проект --> |
+
+## Где это лежит
+
+| Что        | Где                                |
+| ---------- | ---------------------------------- |
+| <механизм> | `<путь>` <!-- заполняет проект --> |
+
+## Где исполняются статьи
+
+Первая колонка — статья дословно, как она написана в разделе «Что здесь действует» правила
+(жирная часть пункта). Статья без строки и строка без статьи — расхождение: правило обещает
+то, чего в дереве нет, либо в дереве стоит то, о чём правило молчит.
+
+| Статья            | Где исполняется                             |
+| ----------------- | ------------------------------------------- |
+| <статья дословно> | `<путь>:<символ>` <!-- заполняет проект --> |
+
+## Что ещё стоит знать при чтении кода
+
+- <Что видно только изнутри этого дерева: почему приём выглядит здесь именно так.>
+
+## Чем это проверяется
+
+- <Команда, которая ловит нарушение, — и что именно она ловит.>

package/assets/templates/pattern.md

@@ -18,6 +18,10 @@ description: Паттерн правила <имя-правила>. Брать <
 
 <Готовый код целиком, а не пересказ: паттерн берут, чтобы не писать заново.>
 
+Имена в примере безымянные — `libs/<домен>`, `<Feature>Component`, `<app>`. Настоящие имена
+этого дерева стоят в `implementation.md` при правиле: пример, написанный на чужих именах,
+читается как рабочий код и переносится в дерево вместе с ними.
+
 ```
 <код>
 ```

package/assets/templates/project.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Профиль этого дерева: что здесь чем зовётся и какими командами проверяется.
+#
+# Живёт в проекте, а не в пакете: механизм у сторожевых хуков общий, а команды, порты и пары
+# «правка — её документ» у каждого дерева свои. Пакет везёт хуки, проект — этот файл.
+#
+# Каждая функция вправе промолчать. Молчание значит «правила на это нет», и хук пропускает:
+# пустой профиль оставляет хуки безвредными, а не отбивающими наугад.
+
+# Где подняты приложения. Идёт в текст отказа, когда кто-то поднимает второй экземпляр.
+RT_STANDS='<приложение> http://localhost:<порт>, <приложение> http://localhost:<порт>'
+
+# Команды, которые обязаны пройти перед пушем. По одной на строку; первая упавшая отбивает пуш.
+rt_push_checks() {
+    cat <<'EOF'
+<команда линтера кода>
+<команда линтера стилей>
+<команда тестов>
+EOF
+}
+
+# Какой документ обязан ехать тем же коммитом, что и этот файл. Печатает путь или молчит.
+rt_docs_pair_for() {
+    case "$1" in
+        */<каталог правил>/*)   printf '%s' '<зеркало правила>' ;;
+        *.proto)                printf '%s' '<спек задетого домена>' ;;
+    esac
+}
+
+# Чем линтуется этот файл сразу после правки. Печатает команду или молчит.
+rt_lint_for() {
+    case "$1" in
+        *.scss)  printf '%s' '<команда линтера стилей> "$1"' ;;
+        *.ts)    printf '%s' '<команда линтера кода> "$1"' ;;
+    esac
+}
+
+# Имя ветки, с которой разрешено открывать PR: номер задачи в имени. Успех — годится.
+rt_task_branch_ok() {
+    printf '%s' "$1" | grep -qE '<выражение имени ветки>'
+}

package/assets/templates/rule.md

@@ -2,37 +2,26 @@
 name: <имя-правила>
 kind: rule
 law: <закон>
-description: Правило проекта под закон «<Название закона>». Брать при <когда> — <что называет>. Готовый код — в паттернах <имена>.
+description: Правило под закон «<Название закона>». Брать при <когда> — <каким приёмом это делается>. Готовый код — в паттернах <имена>.
 ---
 
-# <О чём закон> — как это устроено здесь
+# <О чём закон> — каким приёмом
 
-Правило под закон `{{lawsDir}}/<закон>.md`. Закон говорит, что должно быть верно; здесь — чем
-это названо в этом дереве, где лежит и что из закона у нас не применяется.
+Правило под закон `{{lawsDir}}/<закон>.md`. Закон говорит, что должно быть верно; здесь — каким
+приёмом это делается. Чем это названо в этом дереве и где лежит — `implementation.md` рядом:
+правило переносится между репозиториями, имена — нет.
 
-## Как это называется здесь
+## Когда берётся
 
-| В законе         | Здесь             |
-| ---------------- | ----------------- |
-| <понятие закона> | <имя в этом коде> |
+<Правка, по которой правило узнаётся. Гейт зовёт его по этому признаку, а не по названию.>
 
-## Где это лежит
+## Что здесь действует
 
-| Что        | Где      |
-| ---------- | -------- |
-| <механизм> | `<путь>` |
+Каждый пункт начинается жирной статьёй, и у каждой статьи есть строка в `implementation.md`
+рядом. Утверждение, которому места в коде не нашлось, сюда не ставится: оно уходит прозой в
+«Ловушки» или статьёй в закон.
 
-## Как закон применяется здесь
-
-Каждый пункт начинается жирной фразой, и у каждой жирной фразы есть строка в
-`implementation.md` рядом. Утверждение, которому места в коде не нашлось, сюда не ставится: оно
-уходит прозой в «Ловушки» или вопросом `Q-N` в закон.
-
-- **<Утверждение одной фразой.>** <Что сломается иначе — не больше двух предложений.>
-
-## Чего из закона здесь нет
-
-<Что из закона этот проект не применяет и почему; ссылка на открытый вопрос закона.>
+- **<Статья одной фразой.>** <Что сломается иначе — не больше двух предложений.>
 
 ## Паттерны
 

package/lib/assets.d.ts

@@ -1,11 +1,19 @@
+import { IEntryOfCatalog } from './catalog.js';
 import { IConfig, TKind } from './config.js';
 export interface IAsset {
     /** Идентификатор: `laws/delivery.md`. Он же путь надстройки и ключ в `only` и `skip`. */
     readonly id: string;
     readonly kind: TKind;
+    /** Имя без рода и расширения: `delivery`. У скила — имя каталога, которым его зовут. */
+    readonly name: string;
     readonly text: string;
     /** Путь в дереве проекта, куда ресурс ложится. */
     readonly target: string;
 }
+/**
+ * Куда ложится ресурс. Скил читается агентом как `<имя>/SKILL.md`, и другого имени у него быть
+ * не может: файл, названный по ресурсу, агент не найдёт вовсе. Остальные роды ложатся файлом.
+ */
+export declare function targetOf(entry: IEntryOfCatalog, layout: Readonly<Record<TKind, string>>): string;
 export declare function collectAssets(config: IConfig, assetsDir: string): readonly IAsset[];
 //# sourceMappingURL=assets.d.ts.map

package/lib/assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/assets.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,MAAM;IACnB,yFAAyF;IACzF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CASnF"}
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/assets.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,eAAe,EAAyB,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,OAAO,EAA2B,KAAK,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,MAAM;IACnB,yFAAyF;IACzF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAIhG;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAUnF"}

package/lib/assets.js

@@ -7,14 +7,25 @@
  */
 import { join } from 'node:path';
 import { isChosen, readCatalog } from './catalog.js';
+import { SKILL_FILE, SKILL_KINDS } from './config.js';
+/**
+ * Куда ложится ресурс. Скил читается агентом как `<имя>/SKILL.md`, и другого имени у него быть
+ * не может: файл, названный по ресурсу, агент не найдёт вовсе. Остальные роды ложатся файлом.
+ */
+export function targetOf(entry, layout) {
+    return SKILL_KINDS.includes(entry.kind)
+        ? join(layout[entry.kind], entry.name, SKILL_FILE)
+        : join(layout[entry.kind], entry.id.slice(entry.kind.length + 1));
+}
 export function collectAssets(config, assetsDir) {
     return readCatalog(assetsDir)
         .filter((entry) => isChosen(entry, config.only, config.skip))
         .map((entry) => ({
         id: entry.id,
         kind: entry.kind,
+        name: entry.name,
         text: entry.text,
-        target: join(config.layout[entry.kind], entry.id.slice(entry.kind.length + 1)),
+        target: targetOf(entry, config.layout),
     }));
 }
 //# sourceMappingURL=assets.js.map

package/lib/assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/assets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAmB,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAYtE,MAAM,UAAU,aAAa,CAAC,MAAe,EAAE,SAAiB;IAC5D,OAAO,WAAW,CAAC,SAAS,CAAC;SACxB,MAAM,CAAC,CAAC,KAAsB,EAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;SACtF,GAAG,CAAC,CAAC,KAAsB,EAAU,EAAE,CAAC,CAAC;QACtC,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;KACjF,CAAC,CAAC,CAAC;AACZ,CAAC","sourcesContent":["/**\n * Что из везомого пакетом взял этот проект и куда оно ложится.\n *\n * Полный набор читает `catalog.ts`, здесь из него остаётся выбранное. Разделено потому, что\n * выбирать приходится раньше, чем раскладывать: `init` спрашивает, какие законы взять, а `list`\n * показывает и то, от чего проект отказался, — обоим нужен набор до отбора.\n */\nimport { join } from 'node:path';\n\nimport { IEntryOfCatalog, isChosen, readCatalog } from './catalog.js';\nimport { IConfig, TKind } from './config.js';\n\nexport interface IAsset {\n    /** Идентификатор: `laws/delivery.md`. Он же путь надстройки и ключ в `only` и `skip`. */\n    readonly id: string;\n    readonly kind: TKind;\n    readonly text: string;\n    /** Путь в дереве проекта, куда ресурс ложится. */\n    readonly target: string;\n}\n\nexport function collectAssets(config: IConfig, assetsDir: string): readonly IAsset[] {\n    return readCatalog(assetsDir)\n        .filter((entry: IEntryOfCatalog): boolean => isChosen(entry, config.only, config.skip))\n        .map((entry: IEntryOfCatalog): IAsset => ({\n            id: entry.id,\n            kind: entry.kind,\n            text: entry.text,\n            target: join(config.layout[entry.kind], entry.id.slice(entry.kind.length + 1)),\n        }));\n}\n"]}
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/assets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAmB,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAW,UAAU,EAAE,WAAW,EAAS,MAAM,aAAa,CAAC;AAatE;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAsB,EAAE,MAAuC;IACpF,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QACnC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC;QAClD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAe,EAAE,SAAiB;IAC5D,OAAO,WAAW,CAAC,SAAS,CAAC;SACxB,MAAM,CAAC,CAAC,KAAsB,EAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;SACtF,GAAG,CAAC,CAAC,KAAsB,EAAU,EAAE,CAAC,CAAC;QACtC,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;KACzC,CAAC,CAAC,CAAC;AACZ,CAAC","sourcesContent":["/**\n * Что из везомого пакетом взял этот проект и куда оно ложится.\n *\n * Полный набор читает `catalog.ts`, здесь из него остаётся выбранное. Разделено потому, что\n * выбирать приходится раньше, чем раскладывать: `init` спрашивает, какие законы взять, а `list`\n * показывает и то, от чего проект отказался, — обоим нужен набор до отбора.\n */\nimport { join } from 'node:path';\n\nimport { IEntryOfCatalog, isChosen, readCatalog } from './catalog.js';\nimport { IConfig, SKILL_FILE, SKILL_KINDS, TKind } from './config.js';\n\nexport interface IAsset {\n    /** Идентификатор: `laws/delivery.md`. Он же путь надстройки и ключ в `only` и `skip`. */\n    readonly id: string;\n    readonly kind: TKind;\n    /** Имя без рода и расширения: `delivery`. У скила — имя каталога, которым его зовут. */\n    readonly name: string;\n    readonly text: string;\n    /** Путь в дереве проекта, куда ресурс ложится. */\n    readonly target: string;\n}\n\n/**\n * Куда ложится ресурс. Скил читается агентом как `<имя>/SKILL.md`, и другого имени у него быть\n * не может: файл, названный по ресурсу, агент не найдёт вовсе. Остальные роды ложатся файлом.\n */\nexport function targetOf(entry: IEntryOfCatalog, layout: Readonly<Record<TKind, string>>): string {\n    return SKILL_KINDS.includes(entry.kind)\n        ? join(layout[entry.kind], entry.name, SKILL_FILE)\n        : join(layout[entry.kind], entry.id.slice(entry.kind.length + 1));\n}\n\nexport function collectAssets(config: IConfig, assetsDir: string): readonly IAsset[] {\n    return readCatalog(assetsDir)\n        .filter((entry: IEntryOfCatalog): boolean => isChosen(entry, config.only, config.skip))\n        .map((entry: IEntryOfCatalog): IAsset => ({\n            id: entry.id,\n            kind: entry.kind,\n            name: entry.name,\n            text: entry.text,\n            target: targetOf(entry, config.layout),\n        }));\n}\n"]}

package/lib/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/commands.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AAgDD;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,SAAS,MAAM,EAAO,GAAG,iBAAiB,CAoBlF;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA0CzE;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAyB3D;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CA+CzD"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/commands.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AA+DD;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,SAAS,MAAM,EAAO,GAAG,iBAAiB,CAoBlF;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAgDzE;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAyB3D;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CA+CzD"}

package/lib/commands.js

@@ -7,6 +7,7 @@ import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { collectAssets } from './assets.js';
 import { isChosen, readCatalog } from './catalog.js';
+import { isUnfilled } from './companion.js';
 import { CONFIG_PATH, DEFAULT_LAYOUT, KINDS, OVERRIDES_DIR, readConfig } from './config.js';
 import { isRefusal } from './plan.js';
 import { pendingOf, planSync, runSync } from './sync.js';
@@ -34,16 +35,28 @@ const NOT_CHOSEN = 'не выбран';
 const SKIPPED = 'пропущен';
 const KIND_TITLE = {
     laws: 'ЗАКОНЫ',
+    rules: 'ПРАВИЛА',
+    patterns: 'ПАТТЕРНЫ',
     hooks: 'ХУКИ',
     checks: 'ПРОВЕРКИ',
     agents: 'АГЕНТЫ',
+    commands: 'КОМАНДЫ',
+    workflows: 'ВОРКФЛОУ',
     templates: 'ШАБЛОНЫ',
 };
+/** Состояние компаньона словами. У заполненного слова нет: о нём говорить нечего. */
+const COMPANION_WORD = {
+    missing: 'пропал',
+    draft: 'остался черновиком',
+    filled: 'заполнен',
+};
 const NO_CONFIG = `нет \`${CONFIG_PATH}\` — начни с \`agent-kit init\``;
 const holes = (result) => [...result.missing].map(([asset, names]) => `  ${asset}: нет значений для ${names.map((name) => `{{${name}}}`).join(', ')}`);
+const unfilled = (result) => result.companions.filter(isUnfilled);
 const describe = (result) => [
     ...holes(result),
     ...pendingOf(result).map((entry) => `  ${entry.path} — ${STATE_WORD[entry.outcome]}`),
+    ...unfilled(result).map((entry) => `  ${entry.path} — ${COMPANION_WORD[entry.state]}`),
 ];
 /**
  * Что проект выбрал при заведении конфига. Пустой список — весь набор; выбор приходит сюда
@@ -78,10 +91,16 @@ export function sync(env, check) {
     if (check) {
         const result = planSync(config, root, version, assetsDir);
         const pending = pendingOf(result);
-        if (!result.missing.size && !pending.length) {
+        // Незаполненный компаньон — такое же расхождение, как отставший файл: правило разложено,
+        // а имён этого дерева при нём нет, и агент читает указание, которому некуда примениться.
+        const empty = unfilled(result);
+        if (!result.missing.size && !pending.length && !empty.length) {
             return { code: 0, lines: [`sync --check: разложенное сходится с пакетом v${version}`] };
         }
-        return { code: 1, lines: [`sync --check: расхождений ${result.missing.size + pending.length}`, ...describe(result)] };
+        return {
+            code: 1,
+            lines: [`sync --check: расхождений ${result.missing.size + pending.length + empty.length}`, ...describe(result)],
+        };
     }
     const result = runSync(config, root, version, assetsDir);
     // Перечисляются только дырки: раскладка не начата, и назвать файл «положенным» значило бы

package/lib/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/commands.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Команды и их вывод. Печать отделена от работы: команда возвращает строки и код возврата,\n * а `process.exit` зовёт только точка входа — иначе ни одну из них нельзя было бы проверить\n * спекой, не перехватывая поток вывода.\n */\nimport { existsSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { collectAssets } from './assets.js';\nimport { IEntryOfCatalog, isChosen, readCatalog } from './catalog.js';\nimport { CONFIG_PATH, DEFAULT_LAYOUT, IConfig, KINDS, OVERRIDES_DIR, readConfig, TKind } from './config.js';\nimport { IPlanned, isRefusal, TOutcome } from './plan.js';\nimport { ISyncResult, pendingOf, planSync, runSync } from './sync.js';\n\nexport interface IOutcomeOfCommand {\n    readonly code: number;\n    readonly lines: readonly string[];\n}\n\n/** Всё, что команда знает о мире: корень проекта, версия пакета и его каталог ресурсов. */\nexport interface IEnvironment {\n    readonly root: string;\n    readonly version: string;\n    readonly assetsDir: string;\n}\n\n/** Что с файлом сделала раскладка. Прошедшее время здесь правда: `sync` уже записал. */\nconst DONE_WORD: Readonly<Record<TOutcome, string>> = {\n    create: 'положен',\n    update: 'переложен',\n    drift: 'правлен руками',\n    foreign: 'положен не пакетом',\n    ok: 'без изменений',\n};\n\n/**\n * Что с файлом **сейчас**. Отдельно от прошедшего времени потому, что `doctor` и `list` ничего\n * не пишут: сказать «положен» о файле, которого в дереве нет, значит соврать читателю ровно там,\n * где он пришёл узнать состояние.\n */\nconst STATE_WORD: Readonly<Record<TOutcome, string>> = {\n    create: 'нет в дереве',\n    update: 'отстал от пакета',\n    drift: 'правлен руками',\n    foreign: 'положен не пакетом',\n    ok: 'на месте',\n};\n\nconst NOT_CHOSEN: string = 'не выбран';\nconst SKIPPED: string = 'пропущен';\n\nconst KIND_TITLE: Readonly<Record<TKind, string>> = {\n    laws: 'ЗАКОНЫ',\n    hooks: 'ХУКИ',\n    checks: 'ПРОВЕРКИ',\n    agents: 'АГЕНТЫ',\n    templates: 'ШАБЛОНЫ',\n};\n\nconst NO_CONFIG: string = `нет \\`${CONFIG_PATH}\\` — начни с \\`agent-kit init\\``;\n\nconst holes: (result: ISyncResult) => string[] = (result: ISyncResult): string[] =>\n    [...result.missing].map(\n        ([asset, names]: [string, readonly string[]]): string =>\n            `  ${asset}: нет значений для ${names.map((name: string): string => `{{${name}}}`).join(', ')}`\n    );\n\nconst describe: (result: ISyncResult) => string[] = (result: ISyncResult): string[] => [\n    ...holes(result),\n    ...pendingOf(result).map((entry: IPlanned): string => `  ${entry.path} — ${STATE_WORD[entry.outcome]}`),\n];\n\n/**\n * Что проект выбрал при заведении конфига. Пустой список — весь набор; выбор приходит сюда\n * готовым, потому что взять его негде, кроме края: у строки запуска флаг, у терминала вопрос,\n * а у неинтерактивного прогона нет ни того ни другого — и решать это команде не по чину.\n */\nexport function init(root: string, only: readonly string[] = []): IOutcomeOfCommand {\n    const path: string = join(root, CONFIG_PATH);\n    if (existsSync(path)) {\n        return { code: 0, lines: [`${CONFIG_PATH} уже есть — оставлен как есть`] };\n    }\n\n    const config: object = { vars: {}, layout: DEFAULT_LAYOUT, only, skip: [] };\n    mkdirSync(join(root, OVERRIDES_DIR), { recursive: true });\n    mkdirSync(join(root, CONFIG_PATH, '..'), { recursive: true });\n    writeFileSync(path, `${JSON.stringify(config, null, 4)}\\n`, 'utf8');\n\n    return {\n        code: 0,\n        lines: [\n            `заведён ${CONFIG_PATH}`,\n            only.length ? `выбрано ресурсов: ${only.length}` : 'выбрано всё, что везёт пакет',\n            `заведён ${OVERRIDES_DIR}/ — надстройки проекта кладутся сюда путём ресурса`,\n            'дальше: заполни `vars` и запусти `agent-kit sync`',\n        ],\n    };\n}\n\nexport function sync(env: IEnvironment, check: boolean): IOutcomeOfCommand {\n    const { root, version, assetsDir } = env;\n    const config: IConfig | null = readConfig(root);\n    if (!config) {\n        return { code: 1, lines: [NO_CONFIG] };\n    }\n\n    if (check) {\n        const result: ISyncResult = planSync(config, root, version, assetsDir);\n        const pending: readonly IPlanned[] = pendingOf(result);\n        if (!result.missing.size && !pending.length) {\n            return { code: 0, lines: [`sync --check: разложенное сходится с пакетом v${version}`] };\n        }\n\n        return { code: 1, lines: [`sync --check: расхождений ${result.missing.size + pending.length}`, ...describe(result)] };\n    }\n\n    const result: ISyncResult = runSync(config, root, version, assetsDir);\n    // Перечисляются только дырки: раскладка не начата, и назвать файл «положенным» значило бы\n    // сказать неправду — на диске его нет.\n    if (result.missing.size) {\n        return { code: 1, lines: ['раскладка не начата: нечего подставить в дырки', ...holes(result)] };\n    }\n\n    const refused: readonly IPlanned[] = result.planned.filter((entry: IPlanned): boolean => isRefusal(entry.outcome));\n    if (refused.length) {\n        return {\n            code: 1,\n            lines: [\n                'раскладка не начата: эти файлы пакет переписывать не станет',\n                ...refused.map((entry: IPlanned): string => `  ${entry.path} — ${DONE_WORD[entry.outcome]}`),\n                'правку надо либо перенести в надстройку, либо снять — и повторить',\n            ],\n        };\n    }\n\n    return {\n        code: 0,\n        lines: result.written.length\n            ? [`разложено файлов: ${result.written.length}`, ...result.written.map((path: string): string => `  ${path}`)]\n            : ['всё уже разложено'],\n    };\n}\n\nexport function doctor(env: IEnvironment): IOutcomeOfCommand {\n    const { root, version, assetsDir } = env;\n    const config: IConfig | null = readConfig(root);\n    if (!config) {\n        return { code: 1, lines: [NO_CONFIG] };\n    }\n\n    const result: ISyncResult = planSync(config, root, version, assetsDir);\n    const counted: Map<TOutcome, number> = new Map();\n    for (const entry of result.planned) {\n        counted.set(entry.outcome, (counted.get(entry.outcome) ?? 0) + 1);\n    }\n\n    const catalog: readonly IEntryOfCatalog[] = readCatalog(assetsDir);\n    const taken: number = collectAssets(config, assetsDir).length;\n\n    const lines: string[] = [\n        `пакет v${version}, везёт ресурсов ${catalog.length}, взято ${taken}`,\n        `не выбрано: ${catalog.length - taken - config.skip.length}, пропущено: ${config.skip.length}`,\n        `значений в конфиге: ${Object.keys(config.vars).length}`,\n        ...[...counted].map(([outcome, count]: [TOutcome, number]): string => `${STATE_WORD[outcome]}: ${count}`),\n        ...describe(result),\n    ];\n\n    return { code: 0, lines };\n}\n\n/**\n * Что пакет везёт и что из этого взято здесь.\n *\n * Работает и без конфига: посмотреть, из чего выбирать, нужно раньше, чем выбор сделан, — иначе\n * имена законов взять неоткуда, кроме исходников пакета.\n */\nexport function list(env: IEnvironment): IOutcomeOfCommand {\n    const { root, version, assetsDir } = env;\n    const config: IConfig | null = readConfig(root);\n    const catalog: readonly IEntryOfCatalog[] = readCatalog(assetsDir);\n    const planned: Map<string, TOutcome> = new Map();\n\n    if (config) {\n        for (const entry of planSync(config, root, version, assetsDir).planned) {\n            planned.set(entry.asset, entry.outcome);\n        }\n    }\n\n    const stateOf: (entry: IEntryOfCatalog) => string = (entry: IEntryOfCatalog): string => {\n        if (!config) {\n            return 'везёт пакет';\n        }\n        if (config.skip.includes(entry.id)) {\n            return SKIPPED;\n        }\n        if (!isChosen(entry, config.only, config.skip)) {\n            return NOT_CHOSEN;\n        }\n        const outcome: TOutcome | undefined = planned.get(entry.id);\n\n        // Ресурса нет среди запланированных ровно в одном случае: в нём осталась дырка без\n        // значения, и до решения о судьбе файла раскладка не дошла.\n        return outcome ? STATE_WORD[outcome] : 'дырка без значения';\n    };\n\n    const name: number = catalog.reduce((found: number, entry: IEntryOfCatalog): number => Math.max(found, entry.name.length), 0);\n    const state: number = catalog.reduce((found: number, entry: IEntryOfCatalog): number => Math.max(found, stateOf(entry).length), 0);\n    const lines: string[] = [config ? `пакет v${version}` : `пакет v${version}, ${CONFIG_PATH} ещё не заведён`];\n\n    for (const kind of KINDS) {\n        const entries: readonly IEntryOfCatalog[] = catalog.filter((entry: IEntryOfCatalog): boolean => entry.kind === kind);\n        if (!entries.length) {\n            continue;\n        }\n        lines.push('', KIND_TITLE[kind]);\n        lines.push(\n            ...entries.map(\n                (entry: IEntryOfCatalog): string => `  ${entry.name.padEnd(name)}  ${stateOf(entry).padEnd(state)}  ${entry.title}`\n            )\n        );\n    }\n\n    return { code: 0, lines };\n}\n"]}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/commands.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAmB,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAc,UAAU,EAAmB,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAW,KAAK,EAAE,aAAa,EAAE,UAAU,EAAS,MAAM,aAAa,CAAC;AAC5G,OAAO,EAAY,SAAS,EAAY,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAe,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AActE,wFAAwF;AACxF,MAAM,SAAS,GAAuC;IAClD,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,gBAAgB;IACvB,OAAO,EAAE,oBAAoB;IAC7B,EAAE,EAAE,eAAe;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,GAAuC;IACnD,MAAM,EAAE,cAAc;IACtB,MAAM,EAAE,kBAAkB;IAC1B,KAAK,EAAE,gBAAgB;IACvB,OAAO,EAAE,oBAAoB;IAC7B,EAAE,EAAE,UAAU;CACjB,CAAC;AAEF,MAAM,UAAU,GAAW,WAAW,CAAC;AACvC,MAAM,OAAO,GAAW,UAAU,CAAC;AAEnC,MAAM,UAAU,GAAoC;IAChD,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,SAAS;IACnB,SAAS,EAAE,UAAU;IACrB,SAAS,EAAE,SAAS;CACvB,CAAC;AAEF,qFAAqF;AACrF,MAAM,cAAc,GAA8C;IAC9D,OAAO,EAAE,QAAQ;IACjB,KAAK,EAAE,oBAAoB;IAC3B,MAAM,EAAE,UAAU;CACrB,CAAC;AAEF,MAAM,SAAS,GAAW,SAAS,WAAW,iCAAiC,CAAC;AAEhF,MAAM,KAAK,GAAsC,CAAC,MAAmB,EAAY,EAAE,CAC/E,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CACnB,CAAC,CAAC,KAAK,EAAE,KAAK,CAA8B,EAAU,EAAE,CACpD,KAAK,KAAK,sBAAsB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAY,EAAU,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtG,CAAC;AAEN,MAAM,QAAQ,GAAmD,CAAC,MAAmB,EAAyB,EAAE,CAC5G,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAEzC,MAAM,QAAQ,GAAsC,CAAC,MAAmB,EAAY,EAAE,CAAC;IACnF,GAAG,KAAK,CAAC,MAAM,CAAC;IAChB,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAe,EAAU,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,MAAM,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IACvG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAiB,EAAU,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,MAAM,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;CAC7G,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,OAA0B,EAAE;IAC3D,MAAM,IAAI,GAAW,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,WAAW,+BAA+B,CAAC,EAAE,CAAC;IAC/E,CAAC;IAED,MAAM,MAAM,GAAW,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC5E,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEpE,OAAO;QACH,IAAI,EAAE,CAAC;QACP,KAAK,EAAE;YACH,WAAW,WAAW,EAAE;YACxB,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,qBAAqB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,8BAA8B;YACjF,WAAW,aAAa,oDAAoD;YAC5E,mDAAmD;SACtD;KACJ,CAAC;AACN,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAiB,EAAE,KAAc;IAClD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC;IACzC,MAAM,MAAM,GAAmB,UAAU,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACR,MAAM,MAAM,GAAgB,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACvE,MAAM,OAAO,GAAwB,SAAS,CAAC,MAAM,CAAC,CAAC;QACvD,yFAAyF;QACzF,yFAAyF;QACzF,MAAM,KAAK,GAA0B,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3D,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,iDAAiD,OAAO,EAAE,CAAC,EAAE,CAAC;QAC5F,CAAC;QAED,OAAO;YACH,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC,6BAA6B,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;SACnH,CAAC;IACN,CAAC;IAED,MAAM,MAAM,GAAgB,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACtE,0FAA0F;IAC1F,uCAAuC;IACvC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,gDAAgD,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACpG,CAAC;IAED,MAAM,OAAO,GAAwB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAe,EAAW,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACnH,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO;YACH,IAAI,EAAE,CAAC;YACP,KAAK,EAAE;gBACH,6DAA6D;gBAC7D,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAe,EAAU,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,MAAM,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5F,mEAAmE;aACtE;SACJ,CAAC;IACN,CAAC;IAED,OAAO;QACH,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;YACxB,CAAC,CAAC,CAAC,qBAAqB,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAY,EAAU,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC9G,CAAC,CAAC,CAAC,mBAAmB,CAAC;KAC9B,CAAC;AACN,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAiB;IACpC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC;IACzC,MAAM,MAAM,GAAmB,UAAU,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,MAAM,GAAgB,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACvE,MAAM,OAAO,GAA0B,IAAI,GAAG,EAAE,CAAC;IACjD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,OAAO,GAA+B,WAAW,CAAC,SAAS,CAAC,CAAC;IACnE,MAAM,KAAK,GAAW,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC;IAE9D,MAAM,KAAK,GAAa;QACpB,UAAU,OAAO,oBAAoB,OAAO,CAAC,MAAM,WAAW,KAAK,EAAE;QACrE,eAAe,OAAO,CAAC,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,gBAAgB,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE;QAC9F,uBAAuB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE;QACxD,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAqB,EAAU,EAAE,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,KAAK,EAAE,CAAC;QACzG,GAAG,QAAQ,CAAC,MAAM,CAAC;KACtB,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAC,GAAiB;IAClC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC;IACzC,MAAM,MAAM,GAAmB,UAAU,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,OAAO,GAA+B,WAAW,CAAC,SAAS,CAAC,CAAC;IACnE,MAAM,OAAO,GAA0B,IAAI,GAAG,EAAE,CAAC;IAEjD,IAAI,MAAM,EAAE,CAAC;QACT,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAuC,CAAC,KAAsB,EAAU,EAAE;QACnF,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,aAAa,CAAC;QACzB,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACjC,OAAO,OAAO,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,OAAO,UAAU,CAAC;QACtB,CAAC;QACD,MAAM,OAAO,GAAyB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAE5D,mFAAmF;QACnF,4DAA4D;QAC5D,OAAO,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC;IAChE,CAAC,CAAC;IAEF,MAAM,IAAI,GAAW,OAAO,CAAC,MAAM,CAAC,CAAC,KAAa,EAAE,KAAsB,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9H,MAAM,KAAK,GAAW,OAAO,CAAC,MAAM,CAAC,CAAC,KAAa,EAAE,KAAsB,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnI,MAAM,KAAK,GAAa,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC,CAAC,UAAU,OAAO,KAAK,WAAW,iBAAiB,CAAC,CAAC;IAE5G,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,OAAO,GAA+B,OAAO,CAAC,MAAM,CAAC,CAAC,KAAsB,EAAW,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACrH,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAClB,SAAS;QACb,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CACN,GAAG,OAAO,CAAC,GAAG,CACV,CAAC,KAAsB,EAAU,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,KAAK,EAAE,CACtH,CACJ,CAAC;IACN,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC","sourcesContent":["/**\n * Команды и их вывод. Печать отделена от работы: команда возвращает строки и код возврата,\n * а `process.exit` зовёт только точка входа — иначе ни одну из них нельзя было бы проверить\n * спекой, не перехватывая поток вывода.\n */\nimport { existsSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { collectAssets } from './assets.js';\nimport { IEntryOfCatalog, isChosen, readCatalog } from './catalog.js';\nimport { ICompanion, isUnfilled, TCompanionState } from './companion.js';\nimport { CONFIG_PATH, DEFAULT_LAYOUT, IConfig, KINDS, OVERRIDES_DIR, readConfig, TKind } from './config.js';\nimport { IPlanned, isRefusal, TOutcome } from './plan.js';\nimport { ISyncResult, pendingOf, planSync, runSync } from './sync.js';\n\nexport interface IOutcomeOfCommand {\n    readonly code: number;\n    readonly lines: readonly string[];\n}\n\n/** Всё, что команда знает о мире: корень проекта, версия пакета и его каталог ресурсов. */\nexport interface IEnvironment {\n    readonly root: string;\n    readonly version: string;\n    readonly assetsDir: string;\n}\n\n/** Что с файлом сделала раскладка. Прошедшее время здесь правда: `sync` уже записал. */\nconst DONE_WORD: Readonly<Record<TOutcome, string>> = {\n    create: 'положен',\n    update: 'переложен',\n    drift: 'правлен руками',\n    foreign: 'положен не пакетом',\n    ok: 'без изменений',\n};\n\n/**\n * Что с файлом **сейчас**. Отдельно от прошедшего времени потому, что `doctor` и `list` ничего\n * не пишут: сказать «положен» о файле, которого в дереве нет, значит соврать читателю ровно там,\n * где он пришёл узнать состояние.\n */\nconst STATE_WORD: Readonly<Record<TOutcome, string>> = {\n    create: 'нет в дереве',\n    update: 'отстал от пакета',\n    drift: 'правлен руками',\n    foreign: 'положен не пакетом',\n    ok: 'на месте',\n};\n\nconst NOT_CHOSEN: string = 'не выбран';\nconst SKIPPED: string = 'пропущен';\n\nconst KIND_TITLE: Readonly<Record<TKind, string>> = {\n    laws: 'ЗАКОНЫ',\n    rules: 'ПРАВИЛА',\n    patterns: 'ПАТТЕРНЫ',\n    hooks: 'ХУКИ',\n    checks: 'ПРОВЕРКИ',\n    agents: 'АГЕНТЫ',\n    commands: 'КОМАНДЫ',\n    workflows: 'ВОРКФЛОУ',\n    templates: 'ШАБЛОНЫ',\n};\n\n/** Состояние компаньона словами. У заполненного слова нет: о нём говорить нечего. */\nconst COMPANION_WORD: Readonly<Record<TCompanionState, string>> = {\n    missing: 'пропал',\n    draft: 'остался черновиком',\n    filled: 'заполнен',\n};\n\nconst NO_CONFIG: string = `нет \\`${CONFIG_PATH}\\` — начни с \\`agent-kit init\\``;\n\nconst holes: (result: ISyncResult) => string[] = (result: ISyncResult): string[] =>\n    [...result.missing].map(\n        ([asset, names]: [string, readonly string[]]): string =>\n            `  ${asset}: нет значений для ${names.map((name: string): string => `{{${name}}}`).join(', ')}`\n    );\n\nconst unfilled: (result: ISyncResult) => readonly ICompanion[] = (result: ISyncResult): readonly ICompanion[] =>\n    result.companions.filter(isUnfilled);\n\nconst describe: (result: ISyncResult) => string[] = (result: ISyncResult): string[] => [\n    ...holes(result),\n    ...pendingOf(result).map((entry: IPlanned): string => `  ${entry.path} — ${STATE_WORD[entry.outcome]}`),\n    ...unfilled(result).map((entry: ICompanion): string => `  ${entry.path} — ${COMPANION_WORD[entry.state]}`),\n];\n\n/**\n * Что проект выбрал при заведении конфига. Пустой список — весь набор; выбор приходит сюда\n * готовым, потому что взять его негде, кроме края: у строки запуска флаг, у терминала вопрос,\n * а у неинтерактивного прогона нет ни того ни другого — и решать это команде не по чину.\n */\nexport function init(root: string, only: readonly string[] = []): IOutcomeOfCommand {\n    const path: string = join(root, CONFIG_PATH);\n    if (existsSync(path)) {\n        return { code: 0, lines: [`${CONFIG_PATH} уже есть — оставлен как есть`] };\n    }\n\n    const config: object = { vars: {}, layout: DEFAULT_LAYOUT, only, skip: [] };\n    mkdirSync(join(root, OVERRIDES_DIR), { recursive: true });\n    mkdirSync(join(root, CONFIG_PATH, '..'), { recursive: true });\n    writeFileSync(path, `${JSON.stringify(config, null, 4)}\\n`, 'utf8');\n\n    return {\n        code: 0,\n        lines: [\n            `заведён ${CONFIG_PATH}`,\n            only.length ? `выбрано ресурсов: ${only.length}` : 'выбрано всё, что везёт пакет',\n            `заведён ${OVERRIDES_DIR}/ — надстройки проекта кладутся сюда путём ресурса`,\n            'дальше: заполни `vars` и запусти `agent-kit sync`',\n        ],\n    };\n}\n\nexport function sync(env: IEnvironment, check: boolean): IOutcomeOfCommand {\n    const { root, version, assetsDir } = env;\n    const config: IConfig | null = readConfig(root);\n    if (!config) {\n        return { code: 1, lines: [NO_CONFIG] };\n    }\n\n    if (check) {\n        const result: ISyncResult = planSync(config, root, version, assetsDir);\n        const pending: readonly IPlanned[] = pendingOf(result);\n        // Незаполненный компаньон — такое же расхождение, как отставший файл: правило разложено,\n        // а имён этого дерева при нём нет, и агент читает указание, которому некуда примениться.\n        const empty: readonly ICompanion[] = unfilled(result);\n        if (!result.missing.size && !pending.length && !empty.length) {\n            return { code: 0, lines: [`sync --check: разложенное сходится с пакетом v${version}`] };\n        }\n\n        return {\n            code: 1,\n            lines: [`sync --check: расхождений ${result.missing.size + pending.length + empty.length}`, ...describe(result)],\n        };\n    }\n\n    const result: ISyncResult = runSync(config, root, version, assetsDir);\n    // Перечисляются только дырки: раскладка не начата, и назвать файл «положенным» значило бы\n    // сказать неправду — на диске его нет.\n    if (result.missing.size) {\n        return { code: 1, lines: ['раскладка не начата: нечего подставить в дырки', ...holes(result)] };\n    }\n\n    const refused: readonly IPlanned[] = result.planned.filter((entry: IPlanned): boolean => isRefusal(entry.outcome));\n    if (refused.length) {\n        return {\n            code: 1,\n            lines: [\n                'раскладка не начата: эти файлы пакет переписывать не станет',\n                ...refused.map((entry: IPlanned): string => `  ${entry.path} — ${DONE_WORD[entry.outcome]}`),\n                'правку надо либо перенести в надстройку, либо снять — и повторить',\n            ],\n        };\n    }\n\n    return {\n        code: 0,\n        lines: result.written.length\n            ? [`разложено файлов: ${result.written.length}`, ...result.written.map((path: string): string => `  ${path}`)]\n            : ['всё уже разложено'],\n    };\n}\n\nexport function doctor(env: IEnvironment): IOutcomeOfCommand {\n    const { root, version, assetsDir } = env;\n    const config: IConfig | null = readConfig(root);\n    if (!config) {\n        return { code: 1, lines: [NO_CONFIG] };\n    }\n\n    const result: ISyncResult = planSync(config, root, version, assetsDir);\n    const counted: Map<TOutcome, number> = new Map();\n    for (const entry of result.planned) {\n        counted.set(entry.outcome, (counted.get(entry.outcome) ?? 0) + 1);\n    }\n\n    const catalog: readonly IEntryOfCatalog[] = readCatalog(assetsDir);\n    const taken: number = collectAssets(config, assetsDir).length;\n\n    const lines: string[] = [\n        `пакет v${version}, везёт ресурсов ${catalog.length}, взято ${taken}`,\n        `не выбрано: ${catalog.length - taken - config.skip.length}, пропущено: ${config.skip.length}`,\n        `значений в конфиге: ${Object.keys(config.vars).length}`,\n        ...[...counted].map(([outcome, count]: [TOutcome, number]): string => `${STATE_WORD[outcome]}: ${count}`),\n        ...describe(result),\n    ];\n\n    return { code: 0, lines };\n}\n\n/**\n * Что пакет везёт и что из этого взято здесь.\n *\n * Работает и без конфига: посмотреть, из чего выбирать, нужно раньше, чем выбор сделан, — иначе\n * имена законов взять неоткуда, кроме исходников пакета.\n */\nexport function list(env: IEnvironment): IOutcomeOfCommand {\n    const { root, version, assetsDir } = env;\n    const config: IConfig | null = readConfig(root);\n    const catalog: readonly IEntryOfCatalog[] = readCatalog(assetsDir);\n    const planned: Map<string, TOutcome> = new Map();\n\n    if (config) {\n        for (const entry of planSync(config, root, version, assetsDir).planned) {\n            planned.set(entry.asset, entry.outcome);\n        }\n    }\n\n    const stateOf: (entry: IEntryOfCatalog) => string = (entry: IEntryOfCatalog): string => {\n        if (!config) {\n            return 'везёт пакет';\n        }\n        if (config.skip.includes(entry.id)) {\n            return SKIPPED;\n        }\n        if (!isChosen(entry, config.only, config.skip)) {\n            return NOT_CHOSEN;\n        }\n        const outcome: TOutcome | undefined = planned.get(entry.id);\n\n        // Ресурса нет среди запланированных ровно в одном случае: в нём осталась дырка без\n        // значения, и до решения о судьбе файла раскладка не дошла.\n        return outcome ? STATE_WORD[outcome] : 'дырка без значения';\n    };\n\n    const name: number = catalog.reduce((found: number, entry: IEntryOfCatalog): number => Math.max(found, entry.name.length), 0);\n    const state: number = catalog.reduce((found: number, entry: IEntryOfCatalog): number => Math.max(found, stateOf(entry).length), 0);\n    const lines: string[] = [config ? `пакет v${version}` : `пакет v${version}, ${CONFIG_PATH} ещё не заведён`];\n\n    for (const kind of KINDS) {\n        const entries: readonly IEntryOfCatalog[] = catalog.filter((entry: IEntryOfCatalog): boolean => entry.kind === kind);\n        if (!entries.length) {\n            continue;\n        }\n        lines.push('', KIND_TITLE[kind]);\n        lines.push(\n            ...entries.map(\n                (entry: IEntryOfCatalog): string => `  ${entry.name.padEnd(name)}  ${stateOf(entry).padEnd(state)}  ${entry.title}`\n            )\n        );\n    }\n\n    return { code: 0, lines };\n}\n"]}

package/lib/companion.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Файл-компаньон правила: чем названо в этом дереве то, о чём правило говорит приёмом.
+ *
+ * Правило пакета переносимо ровно потому, что не знает ни путей, ни имён: оно говорит, какой
+ * приём здесь действует и что сломается без него. Но правило без имён дерева — это закон, и
+ * агент по нему работать не может: ему нужно знать, как называется здесь то, о чём идёт речь,
+ * и где оно лежит.
+ *
+ * Поэтому имена живут рядом с правилом, в отдельном файле, и пишет его проект. Пакет кладёт
+ * черновик один раз и больше к нему не возвращается: сверять его нечем — своего текста у пакета
+ * там нет, а перекладывать значило бы стирать написанное проектом.
+ *
+ * Отсюда и три состояния вместо двух. Черновик, который никто не заполнил, — не то же самое,
+ * что заполненный компаньон, и не то же самое, что пропавший: он выглядит рабочим файлом, но
+ * правило при нём остаётся указанием без адресата.
+ */
+import { IAsset } from './assets.js';
+/**
+ * Метка незаполненного места. Стоит в каждой строке черновика, которую должен заменить проект,
+ * и снимается вместе с ней: пока метка на месте, компаньон не заполнен.
+ */
+export declare const COMPANION_MARK: string;
+export type TCompanionState = 
+/** Файла нет: правило разложено, а имён дерева при нём не оказалось. */
+'missing'
+/** Черновик лежит, но остался как положен. */
+ | 'draft'
+/** Проект его заполнил. */
+ | 'filled';
+export interface ICompanion {
+    /** Правило, при котором стоит компаньон. */
+    readonly rule: string;
+    readonly path: string;
+    readonly state: TCompanionState;
+    /** Что записать; `null` — писать нечего, файл уже лежит. */
+    readonly content: string | null;
+}
+/** Путь компаньона: рядом с самим правилом, в каталоге его имени. */
+export declare const pathOf: (asset: IAsset) => string;
+/**
+ * Место имени правила в шаблоне. Угловые скобки, а не `{{дырка}}`: дырка без значения отказывает
+ * раскладке, а шаблон компаньона пакет кладёт проекту и сам — на нём раскладка и споткнулась бы.
+ */
+export declare const RULE_SLOT: string;
+/**
+ * Черновик по шаблону пакета. Имя правила подставляется, чтобы заполняющий не гадал, к чему
+ * файл относится, — открывают его обычно из гейта, а не из правила.
+ */
+export declare const draftOf: (template: string, rule: string) => string;
+export declare function planCompanion(asset: IAsset, existing: string | null, template: string): ICompanion;
+/** Что `sync --check` считает недоделанным: правило при пустом компаньоне не действует. */
+export declare const isUnfilled: (companion: ICompanion) => boolean;
+//# sourceMappingURL=companion.d.ts.map

package/lib/companion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/companion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAoC,CAAC;AAElE,MAAM,MAAM,eAAe;AACvB,wEAAwE;AACtE,SAAS;AACX,8CAA8C;GAC5C,OAAO;AACT,2BAA2B;GACzB,QAAQ,CAAC;AAEf,MAAM,WAAW,UAAU;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,qEAAqE;AACrE,eAAO,MAAM,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAkF,CAAC;AAE3H;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,MAAwB,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAClB,CAAC;AAEzC,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAYlG;AAED,2FAA2F;AAC3F,eAAO,MAAM,UAAU,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,OAA0E,CAAC"}

package/lib/companion.js

@@ -0,0 +1,33 @@
+import { COMPANION_FILE } from './config.js';
+/**
+ * Метка незаполненного места. Стоит в каждой строке черновика, которую должен заменить проект,
+ * и снимается вместе с ней: пока метка на месте, компаньон не заполнен.
+ */
+export const COMPANION_MARK = '<!-- заполняет проект -->';
+/** Путь компаньона: рядом с самим правилом, в каталоге его имени. */
+export const pathOf = (asset) => asset.target.replace(/[^/]+$/, COMPANION_FILE);
+/**
+ * Место имени правила в шаблоне. Угловые скобки, а не `{{дырка}}`: дырка без значения отказывает
+ * раскладке, а шаблон компаньона пакет кладёт проекту и сам — на нём раскладка и споткнулась бы.
+ */
+export const RULE_SLOT = '<имя-правила>';
+/**
+ * Черновик по шаблону пакета. Имя правила подставляется, чтобы заполняющий не гадал, к чему
+ * файл относится, — открывают его обычно из гейта, а не из правила.
+ */
+export const draftOf = (template, rule) => template.split(RULE_SLOT).join(rule);
+export function planCompanion(asset, existing, template) {
+    const path = pathOf(asset);
+    if (existing === null) {
+        return { rule: asset.name, path, state: 'missing', content: draftOf(template, asset.name) };
+    }
+    return {
+        rule: asset.name,
+        path,
+        state: existing.includes(COMPANION_MARK) ? 'draft' : 'filled',
+        content: null,
+    };
+}
+/** Что `sync --check` считает недоделанным: правило при пустом компаньоне не действует. */
+export const isUnfilled = (companion) => companion.state !== 'filled';
+//# sourceMappingURL=companion.js.map

package/lib/companion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/companion.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAW,2BAA2B,CAAC;AAmBlE,qEAAqE;AACrE,MAAM,CAAC,MAAM,MAAM,GAA8B,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;AAE3H;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAW,eAAe,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAA+C,CAAC,QAAgB,EAAE,IAAY,EAAU,EAAE,CAC1G,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEzC,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,QAAuB,EAAE,QAAgB;IAClF,MAAM,IAAI,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;IAChG,CAAC;IAED,OAAO;QACH,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI;QACJ,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;QAC7D,OAAO,EAAE,IAAI;KAChB,CAAC;AACN,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,MAAM,UAAU,GAAuC,CAAC,SAAqB,EAAW,EAAE,CAAC,SAAS,CAAC,KAAK,KAAK,QAAQ,CAAC","sourcesContent":["/**\n * Файл-компаньон правила: чем названо в этом дереве то, о чём правило говорит приёмом.\n *\n * Правило пакета переносимо ровно потому, что не знает ни путей, ни имён: оно говорит, какой\n * приём здесь действует и что сломается без него. Но правило без имён дерева — это закон, и\n * агент по нему работать не может: ему нужно знать, как называется здесь то, о чём идёт речь,\n * и где оно лежит.\n *\n * Поэтому имена живут рядом с правилом, в отдельном файле, и пишет его проект. Пакет кладёт\n * черновик один раз и больше к нему не возвращается: сверять его нечем — своего текста у пакета\n * там нет, а перекладывать значило бы стирать написанное проектом.\n *\n * Отсюда и три состояния вместо двух. Черновик, который никто не заполнил, — не то же самое,\n * что заполненный компаньон, и не то же самое, что пропавший: он выглядит рабочим файлом, но\n * правило при нём остаётся указанием без адресата.\n */\nimport { IAsset } from './assets.js';\nimport { COMPANION_FILE } from './config.js';\n\n/**\n * Метка незаполненного места. Стоит в каждой строке черновика, которую должен заменить проект,\n * и снимается вместе с ней: пока метка на месте, компаньон не заполнен.\n */\nexport const COMPANION_MARK: string = '<!-- заполняет проект -->';\n\nexport type TCompanionState =\n    /** Файла нет: правило разложено, а имён дерева при нём не оказалось. */\n    | 'missing'\n    /** Черновик лежит, но остался как положен. */\n    | 'draft'\n    /** Проект его заполнил. */\n    | 'filled';\n\nexport interface ICompanion {\n    /** Правило, при котором стоит компаньон. */\n    readonly rule: string;\n    readonly path: string;\n    readonly state: TCompanionState;\n    /** Что записать; `null` — писать нечего, файл уже лежит. */\n    readonly content: string | null;\n}\n\n/** Путь компаньона: рядом с самим правилом, в каталоге его имени. */\nexport const pathOf: (asset: IAsset) => string = (asset: IAsset): string => asset.target.replace(/[^/]+$/, COMPANION_FILE);\n\n/**\n * Место имени правила в шаблоне. Угловые скобки, а не `{{дырка}}`: дырка без значения отказывает\n * раскладке, а шаблон компаньона пакет кладёт проекту и сам — на нём раскладка и споткнулась бы.\n */\nexport const RULE_SLOT: string = '<имя-правила>';\n\n/**\n * Черновик по шаблону пакета. Имя правила подставляется, чтобы заполняющий не гадал, к чему\n * файл относится, — открывают его обычно из гейта, а не из правила.\n */\nexport const draftOf: (template: string, rule: string) => string = (template: string, rule: string): string =>\n    template.split(RULE_SLOT).join(rule);\n\nexport function planCompanion(asset: IAsset, existing: string | null, template: string): ICompanion {\n    const path: string = pathOf(asset);\n    if (existing === null) {\n        return { rule: asset.name, path, state: 'missing', content: draftOf(template, asset.name) };\n    }\n\n    return {\n        rule: asset.name,\n        path,\n        state: existing.includes(COMPANION_MARK) ? 'draft' : 'filled',\n        content: null,\n    };\n}\n\n/** Что `sync --check` считает недоделанным: правило при пустом компаньоне не действует. */\nexport const isUnfilled: (companion: ICompanion) => boolean = (companion: ICompanion): boolean => companion.state !== 'filled';\n"]}

package/lib/config.d.ts

@@ -1,6 +1,20 @@
 /** Род ресурса. Он же имя каталога в `assets/` пакета и ключ раскладки. */
-export type TKind = 'laws' | 'hooks' | 'checks' | 'agents' | 'templates';
+export type TKind = 'laws' | 'rules' | 'patterns' | 'hooks' | 'checks' | 'agents' | 'commands' | 'workflows' | 'templates';
 export declare const KINDS: readonly TKind[];
+/**
+ * Роды, которые ложатся не файлом в каталог, а каталогом по имени ресурса: скил читается как
+ * `<имя>/SKILL.md`, и рядом с ним лежит то, что пишет проект.
+ */
+export declare const SKILL_KINDS: readonly TKind[];
+/** Имя файла скила: так его ищет агент, и другого имени у него быть не может. */
+export declare const SKILL_FILE: string;
+/**
+ * Файл-компаньон правила: чем названо в этом дереве то, о чём правило говорит приёмом.
+ *
+ * Пакет знает приём, но не знает ни путей, ни имён — их пишет проект. Черновик кладётся один
+ * раз и дальше не сверяется: это единственный файл раскладки, который принадлежит проекту.
+ */
+export declare const COMPANION_FILE: string;
 export interface IConfig {
     /** Значения дырок `{{имя}}`. */
     readonly vars: Readonly<Record<string, string>>;
@@ -16,6 +30,15 @@ export interface IConfig {
 }
 export declare const CONFIG_PATH: string;
 export declare const OVERRIDES_DIR: string;
+/** Имя дырки под путь карты гейта и её умолчание: карту пишет проект, путь знают оба. */
+export declare const GATE_MAP_VAR: string;
+export declare const DEFAULT_GATE_MAP: string;
+/**
+ * Профиль проекта: команды, стенды и пары «правка — документ» этого дерева. Его читают
+ * сторожевые хуки — механизм у них общий, а всё, что они зовут и называют, своё у каждого.
+ */
+export declare const PROFILE_VAR: string;
+export declare const DEFAULT_PROFILE: string;
 /**
  * Умолчания раскладки. Это не единственно возможные пути, но менять их без нужды не стоит:
  * агент ищет законы в `docs/constitution`, потому что так написано в правилах, которые пакет

package/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/config.ts"],"names":[],"mappings":"AAUA,2EAA2E;AAC3E,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEzE,eAAO,MAAM,KAAK,EAAE,SAAS,KAAK,EAAuD,CAAC;AAE1F,MAAM,WAAW,OAAO;IACpB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,eAAO,MAAM,WAAW,EAAE,MAA8B,CAAC;AACzD,eAAO,MAAM,aAAa,EAAE,MAAmC,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAM1D,CAAC;AAEF,qBAAa,WAAY,SAAQ,KAAK;CAAG;AAgCzC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA6BjD;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAUvD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/config.ts"],"names":[],"mappings":"AAUA,2EAA2E;AAC3E,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAE3H,eAAO,MAAM,KAAK,EAAE,SAAS,KAAK,EAAqG,CAAC;AAExI;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,KAAK,EAA0B,CAAC;AAEnE,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,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,eAAO,MAAM,WAAW,EAAE,MAA8B,CAAC;AACzD,eAAO,MAAM,aAAa,EAAE,MAAmC,CAAC;AAEhE,yFAAyF;AACzF,eAAO,MAAM,YAAY,EAAE,MAAkB,CAAC;AAC9C,eAAO,MAAM,gBAAgB,EAAE,MAAqC,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAyB,CAAC;AACpD,eAAO,MAAM,eAAe,EAAE,MAAoC,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAU1D,CAAC;AAEF,qBAAa,WAAY,SAAQ,KAAK;CAAG;AAgCzC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAkCjD;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAUvD"}

package/lib/config.js

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