micro-models-agent 0.56.0 → 0.56.2

package/CHANGELOG.md

@@ -0,0 +1,452 @@
+# Changelog
+
+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
+- **MoE**: live re-plan loop in `runWithMoE` — orchestrator re-plans on structural failures
+- **MoE**: scope expansion protocol (`scope_request`) for cross-expert file access
+- **MoE**: Esc/interrupt support in the MoE execution path
+- **MoE**: `input_from` cross-expert data flow for subtask dependencies
+- **LSP**: Angular language server support (`@angular/language-server` for `.html` in Angular workspaces)
+- **Tools**: syntax pre-validation and auto-fix for `write_file`/`edit_file`
+
+### Fixed
+- **Security**: SSRF via IPv6-mapped IPv4 and raw numeric hostnames
+- **Security**: command-validator blacklist bypasses (shell expansions, encoded chars)
+- **Security**: audit webhook retry queue drained forever (infinite loop + duplicate notifications)
+- **Core**: dangling `tool_calls` on interrupt — synthesized tool messages keep assistant/tool pairing
+- **Core**: live reasoning policy + `set_thinking` override integration
+- **Core**: deep-clone config defaults to prevent cross-session mutation
+- **Config**: preserve `provider.fallback` on hot-swap
+- **Tools**: path/scope escape holes in filesystem and read tools closed
+- **Tools**: clear timeout timer & abort listener after race settles; log discarded losers
+- **MCP**: stdio timer leaks + null deref after disconnect; added initialize handshake
+- **LSP**: spawn servers detached on POSIX so `killTree` reaches the whole chain
+- **Browser**: bridge leaked Chromium on SIGTERM and parent death
+- **UI**: diff LCS memory cap; one bad encrypted line no longer kills session history
+- **CLI**: `/config migrate` was unreachable
+- **MoE**: locale-independent artifact path + no retry on user abort
+
+## [0.55.1] - 2026-08-25
+
+### Fixed
+- **LLM**: NDJSON-tolerant stream parser for Ollama backends
+- **LLM**: mid-stream provider errors surfaced (Ollama generation failures)
+- **LLM**: `delta.reasoning` alias for thinking models
+- **LLM**: wire-level debug logging for diagnostics
+
+## [0.55.0] - 2026-08-25
+
+### Added
+- **Certification**: targeted re-run (`--scenarios <ids>`) with result merging
+- **Certification**: per-rep timeout (`--timeout <ms>` + per-scenario `timeoutMs`)
+- **Certification**: audit-gate bypass fix for `--exit-on-complete`
+
+### Fixed
+- **Certification**: stale-label wording (removed impossible user instruction)
+- **Dependencies**: typescript pinned to ^5.9 (TS7 preview breaks `@types/node`)
+
+## [0.54.0] - 2026-08-24
+
+### Added
+- **Certification**: global manifest shipped with package updates (`~/.mma/certifications.json`)
+- **Certification**: bundled manifest + startup sync from package
+
+### Fixed
+- **Certification**: marks only showed when running from repo root
+
+## [0.53.0] - 2026-08-24
+
+### Added
+- **Certification**: qwen3.5-9b certified 20/20
+- **Config**: `provider.maxCompletionTokens` option
+- **Certification**: label text in `mma model list` and REPL `/model`
+
+### Fixed
+- **Certification**: reasoning-heavy models truncated tool_call arguments at default 4096 cap
+- **Certification**: scenario 3.5 prompt disambiguation
+
+## [0.52.0] - 2026-08-23
+
+### Added
+- **Execution**: `FS_MUTATING_TOOLS` — plan auto-advance after bash/download/subagent/mcp/pipeline/browser tools
+- **Config**: `provider.maxCompletionTokens` plumbing through ProviderManager → agent
+
+### Fixed
+- **Execution**: small models create files via bash instead of `write_file`, stalling plans
+- **Execution**: `maxCompletionTokens` was never read from config
+
+## [0.51.0] - 2026-08-23
+
+### Added
+- **Plugin**: `HostBridge` interface for bidirectional agent communication
+- **Plugin**: `onTurnEnd(ctx, TurnSummary)` hook — dispatched once per completed run
+- **Plugin**: `web-ui` example plugin — browser-based chat with SSE streaming
+- **CLI**: REPL bridge wiring for web-ui submit/interrupt
+
+### Fixed
+- **REPL**: `/config migrate` unreachable
+
+## [0.50.3] - 2026-08-22
+
+### Fixed
+- **UI**: REPL line editor scroll-proof rendering (absolute anchoring via DSR query)
+
+## [0.50.2] - 2026-08-22
+
+### Fixed
+- **LLM**: idle stream timeout increased 60s → 180s (LM Studio buffering)
+- **LLM**: stall diagnosis with dedicated message for SSE buffering
+- **LLM**: truncation no longer masquerades as empty response
+- **LLM**: recoverable LLM errors fed back into context instead of dying
+- **Execution**: bash flailing detector (≥4 failed bash attempts in last 6)
+
+## [0.50.1] - 2026-08-21
+
+### Fixed
+- **Security**: no longer silently overrides explicit user opt-out
+- **Lint**: skips missing lint binary (was appending error to every write)
+- **Stuck**: anti-spam for stuck-warnings (dedup via key, decay per-tool counters)
+- **Plan**: unified progress counting (done+skipped as settled)
+- **Plan**: bulk `steps[]` rewrite guarded on progressed plans
+- **Plan**: archived plans answer read-only
+- **Process**: usage hints for `process_kill`/`process_log` without id
+
+## [0.50.0] - 2026-08-21
+
+### Added
+- **Provider**: health probe (`probeProviders()` + `mma provider check`)
+- **Provider**: code-only capability routing (`ProviderManager.pickFor()`)
+- **Provider**: per-entry isolation + priority fallback order
+- **Pricing**: per-provider cost attribution + breakdown
+
+### Fixed
+- **Provider**: transparent failover on 429/5xx/network errors
+
+## [0.49.0] - 2026-08-20
+
+### Fixed
+- **REPL**: stale-plan leaks — plan state no longer persists across sessions
+- **REPL**: plan checklist prints only on plan/todo tool-end events
+- **Plan**: `PlanStore` is single source of truth for UI consumers
+
+## [0.48.3] - 2026-08-20
+
+### Fixed
+- **Hallucination**: dotfile false-positive (`.prettierrc.json` extracted as `prettierrc.json`)
+
+## [0.48.2] - 2026-08-20
+
+### Fixed
+- **REPL**: stale plan printed on first agent run of a session
+
+## [0.47.0] - 2026-08-19
+
+### Added
+- **Session**: startup diagnostics logging (environment, LSP probe, baseline typecheck)
+- **Session**: `logBaselineTypecheck()` for post-mortem visibility
+
+## [0.46.1] - 2026-08-19
+
+### Fixed
+- **LLM**: connection-break hardening (stream-level retry, no-data timeout, `[DONE]` tracking)
+- **LLM**: non-streaming timeout (was missing, could hang forever)
+- **Config**: `retry.maxStreamRetries`, `retry.noDataTimeoutMs` options
+
+## [0.46.0] - 2026-08-19
+
+### Added
+- **Provider**: multi-provider + hot-swap + per-message provenance
+- **Provider**: `ProviderManager` with entry-based config
+- **CLI**: `mma provider add/list/use`
+- **REPL**: `/provider list/use`
+
+### Fixed
+- **Path**: `safeResolvePath` POSIX bug (absolute paths re-resolved against baseDir)
+
+## [0.45.0] - 2026-08-18
+
+### Added
+- **Provider**: provider module Phase 1 (registry, presets, `createProvider()`)
+- **Provider**: `openrouter` preset
+- **Setup**: wizard menu built from `BUILTIN_PROVIDERS`
+
+## [0.44.0] - 2026-08-18
+
+### Added
+- **Plugins**: folder plugins (subdirectory with entry file)
+- **Plugin**: `trace-server` split into folder plugin
+
+### Fixed
+- **Plugin**: template-literal page inlining broke `\n` in JS strings
+
+## [0.43.2] - 2026-08-17
+
+### Fixed
+- **Execution**: plan done-gate on known compile failures (typecheck gate)
+- **Bootstrap**: live getters for `sessionId`/`sessionContext` after session switch
+- **Edit**: `edit_file` "String not found" hint to `read_file` first
+
+## [0.43.1] - 2026-08-17
+
+### Fixed
+- **Agent**: session-interrupt no longer renders tool results after "Session ended"
+- **Executor**: `onAfterTool` plugins skipped when signal is aborted
+- **Lint**: abortable syntax checks on Esc
+
+## [0.43.0] - 2026-08-17
+
+### Added
+- **Plan**: `plan delete <id>` + `plan purge` actions
+- **Plan**: `abort` honors `id` parameter
+- **Plan**: `replan` renumbers ids for kept steps
+- **Audit**: `resolveTestCommand` picks the project's real test runner
+
+### Fixed
+- **Plan**: `switch` to already-active plan is a no-op
+- **Plan**: final audit runs for a completed plan
+- **Plan**: evidence-based plan nudge (replaces iteration counter)
+- **Plan**: `checkPlanAlignment` scans path arguments only
+- **Plan**: `isDepsStep` requires a package-manager verb
+- **Plan**: auto-advance resolves nested files
+
+## [0.42.0] - 2026-08-16
+
+### Added
+- **Execution**: automatic error web search (≥5 same-error repeats → web search → inject results)
+- **Config**: `errorWebSearch` section
+
+### Fixed
+- **Execution**: `onAfterTool` double-counted typecheck + failure errors
+
+## [0.41.1] - 2026-08-16
+
+### Fixed
+- **LSP**: `typescript@5` pin + `--yes` for npx
+- **LSP**: sequential probing (waves) to avoid npx cache lock contention
+- **LSP**: stale config normalization
+- **LSP**: Windows process leak in `shutdown()`
+- **REPL**: non-blocking LSP banner
+- **Bootstrap**: lazy startup health check
+
+## [0.41.0] - 2026-08-15
+
+### Added
+- **REPL**: live plan checklist with progress bar
+- **UI**: tool-to-step binding (`← step N` suffix in tool headers)
+- **UI**: background command output preview
+
+## [0.40.1] - 2026-08-15
+
+### Fixed
+- **LSP**: broken package names (`vscode-html-languageserver` → `vscode-langservers-extracted`)
+
+## [0.40.0] - 2026-08-15
+
+### Added
+- **Tools**: tool-set narrowing (on-demand enable via `enable_tools`)
+- **Config**: `tools.defaultTags` + `tools.enableOnDemand`
+- **Tools**: `alwaysOn` flag for structural tools
+
+## [0.39.1] - 2026-08-14
+
+### Fixed
+- **Plugins**: dedup by version, compatibility gate, source tracking
+- **CLI**: `mma plugins list` command
+
+## [0.38.0] - 2026-08-14
+
+### Added
+- **LSP**: `lsp_check` tool for on-demand diagnostics
+- **Plan**: `plan create` guard (blocks when active plan has progress)
+
+### Fixed
+- **Context**: compaction summary carries plan + read state
+- **Browser**: bridge path resolution in bundled dist
+
+## [0.37.0] - 2026-08-13
+
+### Added
+- **Plugins**: folder plugin support in `PluginLoader`
+
+### Fixed
+- **Plugin**: template-literal page inlining broke `\n` in JS
+
+## [0.36.3] - 2026-08-13
+
+### Fixed
+- **UI**: REPL paste fix (batch single-render, CRLF collapse)
+
+## [0.36.2] - 2026-08-13
+
+### Fixed
+- **Updater**: silent logger, one-shot `process.exit()` killed background install, semver-aware check
+
+## [0.36.1] - 2026-08-13
+
+### Fixed
+- **Audit**: nested-file resolution, non-zero test run blocks
+- **Browser**: bridge diagnostics + one-shot restart
+- **LSP**: per-server disable + initialize retry + CSS timeout
+- **Bash**: npm exec hint
+
+## [0.36.0] - 2026-08-12
+
+### Added
+- **Plan**: model-declared `kind: "create"|"delete"` for steps
+- **Execution**: `FS_MUTATING_TOOLS` for plan auto-advance
+- **Config**: `provider.maxCompletionTokens` option
+
+### Fixed
+- **Context**: compaction preserves session `mission`
+- **Context**: deleted files leave compaction `[Files:]` list
+- **Audit**: final audit runs real `tsc --noEmit --skipLibCheck`
+- **Bash**: repeated forbidden Windows commands hard-stopped after 2 failures
+
+## [0.35.5] - 2026-08-12
+
+### Fixed
+- **Execution**: plan-alignment phantom paths (domains/extensions treated as files)
+- **Execution**: hint/recovery dedup in `StuckDetector`
+
+## [0.35.3] - 2026-08-11
+
+### Fixed
+- **LSP**: workspace root resolved from edited file's project
+- **Audit**: skipped steps treated as terminal
+- **Bash**: Windows hint keys on original command word
+- **Tools**: boundedOutput tools never budget-truncated
+
+## [0.35.0] - 2026-08-11
+
+### Added
+- **Tools**: `download_file` tool for binary file downloads
+
+## [0.34.0] - 2026-08-10
+
+### Added
+- **Indexer**: project profile (`[Stack: ...]` summary from manifest)
+- **Indexer**: dynamic map refresh inside sessions
+
+## [0.33.3] - 2026-08-10
+
+### Fixed
+- **Audit**: nested-file resolution (basename + path-suffix match)
+- **Plan**: `plan show` honors `id` parameter
+- **Context**: compaction interval reset per user turn
+- **Context**: `extractFacts` captures `edit_file` paths + Windows drive-letter paths
+- **Execution**: stuck detector read-only loop detection
+- **Read**: default limit 15 → 300 lines
+- **LSP**: `spawn` on Windows (`.cmd` shim resolution)
+- **Todo**: `todo add` tracks subtasks, `todo done` marks individual sub-task
+- **Memory**: learns repeated per-tool failures (≥3×)
+- **Context**: compaction preserves user's task
+
+## [0.33.2] - 2026-08-09
+
+### Fixed
+- **UI**: REPL conversation layout (user/agent message dividers)
+- **Tools**: `isFilePathLike` uses allow-list of file extensions
+
+## [0.33.1] - 2026-08-09
+
+### Fixed
+- **UI**: REPL line editor redraw fix (no duplicated multi-line input)
+- **Tools**: `web_fetch`/`web_browse` description clarifications
+
+## [0.33.0] - 2026-08-09
+
+### Added
+- **RLM**: pass-by-reference sub-agent results (`ArtifactStore`)
+- **RLM**: chunked parallel queries (`chunk_query` tool)
+- **Config**: `subagent.resultMode`, `maxSummaryChars`, `artifactsDir`, `stableSystemPrompt`
+
+## [0.32.0] - 2026-08-08
+
+### Added
+- **Browser**: driver abstraction (`PlaywrightDriver` + `BridgeDriver`)
+- **Browser**: Node bridge for Bun compatibility
+- **Config**: `browser.maxConsoleLineChars`
+
+## [0.31.0] - 2026-08-08
+
+### Added
+- **Security**: session file encryption (AES-256-GCM)
+- **Security**: audit notifications (file + webhook)
+- **Security**: security policies (strict/balanced/permissive)
+- **CLI**: `mma security` commands
+
+## [0.30.0] - 2026-08-07
+
+### Added
+- **Execution**: final audit gate (runs `bun test` for verification steps)
+- **Execution**: `detectTestResults()` auto-verification in bash
+
+### Fixed
+- **Execution**: empty-CLI entry-point hint
+- **Bash**: Windows anti-patterns documentation
+
+## [0.29.0] - 2026-08-07
+
+### Added
+- **Bash**: smart UTF-8/OEM line decoding (fixes Cyrillic on Windows)
+- **Bash**: behavior-based background detection
+- **Bash**: stuck-detector bash awareness
+
+## [0.28.0] - 2026-08-06
+
+### Fixed
+- **Agent**: double-Esc interrupt fix (Bun readline keypress collapsing)
+- **Agent**: abortable in-flight LLM requests on interrupt
+- **UI**: clipboard paste hint
+
+## [0.27.0] - 2026-08-06
+
+### Fixed
+- **Security**: Windows hardening
+- **Hallucination**: fixes
+
+## [0.26.0] - 2026-08-05
+
+### Added
+- **UI**: opencode-style inline tool headers (`ui.toolStyle`)
+- **UI**: model commentary next to tool calls (`ui.toolComments`)
+- **UI**: diffs without background color
+
+## [0.25.0] - 2026-08-05
+
+### Added
+- **LSP**: LSP module (typescript, CSS, HTML, JSON, Python, Rust, Go)
+- **Execution**: audit gate language-agnostic
+- **Bash**: Windows command hints
+
+## [0.24.0] - 2026-08-04
+
+### Added
+- **Context**: quality formula upgrade (token load + compaction loss + error density + freshness)
+- **Read**: display mode (show only header in REPL, full content to LLM)
+
+## [0.23.0] - 2026-08-04
+
+### Added
+- **Certification**: model certification module (`mma model certify`)
+- **CLI**: cert checkmarks in model lists
+
+## [0.22.0] - 2026-08-03
+
+### Added
+- **Security**: `enabled` flag (disabled by default)
+- **CLI**: init/first-run apply wizard security answers
+- **Prompt**: system prompt & recovery messages cleanup

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,31 @@ 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) => {
+    console.error("[DEBUG] changelog action called");
+    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 +36780,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 +37608,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 +37663,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 +38063,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 +38078,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 +38193,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 +38278,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 +38308,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 +38326,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 {}
 }
@@ -38258,6 +38380,9 @@ async function main() {
   const jsonMode = opts.json === true;
   const reasoningLevel = opts.reasoning;
   const isSubcommand = program2.args.length > 0 && cmdNames.has(program2.args[0]);
+  console.error("[DEBUG] program.args:", program2.args);
+  console.error("[DEBUG] cmdNames:", [...cmdNames]);
+  console.error("[DEBUG] isSubcommand:", isSubcommand);
   if (isSubcommand) {
     return;
   }
@@ -38313,9 +38438,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 +38503,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.0",
+  "version": "0.56.2",
   "description": "Micro Models Agent (MMA) — LLM agent harness for small models (Qwen3.5-9B, 32K-64K context)",
   "type": "module",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "files": [
     "dist/",
-    "bin/"
+    "bin/",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=20"