aiterm-mcp 0.51.1 → 0.51.3

package/CHANGELOG.md

@@ -7,6 +7,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.51.3] - 2026-10-04
+
+### 修正
+
+- 完了待ちが、子の答えを待つ間ずっと、100msごとに`tmux capture-pane`を起動していた（ADR 0085）。利用上限の知らせを、完了の見回りの
+  たびに画面から確かめていたため。待ち1本で8秒に76回、4本重なった時はBellTeamのコンテナのCPUが148%だった。画面を読むのは、
+  Claude・Grokが2秒に1回、Cursorが1秒に1回（1回の画面で利用上限とhook拒否の両方を見る）にした。直した版は、待ち1本・8秒で
+  Claude Codeの子が4回、Cursorの子が8回。完了の見回り（100ms）は変えていない。子が利用上限で止まった時に`rate_limited`を返すのが、
+  最長で2秒（Cursorは1秒）遅れる。
+- 親配送の回収で、pidは居ると出るがOSのprocess表に無い持ち主を、終了として閉じる（ADR 0086）。Windowsでは、終了したprocessの
+  pidが、誰かがhandleを握っている間は空かずに残る。0.51.2はこの持ち主を閉じず、この版より前のMCP processが5秒おきに照会し続けていた
+  （実物で、3つのMCP processが各々1分に22〜24回）。process表にはあるが開始時刻を読めない持ち主だけ、今までどおり60秒に1回問い合わせる。
+  pidが無い持ち主も、この版より前のMCP processが生きていて保存場所を消せない間は、`closed`を書いておく。
+  `owner.json`の`closed_reason`に`process_gone`が増える。0.51.2へ戻しても、そのまま動く。
+
+## [0.51.2] - 2026-10-04
+
+### 修正
+
+- 親配送の回収が、終了した持ち主の保存場所を残し続け、使い回されたpidを5秒おきにOSへ問い合わせていた（ADR 0084）。
+  Windowsでは問い合わせがPowerShellの起動で、MCP process 1つが約2.5秒に1回起こし続けていた（実物で、長く動く4つが85秒に約260回。
+  保存場所は約1,620）。macOSでは`ps`。記録を引き取り終えた保存場所は、自分で閉じた持ち主とpidの無い持ち主のものを消す。
+  pidが別のprocessへ使い回された持ち主は`owner.json`を`closed`へ書き換え、どの版の回収にも照合を繰り返させない。
+  開始時刻を照合できない持ち主は60秒に1回だけ問い合わせる。この版より前のMCP processが同じ置き場で生きている間は、保存場所を消さない。
+  `owner.json`に`removal_safe`と`closed_reason`が増える。前の版へ戻しても、そのまま動く（前の版はこの2つを読まない）。
+- Windowsの開始時刻の照会が、CommandLineを読めないprocessを結果から落としていた。pidがserviceへ使い回された時に、
+  別のprocessと確かめられなかった。
+- `pty_observe`の`activity.post_startup_process_count`で、Aitermがprocessの一覧を引くために起こすprocess
+  （`ps`、WindowsのPowerShellとそのconsole host）を数えない。Windowsで、何もしていない席の数が0と2を行き来していた。
+
 ## [0.51.1] - 2026-10-04
 
 ### 修正
