@rt-tools/agent-kit 0.1.0

package/assets/laws/search-visibility.md

@@ -0,0 +1,37 @@
+# Видимость в поиске
+
+Как публичный сайт выглядит для поисковика. Страница живёт в нескольких языках под одним
+доменом, и от разметки зависит, считает поисковик эти адреса одной страницей на разных
+языках или дублями друг друга. Ошибка здесь не видна ни в сборке, ни в браузере: она
+проявляется падением выдачи через недели.
+
+**Ревизия:** 2026-08-05
+
+## Статьи
+
+- **У страницы один канонический адрес — её собственный, на её языке.** Общий канонический
+  адрес на все языки означает, что остальные версии объявлены копиями и в выдачу не попадут.
+- **Разметка страницы при переходе переписывается, а не накапливается.** Иначе на второй
+  открытой странице остаётся описание первой, и два адреса объявляют один канонический.
+- **Языковая версия объявляется поисковику только тогда, когда её перевод готов.** Позвать
+  поисковика на страницу, где текст остался на чужом языке, — значит отдать дубль под
+  неверным языковым тегом.
+- **Страница объявляет себя структурированными данными.** Без них поисковик разбирает
+  содержимое догадками.
+- **Карта сайта строится из живых данных, а не из файла.** Файл устаревает молча в тот же
+  день, когда добавили страницу.
+- **Прежний адрес страницы ведёт на новый постоянным перенаправлением.** Смена адреса без
+  перенаправления обнуляет накопленный вес страницы.
+- **Перенаправление с прежнего адреса живёт в кэше наравне со страницами.** Некэшируемое
+  перенаправление не вытесняет из кэша старую страницу, и гость видит её ещё сутки.
+
+## Открытые вопросы
+
+- **Q-SV-1 — что становится каноническим адресом, когда страниц одного вида несколько.**
+  Сегодня корень языка отдаёт единственную страницу и объявляет каноническим её адрес.
+  Решение изменит, появится ли у списка собственный канонический адрес. Заведён 2026-08-05.
+
+## История изменений
+
+- **2026-08-05.** Закон заведён: статьи собраны из правила `seo` — в нём осталось только то,
+  из чего разметка собирается.

package/assets/laws/shared-code.md

@@ -0,0 +1,32 @@
+# Общий код приложений
+
+Что сайт, админка и бэкенд понимают одинаково: размер страницы, набор операторов условия,
+направление порядка, длину поля. Записанное дважды расходится по одному значению за раз, и
+каждая копия при этом сама по себе исправна — ни линт, ни сборка, ни тесты второй не видят.
+
+Закон говорит о том, что общим быть обязано. Где такой символ лежит и кто его видит — не
+его предмет.
+
+**Ревизия:** 2026-08-02
+
+## Статьи
+
+- **Число-настройка объявлено один раз на все приложения.** Размер страницы жил шестью
+  объявлениями, и одно из них успело стать `25` против `20` у остальных.
+- **Набор значений, уже объявленный в общем пакете, заново не объявляется.** Оператор условия
+  и направление порядка лежали на бэкенде рукописной копией того же набора.
+- **Значение из конечного набора сверяется с набором, а не приводится к типу.** Приведение
+  принимает любую строку, и порядок молча становится нечитаемым.
+- **Номер страницы меньше единицы читается как первая.** Отрицательный номер доходил до
+  переключателя страниц как есть.
+
+## Открытые вопросы
+
+- **Q-S-1 — перевод сущности на двух сторонах устроен по-разному.** Фронт переводит классом
+  с приведением через `typeCast`, бэкенд — свободными функциями без общей основы, хотя пакет
+  с этой основой виден обоим. Решение изменит, станет ли `BaseMapper` общей формой перевода
+  или у сторон останутся две. Заведён 2026-08-02.
+- **Q-S-2 — совпадение строковой настройки и таблицы соответствий не сверяется.** Проверка
+  считает только числа: у строк под одним именем значение бывает своим в каждой либе, и учёт
+  их дал бы полсотни ложных срабатываний. Решение изменит, появится ли признак, который
+  отличает общее понятие от совпавшего имени. Заведён 2026-08-02.

package/assets/laws/verifiability.md

