micro-models-agent 2.16.0 → 2.17.1

package/dist/core/bootstrap/session-phase.js

@@ -1,204 +0,0 @@
-/**
- * Фаза 4 bootstrap: сессии, context-лог, менеджер контекста и ToolContext.
- *
- * Порядок 1:1 с исходником: SessionStore/SessionManager (+ привязка ленивого
- * session id фазы провайдера, autoSave) → запись context-probe в сессию фоном
- * → ContextLogger (opt-in) → TokenCounter/activeToolTags/ContextManager →
- * общий бокс живого конфига → ToolContext с живыми геттерами (config,
- * sessionId, sessionContext, sessionManager, capabilities) → ToolExecutor →
- * HallucinationDetector.
- *
- * Shared mutable state вынесен вместе с фазой: `configRef` (живой бокс
- * конфига) и сам `toolCtx` возвращаются наружу следующим фазам.
- */
-import { join } from "path";
-import { ContextManager } from "../../modules/context/manager";
-import { TokenCounter } from "../../llm/token-counter";
-import { ToolExecutor } from "../../tools/executor";
-import { HallucinationDetector } from "../../modules/hallucination/detector";
-import { SessionStore, SessionManager } from "../../modules/session/index";
-import { BUILTIN_PROVIDERS } from "../../modules/providers/presets";
-import { resolveModelCapabilities } from "../../modules/providers/capabilities";
-import { ContextLogger } from "../agent/context-log";
-import { t } from "../../i18n/index";
-import { errMsg } from "../../utils";
-/**
- * Поднимает сессии, контекст и общий ToolContext.
- * @param input связный вход фазы (см. SessionPhaseInput).
- * @returns менеджер сессий, контекст, toolCtx и исполнители.
- */
-export async function setupSessionPhase(input) {
-    const { config, logger, dir, baseDir, exitOnComplete, contextLogFlag, contextProbePromise, capabilitiesRef, llmProvider, bindSessionManager, toolRegistry, pluginManager, } = input;
-    const sessionDir = join(dir, "sessions");
-    const sessionStore = new SessionStore(sessionDir, config.security?.sessionEncryption);
-    sessionStore.init();
-    // Архивируем сессии старше 30 дней (gzip истории + метка rotated). Был мёртвый
-    // код — не вызывался, старые сессии не сжимались. Отложено, чтобы синхронное
-    // сжатие старт не тормозило; сбои не фатальны.
-    setTimeout(() => {
-        try {
-            sessionStore.rotateOldSessions();
-        }
-        catch (err) {
-            logger.warn(`session rotation failed: ${String(err)}`);
-        }
-    }, 0);
-    const sessionManager = new SessionManager(sessionStore, {
-        model: config.model,
-        contextWindow: config.contextWindow,
-        projectDir: baseDir,
-        maxSessions: config.session.maxSessions,
-        isolation: config.sessionIsolation,
-    });
-    bindSessionManager(() => sessionManager);
-    if (config.session.autoSave && !sessionManager.getActive()) {
-        sessionManager.create();
-    }
-    // Context-пробу — в сессию сразу по резолву, в ОБОИХ режимах (интерактив и
-    // one-shot). Раньше писал только REPL, и one-shot терял расхождение
-    // загруженного vs настроенного контекста целиком (наблюдалось: LM Studio
-    // держит 86016 при contextWindow 32768 — молча).
-    void contextProbePromise
-        .then((probe) => {
-        if (!probe)
-            return;
-        try {
-            sessionManager.appendLog({
-                ts: new Date().toISOString(),
-                type: "context_probe",
-                content: `model=${probe.model} actual=${probe.actual} configured=${config.contextWindow}`,
-            });
-        }
-        catch {
-            // best-effort
-        }
-    })
-        .catch(() => { });
-    // Git-style лог контекста (opt-in через --context-log / конфиг / env). Рядом
-    // с файлами сессии, чтобы путешествовал с ней. Best-effort: лог не должен
-    // ломать прогон никогда.
-    const contextLogEnabled = contextLogFlag === true || config.contextLog?.enabled === true;
-    let contextLogger;
-    if (contextLogEnabled) {
-        const activeMeta = sessionManager.getActiveMeta();
-        if (activeMeta) {
-            try {
-                contextLogger = new ContextLogger({
-                    path: join(sessionStore.getSessionDir(activeMeta.id), "context.diff"),
-                    sessionId: activeMeta.id,
-                    model: config.model,
-                    contextWindow: config.contextWindow,
-                    redact: config.contextLog?.redact !== false,
-                });
-            }
-            catch (err) {
-                logger.warn(t("error.context_log_init", { error: errMsg(err) }));
-                contextLogger = undefined;
-            }
-        }
-    }
-    const tokenCounter = new TokenCounter(config.model);
-    // Мутабельный набор активных тегов тулов — общий у цикла агента и тула
-    // `enable_tools`. Цикл перечитывает его каждую итерацию для пересборки
-    // видимого модели набора; enable_tools дотолкивает теги внутрь. При выключенном
-    // on-demand набор пуст — легаси «все тулы» (getAllForLLM на пустых отдаёт всё).
-    const enableOnDemand = config.tools?.enableOnDemand !== false;
-    const activeToolTags = enableOnDemand
-        ? config.tools?.defaultTags
-            ? [...config.tools.defaultTags]
-            : []
-        : [];
-    const contextManager = new ContextManager(config.contextWindow, config.contextBudget, tokenCounter);
-    // Общий бокс ЖИВОГО конфига. `Agent.reconfigure` меняет и deps.config, и
-    // этот бокс, чтобы захватившие ссылку при bootstrap — toolCtx.config,
-    // валидаторы, правила тулов — видели ТЕКУЩИЕ настройки после /model use или
-    // визарда. Фиксация значения раз означала: тулы весь сеанс enforced
-    // до-reconfigure security/maxTool.
-    const configRef = { current: config };
-    const toolCtx = {
-        baseDir,
-        logger,
-        exitOnComplete,
-        contextManager,
-        activeToolTags,
-        recursionDepth: 0,
-        fileOperationsCount: 0,
-        sessionHistory: {
-            append: async (type, content) => {
-                const meta = sessionManager.getActiveMeta();
-                if (!meta)
-                    return;
-                sessionManager.appendMessage({
-                    role: "tool",
-                    content: typeof content === "string" ? content : JSON.stringify(content),
-                    name: type,
-                    timestamp: new Date().toISOString(),
-                });
-            },
-        },
-        sessionLog: {
-            plan: (event, detail, iteration) => {
-                sessionManager.appendLog({
-                    ts: new Date().toISOString(),
-                    type: "plan",
-                    tool: event,
-                    content: detail,
-                    ...(iteration !== undefined ? { iteration } : {}),
-                });
-            },
-        },
-    };
-    // `config` — ЖИВОЙ геттер поверх общего configRef: тулы и валидаторы видят
-    // ТЕКУЩИЕ настройки после reconfigure.
-    Object.defineProperty(toolCtx, "config", {
-        get: () => configRef.current,
-        configurable: true,
-    });
-    // `sessionId`/`sessionContext` — ЖИВЫЕ геттеры поверх менеджера сессий, а не
-    // снимок при bootstrap. Снимок пинил сессию старта, и после REPL /new или
-    // /resume записи audit.jsonl новой сессии тегировались id ПРЕДЫДУЩЕЙ
-    // (наблюдалось: записи ses_msyghz8w с id ses_msyg892p_78kqhc), а sessionHistory
-    // читал живую мету. Теперь потребители ctx.sessionId — аудит, реестр
-    // процессов, счётчики файлов — всегда видят реально активную сессию.
-    Object.defineProperty(toolCtx, "sessionId", {
-        get: () => sessionManager.getActiveMeta()?.id,
-        configurable: true,
-    });
-    Object.defineProperty(toolCtx, "sessionContext", {
-        get: () => sessionManager.getSessionContext() ?? undefined,
-        configurable: true,
-    });
-    Object.defineProperty(toolCtx, "sessionManager", {
-        get: () => sessionManager,
-        configurable: true,
-    });
-    // Возможности активной модели — LIVE: пресет провайдера + native-probe +
-    // конфиг-оверрайд пересчитываются при каждом обращении тула, поэтому
-    // инструменты (browser и т.п.) видят актуальный vision/tools после
-    // смены модели или /provider use.
-    Object.defineProperty(toolCtx, "capabilities", {
-        get: () => {
-            const cfg = configRef.current;
-            const spec = BUILTIN_PROVIDERS.find((p) => p.type === cfg.provider.type);
-            return resolveModelCapabilities(spec?.capabilities, capabilitiesRef.probe, cfg.modelCapabilities?.[cfg.model]);
-        },
-        configurable: true,
-    });
-    const toolExecutor = new ToolExecutor(toolRegistry, toolCtx, pluginManager);
-    toolCtx.llmProvider = llmProvider;
-    toolCtx.toolExecutor = toolExecutor;
-    const hallucinationDetector = new HallucinationDetector(baseDir, llmProvider, {
-        judgeEnabled: config.hallucination?.judge?.enabled ?? false,
-    });
-    return {
-        sessionManager,
-        sessionStore,
-        contextLogger,
-        contextManager,
-        configRef,
-        activeToolTags,
-        toolCtx,
-        toolExecutor,
-        hallucinationDetector,
-    };
-}

