aiterm-mcp 0.51.0 → 0.51.1

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.51.1] - 2026-10-04
+
+### 修正
+
+- `pty_observe`の`activity.post_startup_process_count`で、harnessが立て直した起動時のprocessを数えない（ADR 0083）。
+  Cursorは起動時にstdioのMCPを立て、最初のつなぎが済むと止めて立て直す。つながるのが遅いMCPがあると、立て直しが
+  起動完了の後になり、何もしていない席で数が残っていた（実物で、直結3・中継ごし4）。起動時のprocessが終了していて、
+  同じ親の下に同じargvで立っているprocessは、その立て直しとして扱う。その下で動くprocessは今までどおり数える。
+  この版より前のAitermが起動したagentは、今までどおり数える。
+
 ## [0.51.0] - 2026-10-04
 
 ### 追加
@@ -2050,7 +2060,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.51.0...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.51.1...HEAD
+[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
 [0.49.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.48.0...v0.49.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.0** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.51.1** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -519,7 +519,8 @@ sessionへ登録する名前の配列で、`pty_list({ env_keys: ["JOB_OWNER"] }
 agent sessionを閉じると失うものは、次の2項目で分かる。`activity.post_startup_process_count`は、`agent_launch`の起動準備が
 完了した時点（初手を送る前）に居なかったprocessの数。起動直後の1分に始めた裏の作業も数える。数えないものは2つ。Codex自身の
 補助process（`codex-code-mode-host`）と、中継`mcp-lazy`の直接の子（初めて使う時に起こすMCPの本体と、先行起動の判定）。
-その下で動くprocessは数える。`pending_child_deliveries`は、そのsessionが親として待っていて、まだ届け終えていない
+その下で動くprocessは数える。harnessが立て直した起動時のprocess（終了した起動時のprocessと同じ親の下に、同じargvで立ったもの。
+つなぎ直したMCPなど）も数えない。`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.0** · 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.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).
 
 ### Update and rollback
 
@@ -552,7 +552,8 @@ Two fields tell a caller what closing an agent session would lose. `activity.pos
 processes in the session that did not exist when `agent_launch` finished startup (before the first prompt), so background work
 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. `pending_child_deliveries`
+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`
 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/core.js

@@ -1077,17 +1077,53 @@ export function selectHarnessProcesses(meta, rows, subtree) {
     });
     return roots;
 }
+const processKey = (row) => `${row.pid}:${row.started_identity}`;
+/** 起動完了の控えに入れたprocessの、親とargvのdigest。控えた後に終了したprocessは入らない。 */
+export function startupProcessShapes(identities, rows) {
+    const byPid = new Map(rows.map(row => [row.pid, row]));
+    const byKey = new Map(rows.map(row => [processKey(row), row]));
+    return identities.flatMap(identity => {
+        const row = byKey.get(identity);
+        if (!row)
+            return [];
+        const parent = parentProcess(row, byPid);
+        return [{ identity, parent: parent ? processKey(parent) : null, argv_digest: row.argv_digest }];
+    });
+}
 // 起動完了の控えに無いprocessの数。harnessと中継が自分のために立てるprocessは、利用者の作業ではないので数えない。
 // その下で動くprocessは数える。
