aiterm-mcp 0.37.2 → 0.37.3

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.37.3] - 2026-09-13
+
+### 修正
+
+- WindowsのMSIX仮想AppDataにAitermがある場合、Codex Desktopの中継起動が`MODULE_NOT_FOUND`で失敗する問題を修正した。起動済みの中継が自身の実体パスを後続processへ渡す。
+
 ## [0.37.2] - 2026-09-13
 
 ### 修正
@@ -1679,7 +1685,8 @@ prototype (preserved under `prototype/python/` as the porting source and referen
   `ubuntu-latest` for Node 18/20/22, publishing to npm on `v*` tags with
   provenance.
 
-[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.2...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.3...HEAD
+[0.37.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.2...v0.37.3
 [0.37.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.1...v0.37.2
 [0.37.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.0...v0.37.1
 [0.37.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.36.0...v0.37.0

package/README.ja.md

@@ -65,6 +65,7 @@ Windowsはユーザー環境変数`CODEX_CLI_PATH`で起動設定を維持しま
 解除・旧版への巻き戻し前は`aiterm-setup --codex-steer disable`を実行してCodexを再起動してください。
 SteerはmacOS・Windowsの公式Codex Desktopと同梱CLI 0.154以上に対応します。Steer有効時の宛先は中継で起動したDesktopに限ります。
 Windowsでは公式Desktopが展開した実行ファイルを照合し、認証付きのローカル接続へ中継します。
+Windowsの仮想AppDataからの起動にも対応し、中継へ実際の保存先を引き継ぎます。
 Aitermのpackageがlauncher・中継・設定・親への配送を含み、gpt-connectorやdotagentsの導入は不要です。
 両OSで公式CodexをDesktopの直接の子として保ち、中継は公式Codexの子として動きます。
 有効化時は元の起動設定を保存してAitermのlauncherを設定し、解除時に元へ戻します。選択後に他から変更された値は上書きしません。
@@ -196,7 +197,7 @@ runtime-error store は canonical dotagents config の `collection.enabled: true
 場合だけ収集し、既定OFF、network送信は行いません。tag起点CIのnpm provenance（OIDC Trusted
 Publishing）で公開し、GitHub Release が Official MCP Registry を再登録します。
 
-**状態:** 開発継続中 · 現行公開版 **v0.37.2** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.37.3** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 

package/README.md

@@ -65,6 +65,7 @@ Windowsはユーザー環境変数`CODEX_CLI_PATH`で起動設定を維持しま
 解除・旧版への巻き戻し前は`aiterm-setup --codex-steer disable`を実行してCodexを再起動してください。
 SteerはmacOS・Windowsの公式Codex Desktopと同梱CLI 0.154以上に対応します。Steer有効時の宛先は中継で起動したDesktopに限ります。
 Windowsでは公式Desktopが展開した実行ファイルを照合し、認証付きのローカル接続へ中継します。
+Windowsの仮想AppDataからの起動にも対応し、中継へ実際の保存先を引き継ぎます。
 Aitermのpackageがlauncher・中継・設定・親への配送を含み、gpt-connectorやdotagentsの導入は不要です。
 両OSで公式CodexをDesktopの直接の子として保ち、中継は公式Codexの子として動きます。
 有効化時は元の起動設定を保存してAitermのlauncherを設定し、解除時に元へ戻します。選択後に他から変更された値は上書きしません。
@@ -210,7 +211,7 @@ collection is off by default and performs no network I/O. It ships via
 tag-triggered CI with npm provenance (OIDC Trusted Publishing); the GitHub
 Release re-registers the Official MCP Registry entry.
 
-**Status:** actively maintained · current public release **v0.37.2** · runs on Linux · WSL2 · macOS · native Windows (tmux on POSIX, the tmux-CLI-compatible [psmux](https://github.com/psmux/psmux) on native Windows — no WSL required) · MIT · see the [CHANGELOG](CHANGELOG.md).
+**Status:** actively maintained · current public release **v0.37.3** · runs on Linux · WSL2 · macOS · native Windows (tmux on POSIX, the tmux-CLI-compatible [psmux](https://github.com/psmux/psmux) on native Windows — no WSL required) · MIT · see the [CHANGELOG](CHANGELOG.md).
 
 ### Update and rollback
 

package/dist/windows-codex-launcher.js

@@ -14,6 +14,7 @@ ${windowsNativeProcessSource}
 [DataContract] public sealed class LaunchPlan {
   [DataMember] public string directory;
   [DataMember] public string endpoint;
+  [DataMember] public string relay;
   [DataMember] public string[] arguments;
 }
 public static class AitermLauncher {
@@ -45,7 +46,7 @@ public static class AitermLauncher {
         if(plan.directory==null) return server.Wait();
         // 中継は公式CLIのjobを継承する。launcherは終了監視だけを担い、JSON-RPCを通さない。
         using(var bridge=AitermNativeProcess.Start(server.Pid,${literal(node)},new string[] {
-          ${literal(relay)},"--serve",${literal(binary)},plan.directory,plan.endpoint,server.Pid.ToString()
+          plan.relay,"--serve",${literal(binary)},plan.directory,plan.endpoint,server.Pid.ToString()
         },false,null)) {
           int code=bridge.Wait();
           lifetime.Dispose();

package/dist/windows-codex-relay.js

@@ -4,7 +4,7 @@ import { once } from "node:events";
 import { randomBytes, randomUUID } from "node:crypto";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { writeFileSync, rmSync } from "node:fs";
+import { writeFileSync, rmSync, realpathSync } from "node:fs";
 import WebSocket from "ws";
 import { ensurePrivateDirectory, makeFilePrivate } from "./windows-codex-state.js";
 import { readWindowsProcesses } from "./windows-codex-connection.js";
@@ -15,6 +15,8 @@ export async function prepareWindowsRelay(root, args) {
     const serverArgs = codexServerArguments(args);
     if (!serverArgs)
         return { directory: null, endpoint: null, arguments: args };
+    // MSIXの仮想AppData名はnative子から見えないため、起動済みの自身の実体を渡す。
+    const relay = realpathSync.native(fileURLToPath(import.meta.url));
     const directory = join(root, randomUUID());
     ensurePrivateDirectory(directory);
     try {
@@ -28,7 +30,7 @@ export async function prepareWindowsRelay(root, args) {
         const port = reservation.address().port;
         await new Promise((resolve, reject) => reservation.close(error => error ? reject(error) : resolve()));
         const endpoint = "ws://127.0.0.1:" + port;
-        return { directory, endpoint, arguments: [...serverArgs, "--listen", endpoint, "--ws-auth", "capability-token", "--ws-token-file", tokenFile] };
+        return { directory, endpoint, relay, arguments: [...serverArgs, "--listen", endpoint, "--ws-auth", "capability-token", "--ws-token-file", tokenFile] };
     }
     catch (error) {
         rmSync(directory, { recursive: true, force: true });

package/docs/DESIGN.md

@@ -89,6 +89,9 @@ Windows標準の.NET Frameworkでlauncherを作り、`CreateProcessW`の親proce
 公式CLIをDesktopの直接の子、中継Nodeを公式CLIの直接の子として起動する。
 launcherは終了監視だけを担い、JSON-RPCを通さない。Windowsには同一PIDでのexecがないためPIDは変わるが、
 公式binary、起動元との直接の親子関係、通常の環境とstdioは維持する。
+MSIXの仮想AppDataはnative子へ同じ論理パスを渡しても見えない場合があるため、準備processが
+自身の`realpathSync.native`を起動計画へ返し、後続の中継Nodeはその実体を起動する。
+解決は起動時に行い、設定時の保存先で固定しない。
 公式Desktopが展開した4実行ファイルを配布元のSHA-256と照合し、AitermがCodexをコピー・再配布しない。
 公式CLIの認証付きloopback WebSocketを使い、本人専用ACLのtokenと接続記録をAitermのsessions下へ置く。
 Windowsのprocess情報はprocess-runtimeが所有し、接続はPID・開始時刻・実行ファイル・token引数で照合する。

package/docs/RELEASE.md

@@ -43,6 +43,10 @@ Codex Steerを変更した場合は、公式バイナリを指定した`test/cod
 Windowsは`AITERM_TEST_CODEX_BINARY`に公式Desktopの実行fileを指定し、
 `test/windows-codex.test.mjs`で単独launcher、ACL、親識別、元の起動設定の保存と解除も確認する。
 同じ環境変数で`test/codex-relay-official.test.mjs`の実行中Steer・終了後再開・承認中継・EOFを確認できる。
+Windowsの中継起動を変更した場合は、公式Desktopが入った端末で`AITERM_TEST_CODEX_PACKAGE`に
+そのpackage family名を指定し、`test/windows-codex-msix.test.mjs`も実行する。公式の
+`Invoke-CommandInDesktopPackage`で仮想AppDataからのinitialize・EOFを確認し、稼働中Desktopや
+ユーザー設定は変更しない。packageと公式binaryを指定しないCIではこの実機試験をskipする。
 Linuxの未対応Steer選択が理由付きで停止することもCIで確認する。
 
 setupを変更した場合は、公開packageのglobal install後に`aiterm-setup --json`を実行し、

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.37.2",
+  "version": "0.37.3",
   "mcpName": "io.github.kitepon/aiterm-mcp",
   "description": "Persistent terminal MCP with one harness-based launcher for Claude Code, Codex CLI, Grok CLI, and Cursor Agent CLI, plus durable PTYs for SSH, containers, and REPLs.",
   "keywords": [