package/dist/core/bootstrap/state.js

@@ -1,94 +0,0 @@
-/**
- * Общее состояние и мелкие хелперы фаз bootstrap.
- *
- * Здесь живёт то, что нужно нескольким фазам сразу: флаг one-shot режима,
- * регистрация встроенных плагинов, таймаут-обёртка, нормализация уровня
- * лога и загрузка AGENTS.md-блоков. Своей логики фаза не несёт — только
- * разделяемые примитивы, чтобы фазы не дублировали их друг у друга.
- */
-import { estimateTokens } from "../../llm/token-counter";
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
-import { projectMmaDir } from "../../config/paths";
-/**
- * One-shot CLI-подкоманды (`session show`, `usage`, `config` …) рисуют итог и
- * выходят. Фоновый стартовый health-check спавнит дочерний процесс (LSP/tsc),
- * который `process.exit` не пожинает — на Windows сирота держит stdout-пайп, и
- * пайп команды (`mma session show <id> | cat`) виснет. Подкоманды агента не
- * гоняют, поэтому чек там пропускается.
- */
-let oneShotMode = false;
-/**
- * Включает one-shot режим (пропуск фонового health-check для подкоманд).
- * @param value true — подкоманда без агента.
- */
-export function setOneShotMode(value) {
-    oneShotMode = value;
-}
-/**
- * Проверяет one-shot режим (нужен фазе модулей для пропуска health-check).
- * @returns true — фоновый стартовый чек пропускается.
- */
-export function isOneShotMode() {
-    return oneShotMode;
-}
-/** Регистрация встроенного плагина модуля: пометка + регистрация. */
-export function registerBuiltinPlugin(pm, plugin) {
-    if (!plugin)
-        return;
-    plugin.isBuiltin = true;
-    pm.register(plugin);
-}
-/** Отклоняет `promise` через `ms`; таймер победителя снимается. */
-export function withTimeout(promise, ms) {
-    return new Promise((resolve, reject) => {
-        const timer = setTimeout(() => reject(new Error(`timeout after ${ms}ms`)), ms);
-        promise.then((v) => {
-            clearTimeout(timer);
-            resolve(v);
-        }, (e) => {
-            clearTimeout(timer);
-            reject(e);
-        });
-    });
-}
-const VALID_LOG_LEVELS = ["debug", "info", "warn", "error"];
-/** Нормализует строку из конфига в LogLevel (без `as any`); неизвестное → info. */
-export function normalizeLogLevel(value) {
-    return value && VALID_LOG_LEVELS.includes(value) ? value : "info";
-}
-/** Кандидаты AGENTS.md по приоритету: проект, проектный `.mma`, глобальный. */
-export function agentsMdPaths(baseDir, configDir) {
-    return [
-        join(baseDir, "AGENTS.md"),
-        join(projectMmaDir(baseDir), "AGENTS.md"),
-        join(configDir, "AGENTS.md"),
-    ];
-}
-/**
- * Грузит AGENTS.md из каталога проекта и конфиг-каталога (по приоритету).
- * Каждый найденный непустой файл — prompt-блок высокого приоритета.
- * @param baseDir workspace; @param dir каталог конфига; @param skip пропустить загрузку.
- * @returns блоки инструкций для системного промпта.
- */
-export function loadAgentsMdBlocks(baseDir, dir, skip) {
-    if (skip)
-        return [];
-    const blocks = [];
-    const candidates = agentsMdPaths(baseDir, dir);
-    for (const p of candidates) {
-        if (existsSync(p)) {
-            const content = readFileSync(p, "utf-8").trim();
-            if (content) {
-                blocks.push({
-                    content,
-                    priority: "high",
-                    essential: false,
-                    estimatedTokens: estimateTokens(content),
-                    kind: "instructions",
-                });
-            }
-        }
-    }
-    return blocks;
-}

