micro-models-agent 0.60.1 → 0.61.1

package/CHANGELOG.md

@@ -1,584 +1,601 @@
-# 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.60.1] - 2026-09-15
-
-### Fixed
-- **Silent prompt-overflow summarization**: the startup dry-run warns that AGENTS.md / the project map "will be summarized before the first run", but the actual summarization ran with no notice — the first prompt appeared to hang while a local model rewrote a large AGENTS.md. `resolvePromptOverflow` now emits (en+ru, `prompt.overflow.*`): a "compressing N block(s)…" line before it starts, a per-block "summarizing \"label\" (N → M tok)…" line before the model call, a "truncating …" line on the fallback, and a failure line before falling back to truncation.
-- **Hardcoded English startup logs**: model auto-load success/failure, reasoning probe result, project indexing start/finish/failure, unreadable index entries and background-processes-killed-on-shutdown were untranslated; they now use `env.*` keys (en+ru). Project indexing now announces start and completion (`Indexed N file(s)`), so a slow first walk no longer pauses startup silently.
-
-## [0.60.0] - 2026-09-15
-
-### Added
-- **`session_info` tool** (`src/tools/session-info.ts`, `alwaysOn`): the model can now answer questions about the session it is running in — id, name, model, provider, context window, message count, timestamps and **live context usage** (`tokens / history budget (percent)` from `ContextManager.getSnapshot()`). Reads live metadata through a new `sessionManager` getter on `ToolContext` (like `sessionId`/`sessionContext`), so a REPL `/new` or `/resume` is reflected immediately. Previously the model reported having "no access to session metadata".
-- **Session prompt block** (`session.info_full`, en+ru): the system prompt carries a compact `[Session: "name" (id) | model: … | context: … tokens]` line so session identity is available passively as well.
-- **Project-map command**: `mma map [summary|refresh|find <query>]` (CLI) and `/map [summary|refresh|find <query>]` (REPL) let the user inspect the index directly — `summary` prints the exact text injected into the system prompt, `refresh` re-indexes, `find` searches by path or exported symbol. Shared implementation in `src/modules/indexer/map-command.ts` (also used by the `project_map` tool for `find`).
-- **Multi-language index**: symbol extraction was TS/JS-only and the extension whitelist stopped at 10 types. New `src/modules/indexer/symbols.ts` is a data-driven registry — adding a language is one rule plus extensions. It now indexes and extracts symbols for TypeScript/JavaScript, Python, Rust, Go, Java, Kotlin, C#, Ruby, PHP, Swift, Scala, C/C++, Shell and Lua (plus data formats: JSON, Markdown, YAML, TOML, XML, HTML/CSS); symbols are deduped and capped at 40 per file. `map-select.ts` now reuses `isCodeLanguage()` instead of its own list.
-
-### Fixed
-- **Session metadata never reached the model**: `SessionModule.getSystemPromptBlock()` was collected once during bootstrap, but the session is created during that same bootstrap with `messageCount === 0`, so the block was always `null`. It is now collected through `getDynamicPromptBlocks`; content is deliberately limited to stable per-session fields (no message count) so the system prompt does not mutate every turn and the prefix KV-cache survives.
-- **Prompt-overflow messages not localized**: the overflow warnings emitted by `agent.ts` and the startup check in `bootstrap.ts` were hardcoded English; they now use `t("prompt.overflow.*")` and respect the configured locale (en+ru). The model-facing hint block stays English by design.
-- **Project map showed no source files**: the map listed the first 100 files in `readdir` walk order, which on a real workspace can be entirely docs/config/tests — on this repo the first 100 walked files contained **zero** `src/` entries, so the model had no idea about the project's code structure. New `selectMapFiles` (`src/modules/indexer/map-select.ts`) ranks source above tests above docs/config, puts the densest source directory first (no directory names hardcoded), drops lockfile noise, and sorts deterministically (KV-cache); the listing is capped at 80 files. The index still contains every file, so `project_map find` is unaffected.
-- **Indexer swallowed virtualenvs and other vendor trees**: `IGNORE_DIRS` was Node-centric (`node_modules`, `dist`, `build`, `.mma`, `coverage`), so a Python `venv/` (thousands of dependency files) was indexed and could crowd the map out. The list now covers Python (`venv`, `.venv`, `env`, `virtualenv`, `__pycache__`, `.pytest_cache`, `.mypy_cache`, `.ruff_cache`, `.tox`, `site-packages`), Rust (`target`), Go/PHP/Ruby (`vendor`, `.bundle`), JVM (`.gradle`, `out`), .NET (`obj`), Apple (`pods`, `deriveddata`), VCS/IDE (`.hg`, `.svn`, `.idea`, `.vscode`) plus the original Node entries. Matching is case-insensitive and the watcher now matches whole path **segments** instead of substrings, so short names (`env`, `out`, `obj`) cannot black out `environment.ts` or `about/`.
-
-## [0.59.0] - 2026-09-05
-
-### Added
-- **Instructions overflow handling**: AGENTS.md and the project map that exceed the system-prompt budget are no longer silently dropped — they are summarized by the LLM into the remaining budget (disk-cached in `<project>/.mma/cache/prompt-summaries`, invalidated by file edits/budget changes) or truncated with a marker; a small essential hint block tells the model what was compressed and to `read_file` the full source
-- **Startup overflow warning**: bootstrap dry-runs the system budget with the real block set and warns the user when instructions/project map will not fit, with a concrete fix — `mma context <N>` for a global `contextWindow`, or an edit of `provider.entries[].contextWindow` in `config/provider.json` when the active entry overrides it
-- **Context probe**: at startup MMA asks LM Studio's native API for the context length the model is actually loaded with and compares it with the configured `contextWindow` — warning on overflow risk (no auto-clamp, user decides), info suggestion when the model supports more; result logged as a `context_probe` session entry
-- **Config**: `instructions.summarize` (default `true`) to disable LLM summarization (truncation fallback only)
-
-## [0.58.2] - 2026-09-01
-
-### Fixed
-- **Stale i18n in published package**: `build:copy-assets` did not refresh `dist/i18n/en.json`/`ru.json`, so the 0.58.1 release shipped the old startup-check wording in the standalone JSON files (only `dist/main.js` had the fix). The copy step now ships the current dictionaries.
-
-## [0.58.1] - 2026-09-01
-
-### Fixed
-- **Startup check overreach**: the `lsp.startup_header` prompt block instructed the model to "fix these before continuing", overriding `SCOPE DISCIPLINE` — the 9B model started fixing pre-existing project errors the user never asked about (and skipped clarifying questions). The block is now informational (baseline only): errors are listed but the model is told to ignore them unless the current request is about them (en+ru).
-
-## [0.58.0] - 2026-08-31
-
-### Added
-- **MoE experts**: dynamic expert registry — `config.experts` (with optional `ExpertConfig.description`) is rendered into the MoE planner prompt instead of a hardcoded code/research/browser/vision list (fallback: `tool_tags`)
-- **MoE orchestrator provider**: `OrchestratorClient` builds its provider through `ProviderManager` — per-entry `contextWindow`/`retry`/`rateLimits` and failover entries are honored; `orchestrator.contextWindow` is the global fallback (legacy `{type,baseUrl,apiKey}` configs keep working)
-- **MoE success criteria**: machine-readable `success_criteria` (`file-exists:<path>`, `substring-in-file:<path>:<text>`, `command-exit-0:<cmd>`) verified by `StepVerifier.verifySubtaskCriteria` before merge; LLM-only criteria surface as warnings in the Router context
-- **MoE selective re-plan**: `executePlan(plan, {skipIds, carriedResults})` — already-succeeded subtasks are carried over across re-plan cycles, only failed/new subtasks re-execute
-- **MoE observability**: `moe_plan` / `moe_subtask` / `moe_replan` / `moe_verify` events written to `session.jsonl` (visible in `mma session show`); token usage aggregated per `expert_tag` (`MoEExecutor.getUsageByTag`); sub-agents receive the real session id instead of the hardcoded `"moe"`
-- **MoE cert scenarios**: `5.2-moe-parallel-waves` and `5.3-moe-read-after-write` (tag `moe`, timeoutMs 600_000)
-- **ToolResult.usage**: sub-agent token usage propagated to the MoE executor for cost attribution
-
-### Changed
-- **Reasoning policy baseline**: configurable via `reasoning.baseline` (default `medium`) — the auto policy's quiet-iteration level is no longer hardcoded, so trivial Q&A turns can start at `low`
-
-### Fixed
-- **MoE hang**: sub-agents spawned by the `subagent` tool re-entered `runWithMoE` when the parent config had `moe.enabled=true` — each MoE sub-agent planned its own subtasks and spawned nested sub-agents recursively (bounded only by `maxRecursionDepth`), hanging execution for many minutes with zero progress events. Sub-agents now always run the plain single-agent loop (`moe` is a top-level orchestration mode only).
-- **MoE fallback visibility**: missing `orchestrator.model` with `moe.enabled=true` now logs a WARN with a fix hint instead of a debug-only message that made silent fallback to single-agent invisible.
-- **CLI one-shot commands hang**: `config`, `session`, `model`, `provider`, `context`, `security`, `plugins`, `changelog` printed their result but never exited — bootstrap leaves open handles (reasoning-probe fetch, indexer) and only the prompt/REPL paths called `process.exit`. Subcommand roots now exit via a `postAction` hook (verified: `session list` 2.7s / exit 0, chained `config set` persists correctly).
-- **Repeated tool calls**: identical `(tool, args)` repeat now injects a nudge into context in ALL modes — previously the nudge was gated behind `--exit-on-complete`, so interactive runs silently burned iterations re-running the same command (observed: duplicate `node sum.js` verification back-to-back).
-- **Perfectionism cycle**: repeated mutations of the SAME target (same file via `edit_file`/`write_file`, same bash command, same `plan`/`todo` action) with varying arguments now inject a finalize-nudge after 5 occurrences — the consecutive-duplicate guard cannot see this pattern (args differ each time; observed: 20+ polish iterations after the task was already complete, then 10+ bookkeeping churn iterations after an audit rejection). The nudge lands AFTER tool results, so `assistant(tool_calls) → tool(results) → user(nudge)` pairing stays valid.
-- **Audit gate friction (evidence-based auto-close)**: pending plan steps whose every file-like token resolves to an existing file are auto-closed by the final audit with a note — small models routinely finish the work but forget `plan update` bookkeeping, and the gate then rejected correct answers burning all retry budget. Steps without file tokens or with missing files stay pending (honest).
-- **Audit rejection guidance**: the audit gate's `<system-summary>` now names the resolution paths (mark done / skipped / re-plan) in en+ru instead of a bare "continue working" — model plan-drift after a rejection (wrong file names, changed approach) is common for 9B and the old message did not point at the fix.
-- **LSP false positives without type env**: `lsp_check` suppresses module-resolution diagnostics when the project root has no `tsconfig.json`/`jsconfig.json`/`node_modules` and reports an inconclusive note instead — phantom `Cannot find module 'fs'` / `Cannot find name '__dirname'` errors made the model abandon a working `.ts` approach for `.js` and spiral into plan drift.
-- **Windows Unix-command hints**: `bash` hint list and the module-side forbidden set now cover `sed`/`awk`/`uniq`/`xargs`/`cut`/`tr`/`basename`/`dirname`/`export`/`source`/`sleep`/`env` (both lists kept consistent) — the 9B model keeps reaching for Unix tools in cmd.exe.
-- **Tool visibility narrowing**: `chunk_query`, `download_file`, `mcp_call`, `pipeline_run` no longer visible by default — they moved behind `enable_tools` (`research`/`shell` tags); the default visible set drops from 23 to 19 schemas, cutting tool tokens on every turn.
-- **Tests**: replaced process-global `vi.mock` with DI seams (`AgentDeps.runWithMoEOverride`, `ToolContext.agentFactory`) — Bun module mocks leak across test files in the same worker; full suite is now green by default (1803 pass / 0 fail).
-- **Docs**: AGENTS.md / testing.md — warn that `mma` resolves the globally installed package (stale `dist/`) when run outside the repo root, silently ignoring `src/` changes; always run from the repo root with `-d <sandbox>` and verify the version in the `Environment:` line.
-
-## [0.57.2] - 2026-08-30
-
-### Changed
-- **KV-cache**: plan block removed from system prompt; plan status now injected into `<system-summary>` envelope after every tool batch. System prompt is immutable per session — local backends retain prefix cache.
-- **Provenance**: provider entry resolution uses active entry label, not bare `provider.type`
-- **Reasoning signals**: `consecutiveToolSuccesses` and `isRepetitive` now feed real values to the reasoning policy (were hardcoded)
-- **Token estimation**: tool-def token estimate in agent loop uses `estimateTokens()` instead of flat `/4`
-- **Agent split**: `agent.ts` 1550→950 lines; 10 extracted modules (`loop-state`, `compaction`, `tool-batch`, `hallucination-gate`, `audit-gate`, `reasoning-resolver`, `token-tracker`, `context-renderer`, `tool-output`, `constants`)
-- **Plan-tool**: `plan-tool.ts` 741→232 lines; per-action handlers in `plan-actions.ts`
-- **CLI**: `createProgram` 513→thin orchestrator; `registerMmaCommands` 470→8 lines (5 per-domain registers)
-- **Bash handler**: `bash.ts` 236→~100 lines (`resolveBashSecurityConfig`, `decorateCommandOutput`)
-- **Orchestrator**: reuse `parseChunks` instead of hand-rolled `any[]` aggregation; `createPlan` uses own `parseJSON`; constructor deduplicated via `createProviderInstance`
-- **Shared utils**: `src/utils/` with `errMsg()`, `sleep()`, `truncate()`, `backoffDelay()`
-- **errMsg**: replaces 23 occurrences of `e instanceof Error ? e.message : String(e)` across 12 files
-
-### Fixed
-- **chunk_query**: one failing chunk no longer kills the entire query; per-chunk `catch` → `[FAILED]`
-- **chunk_query**: synthesis prompt capped at 20K chars with `[TRUNCATED]` marker
-- **chunk_query**: `AbortSignal` propagated to `chatText` for cancellation support
-- **Executor**: `failFast` cleanup guard prevents nested scope clobbering
-- **probe.ts**: transient errors (network/auth) no longer cached as "reasoning not supported" for 24h; returns `null` → caller skips cache
-- **LSP**: startup timeout unified on `DEFAULT_TIMEOUT` (15000) instead of conflicting hardcoded 10000
-- **Browser**: `BridgeResponse.data` typed (was `any`)
-- **Agent**: `Agent.runTool()` public API replaces `(ctx.agent as any).deps` reach-in; `/reload` no longer mutates readonly context
-- **LSP /lsp check**: fixed latent bug where `.execute()` was called with `.executeByName` signature
-
-### Added
-- **Plan Reminder**: static `[Plan Reminder]` block in system prompt (never mutates)
-- **Documentation**: reentrancy warning on `executeByName()`, `PlanResult` JSDoc
-- **Tests**: `probe.test.ts` (6 cases), `command-suggest.test.ts`, `providers-factory.test.ts`, `subagent-tool.test.ts`, `agent-moe-write.test.ts`, `chunk-query.test.ts`
-- **probe.ts**: `null` return for transient errors; bootstrap skips cache on `null`
-- **Execution-plugin**: `resetStepFlags`/`resetPlanState` helpers (dedup 3 inline reset blocks)
-- **Security-policies**: `comparePolicies` typed (`keyof SecurityConfig` replaces `as any`)
-
-### Removed
-- **Browser**: dead `buildWaitScript` export (never imported)
-
-## [0.57.1] - 2026-08-28
-
-### Fixed
-- **Publish**: republish after version bump
-
-## [0.57.0] - 2026-08-28
-
-### Changed
-- **MCP**: lazy connect — server connections deferred to first tool call. Startup no longer blocks on unreachable MCP servers (e.g. context7 offline). Discovery runs in background with 5s timeout.
-- **Updater**: `checkOnStart` and `autoInstall` disabled by default. Reduced `waitForIdle` timeout from 130s to 10s.
-- **Config**: `updater.checkOnStart` default changed from `true` to `false`
-
-### Added
-- **MCP**: HTTP request timeouts (10s) on `connectSSE`, `listToolsHTTP`, `callToolHTTP`
-- **MCP**: `failedServers` tracking — servers that fail discovery are not retried
-- **MCP**: placeholder `connect` tool for not-yet-discovered servers (LLM can trigger lazy discovery)
-- **Reasoning**: persistent disk cache (`~/.mma/reasoning-cache.json`) with 24h TTL — avoids re-probing LLM on every restart
-
-## [0.56.5] - 2026-08-27
-
-### Fixed
-- **Hallucination**: `FactualCheck` now receives deleted files from `ConsistencyCheck` — no longer false-positives on files that were intentionally deleted in the same session
-
-## [0.56.4] - 2026-08-27
-
-### Fixed
-- **Tools**: `list_dir` now filters `.mma/`, `node_modules/`, `.git/`, `dist/`, `build/`, `coverage/` from directory listings (consistent with indexer)
-- **Hallucination**: `dotfileVariants` now tries dot-prefixing each directory component, not just basename (fixes false positive on `.mma/index-cache.json` → `mma/index-cache.json`)
-
-## [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
+# 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.61.1] - 2026-09-16
+
+### Fixed
+- **OpenCode Go rejected every request**: `/chat/completions` returned `400 MissingSessionID` because the OpenAI-compatible provider sent no `x-opencode-session` header. The provider now sends the live session id (threaded through `ProviderOptions` → `ProviderManager` → `Agent`/`bootstrap`, plus the MoE orchestrator) and a `micro-models-agent/<version>` User-Agent on every chat and `listModels` request.
+- **Dev runs self-updated the global install**: running from TypeScript sources (`bun run mma`, `bun --watch src/cli/main.ts`) read the checkout's `package.json` version and `npm install -g`'d the published one over the user's install. The background updater is now skipped when the entry is a TS source; real installs (`dist/main.js` via `bin/mma.mjs`) still update.
+
+## [0.61.0] - 2026-09-15
+
+### Added
+- **Budget share controls**: `mma context --system <f>` / `--reserve <f>` and REPL `/context system <f>` / `reserve <f>` set `contextBudget.systemPrompt` / `responseReserve` (validated 0.05–0.9, system + reserve < 0.95). `mma context` and `/context` with no argument now print the budget breakdown (system / reserve / history in tokens and %). `mma config set contextBudget.systemPrompt <f>` keeps working.
+
+### Changed
+- **Overflow fix advice**: the "system prompt exceeds budget" warning no longer only snaps to a coarse standard context size — a 32K project was jumping straight to `131072`, which looked arbitrary and was often unusable on a local model. The hint (`prompt.overflow.hint_*`, en+ru) now states the raw requirement (`needs ~N system tokens; current budget: W × f = B`) and both levers: raise `contextWindow` to the exact minimum (with the standard size) **or** keep the window and raise `contextBudget.systemPrompt` to the required share (`mma context --system <f>`).
+
+### Fixed
+- **`mma context` ignored `MMA_CONFIG_DIR`**: it saved to a hardcoded `~/.mma/config.json`; it now writes to the config dir resolved by bootstrap.
+
+## [0.60.1] - 2026-09-15
+
+### Fixed
+- **Silent prompt-overflow summarization**: the startup dry-run warns that AGENTS.md / the project map "will be summarized before the first run", but the actual summarization ran with no notice — the first prompt appeared to hang while a local model rewrote a large AGENTS.md. `resolvePromptOverflow` now emits (en+ru, `prompt.overflow.*`): a "compressing N block(s)…" line before it starts, a per-block "summarizing \"label\" (N → M tok)…" line before the model call, a "truncating …" line on the fallback, and a failure line before falling back to truncation.
+- **Hardcoded English startup logs**: model auto-load success/failure, reasoning probe result, project indexing start/finish/failure, unreadable index entries and background-processes-killed-on-shutdown were untranslated; they now use `env.*` keys (en+ru). Project indexing now announces start and completion (`Indexed N file(s)`), so a slow first walk no longer pauses startup silently.
+
+## [0.60.0] - 2026-09-15
+
+### Added
+- **`session_info` tool** (`src/tools/session-info.ts`, `alwaysOn`): the model can now answer questions about the session it is running in — id, name, model, provider, context window, message count, timestamps and **live context usage** (`tokens / history budget (percent)` from `ContextManager.getSnapshot()`). Reads live metadata through a new `sessionManager` getter on `ToolContext` (like `sessionId`/`sessionContext`), so a REPL `/new` or `/resume` is reflected immediately. Previously the model reported having "no access to session metadata".
+- **Session prompt block** (`session.info_full`, en+ru): the system prompt carries a compact `[Session: "name" (id) | model: … | context: … tokens]` line so session identity is available passively as well.
+- **Project-map command**: `mma map [summary|refresh|find <query>]` (CLI) and `/map [summary|refresh|find <query>]` (REPL) let the user inspect the index directly — `summary` prints the exact text injected into the system prompt, `refresh` re-indexes, `find` searches by path or exported symbol. Shared implementation in `src/modules/indexer/map-command.ts` (also used by the `project_map` tool for `find`).
+- **Multi-language index**: symbol extraction was TS/JS-only and the extension whitelist stopped at 10 types. New `src/modules/indexer/symbols.ts` is a data-driven registry — adding a language is one rule plus extensions. It now indexes and extracts symbols for TypeScript/JavaScript, Python, Rust, Go, Java, Kotlin, C#, Ruby, PHP, Swift, Scala, C/C++, Shell and Lua (plus data formats: JSON, Markdown, YAML, TOML, XML, HTML/CSS); symbols are deduped and capped at 40 per file. `map-select.ts` now reuses `isCodeLanguage()` instead of its own list.
+
+### Fixed
+- **Session metadata never reached the model**: `SessionModule.getSystemPromptBlock()` was collected once during bootstrap, but the session is created during that same bootstrap with `messageCount === 0`, so the block was always `null`. It is now collected through `getDynamicPromptBlocks`; content is deliberately limited to stable per-session fields (no message count) so the system prompt does not mutate every turn and the prefix KV-cache survives.
+- **Prompt-overflow messages not localized**: the overflow warnings emitted by `agent.ts` and the startup check in `bootstrap.ts` were hardcoded English; they now use `t("prompt.overflow.*")` and respect the configured locale (en+ru). The model-facing hint block stays English by design.
+- **Project map showed no source files**: the map listed the first 100 files in `readdir` walk order, which on a real workspace can be entirely docs/config/tests — on this repo the first 100 walked files contained **zero** `src/` entries, so the model had no idea about the project's code structure. New `selectMapFiles` (`src/modules/indexer/map-select.ts`) ranks source above tests above docs/config, puts the densest source directory first (no directory names hardcoded), drops lockfile noise, and sorts deterministically (KV-cache); the listing is capped at 80 files. The index still contains every file, so `project_map find` is unaffected.
+- **Indexer swallowed virtualenvs and other vendor trees**: `IGNORE_DIRS` was Node-centric (`node_modules`, `dist`, `build`, `.mma`, `coverage`), so a Python `venv/` (thousands of dependency files) was indexed and could crowd the map out. The list now covers Python (`venv`, `.venv`, `env`, `virtualenv`, `__pycache__`, `.pytest_cache`, `.mypy_cache`, `.ruff_cache`, `.tox`, `site-packages`), Rust (`target`), Go/PHP/Ruby (`vendor`, `.bundle`), JVM (`.gradle`, `out`), .NET (`obj`), Apple (`pods`, `deriveddata`), VCS/IDE (`.hg`, `.svn`, `.idea`, `.vscode`) plus the original Node entries. Matching is case-insensitive and the watcher now matches whole path **segments** instead of substrings, so short names (`env`, `out`, `obj`) cannot black out `environment.ts` or `about/`.
+
+## [0.59.0] - 2026-09-05
+
+### Added
+- **Instructions overflow handling**: AGENTS.md and the project map that exceed the system-prompt budget are no longer silently dropped — they are summarized by the LLM into the remaining budget (disk-cached in `<project>/.mma/cache/prompt-summaries`, invalidated by file edits/budget changes) or truncated with a marker; a small essential hint block tells the model what was compressed and to `read_file` the full source
+- **Startup overflow warning**: bootstrap dry-runs the system budget with the real block set and warns the user when instructions/project map will not fit, with a concrete fix — `mma context <N>` for a global `contextWindow`, or an edit of `provider.entries[].contextWindow` in `config/provider.json` when the active entry overrides it
+- **Context probe**: at startup MMA asks LM Studio's native API for the context length the model is actually loaded with and compares it with the configured `contextWindow` — warning on overflow risk (no auto-clamp, user decides), info suggestion when the model supports more; result logged as a `context_probe` session entry
+- **Config**: `instructions.summarize` (default `true`) to disable LLM summarization (truncation fallback only)
+
+## [0.58.2] - 2026-09-01
+
+### Fixed
+- **Stale i18n in published package**: `build:copy-assets` did not refresh `dist/i18n/en.json`/`ru.json`, so the 0.58.1 release shipped the old startup-check wording in the standalone JSON files (only `dist/main.js` had the fix). The copy step now ships the current dictionaries.
+
+## [0.58.1] - 2026-09-01
+
+### Fixed
+- **Startup check overreach**: the `lsp.startup_header` prompt block instructed the model to "fix these before continuing", overriding `SCOPE DISCIPLINE` — the 9B model started fixing pre-existing project errors the user never asked about (and skipped clarifying questions). The block is now informational (baseline only): errors are listed but the model is told to ignore them unless the current request is about them (en+ru).
+
+## [0.58.0] - 2026-08-31
+
+### Added
+- **MoE experts**: dynamic expert registry — `config.experts` (with optional `ExpertConfig.description`) is rendered into the MoE planner prompt instead of a hardcoded code/research/browser/vision list (fallback: `tool_tags`)
+- **MoE orchestrator provider**: `OrchestratorClient` builds its provider through `ProviderManager` — per-entry `contextWindow`/`retry`/`rateLimits` and failover entries are honored; `orchestrator.contextWindow` is the global fallback (legacy `{type,baseUrl,apiKey}` configs keep working)
+- **MoE success criteria**: machine-readable `success_criteria` (`file-exists:<path>`, `substring-in-file:<path>:<text>`, `command-exit-0:<cmd>`) verified by `StepVerifier.verifySubtaskCriteria` before merge; LLM-only criteria surface as warnings in the Router context
+- **MoE selective re-plan**: `executePlan(plan, {skipIds, carriedResults})` — already-succeeded subtasks are carried over across re-plan cycles, only failed/new subtasks re-execute
+- **MoE observability**: `moe_plan` / `moe_subtask` / `moe_replan` / `moe_verify` events written to `session.jsonl` (visible in `mma session show`); token usage aggregated per `expert_tag` (`MoEExecutor.getUsageByTag`); sub-agents receive the real session id instead of the hardcoded `"moe"`
+- **MoE cert scenarios**: `5.2-moe-parallel-waves` and `5.3-moe-read-after-write` (tag `moe`, timeoutMs 600_000)
+- **ToolResult.usage**: sub-agent token usage propagated to the MoE executor for cost attribution
+
+### Changed
+- **Reasoning policy baseline**: configurable via `reasoning.baseline` (default `medium`) — the auto policy's quiet-iteration level is no longer hardcoded, so trivial Q&A turns can start at `low`
+
+### Fixed
+- **MoE hang**: sub-agents spawned by the `subagent` tool re-entered `runWithMoE` when the parent config had `moe.enabled=true` — each MoE sub-agent planned its own subtasks and spawned nested sub-agents recursively (bounded only by `maxRecursionDepth`), hanging execution for many minutes with zero progress events. Sub-agents now always run the plain single-agent loop (`moe` is a top-level orchestration mode only).
+- **MoE fallback visibility**: missing `orchestrator.model` with `moe.enabled=true` now logs a WARN with a fix hint instead of a debug-only message that made silent fallback to single-agent invisible.
+- **CLI one-shot commands hang**: `config`, `session`, `model`, `provider`, `context`, `security`, `plugins`, `changelog` printed their result but never exited — bootstrap leaves open handles (reasoning-probe fetch, indexer) and only the prompt/REPL paths called `process.exit`. Subcommand roots now exit via a `postAction` hook (verified: `session list` 2.7s / exit 0, chained `config set` persists correctly).
+- **Repeated tool calls**: identical `(tool, args)` repeat now injects a nudge into context in ALL modes — previously the nudge was gated behind `--exit-on-complete`, so interactive runs silently burned iterations re-running the same command (observed: duplicate `node sum.js` verification back-to-back).
+- **Perfectionism cycle**: repeated mutations of the SAME target (same file via `edit_file`/`write_file`, same bash command, same `plan`/`todo` action) with varying arguments now inject a finalize-nudge after 5 occurrences — the consecutive-duplicate guard cannot see this pattern (args differ each time; observed: 20+ polish iterations after the task was already complete, then 10+ bookkeeping churn iterations after an audit rejection). The nudge lands AFTER tool results, so `assistant(tool_calls) → tool(results) → user(nudge)` pairing stays valid.
+- **Audit gate friction (evidence-based auto-close)**: pending plan steps whose every file-like token resolves to an existing file are auto-closed by the final audit with a note — small models routinely finish the work but forget `plan update` bookkeeping, and the gate then rejected correct answers burning all retry budget. Steps without file tokens or with missing files stay pending (honest).
+- **Audit rejection guidance**: the audit gate's `<system-summary>` now names the resolution paths (mark done / skipped / re-plan) in en+ru instead of a bare "continue working" — model plan-drift after a rejection (wrong file names, changed approach) is common for 9B and the old message did not point at the fix.
+- **LSP false positives without type env**: `lsp_check` suppresses module-resolution diagnostics when the project root has no `tsconfig.json`/`jsconfig.json`/`node_modules` and reports an inconclusive note instead — phantom `Cannot find module 'fs'` / `Cannot find name '__dirname'` errors made the model abandon a working `.ts` approach for `.js` and spiral into plan drift.
+- **Windows Unix-command hints**: `bash` hint list and the module-side forbidden set now cover `sed`/`awk`/`uniq`/`xargs`/`cut`/`tr`/`basename`/`dirname`/`export`/`source`/`sleep`/`env` (both lists kept consistent) — the 9B model keeps reaching for Unix tools in cmd.exe.
+- **Tool visibility narrowing**: `chunk_query`, `download_file`, `mcp_call`, `pipeline_run` no longer visible by default — they moved behind `enable_tools` (`research`/`shell` tags); the default visible set drops from 23 to 19 schemas, cutting tool tokens on every turn.
+- **Tests**: replaced process-global `vi.mock` with DI seams (`AgentDeps.runWithMoEOverride`, `ToolContext.agentFactory`) — Bun module mocks leak across test files in the same worker; full suite is now green by default (1803 pass / 0 fail).
+- **Docs**: AGENTS.md / testing.md — warn that `mma` resolves the globally installed package (stale `dist/`) when run outside the repo root, silently ignoring `src/` changes; always run from the repo root with `-d <sandbox>` and verify the version in the `Environment:` line.
+
+## [0.57.2] - 2026-08-30
+
+### Changed
+- **KV-cache**: plan block removed from system prompt; plan status now injected into `<system-summary>` envelope after every tool batch. System prompt is immutable per session — local backends retain prefix cache.
+- **Provenance**: provider entry resolution uses active entry label, not bare `provider.type`
+- **Reasoning signals**: `consecutiveToolSuccesses` and `isRepetitive` now feed real values to the reasoning policy (were hardcoded)
+- **Token estimation**: tool-def token estimate in agent loop uses `estimateTokens()` instead of flat `/4`
+- **Agent split**: `agent.ts` 1550→950 lines; 10 extracted modules (`loop-state`, `compaction`, `tool-batch`, `hallucination-gate`, `audit-gate`, `reasoning-resolver`, `token-tracker`, `context-renderer`, `tool-output`, `constants`)
+- **Plan-tool**: `plan-tool.ts` 741→232 lines; per-action handlers in `plan-actions.ts`
+- **CLI**: `createProgram` 513→thin orchestrator; `registerMmaCommands` 470→8 lines (5 per-domain registers)
+- **Bash handler**: `bash.ts` 236→~100 lines (`resolveBashSecurityConfig`, `decorateCommandOutput`)
+- **Orchestrator**: reuse `parseChunks` instead of hand-rolled `any[]` aggregation; `createPlan` uses own `parseJSON`; constructor deduplicated via `createProviderInstance`
+- **Shared utils**: `src/utils/` with `errMsg()`, `sleep()`, `truncate()`, `backoffDelay()`
+- **errMsg**: replaces 23 occurrences of `e instanceof Error ? e.message : String(e)` across 12 files
+
+### Fixed
+- **chunk_query**: one failing chunk no longer kills the entire query; per-chunk `catch` → `[FAILED]`
+- **chunk_query**: synthesis prompt capped at 20K chars with `[TRUNCATED]` marker
+- **chunk_query**: `AbortSignal` propagated to `chatText` for cancellation support
+- **Executor**: `failFast` cleanup guard prevents nested scope clobbering
+- **probe.ts**: transient errors (network/auth) no longer cached as "reasoning not supported" for 24h; returns `null` → caller skips cache
+- **LSP**: startup timeout unified on `DEFAULT_TIMEOUT` (15000) instead of conflicting hardcoded 10000
+- **Browser**: `BridgeResponse.data` typed (was `any`)
+- **Agent**: `Agent.runTool()` public API replaces `(ctx.agent as any).deps` reach-in; `/reload` no longer mutates readonly context
+- **LSP /lsp check**: fixed latent bug where `.execute()` was called with `.executeByName` signature
+
+### Added
+- **Plan Reminder**: static `[Plan Reminder]` block in system prompt (never mutates)
+- **Documentation**: reentrancy warning on `executeByName()`, `PlanResult` JSDoc
+- **Tests**: `probe.test.ts` (6 cases), `command-suggest.test.ts`, `providers-factory.test.ts`, `subagent-tool.test.ts`, `agent-moe-write.test.ts`, `chunk-query.test.ts`
+- **probe.ts**: `null` return for transient errors; bootstrap skips cache on `null`
+- **Execution-plugin**: `resetStepFlags`/`resetPlanState` helpers (dedup 3 inline reset blocks)
+- **Security-policies**: `comparePolicies` typed (`keyof SecurityConfig` replaces `as any`)
+
+### Removed
+- **Browser**: dead `buildWaitScript` export (never imported)
+
+## [0.57.1] - 2026-08-28
+
+### Fixed
+- **Publish**: republish after version bump
+
+## [0.57.0] - 2026-08-28
+
+### Changed
+- **MCP**: lazy connect — server connections deferred to first tool call. Startup no longer blocks on unreachable MCP servers (e.g. context7 offline). Discovery runs in background with 5s timeout.
+- **Updater**: `checkOnStart` and `autoInstall` disabled by default. Reduced `waitForIdle` timeout from 130s to 10s.
+- **Config**: `updater.checkOnStart` default changed from `true` to `false`
+
+### Added
+- **MCP**: HTTP request timeouts (10s) on `connectSSE`, `listToolsHTTP`, `callToolHTTP`
+- **MCP**: `failedServers` tracking — servers that fail discovery are not retried
+- **MCP**: placeholder `connect` tool for not-yet-discovered servers (LLM can trigger lazy discovery)
+- **Reasoning**: persistent disk cache (`~/.mma/reasoning-cache.json`) with 24h TTL — avoids re-probing LLM on every restart
+
+## [0.56.5] - 2026-08-27
+
+### Fixed
+- **Hallucination**: `FactualCheck` now receives deleted files from `ConsistencyCheck` — no longer false-positives on files that were intentionally deleted in the same session
+
+## [0.56.4] - 2026-08-27
+
+### Fixed
+- **Tools**: `list_dir` now filters `.mma/`, `node_modules/`, `.git/`, `dist/`, `build/`, `coverage/` from directory listings (consistent with indexer)
+- **Hallucination**: `dotfileVariants` now tries dot-prefixing each directory component, not just basename (fixes false positive on `.mma/index-cache.json` → `mma/index-cache.json`)
+
+## [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