@@ -0,0 +1,33 @@
+# Проверяемость
+
+Что считается подтверждением того, что работа сделана. Закон нужен потому, что пересказ
+выглядит так же уверенно, как проверенное утверждение, и отличить их потом нечем: код,
+который «должен работать», и код, который проверили, в истории выглядят одинаково.
+
+**Ревизия:** 2026-08-05
+
+## Статьи
+
+- **Обещанное поведение названо сценарием, а сценарий назван в тесте, который его
+  проверяет.** Иначе связь между обещанием и проверкой держится только на памяти автора.
+- **Сценарий без теста помечен как непокрытый и виден в сводке.** Молчаливый пропуск
+  выглядит так же, как покрытый сценарий, и долг перестаёт быть заметным.
+- **Тест, проверяющий часть обещанного, считается долгом, а не покрытием.** Иначе сводка
+  показывает выполненным то, что выполнено наполовину.
+- **Упоминание в тесте сценария, которого нет, — отказ.** Так ловится переименованный или
+  выкинутый сценарий: без этого он пропадает молча.
+- **Работающее приложение проверяется там, где его видит пользователь.** Отладочный режим
+  ведёт себя иначе рабочего, и проверка в нём подтверждает не то, что будет у пользователя.
+- **Разметка проверяется замером, а не взглядом.** На глаз не отличить отступ от поля и
+  выравнивание от совпадения, и расхождение находится уже после выкатки.
+
+## Открытые вопросы
+
+- **Q-V-1 — что считать достаточным покрытием сценария.** Сегодня достаточно одного теста,
+  назвавшего сценарий, и его глубину не проверяет ничто. Решение изменит, появится ли
+  требование к тому, каким путём тест идёт. Заведён 2026-08-05.
+
+## История изменений
+
+- **2026-08-05.** Закон заведён: статьи собраны из правил `testing` и `browser-verification`
+  — в них осталось то, из чего проверка собирается.

package/assets/templates/pattern.md

@@ -0,0 +1,29 @@
+---
+name: <имя-правила>-<что>
+kind: pattern
+rule: <имя-правила>
+description: Паттерн правила <имя-правила>. Брать <когда> — <что даёт>. Не брать для <соседний случай> — это паттерн <имя соседа>.
+---
+
+# <Что собирается>
+
+Паттерн правила `<имя-правила>`. Что при этом должно быть верно — закон
+`{{lawsDir}}/<закон>.md`.
+
+## Когда брать
+
+- <Случай, по которому паттерн узнаётся.>
+
+## <Приём>
+
+<Готовый код целиком, а не пересказ: паттерн берут, чтобы не писать заново.>
+
+```
+<код>
+```
+
+<Одно-два предложения о том, почему именно так, если из кода этого не видно.>
+
+## Частые промахи
+
+- <Что делают вместо этого и чем это кончается.>

package/assets/templates/rule.md

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

package/bin/agent-kit.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { IOutcomeOfCommand } from '../lib/commands.js';
+export declare function main(argv: readonly string[]): IOutcomeOfCommand;
+//# sourceMappingURL=agent-kit.d.ts.map

package/bin/agent-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-kit.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/bin/agent-kit.ts"],"names":[],"mappings":";AAUA,OAAO,EAA8B,iBAAiB,EAAQ,MAAM,oBAAoB,CAAC;AAgCzF,wBAAgB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CAc/D"}