package/dist/core/bootstrap/workspace-phase.js

@@ -1,115 +0,0 @@
-/**
- * Фаза 3 bootstrap: workspace, окружение, индекс проекта, скиллы и тулы.
- *
- * Порядок 1:1 с исходником: резолв baseDir (громкий фол на несуществующем
- * `-d`) → отчёт окружения → построение индекса проекта → загрузка скиллов →
- * реестр тулов → менеджер плагинов → системный systemInfo-блок.
- */
-import { join, resolve } from "path";
-import { statSync } from "fs";
-import { buildSystemInfo } from "../system-prompt";
-import { collectEnvironment, logEnvironment } from "../environment";
-import { IndexerModule } from "../../modules/indexer/index";
-import { SkillsLoader, SkillsModule } from "../../modules/skills/index";
-import { ToolRegistry, registerAllTools } from "../../tools/index";
-import { PluginManager } from "../../modules/plugins/manager";
-import { estimateTokens } from "../../llm/token-counter";
-import { t } from "../../i18n/index";
-import { homedir } from "os";
-import { projectMmaDir } from "../../config/paths";
-/**
- * Резолвит workspace агента. Несуществующий `-d` (классика: шелл режет по
- * пробелам, висячий бэкслэш экранирует кавычку) должен упасть ГРОМКО здесь —
- * иначе агент молча работает не в том каталоге и уверяет, что всё хорошо.
- */
-export function resolveBaseDir(projectDir) {
-    if (!projectDir)
-        return process.cwd();
-    const abs = resolve(projectDir);
-    let isDir = false;
-    try {
-        isDir = statSync(abs).isDirectory();
-    }
-    catch {
-        isDir = false;
-    }
-    if (!isDir) {
-        throw new Error(`workspace directory does not exist: ${abs} (received ${JSON.stringify(projectDir)} — ` +
-            `if the path contains spaces, quote it without a trailing backslash)`);
-    }
-    return abs;
-}
-/**
- * Готовит workspace, окружение, индекс, скиллы и реестр тулов.
- * @param config живой конфиг; @param logger настроенный логгер;
- * @param dir каталог конфига; @param projectDir запрошенный workspace (опционально);
- * @param profile загруженный профиль пользователя (из фазы провайдера).
- * @returns каталог, отчёт окружения, индекс, скиллы, реестр, system-блок.
- */
-export async function setupWorkspacePhase(config, logger, dir, projectDir, profile) {
-    const baseDir = resolveBaseDir(projectDir);
-    // Кросс-девайс диагностика: полный отчёт окружения (ОС, рантайм, engines,
-    // PATH-тулы, провайдер/ретраи, playwright) на каждый старт.
-    const envReport = collectEnvironment({
-        configDir: dir,
-        baseDir,
-        config,
-        scanTools: process.env.NODE_ENV !== "test",
-    });
-    logEnvironment(envReport, logger);
-    for (const warning of envReport.warnings) {
-        logger.warn(warning);
-    }
-    const projectMapCacheDir = projectMmaDir(baseDir);
-    const indexerModule = new IndexerModule({
-        baseDir,
-        cacheDir: projectMapCacheDir,
-    });
-    try {
-        // Строим (или грузим из кэша) индекс проекта. На большом workspace первый
-        // обход подвисает старт без вывода — анонсируем оба конца, чтобы тишина
-        // была объяснена.
-        logger.info(t("env.indexing"));
-        const index = await indexerModule.buildIndex();
-        if (index) {
-            logger.info(t("env.indexed", { files: String(index.files.length) }));
-        }
-        else {
-            logger.warn(t("env.indexing_failed", { error: "no index produced" }));
-        }
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        logger.warn(t("env.indexing_failed", { error: msg }));
-    }
-    const skillsLoader = new SkillsLoader();
-    const builtinDir = join(import.meta.dirname, "skills", "builtin");
-    const globalDir = join(homedir(), ".agents", "skills");
-    const projectSkillsDir = join(projectMmaDir(baseDir), "skills");
-    const availableSkills = skillsLoader.loadFromAllSources(builtinDir, globalDir, projectSkillsDir);
-    const skillsBudget = Math.floor(config.contextWindow * config.skills.budget);
-    const skillsModule = new SkillsModule(availableSkills, skillsBudget);
-    const toolRegistry = new ToolRegistry();
-    registerAllTools(toolRegistry, skillsModule, {
-        enableOnDemand: config.tools?.enableOnDemand,
-    });
-    const pluginManager = new PluginManager();
-    // SystemInfo собирается здесь из готового профиля (в исходнике — сразу
-    // после создания pluginManager; сайд-эффектов чтения профиля тут уже нет).
-    const systemInfoContent = buildSystemInfo(config, baseDir, profile.compress());
-    const systemInfoPrompt = {
-        content: systemInfoContent,
-        priority: "critical",
-        essential: true,
-        estimatedTokens: estimateTokens(systemInfoContent),
-    };
-    return {
-        baseDir,
-        envReport,
-        indexerModule,
-        skillsModule,
-        toolRegistry,
-        pluginManager,
-        systemInfoPrompt,
-    };
-}

