@fractalizer/mcp-cli 0.3.18 → 1.0.1

package/dist/commands/connect.command.js

@@ -5,32 +5,35 @@
 import { InteractivePrompter } from '../utils/interactive-prompter.js';
 import { Logger } from '../utils/logger.js';
 /**
- * Команда для подключения MCP сервера к выбранному клиенту
+ * Команда подключения MCP сервера к выбранному клиенту.
  *
- * @param options - Опции команды
+ * Поток:
+ *  1. Найти установленные клиенты (`registry.findInstalled`).
+ *  2. Выбрать клиент (через CLI флаг `--client` или интерактивно).
+ *  3. Загрузить сохранённую доменную конфигурацию (`configManager.load`).
+ *  4. Собрать новую доменную конфигурацию через промпты.
+ *  5. Адаптер `buildServerLaunch(config)` → {@link ServerLaunchSpec}.
+ *  6. `connector.validateLaunchSpec(spec)`; при ошибках — abort (без `connect`/`save`).
+ *  7. `connector.connect(spec)`. При исключении управление прерывается, `save` не достигается.
+ *  8. Информационный `getStatus()`.
+ *  9. После успешного connect — `configManager.save(domainConfig)` и warning про plaintext-токен.
  *
  * @example
  * ```typescript
- * const registry = new ConnectorRegistry<YourConfig>();
- * const configManager = new ConfigManager<YourConfig>({
- *   projectName: 'your-server',
- *   safeFields: ['orgId', 'apiBase'],
- * });
- *
- * const configPrompts = [
- *   { name: 'token', type: 'password', message: 'OAuth токен:' },
- *   { name: 'orgId', type: 'input', message: 'ID организации:' },
- * ];
- *
  * await connectCommand({
  *   registry,
  *   configManager,
  *   configPrompts,
+ *   buildServerLaunch: (cfg) => ({
+ *     command: 'node',
+ *     args: ['/abs/path/server.bundle.cjs'],
+ *     env: { API_TOKEN: cfg.token, ORG_ID: cfg.orgId },
+ *   }),
  * });
  * ```
  */
 export async function connectCommand(options) {
-    const { registry, configManager, configPrompts, cliOptions, buildConfig } = options;
+    const { registry, configManager, configPrompts, buildServerLaunch, cliOptions } = options;
     Logger.header('🔌 Подключение MCP сервера');
     Logger.newLine();
     // 1. Найти установленные клиенты
@@ -39,11 +42,10 @@ export async function connectCommand(options) {
     spinner.stop();
     if (installedClients.length === 0) {
         Logger.error('Не найдено установленных MCP клиентов');
-        Logger.info('Поддерживаемые клиенты: Claude Desktop, Claude Code, Codex, Gemini, Qwen');
-        Logger.info('Установите хотя бы один из них для продолжения');
+        Logger.info('Установите хотя бы один поддерживаемый MCP клиент');
         return;
     }
-    Logger.success(`Найдено ${installedClients.length} установленных клиента(ов)`);
+    Logger.success(`Найдено ${String(installedClients.length)} установленных клиента(ов)`);
     Logger.newLine();
     // 2. Выбрать клиент
     let connector;
@@ -51,6 +53,14 @@ export async function connectCommand(options) {
         connector = registry.get(cliOptions.client);
         if (!connector) {
             Logger.error(`Клиент "${cliOptions.client}" не найден`);
+            const valid = registry.getAll();
+            if (valid.length > 0) {
+                Logger.info('Доступные клиенты:');
+                for (const c of valid) {
+                    const info = c.getClientInfo();
+                    Logger.info(`  - ${info.name} (${info.displayName})`);
+                }
+            }
             return;
         }
         const isInstalled = await connector.isInstalled();
@@ -70,49 +80,65 @@ export async function connectCommand(options) {
         return;
     }
     Logger.newLine();
-    // 3. Собрать конфигурацию
+    // 3. Загрузить сохранённую доменную конфигурацию
     const savedConfig = await configManager.load();
     if (savedConfig) {
         Logger.info('Найдена сохраненная конфигурация (секретные поля будут запрошены заново)');
     }
+    // 4. Собрать доменную конфигурацию
     const prompter = new InteractivePrompter(configPrompts);
-    const serverConfig = await prompter.promptServerConfig(savedConfig);
-    // Построить полную конфигурацию
-    const config = buildConfig
-        ? buildConfig(serverConfig)
-        : {
-            projectPath: process.cwd(),
-            ...serverConfig,
-        };
+    const domainConfig = await prompter.promptServerConfig(savedConfig);
     Logger.newLine();
-    // 4. Валидация
-    const errors = await connector.validateConfig(config);
+    // 5. Построить spec через адаптер
+    const spec = buildServerLaunch(domainConfig);
+    // 6. Валидация
+    const errors = await connector.validateLaunchSpec(spec);
     if (errors.length > 0) {
-        Logger.error('Ошибки конфигурации:');
+        Logger.error('Ошибки конфигурации запуска:');
         errors.forEach((err) => Logger.error(`  - ${err}`));
         return;
     }
-    // 5. Подключение
+    // 7. Подключение (если бросит — save не выполняется)
     const connectSpinner = Logger.spinner(`Подключаю к ${connector.getClientInfo().displayName}...`);
     try {
-        await connector.connect(config);
+        await connector.connect(spec);
         connectSpinner.succeed(`MCP сервер успешно подключен к ${connector.getClientInfo().displayName}!`);
-        const status = await connector.getStatus();
-        if (status.details) {
-            Logger.info(`Конфигурация: ${status.details.configPath}`);
-        }
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         connectSpinner.fail(`Ошибка подключения: ${errorMessage}`);
         return;
     }
+    // 8. Информационный статус
+    const status = await connector.getStatus();
+    if (status.details?.configPath) {
+        Logger.info(`Конфигурация: ${status.details.configPath}`);
+    }
     Logger.newLine();
-    // 6. Предложить сохранить конфигурацию
-    const shouldSave = await InteractivePrompter.promptConfirmation('Сохранить конфигурацию для следующего раза?', true);
-    if (shouldSave) {
-        await configManager.save(config);
-        Logger.success('Конфигурация сохранена (секретные поля исключены)');
+    // 9. Безусловно сохранить доменную конфигурацию (после успешного connect).
+    //    Подключение к клиенту уже выполнено успешно; неудача save локального
+    //    кэша — не критична, но информируем пользователя, чтобы при необходимости
+    //    он мог разобраться (например, нет прав на ~/. dir).
+    try {
+        await configManager.save(domainConfig);
+        Logger.success(`Конфигурация сохранена: ${configManager.getConfigPath()}`);
+    }
+    catch (saveError) {
+        const errMsg = saveError instanceof Error ? saveError.message : String(saveError);
+        Logger.error(`Подключение выполнено, но локальный кэш конфига не сохранён: ${errMsg}`);
+        Logger.info(`Путь к локальному кэшу: ${configManager.getConfigPath()}`);
+        if (status.details?.configPath) {
+            Logger.info(`Путь к client config (подключение активно): ${status.details.configPath}`);
+        }
+    }
+    // Предупреждение о plaintext-хранении токена в конфиге клиента
+    if (status.details?.configPath) {
+        Logger.warn(`⚠️ Токен сохранён в plaintext в ${status.details.configPath}. ` +
+            'Убедитесь, что файл недоступен другим пользователям системы.');
+    }
+    else {
+        Logger.warn('⚠️ Токен сохранён в plaintext в конфиге клиента. ' +
+            'Убедитесь, что файл недоступен другим пользователям системы.');
     }
     Logger.newLine();
     Logger.success('✅ Готово! Теперь вы можете использовать MCP сервер в выбранном клиенте.');

package/dist/commands/connect.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"connect.command.js","sourceRoot":"","sources":["../../src/commands/connect.command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"connect.command.js","sourceRoot":"","sources":["../../src/commands/connect.command.ts"],"names":[],"mappings":"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"}

package/dist/commands/disconnect.command.d.ts

@@ -1,11 +1,10 @@
 import type { ConnectorRegistry } from '../connectors/registry.js';
-import type { BaseMCPServerConfig } from '../types.js';
 /**
  * Опции для команды disconnect
  */
-export interface DisconnectCommandOptions<TConfig extends BaseMCPServerConfig> {
+export interface DisconnectCommandOptions {
     /** Реестр MCP коннекторов */
-    registry: ConnectorRegistry<TConfig>;
+    registry: ConnectorRegistry;
     /** CLI опции из командной строки */
     cliOptions?: {
         /** Имя клиента для отключения (опционально, если не указан - будет интерактивный выбор) */
@@ -13,24 +12,13 @@ export interface DisconnectCommandOptions<TConfig extends BaseMCPServerConfig> {
     };
 }
 /**
- * Команда для отключения MCP сервера от клиента
- *
- * @param options - Опции команды
+ * Команда для отключения MCP сервера от клиента.
  *
  * @example
  * ```typescript
- * const registry = new ConnectorRegistry<YourConfig>();
- * // регистрация коннекторов...
- *
- * // Интерактивный выбор клиента
  * await disconnectCommand({ registry });
- *
- * // Или указать клиент явно
- * await disconnectCommand({
- *   registry,
- *   cliOptions: { client: 'claude-desktop' }
- * });
+ * await disconnectCommand({ registry, cliOptions: { client: 'claude-desktop' } });
  * ```
  */
-export declare function disconnectCommand<TConfig extends BaseMCPServerConfig>(options: DisconnectCommandOptions<TConfig>): Promise<void>;
+export declare function disconnectCommand(options: DisconnectCommandOptions): Promise<void>;
 //# sourceMappingURL=disconnect.command.d.ts.map

package/dist/commands/disconnect.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disconnect.command.d.ts","sourceRoot":"","sources":["../../src/commands/disconnect.command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIvD;;GAEG;AACH,MAAM,WAAW,wBAAwB,CAAC,OAAO,SAAS,mBAAmB;IAC3E,6BAA6B;IAC7B,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAErC,oCAAoC;IACpC,UAAU,CAAC,EAAE;QACX,2FAA2F;QAC3F,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAgED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,SAAS,mBAAmB,EACzE,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CAgCf"}
+{"version":3,"file":"disconnect.command.d.ts","sourceRoot":"","sources":["../../src/commands/disconnect.command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAInE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,6BAA6B;IAC7B,QAAQ,EAAE,iBAAiB,CAAC;IAE5B,oCAAoC;IACpC,UAAU,CAAC,EAAE;QACX,2FAA2F;QAC3F,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AA4DD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCxF"}

package/dist/commands/disconnect.command.js

@@ -6,7 +6,7 @@ import { InteractivePrompter } from '../utils/interactive-prompter.js';
 async function findConnectedConnectors(registry) {
     const statuses = await registry.checkAllStatuses();
     return Array.from(statuses.entries())
-        .filter(([_, status]) => status.connected)
+        .filter(([, status]) => status.connected)
         .map(([name]) => registry.get(name))
         .filter((c) => c !== undefined);
 }
@@ -49,23 +49,12 @@ async function performDisconnect(connector) {
     }
 }
 /**
- * Команда для отключения MCP сервера от клиента
- *
- * @param options - Опции команды
+ * Команда для отключения MCP сервера от клиента.
  *
  * @example
  * ```typescript
- * const registry = new ConnectorRegistry<YourConfig>();
- * // регистрация коннекторов...
- *
- * // Интерактивный выбор клиента
  * await disconnectCommand({ registry });
- *
- * // Или указать клиент явно
- * await disconnectCommand({
- *   registry,
- *   cliOptions: { client: 'claude-desktop' }
- * });
+ * await disconnectCommand({ registry, cliOptions: { client: 'claude-desktop' } });
  * ```
  */
 export async function disconnectCommand(options) {
@@ -80,7 +69,7 @@ export async function disconnectCommand(options) {
         Logger.newLine();
         return;
     }
-    Logger.success(`Найдено ${connectedConnectors.length} подключенных клиента(ов)`);
+    Logger.success(`Найдено ${String(connectedConnectors.length)} подключенных клиента(ов)`);
     Logger.newLine();
     const connector = await selectConnector(registry, connectedConnectors, cliOptions?.client);
     if (!connector) {

package/dist/commands/disconnect.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"disconnect.command.js","sourceRoot":"","sources":["../../src/commands/disconnect.command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"disconnect.command.js","sourceRoot":"","sources":["../../src/commands/disconnect.command.ts"],"names":[],"mappings":"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"}

package/dist/commands/doctor.command.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Команда самодиагностики MCP подключений.
+ *
+ * @packageDocumentation
+ */
+import type { DoctorCommandOptions, DoctorReport } from '../types/doctor.types.js';
+/**
+ * Запустить диагностику MCP подключений.
+ *
+ * Собирает проверки в детерминированном порядке:
+ *  1. Для каждого зарегистрированного и установленного клиента
+ *     (`registry.findInstalled()` в порядке `registry.getAll()`):
+ *     - `isInstalled` (фактически уже пройдена — отмечается как `ok`);
+ *     - `getStatus` (запрос статуса через коннектор);
+ *     - `command-exists` (проверка существования `command` из spec на диске).
+ *  2. Доменные `extraChecks` в порядке передачи.
+ *
+ * Все проверки запускаются параллельно через `Promise.allSettled`. Рендеринг
+ * результатов — после завершения всех проверок, чтобы избежать чересполосицы
+ * вывода.
+ *
+ * **Robustness:** исключение внутри `check.run()` перехватывается и трактуется
+ * как `fail` с сообщением `'Исключение при выполнении проверки: <message>'`.
+ * Одна сломанная проверка не валит весь doctor.
+ *
+ * **Важно:** функция НЕ вызывает `process.exit`. Caller обязан проверить
+ * `report.summary.fail` и при необходимости вызвать `process.exit(1)` — это
+ * сохраняет тестируемость функции и оставляет policy решение на CLI entry point.
+ *
+ * @param options - Опции: `registry` + опциональные доменные `extraChecks`.
+ * @returns Агрегированный {@link DoctorReport}.
+ */
+export declare function doctorCommand(options: DoctorCommandOptions): Promise<DoctorReport>;
+//# sourceMappingURL=doctor.command.d.ts.map

package/dist/commands/doctor.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.command.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.command.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAGV,oBAAoB,EACpB,YAAY,EACb,MAAM,0BAA0B,CAAC;AAclC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CAkDxF"}

package/dist/commands/doctor.command.js

@@ -0,0 +1,321 @@
+/**
+ * Команда самодиагностики MCP подключений.
+ *
+ * @packageDocumentation
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { resolveExecutablePath } from '../utils/launch-spec-helpers.js';
+import { Logger } from '../utils/logger.js';
+/**
+ * Internal: ключ группы для проверок без явной group (например, доменные
+ * extraChecks без поля group).
+ */
+const UNGROUPED_GROUP_KEY = '_ungrouped';
+/**
+ * Internal: метка группы для рендера проверок без group.
+ */
+const UNGROUPED_GROUP_LABEL = 'Доменные проверки';
+/**
+ * Запустить диагностику MCP подключений.
+ *
+ * Собирает проверки в детерминированном порядке:
+ *  1. Для каждого зарегистрированного и установленного клиента
+ *     (`registry.findInstalled()` в порядке `registry.getAll()`):
+ *     - `isInstalled` (фактически уже пройдена — отмечается как `ok`);
+ *     - `getStatus` (запрос статуса через коннектор);
+ *     - `command-exists` (проверка существования `command` из spec на диске).
+ *  2. Доменные `extraChecks` в порядке передачи.
+ *
+ * Все проверки запускаются параллельно через `Promise.allSettled`. Рендеринг
+ * результатов — после завершения всех проверок, чтобы избежать чересполосицы
+ * вывода.
+ *
+ * **Robustness:** исключение внутри `check.run()` перехватывается и трактуется
+ * как `fail` с сообщением `'Исключение при выполнении проверки: <message>'`.
+ * Одна сломанная проверка не валит весь doctor.
+ *
+ * **Важно:** функция НЕ вызывает `process.exit`. Caller обязан проверить
+ * `report.summary.fail` и при необходимости вызвать `process.exit(1)` — это
+ * сохраняет тестируемость функции и оставляет policy решение на CLI entry point.
+ *
+ * @param options - Опции: `registry` + опциональные доменные `extraChecks`.
+ * @returns Агрегированный {@link DoctorReport}.
+ */
+export async function doctorCommand(options) {
+    const { registry, extraChecks = [] } = options;
+    Logger.header('🩺 Диагностика MCP подключений');
+    // Per-run cache для getLaunchSpec — connector.getLaunchSpec() читает файл
+    // конфигурации (или вызывает CLI) — может быть дорогим. Внутри doctor мы
+    // вызываем его для двух проверок (interpretConnectionStatus и
+    // checkCommandExistsOnDisk), достаточно одного чтения.
+    const launchSpecCache = new Map();
+    const getCachedLaunchSpec = (connector) => {
+        let p = launchSpecCache.get(connector);
+        if (!p) {
+            p = connector.getLaunchSpec();
+            launchSpecCache.set(connector, p);
+        }
+        return p;
+    };
+    // 1. Сбор client-level проверок только для установленных клиентов.
+    // Порядок — как в registry.getAll() (стабильный).
+    const installed = await registry.findInstalled();
+    const installedNames = new Set(installed.map((c) => c.getClientInfo().name));
+    const clientChecks = [];
+    for (const connector of registry.getAll()) {
+        if (!installedNames.has(connector.getClientInfo().name))
+            continue;
+        clientChecks.push(...buildClientChecks(connector, getCachedLaunchSpec));
+    }
+    const allChecks = [...clientChecks, ...extraChecks];
+    // 2. Параллельное выполнение всех проверок через Promise.allSettled.
+    //    Исключения внутри check.run() трактуем как fail (см. JSDoc).
+    const settled = await Promise.allSettled(allChecks.map((c) => safeRun(c)));
+    // 3. Сбор результатов в детерминированном порядке.
+    const checks = allChecks.map((check, idx) => {
+        const outcome = settled[idx];
+        const result = settledToResult(outcome);
+        return { check, result };
+    });
+    const report = buildReport(checks);
+    // 4. Рендер после завершения всех проверок.
+    renderReport(report);
+    return report;
+}
+/**
+ * Собрать стандартные client-level проверки для одного коннектора.
+ */
+function buildClientChecks(connector, getCachedLaunchSpec) {
+    const group = connector.getClientInfo().displayName;
+    return [
+        buildIsInstalledCheck(connector, group),
+        buildGetStatusCheck(connector, group),
+        buildCommandExistsCheck(connector, group, getCachedLaunchSpec),
+    ];
+}
+function buildIsInstalledCheck(connector, group) {
+    return {
+        name: 'isInstalled',
+        description: 'Проверка установки клиента в системе',
+        group,
+        run: async () => {
+            // findInstalled() уже отфильтровал по этому критерию, но для полноты
+            // явно отмечаем как ok.
+            const ok = await connector.isInstalled();
+            return ok
+                ? { status: 'ok', message: 'Клиент установлен' }
+                : { status: 'fail', message: 'Клиент не установлен' };
+        },
+    };
+}
+function buildGetStatusCheck(connector, group) {
+    return {
+        name: 'getStatus',
+        description: 'Запрос статуса подключения через коннектор',
+        group,
+        run: async () => {
+            const status = await connector.getStatus();
+            return interpretConnectionStatus(status);
+        },
+    };
+}
+function buildCommandExistsCheck(connector, group, getCachedLaunchSpec) {
+    return {
+        name: 'command-exists',
+        description: 'Существование исполняемого файла из конфигурации клиента',
+        group,
+        run: () => checkCommandExistsOnDisk(connector, getCachedLaunchSpec),
+    };
+}
+function interpretConnectionStatus(status) {
+    if (status.connected && !status.error) {
+        return { status: 'ok', message: 'Сервер подключен и отвечает' };
+    }
+    if (status.connected && status.error) {
+        return {
+            status: 'warn',
+            message: `Подключен, но с предупреждением: ${status.error}`,
+        };
+    }
+    if (status.error) {
+        return { status: 'fail', message: status.error };
+    }
+    return {
+        status: 'warn',
+        message: 'Сервер не подключен к этому клиенту',
+        hint: 'Запустите команду `connect`, чтобы подключить сервер.',
+    };
+}
+/**
+ * Проверка существования `command` (или скрипта при `command === 'node'`)
+ * на диске. Использует {@link resolveExecutablePath} — ту же логику, что и
+ * `BaseConnector.validateLaunchSpec`/`ConfigurableConnector.commandExistsOnDisk`.
+ *
+ * Кейсы:
+ *  - `spec === null` (сервер не подключен) → `skip`.
+ *  - Команда — `npx`/`pipx`/`uvx` или относительная — `warn`.
+ *  - Команда — абсолютный путь или `node` с абсолютным скриптом — `fs.access(R_OK)`.
+ */
+async function checkCommandExistsOnDisk(connector, getCachedLaunchSpec) {
+    const spec = await getCachedLaunchSpec(connector);
+    if (spec === null) {
+        return {
+            status: 'skip',
+            message: 'Сервер не подключен к этому клиенту',
+        };
+    }
+    const filePath = resolveExecutablePath(spec);
+    if (filePath === null) {
+        // относительная команда или `node` без скрипта в args
+        if (path.isAbsolute(spec.command)) {
+            // не должно случиться, resolveExecutablePath обрабатывает абсолютные.
+            return {
+                status: 'fail',
+                message: `Не удалось определить путь к исполняемому файлу для команды: ${spec.command}`,
+            };
+        }
+        return {
+            status: 'warn',
+            message: `Команда '${spec.command}' разрешается через PATH; не можем проверить на диске`,
+            hint: 'Работа зависит от текущего PATH клиента. Рекомендуется указывать абсолютный путь.',
+        };
+    }
+    try {
+        await fs.access(filePath, fs.constants.R_OK);
+        return {
+            status: 'ok',
+            message: `Файл найден и читаем: ${filePath}`,
+        };
+    }
+    catch {
+        return {
+            status: 'fail',
+            message: `Файл не найден или недоступен: ${filePath}`,
+            hint: 'Переподключите сервер командой `connect` (путь к бандлу мог измениться при обновлении пакета).',
+        };
+    }
+}
+/**
+ * Безопасно запустить проверку, перехватывая исключения.
+ */
+async function safeRun(check) {
+    try {
+        return await check.run();
+    }
+    catch (err) {
+        return {
+            status: 'fail',
+            message: `Исключение при выполнении проверки: ${stringifyError(err)}`,
+        };
+    }
+}
+function stringifyError(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+/**
+ * Преобразование одного исхода `Promise.allSettled` в `DoctorCheckResult`.
+ * `safeRun` уже перехватывает исключения внутри проверки, поэтому ветка
+ * `rejected` — defence-in-depth (например, если safeRun сам кинет).
+ */
+function settledToResult(outcome) {
+    if (!outcome) {
+        return {
+            status: 'fail',
+            message: 'Внутренняя ошибка: отсутствует результат проверки',
+        };
+    }
+    if (outcome.status === 'fulfilled') {
+        return outcome.value;
+    }
+    return {
+        status: 'fail',
+        message: `Исключение при выполнении проверки: ${stringifyError(outcome.reason)}`,
+    };
+}
+function buildReport(checks) {
+    const summary = { ok: 0, warn: 0, fail: 0, skip: 0 };
+    for (const { result } of checks) {
+        summary[result.status] += 1;
+    }
+    return { checks, summary };
+}
+/**
+ * Отрендерить отчёт через {@link Logger}. Группирует проверки по `group`
+ * (если задано) в порядке появления группы.
+ */
+function renderReport(report) {
+    // Группировка с сохранением порядка появления group.
+    const groups = new Map();
+    for (const item of report.checks) {
+        const group = item.check.group ?? UNGROUPED_GROUP_KEY;
+        let arr = groups.get(group);
+        if (!arr) {
+            arr = [];
+            groups.set(group, arr);
+        }
+        arr.push(item);
+    }
+    for (const [group, items] of groups) {
+        if (group !== UNGROUPED_GROUP_KEY) {
+            Logger.info(`\nГруппа: ${group}`);
+        }
+        else {
+            Logger.info(`\n${UNGROUPED_GROUP_LABEL}:`);
+        }
+        for (const { check, result } of items) {
+            renderCheck(check, result);
+        }
+    }
+    Logger.newLine();
+    const { ok, warn, fail, skip } = report.summary;
+    const summaryLine = `Сводка: ${ok} ok · ${warn} warn · ${fail} fail · ${skip} skip`;
+    if (fail > 0) {
+        Logger.error(summaryLine);
+    }
+    else if (warn > 0) {
+        Logger.warn(summaryLine);
+    }
+    else {
+        Logger.success(summaryLine);
+    }
+}
+function renderCheck(check, result) {
+    renderCheckLine(check, result);
+    renderCheckDetails(result);
+    renderCheckHint(result);
+}
+function renderCheckLine(check, result) {
+    const message = `[${check.name}] ${result.message}`;
+    switch (result.status) {
+        case 'ok':
+            Logger.success(message);
+            return;
+        case 'warn':
+            Logger.warn(message);
+            return;
+        case 'fail':
+            Logger.error(message);
+            return;
+        case 'skip':
+            Logger.info(`${message} (пропущено)`);
+            return;
+    }
+}
+function renderCheckDetails(result) {
+    if (!result.details || result.details.length === 0)
+        return;
+    for (const line of result.details) {
+        Logger.info(`  ${line}`);
+    }
+}
+function renderCheckHint(result) {
+    if (!result.hint)
+        return;
+    if (result.status !== 'warn' && result.status !== 'fail')
+        return;
+    Logger.info(`  Подсказка: ${result.hint}`);
+}
+//# sourceMappingURL=doctor.command.js.map