micro-models-agent 0.63.3 → 1.1.0

package/dist/cli/cache-line.js

@@ -0,0 +1,30 @@
+import { t } from "../i18n/index";
+import { formatCost } from "../modules/pricing/prices";
+/**
+ * Формирует строку кеша для футера. Возвращает undefined, когда показывать
+ * нечего: провайдер не отдал cache-токены и префикс не ломался. Так вывод не
+ * засоряется на бэкендах без кеша.
+ */
+export function formatCacheLine(cache) {
+    if (!cache)
+        return undefined;
+    const total = cache.cachedTokens + cache.uncachedTokens;
+    const hit = Math.round(cache.hitRate * 100);
+    if (total > 0) {
+        if (cache.saved !== undefined && cache.saved > 0) {
+            return t("repl.cache", { hit, saved: formatCost(cache.saved) });
+        }
+        return t("repl.cache_nosave", { hit });
+    }
+    // Нет провайдерских токенов — показываем только РЕАЛЬНЫЙ разрыв префикса.
+    // `none` (нормальная дописка истории) и `unknown` (нет предыдущего промпта —
+    // первая итерация) не являются промахом и не должны пугать.
+    const broken = cache.prefixCause !== undefined &&
+        cache.prefixCause !== "none" &&
+        cache.prefixCause !== "unknown";
+    if (broken && cache.prefixStable !== undefined && cache.prefixStable < 0.98) {
+        const stable = Math.round(cache.prefixStable * 100);
+        return t("repl.prefix", { stable, cause: t(`cache.cause.${cache.prefixCause}`) });
+    }
+    return undefined;
+}

package/dist/cli/command-suggest.js

@@ -0,0 +1,38 @@
+/** Levenshtein edit distance between two strings (case-insensitive). */
+export function levenshtein(a, b) {
+    const s = a.toLowerCase();
+    const t = b.toLowerCase();
+    if (s === t)
+        return 0;
+    const prev = new Array(t.length + 1);
+    const curr = new Array(t.length + 1);
+    for (let j = 0; j <= t.length; j++)
+        prev[j] = j;
+    for (let i = 1; i <= s.length; i++) {
+        curr[0] = i;
+        for (let j = 1; j <= t.length; j++) {
+            const cost = s[i - 1] === t[j - 1] ? 0 : 1;
+            curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost);
+        }
+        for (let j = 0; j <= t.length; j++)
+            prev[j] = curr[j];
+    }
+    return prev[t.length];
+}
+/**
+ * The known command whose name is within `maxDistance` of `input`, or
+ * `undefined` when nothing is close enough. Used to catch subcommand typos
+ * (`mma sesion list`) that would otherwise be silently sent to the LLM.
+ */
+export function closestCommand(input, known, maxDistance = 2) {
+    let best;
+    let bestDist = Infinity;
+    for (const k of known) {
+        const d = levenshtein(input, k);
+        if (d < bestDist) {
+            bestDist = d;
+            best = k;
+        }
+    }
+    return bestDist <= maxDistance ? best : undefined;
+}

package/dist/cli/commands.js

@@ -12,16 +12,14 @@ import { createPluginCommand } from "./plugin-commands";
 import { HOSTED_BASE_URLS } from "../modules/providers/presets";
 import { probeProviders, targetsFromProviders } from "../modules/providers/health";
 import { readMmaVersion } from "../core/version";
+import { runMapAction } from "../modules/indexer/map-command";
+import { budgetBreakdownLines, setBudgetShare } from "../config/budget";
+import { fetchProviderBudget } from "../llm/provider-budget";
+import { formatCost } from "../modules/pricing/prices";
+import { readChangelog, extractLatestChangelog, extractChangelogRange, } from "../modules/updater/changelog-reader";
+import { getDefaultChannel, writeMachineJson } from "../output";
 const version = readMmaVersion();
-export function createProgram() {
-    const program = new Command()
-        .name("mma")
-        .description(t("cli.description"))
-        .version(version)
-        .option("--no-agents-md", t("cli.no_agents_md"))
-        .option("-d, --dir <path>", t("cli.dir"))
-        .option("-e, --exit-on-complete", t("cli.exit_on_complete"))
-        .option("-j, --json", t("cli.json"));
+function buildInitCommand(program) {
     program
         .command("init")
         .description(t("cli.init"))
@@ -71,8 +69,10 @@ export function createProgram() {
             }
         }
         saveConfig(config, configPath, dirname(configPath));
-        console.log(t("cli.config_saved"));
+        getDefaultChannel().writeLine(t("cli.config_saved"));
     });
