finalize

CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## 0.1.26 — 2026-09-10
+
+### Added
+
+- **AI Agent access (MCP).** `RA3 Mod XML: Enable AI Agent access…` exposes the
+  semantic index to AI agent clients through a local, read-only MCP (Model
+  Context Protocol) server. It exports a stable snapshot, writes a launcher
+  under `~/.ra3modxml/`, starts a loopback query server while VS Code is
+  running, and offers to install the Agent Skill and/or write the MCP client
+  configuration (Claude Desktop, Cursor global/project, or a copied generic
+  block). `Disable AI Agent access` stops the live server for the workspace;
+  `Uninstall AI Agent integration…` removes MCP config entries, the launcher,
+  and Skill copies after a confirmation prompt.
+- **Agent Skill (`ra3-mod-xml`).** `RA3 Mod XML: Install Agent Skill…` installs
+  `SKILL.md` plus a query-tool reference to `~/.agents/skills/`, and optionally
+  to Claude Code or project-local skill directories. It explains when the index
+  applies and how to reach it with or without MCP. `Uninstall Agent Skill…` 
+  removes only directories that still carry the extension's marker.
+- **`RA3 Mod XML: Export AI Agent index snapshot`** writes the gzipped,
+  versioned snapshot that the MCP server and CLI fall back to when VS Code is
+  closed.
+- **Agent CLI** (`dist/agent/cli.js`): live-index first, exported-snapshot
+  fallback. `outgoing` and `projects` need element context and report that
+  explicitly instead of returning an empty result.
+- **First-run / upgrade introduction.** After the first index, the extension
+  offers AI Agent access once (per machine). Upgrades from a build that already
+  had the feature stay silent, and "Don't show again" is remembered.
+- **Live discovery and multi-window safety.** Per-project endpoint files, one
+  `instances/` entry per VS Code window, and a merged `~/.ra3modxml/index.json`.
+  Queries are pinned to a project and a mismatched answer is refused. A crashed
+  window's instance file is pruned by the next activation.
+- **No Node installation required.** The MCP launcher for AI Agent Access runs
+  the bundled server on VS Code's own Electron binary (`ELECTRON_RUN_AS_NODE=1`)
+  and falls back to `node` on `PATH` only when that binary is missing.
+  Launchers are refreshed on activation, so moving or updating VS Code does not
+  break an existing MCP configuration.
+
 ## 0.1.25 — 2026-08-11
 
 ### Changed