micro-models-agent 0.56.1 → 0.56.3

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to Micro Models Agent (MMA) will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.56.1] - 2026-08-27
+
+### Added
+- **CLI**: `mma changelog` command — show latest changelog entry or diff between versions (`--from <version>`)
+- **Updater**: show changelog after auto-update install (`updater.installed` message includes new version's changelog)
+- **Docs**: `CHANGELOG.md` included in npm package (visible via `npm info micro-models-agent`)
+- **Docs**: rule to maintain changelog in `AGENTS.md`
+
 ## [0.56.0] - 2026-08-27
 
 ### Added

package/dist/main.js

@@ -3126,8 +3126,12 @@ Apply a matching solution from these results. If none is relevant — do NOT rep
     "updater.check_error": "[updater] update check failed: {error}",
     "updater.available": "[updater] Update available: {current} → {latest}. Run `npm install -g micro-models-agent` to upgrade.",
     "updater.installing": "[updater] Installing {latest} globally (current: {current})…",
-    "updater.installed": "[updater] Installed {latest}. Restart MMA to use it (was {current}).",
+    "updater.installed": `[updater] Installed {latest}. Restart MMA to use it (was {current}).
+{changelog}`,
     "updater.install_failed": "[updater] Failed to install {latest}: {error}. Update manually with `npm install -g micro-models-agent`.",
+    "cli.changelog_title": "Changelog (micro-models-agent@{version}):",
+    "cli.changelog_not_found": "Changelog not found for this installation.",
+    "cli.changelog_range": "Changes since {from}:",
     "tools.enable_no_tags": 'enable_tools requires at least one tag in the "tags" array.',
     "tools.enable_no_executor": "Tool executor is not available — cannot enumerate enabled tools.",
     "tools.enable_already_active": "Tool tags already active: {tags}.",
@@ -3889,8 +3893,12 @@ var init_ru = __esm(() => {
     "updater.check_error": "[updater] Ошибка проверки обновления: {error}",
     "updater.available": "[updater] Доступно обновление: {current} → {latest}. Выполните `npm install -g micro-models-agent` для обновления.",
     "updater.installing": "[updater] Установка {latest} глобально (текущая: {current})…",
-    "updater.installed": "[updater] Установлена {latest}. Перезапустите MMA для применения (была {current}).",
+    "updater.installed": `[updater] Установлена {latest}. Перезапустите MMA для применения (была {current}).
+{changelog}`,
     "updater.install_failed": "[updater] Не удалось установить {latest}: {error}. Обновите вручную: `npm install -g micro-models-agent`.",
+    "cli.changelog_title": "Список изменений (micro-models-agent@{version}):",
+    "cli.changelog_not_found": "Changelog не найден для этой установки.",
+    "cli.changelog_range": "Изменения с версии {from}:",
     "tools.enable_no_tags": 'enable_tools требует хотя бы один тег в массиве "tags".',
     "tools.enable_no_executor": "Исполнитель тулов недоступен — невозможно перечислить включённые тулы.",
     "tools.enable_already_active": "Теги тулов уже активны: {tags}.",
@@ -33408,8 +33416,8 @@ var init_scenarios = __esm(() => {
 });
 
 // src/modules/certification/loader.ts
-import { existsSync as existsSync51, readdirSync as readdirSync17, readFileSync as readFileSync32 } from "fs";
-import { join as join44 } from "path";
+import { existsSync as existsSync52, readdirSync as readdirSync17, readFileSync as readFileSync33 } from "fs";
+import { join as join45 } from "path";
 function validateScenario(s) {
   const errors2 = [];
   const isSkip = s.mode === "skip";
@@ -33461,12 +33469,12 @@ function loadScenarios(userDir) {
     else
       scenarios.push(s);
   }
-  if (userDir && existsSync51(userDir)) {
+  if (userDir && existsSync52(userDir)) {
     for (const file of readdirSync17(userDir)) {
       if (!file.endsWith(".yaml") && !file.endsWith(".yml"))
         continue;
       try {
-        const raw = readFileSync32(join44(userDir, file), "utf-8");
+        const raw = readFileSync33(join45(userDir, file), "utf-8");
         const data = $parse(raw);
         const parsed = normalizeScenario(data, file);
         const errs = validateScenario(parsed);
@@ -33529,8 +33537,8 @@ var init_loader3 = __esm(() => {
 });
 
 // src/modules/certification/fact-checker.ts
-import { existsSync as existsSync52, readFileSync as readFileSync33, statSync as statSync9 } from "fs";
-import { join as join45 } from "path";
+import { existsSync as existsSync53, readFileSync as readFileSync34, statSync as statSync9 } from "fs";
+import { join as join46 } from "path";
 function checkSandbox(sandboxDir, checks, exitCode, output) {
   const failures = [];
   for (const check of checks) {
@@ -33547,16 +33555,16 @@ function runCheck2(sandboxDir, check, exitCode, output) {
     case "outputContains":
       return output.includes(check.text);
     case "fileExists":
-      return isFile(join45(sandboxDir, check.path));
+      return isFile(join46(sandboxDir, check.path));
     case "fileNotExists":
-      return !existsSync52(join45(sandboxDir, check.path));
+      return !existsSync53(join46(sandboxDir, check.path));
     case "dirExists":
-      return isDir(join45(sandboxDir, check.path));
+      return isDir(join46(sandboxDir, check.path));
     case "fileContent": {
-      const abs = join45(sandboxDir, check.path);
+      const abs = join46(sandboxDir, check.path);
       if (!isFile(abs))
         return false;
-      const content = readFileSync33(abs, "utf-8");
+      const content = readFileSync34(abs, "utf-8");
       if (check.contains !== undefined)
         return content.includes(check.contains);
       if (check.equals !== undefined)
@@ -33564,10 +33572,10 @@ function runCheck2(sandboxDir, check, exitCode, output) {
       return false;
     }
     case "fileRegex": {
-      const abs = join45(sandboxDir, check.path);
+      const abs = join46(sandboxDir, check.path);
       if (!isFile(abs))
         return false;
-      return new RegExp(check.pattern).test(readFileSync33(abs, "utf-8"));
+      return new RegExp(check.pattern).test(readFileSync34(abs, "utf-8"));
     }
     default:
       return false;
@@ -33575,14 +33583,14 @@ function runCheck2(sandboxDir, check, exitCode, output) {
 }
 function isFile(p) {
   try {
-    return existsSync52(p) && statSync9(p).isFile();
+    return existsSync53(p) && statSync9(p).isFile();
   } catch {
     return false;
   }
 }
 function isDir(p) {
   try {
-    return existsSync52(p) && statSync9(p).isDirectory();
+    return existsSync53(p) && statSync9(p).isDirectory();
   } catch {
     return false;
   }
@@ -33613,8 +33621,8 @@ var init_fact_checker = () => {};
 
 // src/modules/certification/runner.ts
 import { spawn as spawn10 } from "child_process";
-import { existsSync as existsSync53, mkdirSync as mkdirSync20, rmSync as rmSync4, cpSync as cpSync2, writeFileSync as writeFileSync20, readdirSync as readdirSync18, readFileSync as readFileSync34 } from "fs";
-import { join as join46, resolve as resolve23, dirname as dirname19, relative as relative7 } from "path";
+import { existsSync as existsSync54, mkdirSync as mkdirSync20, rmSync as rmSync4, cpSync as cpSync2, writeFileSync as writeFileSync20, readdirSync as readdirSync18, readFileSync as readFileSync35 } from "fs";
+import { join as join47, resolve as resolve23, dirname as dirname20, relative as relative7 } from "path";
 async function runScenario(scenario, opts) {
   if (scenario.mode === "skip") {
     return {
@@ -33634,7 +33642,7 @@ async function runScenario(scenario, opts) {
   let firstError;
   let lastFailedSandbox;
   for (let i = 1;i <= reps; i++) {
-    const sandbox = join46(opts.sandboxBase, `run-${scenario.id}-${i}`);
+    const sandbox = join47(opts.sandboxBase, `run-${scenario.id}-${i}`);
     let failures = [];
     let exitCode = -1;
     let output = "";
@@ -33658,9 +33666,9 @@ async function runScenario(scenario, opts) {
         env3.MMA_PROVIDER_APIKEY = opts.providerKey;
       if (scenario.config && opts.baseConfig) {
         const merged = deepMergeAny(opts.baseConfig, scenario.config);
-        const certConfigDir = join46(sandbox, ".mma");
+        const certConfigDir = join47(sandbox, ".mma");
         mkdirSync20(certConfigDir, { recursive: true });
-        writeFileSync20(join46(certConfigDir, "config.json"), JSON.stringify(merged, null, 2), "utf-8");
+        writeFileSync20(join47(certConfigDir, "config.json"), JSON.stringify(merged, null, 2), "utf-8");
         env3.MMA_CONFIG_DIR = certConfigDir;
       }
       const res = await runner(env3, opts.mmaRoot, args, timeoutMs);
@@ -33707,12 +33715,12 @@ function prepareSandbox(sandbox, scenario, mmaRoot) {
   rmSync4(sandbox, { recursive: true, force: true });
   mkdirSync20(sandbox, { recursive: true });
   for (const f of scenario.fixtures ?? []) {
-    const src = join46(mmaRoot, f.source);
-    if (!existsSync53(src)) {
+    const src = join47(mmaRoot, f.source);
+    if (!existsSync54(src)) {
       throw new Error(`fixture missing: ${f.source}`);
     }
-    const dest = join46(sandbox, f.dest);
-    mkdirSync20(dirname19(dest), { recursive: true });
+    const dest = join47(sandbox, f.dest);
+    mkdirSync20(dirname20(dest), { recursive: true });
     cpSync2(src, dest);
   }
 }
@@ -33724,10 +33732,10 @@ function collectDiagnostics(sandbox) {
   } else {
     lines.push("  Files created: (none)");
   }
-  const planPath = join46(sandbox, ".mma", "plans", "active.json");
-  if (existsSync53(planPath)) {
+  const planPath = join47(sandbox, ".mma", "plans", "active.json");
+  if (existsSync54(planPath)) {
     try {
-      const plan = JSON.parse(readFileSync34(planPath, "utf-8"));
+      const plan = JSON.parse(readFileSync35(planPath, "utf-8"));
       const steps = plan.steps ?? [];
       const done = steps.filter((s) => s.status === "done").length;
       const pending = steps.filter((s) => s.status === "pending" || s.status === "in_progress");
@@ -33746,7 +33754,7 @@ function listFiles(dir, root) {
     for (const entry of readdirSync18(dir, { withFileTypes: true })) {
       if (entry.name === ".mma")
         continue;
-      const abs = join46(dir, entry.name);
+      const abs = join47(dir, entry.name);
       const rel = toForwardSlash(relative7(root, abs));
       if (entry.isDirectory()) {
         result.push(...listFiles(abs, root));
@@ -33758,15 +33766,15 @@ function listFiles(dir, root) {
   return result;
 }
 function resolveMmaEntry(mmaRoot) {
-  const dev = join46(mmaRoot, "src", "cli", "main.ts");
-  if (existsSync53(dev))
+  const dev = join47(mmaRoot, "src", "cli", "main.ts");
+  if (existsSync54(dev))
     return dev;
-  return join46(mmaRoot, "dist", "main.js");
+  return join47(mmaRoot, "dist", "main.js");
 }
 function findMmaRoot(fromDir) {
   const candidates = [resolve23(fromDir, "..", "..", ".."), resolve23(fromDir, "..")];
   for (const c of candidates) {
-    if (existsSync53(join46(c, "package.json")))
+    if (existsSync54(join47(c, "package.json")))
       return c;
   }
   return process.cwd();
@@ -33834,15 +33842,15 @@ __export(exports_cli, {
   certList: () => certList
 });
 import { rmSync as rmSync5, writeFileSync as writeFileSync21 } from "fs";
-import { join as join47, dirname as dirname20 } from "path";
+import { join as join48, dirname as dirname21 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
-import { existsSync as existsSync54, readFileSync as readFileSync35 } from "fs";
+import { existsSync as existsSync55, readFileSync as readFileSync36 } from "fs";
 function readVersion() {
-  const candidates = [join47(MMA_ROOT, "package.json")];
+  const candidates = [join48(MMA_ROOT, "package.json")];
   for (const p of candidates) {
-    if (existsSync54(p)) {
+    if (existsSync55(p)) {
       try {
-        const raw = JSON.parse(readFileSync35(p, "utf-8"));
+        const raw = JSON.parse(readFileSync36(p, "utf-8"));
         if (raw.version)
           return raw.version;
       } catch {}
@@ -33855,7 +33863,7 @@ function parseTags(s) {
 }
 async function certify(opts) {
   const providerUrl = opts.providerUrl || opts.config.provider.baseUrl;
-  const { scenarios, errors: errors2 } = loadScenarios(join47(opts.projectDir, ".mma", "certification", "scenarios"));
+  const { scenarios, errors: errors2 } = loadScenarios(join48(opts.projectDir, ".mma", "certification", "scenarios"));
   for (const e of errors2)
     console.error(pc2.yellow(`  ${e}`));
   let selected = filterByTags(scenarios, opts.tags);
@@ -33886,7 +33894,7 @@ async function certify(opts) {
     return;
   }
   console.log(t("cli.cert_started", { model: opts.name, provider: providerUrl }));
-  const sandboxBase = join47(process.cwd(), ".mma", "certification");
+  const sandboxBase = join48(process.cwd(), ".mma", "certification");
   const results = [];
   const total = selected.length;
   let idx = 0;
@@ -34019,10 +34027,10 @@ function printResults(results) {
   }
 }
 function writeReport(entry, projectDir) {
-  const reportDir = join47(projectDir, "certification");
+  const reportDir = join48(projectDir, "certification");
   const ts = entry.certifiedAt.replace(/[:.]/g, "-").slice(0, 19);
   const filename = `report-${entry.model.replace(/[/\\:]/g, "_")}-${ts}.json`;
-  const reportPath = join47(reportDir, filename);
+  const reportPath = join48(reportDir, filename);
   const report = {
     model: entry.model,
     providerUrl: entry.providerUrl,
@@ -34055,7 +34063,7 @@ var init_cli = __esm(() => {
   init_loader3();
   init_runner2();
   init_manifest();
-  HERE = dirname20(fileURLToPath5(import.meta.url));
+  HERE = dirname21(fileURLToPath5(import.meta.url));
   MMA_ROOT = findMmaRoot(HERE);
 });
 
@@ -34065,8 +34073,8 @@ __export(exports_repl_commands, {
   registerAllCommands: () => registerAllCommands,
   COMMAND_GROUPS: () => COMMAND_GROUPS
 });
-import { join as join49, dirname as dirname22 } from "path";
-import { existsSync as existsSync56 } from "fs";
+import { join as join50, dirname as dirname23 } from "path";
+import { existsSync as existsSync57 } from "fs";
 function registerAllCommands(ctx) {
   registerBuiltinCommands(ctx);
   registerMmaCommands(ctx);
@@ -34123,7 +34131,7 @@ function registerMmaCommands(ctx) {
       }
       try {
         const { loadFileAsDataUrl: loadFileAsDataUrl2, loadUrlAsDataUrl: loadUrlAsDataUrl2, readClipboardImage: readClipboardImage2 } = await Promise.resolve().then(() => (init_image_utils(), exports_image_utils));
-        const { existsSync: existsSync57 } = await import("fs");
+        const { existsSync: existsSync58 } = await import("fs");
         const { resolve: resolve24 } = await import("path");
         let dataUrl;
         let label;
@@ -34143,7 +34151,7 @@ function registerMmaCommands(ctx) {
           label = source;
         } else {
           const absPath = resolve24(process.cwd(), source);
-          if (!existsSync57(absPath)) {
+          if (!existsSync58(absPath)) {
             console.log(pc2.red(t("image.not_found", { path: source })));
             return;
           }
@@ -34246,7 +34254,7 @@ function registerMmaCommands(ctx) {
       console.log(pc2.yellow(t("repl.wizard_running")));
       await ctx.withExclusiveInput(async () => {
         const answers = await runSetup(ctx.rl);
-        const configPath = join49(ctx.configDir, "config.json");
+        const configPath = join50(ctx.configDir, "config.json");
         ctx.config.provider.type = answers.provider;
         ctx.config.provider.baseUrl = answers.apiBase;
         ctx.config.provider.apiKey = answers.apiKey;
@@ -34254,7 +34262,7 @@ function registerMmaCommands(ctx) {
         ctx.config.contextWindow = answers.contextWindow;
         ctx.config.maxToolIterations = answers.maxToolIterations;
         ctx.config.locale = answers.locale;
-        saveConfig(ctx.config, configPath, dirname22(configPath));
+        saveConfig(ctx.config, configPath, dirname23(configPath));
         await ctx.agent.reconfigure(ctx.config);
         console.log(pc2.green(t("cli.config_saved")));
       });
@@ -34368,8 +34376,8 @@ function registerMmaCommands(ctx) {
           return;
         }
         ctx.config.model = name;
-        const configPath = join49(ctx.configDir, "config.json");
-        saveConfig(ctx.config, configPath, dirname22(configPath));
+        const configPath = join50(ctx.configDir, "config.json");
+        saveConfig(ctx.config, configPath, dirname23(configPath));
         await ctx.agent.reconfigure(ctx.config);
         console.log(pc2.green(t("repl.model_set", { name })));
         return;
@@ -34393,8 +34401,8 @@ function registerMmaCommands(ctx) {
         return;
       }
       ctx.config.contextWindow = size;
-      const configPath = join49(ctx.configDir, "config.json");
-      saveConfig(ctx.config, configPath, dirname22(configPath));
+      const configPath = join50(ctx.configDir, "config.json");
+      saveConfig(ctx.config, configPath, dirname23(configPath));
       await ctx.agent.reconfigure(ctx.config);
       console.log(pc2.green(t("cli.context_set", { size })));
     }
@@ -34408,10 +34416,10 @@ function registerMmaCommands(ctx) {
       if (ctx.sessionManager && ctx.config.session.autoSave) {}
       ctx.agent.shutdown();
       const { loadConfig: loadConfig2 } = await Promise.resolve().then(() => (init_config2(), exports_config));
-      const { join: join50 } = await import("path");
+      const { join: join51 } = await import("path");
       const configDir = ctx.configDir;
       const baseDir = ctx.baseDir;
-      const projectConfigPath = join50(baseDir, ".mmrc");
+      const projectConfigPath = join51(baseDir, ".mmrc");
       const { config: freshConfig } = loadConfig2({ configDir, projectConfigPath });
       Object.assign(ctx.config, freshConfig);
       const { bootstrap: bootstrap2 } = await Promise.resolve().then(() => (init_bootstrap(), exports_bootstrap));
@@ -34765,21 +34773,21 @@ async function runConfigMigrate(ctx) {
   const { hasDomainFiles: hasDomainFiles3 } = await Promise.resolve().then(() => (init_domains(), exports_domains));
   const { loadConfig: loadCfg } = await Promise.resolve().then(() => (init_config2(), exports_config));
   const configDir = ctx.configDir;
-  const configPath = join49(configDir, "config.json");
+  const configPath = join50(configDir, "config.json");
   if (hasDomainFiles3(configDir)) {
     console.log(pc2.yellow(t("config.migrate_no_legacy")));
     return;
   }
-  if (!existsSync56(configPath)) {
+  if (!existsSync57(configPath)) {
     console.log(pc2.yellow(t("config.migrate_no_legacy")));
     return;
   }
   console.log(t("config.migrate_start"));
-  const { config } = loadCfg({ configDir, projectConfigPath: join49(configDir, ".mmrc") });
+  const { config } = loadCfg({ configDir, projectConfigPath: join50(configDir, ".mmrc") });
   saveConfig(config, configPath, configDir);
   const { renameSync: renameSync4, readdirSync: readdirSync19 } = await import("fs");
   renameSync4(configPath, configPath + ".bak");
-  const domainFiles = readdirSync19(join49(configDir, "config")).filter((f) => f.endsWith(".json"));
+  const domainFiles = readdirSync19(join50(configDir, "config")).filter((f) => f.endsWith(".json"));
   console.log(pc2.green(t("config.migrate_done", { count: String(domainFiles.length) })));
 }
 var version2, COMMAND_GROUPS;
@@ -34839,9 +34847,9 @@ init_config2();
 init_setup();
 init_i18n();
 init_colors();
-import { join as join48, dirname as dirname21 } from "path";
+import { join as join49, dirname as dirname22 } from "path";
 import { homedir as homedir16 } from "os";
-import { existsSync as existsSync55 } from "fs";
+import { existsSync as existsSync56 } from "fs";
 
 // src/cli/security-commands.ts
 init_bootstrap();
@@ -35472,12 +35480,92 @@ function createPluginCommand(program2) {
 // src/cli/commands.ts
 init_presets();
 init_version();
+
+// src/modules/updater/changelog-reader.ts
+import { readFileSync as readFileSync32, existsSync as existsSync51 } from "fs";
+import { dirname as dirname19, join as join44 } from "path";
+function readChangelog(packageName) {
+  try {
+    let dir = dirname19(import.meta.url);
+    if (dir.startsWith("file://")) {
+      dir = decodeURIComponent(dir.slice(7));
+    }
+    for (let i = 0;i < 10; i++) {
+      const pkgPath = join44(dir, "package.json");
+      if (existsSync51(pkgPath)) {
+        const pkg = JSON.parse(readFileSync32(pkgPath, "utf-8"));
+        if (pkg.name === packageName) {
+          const changelogPath = join44(dir, "CHANGELOG.md");
+          if (existsSync51(changelogPath)) {
+            return readFileSync32(changelogPath, "utf-8");
+          }
+          return null;
+        }
+      }
+      dir = dirname19(dir);
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function extractChangelogRange(changelog, fromVersion, toVersion) {
+  const lines = changelog.split(`
+`);
+  const sections = [];
+  let capturing = false;
+  let foundFrom = false;
+  for (const line of lines) {
+    const match = line.match(/^## \[(\d+\.\d+\.\d+)\]/);
+    if (match) {
+      const ver = match[1];
+      if (ver === fromVersion) {
+        foundFrom = true;
+        break;
+      }
+      if (capturing) {
+        sections.push("");
+      }
+      capturing = true;
+    }
+    if (capturing) {
+      sections.push(line);
+    }
+  }
+  if (!foundFrom)
+    return null;
+  return sections.length > 0 ? sections.join(`
+`).trim() : null;
+}
+function extractLatestChangelog(changelog) {
+  const lines = changelog.split(`
+`);
+  const sections = [];
+  let capturing = false;
+  let found = false;
+  for (const line of lines) {
+    const match = line.match(/^## \[(\d+\.\d+\.\d+)\]/);
+    if (match) {
+      if (found)
+        break;
+      capturing = true;
+      found = true;
+    }
+    if (capturing) {
+      sections.push(line);
+    }
+  }
+  return sections.length > 0 ? sections.join(`
+`).trim() : null;
+}
+
+// src/cli/commands.ts
 var version = readMmaVersion();
 function createProgram() {
   const program2 = 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");
   program2.command("init").description(t("cli.init")).action(async () => {
     const answers = await runSetup();
-    const configPath = join48(homedir16(), ".mma", "config.json");
+    const configPath = join49(homedir16(), ".mma", "config.json");
     const { config } = await bootstrap();
     config.provider.type = answers.provider;
     config.provider.baseUrl = answers.apiBase;
@@ -35517,12 +35605,12 @@ function createProgram() {
         config.security.paths.denied = [];
       }
     }
-    saveConfig(config, configPath, dirname21(configPath));
+    saveConfig(config, configPath, dirname22(configPath));
     console.log(t("cli.config_saved"));
   });
   const configCmd = program2.command("config").description(t("cli.manage_config"));
   configCmd.command("set").argument("<key>", t("cli.config_key")).argument("<value>", "Config value").description(t("cli.set_value")).action(async (key, value) => {
-    const configPath = join48(homedir16(), ".mma", "config.json");
+    const configPath = join49(homedir16(), ".mma", "config.json");
     const { config } = await bootstrap();
     const keys = key.split(".");
     let obj = config;
@@ -35542,7 +35630,7 @@ function createProgram() {
       obj[lastKey] = parseFloat(value);
     else
       obj[lastKey] = value;
-    saveConfig(config, configPath, dirname21(configPath));
+    saveConfig(config, configPath, dirname22(configPath));
     console.log(t("cli.set_done", { key, value }));
   });
   configCmd.command("show").description(t("cli.show_config")).action(async () => {
@@ -35552,24 +35640,24 @@ function createProgram() {
   configCmd.command("migrate").description(t("cli.migrate_config")).action(async () => {
     const { loadConfig: loadConfig2 } = await Promise.resolve().then(() => (init_config2(), exports_config));
     const { hasDomainFiles: hasDomainFiles3 } = await Promise.resolve().then(() => (init_domains(), exports_domains));
-    const configDir = join48(homedir16(), ".mma");
-    const configPath = join48(configDir, "config.json");
+    const configDir = join49(homedir16(), ".mma");
+    const configPath = join49(configDir, "config.json");
     if (hasDomainFiles3(configDir)) {
       console.log(pc2.yellow(t("config.migrate_no_legacy")));
       return;
     }
-    if (!existsSync55(configPath)) {
+    if (!existsSync56(configPath)) {
       console.log(pc2.yellow(t("config.migrate_no_legacy")));
       return;
     }
     console.log(t("config.migrate_start"));
-    const { config } = loadConfig2({ configDir, projectConfigPath: join48(configDir, ".mmrc") });
+    const { config } = loadConfig2({ configDir, projectConfigPath: join49(configDir, ".mmrc") });
     saveConfig(config, configPath, configDir);
     const bakPath = configPath + ".bak";
     const { renameSync: renameSync4 } = await import("fs");
     renameSync4(configPath, bakPath);
     const { readdirSync: readdirSync19 } = await import("fs");
-    const domainFiles = readdirSync19(join48(configDir, "config")).filter((f) => f.endsWith(".json"));
+    const domainFiles = readdirSync19(join49(configDir, "config")).filter((f) => f.endsWith(".json"));
     console.log(pc2.green(t("config.migrate_done", { count: String(domainFiles.length) })));
   });
   const model = program2.command("model").description(t("cli.manage_models"));
@@ -35609,10 +35697,10 @@ function createProgram() {
     console.log(t("cli.model_hint"));
   });
   model.command("use").argument("<name>", "Model name").description(t("cli.set_model")).action(async (name) => {
-    const configPath = join48(homedir16(), ".mma", "config.json");
+    const configPath = join49(homedir16(), ".mma", "config.json");
     const { config } = await bootstrap();
     config.model = name;
-    saveConfig(config, configPath, dirname21(configPath));
+    saveConfig(config, configPath, dirname22(configPath));
     console.log(t("cli.model_set", { name }));
   });
   model.command("certify").argument("<name>", "Model name").option("--provider-url <url>", t("cli.cert_provider_url")).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")).description(t("cli.certify")).action(async (name, cmdOpts) => {
@@ -35648,7 +35736,7 @@ function createProgram() {
     await uncertify2(name, config, process.cwd());
   });
   program2.command("context").description(t("cli.manage_context")).argument("<size>", "Context window size in tokens").action(async (size) => {
-    const configPath = join48(homedir16(), ".mma", "config.json");
+    const configPath = join49(homedir16(), ".mma", "config.json");
     const { config } = await bootstrap();
     const contextWindow = parseInt(size, 10);
     if (isNaN(contextWindow) || contextWindow < 1024) {
@@ -35656,7 +35744,7 @@ function createProgram() {
       return;
     }
     config.contextWindow = contextWindow;
-    saveConfig(config, configPath, dirname21(configPath));
+    saveConfig(config, configPath, dirname22(configPath));
     console.log(t("cli.context_set", { size: contextWindow }));
   });
   const provider = program2.command("provider").description(t("cli.manage_providers"));
@@ -35694,7 +35782,7 @@ function createProgram() {
     console.log(t("cli.base_url"), config.provider.baseUrl);
   });
   provider.command("use").argument("<name>", "Provider name").description(t("cli.set_provider")).action(async (name) => {
-    const configPath = join48(homedir16(), ".mma", "config.json");
+    const configPath = join49(homedir16(), ".mma", "config.json");
     const { config, agent } = await bootstrap();
     if (config.provider.entries && config.provider.entries.length > 0) {
       try {
@@ -35710,14 +35798,14 @@ function createProgram() {
     if (baseUrl) {
       config.provider.baseUrl = baseUrl;
     }
-    saveConfig(config, configPath, dirname21(configPath));
+    saveConfig(config, configPath, dirname22(configPath));
     console.log(t("cli.provider_set", { name }));
     if (baseUrl) {
       console.log(t("cli.provider_base_hint", { baseUrl }));
     }
   });
   provider.command("add").argument("<name>", "Provider type or label").option("--url <url>", "Base URL").option("--key <key>", "API key").option("--priority <n>", "Fallback priority (lower = tried first)").option("--context-window <n>", "Context window override for this entry").option("--rpm <n>", "Max requests per minute for this entry").option("--parallel <n>", "Max parallel tasks for this entry").description(t("cli.add_provider")).action(async (name, opts) => {
-    const configPath = join48(homedir16(), ".mma", "config.json");
+    const configPath = join49(homedir16(), ".mma", "config.json");
     const { config } = await bootstrap();
     const entries = Array.isArray(config.provider.entries) ? config.provider.entries : [];
     if (entries.length === 0) {
@@ -35749,7 +35837,7 @@ function createProgram() {
     });
     config.provider.entries = entries;
     config.provider.active = config.provider.active || config.provider.type;
-    saveConfig(config, configPath, dirname21(configPath));
+    saveConfig(config, configPath, dirname22(configPath));
     console.log(pc2.green(t("cli.provider_added", { name })));
     console.log(t("cli.provider_switch_hint"));
   });
@@ -35790,6 +35878,30 @@ function createProgram() {
   });
   createSecurityCommand(program2);
   createPluginCommand(program2);
+  program2.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) {
+      console.log(pc2.yellow(t("cli.changelog_not_found")));
+      return;
+    }
+    if (opts.from) {
+      const range = extractChangelogRange(changelog, opts.from, version);
+      if (!range) {
+        console.log(pc2.yellow(t("cli.changelog_not_found")));
+        return;
+      }
+      console.log(pc2.cyan(t("cli.changelog_range", { from: opts.from })));
+      console.log(range);
+    } else {
+      const latest = extractLatestChangelog(changelog);
+      if (!latest) {
+        console.log(pc2.yellow(t("cli.changelog_not_found")));
+        return;
+      }
+      console.log(pc2.cyan(t("cli.changelog_title", { version })));
+      console.log(latest);
+    }
+  });
   program2.argument("[prompt...]", "Prompt to execute").description("Run a single prompt").action((prompt) => {});
   return program2;
 }
@@ -36667,8 +36779,8 @@ class LineEditor {
 }
 
 // src/cli/repl.ts
-import { existsSync as existsSync57, readFileSync as readFileSync38, writeFileSync as writeFileSync22 } from "fs";
-import { join as join50 } from "path";
+import { existsSync as existsSync58, readFileSync as readFileSync39, writeFileSync as writeFileSync22 } from "fs";
+import { join as join51 } from "path";
 import { homedir as homedir17 } from "os";
 
 // src/cli/completer.ts
@@ -37495,10 +37607,10 @@ class Repl {
     this.envReport = envReport;
     this.execModule = execModule;
     this.slog = new SessionLogger(sessionManager, logger4);
-    this.configDir = configDir || join50(homedir17(), ".mma");
+    this.configDir = configDir || join51(homedir17(), ".mma");
     this.baseDir = baseDir || process.cwd();
     this.noAgentsMd = noAgentsMd === true;
-    this.historyPath = historyPath ?? join50(homedir17(), ".mma", "repl-history");
+    this.historyPath = historyPath ?? join51(homedir17(), ".mma", "repl-history");
     this.loadHistory();
     this.rl = process.stdin.isTTY ? new LineEditor({
       input: process.stdin,
@@ -37550,9 +37662,9 @@ class Repl {
     }));
   }
   loadHistory() {
-    if (existsSync57(this.historyPath)) {
+    if (existsSync58(this.historyPath)) {
       try {
-        const raw = readFileSync38(this.historyPath, "utf-8");
+        const raw = readFileSync39(this.historyPath, "utf-8");
         this.history = raw.split(`
 `).filter(Boolean).slice(-this.maxHistory);
       } catch {
@@ -37950,11 +38062,11 @@ ${t("image.clipboard_empty")}`));
       row(t("repl.agents_label"), pc2.red(t("repl.disabled")));
     } else {
       const agentsMdCandidates = [
-        join50(this.baseDir, "AGENTS.md"),
-        join50(this.baseDir, ".mma", "AGENTS.md"),
-        join50(this.configDir, "AGENTS.md")
+        join51(this.baseDir, "AGENTS.md"),
+        join51(this.baseDir, ".mma", "AGENTS.md"),
+        join51(this.configDir, "AGENTS.md")
       ];
-      const foundAgents = agentsMdCandidates.filter((p) => existsSync57(p));
+      const foundAgents = agentsMdCandidates.filter((p) => existsSync58(p));
       if (foundAgents.length > 0) {
         for (const p of foundAgents) {
           row(t("repl.agents_label"), pc2.dim(p));
@@ -37965,7 +38077,7 @@ ${t("image.clipboard_empty")}`));
     }
     const meta = this.sessionManager?.getActiveMeta();
     if (meta) {
-      const sessionPath = join50(this.configDir, "sessions", meta.id);
+      const sessionPath = join51(this.configDir, "sessions", meta.id);
       row(t("repl.session_label"), `${pc2.cyan(meta.name)} ${pc2.dim(`(${meta.id.slice(0, 12)})`)}  —  ${meta.messageCount} msgs  ${pc2.dim(sessionPath)}`);
     }
     const isTty2 = process.stdout.isTTY === true;
@@ -38080,8 +38192,8 @@ init_setup();
 init_config2();
 init_i18n();
 init_colors();
-import { existsSync as existsSync58 } from "fs";
-import { join as join52, dirname as dirname23 } from "path";
+import { existsSync as existsSync59 } from "fs";
+import { join as join53, dirname as dirname24 } from "path";
 import { homedir as homedir19 } from "os";
 
 // src/modules/updater/index.ts
@@ -38165,7 +38277,16 @@ class UpdaterModule {
       }));
       const install = await this.updater.install(result.latest);
       if (install.success) {
-        this.logger.info(t("updater.installed", { current: result.current, latest: result.latest }));
+        const changelog = readChangelog("micro-models-agent");
+        const latestEntry = changelog ? extractLatestChangelog(changelog) : null;
+        const changelogBlock = latestEntry ? pc2.cyan(`
+${t("cli.changelog_title", { version: result.latest })}
+`) + latestEntry : "";
+        this.logger.info(t("updater.installed", {
+          current: result.current,
+          latest: result.latest,
+          changelog: changelogBlock
+        }));
       } else {
         this.logger.warn(t("updater.install_failed", {
           current: result.current,
@@ -38186,9 +38307,9 @@ init_environment();
 init_data_sanitizer();
 init_i18n();
 import { appendFileSync as appendFileSync7, mkdirSync as mkdirSync21 } from "fs";
-import { join as join51 } from "path";
+import { join as join52 } from "path";
 import { homedir as homedir18 } from "os";
-var CRASH_LOG_DIR = join51(homedir18(), ".mma", "logs");
+var CRASH_LOG_DIR = join52(homedir18(), ".mma", "logs");
 var CRASH_LOG_FILE = "crash.jsonl";
 function formatCrashEntry(type2, err) {
   const message = err instanceof Error ? err.message : String(err);
@@ -38204,7 +38325,7 @@ function formatCrashEntry(type2, err) {
 function writeCrashEntry(dir, entry) {
   try {
     mkdirSync21(dir, { recursive: true });
-    appendFileSync7(join51(dir, CRASH_LOG_FILE), JSON.stringify(entry) + `
+    appendFileSync7(join52(dir, CRASH_LOG_FILE), JSON.stringify(entry) + `
 `, "utf-8");
   } catch {}
 }
@@ -38313,9 +38434,9 @@ async function main() {
     await updater?.waitForIdle();
     process.exit(exitCode);
   } else {
-    const mmaDir = join52(homedir19(), ".mma");
-    const legacyConfigPath = join52(mmaDir, "config.json");
-    let hasAnyConfig = existsSync58(legacyConfigPath);
+    const mmaDir = join53(homedir19(), ".mma");
+    const legacyConfigPath = join53(mmaDir, "config.json");
+    let hasAnyConfig = existsSync59(legacyConfigPath);
     if (!hasAnyConfig) {
       try {
         const { hasDomainFiles: hasDomainFiles3 } = await Promise.resolve().then(() => (init_domains(), exports_domains));
@@ -38378,7 +38499,7 @@ async function main() {
           config.security.paths.denied = [];
         }
       }
-      saveConfig(config, legacyConfigPath, dirname23(legacyConfigPath));
+      saveConfig(config, legacyConfigPath, dirname24(legacyConfigPath));
       await agent.reconfigure(config);
     }
     startAutoUpdate(config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "micro-models-agent",
-  "version": "0.56.1",
+  "version": "0.56.3",
   "description": "Micro Models Agent (MMA) — LLM agent harness for small models (Qwen3.5-9B, 32K-64K context)",
   "type": "module",
   "bin": {