# ALCOMD3 v2.0.0-beta.5

## English

ALCOMD3 v2.0.0-beta.5 is a beta maintenance release from the current `dev-mcp` branch. It focuses on MCP bridge lifecycle reliability, MCP status visibility, and a Unity Hub environment fallback.

### Changes since v2.0.0-beta.4

#### MCP bridge

- Improved MCP bridge lifecycle handling during app startup and shutdown.
- Added MCP documentation under `docs/mcp.md`.
- Refreshed the MCP status page periodically so client/server state remains visible even if an event is missed.
- Recorded MCP client status with bounded history and throttled status-change events to avoid excessive UI refreshes.
- Added unit coverage for MCP client status recording behavior.

#### Unity Hub reliability

- Handled missing `ProgramData` environment values when locating Unity Hub on Windows.

#### Release and maintenance

- Updated Rust workspace packages, npm packages, lockfiles, README release references, and release notes to `2.0.0-beta.5`.
- Windows setup resource metadata uses the numeric version `2.0.0.0`, while updater and release metadata use the SemVer version `2.0.0-beta.5`.

### Installation Notes

The Windows version updates the existing application installation instead of installing side by side.
The main executable keeps its legacy file name for compatibility with the existing install path and protocol associations.

## 日本語

ALCOMD3 v2.0.0-beta.5 は、現在の `dev-mcp` ブランチから作成したベータ版メンテナンスリリースです。MCP bridge の lifecycle 信頼性、MCP status の表示、Unity Hub 環境 fallback を中心に改善しました。

### v2.0.0-beta.4 からの変更点

#### MCP bridge

- アプリ起動時と終了時の MCP bridge lifecycle handling を改善しました。
- `docs/mcp.md` に MCP ドキュメントを追加しました。
- イベントを取りこぼした場合でも client/server state が見えるように、MCP status page を定期的に再取得するようにしました。
- MCP client status の履歴数を制限し、status-change event を throttle して過剰な UI refresh を避けるようにしました。
- MCP client status 記録処理の unit test を追加しました。

#### Unity Hub の信頼性

- Windows で Unity Hub を探す際、`ProgramData` 環境値が存在しない場合を扱うようにしました。

#### リリースとメンテナンス

- Rust workspace packages、npm packages、lockfiles、README の release 参照、release notes を `2.0.0-beta.5` に更新しました。
- Windows setup の resource metadata は numeric version `2.0.0.0` を使用し、updater と release metadata は SemVer の `2.0.0-beta.5` を使用します。

### インストールについて

Windows 版は、並行してインストールされるのではなく、既存の application installation を更新します。
既存のインストール先やプロトコル関連付けとの互換性のため、main executable は legacy file name を維持します。

## 中文

ALCOMD3 v2.0.0-beta.5 是从当前 `dev-mcp` 分支发布的 beta 维护版本。本版本重点改进 MCP bridge 生命周期可靠性、MCP 状态可见性，以及 Unity Hub 环境 fallback。

### 相比 v2.0.0-beta.4 的变化

#### MCP bridge

- 改进应用启动和退出期间的 MCP bridge 生命周期处理。
- 新增 `docs/mcp.md` MCP 文档。
- MCP status page 会定期刷新，避免事件丢失时 client/server 状态停留在旧值。
- MCP client status 使用有界历史，并对 status-change event 做节流，避免过度刷新 UI。
- 为 MCP client status 记录行为新增单元测试。

#### Unity Hub 可靠性

- 在 Windows 上定位 Unity Hub 时，处理 `ProgramData` 环境值缺失的情况。

#### 发布与维护

- 将 Rust workspace 包、npm 包、lockfile、README 发布引用和发布说明更新为 `2.0.0-beta.5`。
- Windows setup 资源元数据使用数值版本 `2.0.0.0`；updater 和 release 元数据仍使用 SemVer 版本 `2.0.0-beta.5`。

### 安装说明

Windows 版本会更新既有应用安装，而不是并排安装。
主程序保留 legacy file name，用于兼容既有安装路径和协议关联。
