aiterm-mcp 0.58.3 → 0.58.4

package/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.58.4] - 2026-10-12
+
+### 修正
+
+- AitermのMCP processが、互いの生き死にを確かめるためにprocessを起こし続け、端末を重くしていた件を直す（ADR 0112）。
+  親への配送の回収は、MCP process 1個につき2本、5秒おきに回り、ほかの持ち主の開始時刻を60秒おきに照合していた
+  （WindowsはPowerShell 7とWMI、ほかは`ps`）。照合の時刻が持ち主ごとにずれるので、回数がMCP processの数の掛け算で増えていた。
+  Windowsの端末（process 1312個、AitermのMCP process 23個）で、Aitermだけで20秒に78回のPowerShellが起き、
+  WMIの側のprocessがCPUを中央2.8コア使っていた。
+  - 持ち主は、自分の保存場所へ「生きている印」（`active/<持ち主>/alive`の時刻）を15秒おきに付ける。
+    印が60秒以内の持ち主は、OSへ聞かずに生きていると読む。pidを使い回した別のprocessは、この印を書かない。
+  - 印の無い持ち主（0.58.3までの版）と、印が古い持ち主だけ、今までどおり開始時刻で照合する。照合する回は全員をまとめ、1本が1分に1回まで。
+  - Windowsで1個のprocessの開始時刻を読む時は、WMIを使わず、.NETのprocessの読みを使う（1個1.5ミリ秒。値は今までと同じ）。
+  - Windowsの実物で、MCP processを6個・150秒動かした時のPowerShellの起動は、0.58.3が80回、この版は0回。
+  - `owner.json`の形、保存場所の名前、配送の記録と返りは変わらない。前の版のMCP processが残っている間、その分の照合は続く。
+- 共通部品`aiterm-steer-delivery`を0.4.5へ上げる。AitermのClaude Codeの親への配送で、受信hookが走るたびに端末の全processの一覧を
+  取っていたのが、確かめるprocessだけを読む形になる。
+
 ## [0.58.3] - 2026-10-12
 
 ### 修正