+}
+function buildConfigCommands(program) {
     const configCmd = program.command("config").description(t("cli.manage_config"));
     configCmd
         .command("set")
@@ -101,14 +101,14 @@ export function createProgram() {
         else
             obj[lastKey] = value;
         saveConfig(config, configPath, dirname(configPath));
-        console.log(t("cli.set_done", { key, value }));
+        getDefaultChannel().writeLine(t("cli.set_done", { key, value }));
     });
     configCmd
         .command("show")
         .description(t("cli.show_config"))
         .action(async () => {
         const { config } = await bootstrap();
-        console.log(JSON.stringify(config, null, 2));
+        writeMachineJson(config);
     });
     configCmd
         .command("migrate")
@@ -119,14 +119,14 @@ export function createProgram() {
         const configDir = join(homedir(), ".mma");
         const configPath = join(configDir, "config.json");
         if (hasDomainFiles(configDir)) {
-            console.log(pc.yellow(t("config.migrate_no_legacy")));
+            getDefaultChannel().writeLine(pc.yellow(t("config.migrate_no_legacy")));
             return;
         }
         if (!existsSync(configPath)) {
-            console.log(pc.yellow(t("config.migrate_no_legacy")));
+            getDefaultChannel().writeLine(pc.yellow(t("config.migrate_no_legacy")));
             return;
         }
-        console.log(t("config.migrate_start"));
+        getDefaultChannel().writeLine(t("config.migrate_start"));
         const { config } = loadConfig({ configDir, projectConfigPath: join(configDir, ".mmrc") });
         saveConfig(config, configPath, configDir);
         // Rename legacy file
@@ -135,15 +135,17 @@ export function createProgram() {
         renameSync(configPath, bakPath);
         const { readdirSync } = await import("fs");
         const domainFiles = readdirSync(join(configDir, "config")).filter((f) => f.endsWith(".json"));
-        console.log(pc.green(t("config.migrate_done", { count: String(domainFiles.length) })));
+        getDefaultChannel().writeLine(pc.green(t("config.migrate_done", { count: String(domainFiles.length) })));
     });
