# ALCOMD3 v2.0.0

## English

ALCOMD3 v2.0.0 is a major version change and starts the independent ALCOMD3 2.0 release line. It keeps the MD3 desktop experience from MD3.6, preserves Windows install-path compatibility, and adds a minimal read-only MCP integration for AI agents, along with reliability fixes around repository import, package operations, and Windows environment detection.

### Changes since v1.1.6-MD3.6

#### MCP bridge

- Added the bundled `alcomd3-mcp` stdio MCP bridge.
- Added a private local GUI IPC endpoint used by the MCP bridge while the GUI is running.
- Added read-only MCP tools for listing projects, reading registered project details, listing repositories, and searching packages.
- Added the MCP status page and sidebar entry.
- The MCP enable/disable control gates data access. It does not stop the local endpoint while the GUI is running.
- When MCP is disabled, tool calls return the structured `mcp_disabled` error.
- When the GUI or endpoint is unavailable, tool calls return the structured `alcomd3_unavailable` error.
- Tool calls may start ALCOMD3 GUI when the GUI is not running, while `initialize` and `tools/list` do not start the GUI.
- Added MCP documentation under `docs/mcp.md`.

#### Stability

- Fixed installed-app binding export behavior so production builds do not try to write generated TypeScript bindings into the source tree.
- Fixed repository add/import panic paths. Duplicate repositories now return errors, progress event emit failures are logged, and deep link add failures can be shown to the user.
- Added a repository-add regression test covering duplicate repository handling without panic.
- Handled missing `ALLUSERSPROFILE` values when locating Unity Hub on Windows.
- Prevented concurrent package apply requests from racing the same project operation state.
- Improved MCP client status refresh behavior with bounded client history and throttled status-change events.

#### Packaging and release

- Packaged alcomd3-mcp.exe with the Windows installer next to the main GUI executable.
- Started the independent ALCOMD3 `2.0.0` release line and published ALCOMD3-owned release artifacts.
- Updated Rust workspace packages, npm packages, lockfiles, README release references, and release notes to `2.0.0`.
- Windows setup resource metadata uses the numeric version `2.0.0.0`; package, updater, and release metadata use the SemVer version `2.0.0`.

### 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 は major version change であり、独立した ALCOMD3 2.0 release line を開始します。MD3.6 の MD3 デスクトップ体験を維持し、Windows install-path compatibility を保ちながら、AI agent 向けの最小 read-only MCP integration を追加し、リポジトリインポート、パッケージ操作、Windows 環境検出の信頼性を改善しました。

### v1.1.6-MD3.6 からの変更点

#### MCP bridge

- 同梱の `alcomd3-mcp` stdio MCP bridge を追加しました。
- GUI の実行中に MCP bridge が使用する private local GUI IPC endpoint を追加しました。
- プロジェクト一覧、登録済みプロジェクト詳細、リポジトリ一覧、パッケージ検索の read-only MCP tools を追加しました。
- MCP status page と sidebar entry を追加しました。
- MCP の有効化/無効化コントロールはデータアクセスを制御します。GUI 実行中の local endpoint は停止しません。
- MCP が無効な場合、tool call は structured error `mcp_disabled` を返します。
- GUI または endpoint が利用できない場合、tool call は structured error `alcomd3_unavailable` を返します。
- GUI が起動していない場合、tool call は ALCOMD3 GUI の起動を試みます。一方で `initialize` と `tools/list` は GUI を起動しません。
- `docs/mcp.md` に MCP documentation を追加しました。

#### 安定性

- インストール済みアプリで generated TypeScript bindings を source tree に書き込もうとしないよう、production build の binding export behavior を修正しました。
- リポジトリ追加/インポート時の panic 経路を修正しました。重複リポジトリは error を返し、progress event emit failure は log に記録し、deep link add failure はユーザーに表示できるようにしました。
- 重複リポジトリ処理が panic しないことを確認する regression test を追加しました。
- Windows で Unity Hub を探す際、`ALLUSERSPROFILE` が存在しない環境を扱えるようにしました。
- 同一 project operation state に対する concurrent package apply requests の競合を防止しました。
- MCP client status の更新挙動を改善し、履歴数を制限し、status-change event を throttle しました。

#### パッケージングとリリース

- Windows installer で alcomd3-mcp.exe を main GUI executable と同じ場所に同梱しました。
- 独立した ALCOMD3 `2.0.0` release line を開始し、ALCOMD3-owned release artifacts として公開しました。
- Rust workspace packages、npm packages、lockfiles、README の release 参照、release notes を `2.0.0` に更新しました。
- Windows setup の resource metadata は numeric version `2.0.0.0` を使用し、package、updater、release metadata は SemVer の `2.0.0` を使用します。

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

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

## 中文

ALCOMD3 v2.0.0 是一次重大版本变更，并开启独立的 ALCOMD3 2.0 发布线。本版本保留 MD3.6 的 MD3 桌面体验，继续兼容 Windows 安装路径，并加入面向 AI 代理的最小只读 MCP 集成，同时改进仓库导入、软件包操作和 Windows 环境检测的可靠性。

### 相比 v1.1.6-MD3.6 的变化

#### MCP bridge

- 新增随程序打包的 `alcomd3-mcp` stdio MCP bridge。
- 新增 GUI 运行期间供 MCP bridge 使用的私有本地 GUI IPC endpoint。
- 新增只读 MCP 工具：列出项目、读取已登记项目详情、列出仓库、搜索软件包。
- 新增 MCP 状态页和侧边栏入口。
- MCP 启用/停用控件现在控制数据访问；GUI 运行期间不会停止本地 endpoint。
- MCP 停用时，tool call 返回结构化 `mcp_disabled` 错误。
- GUI 或 endpoint 不可用时，tool call 返回结构化 `alcomd3_unavailable` 错误。
- GUI 未运行时，tool call 可以尝试启动 ALCOMD3 GUI；`initialize` 和 `tools/list` 不会启动 GUI。
- 新增 `docs/mcp.md` MCP 文档。

#### 稳定性

- 修复安装版 binding export 行为，避免生产构建尝试把生成的 TypeScript bindings 写入源码目录。
- 修复仓库添加/导入路径上的 panic：重复仓库现在返回错误，progress event emit 失败只记录日志，deep link 添加失败可以展示给用户。
- 新增仓库添加回归测试，覆盖重复仓库不 panic 的行为。
- 在 Windows 上定位 Unity Hub 时，处理 `ALLUSERSPROFILE` 缺失的环境。
- 防止并发 package apply 请求竞争同一个项目操作状态。
- 改进 MCP client status 刷新行为，使用有界历史，并对 status-change event 做节流。

#### 打包与发布

- Windows 安装器会将 alcomd3-mcp.exe 与主 GUI 可执行文件放在同一目录。
- 开启独立的 ALCOMD3 `2.0.0` 发布线，并以 ALCOMD3 自有发布产物形式发布。
- 将 Rust workspace 包、npm 包、lockfile、README 发布引用和发布说明更新为 `2.0.0`。
- Windows setup 资源元数据使用数值版本 `2.0.0.0`；package、updater 和 release 元数据使用 SemVer 版本 `2.0.0`。

### 安装说明

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