aiterm-mcp 0.37.2 → 0.37.4

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.37.4] - 2026-09-19
+
+### 修正
+
+- HomebrewのNode更新後にCodex Desktopの中継起動が終了コード127で失敗する問題を修正した。MCP登録と中継launcherは、削除されるCellarの版別実体ではなく、同じformulaの`opt`経由でNodeを起動する。`node@22`等の選択を維持し、GUIのPATHへ依存しない。
+- 既存の登録とlauncherは、更新後の`aiterm-setup --json`で修復できる。
+
+## [0.37.3] - 2026-09-13
+
+### 修正
+
+- WindowsのMSIX仮想AppDataにAitermがある場合、Codex Desktopの中継起動が`MODULE_NOT_FOUND`で失敗する問題を修正した。起動済みの中継が自身の実体パスを後続processへ渡す。
+
 ## [0.37.2] - 2026-09-13
 
 ### 修正
@@ -1679,7 +1692,9 @@ 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.4...HEAD
+[0.37.4]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.3...v0.37.4
+[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

@@ -42,6 +42,7 @@ Ubuntu／Debianはsudoとaptでtmuxを準備する。必要な公式package mana
 既存設定の他サーバーを保持し、JSON設定は変更前の`.aiterm-backup`を残す。
 結果の`status`は`ready`／`unsupported`／`failed`／`restart_required`。未検出のAIは`not_detected`とし、全AI未検出は成功にしない。
 登録先はglobal packageのNodeとMCP入口の絶対パスで、npm一時cacheやsource checkoutは登録しない。
+HomebrewのNodeは更新後も有効な`opt`のパスをMCP登録とCodex中継に使う。旧版の登録でNode更新後に起動できなくなった場合も、更新後の`aiterm-setup --json`で修復できる。
 更新後も同じ入口を実行し、MCP clientを再起動する。npm install自体はユーザー設定を変更しない。
 公開JSONは`schema: "aiterm.setup-result.v1"`、全体の`status`、端末の`backend`、
 AI別の`integrations`と選択機能の`codex_steer`を持つ。失敗時は`reason_code`を付け、終了コードはreadyなら0、再起動待ちは3、それ以外は2となる。
@@ -65,6 +66,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 +198,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.4** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 

package/README.md

@@ -42,6 +42,7 @@ Ubuntu／Debianはsudoとaptでtmuxを準備する。必要な公式package mana
 既存設定の他サーバーを保持し、JSON設定は変更前の`.aiterm-backup`を残す。
 結果の`status`は`ready`／`unsupported`／`failed`／`restart_required`。未検出のAIは`not_detected`とし、全AI未検出は成功にしない。
 登録先はglobal packageのNodeとMCP入口の絶対パスで、npm一時cacheやsource checkoutは登録しない。
+HomebrewのNodeは更新後も有効な`opt`のパスをMCP登録とCodex中継に使う。旧版の登録でNode更新後に起動できなくなった場合も、更新後の`aiterm-setup --json`で修復できる。
 更新後も同じ入口を実行し、MCP clientを再起動する。npm install自体はユーザー設定を変更しない。
 公開JSONは`schema: "aiterm.setup-result.v1"`、全体の`status`、端末の`backend`、
 AI別の`integrations`と選択機能の`codex_steer`を持つ。失敗時は`reason_code`を付け、終了コードはreadyなら0、再起動待ちは3、それ以外は2となる。
@@ -65,6 +66,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 +212,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.4** · 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/setup-codex-relay.js

@@ -14,6 +14,7 @@ import { readRuntimeProcesses } from "./process-runtime.js";
 import { installRelayLogin, removeRelayLogin } from "./codex-relay-login.js";
 import { windowsCodexRuntime } from "./windows-codex-setup.js";
 import { configureRelay } from "./codex-relay-setup.js";
+import { setupNodeExecutable } from "./setup-node.js";
 function command(executable, args) {
     const result = spawnSync(executable, args, { encoding: "utf8", timeout: 15_000 });
     if (result.error || result.status !== 0)
@@ -150,5 +151,7 @@ export async function configureCodexSteer(action = "status", overrides = {}) {
     if (runtime.platform !== "darwin") {
         return action === "enable" ? { status: "unsupported", reason_code: "codex_steer_platform_unsupported" } : { status: "disabled" };
     }
+    if (action === "enable")
+        runtime.node = setupNodeExecutable(runtime.node);
     return configureRelay(action, runtime);
 }

package/dist/setup-node.js

@@ -0,0 +1,16 @@
+import { accessSync, constants } from "node:fs";
+import { SetupError } from "./setup-platform.js";
+// HomebrewのCellar実体は更新で消える。保存する起動先には同じformulaのoptを使う。
+export function setupNodeExecutable(executable = process.execPath) {
+    const brew = /^(.*)\/Cellar\/(node(?:@\d+)?)\/[^/]+\/bin\/node$/.exec(executable);
+    if (!brew)
+        return executable;
+    const node = `${brew[1]}/opt/${brew[2]}/bin/node`;
+    try {
+        accessSync(node, constants.X_OK);
+    }
+    catch {
+        throw new SetupError("node_runtime_unavailable", "HomebrewのNode起動先を実行できません。Nodeの導入状態を確認してください");
+    }
+    return node;
+}

package/dist/setup.js

@@ -10,6 +10,7 @@ import { prepareBackend, runSetupCommand, SetupError } from "./setup-platform.js
 import { configureIntegrations } from "./setup-integrations.js";
 import { configureCodexSteer } from "./setup-codex-relay.js";
 import { readRelayConfig } from "./codex-relay-config.js";
+import { setupNodeExecutable } from "./setup-node.js";
 export function globalRegistration(run = runSetupCommand) {
     const root = run(process.platform === "win32" ? "npm.cmd" : "npm", ["root", "-g"]).trim();
     if (!isAbsolute(root) || /[\r\n]/u.test(root))
@@ -19,7 +20,7 @@ export function globalRegistration(run = runSetupCommand) {
     if (realpathSync(installedRoot) !== realpathSync(packageRoot)) {
         throw new SetupError("global_package_required", "npm install -g aiterm-mcp後にaiterm-setupを実行してください。一時npm cacheやsource checkoutは登録しません");
     }
-    return { command: process.execPath, args: [join(installedRoot, "dist", "index.js")] };
+    return { command: setupNodeExecutable(), args: [join(installedRoot, "dist", "index.js")] };
 }
 export async function verifySetupRuntime(registration) {
     const client = new Client({ name: "aiterm-setup", version: "1.0.0" });

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

@@ -76,6 +76,10 @@ Steerを選択したmacOS・Windows Desktopでは、MCP processの祖先にあ
 Steer設定がある場合にqueueへ自動退避することはない。
 
 `aiterm-setup`の`--codex-steer enable|disable|status`が選択導入を所有する。
+MCP登録とmacOSの中継launcherへ保存するNodeの起動先は`src/setup-node.ts`が決める。
+HomebrewのCellar実体は同じformulaの`opt/<formula>/bin/node`へ変換し、実行できることを確認する。
+`node@22`等のformulaを維持し、GUIのPATH探索や別のNodeへの自動切替は行わない。
+Homebrew以外の起動先は変更しない。既存の版別パスは`aiterm-setup --json`で再生成する。
 設定とPOSIX launcherは`~/.config/aiterm-mcp/codex-relay/`、一時socketは`/tmp/aiterm-codex-<uid>/`へ置く。
 launcherはNodeのstdio中継を起動してから公式CLIへ同じPIDでexecし、Desktopとの親子関係・署名・通常環境を保つ。
 Python・独自App Server・認証情報のコピーは使わない。中継はRPCと承認応答を透過搬送し、追加clientは承認へ応答しない。
@@ -89,6 +93,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.4",
   "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": [