+}
+function buildModelCommands(program) {
     const model = program.command("model").description(t("cli.manage_models"));
     model
         .command("list")
         .description(t("cli.list_models"))
         .action(async () => {
         const { config } = await bootstrap();
-        console.log(t("cli.current_model"), config.model);
+        getDefaultChannel().writeLine(`${t("cli.current_model")} ${config.model}`);
         // Fetch available models from provider
         const { createProvider } = await import("../modules/providers/create");
         const provider = createProvider(config.provider.type, {
@@ -159,24 +161,29 @@ export function createProgram() {
             const models = await provider.listModels();
             s.stop();
             if (models.length > 0) {
-                console.log(t("cli.available_models"));
+                getDefaultChannel().writeLine(t("cli.available_models"));
                 const { getCertMark } = await import("../modules/certification/manifest");
                 for (const m of models) {
                     const marker = m === config.model ? "* " : "  ";
                     const mark = getCertMark(m, config.provider.baseUrl, version, process.cwd());
                     const cert = mark === "certified" ? "✔" : mark === "stale" ? "○" : "·";
-                    console.log(` ${marker}${cert} ${m}`);
+                    const label = mark === "certified"
+                        ? `  ${pc.green(t("cli.cert_label"))}`
+                        : mark === "stale"
+                            ? `  ${pc.yellow(t("cli.cert_stale_label"))}`
+                            : "";
+                    getDefaultChannel().writeLine(` ${marker}${cert} ${m}${label}`);
                 }
             }
             else {
-                console.log(t("cli.no_models_found"));
+                getDefaultChannel().writeLine(t("cli.no_models_found"));
             }
         }
         catch (err) {
             s.stop();
-            console.log(t("cli.model_fetch_failed", { error: String(err) }));
+            getDefaultChannel().writeLine(t("cli.model_fetch_failed", { error: String(err) }));
         }
-        console.log(t("cli.model_hint"));
+        getDefaultChannel().writeLine(t("cli.model_hint"));
     });
     model
         .command("use")
@@ -187,7 +194,7 @@ export function createProgram() {
         const { config } = await bootstrap();
         config.model = name;
         saveConfig(config, configPath, dirname(configPath));
-        console.log(t("cli.model_set", { name }));
+        getDefaultChannel().writeLine(t("cli.model_set", { name }));
     });
     model
         .command("certify")
@@ -196,6 +203,8 @@ export function createProgram() {
         .option("--provider-key <key>", t("cli.cert_provider_key"))
         .option("--context-window <n>", t("cli.cert_context_window"))
         .option("--tags <tags>", t("cli.cert_tags"), "core")
+        .option("--scenarios <ids>", t("cli.cert_scenarios"))
+        .option("--timeout <ms>", t("cli.cert_timeout"))
         .option("--reps <n>", t("cli.cert_reps"))
         .option("--force", t("cli.cert_force"))
         .option("--clean", t("cli.cert_clean"))
@@ -209,7 +218,14 @@ export function createProgram() {
             providerKey: cmdOpts.providerKey,
             contextWindow: cmdOpts.contextWindow ? parseInt(cmdOpts.contextWindow, 10) : undefined,
             tags: parseTags(cmdOpts.tags),
+            scenarios: cmdOpts.scenarios
+                ? String(cmdOpts.scenarios)
+                    .split(",")
+                    .map((x) => x.trim())
+                    .filter(Boolean)
+                : undefined,
             reps: cmdOpts.reps ? parseInt(cmdOpts.reps, 10) : 3,
+            timeout: cmdOpts.timeout ? parseInt(cmdOpts.timeout, 10) : undefined,
             force: cmdOpts.force === true,
             clean: cmdOpts.clean === true,
             config,
@@ -241,23 +257,111 @@ export function createProgram() {
         const { uncertify } = await import("../modules/certification/cli");
         await uncertify(name, config, process.cwd());
     });
-    // Context window command
+}
+function buildContextCommand(program) {
     program
         .command("context")
         .description(t("cli.manage_context"))
-        .argument("<size>", "Context window size in tokens")
-        .action(async (size) => {
-        const configPath = join(homedir(), ".mma", "config.json");
-        const { config } = await bootstrap();
+        .argument("[size]", "Context window size in tokens (omit to show the budget breakdown)")
+        .option("--system <fraction>", t("cli.context_system_fraction"))
+        .option("--reserve <fraction>", t("cli.context_reserve_fraction"))
+        .action(async (size, opts) => {
+        const { config, configDir } = await bootstrap();
+        const configPath = join(configDir, "config.json");
+        if (opts.system !== undefined || opts.reserve !== undefined) {
+            const key = opts.system !== undefined ? "system" : "reserve";
+            const value = Number(opts.system ?? opts.reserve);
+            if (setBudgetShare(config, key, value) !== null) {
+                getDefaultChannel().writeLine(t("cli.context_invalid_fraction"));
+                return;
+            }
+            saveConfig(config, configPath, dirname(configPath));
+            getDefaultChannel().writeLine(t("cli.context_fraction_set", { key, value }));
+            return;
+        }
+        if (size === undefined) {
+            for (const line of budgetBreakdownLines(config))
+                getDefaultChannel().writeLine(line);
+            return;
+        }
         const contextWindow = parseInt(size, 10);
         if (isNaN(contextWindow) || contextWindow < 1024) {
-            console.log(t("cli.invalid_context_size"));
+            getDefaultChannel().writeLine(t("cli.invalid_context_size"));
             return;
         }
         config.contextWindow = contextWindow;
         saveConfig(config, configPath, dirname(configPath));
-        console.log(t("cli.context_set", { size: contextWindow }));
+        getDefaultChannel().writeLine(t("cli.context_set", { size: contextWindow }));
     });
+}
+function buildUsageCommand(program) {
+    program
+        .command("usage")
+        .description(t("cli.usage"))
+        .action(async () => {
+        const { config, logger } = await bootstrap();
+        const { type: provider, baseUrl, apiKey } = config.provider;
+        const result = await fetchProviderBudget(provider, baseUrl, apiKey, {
+            log: (level, message) => (level === "warn" ? logger.warn(message) : logger.debug(message)),
+        });
+        if (result.reason === "unsupported") {
+            getDefaultChannel().writeLine(t("cli.usage_unsupported", { provider }));
+            return;
+        }
+        if (result.reason === "no-key") {
+            getDefaultChannel().writeLine(t("cli.usage_no_key"));
+            return;
+        }
+        if (result.reason === "error" || !result.budget) {
+            getDefaultChannel().writeLine(t("cli.usage_error", { error: result.error ?? "" }));
+            return;
+        }
+        const b = result.budget;
+        let printed = false;
+        if (b.keyUsageUsd !== undefined) {
+            getDefaultChannel().writeLine(t("cli.usage_key_usage", { usage: formatCost(b.keyUsageUsd) }));
+            printed = true;
+        }
+        if (b.keyLimitUsd !== undefined && b.keyRemainingUsd !== undefined) {
+            getDefaultChannel().writeLine(t("cli.usage_key_limit", {
+                limit: formatCost(b.keyLimitUsd),
+                remaining: formatCost(b.keyRemainingUsd),
+            }));
+            printed = true;
+        }
+        if (b.balanceUsd !== undefined) {
+            getDefaultChannel().writeLine(t("cli.usage_balance", { balance: formatCost(b.balanceUsd) }));
+            printed = true;
+        }
+        if (b.totalCreditsUsd !== undefined && b.totalUsageUsd !== undefined) {
+            getDefaultChannel().writeLine(t("cli.usage_account", {
+                credits: formatCost(b.totalCreditsUsd),
+                used: formatCost(b.totalUsageUsd),
+            }));
+            printed = true;
+        }
+        if (!printed)
+            getDefaultChannel().writeLine(t("cli.usage_empty"));
+    });
+}
+function buildMapCommand(program) {
+    program
+        .command("map")
+        .description(t("cli.map.description"))
+        .argument("[action]", t("cli.map.action"), "summary")
+        .argument("[query]", t("cli.map.query"))
+        .action(async (action, query) => {
+        const { agent } = await bootstrap();
+        const indexer = agent.getModule("indexer");
+        if (!indexer) {
+            getDefaultChannel().writeLine(t("indexer.not_indexed"));
+            return;
+        }
+        const result = await runMapAction(indexer, action, query);
+        getDefaultChannel().writeLine(result.output);
+    });
+}
+function buildProviderCommands(program) {
     const provider = program.command("provider").description(t("cli.manage_providers"));
     provider
         .command("check")
@@ -281,10 +385,8 @@ export function createProgram() {
         });
         for (const r of results) {
             const mark = r.ok ? pc.green("✓") : pc.red("✗");
-            const detail = r.ok
-                ? pc.dim(`${r.ms}ms, ${r.models} models`)
-                : pc.red(r.error ?? "failed");
-            console.log(` ${mark} ${r.name.padEnd(16)} ${detail}`);
+            const detail = r.ok ? pc.dim(`${r.ms}ms, ${r.models} models`) : pc.red(r.error ?? "failed");
+            getDefaultChannel().writeLine(` ${mark} ${r.name.padEnd(16)} ${detail}`);
         }
     });
     provider
@@ -294,16 +396,16 @@ export function createProgram() {
         const { config, agent } = await bootstrap();
         const providers = agent.listProviders();
         if (providers.length > 0) {
-            console.log(t("cli.current_provider"));
+            getDefaultChannel().writeLine(t("cli.current_provider"));
             for (const p of providers) {
                 const marker = p.active ? pc.green("* ") : "  ";
                 const prio = p.priority !== undefined ? `  ${pc.dim(`prio=${p.priority}`)}` : "";
-                console.log(` ${marker}${p.label}  (${pc.dim(p.type)})  ${pc.dim(p.baseUrl)}${prio}`);
+                getDefaultChannel().writeLine(` ${marker}${p.label}  (${pc.dim(p.type)})  ${pc.dim(p.baseUrl)}${prio}`);
             }
             return;
         }
-        console.log(t("cli.current_provider"), config.provider.type);
-        console.log(t("cli.base_url"), config.provider.baseUrl);
+        getDefaultChannel().writeLine(`${t("cli.current_provider")} ${config.provider.type}`);
+        getDefaultChannel().writeLine(`${t("cli.base_url")} ${config.provider.baseUrl}`);
     });
     provider
         .command("use")
@@ -315,10 +417,10 @@ export function createProgram() {
         if (config.provider.entries && config.provider.entries.length > 0) {
             try {
                 await agent.setProvider(name);
-                console.log(t("cli.provider_set", { name }));
+                getDefaultChannel().writeLine(t("cli.provider_set", { name }));
             }
             catch (e) {
-                console.log(pc.red(e.message));
+                getDefaultChannel().writeLine(pc.red(e.message));
             }
             return;
         }
@@ -328,9 +430,9 @@ export function createProgram() {
             config.provider.baseUrl = baseUrl;
         }
         saveConfig(config, configPath, dirname(configPath));
-        console.log(t("cli.provider_set", { name }));
+        getDefaultChannel().writeLine(t("cli.provider_set", { name }));
         if (baseUrl) {
-            console.log(t("cli.provider_base_hint", { baseUrl }));
+            getDefaultChannel().writeLine(t("cli.provider_base_hint", { baseUrl }));
         }
     });
     provider