package/bin/agent-kit.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+/**
+ * Точка входа. Разбирает аргументы, зовёт команду и печатает то, что она вернула, — своей
+ * работы у неё нет: всё, что решает, живёт в `commands.ts` и проверяется спеками.
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import process from 'node:process';
+import { doctor, init, sync } from '../lib/commands.js';
+import { packageRootFrom } from '../lib/package-root.js';
+const USAGE = [
+    'agent-kit <команда>',
+    '',
+    '  init            завести .claude/rt-kit.json и каталог надстроек',
+    '  sync            разложить ресурсы пакета в дерево проекта',
+    '  sync --check    ничего не писать, отказать при расхождении — для гейта пуша',
+    '  doctor          рассказать о состоянии раскладки, ничего не меняя',
+    '',
+    '  --root <путь>   корень проекта; по умолчанию текущий каталог',
+];
+/**
+ * Единственное место, где пакет узнаёт собственное расположение. `import.meta` живёт только
+ * здесь: библиотечные модули получают каталог ресурсов входным значением, и трансформ тестов,
+ * разбирающий модули как CommonJS, на них уже не спотыкается.
+ */
+function environmentOf(root) {
+    const pkg = packageRootFrom(dirname(fileURLToPath(import.meta.url)));
+    const version = JSON.parse(readFileSync(join(pkg, 'package.json'), 'utf8')).version;
+    return { root, version, assetsDir: join(pkg, 'assets') };
+}
+function optionOf(argv, name, fallback) {
+    const index = argv.indexOf(name);
+    return index >= 0 && argv[index + 1] ? argv[index + 1] : fallback;
+}
+export function main(argv) {
+    const command = argv[0] ?? '';
+    const env = environmentOf(resolve(optionOf(argv, '--root', process.cwd())));
+    switch (command) {
+        case 'init':
+            return init(env.root);
+        case 'sync':
+            return sync(env, argv.includes('--check'));
+        case 'doctor':
+            return doctor(env);
+        default:
+            return { code: command ? 1 : 0, lines: command ? [`неизвестная команда «${command}»`, '', ...USAGE] : USAGE };
+    }
+}
+const outcome = main(process.argv.slice(2));
+for (const line of outcome.lines) {
+    // eslint-disable-next-line no-console
+    console.log(line);
+}
+process.exit(outcome.code);
+//# sourceMappingURL=agent-kit.js.map