-export function postStartupProcessCount(kind, activityRows, rows, startup) {
+// harnessは起動の足場（MCP、language server）を自分で立て直す。控えた後に立て直されると、控えに無いprocessとして残る。
+// 控えの物が終了していて、同じ親の下に同じargvで立ったprocessは、その立て直しとして数えない。
+// 親も立て直されている時は、立て直された親の下を見る。終了した控え1つにつき、数えないのは1つまで。
+export function postStartupProcessCount(kind, activityRows, rows, startup, shapes = []) {
     const byPid = new Map(rows.map(row => [row.pid, row]));
     const relayChild = (row) => {
         const parent = parentProcess(row, byPid);
         return parent !== undefined && lazyRelayProcess(parent.command);
     };
-    return new Set(activityRows
-        .filter(row => !(kind === "codex" && codexHelperProcess(row.command)) && !relayChild(row))
-        .map(row => `${row.pid}:${row.started_identity}`).filter(identity => !startup.has(identity))).size;
+    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))
+        .map(row => [processKey(row), row]));
+    const gone = shapes.filter(shape => startup.has(shape.identity) && !present.has(shape.identity));
+    const replacedBy = new Map();
+    for (let changed = gone.length > 0; changed;) {
+        changed = false;
+        for (const [key, row] of added) {
+            const parent = parentProcess(row, byPid);
+            if (!parent)
+                continue;
+            const parentKey = processKey(parent);
+            const original = gone.find(shape => !replacedBy.has(shape.identity) && shape.argv_digest === row.argv_digest
+                && shape.parent !== null && (shape.parent === parentKey || replacedBy.get(shape.parent) === parentKey));
+            if (!original)
+                continue;
+            replacedBy.set(original.identity, key);
+            added.delete(key);
+            changed = true;
+        }
+    }
+    return added.size;
 }
 export function observeSession(name, cursor) {
     assertSessionName(name);
@@ -1190,7 +1226,8 @@ export function observeSession(name, cursor) {
         background_cpu_seconds: Object.values(backgroundCpu).reduce((sum, cpu) => sum + cpu, 0),
         background_cpu_delta_seconds: comparable ? Object.entries(backgroundCpu).reduce((sum, [identity, cpu]) => sum + cpu - (previous.background_processes[identity] ?? 0), 0) : null,
         background_cpu_delta_complete: comparable ? Object.keys(previous.background_processes).every(identity => identity in backgroundCpu) : null,
-        post_startup_process_count: startup ? postStartupProcessCount(meta.kind, activityRows, rows, startup) : null,
+        post_startup_process_count: startup
+            ? postStartupProcessCount(meta.kind, activityRows, rows, startup, meta.startup_process_shapes) : null,
     };
     return result;
 }
@@ -2013,8 +2050,10 @@ function loadAgentMetadata(name) {
         initial_prompt_delivery: m.initial_prompt_delivery, initial_prompt_cursor: m.initial_prompt_cursor,
     };
     const executableFields = m.agent_executable === undefined ? {} : { agent_executable: m.agent_executable };
+    const startupShapes = Array.isArray(m.startup_process_shapes) && m.startup_process_shapes.every((shape) => shape && typeof shape.identity === "string" && (shape.parent === null || typeof shape.parent === "string") && typeof shape.argv_digest === "string")
+        ? { startup_process_shapes: m.startup_process_shapes } : {};
     const startupFields = Array.isArray(m.startup_processes) && m.startup_processes.every((identity) => typeof identity === "string")
-        ? { startup_processes: m.startup_processes } : {};
+        ? { startup_processes: m.startup_processes, ...startupShapes } : {};
     if (m.kind === "claude") {
         const expectedSettings = agentManagedClaudeSettingsPath(name, m.launch_id);
         const expectedResult = agentClaudeResultPath(name, m.launch_id);
@@ -3235,6 +3274,7 @@ async function prepareAgentInput(name, meta, options) {
     // ここまでに居るprocessは起動時の足場（harness・MCP・起動時hook）。初手を送る前に控える。
     if (live.activity.cursor !== null) {
         meta.startup_processes = Object.keys(decodeActivityCursor(live.activity.cursor, name).processes);
+        meta.startup_process_shapes = startupProcessShapes(meta.startup_processes, readRuntimeProcesses());
         writeAgentMetadata(meta);
     }
     return { status: "ready", reason: "composer_ready" };

package/docs/DESIGN.md

@@ -55,6 +55,7 @@ POSIXの停止状態はOSのprocess表から取得し、SIGSTOP中は残画面
 sessionを閉じると失うものは数で返す（ADR 0080）。`activity.post_startup_process_count`は起動完了の時点に居なかったprocessの数、
 `pending_child_deliveries`はそのsessionが親として待つ未配送の数。数えられない時はnullで、0と区別する。
 harnessと中継が自分のために立てるprocessは数えない（Codexの`codex-code-mode-host`、中継`mcp-lazy`の直接の子。ADR 0082）。その下は数える。
+harnessが同じ親の下に同じargvで立て直した起動時のprocessも数えない（ADR 0083）。
 中継の後ろで眠っている本体を配送の引き取りのために起こすかは、`aiterm-delivery-wake`が返す（ADR 0082）。
 Claude Codeの入力待ちは、起動時の見出しが取得範囲から流れ出た後も、入力欄の形（`❯`行の上下の罫線）で読む。
 画面本文とargv本文は返さず、活動cursorには画面digestとprocess別CPUだけを持たせる。

package/package.json

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