@@ -2060,7 +2090,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.51.1...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.51.3...HEAD
+[0.51.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.51.2...v0.51.3
+[0.51.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.51.1...v0.51.2
 [0.51.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.51.0...v0.51.1
 [0.51.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.50.0...v0.51.0
 [0.50.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.49.0...v0.50.0

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.51.1** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.51.3** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -520,7 +520,7 @@ agent sessionを閉じると失うものは、次の2項目で分かる。`activ
 完了した時点（初手を送る前）に居なかったprocessの数。起動直後の1分に始めた裏の作業も数える。数えないものは2つ。Codex自身の
 補助process（`codex-code-mode-host`）と、中継`mcp-lazy`の直接の子（初めて使う時に起こすMCPの本体と、先行起動の判定）。
 その下で動くprocessは数える。harnessが立て直した起動時のprocess（終了した起動時のprocessと同じ親の下に、同じargvで立ったもの。
-つなぎ直したMCPなど）も数えない。`pending_child_deliveries`は、そのsessionが親として待っていて、まだ届け終えていない
+つなぎ直したMCPなど）も数えない。Aitermがprocessの一覧を引くために起こすprocess（`ps`、WindowsではPowerShellとそのconsole host）も数えない。`pending_child_deliveries`は、そのsessionが親として待っていて、まだ届け終えていない
 子の結果の数。呼び出した側が誰でも付く。どちらも、分からない時はnull（通常PTY、harnessのprocessを特定できない時。
 processの数は0.48.0以前が起動したagentも）。別端末が旧版の時は項目ごと無い。nullと項目なしは「分からない」で、0ではない。
 

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.51.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.51.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
 
@@ -553,7 +553,8 @@ processes in the session that did not exist when `agent_launch` finished startup
 started in the first minute is counted too. Two kinds of process are not counted: Codex's own `codex-code-mode-host` helper, and
 the direct children of an `mcp-lazy` relay (the MCP server it starts on first use and its wake predicate). What runs below them
 is counted. A startup process that the harness restarted (a process with the same parent and the same arguments as a startup
-process that has exited, such as a reconnected MCP server) is not counted either. `pending_child_deliveries`
+process that has exited, such as a reconnected MCP server) is not counted either, and neither are the processes Aiterm itself
+starts to read the process table (`ps`, or PowerShell and its console host on Windows). `pending_child_deliveries`
 is the number of sub-agent results this session is still waiting for as a parent, whoever the caller is. Both are null when
 Aiterm cannot tell (ordinary terminals, agents launched by 0.48.0 or earlier for the process count, or an unresolved harness
 process), and may be absent when a remote host runs an older Aiterm. Treat null or absent as unknown, not as zero.

package/dist/agent-shared.js

@@ -85,6 +85,22 @@ export function shq(s) {
 }
 export const LAUNCH_ID_RE = /^[0-9a-f]{32}$/;
 export const AGENT_DONE_POLL_MS = 100;
+// 完了待ちの中で画面を読む間隔。画面を読むたびにtmux（capture-pane）を1回起動するので、完了の見回りとは別に持つ。
+// 画面でしか分からないのは利用上限の知らせとCursorのhook拒否の表示で、どちらも数秒は画面に残る。
+export const AGENT_RATE_LIMIT_POLL_MS = 2_000;
+// Cursorのhook拒否の表示は数秒で消える。見えている間に1回は読む。
+export const CURSOR_SCREEN_POLL_MS = 1_000;
+/** 最初の呼び出しと、前にtrueを返してから間隔が空いた呼び出しだけtrueを返す。 */
+export function pollGate(intervalMs, now = () => performance.now()) {
+    let last = -Infinity;
+    return () => {
+        const at = now();
+        if (at - last < intervalMs)
+            return false;
+        last = at;
+        return true;
+    };
+}
 export const AGENT_EVENT_MAX_BYTES = 1024 * 1024;
 export const AGENT_EVENT_TAIL_BYTES = 64 * 1024;
 export const CODEX_TRANSCRIPT_INCREMENT_MAX_BYTES = 16 * 1024 * 1024;

package/dist/core.js

@@ -16,10 +16,10 @@ import * as rtk from "./rtk.js";
 import { isCursorMcpClient } from "aiterm-steer-delivery";
 import { paneTokenHint } from "./harnesses/pane-tokens.js";
 import { unfinishedDeliveriesOwnedBy } from "./parent-delivery-owners.js";
-import { readRuntimeProcesses, processSubtree, parentProcess, processIdentity, backgroundProcesses, lazyRelayProcess } from "./process-runtime.js";
+import { readRuntimeProcesses, processSubtree, parentProcess, processIdentity, backgroundProcesses, lazyRelayProcess, aitermProcessProbe, windowsConsoleHost } from "./process-runtime.js";
 import { AitermError, telemetryOwnedFailure, ownTelemetryFailure } from "./errors.js";
 import { isWin, SOCKDIR, tmuxCommand, sendPsmuxPayload, loadPtyBufferChunk, pasteBufferBaseArgs, tmuxNewSession, registeredSessionEnvironment, attachCommand, normalizePaneCommand, atomicShellMultiline, appendMarkSentinel, markShellCommand, settlePaneLog, paneCwdArgument, sessionEnvironmentLaunch, } from "./tmux-runtime.js";
-import { sleep, currentUid, runtimeStateBase, safeStatSize, readFileRange, writeJson0600, createEmpty0600, shq, LAUNCH_ID_RE, AGENT_DONE_POLL_MS, AGENT_EVENT_MAX_BYTES, assertSessionName, agentsDir, agentEventPath, agentMetadataPath, writeAgentMetadata, AGENT_EVENT_TAIL_BYTES, agentLabel, agentHarness, subagentInstruction, agentLineageFields, } from "./agent-shared.js";
+import { sleep, currentUid, runtimeStateBase, safeStatSize, readFileRange, writeJson0600, createEmpty0600, shq, LAUNCH_ID_RE, AGENT_DONE_POLL_MS, AGENT_RATE_LIMIT_POLL_MS, pollGate, AGENT_EVENT_MAX_BYTES, assertSessionName, agentsDir, agentEventPath, agentMetadataPath, writeAgentMetadata, AGENT_EVENT_TAIL_BYTES, agentLabel, agentHarness, subagentInstruction, agentLineageFields, } from "./agent-shared.js";
 import { catalogUnavailable } from "./model-catalog.js";
 import { grokAuthPlan, grokAuthStatus, grokAuthPane, realGrokHome, resolveAndValidateGrokAuth, assertGrokModelAvailable, grokModelChoices, grokEventsTranscript, latestGrokCompletion, observeGrokDone, buildGrokAgentCmd, grokLaunchNote, grokEnvTokens, grokTuiReady, grokTuiBusy, grokPaneObservation, grokRateLimitDialog, grokStartupAction, grokLaunchBlockingDialog, assertGrokSandboxNotRejected, GROK_COMPOSER_MARKER_RE, grokFooterHasConfiguration, grokTranscriptText, createGrokAgentMetadata, } from "./harnesses/grok.js";
 import { codexAuthPlan, codexAuthStatus, codexAuthPane, bindCodexTranscriptSession, latestCodexCompletion, observeCodexDone, buildCodexAgentCmd, codexLaunchNote, codexTuiReady, codexPaneObservation, codexHelperProcess, codexRateLimitModelSwitchDialog, codexApprovalDialog, codexStartupAction, CODEX_COMPOSER_MARKER_RE, codexModelChoice, codexEffortChoice, codexMoreReasoningChoice, codexTranscriptText, createCodexAgentMetadata, codexModelChoices, } from "./harnesses/codex.js";
@@ -1090,7 +1090,7 @@ export function startupProcessShapes(identities, rows) {
         return [{ identity, parent: parent ? processKey(parent) : null, argv_digest: row.argv_digest }];
     });
 }
-// 起動完了の控えに無いprocessの数。harnessと中継が自分のために立てるprocessは、利用者の作業ではないので数えない。
+// 起動完了の控えに無いprocessの数。harness・中継・Aitermが自分のために立てるprocessは、利用者の作業ではないので数えない。
 // その下で動くprocessは数える。
 // harnessは起動の足場（MCP、language server）を自分で立て直す。控えた後に立て直されると、控えに無いprocessとして残る。
 // 控えの物が終了していて、同じ親の下に同じargvで立ったprocessは、その立て直しとして数えない。
@@ -1101,9 +1101,17 @@ export function postStartupProcessCount(kind, activityRows, rows, startup, shape
         const parent = parentProcess(row, byPid);
         return parent !== undefined && lazyRelayProcess(parent.command);
     };
+    // 席の中のAitermも、配送の持ち主の生存確認でprocess表を引く。その問い合わせと、付いて立つconsole hostは数えない。
+    // 親の問い合わせが先に終わって残ったconsole hostも同じ扱いにする（console hostは最後のconsole processと一緒に消える）。
+    const ownProbe = (row) => {
+        if (aitermProcessProbe(row.command))
+            return true;
+        const parent = parentProcess(row, byPid);
+        return windowsConsoleHost(row) && (parent === undefined || aitermProcessProbe(parent.command));
+    };
     const present = new Set(activityRows.map(processKey));
     const added = new Map(activityRows
-        .filter(row => !startup.has(processKey(row)) && !(kind === "codex" && codexHelperProcess(row.command)) && !relayChild(row))
+        .filter(row => !startup.has(processKey(row)) && !(kind === "codex" && codexHelperProcess(row.command)) && !relayChild(row) && !ownProbe(row))
         .map(row => [processKey(row), row]));
     const gone = shapes.filter(shape => startup.has(shape.identity) && !present.has(shape.identity));
     const replacedBy = new Map();
@@ -2754,7 +2762,7 @@ export async function observeAgentDone(name, o = {}) {
         return observeCodexDone(meta, timeout, o.cursor, o.signal);
     }
     if (meta.kind === "cursor" && meta.completion_route === "cursor_transcript") {
-        return observeCursorDone(meta, timeout, o.cursor, detectAgentRateLimit, (session) => captureScreen(session, 0), o.signal);
+        return observeCursorDone(meta, timeout, o.cursor, (session) => captureScreen(session, 0), o.signal);
     }
     if (meta.kind === "grok" && meta.completion_route === "grok_transcript") {
         return observeGrokDone(meta, timeout, o.cursor, detectAgentRateLimit, o.signal);
@@ -2772,6 +2780,9 @@ export async function observeAgentDone(name, o = {}) {
     const transcriptFile = claudeSessionTranscriptPath(meta);
     let transcriptCursor = transcriptFile ? safeStatSize(transcriptFile) : 0;
     let transcriptCarry = "";
+    // 利用上限の知らせは画面でしか分からない。画面を読むとtmuxを起動するので、完了の見回りより間隔を空ける。
+    // 実被弾: 完了の見回り（100ms）のたびに読んでいて、待ち1本が1秒に約10回tmuxを起動していた（4本でコンテナのCPUが148%）。
+    const rateLimitDue = pollGate(AGENT_RATE_LIMIT_POLL_MS);
     const observation = (outcome, ev = null, rateLimit = null, apiError = null) => ({
         schema: "aiterm.agent-wait-result.v1",
         session_id: meta.aiterm_session,
@@ -2832,7 +2843,8 @@ export async function observeAgentDone(name, o = {}) {
         }
         // timeout=0 は「待たずに一度だけ見る」照会＝未完了は失敗ではなく running。
         // 1秒以上を指定した待機の未完了は従来どおり timeout で、待ち方の意味は変えない。
-        {
+        // 最初の周回では必ず見る（timeout=0の照会も1回は見る）。
+        if (rateLimitDue()) {
             const limited = detectAgentRateLimit(meta.kind, meta.aiterm_session);
             if (limited)
                 return observation("rate_limited", null, limited);

package/dist/harnesses/cursor.js

@@ -8,7 +8,7 @@ import { randomBytes } from "node:crypto";
 import { AitermError } from "../errors.js";
 import { spawnAgentControlCommand } from "../agent-resolver.js";
 import { checkedCatalog } from "../model-catalog.js";
-import { AGENT_DONE_POLL_MS, AGENT_EVENT_MAX_BYTES, agentEventPath, agentHarness, agentLineageFields, agentMetadataPath, createEmpty0600, readFileRange, safeStatSize, shq, sleep, subagentInstruction, writeAgentMetadata, writeScopeLaunchNote, } from "../agent-shared.js";
+import { AGENT_DONE_POLL_MS, CURSOR_SCREEN_POLL_MS, pollGate, AGENT_EVENT_MAX_BYTES, agentEventPath, agentHarness, agentLineageFields, agentMetadataPath, createEmpty0600, readFileRange, safeStatSize, shq, sleep, subagentInstruction, writeAgentMetadata, writeScopeLaunchNote, } from "../agent-shared.js";
 const CURSOR_TRANSCRIPT_MATCH_MAX_BYTES = 1024 * 1024;
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 // Cursor Agentはextended keyboard protocolを有効にするため、通常のtmux Enterではなく
@@ -185,12 +185,14 @@ export function latestCursorCompletion(meta, readTranscriptLines) {
         ? cursorCompletionEvent(meta, harnessSessionId, state.terminalRecord, `cursor:${state.userTurns}`)
         : null;
 }
-export async function observeCursorDone(meta, timeout, requestedCursor, detectRateLimit, readScreen, signal) {
+export async function observeCursorDone(meta, timeout, requestedCursor, readScreen, signal) {
     const metadataFile = agentMetadataPath(meta.aiterm_session, meta.launch_id);
     let transcript = cursorTranscript(meta);
     const startBoundary = requestedCursor ?? (transcript ? cursorTranscriptState(transcript).userTurns : 0);
     let malformedEvents = 0;
     const deadline = performance.now() + timeout * 1000;
+    // 画面を読むたびにtmuxを1回起動する。完了の見回りより間隔を空け、1回読んだ画面で利用上限とhook拒否の両方を見る。
+    const screenDue = pollGate(CURSOR_SCREEN_POLL_MS);
     const observation = (outcome, ev = null, rateLimit = null, error = null) => ({
         schema: "aiterm.agent-wait-result.v1",
         session_id: meta.aiterm_session,
@@ -221,13 +223,17 @@ export async function observeCursorDone(meta, timeout, requestedCursor, detectRa
                     return observation("done", done);
             }
         }
-        const limited = detectRateLimit(meta.kind, meta.aiterm_session);
-        if (limited)
-            return observation("rate_limited", null, limited);
-        // 拒否されたpromptのturnは始まらず、完了も来ない。拒否の表示は数秒で消えるので、見えている間に終わらせる。
-        const hookBlocked = cursorHookBlocked(readScreen(meta.aiterm_session));
-        if (hookBlocked)
-            return observation("error", null, null, `USER_HOOK_BLOCKED: ${hookBlocked.message}`);
+        // 最初の周回では必ず読む（timeout=0の照会も1回は読む）。
+        if (screenDue()) {
+            const screen = readScreen(meta.aiterm_session);
+            const limited = cursorUsageLimit(screen)?.message ?? null;
+            if (limited)
+                return observation("rate_limited", null, limited);
+            // 拒否されたpromptのturnは始まらず、完了も来ない。拒否の表示は数秒で消えるので、見えている間に終わらせる。
+            const hookBlocked = cursorHookBlocked(screen);
+            if (hookBlocked)
+                return observation("error", null, null, `USER_HOOK_BLOCKED: ${hookBlocked.message}`);
+        }
         if (performance.now() >= deadline)
             return observation(timeout === 0 ? "running" : "timeout");
         await sleep(AGENT_DONE_POLL_MS);

package/dist/harnesses/grok.js

@@ -10,7 +10,7 @@ import { randomBytes, randomUUID } from "node:crypto";
 import { AitermError } from "../errors.js";
 import { runAgentProtocolCommand, spawnAgentControlCommand } from "../agent-resolver.js";
 import { catalogInvalid, catalogUnavailable, checkedCatalog, findJsonLine, processSummary } from "../model-catalog.js";
-import { shq, subagentInstruction, writeScopeLaunchNote, safeStatSize, readFileRange, sleep, agentMetadataPath, writeAgentMetadata, agentEventPath, createEmpty0600, agentLineageFields, AGENT_DONE_POLL_MS, AGENT_EVENT_MAX_BYTES, GROK_TRANSCRIPT_INCREMENT_MAX_BYTES, agentHarness, } from "../agent-shared.js";
+import { shq, subagentInstruction, writeScopeLaunchNote, safeStatSize, readFileRange, sleep, agentMetadataPath, writeAgentMetadata, agentEventPath, createEmpty0600, agentLineageFields, AGENT_DONE_POLL_MS, AGENT_RATE_LIMIT_POLL_MS, pollGate, AGENT_EVENT_MAX_BYTES, GROK_TRANSCRIPT_INCREMENT_MAX_BYTES, agentHarness, } from "../agent-shared.js";
 const GROK_MODELS_MAX_BYTES = 1024 * 1024;
 const GROK_MODELS_TIMEOUT_MS = 15_000;
 // grok CLI はモデル未指定だと端末側 default に従うため、ツール契約として既定 slug を固定する。
@@ -229,6 +229,7 @@ export async function observeGrokDone(meta, timeout, requestedCursor, detectRate
     let discardLeadingFragment = false;
     let initializedBoundary = false;
     const deadline = performance.now() + timeout * 1000;
+    const rateLimitDue = pollGate(AGENT_RATE_LIMIT_POLL_MS);
     const observation = (outcome, ev = null, rateLimit = null) => ({
         schema: "aiterm.agent-wait-result.v1",
         session_id: meta.aiterm_session,
@@ -293,7 +294,8 @@ export async function observeGrokDone(meta, timeout, requestedCursor, detectRate
                 }
             }
         }
-        {
+        // 質問カードの確認は画面を読む（tmuxを起動する）。完了の見回りより間隔を空け、最初の周回では必ず見る。
+        if (rateLimitDue()) {
             const limited = detectRateLimit(meta.kind, meta.aiterm_session);
             if (limited)
                 return observation("rate_limited", null, limited);

package/dist/parent-delivery.js

@@ -62,6 +62,8 @@ async function submitParentAnswer(parent, deliveryId, text) {
 // 5秒おきの確認はpidの存在だけを見て、開始時刻は初めて見た持ち主とこの間隔でだけ照合する。
 // 持ち主が終了した直後に同じpidが再利用された時だけ、回収が最長でこの間隔だけ遅れる。生きている持ち主の記録は引き取らない。
 const OWNER_IDENTITY_RECHECK_MS = 60_000;
+// owner.jsonの無い保存場所を、作っている途中の持ち主として扱う時間。
+const OWNER_SETUP_GRACE_MS = 60_000;
 function processExists(pid) {
     // 0以下はprocess groupを指す。持ち主のpidにはならない。
     if (pid <= 0)
@@ -74,6 +76,14 @@ function processExists(pid) {
         return error.code === "EPERM";
     }
 }
+function ownerSetupInProgress(directory) {
+    try {
+        return Date.now() - fs.statSync(directory).mtimeMs < OWNER_SETUP_GRACE_MS;
+    }
+    catch {
+        return false;
+    }
+}
 function readRecord(file) {
     try {
         const record = recordSchema.parse(JSON.parse(fs.readFileSync(file, "utf8")));
@@ -115,7 +125,7 @@ export class ParentDeliveryManager {
     registering = new Map();
     timer;
     recovering = null;
-    // 他の持ち主の開始時刻を最後に照合した時刻（持ち主の保存場所ごと）。
+    // 他の持ち主の開始時刻を最後に照合した時刻と結果（持ち主の保存場所ごと）。照合できなかった結果も覚える。
     verifiedOwners = new Map();
     serviceError = null;
     closing = false;
@@ -139,9 +149,9 @@ export class ParentDeliveryManager {
         this.results = path.join(this.root, "results");
         this.claims = path.join(options.root ?? path.join(stateRoot, prefix + "parent-deliveries"), "claims");
         const ownProcess = this.deps.processes([process.pid]).find((entry) => entry.pid === process.pid);
-        if (!ownProcess)
+        if (!ownProcess || ownProcess.started_identity === null)
             throw new AitermError("PARENT_DELIVERY_OWNER_UNKNOWN: 配送processを識別できません", 2);
-        this.owner = { pid: process.pid, started_identity: ownProcess.started_identity, closed: false };
+        this.owner = { pid: process.pid, started_identity: ownProcess.started_identity, closed: false, removal_safe: true };
         this.ownerDir = path.join(this.active, `${deliveryOwnerPrefix(this.owner)}${randomUUID()}`);
         fs.mkdirSync(this.ownerDir, { recursive: true, mode: 0o700 });
         fs.mkdirSync(this.results, { recursive: true, mode: 0o700 });
@@ -361,7 +371,17 @@ export class ParentDeliveryManager {
                 if (!owner.isDirectory())
                     continue;
                 const directory = path.join(active, owner.name);
-                files.push(...fs.readdirSync(directory).filter((name) => name !== "owner.json" && name.endsWith(".json")).map((name) => path.join(directory, name)));
+                let names;
+                // 一覧を取った後に、回収が終了した持ち主の保存場所を消す事がある。
+                try {
+                    names = fs.readdirSync(directory);
+                }
+                catch (error) {
+                    if (error.code === "ENOENT")
+                        continue;
+                    throw error;
+                }
+                files.push(...names.filter((name) => name !== "owner.json" && name.endsWith(".json")).map((name) => path.join(directory, name)));
             }
         }
         return files;
@@ -399,7 +419,7 @@ export class ParentDeliveryManager {
         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 alive = new Map();
+        const fate = new Map();
         const unverified = [];
         for (const directory of directories) {
             let owner;
@@ -413,46 +433,83 @@ export class ParentDeliveryManager {
                 continue;
             const pid = owner.pid;
             if (!this.deps.exists(pid)) {
-                alive.set(directory.name, false);
+                fate.set(directory.name, "gone");
                 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)
-                alive.set(directory.name, true);
+                fate.set(directory.name, verified.alive ? "alive" : "unverified");
             else
                 unverified.push({ name: directory.name, pid, started_identity: owner.started_identity });
         }
         if (unverified.length > 0) {
             const processes = this.deps.processes([...new Set(unverified.map((entry) => entry.pid))]);
             for (const entry of unverified) {
-                const same = processes.some((row) => row.pid === entry.pid && row.started_identity === entry.started_identity);
-                alive.set(entry.name, same);
-                if (same)
-                    this.verifiedOwners.set(entry.name, { pid: entry.pid, started_identity: entry.started_identity, at: now });
+                const row = processes.find((candidate) => candidate.pid === entry.pid);
+                // pidは居ると出たのにprocess表に無いのは、照会の直前に終了したか、終了したprocessの名残
+                // （Windowsでは、誰かがhandleを握っている間、終了したprocessのpidが空かず、権限の低いprocessからは「居るが開けない」と見える）。
+                const state = !row ? "vanished" : row.started_identity === null ? "unverified"
+                    : row.started_identity === entry.started_identity ? "alive" : "reused";
+                fate.set(entry.name, state);
+                // 終了と分かった持ち主は下で閉じるので、照合の結果を覚えない。
+                if (state === "alive" || state === "unverified") {
+                    this.verifiedOwners.set(entry.name, { pid: entry.pid, started_identity: entry.started_identity, at: now, alive: state === "alive" });
+                }
             }
         }
-        for (const name of this.verifiedOwners.keys())
-            if (alive.get(name) !== true)
+        for (const name of this.verifiedOwners.keys()) {
+            const state = fate.get(name);
+            if (state !== "alive" && state !== "unverified")
                 this.verifiedOwners.delete(name);
+        }
+        // 記録を引き取り終えた、終了した持ち主の保存場所。残すと、回収のたびに全部を読み直す。
+        const finished = [];
+        // pidが無いと分かった、closeしていない持ち主。保存場所を消せない回は、閉じた事だけを書く。
+        const goneOwners = [];
+        // owner.jsonの無い、古い保存場所。
+        const abandoned = [];
+        // 旧版は、読んでいる最中に他の持ち主の保存場所が消えると回収が止まる。印の無い持ち主が生きている間は消さない。
+        let removalBlocked = false;
         for (const directory of directories) {
             const oldDir = path.join(this.active, directory.name);
+            const ownerFile = path.join(oldDir, "owner.json");
             let owner;
             try {
-                owner = JSON.parse(fs.readFileSync(path.join(oldDir, "owner.json"), "utf8"));
+                owner = JSON.parse(fs.readFileSync(ownerFile, "utf8"));
             }
             catch (error) {
-                if (error.code === "ENOENT")
-                    continue;
-                throw new AitermError("PARENT_DELIVERY_OWNER_INVALID: 配送所有者の記録を読めません", 2);
+                if (error.code !== "ENOENT")
+                    throw new AitermError("PARENT_DELIVERY_OWNER_INVALID: 配送所有者の記録を読めません", 2);
+                // 作っている途中の持ち主は版が分からない。
+                if (ownerSetupInProgress(oldDir))
+                    removalBlocked = true;
+                else
+                    abandoned.push(oldDir);
+                continue;
             }
             if (!Number.isSafeInteger(owner.pid) || typeof owner.started_identity !== "string" || typeof owner.closed !== "boolean") {
                 throw new AitermError("PARENT_DELIVERY_OWNER_INVALID: 配送所有者の形式が不正です", 2);
             }
+            const state = fate.get(directory.name);
             // 生死を確かめた後に現れた持ち主は、次の回で扱う。生きている持ち主の記録は引き取らない。
-            if (!owner.closed && alive.get(directory.name) !== false)
+            if (!owner.closed && (state === undefined || state === "alive")) {
+                if (owner.removal_safe !== true)
+                    removalBlocked = true;
                 continue;
-            for (const name of fs.readdirSync(oldDir).filter((name) => name !== "owner.json" && name.endsWith(".json"))) {
+            }
+            if (!owner.closed && state === "unverified" && owner.removal_safe !== true)
+                removalBlocked = true;
+            let names;
+            try {
+                names = fs.readdirSync(oldDir);
+            }
+            catch (error) {
+                if (error.code === "ENOENT")
+                    continue;
+                throw error;
+            }
+            for (const name of names.filter((name) => name !== "owner.json" && name.endsWith(".json"))) {
                 const oldFile = path.join(oldDir, name);
                 const file = path.join(this.ownerDir, name);
                 // 元のpathが消えるrenameを使うため、同じ旧recordを二つのprocessで回収できない。
@@ -490,9 +547,53 @@ export class ParentDeliveryManager {
                 else
                     this.finish(job);
             }
+            if (!owner.closed && (state === "reused" || state === "vanished")) {
+                // 同じpidと開始時刻の組は二度と現れない。閉じた事にして、どの版の回収にも照合を繰り返させない。
+                // 書けなかった時は次の回でもう一度照合する。配送には影響しない。
+                const reason = state === "reused" ? "pid_reused" : "process_gone";
+                try {
+                    writeJson0600(ownerFile, { ...owner, closed: true, closed_reason: reason });
+                }
+                catch { /* 次の回 */ }
+                continue;
+            }
+            // 持ち主が自分で閉じた保存場所と、pidがもう無い持ち主の保存場所だけを消す。
+            // 回収側が閉じた保存場所は、そのpidが空くまで残す。
+            const ended = owner.closed ? owner.closed_reason === undefined || !this.deps.exists(owner.pid) : state === "gone";
+            if (ended)
+                finished.push(oldDir);
+            if (!owner.closed && state === "gone")
+                goneOwners.push({ file: ownerFile, owner });
+        }
+        if (removalBlocked) {
+            // 消せない間も、終了した持ち主は閉じておく。pidの有無は見る側の権限で変わる事があり（ADR 0086）、
+            // 閉じていない持ち主は、前の版の回収が照会の相手にし続ける。
+            for (const { file, owner } of goneOwners) {
+                try {
+                    writeJson0600(file, { ...owner, closed: true, closed_reason: "process_gone" });
+                }
+                catch { /* 次の回 */ }
+            }
+            return;
+        }
+        // 片付けの失敗は配送に影響しない。残った保存場所は次の回でもう一度消す。
+        for (const directory of finished) {
+            try {
+                fs.rmSync(directory, { recursive: true, force: true });
+            }
+            catch { /* 次の回 */ }
+        }
+        for (const directory of abandoned) {
+            try {
+                fs.rmdirSync(directory);
+            }
+            catch { /* 空でない、または既に無い */ }
         }
     }
     async close() {
+        // 閉じた後の保存場所は、記録を引き取った他の持ち主が消す。二度目のcloseは何も書かない。
+        if (this.owner.closed)
+            return;
         this.closing = true;
         clearInterval(this.timer);
         await this.recovering;

package/dist/process-runtime.js

@@ -32,9 +32,32 @@ export function parsePosixProcessTable(text) {
         };
     });
 }
+// AitermがOSのprocess表を引く時のコマンドの形。席のprocessを数える側が、これを利用者の作業と取り違えないために使う。
+const POSIX_PS = "/bin/ps";
+const POSIX_TABLE_ARGS = ["-axww", "-o", "pid=,ppid=,pgid=,stat=,lstart=,time=,command="];
+const POSIX_IDENTITY_ARGS = ["-o", "pid=,lstart=", "-p"];
+const WINDOWS_PROBE_HEADER = ["$ErrorActionPreference='Stop'", "[Console]::OutputEncoding=[Text.UTF8Encoding]::new($false)"];
+const WINDOWS_PROBE_ARGS = ["-NoLogo", "-NoProfile", "-NonInteractive", "-EncodedCommand"];
+// 先頭2行だけのbase64。3 byteの区切りで切り、後ろの行に左右されない前方一致にする。
+const WINDOWS_PROBE_PREFIX = (() => {
+    const bytes = Buffer.from(WINDOWS_PROBE_HEADER.join("\n") + "\n", "utf16le");
+    return bytes.subarray(0, bytes.length - bytes.length % 3).toString("base64");
+})();
+/** Aitermがprocess表を引くために起こしたprocessか。引く側のAitermは、数えられる席の中のMCP processでもある。 */
+export function aitermProcessProbe(command) {
+    if (command.includes(` ${WINDOWS_PROBE_ARGS.join(" ")} ${WINDOWS_PROBE_PREFIX}`))
+        return true;
+    return command === `${POSIX_PS} ${POSIX_TABLE_ARGS.join(" ")}` || command.startsWith(`${POSIX_PS} ${POSIX_IDENTITY_ARGS.join(" ")} `);
+}
+/** Windowsのconsole host。console processの起動に付いて立ち、最後のconsole processが終わると消える。 */
+export function windowsConsoleHost(row) {
+    const first = /^(?:"([^"]+)"|(\S+))/.exec(row.command);
+    const name = (row.executable || first?.[1] || first?.[2] || "").replace(/\\/g, "/");
+    return path.posix.basename(name).toLowerCase() === "conhost.exe";
+}
 export function readRuntimeProcesses() {
     if (!isWin) {
-        const result = spawnSync("/bin/ps", ["-axww", "-o", "pid=,ppid=,pgid=,stat=,lstart=,time=,command="], {
+        const result = spawnSync(POSIX_PS, POSIX_TABLE_ARGS, {
             encoding: "utf8", env: { ...process.env, LC_ALL: "C" }, timeout: 10000, maxBuffer: 16 * 1024 * 1024,
         });
         if (result.error || result.status !== 0)
@@ -42,13 +65,12 @@ export function readRuntimeProcesses() {
         return parsePosixProcessTable(result.stdout);
     }
     const script = [
-        "$ErrorActionPreference='Stop'",
-        "[Console]::OutputEncoding=[Text.UTF8Encoding]::new($false)",
+        ...WINDOWS_PROBE_HEADER,
         "@(Get-CimInstance Win32_Process | Where-Object { $null -ne $_.CreationDate -and $null -ne $_.CommandLine } | ForEach-Object {",
         "[ordered]@{ pid=[int]$_.ProcessId; parent_pid=[int]$_.ParentProcessId; executable=[string]$_.ExecutablePath; started_identity=$_.CreationDate.ToUniversalTime().ToString('o'); command=$_.CommandLine; cpu_seconds=([double]$_.KernelModeTime+[double]$_.UserModeTime)/10000000 }",
         "}) | ConvertTo-Json -Compress",
     ].join("\n");
-    const result = spawnSync(resolveWindowsPowerShell7(), ["-NoLogo", "-NoProfile", "-NonInteractive", "-EncodedCommand", Buffer.from(script, "utf16le").toString("base64")], {
+    const result = spawnSync(resolveWindowsPowerShell7(), [...WINDOWS_PROBE_ARGS, Buffer.from(script, "utf16le").toString("base64")], {
         encoding: "utf8", timeout: 15000, maxBuffer: 16 * 1024 * 1024, windowsHide: true,
     });
     if (result.error || result.status !== 0)
@@ -78,6 +100,7 @@ export function readRuntimeProcesses() {
 }
 /**
  * 指定したpidの開始時刻だけを引く。readRuntimeProcessesと同じ開始時刻を返し、存在しないpidは結果に含めない。
+ * process表にpidはあるが開始時刻を読めない時は、started_identityをnullで返す（pidが無いのとは区別する）。
  * 全processのargvを読む一覧取得は、processの多い端末で重い（定期実行から呼ばない）。
  */
 export function readProcessIdentities(pids) {
@@ -87,7 +110,7 @@ export function readProcessIdentities(pids) {
     if (wanted.some(pid => !Number.isSafeInteger(pid) || pid < 0))
         throw new AitermError("process照会のpidが不正です", 2);
     if (!isWin) {
-        const result = spawnSync("/bin/ps", ["-o", "pid=,lstart=", "-p", wanted.join(",")], {
+        const result = spawnSync(POSIX_PS, [...POSIX_IDENTITY_ARGS, wanted.join(",")], {
             encoding: "utf8", env: { ...process.env, LC_ALL: "C" }, timeout: 10000,
         });
         // 該当するprocessが一つも無い時、psは何も出さずstatus 1で終わる。
@@ -101,15 +124,16 @@ export function readProcessIdentities(pids) {
             return { pid: Number(match[1]), started_identity: match[2].trim() };
         });
     }
+    // CommandLineの読めないprocess（別の権限のserviceなど）も返す。pidが使い回された先を「別のprocess」と確かめるのに要る。
+    // 開始時刻を読めない行も、pidがprocess表にある印として返す。
     const script = [
-        "$ErrorActionPreference='Stop'",
-        "[Console]::OutputEncoding=[Text.UTF8Encoding]::new($false)",
-        `$rows=@(Get-CimInstance Win32_Process -Filter "${wanted.map(pid => `ProcessId=${pid}`).join(" OR ")}" | Where-Object { $null -ne $_.CreationDate -and $null -ne $_.CommandLine } | ForEach-Object {`,
-        "[ordered]@{ pid=[int]$_.ProcessId; started_identity=$_.CreationDate.ToUniversalTime().ToString('o') }",
+        ...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 }) }",
         "})",
         "ConvertTo-Json -Compress -InputObject $rows",
     ].join("\n");
-    const result = spawnSync(resolveWindowsPowerShell7(), ["-NoLogo", "-NoProfile", "-NonInteractive", "-EncodedCommand", Buffer.from(script, "utf16le").toString("base64")], {
+    const result = spawnSync(resolveWindowsPowerShell7(), [...WINDOWS_PROBE_ARGS, Buffer.from(script, "utf16le").toString("base64")], {
         encoding: "utf8", timeout: 15000, windowsHide: true,
     });
     if (result.error || result.status !== 0)
@@ -124,8 +148,11 @@ export function readProcessIdentities(pids) {
     if (!Array.isArray(rows))
         throw new AitermError("Windows process一覧が配列ではありません", 2);
     return rows.map(row => {
-        if (!row || !Number.isSafeInteger(row.pid) || typeof row.started_identity !== "string"
-            || !Number.isFinite(Date.parse(row.started_identity)))
+        if (!row || !Number.isSafeInteger(row.pid))
+            throw new AitermError("Windows process一覧のfieldが不正です", 2);
+        if (row.started_identity === null)
+            return { pid: row.pid, started_identity: null };
+        if (typeof row.started_identity !== "string" || !Number.isFinite(Date.parse(row.started_identity)))
             throw new AitermError("Windows process一覧のfieldが不正です", 2);
         return { pid: row.pid, started_identity: new Date(row.started_identity).toISOString() };
     });

package/docs/DESIGN.md

@@ -56,6 +56,7 @@ sessionを閉じると失うものは数で返す（ADR 0080）。`activity.post
 `pending_child_deliveries`はそのsessionが親として待つ未配送の数。数えられない時はnullで、0と区別する。
 harnessと中継が自分のために立てるprocessは数えない（Codexの`codex-code-mode-host`、中継`mcp-lazy`の直接の子。ADR 0082）。その下は数える。
 harnessが同じ親の下に同じargvで立て直した起動時のprocessも数えない（ADR 0083）。
+Aitermがprocess表を引くために起こしたprocess（`ps`、WindowsのPowerShellと付いて立つconsole host）も数えない（ADR 0084）。
 中継の後ろで眠っている本体を配送の引き取りのために起こすかは、`aiterm-delivery-wake`が返す（ADR 0082）。
 Claude Codeの入力待ちは、起動時の見出しが取得範囲から流れ出た後も、入力欄の形（`❯`行の上下の罫線）で読む。
 画面本文とargv本文は返さず、活動cursorには画面digestとprocess別CPUだけを持たせる。
@@ -151,6 +152,10 @@ Codexの配送記録と本文はAiterm stateの`parent-deliveries`へ保存す
 受信口が明示拒否した場合は`failed`、子の異常終了はそのoutcomeを配送する。
 生存の確認は5秒おきにpidの存在だけをOSへ聞き、開始識別子の照合は初めて見たownerと60秒に1回だけ行う。
 全processの一覧は取らない。終了直後に同じpidが再利用された時だけ、引き継ぎが最長60秒遅れる（ADR 0078）。
+pidが別のprocessへ使い回されたownerと、pidは居ると出るがprocess表に無いownerは、回収側が`owner.json`を`closed`へ書き換え、照合を繰り返さない。
+process表にはあるが開始時刻を読めないownerだけ、60秒に1回問い合わせる（ADR 0086）。
+記録を引き継ぎ終えた保存場所は、自分で閉じたownerとpidの無いownerのものを消す。保存場所が消えても読める印（`removal_safe`）の無いownerが
+同じ置き場で生きている間は消さない（ADR 0084）。
 このstateは既存のPTY／harness stateと独立し、旧版は配送を再開しない。
 
 ### Claude Code親への自動配送
@@ -320,6 +325,8 @@ Grokの終了済みerrorターンにweekly-limit質問カードが残る場合
 `grokRateLimitDialog`が見出しと操作footerの組を所有し、過去logや後続UIのあるカードは採用しない。
 privacy案内は現在の枠付きcomposerとmodel footerが見える場合だけ入力受付を妨げない。
 完了観測は成功eventを優先し、今回のerror eventと現在のカードが揃えばturn情報付きの`rate_limited`を返す。
+完了の見回りは100msで、画面を読む確認（利用上限の知らせ、Cursorのhook拒否の表示）は別の間隔で行う。画面を読むたびにtmuxを1回起動するため。
+Claude・Grokは2秒、Cursorは1秒に1回で、待ちに入った最初の周回では必ず読む（ADR 0085）。
 新turnの完了前に古いlogだけで上限を返さない。購入・再認証・過去prompt再送・定期再試行は行わない。
 画面判定と模擬CLIの実PTY試験は`test/grok-rate-limit.test.mjs`に置く。
 

package/package.json

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