@@ -2524,7 +2542,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.58.3...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.58.4...HEAD
+[0.58.4]: https://github.com/kitepon/aiterm-mcp/compare/v0.58.3...v0.58.4
 [0.58.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.58.2...v0.58.3
 [0.58.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.58.1...v0.58.2
 [0.58.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.58.0...v0.58.1

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.58.3** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.58.4** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 

package/README.md

@@ -227,7 +227,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.58.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.58.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/parent-delivery.js

@@ -64,6 +64,22 @@ async function submitParentAnswer(parent, deliveryId, text) {
 const OWNER_IDENTITY_RECHECK_MS = 60_000;
 // owner.jsonの無い保存場所を、作っている途中の持ち主として扱う時間。
 const OWNER_SETUP_GRACE_MS = 60_000;
+// 持ち主が自分の保存場所へ付ける「生きている印」（ADR 0112）。中身は無く、最後に書いた時刻（mtime）だけを使う。
+// 印が新しい持ち主は、OSへ聞かずに生きていると読む。pidを使い回した別のprocessは、この印を書かない。
+// 印の無い持ち主（0.58.3までの版）と、印が古い持ち主だけ、今までどおり開始時刻で照合する。
+// 名前は.jsonで終わらせない（回収は、保存場所の.jsonを配送の記録として引き取る）。
+const OWNER_HEARTBEAT_FILE = "alive";
+const OWNER_HEARTBEAT_MS = 15_000;
+// 持ち主のprocessが同期の処理で塞がる間（最長で十数秒）も印を新しいと読めるよう、書く間隔の4倍にする。
+const OWNER_HEARTBEAT_FRESH_MS = 60_000;
+function ownerHeartbeatAt(directory) {
+    try {
+        return fs.statSync(path.join(directory, OWNER_HEARTBEAT_FILE)).mtimeMs;
+    }
+    catch {
+        return null;
+    }
+}
 function processExists(pid) {
     // 0以下はprocess groupを指す。持ち主のpidにはならない。
     if (pid <= 0)
@@ -129,10 +145,11 @@ export class ParentDeliveryManager {
     verifiedOwners = new Map();
     serviceError = null;
     closing = false;
+    lastHeartbeat = Number.NEGATIVE_INFINITY;
     constructor(options = {}) {
         this.deps = { observe: observeAnywhere, answer: answerAnywhere, submit: submitParentAnswer,
             verify: verifyParent, processes: readProcessIdentities, exists: processExists,
-            now: () => performance.now(), ...options.dependencies };
+            now: () => performance.now(), wall: () => Date.now(), ...options.dependencies };
         const stateRoot = ensureStateRoot();
         // 別端末の子の記録はremote-で始まる保存場所へ分け、boundary.remoteを知らない旧版のreaderへ渡さない。
         const prefix = options.remote ? "remote-" : "";
@@ -414,14 +431,40 @@ export class ParentDeliveryManager {
         this.recovering = this.recoverOrphans().finally(() => { this.recovering = null; });
         return this.recovering;
     }
+    /** 自分の保存場所の「生きている印」を新しくする。書けない回は次の回へ回す（印が古くなれば、相手は開始時刻で照合する）。 */
+    heartbeat() {
+        const wall = this.deps.wall();
+        if (this.closing || Math.abs(wall - this.lastHeartbeat) < OWNER_HEARTBEAT_MS)
+            return;
+        const file = path.join(this.ownerDir, OWNER_HEARTBEAT_FILE);
+        try {
+            const at = new Date(wall);
+            try {
+                fs.utimesSync(file, at, at);
+            }
+            catch (error) {
+                if (error.code !== "ENOENT")
+                    throw error;
+                fs.writeFileSync(file, "", { mode: 0o600 });
+                fs.utimesSync(file, at, at);
+            }
+            this.lastHeartbeat = wall;
+        }
+        catch { /* 次の回 */ }
+    }
     async recoverOrphans() {
+        this.heartbeat();
         // 生存を確かめる相手は、closeしていない他の持ち主だけ。居なければOSへ問い合わせない。
-        // この処理は5秒おきに全MCP processで回る。全processの一覧を取ると、processの多い端末で負荷になる。
+        // この処理は5秒おきに全MCP processで回る。processを起こして確かめると、MCP processの数の掛け算で端末を重くする
+        // （Windowsで、23個のMCP processがPowerShellを毎秒4回起こしていた。2026-10-12）。
         const directories = fs.readdirSync(this.active, { withFileTypes: true })
             .filter((directory) => directory.isDirectory() && path.join(this.active, directory.name) !== this.ownerDir);
         const now = this.deps.now();
+        const wall = this.deps.wall();
         const fate = new Map();
         const unverified = [];
+        // 前の照合を覚えている持ち主。誰かを照合する回に、まとめて照合し直す。
+        const remembered = [];
         for (const directory of directories) {
             let owner;
             try {
@@ -437,14 +480,23 @@ export class ParentDeliveryManager {
                 fate.set(directory.name, "gone");
                 continue;
             }
+            const beat = ownerHeartbeatAt(path.join(this.active, directory.name));
+            if (beat !== null && Math.abs(wall - beat) < OWNER_HEARTBEAT_FRESH_MS) {
+                fate.set(directory.name, "alive");
+                continue;
+            }
             const verified = this.verifiedOwners.get(directory.name);
             if (verified && verified.pid === pid && verified.started_identity === owner.started_identity
-                && now - verified.at < OWNER_IDENTITY_RECHECK_MS)
+                && now - verified.at < OWNER_IDENTITY_RECHECK_MS) {
                 fate.set(directory.name, verified.alive ? "alive" : "unverified");
+                remembered.push({ name: directory.name, pid, started_identity: owner.started_identity });
+            }
             else
                 unverified.push({ name: directory.name, pid, started_identity: owner.started_identity });
         }
         if (unverified.length > 0) {
+            // 覚えた時刻が持ち主ごとにずれると、1分の間に何度もprocessを起こす。照合する回は、全員を1回で照合し直して時刻を揃える。
+            unverified.push(...remembered);
             const processes = this.deps.processes([...new Set(unverified.map((entry) => entry.pid))]);
             for (const entry of unverified) {
                 const row = processes.find((candidate) => candidate.pid === entry.pid);

package/dist/process-runtime.js

@@ -101,17 +101,31 @@ export function readRuntimeProcesses() {
         };
     });
 }
+/** そのpidのprocessが今あるか。OSへ直接聞き、processを起こさない。権限が無くて触れないprocessも「ある」と読む。 */
+function pidExists(pid) {
+    if (pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === "EPERM";
+    }
+}
 /**
  * 指定したpidの開始時刻だけを引く。readRuntimeProcessesと同じ開始時刻を返し、存在しないpidは結果に含めない。
  * process表にpidはあるが開始時刻を読めない時は、started_identityをnullで返す（pidが無いのとは区別する）。
  * 全processのargvを読む一覧取得は、processの多い端末で重い（定期実行から呼ばない）。
  */
 export function readProcessIdentities(pids) {
-    const wanted = [...new Set(pids)];
+    if (pids.some(pid => !Number.isSafeInteger(pid) || pid < 0))
+        throw new AitermError("process照会のpidが不正です", 2);
+    // 居ないpidは、OSへ直接聞いて先に除く。全部居なければ、processを起こさない。
+    // macOSのpsは、範囲の外のpidが1つ混ざると、居るprocessの分も出さずに誤りで終わる。
+    const wanted = [...new Set(pids)].filter(pidExists);
     if (wanted.length === 0)
         return [];
-    if (wanted.some(pid => !Number.isSafeInteger(pid) || pid < 0))
-        throw new AitermError("process照会のpidが不正です", 2);
     if (!isWin) {
         const result = spawnSync(POSIX_PS, [...POSIX_IDENTITY_ARGS, wanted.join(",")], {
             encoding: "utf8", env: { ...process.env, LC_ALL: "C" }, timeout: 10000,
@@ -129,11 +143,25 @@ export function readProcessIdentities(pids) {
     }
     // CommandLineの読めないprocess（別の権限のserviceなど）も返す。pidが使い回された先を「別のprocess」と確かめるのに要る。
     // 開始時刻を読めない行も、pidがprocess表にある印として返す。
+    // WMI（Win32_Process）は使わない。絞っても1回に0.1〜0.3秒かかり、WMIの側のprocess（wmiprvse）のCPUを使う
+    // （process 1300個のWindowsで測った 2026-10-12。ADR 0112）。.NETのprocessの読み（OpenProcessとGetProcessTimes）は1個1.5ミリ秒。
+    // 開始時刻は同じ値になる（WMIはマイクロ秒で切り捨てた値を返し、どちらも1ミリ秒で切り捨てて使う。888個のprocessで食い違いは0）。
+    // 権限が無くて読めないprocessだけ、WMIへ聞き直す。
     const script = [
         ...WINDOWS_PROBE_HEADER,
-        `$rows=@(Get-CimInstance Win32_Process -Filter "${wanted.map(pid => `ProcessId=${pid}`).join(" OR ")}" | ForEach-Object {`,
-        "[ordered]@{ pid=[int]$_.ProcessId; started_identity=$(if ($null -ne $_.CreationDate) { $_.CreationDate.ToUniversalTime().ToString('o') } else { $null }) }",
-        "})",
+        "$rows=@()",
+        `foreach ($id in @(${wanted.join(",")})) {`,
+        "  try { $p=[Diagnostics.Process]::GetProcessById($id) } catch [ArgumentException] { continue }",
+        "  $started=$null",
+        "  try { $started=$p.StartTime.ToUniversalTime().ToString('o') }",
+        "  catch [InvalidOperationException] { continue }",
+        "  catch {",
+        "    $w=Get-CimInstance Win32_Process -Filter \"ProcessId=$id\" -Property CreationDate",
+        "    if ($null -eq $w) { continue }",
+        "    if ($null -ne $w.CreationDate) { $started=$w.CreationDate.ToUniversalTime().ToString('o') }",
+        "  }",
+        "  $rows += [ordered]@{ pid=[int]$id; started_identity=$started }",
+        "}",
         "ConvertTo-Json -Compress -InputObject $rows",
     ].join("\n");
     const result = spawnSync(resolveWindowsPowerShell7(), [...WINDOWS_PROBE_ARGS, Buffer.from(script, "utf16le").toString("base64")], {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.58.3",
+  "version": "0.58.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": [
@@ -72,7 +72,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "aiterm-steer-delivery": "^0.4.3",
+    "aiterm-steer-delivery": "^0.4.5",
     "ws": "8.21.3",
     "zod": "^4.4.3"
   },