package/dist/core/bootstrap.js

@@ -1,112 +0,0 @@
-import { initConfigPhase } from "./bootstrap/config-phase";
-import { setupProviderPhase } from "./bootstrap/provider-phase";
-import { setupWorkspacePhase } from "./bootstrap/workspace-phase";
-import { setupSessionPhase } from "./bootstrap/session-phase";
-import { setupModulesPhase } from "./bootstrap/modules-phase";
-import { assembleAgent } from "./bootstrap/agent-phase";
-// Публичные экспорты 1:1 (сигнатуры и поведение не меняются) — потребители
-// (cli/main, web-command, тесты) продолжают импортить из "../core/bootstrap".
-export { applyReasoningCliOverride } from "./bootstrap/config-phase";
-export { applyProbedContext } from "./bootstrap/provider-phase";
-export { resolveBaseDir } from "./bootstrap/workspace-phase";
-export { agentsMdPaths, setOneShotMode } from "./bootstrap/state";
-export { buildSystemInfo } from "./system-prompt";
-/**
- * Собирает всё для работы агента: конфиг, окружение, провайдер, пробы,
- * тулы, модули, Agent. Тяжёлые старты (health-check, пробы) — фоном.
- * Тонкий оркестратор: каждая фаза — в `src/core/bootstrap/*.ts`.
- * @param configDir каталог конфига; @param projectDir workspace;
- * @param noAgentsMd пропустить AGENTS.md; @param exitOnComplete стоп на первом ответе;
- * @param reasoningLevel CLI-override reasoning; @param contextLog git-лог контекста.
- * @returns агент и окружение.
- */
-export async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplete, reasoningLevel, contextLog) {
-    // Фаза 1: пути, конфиг, локаль, логгер.
-    const { dir, config, legacyDetected, logger } = await initConfigPhase(configDir, projectDir, reasoningLevel);
-    // Фаза 2: провайдер, автозагрузка модели, фоновые пробы, профиль.
-    const provider = await setupProviderPhase(config, logger, dir);
-    // Фаза 3: workspace, окружение, индекс, скиллы, реестр тулов, system-блок.
-    const workspace = await setupWorkspacePhase(config, logger, dir, projectDir, provider.profile);
-    // Фаза 4: сессии, context-лог, менеджер контекста, живой toolCtx.
-    const session = await setupSessionPhase({
-        config,
-        logger,
-        dir,
-        baseDir: workspace.baseDir,
-        exitOnComplete,
-        contextLogFlag: contextLog,
-        contextProbePromise: provider.contextProbePromise,
-        capabilitiesRef: provider.capabilitiesRef,
-        llmProvider: provider.llmProvider,
-        bindSessionManager: provider.bindSessionManager,
-        toolRegistry: workspace.toolRegistry,
-        pluginManager: workspace.pluginManager,
-    });
-    // Фаза 5: модули, плагины, промпт-блоки, dry-run переполнения.
-    const modules = await setupModulesPhase({
-        config,
-        logger,
-        dir,
-        baseDir: workspace.baseDir,
-        noAgentsMd,
-        exitOnComplete,
-        toolRegistry: workspace.toolRegistry,
-        pluginManager: workspace.pluginManager,
-        skillsModule: workspace.skillsModule,
-        indexerModule: workspace.indexerModule,
-        sessionManager: session.sessionManager,
-        contextManager: session.contextManager,
-        toolCtx: session.toolCtx,
-        activeToolTags: session.activeToolTags,
-        hallucinationDetector: session.hallucinationDetector,
-        systemInfoPrompt: workspace.systemInfoPrompt,
-    });
-    // Фаза 6: AgentDeps, late-apply пробы, set_thinking.
-    const agent = await assembleAgent({
-        config,
-        configRef: session.configRef,
-        llmProvider: provider.llmProvider,
-        providerManager: provider.providerManager,
-        toolExecutor: session.toolExecutor,
-        pluginManager: workspace.pluginManager,
-        contextManager: session.contextManager,
-        hallucinationDetector: session.hallucinationDetector,
-        logger,
-        baseDir: workspace.baseDir,
-        configDir: dir,
-        activeToolTags: session.activeToolTags,
-        promptBlocks: modules.promptBlocks,
-        envReport: workspace.envReport,
-        getDynamicPromptBlocks: modules.getDynamicPromptBlocks,
-        lazyPromptBlocks: modules.lazyPromptBlocks,
-        sessionManager: session.sessionManager,
-        memoryStore: modules.memoryStore,
-        moduleRegistry: modules.moduleRegistry,
-        exitOnComplete,
-        contextLogger: session.contextLogger,
-        reasoningProbePromise: provider.reasoningProbePromise,
-        reasoningStrategy: provider.reasoningStrategy,
-        execModule: modules.execModule,
-        toolCtx: session.toolCtx,
-        contextProbePromise: provider.contextProbePromise,
-    }, workspace.toolRegistry);
-    return {
-        agent,
-        config,
-        logger,
-        sessionManager: session.sessionManager,
-        skillsModule: workspace.skillsModule,
-        pluginManager: workspace.pluginManager,
-        execModule: modules.execModule,
-        toolCtx: session.toolCtx,
-        toolRegistry: workspace.toolRegistry,
-        configDir: dir,
-        baseDir: workspace.baseDir,
-        noAgentsMd: noAgentsMd === true,
-        envReport: workspace.envReport,
-        legacyDetected,
-        contextProbe: provider.contextProbePromise,
-        memoryStore: modules.memoryStore,
-        indexerModule: workspace.indexerModule,
-    };
-}

