aiterm-mcp 0.37.3 → 0.37.4

package/CHANGELOG.md

@@ -7,6 +7,13 @@ 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
 
 ### 修正
@@ -1685,7 +1692,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.3...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

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となる。
@@ -197,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.3** · 動作対象は 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となる。
@@ -211,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.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).
+**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/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は承認へ応答しない。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.37.3",
+  "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": [