@@ -346,9 +448,7 @@ export function createProgram() {
         .action(async (name, opts) => {
         const configPath = join(homedir(), ".mma", "config.json");
         const { config } = await bootstrap();
-        const entries = Array.isArray(config.provider.entries)
-            ? config.provider.entries
-            : [];
+        const entries = Array.isArray(config.provider.entries) ? config.provider.entries : [];
         // If a legacy single provider exists, seed the list with it first.
         if (entries.length === 0) {
             entries.push({
@@ -360,7 +460,7 @@ export function createProgram() {
         }
         const baseUrl = opts.url || HOSTED_BASE_URLS[name] || HOSTED_BASE_URLS[`opencode-${name}`] || "";
         if (!baseUrl) {
-            console.log(pc.red(t("cli.provider_no_url", { name })));
+            getDefaultChannel().writeLine(pc.red(t("cli.provider_no_url", { name })));
             return;
         }
         entries.push({
@@ -384,9 +484,11 @@ export function createProgram() {
         config.provider.entries = entries;
         config.provider.active = config.provider.active || config.provider.type;
         saveConfig(config, configPath, dirname(configPath));
-        console.log(pc.green(t("cli.provider_added", { name })));
-        console.log(t("cli.provider_switch_hint"));
+        getDefaultChannel().writeLine(pc.green(t("cli.provider_added", { name })));
+        getDefaultChannel().writeLine(t("cli.provider_switch_hint"));
     });
+}
+function buildSessionCommands(program) {
     const session = program.command("session").description(t("cli.manage_sessions"));
     session
         .command("list")
@@ -395,13 +497,13 @@ export function createProgram() {
         const { sessionManager } = await bootstrap();
         const sessions = sessionManager.list();
         if (sessions.length === 0) {
-            console.log(t("session.no_sessions"));
+            getDefaultChannel().writeLine(t("session.no_sessions"));
             return;
         }
         const active = sessionManager.getActive();
         for (const s of sessions) {
             const marker = s.id === active ? "*" : " ";
-            console.log(` ${marker} ${s.id.slice(0, 12)}  ${s.name}  ${s.messageCount} msgs  ${s.updatedAt.slice(0, 10)}`);
+            getDefaultChannel().writeLine(` ${marker} ${s.id.slice(0, 12)}  ${s.name}  ${s.messageCount} msgs  ${s.updatedAt.slice(0, 10)}`);
         }
     });
     session
@@ -412,17 +514,68 @@ export function createProgram() {
         const { sessionManager } = await bootstrap();
         const meta = sessionManager.get(id);
         if (!meta) {
-            console.log(t("session.not_found", { id }));
+            getDefaultChannel().writeLine(t("session.not_found", { id }));
             return;
         }
-        console.log(`ID:           ${meta.id}`);
-        console.log(`Name:         ${meta.name}`);
-        console.log(`Created:      ${meta.createdAt}`);
-        console.log(`Updated:      ${meta.updatedAt}`);
-        console.log(`Messages:     ${meta.messageCount}`);
-        console.log(`Model:        ${meta.model}`);
-        console.log(`Context:      ${meta.contextWindow}`);
-        console.log(`Project:      ${meta.projectDir}`);
+        getDefaultChannel().writeLine(`ID:           ${meta.id}`);
+        getDefaultChannel().writeLine(`Name:         ${meta.name}`);
+        getDefaultChannel().writeLine(`Created:      ${meta.createdAt}`);
+        getDefaultChannel().writeLine(`Updated:      ${meta.updatedAt}`);
+        getDefaultChannel().writeLine(`Messages:     ${meta.messageCount}`);
+        getDefaultChannel().writeLine(`Model:        ${meta.model}`);
+        getDefaultChannel().writeLine(`Context:      ${meta.contextWindow}`);
+        getDefaultChannel().writeLine(`Project:      ${meta.projectDir}`);
+        const moeEvents = sessionManager.loadSessionLog(id).filter((e) => e.type.startsWith("moe_"));
+        if (moeEvents.length > 0) {
+            getDefaultChannel().writeLine("");
+            getDefaultChannel().writeLine(pc.cyan("MoE events:"));
+            for (const e of moeEvents) {
+                const ts = e.ts.slice(11, 19);
+                if (e.type === "moe_subtask") {
+                    getDefaultChannel().writeLine(`  ${pc.dim(ts)} [subtask] ${e.subtaskId} (${e.expertTag}) ${e.status ?? ""}${e.durationMs !== undefined ? ` ${e.durationMs}ms` : ""}`);
+                }
+                else if (e.type === "moe_plan") {
+                    getDefaultChannel().writeLine(`  ${pc.dim(ts)} [plan] ${e.status === "ok" ? e.subtaskIds?.join(", ") : e.status}`);
+                }
+                else if (e.type === "moe_replan") {
+                    getDefaultChannel().writeLine(`  ${pc.dim(ts)} [replan] cycle ${e.cycle}: ${e.subtaskIds?.join(", ")}`);
+                }
+                else {
+                    const usage = e.usageByTag
+                        ? " | usage: " +
+                            Object.entries(e.usageByTag)
+                                .map(([tag, u]) => `${tag}=${u.totalTokens}t`)
+                                .join(", ")
+                        : "";
+                    getDefaultChannel().writeLine(`  ${pc.dim(ts)} [verify] ${e.decision ?? e.status ?? "?"}${e.explanation ? ` — ${e.explanation}` : ""}${usage}`);
+                }
+            }
+        }
+        const usageEvents = sessionManager.loadSessionLog(id).filter((e) => e.type === "llm_usage");
+        if (usageEvents.length > 0) {
+            let prompt = 0;
+            let completion = 0;
+            let cached = 0;
+            for (const e of usageEvents) {
+                prompt += e.promptTokens ?? 0;
+                completion += e.completionTokens ?? 0;
+                cached += e.cachedTokens ?? 0;
+            }
+            getDefaultChannel().writeLine("");
+            getDefaultChannel().writeLine(pc.cyan(t("cli.session_usage", {
+                prompt,
+                completion,
+                total: prompt + completion,
+            })));
+            if (cached > 0 && prompt > 0) {
+                const hit = Math.round((cached / prompt) * 100);
+                getDefaultChannel().writeLine(pc.dim(t("cli.session_cache", {
+                    hit,
+                    cached,
+                    uncached: Math.max(0, prompt - cached),
+                })));
+            }
+        }
     });
     session
         .command("delete")
@@ -431,17 +584,89 @@ export function createProgram() {
         .action(async (id) => {
         const { sessionManager } = await bootstrap();
         sessionManager.delete(id);
-        console.log(t("session.deleted", { id }));
+        getDefaultChannel().writeLine(t("session.deleted", { id }));
+    });
+}
+function buildChangelogCommand(program) {
+    program
+        .command("changelog")
+        .description(t("cli.changelog_title", { version }))
+        .option("--from <version>", t("cli.changelog_range", { from: "..." }))
+        .action((opts) => {
+        const changelog = readChangelog("micro-models-agent");
+        if (!changelog) {
+            getDefaultChannel().writeLine(pc.yellow(t("cli.changelog_not_found")));
+            return;
+        }
+        if (opts.from) {
+            const range = extractChangelogRange(changelog, opts.from, version);
+            if (!range) {
+                getDefaultChannel().writeLine(pc.yellow(t("cli.changelog_not_found")));
+                return;
+            }
+            getDefaultChannel().writeLine(pc.cyan(t("cli.changelog_range", { from: opts.from })));
+            getDefaultChannel().writeLine(range);
+        }
+        else {
+            const latest = extractLatestChangelog(changelog);
+            if (!latest) {
+                getDefaultChannel().writeLine(pc.yellow(t("cli.changelog_not_found")));
+                return;
+            }
+            getDefaultChannel().writeLine(pc.cyan(t("cli.changelog_title", { version })));
+            getDefaultChannel().writeLine(latest);
+        }
     });
+}
+/** Тонкий оркестратор: собирает CLI из per-domain builder-функций. */
+export function createProgram() {
+    const program = new Command()
+        .name("mma")
+        .description(t("cli.description"))
+        .version(version)
+        .option("--no-agents-md", t("cli.no_agents_md"))
+        .option("-d, --dir <path>", t("cli.dir"))
+        .option("-e, --exit-on-complete", t("cli.exit_on_complete"))
+        .option("-j, --json", t("cli.json"))
+        .option("--reasoning <level>", t("cli.reasoning_level"), "auto");
+    buildInitCommand(program);
+    buildConfigCommands(program);
+    buildModelCommands(program);
+    buildContextCommand(program);
+    buildUsageCommand(program);
+    buildMapCommand(program);
+    buildProviderCommands(program);
+    buildSessionCommands(program);
     // Add security commands
     createSecurityCommand(program);
     // Add plugin commands
     createPluginCommand(program);
+    buildChangelogCommand(program);
     program
         .argument("[prompt...]", "Prompt to execute")
         .description("Run a single prompt")
         .action((prompt) => {
         /* Handled by main.ts after program.parse() */
     });
+    // Subcommand actions run full bootstrap() (reasoning-probe fetch, indexer,
+    // plugins…), which leaves open handles — without an explicit exit the
+    // process hangs after printing its result ("config set" printed, never
+    // exited). The prompt/REPL paths exit explicitly in main.ts; every
+    // SUBCOMMAND is one-shot, so exit as soon as its action resolves.
+    //
+    // Хук навешиваем РЕКУРСИВНО на все подкоманды (не только верхнего уровня):
+    // у вложенных (`session show`, `model certify`, `provider use` …) родитель
+    // без action, поэтому postAction родителя не срабатывает, и фоновые хендлы
+    // bootstrap держат процесс — команда «виснет» после вывода. На `program`
+    // хук не вешаем: его action — prompt/REPL, которым управляет main.ts.
+    const attachOneShotExit = (cmd) => {
+        cmd.hook("postAction", () => {
+            process.exit(0);
+        });
+        for (const sub of cmd.commands)
+            attachOneShotExit(sub);
+    };
+    for (const cmd of program.commands)
+        attachOneShotExit(cmd);
     return program;
 }

package/dist/cli/completer.js

@@ -125,22 +125,17 @@ export class SkillNameProvider {
             (ctx.tokens[1] === "load" || ctx.tokens[1] === "unload"));
     }
     complete(ctx) {
-        const subcmd = ctx.tokens[1];
-        if (subcmd === "load") {
-            const available = this.skillsModule.getAvailable();
-            const names = available.map((s) => s.name);
-            if (!ctx.partial)
-                return names;
-            return names.filter((n) => n.toLowerCase().includes(ctx.partial.toLowerCase()));
-        }
-        if (subcmd === "unload") {
-            const loaded = this.skillsModule.getLoaded();
-            const names = loaded.map((s) => s.name);
-            if (!ctx.partial)
-                return names;
-            return names.filter((n) => n.toLowerCase().includes(ctx.partial.toLowerCase()));
-        }
-        return [];
+        const sources = {
+            load: () => this.skillsModule.getAvailable().map((s) => s.name),
+            unload: () => this.skillsModule.getLoaded().map((s) => s.name),
+        };
+        const source = sources[ctx.tokens[1]];
+        if (!source)
+            return [];
+        const names = source();
+        if (!ctx.partial)
+            return names;
+        return names.filter((n) => n.toLowerCase().includes(ctx.partial.toLowerCase()));
     }
 }
 export class Completer {
@@ -148,6 +143,11 @@ export class Completer {
     registerProvider(provider) {
         this.providers.push(provider);
     }
+    /** Drop all registered providers — used before a rebuild (e.g. /reload)
+     *  so re-registering never accumulates duplicates. */
+    reset() {
+        this.providers = [];
+    }
     complete(line) {
         const cursor = line.length;
         const tokens = line.split(/\s+/);