package/dist/core/crash-handler.js

@@ -1,62 +0,0 @@
-/** Глобальные обработчики падений: запись краша в ~/.mma/logs/crash.jsonl. */
-import { appendFileSync, mkdirSync } from "fs";
-import { join } from "path";
-import { homedir } from "os";
-import { collectEnvironment } from "./environment";
-import { sanitizeLogMessage } from "../modules/security/data-sanitizer";
-import { t } from "../i18n/index";
-import { errMsg } from "../utils";
-import { globalLogsDir } from "../config/paths";
-/** Каталог краш-логов. */
-export const CRASH_LOG_DIR = globalLogsDir();
-/** Имя файла краш-лога. */
-export const CRASH_LOG_FILE = "crash.jsonl";
-/**
- * Строит санитизированную запись о падении. Окружение снимается в момент
- * краша (без сканирования тулов).
- */
-export function formatCrashEntry(type, err) {
-    const message = errMsg(err);
-    const stack = err instanceof Error && err.stack ? err.stack : message;
-    return {
-        ts: new Date().toISOString(),
-        type,
-        message: sanitizeLogMessage(message),
-        stack: sanitizeLogMessage(stack),
-        environment: collectEnvironment({ configDir: homedir(), scanTools: false }),
-    };
-}
-/**
- * Дописывает запись в краш-лог. Best-effort: отчёт о краше никогда не роняет процесс.
- */
-export function writeCrashEntry(dir, entry) {
-    try {
-        mkdirSync(dir, { recursive: true });
-        appendFileSync(join(dir, CRASH_LOG_FILE), `${JSON.stringify(entry)}\n`, "utf-8");
-    }
-    catch {
-        // Best-effort — отчёт о краше не должен ронять процесс
-    }
-}
-let installed = false;
-/**
- * Ставит глобальные обработчики. uncaughtException логируется и завершает
- * процесс (exit 1 — продолжение в битом состоянии недопустимо);
- * unhandledRejection только логируется (цикл продолжает работу).
- */
-export function installCrashHandlers() {
-    if (installed)
-        return;
-    installed = true;
-    process.on("uncaughtException", (err) => {
-        const entry = formatCrashEntry("uncaughtException", err);
-        writeCrashEntry(CRASH_LOG_DIR, entry);
-        process.stderr.write(`${t("env.crash_stderr", { type: entry.type, message: entry.message })}\n`);
-        process.exit(1);
-    });
-    process.on("unhandledRejection", (reason) => {
-        const entry = formatCrashEntry("unhandledRejection", reason);
-        writeCrashEntry(CRASH_LOG_DIR, entry);
-        process.stderr.write(`${t("env.crash_stderr", { type: entry.type, message: entry.message })}\n`);
-    });
-}