package/bin/agent-kit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-kit.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/bin/agent-kit.ts"],"names":[],"mappings":";AACA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,MAAM,EAAgB,IAAI,EAAqB,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,KAAK,GAAsB;IAC7B,qBAAqB;IACrB,EAAE;IACF,mEAAmE;IACnE,6DAA6D;IAC7D,+EAA+E;IAC/E,qEAAqE;IACrE,EAAE;IACF,gEAAgE;CACnE,CAAC;AAEF;;;;GAIG;AACH,SAAS,aAAa,CAAC,IAAY;IAC/B,MAAM,GAAG,GAAW,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAyB,CAAC,OAAO,CAAC;IAErH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED,SAAS,QAAQ,CAAC,IAAuB,EAAE,IAAY,EAAE,QAAgB;IACrE,MAAM,KAAK,GAAW,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,OAAO,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAuB;IACxC,MAAM,OAAO,GAAW,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,GAAG,GAAiB,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAE1F,QAAQ,OAAO,EAAE,CAAC;QACd,KAAK,MAAM;YACP,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,KAAK,MAAM;YACP,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/C,KAAK,QAAQ;YACT,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB;YACI,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,wBAAwB,OAAO,GAAG,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;IACtH,CAAC;AACL,CAAC;AAED,MAAM,OAAO,GAAsB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/D,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAC/B,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AACD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\n/**\n * Точка входа. Разбирает аргументы, зовёт команду и печатает то, что она вернула, — своей\n * работы у неё нет: всё, что решает, живёт в `commands.ts` и проверяется спеками.\n */\nimport { readFileSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport process from 'node:process';\n\nimport { doctor, IEnvironment, init, IOutcomeOfCommand, sync } from '../lib/commands.js';\nimport { packageRootFrom } from '../lib/package-root.js';\n\nconst USAGE: readonly string[] = [\n    'agent-kit <команда>',\n    '',\n    '  init            завести .claude/rt-kit.json и каталог надстроек',\n    '  sync            разложить ресурсы пакета в дерево проекта',\n    '  sync --check    ничего не писать, отказать при расхождении — для гейта пуша',\n    '  doctor          рассказать о состоянии раскладки, ничего не меняя',\n    '',\n    '  --root <путь>   корень проекта; по умолчанию текущий каталог',\n];\n\n/**\n * Единственное место, где пакет узнаёт собственное расположение. `import.meta` живёт только\n * здесь: библиотечные модули получают каталог ресурсов входным значением, и трансформ тестов,\n * разбирающий модули как CommonJS, на них уже не спотыкается.\n */\nfunction environmentOf(root: string): IEnvironment {\n    const pkg: string = packageRootFrom(dirname(fileURLToPath(import.meta.url)));\n    const version: string = (JSON.parse(readFileSync(join(pkg, 'package.json'), 'utf8')) as { version: string }).version;\n\n    return { root, version, assetsDir: join(pkg, 'assets') };\n}\n\nfunction optionOf(argv: readonly string[], name: string, fallback: string): string {\n    const index: number = argv.indexOf(name);\n\n    return index >= 0 && argv[index + 1] ? argv[index + 1] : fallback;\n}\n\nexport function main(argv: readonly string[]): IOutcomeOfCommand {\n    const command: string = argv[0] ?? '';\n    const env: IEnvironment = environmentOf(resolve(optionOf(argv, '--root', process.cwd())));\n\n    switch (command) {\n        case 'init':\n            return init(env.root);\n        case 'sync':\n            return sync(env, argv.includes('--check'));\n        case 'doctor':\n            return doctor(env);\n        default:\n            return { code: command ? 1 : 0, lines: command ? [`неизвестная команда «${command}»`, '', ...USAGE] : USAGE };\n    }\n}\n\nconst outcome: IOutcomeOfCommand = main(process.argv.slice(2));\nfor (const line of outcome.lines) {\n    // eslint-disable-next-line no-console\n    console.log(line);\n}\nprocess.exit(outcome.code);\n"]}

package/index.d.ts

@@ -0,0 +1,9 @@
+export * from './lib/assets.js';
+export * from './lib/commands.js';
+export * from './lib/config.js';
+export * from './lib/plan.js';
+export * from './lib/sections.js';
+export * from './lib/stamp.js';
+export * from './lib/sync.js';
+export * from './lib/vars.js';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../projects/agent-kit/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/index.js

@@ -0,0 +1,9 @@
+export * from './lib/assets.js';
+export * from './lib/commands.js';
+export * from './lib/config.js';
+export * from './lib/plan.js';
+export * from './lib/sections.js';
+export * from './lib/stamp.js';
+export * from './lib/sync.js';
+export * from './lib/vars.js';
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../projects/agent-kit/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC","sourcesContent":["export * from './lib/assets.js';\nexport * from './lib/commands.js';\nexport * from './lib/config.js';\nexport * from './lib/plan.js';\nexport * from './lib/sections.js';\nexport * from './lib/stamp.js';\nexport * from './lib/sync.js';\nexport * from './lib/vars.js';\n"]}

package/lib/assets.d.ts

@@ -0,0 +1,11 @@
+import { IConfig, TKind } from './config.js';
+export interface IAsset {
+    /** Идентификатор: `laws/delivery.md`. Он же путь надстройки и ключ в `skip`. */
+    readonly id: string;
+    readonly kind: TKind;
+    readonly text: string;
+    /** Путь в дереве проекта, куда ресурс ложится. */
+    readonly target: string;
+}
+export declare function collectAssets(config: IConfig, root: string): readonly IAsset[];
+//# sourceMappingURL=assets.d.ts.map

package/lib/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/assets.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAS,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,MAAM;IACnB,gFAAgF;IAChF,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;AAaD,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAa9E"}

package/lib/assets.js

@@ -0,0 +1,35 @@
+/**
+ * Что пакет везёт и куда это ложится.
+ *
+ * Список ресурсов не выписан руками, а читается из каталога `assets/`: выписанный список
+ * разошёлся бы с каталогом на первом же добавленном законе, и заметить это было бы нечем —
+ * ресурс просто не приезжал бы к проекту.
+ */
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { KINDS } from './config.js';
+function filesOf(dir) {
+    try {
+        return readdirSync(dir, { withFileTypes: true })
+            .filter((entry) => entry.isFile())
+            .map((entry) => entry.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+export function collectAssets(config, root) {
+    const assets = [];
+    for (const kind of KINDS) {
+        for (const name of filesOf(join(root, kind))) {
+            const id = `${kind}/${name}`;
+            if (config.skip.includes(id)) {
+                continue;
+            }
+            assets.push({ id, kind, text: readFileSync(join(root, kind, name), 'utf8'), target: join(config.layout[kind], name) });
+        }
+    }
+    return assets;
+}
+//# sourceMappingURL=assets.js.map

package/lib/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/assets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAU,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAW,KAAK,EAAS,MAAM,aAAa,CAAC;AAWpD,SAAS,OAAO,CAAC,GAAW;IACxB,IAAI,CAAC;QACD,OAAO,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC3C,MAAM,CAAC,CAAC,KAAa,EAAW,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;aAClD,GAAG,CAAC,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;aAC1C,IAAI,EAAE,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAe,EAAE,IAAY;IACvD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;YAC3C,MAAM,EAAE,GAAW,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;YACrC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC3B,SAAS;YACb,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3H,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC","sourcesContent":["/**\n * Что пакет везёт и куда это ложится.\n *\n * Список ресурсов не выписан руками, а читается из каталога `assets/`: выписанный список\n * разошёлся бы с каталогом на первом же добавленном законе, и заметить это было бы нечем —\n * ресурс просто не приезжал бы к проекту.\n */\nimport { Dirent, readdirSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { IConfig, KINDS, TKind } from './config.js';\n\nexport interface IAsset {\n    /** Идентификатор: `laws/delivery.md`. Он же путь надстройки и ключ в `skip`. */\n    readonly id: string;\n    readonly kind: TKind;\n    readonly text: string;\n    /** Путь в дереве проекта, куда ресурс ложится. */\n    readonly target: string;\n}\n\nfunction filesOf(dir: string): readonly string[] {\n    try {\n        return readdirSync(dir, { withFileTypes: true })\n            .filter((entry: Dirent): boolean => entry.isFile())\n            .map((entry: Dirent): string => entry.name)\n            .sort();\n    } catch {\n        return [];\n    }\n}\n\nexport function collectAssets(config: IConfig, root: string): readonly IAsset[] {\n    const assets: IAsset[] = [];\n    for (const kind of KINDS) {\n        for (const name of filesOf(join(root, kind))) {\n            const id: string = `${kind}/${name}`;\n            if (config.skip.includes(id)) {\n                continue;\n            }\n            assets.push({ id, kind, text: readFileSync(join(root, kind, name), 'utf8'), target: join(config.layout[kind], name) });\n        }\n    }\n\n    return assets;\n}\n"]}

package/lib/commands.d.ts

@@ -0,0 +1,14 @@
+export interface IOutcomeOfCommand {
+    readonly code: number;
+    readonly lines: readonly string[];
+}
+/** Всё, что команда знает о мире: корень проекта, версия пакета и его каталог ресурсов. */
+export interface IEnvironment {
+    readonly root: string;
+    readonly version: string;
+    readonly assetsDir: string;
+}
+export declare function init(root: string): IOutcomeOfCommand;
+export declare function sync(env: IEnvironment, check: boolean): IOutcomeOfCommand;
+export declare function doctor(env: IEnvironment): IOutcomeOfCommand;
+//# sourceMappingURL=commands.d.ts.map

package/lib/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/commands.ts"],"names":[],"mappings":"AAaA,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;AAuBD,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAmBpD;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA0CzE;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAqB3D"}

package/lib/commands.js

@@ -0,0 +1,100 @@
+/**
+ * Три команды и их вывод. Печать отделена от работы: команда возвращает строки и код возврата,
+ * а `process.exit` зовёт только точка входа — иначе ни одну из них нельзя было бы проверить
+ * спекой, не перехватывая поток вывода.
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { collectAssets } from './assets.js';
+import { CONFIG_PATH, DEFAULT_LAYOUT, OVERRIDES_DIR, readConfig } from './config.js';
+import { isRefusal } from './plan.js';
+import { pendingOf, planSync, runSync } from './sync.js';
+const WORD = {
+    create: 'положен',
+    update: 'переложен',
+    drift: 'правлен руками',
+    foreign: 'положен не пакетом',
+    ok: 'без изменений',
+};
+const NO_CONFIG = `нет \`${CONFIG_PATH}\` — начни с \`agent-kit init\``;
+const holes = (result) => [...result.missing].map(([asset, names]) => `  ${asset}: нет значений для ${names.map((name) => `{{${name}}}`).join(', ')}`);
+const describe = (result) => [
+    ...holes(result),
+    ...pendingOf(result).map((entry) => `  ${entry.path} — ${WORD[entry.outcome]}`),
+];
+export function init(root) {
+    const path = join(root, CONFIG_PATH);
+    if (existsSync(path)) {
+        return { code: 0, lines: [`${CONFIG_PATH} уже есть — оставлен как есть`] };
+    }
+    const config = { vars: {}, layout: DEFAULT_LAYOUT, skip: [] };
+    mkdirSync(join(root, OVERRIDES_DIR), { recursive: true });
+    mkdirSync(join(root, CONFIG_PATH, '..'), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(config, null, 4)}\n`, 'utf8');
+    return {
+        code: 0,
+        lines: [
+            `заведён ${CONFIG_PATH}`,
+            `заведён ${OVERRIDES_DIR}/ — надстройки проекта кладутся сюда путём ресурса`,
+            'дальше: заполни `vars` и запусти `agent-kit sync`',
+        ],
+    };
+}
+export function sync(env, check) {
+    const { root, version, assetsDir } = env;
+    const config = readConfig(root);
+    if (!config) {
+        return { code: 1, lines: [NO_CONFIG] };
+    }
+    if (check) {
+        const result = planSync(config, root, version, assetsDir);
+        const pending = pendingOf(result);
+        if (!result.missing.size && !pending.length) {
+            return { code: 0, lines: [`sync --check: разложенное сходится с пакетом v${version}`] };
+        }
+        return { code: 1, lines: [`sync --check: расхождений ${result.missing.size + pending.length}`, ...describe(result)] };
+    }
+    const result = runSync(config, root, version, assetsDir);
+    // Перечисляются только дырки: раскладка не начата, и назвать файл «положенным» значило бы
+    // сказать неправду — на диске его нет.
+    if (result.missing.size) {
+        return { code: 1, lines: ['раскладка не начата: нечего подставить в дырки', ...holes(result)] };
+    }
+    const refused = result.planned.filter((entry) => isRefusal(entry.outcome));
+    if (refused.length) {
+        return {
+            code: 1,
+            lines: [
+                'раскладка не начата: эти файлы пакет переписывать не станет',
+                ...refused.map((entry) => `  ${entry.path} — ${WORD[entry.outcome]}`),
+                'правку надо либо перенести в надстройку, либо снять — и повторить',
+            ],
+        };
+    }
+    return {
+        code: 0,
+        lines: result.written.length
+            ? [`разложено файлов: ${result.written.length}`, ...result.written.map((path) => `  ${path}`)]
+            : ['всё уже разложено'],
+    };
+}
+export function doctor(env) {
+    const { root, version, assetsDir } = env;
+    const config = readConfig(root);
+    if (!config) {
+        return { code: 1, lines: [NO_CONFIG] };
+    }
+    const result = planSync(config, root, version, assetsDir);
+    const counted = new Map();
+    for (const entry of result.planned) {
+        counted.set(entry.outcome, (counted.get(entry.outcome) ?? 0) + 1);
+    }
+    const lines = [
+        `пакет v${version}, ресурсов ${collectAssets(config, assetsDir).length}, из них пропущено ${config.skip.length}`,
+        `значений в конфиге: ${Object.keys(config.vars).length}`,
+        ...[...counted].map(([outcome, count]) => `${WORD[outcome]}: ${count}`),
+        ...describe(result),
+    ];
+    return { code: 0, lines };
+}
+//# sourceMappingURL=commands.js.map

package/lib/commands.js.map

@@ -0,0 +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 { CONFIG_PATH, DEFAULT_LAYOUT, IConfig, OVERRIDES_DIR, readConfig } 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\nconst WORD: Readonly<Record<TOutcome, string>> = {\n    create: 'положен',\n    update: 'переложен',\n    drift: 'правлен руками',\n    foreign: 'положен не пакетом',\n    ok: 'без изменений',\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} — ${WORD[entry.outcome]}`),\n];\n\nexport function init(root: 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, 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            `заведён ${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} — ${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 lines: string[] = [\n        `пакет v${version}, ресурсов ${collectAssets(config, assetsDir).length}, из них пропущено ${config.skip.length}`,\n        `значений в конфиге: ${Object.keys(config.vars).length}`,\n        ...[...counted].map(([outcome, count]: [TOutcome, number]): string => `${WORD[outcome]}: ${count}`),\n        ...describe(result),\n    ];\n\n    return { code: 0, lines };\n}\n"]}

package/lib/config.d.ts

@@ -0,0 +1,25 @@
+/** Род ресурса. Он же имя каталога в `assets/` пакета и ключ раскладки. */
+export type TKind = 'laws' | 'hooks' | 'checks' | 'agents' | 'templates';
+export declare const KINDS: readonly TKind[];
+export interface IConfig {
+    /** Значения дырок `{{имя}}`. */
+    readonly vars: Readonly<Record<string, string>>;
+    /** Куда класть каждый род ресурса, путями от корня проекта. */
+    readonly layout: Readonly<Record<TKind, string>>;
+    /** Ресурсы, от которых проект отказался, идентификаторами: `laws/money.md`. */
+    readonly skip: readonly string[];
+}
+export declare const CONFIG_PATH: string;
+export declare const OVERRIDES_DIR: string;
+/**
+ * Умолчания раскладки. Это не единственно возможные пути, но менять их без нужды не стоит:
+ * агент ищет законы в `docs/constitution`, потому что так написано в правилах, которые пакет
+ * же и везёт.
+ */
+export declare const DEFAULT_LAYOUT: Readonly<Record<TKind, string>>;
+export declare class ConfigError extends Error {
+}
+export declare function parseConfig(text: string): IConfig;
+/** Конфиг проекта; его отсутствие — не отказ, а повод сказать про `agent-kit init`. */
+export declare function readConfig(root: string): IConfig | null;
+//# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -0,0 +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,+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;AAuBzC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA+BjD;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAUvD"}

package/lib/config.js

@@ -0,0 +1,85 @@
+/**
+ * Конфиг проекта — `.claude/rt-kit.json`.
+ *
+ * Всё, что пакет не может знать сам: значения для дырок, куда класть каждый род ресурса и от
+ * чего проект отказался. Конфиг лежит в дереве проекта и коммитится: раскладка обязана
+ * повторяться на чужой машине без вопросов, иначе разложенное расходится между разработчиками.
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+export const KINDS = ['laws', 'hooks', 'checks', 'agents', 'templates'];
+export const CONFIG_PATH = '.claude/rt-kit.json';
+export const OVERRIDES_DIR = '.claude/rt-kit/overrides';
+/**
+ * Умолчания раскладки. Это не единственно возможные пути, но менять их без нужды не стоит:
+ * агент ищет законы в `docs/constitution`, потому что так написано в правилах, которые пакет
+ * же и везёт.
+ */
+export const DEFAULT_LAYOUT = {
+    laws: 'docs/constitution',
+    hooks: '.claude/hooks',
+    checks: 'tools',
+    agents: '.claude/agents',
+    templates: '.claude/rt-kit/templates',
+};
+export class ConfigError extends Error {
+}
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+function stringMap(value, where) {
+    if (value === undefined) {
+        return {};
+    }
+    if (!isRecord(value)) {
+        throw new ConfigError(`${where}: ожидается объект «имя — значение»`);
+    }
+    const result = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (typeof entry !== 'string') {
+            throw new ConfigError(`${where}.${key}: ожидается строка`);
+        }
+        result[key] = entry;
+    }
+    return result;
+}
+export function parseConfig(text) {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (error) {
+        throw new ConfigError(`${CONFIG_PATH} — не разбирается как JSON: ${error.message}`);
+    }
+    if (!isRecord(raw)) {
+        throw new ConfigError(`${CONFIG_PATH}: ожидается объект`);
+    }
+    const layout = { ...DEFAULT_LAYOUT, ...stringMap(raw['layout'], 'layout') };
+    for (const kind of Object.keys(layout)) {
+        if (!KINDS.includes(kind)) {
+            throw new ConfigError(`layout.${kind}: такого рода ресурсов нет — есть ${KINDS.join(', ')}`);
+        }
+    }
+    const skip = raw['skip'] ?? [];
+    if (!Array.isArray(skip) || skip.some((entry) => typeof entry !== 'string')) {
+        throw new ConfigError('skip: ожидается список идентификаторов ресурсов');
+    }
+    // Пути раскладки — тоже значения проекта, и пакет их уже знает. Требовать их вторым списком
+    // значило бы держать одно и то же в двух местах: расходятся такие пары молча.
+    const derived = {};
+    for (const kind of KINDS) {
+        derived[`${kind.replace(/s$/, '')}sDir`] = layout[kind];
+    }
+    return { vars: { ...derived, ...stringMap(raw['vars'], 'vars') }, layout: layout, skip: skip };
+}
+/** Конфиг проекта; его отсутствие — не отказ, а повод сказать про `agent-kit init`. */
+export function readConfig(root) {
+    try {
+        return parseConfig(readFileSync(join(root, CONFIG_PATH), 'utf8'));
+    }
+    catch (error) {
+        if (error instanceof ConfigError) {
+            throw error;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=config.js.map