@rt-tools/agent-kit 0.1.0 → 0.2.0

package/lib/commands.js

@@ -1,33 +1,61 @@
 /**
- * Три команды и их вывод. Печать отделена от работы: команда возвращает строки и код возврата,
+ * Команды и их вывод. Печать отделена от работы: команда возвращает строки и код возврата,
  * а `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 { isChosen, readCatalog } from './catalog.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';
-const WORD = {
+/** Что с файлом сделала раскладка. Прошедшее время здесь правда: `sync` уже записал. */
+const DONE_WORD = {
     create: 'положен',
     update: 'переложен',
     drift: 'правлен руками',
     foreign: 'положен не пакетом',
     ok: 'без изменений',
 };
+/**
+ * Что с файлом **сейчас**. Отдельно от прошедшего времени потому, что `doctor` и `list` ничего
+ * не пишут: сказать «положен» о файле, которого в дереве нет, значит соврать читателю ровно там,
+ * где он пришёл узнать состояние.
+ */
+const STATE_WORD = {
+    create: 'нет в дереве',
+    update: 'отстал от пакета',
+    drift: 'правлен руками',
+    foreign: 'положен не пакетом',
+    ok: 'на месте',
+};
+const NOT_CHOSEN = 'не выбран';
+const SKIPPED = 'пропущен';
+const KIND_TITLE = {
+    laws: 'ЗАКОНЫ',
+    hooks: 'ХУКИ',
+    checks: 'ПРОВЕРКИ',
+    agents: 'АГЕНТЫ',
+    templates: 'ШАБЛОНЫ',
+};
 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]}`),
+    ...pendingOf(result).map((entry) => `  ${entry.path} — ${STATE_WORD[entry.outcome]}`),
 ];
-export function init(root) {
+/**
+ * Что проект выбрал при заведении конфига. Пустой список — весь набор; выбор приходит сюда
+ * готовым, потому что взять его негде, кроме края: у строки запуска флаг, у терминала вопрос,
+ * а у неинтерактивного прогона нет ни того ни другого — и решать это команде не по чину.
+ */
+export function init(root, only = []) {
     const path = join(root, CONFIG_PATH);
     if (existsSync(path)) {
         return { code: 0, lines: [`${CONFIG_PATH} уже есть — оставлен как есть`] };
     }
-    const config = { vars: {}, layout: DEFAULT_LAYOUT, skip: [] };
+    const config = { vars: {}, layout: DEFAULT_LAYOUT, only, skip: [] };
     mkdirSync(join(root, OVERRIDES_DIR), { recursive: true });
     mkdirSync(join(root, CONFIG_PATH, '..'), { recursive: true });
     writeFileSync(path, `${JSON.stringify(config, null, 4)}\n`, 'utf8');
@@ -35,6 +63,7 @@ export function init(root) {
         code: 0,
         lines: [
             `заведён ${CONFIG_PATH}`,
+            only.length ? `выбрано ресурсов: ${only.length}` : 'выбрано всё, что везёт пакет',
             `заведён ${OVERRIDES_DIR}/ — надстройки проекта кладутся сюда путём ресурса`,
             'дальше: заполни `vars` и запусти `agent-kit sync`',
         ],
@@ -66,7 +95,7 @@ export function sync(env, check) {
             code: 1,
             lines: [
                 'раскладка не начата: эти файлы пакет переписывать не станет',
-                ...refused.map((entry) => `  ${entry.path} — ${WORD[entry.outcome]}`),
+                ...refused.map((entry) => `  ${entry.path} — ${DONE_WORD[entry.outcome]}`),
                 'правку надо либо перенести в надстройку, либо снять — и повторить',
             ],
         };
@@ -89,12 +118,59 @@ export function doctor(env) {
     for (const entry of result.planned) {
         counted.set(entry.outcome, (counted.get(entry.outcome) ?? 0) + 1);
     }
+    const catalog = readCatalog(assetsDir);
+    const taken = collectAssets(config, assetsDir).length;
     const lines = [
-        `пакет v${version}, ресурсов ${collectAssets(config, assetsDir).length}, из них пропущено ${config.skip.length}`,
+        `пакет v${version}, везёт ресурсов ${catalog.length}, взято ${taken}`,
+        `не выбрано: ${catalog.length - taken - config.skip.length}, пропущено: ${config.skip.length}`,
         `значений в конфиге: ${Object.keys(config.vars).length}`,
-        ...[...counted].map(([outcome, count]) => `${WORD[outcome]}: ${count}`),
+        ...[...counted].map(([outcome, count]) => `${STATE_WORD[outcome]}: ${count}`),
         ...describe(result),
     ];
     return { code: 0, lines };
 }
+/**
+ * Что пакет везёт и что из этого взято здесь.
+ *
+ * Работает и без конфига: посмотреть, из чего выбирать, нужно раньше, чем выбор сделан, — иначе
+ * имена законов взять неоткуда, кроме исходников пакета.
+ */
+export function list(env) {
+    const { root, version, assetsDir } = env;
+    const config = readConfig(root);
+    const catalog = readCatalog(assetsDir);
+    const planned = new Map();
+    if (config) {
+        for (const entry of planSync(config, root, version, assetsDir).planned) {
+            planned.set(entry.asset, entry.outcome);
+        }
+    }
+    const stateOf = (entry) => {
+        if (!config) {
+            return 'везёт пакет';
+        }
+        if (config.skip.includes(entry.id)) {
+            return SKIPPED;
+        }
+        if (!isChosen(entry, config.only, config.skip)) {
+            return NOT_CHOSEN;
+        }
+        const outcome = planned.get(entry.id);
+        // Ресурса нет среди запланированных ровно в одном случае: в нём осталась дырка без
+        // значения, и до решения о судьбе файла раскладка не дошла.
+        return outcome ? STATE_WORD[outcome] : 'дырка без значения';
+    };
+    const name = catalog.reduce((found, entry) => Math.max(found, entry.name.length), 0);
+    const state = catalog.reduce((found, entry) => Math.max(found, stateOf(entry).length), 0);
+    const lines = [config ? `пакет v${version}` : `пакет v${version}, ${CONFIG_PATH} ещё не заведён`];
+    for (const kind of KINDS) {
+        const entries = catalog.filter((entry) => entry.kind === kind);
+        if (!entries.length) {
+            continue;
+        }
+        lines.push('', KIND_TITLE[kind]);
+        lines.push(...entries.map((entry) => `  ${entry.name.padEnd(name)}  ${stateOf(entry).padEnd(state)}  ${entry.title}`));
+    }
+    return { code: 0, lines };
+}
 //# sourceMappingURL=commands.js.map

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 { 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"]}
+{"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"]}

package/lib/config.d.ts

@@ -6,6 +6,11 @@ export interface IConfig {
     readonly vars: Readonly<Record<string, string>>;
     /** Куда класть каждый род ресурса, путями от корня проекта. */
     readonly layout: Readonly<Record<TKind, string>>;
+    /**
+     * Ресурсы, которые проект выбрал, идентификаторами: `laws/access.md`. Пусто — берётся всё.
+     * Ограничивает только те роды, которые сам называет; как именно — `isChosen`.
+     */
+    readonly only: readonly string[];
     /** Ресурсы, от которых проект отказался, идентификаторами: `laws/money.md`. */
     readonly skip: readonly string[];
 }

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,+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"}
+{"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"}

package/lib/config.js

@@ -41,6 +41,13 @@ function stringMap(value, where) {
     }
     return result;
 }
+function idList(value, where) {
+    const list = value ?? [];
+    if (!Array.isArray(list) || list.some((entry) => typeof entry !== 'string')) {
+        throw new ConfigError(`${where}: ожидается список идентификаторов ресурсов`);
+    }
+    return list;
+}
 export function parseConfig(text) {
     let raw;
     try {
@@ -58,17 +65,15 @@ export function parseConfig(text) {
             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 only = idList(raw['only'], 'only');
+    const skip = idList(raw['skip'], '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 };
+    return { vars: { ...derived, ...stringMap(raw['vars'], 'vars') }, layout: layout, only, skip };
 }
 /** Конфиг проекта; его отсутствие — не отказ, а повод сказать про `agent-kit init`. */
 export function readConfig(root) {

package/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/config.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Конфиг проекта — `.claude/rt-kit.json`.\n *\n * Всё, что пакет не может знать сам: значения для дырок, куда класть каждый род ресурса и от\n * чего проект отказался. Конфиг лежит в дереве проекта и коммитится: раскладка обязана\n * повторяться на чужой машине без вопросов, иначе разложенное расходится между разработчиками.\n */\nimport { readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\n/** Род ресурса. Он же имя каталога в `assets/` пакета и ключ раскладки. */\nexport type TKind = 'laws' | 'hooks' | 'checks' | 'agents' | 'templates';\n\nexport const KINDS: readonly TKind[] = ['laws', 'hooks', 'checks', 'agents', 'templates'];\n\nexport interface IConfig {\n    /** Значения дырок `{{имя}}`. */\n    readonly vars: Readonly<Record<string, string>>;\n    /** Куда класть каждый род ресурса, путями от корня проекта. */\n    readonly layout: Readonly<Record<TKind, string>>;\n    /** Ресурсы, от которых проект отказался, идентификаторами: `laws/money.md`. */\n    readonly skip: readonly string[];\n}\n\nexport const CONFIG_PATH: string = '.claude/rt-kit.json';\nexport const OVERRIDES_DIR: string = '.claude/rt-kit/overrides';\n\n/**\n * Умолчания раскладки. Это не единственно возможные пути, но менять их без нужды не стоит:\n * агент ищет законы в `docs/constitution`, потому что так написано в правилах, которые пакет\n * же и везёт.\n */\nexport const DEFAULT_LAYOUT: Readonly<Record<TKind, string>> = {\n    laws: 'docs/constitution',\n    hooks: '.claude/hooks',\n    checks: 'tools',\n    agents: '.claude/agents',\n    templates: '.claude/rt-kit/templates',\n};\n\nexport class ConfigError extends Error {}\n\nconst isRecord: (value: unknown) => value is Record<string, unknown> = (value: unknown): value is Record<string, unknown> =>\n    typeof value === 'object' && value !== null && !Array.isArray(value);\n\nfunction stringMap(value: unknown, where: string): Record<string, string> {\n    if (value === undefined) {\n        return {};\n    }\n    if (!isRecord(value)) {\n        throw new ConfigError(`${where}: ожидается объект «имя — значение»`);\n    }\n    const result: Record<string, string> = {};\n    for (const [key, entry] of Object.entries(value)) {\n        if (typeof entry !== 'string') {\n            throw new ConfigError(`${where}.${key}: ожидается строка`);\n        }\n        result[key] = entry;\n    }\n\n    return result;\n}\n\nexport function parseConfig(text: string): IConfig {\n    let raw: unknown;\n    try {\n        raw = JSON.parse(text);\n    } catch (error: unknown) {\n        throw new ConfigError(`${CONFIG_PATH} — не разбирается как JSON: ${(error as Error).message}`);\n    }\n    if (!isRecord(raw)) {\n        throw new ConfigError(`${CONFIG_PATH}: ожидается объект`);\n    }\n\n    const layout: Record<string, string> = { ...DEFAULT_LAYOUT, ...stringMap(raw['layout'], 'layout') };\n    for (const kind of Object.keys(layout)) {\n        if (!KINDS.includes(kind as TKind)) {\n            throw new ConfigError(`layout.${kind}: такого рода ресурсов нет — есть ${KINDS.join(', ')}`);\n        }\n    }\n\n    const skip: unknown = raw['skip'] ?? [];\n    if (!Array.isArray(skip) || skip.some((entry: unknown): boolean => typeof entry !== 'string')) {\n        throw new ConfigError('skip: ожидается список идентификаторов ресурсов');\n    }\n\n    // Пути раскладки — тоже значения проекта, и пакет их уже знает. Требовать их вторым списком\n    // значило бы держать одно и то же в двух местах: расходятся такие пары молча.\n    const derived: Record<string, string> = {};\n    for (const kind of KINDS) {\n        derived[`${kind.replace(/s$/, '')}sDir`] = layout[kind];\n    }\n\n    return { vars: { ...derived, ...stringMap(raw['vars'], 'vars') }, layout: layout as Record<TKind, string>, skip: skip as string[] };\n}\n\n/** Конфиг проекта; его отсутствие — не отказ, а повод сказать про `agent-kit init`. */\nexport function readConfig(root: string): IConfig | null {\n    try {\n        return parseConfig(readFileSync(join(root, CONFIG_PATH), 'utf8'));\n    } catch (error: unknown) {\n        if (error instanceof ConfigError) {\n            throw error;\n        }\n\n        return null;\n    }\n}\n"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/config.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Конфиг проекта — `.claude/rt-kit.json`.\n *\n * Всё, что пакет не может знать сам: значения для дырок, куда класть каждый род ресурса и от\n * чего проект отказался. Конфиг лежит в дереве проекта и коммитится: раскладка обязана\n * повторяться на чужой машине без вопросов, иначе разложенное расходится между разработчиками.\n */\nimport { readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\n/** Род ресурса. Он же имя каталога в `assets/` пакета и ключ раскладки. */\nexport type TKind = 'laws' | 'hooks' | 'checks' | 'agents' | 'templates';\n\nexport const KINDS: readonly TKind[] = ['laws', 'hooks', 'checks', 'agents', 'templates'];\n\nexport interface IConfig {\n    /** Значения дырок `{{имя}}`. */\n    readonly vars: Readonly<Record<string, string>>;\n    /** Куда класть каждый род ресурса, путями от корня проекта. */\n    readonly layout: Readonly<Record<TKind, string>>;\n    /**\n     * Ресурсы, которые проект выбрал, идентификаторами: `laws/access.md`. Пусто — берётся всё.\n     * Ограничивает только те роды, которые сам называет; как именно — `isChosen`.\n     */\n    readonly only: readonly string[];\n    /** Ресурсы, от которых проект отказался, идентификаторами: `laws/money.md`. */\n    readonly skip: readonly string[];\n}\n\nexport const CONFIG_PATH: string = '.claude/rt-kit.json';\nexport const OVERRIDES_DIR: string = '.claude/rt-kit/overrides';\n\n/**\n * Умолчания раскладки. Это не единственно возможные пути, но менять их без нужды не стоит:\n * агент ищет законы в `docs/constitution`, потому что так написано в правилах, которые пакет\n * же и везёт.\n */\nexport const DEFAULT_LAYOUT: Readonly<Record<TKind, string>> = {\n    laws: 'docs/constitution',\n    hooks: '.claude/hooks',\n    checks: 'tools',\n    agents: '.claude/agents',\n    templates: '.claude/rt-kit/templates',\n};\n\nexport class ConfigError extends Error {}\n\nconst isRecord: (value: unknown) => value is Record<string, unknown> = (value: unknown): value is Record<string, unknown> =>\n    typeof value === 'object' && value !== null && !Array.isArray(value);\n\nfunction stringMap(value: unknown, where: string): Record<string, string> {\n    if (value === undefined) {\n        return {};\n    }\n    if (!isRecord(value)) {\n        throw new ConfigError(`${where}: ожидается объект «имя — значение»`);\n    }\n    const result: Record<string, string> = {};\n    for (const [key, entry] of Object.entries(value)) {\n        if (typeof entry !== 'string') {\n            throw new ConfigError(`${where}.${key}: ожидается строка`);\n        }\n        result[key] = entry;\n    }\n\n    return result;\n}\n\nfunction idList(value: unknown, where: string): readonly string[] {\n    const list: unknown = value ?? [];\n    if (!Array.isArray(list) || list.some((entry: unknown): boolean => typeof entry !== 'string')) {\n        throw new ConfigError(`${where}: ожидается список идентификаторов ресурсов`);\n    }\n\n    return list as string[];\n}\n\nexport function parseConfig(text: string): IConfig {\n    let raw: unknown;\n    try {\n        raw = JSON.parse(text);\n    } catch (error: unknown) {\n        throw new ConfigError(`${CONFIG_PATH} — не разбирается как JSON: ${(error as Error).message}`);\n    }\n    if (!isRecord(raw)) {\n        throw new ConfigError(`${CONFIG_PATH}: ожидается объект`);\n    }\n\n    const layout: Record<string, string> = { ...DEFAULT_LAYOUT, ...stringMap(raw['layout'], 'layout') };\n    for (const kind of Object.keys(layout)) {\n        if (!KINDS.includes(kind as TKind)) {\n            throw new ConfigError(`layout.${kind}: такого рода ресурсов нет — есть ${KINDS.join(', ')}`);\n        }\n    }\n\n    const only: readonly string[] = idList(raw['only'], 'only');\n    const skip: readonly string[] = idList(raw['skip'], 'skip');\n\n    // Пути раскладки — тоже значения проекта, и пакет их уже знает. Требовать их вторым списком\n    // значило бы держать одно и то же в двух местах: расходятся такие пары молча.\n    const derived: Record<string, string> = {};\n    for (const kind of KINDS) {\n        derived[`${kind.replace(/s$/, '')}sDir`] = layout[kind];\n    }\n\n    return { vars: { ...derived, ...stringMap(raw['vars'], 'vars') }, layout: layout as Record<TKind, string>, only, skip };\n}\n\n/** Конфиг проекта; его отсутствие — не отказ, а повод сказать про `agent-kit init`. */\nexport function readConfig(root: string): IConfig | null {\n    try {\n        return parseConfig(readFileSync(join(root, CONFIG_PATH), 'utf8'));\n    } catch (error: unknown) {\n        if (error instanceof ConfigError) {\n            throw error;\n        }\n\n        return null;\n    }\n}\n"]}

package/lib/picker.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Выбиралка галочками — её состояние и разметка, без единого касания терминала.
+ *
+ * Отделено от ввода-вывода по той же причине, что и команды: нажатие клавиши — это переход
+ * состояния, и проверять его надо спекой, а не глазами на живом терминале. Сырой режим,
+ * перерисовка и восстановление курсора живут на краю, в `bin/prompt.ts`, и не решают ничего.
+ */
+export interface IChoice {
+    readonly id: string;
+    /** Имя, которым ресурс называют в строке запуска: `access`. */
+    readonly name: string;
+    /** Заголовок ресурса — им человек и выбирает, имена ему ни о чём не говорят. */
+    readonly title: string;
+}
+export interface IPickerState {
+    readonly choices: readonly IChoice[];
+    readonly cursor: number;
+    readonly chosen: ReadonlySet<string>;
+    /** Выбор окончен, `chosen` — ответ. */
+    readonly done: boolean;
+    /** Выбор брошен: ответа нет, и подставлять вместо него умолчание нельзя. */
+    readonly cancelled: boolean;
+}
+/** Первым предложением взято всё: отказ от закона — решение, и принимать его должен человек. */
+export declare function pickerOf(choices: readonly IChoice[]): IPickerState;
+export declare const KEY_UP: string;
+export declare const KEY_DOWN: string;
+export declare const KEY_ESCAPE: string;
+export declare const KEY_CANCEL: string;
+/**
+ * Кусок сырого потока, разобранный на клавиши.
+ *
+ * Терминал не обещает по куску на нажатие: набранное быстро, вставленное из буфера и всё, что
+ * пришло по конвейеру, приезжает одной строкой. Неразобранный кусок читался бы как одна
+ * незнакомая клавиша, и выбиралка молча не отзывалась бы ни на что — так она и повисла на
+ * первом прогоне через конвейер.
+ *
+ * Escape-последовательность берётся целиком: `ESC [ A` — это стрелка, а не escape и две буквы.
+ */
+export declare function keysOf(chunk: string): readonly string[];
+/** Переход состояния по одной нажатой клавише. Незнакомая клавиша не делает ничего. */
+export declare function pressKey(state: IPickerState, key: string): IPickerState;
+/** Кусок потока целиком: разобрать на клавиши и провести состояние через каждую. */
+export declare const pressChunk: (state: IPickerState, chunk: string) => IPickerState;
+/** Разметка выбиралки строками. Курсор — стрелкой, выбранное — крестиком в скобках. */
+export declare function renderPicker(state: IPickerState, question: string): readonly string[];
+//# sourceMappingURL=picker.d.ts.map

package/lib/picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/picker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,OAAO;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC/B;AAED,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,YAAY,CAElE;AAUD,eAAO,MAAM,MAAM,EAAE,MAAsB,CAAC;AAC5C,eAAO,MAAM,QAAQ,EAAE,MAAsB,CAAC;AAC9C,eAAO,MAAM,UAAU,EAAE,MAAe,CAAC;AACzC,eAAO,MAAM,UAAU,EAAE,MAA+B,CAAC;AAiCzD;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAcvD;AAED,uFAAuF;AACvF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAwBvE;AAED,oFAAoF;AACpF,eAAO,MAAM,UAAU,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,KAAK,YACxB,CAAC;AAK1C,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAarF"}

package/lib/picker.js

@@ -0,0 +1,112 @@
+/**
+ * Выбиралка галочками — её состояние и разметка, без единого касания терминала.
+ *
+ * Отделено от ввода-вывода по той же причине, что и команды: нажатие клавиши — это переход
+ * состояния, и проверять его надо спекой, а не глазами на живом терминале. Сырой режим,
+ * перерисовка и восстановление курсора живут на краю, в `bin/prompt.ts`, и не решают ничего.
+ */
+/** Первым предложением взято всё: отказ от закона — решение, и принимать его должен человек. */
+export function pickerOf(choices) {
+    return { choices, cursor: 0, chosen: new Set(choices.map((choice) => choice.id)), done: false, cancelled: false };
+}
+/**
+ * Клавиши сырого потока. Записаны кодами, а не знаками: управляющий знак посреди исходника
+ * невидим, и правка рядом с ним ломает разбор молча.
+ *
+ * Стрелка приходит целиком, тремя знаками, — сравнивать надо всю последовательность.
+ */
+const ESCAPE = String.fromCharCode(27);
+export const KEY_UP = `${ESCAPE}[A`;
+export const KEY_DOWN = `${ESCAPE}[B`;
+export const KEY_ESCAPE = ESCAPE;
+export const KEY_CANCEL = String.fromCharCode(3);
+const UP = [KEY_UP, 'k'];
+const DOWN = [KEY_DOWN, 'j'];
+const DONE = ['\r', '\n'];
+/** Ctrl-C и escape. Оба — «я передумал», и оба обязаны уйти без записи. */
+const CANCEL = [KEY_CANCEL, KEY_ESCAPE];
+function moved(state, step) {
+    const count = state.choices.length;
+    return count ? { ...state, cursor: (state.cursor + step + count) % count } : state;
+}
+function toggled(state) {
+    const choice = state.choices[state.cursor];
+    if (!choice) {
+        return state;
+    }
+    const chosen = new Set(state.chosen);
+    if (!chosen.delete(choice.id)) {
+        chosen.add(choice.id);
+    }
+    return { ...state, chosen };
+}
+function switched(state) {
+    const all = state.chosen.size === state.choices.length;
+    return { ...state, chosen: all ? new Set() : new Set(state.choices.map((choice) => choice.id)) };
+}
+/**
+ * Кусок сырого потока, разобранный на клавиши.
+ *
+ * Терминал не обещает по куску на нажатие: набранное быстро, вставленное из буфера и всё, что
+ * пришло по конвейеру, приезжает одной строкой. Неразобранный кусок читался бы как одна
+ * незнакомая клавиша, и выбиралка молча не отзывалась бы ни на что — так она и повисла на
+ * первом прогоне через конвейер.
+ *
+ * Escape-последовательность берётся целиком: `ESC [ A` — это стрелка, а не escape и две буквы.
+ */
+export function keysOf(chunk) {
+    const points = Array.from(chunk);
+    const keys = [];
+    for (let index = 0; index < points.length; index++) {
+        if (points[index] === ESCAPE && points[index + 1] === '[' && points[index + 2] !== undefined) {
+            keys.push(points.slice(index, index + 3).join(''));
+            index += 2;
+        }
+        else {
+            keys.push(points[index]);
+        }
+    }
+    return keys;
+}
+/** Переход состояния по одной нажатой клавише. Незнакомая клавиша не делает ничего. */
+export function pressKey(state, key) {
+    if (state.done || state.cancelled) {
+        return state;
+    }
+    if (UP.includes(key)) {
+        return moved(state, -1);
+    }
+    if (DOWN.includes(key)) {
+        return moved(state, 1);
+    }
+    if (CANCEL.includes(key)) {
+        return { ...state, cancelled: true };
+    }
+    if (DONE.includes(key)) {
+        return { ...state, done: true };
+    }
+    if (key === ' ') {
+        return toggled(state);
+    }
+    if (key === 'a') {
+        return switched(state);
+    }
+    return state;
+}
+/** Кусок потока целиком: разобрать на клавиши и провести состояние через каждую. */
+export const pressChunk = (state, chunk) => keysOf(chunk).reduce(pressKey, state);
+const widest = (choices) => choices.reduce((width, choice) => Math.max(width, choice.name.length), 0);
+/** Разметка выбиралки строками. Курсор — стрелкой, выбранное — крестиком в скобках. */
+export function renderPicker(state, question) {
+    const width = widest(state.choices);
+    return [
+        question,
+        '  ↑↓ — двигаться, пробел — выбрать, a — все или ни одного, enter — готово',
+        '',
+        ...state.choices.map((choice, index) => {
+            const mark = state.chosen.has(choice.id) ? 'x' : ' ';
+            return `${index === state.cursor ? '❯' : ' '} [${mark}] ${choice.name.padEnd(width)}  ${choice.title}`;
+        }),
+    ];
+}
+//# sourceMappingURL=picker.js.map

package/lib/picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/picker.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Выбиралка галочками — её состояние и разметка, без единого касания терминала.\n *\n * Отделено от ввода-вывода по той же причине, что и команды: нажатие клавиши — это переход\n * состояния, и проверять его надо спекой, а не глазами на живом терминале. Сырой режим,\n * перерисовка и восстановление курсора живут на краю, в `bin/prompt.ts`, и не решают ничего.\n */\n\nexport interface IChoice {\n    readonly id: string;\n    /** Имя, которым ресурс называют в строке запуска: `access`. */\n    readonly name: string;\n    /** Заголовок ресурса — им человек и выбирает, имена ему ни о чём не говорят. */\n    readonly title: string;\n}\n\nexport interface IPickerState {\n    readonly choices: readonly IChoice[];\n    readonly cursor: number;\n    readonly chosen: ReadonlySet<string>;\n    /** Выбор окончен, `chosen` — ответ. */\n    readonly done: boolean;\n    /** Выбор брошен: ответа нет, и подставлять вместо него умолчание нельзя. */\n    readonly cancelled: boolean;\n}\n\n/** Первым предложением взято всё: отказ от закона — решение, и принимать его должен человек. */\nexport function pickerOf(choices: readonly IChoice[]): IPickerState {\n    return { choices, cursor: 0, chosen: new Set(choices.map((choice: IChoice): string => choice.id)), done: false, cancelled: false };\n}\n\n/**\n * Клавиши сырого потока. Записаны кодами, а не знаками: управляющий знак посреди исходника\n * невидим, и правка рядом с ним ломает разбор молча.\n *\n * Стрелка приходит целиком, тремя знаками, — сравнивать надо всю последовательность.\n */\nconst ESCAPE: string = String.fromCharCode(27);\n\nexport const KEY_UP: string = `${ESCAPE}[A`;\nexport const KEY_DOWN: string = `${ESCAPE}[B`;\nexport const KEY_ESCAPE: string = ESCAPE;\nexport const KEY_CANCEL: string = String.fromCharCode(3);\n\nconst UP: readonly string[] = [KEY_UP, 'k'];\nconst DOWN: readonly string[] = [KEY_DOWN, 'j'];\nconst DONE: readonly string[] = ['\\r', '\\n'];\n/** Ctrl-C и escape. Оба — «я передумал», и оба обязаны уйти без записи. */\nconst CANCEL: readonly string[] = [KEY_CANCEL, KEY_ESCAPE];\n\nfunction moved(state: IPickerState, step: number): IPickerState {\n    const count: number = state.choices.length;\n\n    return count ? { ...state, cursor: (state.cursor + step + count) % count } : state;\n}\n\nfunction toggled(state: IPickerState): IPickerState {\n    const choice: IChoice | undefined = state.choices[state.cursor];\n    if (!choice) {\n        return state;\n    }\n    const chosen: Set<string> = new Set(state.chosen);\n    if (!chosen.delete(choice.id)) {\n        chosen.add(choice.id);\n    }\n\n    return { ...state, chosen };\n}\n\nfunction switched(state: IPickerState): IPickerState {\n    const all: boolean = state.chosen.size === state.choices.length;\n\n    return { ...state, chosen: all ? new Set() : new Set(state.choices.map((choice: IChoice): string => choice.id)) };\n}\n\n/**\n * Кусок сырого потока, разобранный на клавиши.\n *\n * Терминал не обещает по куску на нажатие: набранное быстро, вставленное из буфера и всё, что\n * пришло по конвейеру, приезжает одной строкой. Неразобранный кусок читался бы как одна\n * незнакомая клавиша, и выбиралка молча не отзывалась бы ни на что — так она и повисла на\n * первом прогоне через конвейер.\n *\n * Escape-последовательность берётся целиком: `ESC [ A` — это стрелка, а не escape и две буквы.\n */\nexport function keysOf(chunk: string): readonly string[] {\n    const points: readonly string[] = Array.from(chunk);\n    const keys: string[] = [];\n\n    for (let index: number = 0; index < points.length; index++) {\n        if (points[index] === ESCAPE && points[index + 1] === '[' && points[index + 2] !== undefined) {\n            keys.push(points.slice(index, index + 3).join(''));\n            index += 2;\n        } else {\n            keys.push(points[index]);\n        }\n    }\n\n    return keys;\n}\n\n/** Переход состояния по одной нажатой клавише. Незнакомая клавиша не делает ничего. */\nexport function pressKey(state: IPickerState, key: string): IPickerState {\n    if (state.done || state.cancelled) {\n        return state;\n    }\n    if (UP.includes(key)) {\n        return moved(state, -1);\n    }\n    if (DOWN.includes(key)) {\n        return moved(state, 1);\n    }\n    if (CANCEL.includes(key)) {\n        return { ...state, cancelled: true };\n    }\n    if (DONE.includes(key)) {\n        return { ...state, done: true };\n    }\n    if (key === ' ') {\n        return toggled(state);\n    }\n    if (key === 'a') {\n        return switched(state);\n    }\n\n    return state;\n}\n\n/** Кусок потока целиком: разобрать на клавиши и провести состояние через каждую. */\nexport const pressChunk: (state: IPickerState, chunk: string) => IPickerState = (state: IPickerState, chunk: string): IPickerState =>\n    keysOf(chunk).reduce(pressKey, state);\n\nconst widest: (choices: readonly IChoice[]) => number = (choices: readonly IChoice[]): number =>\n    choices.reduce((width: number, choice: IChoice): number => Math.max(width, choice.name.length), 0);\n\n/** Разметка выбиралки строками. Курсор — стрелкой, выбранное — крестиком в скобках. */\nexport function renderPicker(state: IPickerState, question: string): readonly string[] {\n    const width: number = widest(state.choices);\n\n    return [\n        question,\n        '  ↑↓ — двигаться, пробел — выбрать, a — все или ни одного, enter — готово',\n        '',\n        ...state.choices.map((choice: IChoice, index: number): string => {\n            const mark: string = state.chosen.has(choice.id) ? 'x' : ' ';\n\n            return `${index === state.cursor ? '❯' : ' '} [${mark}] ${choice.name.padEnd(width)}  ${choice.title}`;\n        }),\n    ];\n}\n"]}

package/package.json

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