aiterm-mcp 0.53.1 → 0.53.2

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.53.2] - 2026-10-05
+
+### 修正
+
+- 引数なしの`aiterm-setup`が、中継（`mcp-lazy`）で包んだAitermの登録を直結へ書き戻していた（ADR 0091）。
+  連携元が全席の登録を中継つきにした後、1席がsetupを流すだけで、Claude Code・Codex・Grok・Cursorの4つの設定が直結へ戻り、
+  本体を眠らせておく節約が次の書き直しまで消えた。Codexは`mcp add`で作り直されるので、待ち時間（`startup_timeout_sec`・
+  `tool_timeout_sec`）と`env_vars`も一緒に消えた。
+  commandが`mcp-lazy`で始まる名前の実行ファイルで、argsが直結の登録のcommand＋args（中継のflagを`--`の前に置いた形も含む）なら、
+  同じ登録と数えて書き直さない。包んでいる本体のpathが違う時は、今までどおり直結の登録へ書き直す。
+
 ## [0.53.1] - 2026-10-05
 
 ### 修正
@@ -2204,7 +2215,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.53.1...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.53.2...HEAD
+[0.53.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.53.1...v0.53.2
 [0.53.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.53.0...v0.53.1
 [0.53.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.52.3...v0.53.0
 [0.52.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.52.2...v0.52.3

package/README.ja.md

@@ -209,7 +209,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.53.1** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.53.2** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -536,6 +536,8 @@ MCPの本体を初めて使う時まで起こさない中継の後ろにAiterm
 `MCP_LAZY_WAKE_COMMAND='["/absolute/path/to/node","/absolute/path/to/aiterm-mcp/dist/delivery-wake-cli.js","--parent","claude"]'`
 持ち主の開始時刻はLinuxでは`/proc`で照合する。それ以外のOSでは、pidがあれば生きている持ち主として扱う。
 
+`aiterm-setup`は、中継（`mcp-lazy`）で包んだ同じ登録を作り直さない。commandが`mcp-lazy`で始まる名前の実行ファイルで、argsが直結の登録のcommand＋args（中継のflagを`--`の前に置いた形も含む）なら、Claude Code・Codex・Grok・Cursorの登録をそのまま残す。包んでいる本体のpathが違う時は、直結の登録へ書き直す。
+
 `agent_launch({ harness, cwd, trust_project: true })`はpromptなしでも既知のworkspace・project hooks・MCP初期同意を
 進め、入力受付とharness生存を確認して`startup.status="ready"`を返す。指定なしのpromptなし起動は`not_checked`。
 Claude Code初回起動の文字表示テーマ選択では、画面で選択済みの項目を確定して起動を続ける。

package/README.md

@@ -223,7 +223,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.53.1** · 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.53.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).
 
 ### Update and rollback
 
@@ -572,6 +572,8 @@ same environment as the server:
 `MCP_LAZY_WAKE_COMMAND='["/absolute/path/to/node","/absolute/path/to/aiterm-mcp/dist/delivery-wake-cli.js","--parent","claude"]'`.
 Owner start times are checked through `/proc` on Linux; elsewhere an existing PID is treated as a live owner.
 
+`aiterm-setup` does not rewrite a registration that wraps the same server in the `mcp-lazy` relay. When the registered command is an executable whose name starts with `mcp-lazy` and its args are the direct registration's command followed by its args (relay flags before `--` are allowed), the Claude Code, Codex, Grok, and Cursor registrations are left as they are. If the wrapped server path differs, setup writes the direct registration.
+
 `agent_launch({ harness, cwd, trust_project: true })` completes known workspace, project-hook, and project-MCP startup
 consent even without a prompt, then verifies input readiness and harness liveness before returning `startup.status="ready"`.
 For Claude Code's first-run text-style menu, it confirms the item already selected on screen before continuing startup.

package/dist/lazy-relay.js

@@ -0,0 +1,8 @@
+// 中継（mcp-lazy）の見分け。取り決めはmcp-lazyのREADMEにある（実行ファイルの名前が`mcp-lazy`で始まる）。
+// process表の読み手（process-runtime）と、登録の読み手（setup-integrations）が同じ決まりを使う。
+// setup-integrationsは連携元のprocessへ直接読み込まれるので、ここはnode:pathだけに依存する。
+import path from "node:path";
+/** 実行ファイルのpathが中継（mcp-lazy）か。名前（basename）が`mcp-lazy`で始まる物。 */
+export function lazyRelayExecutable(file) {
+    return path.posix.basename(file.replace(/\\/g, "/")).toLowerCase().startsWith("mcp-lazy");
+}

package/dist/process-runtime.js

@@ -3,6 +3,7 @@ import { spawnSync } from "node:child_process";
 import { createHash } from "node:crypto";
 import path from "node:path";
 import { AitermError } from "./errors.js";
+import { lazyRelayExecutable } from "./lazy-relay.js";
 import { isWin } from "./tmux-runtime.js";
 import { resolveWindowsPowerShell7 } from "./windows-powershell.js";
 export function processIdentity(process) {
@@ -223,7 +224,7 @@ export function processSubtree(rows, rootPid) {
 // 見分けるのは起動した実行ファイルの名前（argvの先頭のbasenameが`mcp-lazy`で始まる）。取り決めはmcp-lazyのREADMEにある。
 export function lazyRelayProcess(command) {
     const first = /^(?:"([^"]+)"|(\S+))/.exec(command);
-    return path.posix.basename((first?.[1] ?? first?.[2] ?? "").replace(/\\/g, "/")).toLowerCase().startsWith("mcp-lazy");
+    return lazyRelayExecutable(first?.[1] ?? first?.[2] ?? "");
 }
 export function backgroundProcesses(rows, root) {
     // 起動時の足場processを除く既存契約。pane開始から60秒以上後に生成された子孫だけを集計する。

package/dist/setup-integrations.js

@@ -5,10 +5,29 @@ import { randomUUID } from "node:crypto";
 import { isDeepStrictEqual } from "node:util";
 import * as steer from "aiterm-steer-delivery";
 import { resolveAgentBin } from "./agent-resolver.js";
+import { lazyRelayExecutable } from "./lazy-relay.js";
 import { SetupError, runSetupCommand } from "./setup-platform.js";
 import { AITERM_PROFILE } from "./steer-profile.js";
 export { powershellInvocation } from "./setup-platform.js";
 const record = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/**
+ * 既にある登録が、今から書く登録と同じ本体を指しているか。
+ * 直結（commandとargsが同じ）に加えて、中継（mcp-lazy）で包んだ同じ登録も同じと数える。
+ * 中継つきの形は、commandが`mcp-lazy`で始まる名前の実行ファイルで、argsが直結のcommand＋args
+ * （中継のflagを`--`の前に置いた形も含む）。中継は本体を道具が呼ばれるまで起こさない。
+ * 連携元が全席の登録を中継つきで書いた後、1席が引数なしのsetupを流しても、直結へ戻さない。
+ */
+export function sameRegistration(command, args, registration) {
+    if (typeof command !== "string" || !Array.isArray(args))
+        return false;
+    if (command === registration.command && isDeepStrictEqual(args, registration.args))
+        return true;
+    if (!lazyRelayExecutable(command))
+        return false;
+    const direct = [registration.command, ...registration.args];
+    const separator = args.indexOf("--");
+    return isDeepStrictEqual(args, direct) || (separator >= 0 && isDeepStrictEqual(args.slice(separator + 1), direct));
+}
 export function mergeJsonMcp(file, registration) {
     let current = {};
     let target = file;
@@ -36,6 +55,9 @@ export function mergeJsonMcp(file, registration) {
     }
     const servers = (current.mcpServers ?? {});
     const previous = record(servers.aiterm) ? servers.aiterm : {};
+    // 中継で包んだ同じ登録は、そのまま残す（直結へ書き戻さない）。
+    if (previous.command !== registration.command && sameRegistration(previous.command, previous.args, registration))
+        return "unchanged";
     const updated = { ...previous, ...registration };
     if (isDeepStrictEqual(servers.aiterm, updated))
         return "unchanged";
@@ -144,8 +166,8 @@ export function configureIntegrations(home, registration, run = runSetupCommand,
                 if (!Array.isArray(servers))
                     throw new SetupError("config_readback_failed", "CodexのMCP一覧形式を確認できません");
                 const existing = servers.find((entry) => entry.name === "aiterm");
-                // 公式CLIの追加は登録を作り直し、利用者が足した項目（待ち時間など）を落とす。同じ登録なら書き直さない。
-                if (existing?.transport?.command !== registration.command || !isDeepStrictEqual(existing?.transport?.args, registration.args)) {
+                // 公式CLIの追加は登録を作り直し、利用者が足した項目（待ち時間など）を落とす。同じ登録（中継で包んだ物を含む）なら書き直さない。
+                if (!sameRegistration(existing?.transport?.command, existing?.transport?.args, registration)) {
                     const envArgs = Object.entries(existing?.transport?.env ?? {}).flatMap(([key, value]) => ["--env", `${key}=${value}`]);
                     run(executable, ["mcp", "add", "aiterm", ...envArgs, "--", registration.command, ...registration.args]);
                     const value = JSON.parse(run(executable, ["mcp", "get", "aiterm", "--json"]));
@@ -160,7 +182,7 @@ export function configureIntegrations(home, registration, run = runSetupCommand,
                     throw new SetupError("config_readback_failed", "GrokのMCP一覧形式を確認できません");
                 const existing = servers.find((entry) => entry.name === "aiterm" && entry.scope === "user");
                 // Codexと同じく、同じ登録なら書き直さない。
-                if (existing?.command !== registration.command || !isDeepStrictEqual(existing?.args, registration.args)) {
+                if (!sameRegistration(existing?.command, existing?.args, registration)) {
                     const envArgs = Object.entries(existing?.env ?? {}).flatMap(([key, value]) => ["--env", `${key}=${value}`]);
                     run(executable, ["mcp", "add", "--scope", "user", "aiterm", ...envArgs, "--", registration.command, ...registration.args]);
                     const value = JSON.parse(run(executable, ["mcp", "list", "--json"]));

package/docs/DESIGN.md

@@ -16,7 +16,7 @@ Claude／CursorのJSONは参照先を原子的に更新して変更前backupを
 各AIの読戻しは登録内容の確認であり、端末の実動作はその前の公開MCP試験で確認する。
 失敗は理由付きJSONと非ゼロ終了で返す。対応外の自動導入と全AI未検出を成功扱いしない。
 global packageは、npmの現在のglobal rootか、実行中のNodeの既定のglobal rootにあるものを指す。
-CodexとGrokは登録が同じなら公式CLIで作り直さない。`aiterm-setup --hooks-only`はClaude Code・Cursorの親配送hookだけを登録し、
+CodexとGrokは登録が同じなら公式CLIで作り直さない。中継（`mcp-lazy`）で包んだ同じ登録も「同じ」と数え、4つのclientとも直結へ書き戻さない（ADR 0091）。`aiterm-setup --hooks-only`はClaude Code・Cursorの親配送hookだけを登録し、
 依存準備、端末の実動作確認、MCP登録、Codex Steerに触れない。判断はADR 0077。
 
 ## Terminal model

package/package.json

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