aiterm-mcp 0.46.1 → 0.47.1

package/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.47.1] - 2026-10-03
+
+### 修正
+
+- 混んだ端末で、agentの画面が描かれる前に入力受付の待ち（30秒）が切れ、`agent_launch`が`reason=unrecognized_screen`で初手を送らなかった。画面が起動コマンドの表示のままの時だけ、起動から50秒まで待つ。描かれた後の画面の扱いと、50秒でも描かれない時の未送信の返し方は変わらない。
+- Codex・Claude Code・Cursorを親にしたMCP processが、5秒おきに全processの一覧を2回ずつ取っていた（POSIXは`ps -axww`、WindowsはPowerShell）。processの多い端末でCPUを使い続け、その間MCPの応答も止まっていた。5秒おきの確認は他の持ち主のpidの存在だけを見て、開始時刻の照合は初めて見た持ち主と60秒に1回だけ、対象のpidに絞って行う。配送記録を引き継ぐ条件は変わらない。終了直後に同じpidが再利用された時だけ、引き継ぎが最長60秒遅れる。
+
+## [0.47.0] - 2026-10-03
+
+### 追加
+
+- `aiterm-setup --hooks-only`。Claude Code・Cursorの親配送hookだけを登録し、依存準備、端末の実動作確認、MCP登録、Codex Steerには触れない。MCP登録を利用者や他の製品が管理する環境向け。結果は`aiterm.parent-hooks-result.v1`で返し、登録済みなら設定を書き換えない。
+- `diagnostics`が2つ目のtextで親配送hookの状態（`aiterm-mcp.parent-delivery-diagnostics.v1`）を返す。Claude Code・Cursorそれぞれの`status`と`reason_code`、呼出元のclientに当たる`caller_status`を持つ。hookが無いと`CLAUDE_PARENT_HOOK_UNAVAILABLE`で送信が拒否されるのに、診断は`ready`だけを返していた。1つ目のfactory向けJSON（`aiterm-mcp.factory-diagnostics.v1`）は項目も`overall`の意味も変えていない。
+
+### 修正
+
+- npmのprefixを利用者ごとの場所へ向けた環境（`npm_config_prefix`など）で、共通の場所へ導入した`aiterm-setup`が`global_package_failed`で失敗していた。npmの現在のglobal rootに加え、実行中のNodeの既定のglobal rootにある当packageも導入先と認める。npm一時cacheとsource checkoutは引き続き登録しない。
+- `aiterm-setup`（`aiterm-update`からの実行を含む）が、CodexとGrokの登録を毎回公式CLIで作り直し、利用者が足した項目（`tool_timeout_sec`など）を落としていた。登録が同じなら書き直さない。
+
 ## [0.46.1] - 2026-10-02
 
 ### 修正
@@ -1964,7 +1983,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.46.1...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.47.1...HEAD
+[0.47.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.47.0...v0.47.1
+[0.47.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.46.1...v0.47.0
 [0.46.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.46.0...v0.46.1
 [0.46.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.45.2...v0.46.0
 [0.45.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.45.1...v0.45.2

package/README.ja.md

@@ -42,11 +42,17 @@ 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は登録しない。
+global packageは、npmの現在のglobal rootか、実行中のNodeの既定のglobal rootにあるものを指す。npmのprefixを利用者ごとの場所へ向けた環境でも、共通の場所へ導入したAitermを登録できる。
+CodexとGrokは、登録が同じなら公式CLIで作り直さず、利用者が足した項目（待ち時間など）を保つ。
 HomebrewのNodeは更新後も有効な`opt`のパスをMCP登録とCodexのhookに使う。旧版の登録で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となる。
 
+MCP登録を利用者や他の製品が管理する環境では、`aiterm-setup --hooks-only`でClaude Code・Cursorの親配送hookだけを登録できる。
+依存準備、端末の実動作確認、MCP登録、Codex Steerには触れない。登録済みなら設定を書き換えない。
+結果は`schema: "aiterm.parent-hooks-result.v1"`、全体の`status`（`ready`／`unsupported`／`failed`）、AI別の`hooks`（`configured`／`unchanged`／`not_detected`／`failed`）を持つ。終了コードはreadyなら0、それ以外は2となる。
+
 
 ### CodexへSteerを有効にする（macOS・Windows・Linux）
 
@@ -203,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.46.1** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.47.1** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -508,6 +514,8 @@ aiterm は同じ核心の洞察——端末を出会いの場にする——を
 進め、入力受付とharness生存を確認して`startup.status="ready"`を返す。指定なしのpromptなし起動は`not_checked`。
 Claude Code初回起動の文字表示テーマ選択では、画面で選択済みの項目を確定して起動を続ける。
 続いてログイン方式の選択が出た場合は`vendor_onboarding_required`を返す。公式の対話型Claude Code CLIで初回設定を完了する。
+入力受付の待ちは30秒。混んだ端末でagentの画面がまだ描かれていない間に切れた時だけ、起動から50秒まで待つ。
+それでも描かれなければ、今までと同じく未送信（`initial_prompt=not_sent`）で返り、sessionは残る。
 WindowsのCodexもhook確認を認識し、npm shim経由の起動を一つのharnessとして識別する。
 初手の`initial_prompt.status`は`not_requested`／`not_sent`／`submitted_unconfirmed`／`started`を区別する。
 未送信・未確認の失敗もsession付きstructuredContentを保持する。未確認のpromptを再送せず、返ったcursorで観測する。
@@ -538,6 +546,8 @@ Claudeの相関済み承認は既存の`claude_approval`を使う。
 
 `diagnostics` は PTY やエージェントを起動しない。パッケージ版、MCP 呼出 readiness、read-only な PTY 一覧要約、bounded runtime-error-store status、任意 vendor launcher の可用性だけを返す。path・環境値・認証情報・コマンド本文・PTY 出力・raw log は意図的に返さない。通常未設定の任意依存は `not_applicable`、安全に確定できない状態は `unverified` と表す。
 
+結果のtextは2つある。1つ目は上の内容で、項目を固定したfactory向けのJSON（`aiterm-mcp.factory-diagnostics.v1`）。2つ目は親配送hookの状態（`aiterm-mcp.parent-delivery-diagnostics.v1`）で、Claude Code・Cursorそれぞれの`status`（`ready`／`setup_required`／`not_applicable`／`unverified`）と`reason_code`、呼出元のclientに当たる`caller_status`を返す。`caller_status`が`setup_required`なら、そのclientからのagent送信は拒否されるので`aiterm-setup`を実行する。hookの状態は1つ目の`overall`には含めない。
+
 ### ローカル runtime error snapshot
 
 `aiterm-runtime-errors snapshot` は dotagents factory adapter 向けに、製品所有のローカル snapshot を機械可読 JSON で返す。canonical dotagents factory-reporter config が schema-exact、host profile が実行 OS と一致し、`collection.enabled` が JSON boolean `true` の時だけ収集する。reporting field は schema 検証するが endpoint/credential file へ接続・読取せず network I/O も行わない。観測 API は core owner layer の固定3 code（PTY dependency・persistence・任意 vendor launcher）だけを受け、保存するのも固定 template と aggregate metadata（SHA-256 fingerprint、count、first/last、status、monotonic sequence）だけ。exception、stderr/stdout、stack、prompt、PTY/transcript/event body、path、任意 context は受け付けない。保存済み JSON も top/record exact・固定定義一致・fingerprint 再計算を通し、明示 DTO だけを返す。

package/README.md

@@ -42,11 +42,17 @@ 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は登録しない。
+global packageは、npmの現在のglobal rootか、実行中のNodeの既定のglobal rootにあるものを指す。npmのprefixを利用者ごとの場所へ向けた環境でも、共通の場所へ導入したAitermを登録できる。
+CodexとGrokは、登録が同じなら公式CLIで作り直さず、利用者が足した項目（待ち時間など）を保つ。
 HomebrewのNodeは更新後も有効な`opt`のパスをMCP登録とCodexのhookに使う。旧版の登録で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となる。
 
+MCP登録を利用者や他の製品が管理する環境では、`aiterm-setup --hooks-only`でClaude Code・Cursorの親配送hookだけを登録できる。
+依存準備、端末の実動作確認、MCP登録、Codex Steerには触れない。登録済みなら設定を書き換えない。
+結果は`schema: "aiterm.parent-hooks-result.v1"`、全体の`status`（`ready`／`unsupported`／`failed`）、AI別の`hooks`（`configured`／`unchanged`／`not_detected`／`failed`）を持つ。終了コードはreadyなら0、それ以外は2となる。
+
 
 ### CodexへSteerを有効にする（macOS・Windows・Linux）
 
@@ -217,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.46.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.47.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
 
@@ -540,6 +546,8 @@ displayed token count or null. Callers do not need raw argv or pane-text parsing
 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.
 If the CLI then requests an account login method, the launch reports `vendor_onboarding_required`; complete that choice in the official interactive Claude Code CLI.
+The input-readiness wait is 30 seconds. Only when it expires while the agent has not drawn anything yet (a busy host), the launch
+waits up to 50 seconds from startup. If nothing is drawn by then, it still returns `initial_prompt=not_sent` and keeps the session.
 A prompt-free launch without this option retains `startup.status="not_checked"`. `initial_prompt.status` distinguishes
 `not_requested`, `not_sent`, `submitted_unconfirmed`, and `started`. Failure responses retain structured session information.
 WindowsのCodexもhook確認を認識し、npm shim経由の起動を一つのharnessとして識別する。
@@ -571,6 +579,8 @@ continue to use `claude_approval`.
 
 `diagnostics` never starts a PTY or agent. It reports package version, MCP call readiness, a read-only PTY-list summary, bounded runtime-error-store status, and optional vendor-launcher availability. It deliberately excludes paths, environment values, credentials, command text, PTY output, and raw logs; normal unset optional dependencies are `not_applicable`, while an indeterminate probe is `unverified`.
 
+The result carries two text items. The first is the factory JSON described above (`aiterm-mcp.factory-diagnostics.v1`), whose fields are fixed. The second reports the parent-delivery hooks (`aiterm-mcp.parent-delivery-diagnostics.v1`): a `status` (`ready` / `setup_required` / `not_applicable` / `unverified`) and `reason_code` for Claude Code and Cursor, plus `caller_status` for the calling client. When `caller_status` is `setup_required`, agent dispatch from that client is rejected; run `aiterm-setup`. Hook status is not folded into `overall` in the first item.
+
 ### Local runtime error snapshot
 
 snapshotの`product_version`は各recordの最終実発生時の版を表す。store v2は旧v1を読み取り、単発記録の版を保持し、複数回の旧集約の版は`unknown`にする。読取りでは状態JSONを書き戻さず、次のロック内更新でv2を保存する。consumerを先に更新し、旧writerの終了後に新writerを使う。v2保存後の旧版への切替は、製品のバックアップ復元を伴う。

package/dist/core.js

@@ -51,6 +51,11 @@ const AGENT_DONE_SCREEN_SETTLE_MIN_SAMPLES = 3;
 const AGENT_SUBMIT_DELAY_MS = 250;
 const AGENT_METADATA_NEGATIVE_CACHE_TTL_MS = 2_000;
 const AGENT_TUI_READY_TIMEOUT_MS = 30_000;
+// 画面が起動コマンドの表示のまま（agentがまだ何も描いていない）で上の待ちが切れた時に、起動から待つ上限。
+// Codex親の既定のtool timeout（60秒）の内側に収める。越えると親には時間切れに見えたまま子へ初手が送られる。
+const AGENT_TUI_FIRST_DRAW_TIMEOUT_MS = 50_000;
+const LAUNCH_ECHO_TAIL_CHARS = 24;
+const LAUNCH_ECHO_MIN_CHARS = 8;
 const AGENT_TUI_READY_POLL_MS = 500;
 const AGENT_TUI_READY_STABLE_SAMPLES = 11;
 const AGENT_TUI_READY_LINES = 45;
@@ -1272,6 +1277,7 @@ function closeSessionInternal(name, observeDependency = true) {
         }
     }
     cleanupAgentState(name);
+    agentLaunchLines.delete(name);
     return `closed ${name}`;
 }
 export function closeSession(name) {
@@ -2829,11 +2835,32 @@ function isClaudeBypassPermissionsScreen(screen) {
 function isClaudeManagedLaunchConfirmation(screen) {
     return isClaudeWorkspaceTrustScreen(screen) || isClaudeBypassPermissionsScreen(screen);
 }
+/**
+ * 画面の末尾が、Aitermが打った起動コマンドの表示のままかを見る（純粋関数）。
+ * 混んだ端末ではagentのTUIが描かれる前にready待ちが切れる。画面の最後の文字列が起動コマンドの一部なら、
+ * agentはまだ何も描いていない。空白と行頭の継続prompt（`> `／`>> `）は端末の折返しとshellの表示なので比べない。
+ */
+export function launchEchoIsLastOnScreen(screen, launchLine) {
+    const command = launchLine.replace(/\s+/g, "");
+    const lines = screen.split("\n");
+    let tail = "";
+    for (let i = lines.length - 1; i >= 0 && tail.length < LAUNCH_ECHO_TAIL_CHARS; i--) {
+        tail = lines[i].replace(/^\s*>{1,2}(?:\s|$)/, "").replace(/\s+/g, "") + tail;
+    }
+    tail = tail.slice(-LAUNCH_ECHO_TAIL_CHARS);
+    return tail.length >= LAUNCH_ECHO_MIN_CHARS && command.includes(tail);
+}
+// 起動コマンドはopenAgentだけが知っている。同じprocess内のready待ちが、TUI未描画の判定に使う。
+const agentLaunchLines = new Map();
 async function waitAgentTuiReadyImpl(kind, sample, sleepFn, opts = {}) {
     const timeoutMs = opts.timeoutMs ?? AGENT_TUI_READY_TIMEOUT_MS;
     const pollMs = opts.pollMs ?? AGENT_TUI_READY_POLL_MS;
     const stableSamples = opts.stableSamples ?? agentTuiReadyStableSamplesTestOverride ?? AGENT_TUI_READY_STABLE_SAMPLES;
-    const deadline = performance.now() + timeoutMs;
+    const now = opts.now ?? (() => performance.now());
+    const start = now();
+    let deadline = start + timeoutMs;
+    // 呼ぶ側が既定より短い待ちを指定した時は、その待ちを守る（延ばさない）。
+    const firstDrawDeadline = timeoutMs >= AGENT_TUI_READY_TIMEOUT_MS ? start + AGENT_TUI_FIRST_DRAW_TIMEOUT_MS : deadline;
     let samples = 0;
     let readyStreak = 0;
     let lastScreen = "";
@@ -2852,13 +2879,21 @@ async function waitAgentTuiReadyImpl(kind, sample, sleepFn, opts = {}) {
             if (isAgentTuiActionRequired(kind, lastScreen))
                 return { ready: false, samples, lastScreen };
         }
-        if (performance.now() >= deadline)
-            return { ready: false, samples, lastScreen };
+        if (now() >= deadline) {
+            // TUIが一度も描かれていない間に切れた時だけ、決めた上限まで待ちを延ばす。描かれた後の画面は今までどおり扱う。
+            if (deadline >= firstDrawDeadline || opts.launchLine === undefined
+                || !launchEchoIsLastOnScreen(lastScreen, opts.launchLine))
+                return { ready: false, samples, lastScreen };
+            deadline = firstDrawDeadline;
+        }
         await sleepFn(pollMs);
     }
 }
 async function waitAgentTuiReady(name, meta, timeoutMs = AGENT_TUI_READY_TIMEOUT_MS) {
-    return waitAgentTuiReadyImpl(meta.kind, () => captureScreen(name, AGENT_TUI_READY_LINES), sleep, { timeoutMs });
+    const result = await waitAgentTuiReadyImpl(meta.kind, () => captureScreen(name, AGENT_TUI_READY_LINES), sleep, { timeoutMs, launchLine: agentLaunchLines.get(name) });
+    if (result.ready)
+        agentLaunchLines.delete(name);
+    return result;
 }
 async function waitAgentTuiReadyByKind(name, kind, timeoutMs = AGENT_TUI_READY_TIMEOUT_MS) {
     return waitAgentTuiReadyImpl(kind, () => captureScreen(name, AGENT_TUI_READY_LINES), sleep, { timeoutMs });
@@ -3036,9 +3071,13 @@ export async function __testWaitAgentTuiReady(kind, samples, opts = {}) {
         throw new AitermError("agent ready test samples が空です", 2);
     let i = 0;
     const sleeps = [];
+    // virtualClockは待った分だけ進む時計。実時間を使わずに締切の扱いを確かめる。
+    let clock = 0;
+    const { virtualClock, ...waitOpts } = opts;
     const result = await waitAgentTuiReadyImpl(kind, () => samples[Math.min(i++, samples.length - 1)], async (ms) => {
         sleeps.push(ms);
-    }, opts);
+        clock += ms;
+    }, virtualClock ? { ...waitOpts, now: () => clock } : waitOpts);
     return { ...result, sleeps };
 }
 export function __testIsAgentTuiIdleReady(kind, screen) {
@@ -4357,6 +4396,8 @@ export function openAgent(kind, opts = {}) {
             const envPrefix = agentEnvPrefix(meta, sid, envVars);
             full = cwdForCmd ? `cd ${shq(cwdForCmd)} && ${envPrefix}${cmd}` : `${envPrefix}${cmd}`;
         }
+        if (meta)
+            agentLaunchLines.set(sid, full);
         // force:true はagent sessionへの手動介入を表す。起動コマンド自体はAitermが組み立てて素送信する。
         send(sid, full, {
             enter: true,

package/dist/index.js

@@ -20,6 +20,7 @@ import { ParentDeliveryManager, deliveryKey } from "./parent-delivery.js";
 import { acceptRemote, callRemoteTool, observeRemoteAgentDone, remoteInputDescription, remoteInputSchema, remoteLabel, remoteWaitProcess } from "./remote.js";
 import { codexParentFromRequest } from "./codex-parent-receiver.js";
 import { claudeParentFromRequest } from "./claude-parent-receiver.js";
+import { parentDeliveryDiagnostic } from "./parent-hook-diagnostic.js";
 import { cursorParentFromRequest, isCursorMcpClient } from "./cursor-parent-receiver.js";
 import { waitProcessCommandLine } from "./cursor-parent-receive.js";
 import { INTERIM_RESULT_META_KEY, interimRequestFromMeta } from "./interim-words.js";
@@ -234,9 +235,15 @@ async function remoteCompletionWait(delivery, target, sessionId, eventCursor) {
     return { wait_process: waitProcess, wait_command: `ssh ${remoteLabel(target)} aiterm-wait --session ${sessionId} --cursor ${eventCursor}` };
 }
 server.registerTool("diagnostics", {
-    description: "Factory 向け read-only 診断。安全な状態語彙だけを機械可読 JSON で返す（PTY 内容・認証情報・path・環境値は返さない）。",
+    description: "Factory 向け read-only 診断。安全な状態語彙だけを機械可読 JSON で返す（PTY 内容・認証情報・path・環境値は返さない）。" +
+        "2つ目のtextは親配送hook（Claude Code・Cursor）の登録状態で、caller_status が setup_required なら呼出元からのagent送信は拒否される。aiterm-setup を実行する。",
     inputSchema: {},
-}, async () => ok(await factoryDiagnostics()));
+}, 
+// 1つ目は項目を固定したfactory向けの契約。親配送hookの状態は別のtextに分け、既存の読み手の形を変えない。
+async () => ({ content: [
+        { type: "text", text: await factoryDiagnostics() },
+        { type: "text", text: JSON.stringify(parentDeliveryDiagnostic(deliveryParentKind(server.server.getClientVersion()?.name))) },
+    ] }));
 const DEFAULT_PTY_SHELL = process.platform === "win32" ? "pwsh" : "bash";
 registerRemoteAwareTool("pty_open", {
     description: "ローカル永続端末（POSIXはtmux、Windows nativeはpsmux 3.3.8以上）を1個開き、session_id を返す。backend server常駐ゆえ本サーバや " +

package/dist/parent-delivery.js

@@ -4,7 +4,7 @@ import * as path from "node:path";
 import { randomUUID, createHash } from "node:crypto";
 import { z } from "zod";
 import { ensureStateRoot, writeJson0600 } from "./agent-shared.js";
-import { readRuntimeProcesses } from "./process-runtime.js";
+import { readProcessIdentities } from "./process-runtime.js";
 import { CodexDeliveryError, submitCodexParentAnswer, verifyCodexParent } from "./codex-parent-receiver.js";
 import { claudeParentSchema, ClaudeDeliveryError, bindClaudeParentDelivery, submitClaudeParentAnswer, verifyClaudeParent } from "./claude-parent-receiver.js";
 import { cursorParentSchema, CursorDeliveryError, prepareCursorDelivery, submitCursorParentAnswer, verifyCursorParent } from "./cursor-parent-receiver.js";
@@ -57,6 +57,22 @@ async function submitParentAnswer(parent, deliveryId, text) {
         return submitCursorParentAnswer(parent, deliveryId, text);
     return submitCodexParentAnswer(parent, deliveryId, text);
 }
+// 開始時刻の照会はprocessの起動を伴い、processの多い端末では1回が重い（macOSのpsは-pでも全processを歩く）。
+// 5秒おきの確認はpidの存在だけを見て、開始時刻は初めて見た持ち主とこの間隔でだけ照合する。
+// 持ち主が終了した直後に同じpidが再利用された時だけ、回収が最長でこの間隔だけ遅れる。生きている持ち主の記録は引き取らない。
+const OWNER_IDENTITY_RECHECK_MS = 60_000;
+function processExists(pid) {
+    // 0以下はprocess groupを指す。持ち主のpidにはならない。
+    if (pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === "EPERM";
+    }
+}
 function readRecord(file) {
     try {
         const record = recordSchema.parse(JSON.parse(fs.readFileSync(file, "utf8")));
@@ -98,11 +114,14 @@ export class ParentDeliveryManager {
     registering = new Map();
     timer;
     recovering = null;
+    // 他の持ち主の開始時刻を最後に照合した時刻（持ち主の保存場所ごと）。
+    verifiedOwners = new Map();
     serviceError = null;
     closing = false;
     constructor(options = {}) {
         this.deps = { observe: observeAnywhere, answer: answerAnywhere, submit: submitParentAnswer,
-            verify: verifyParent, processes: readRuntimeProcesses, ...options.dependencies };
+            verify: verifyParent, processes: readProcessIdentities, exists: processExists,
+            now: () => performance.now(), ...options.dependencies };
         const stateRoot = ensureStateRoot();
         // 別端末の子の記録はremote-で始まる保存場所へ分け、boundary.remoteを知らない旧版のreaderへ渡さない。
         const prefix = options.remote ? "remote-" : "";
@@ -118,7 +137,7 @@ export class ParentDeliveryManager {
         this.active = path.join(this.root, "active");
         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().find((entry) => entry.pid === process.pid);
+        const ownProcess = this.deps.processes([process.pid]).find((entry) => entry.pid === process.pid);
         if (!ownProcess)
             throw new AitermError("PARENT_DELIVERY_OWNER_UNKNOWN: 配送processを識別できません", 2);
         this.owner = { pid: process.pid, started_identity: ownProcess.started_identity, closed: false };
@@ -375,13 +394,49 @@ export class ParentDeliveryManager {
         return this.recovering;
     }
     async recoverOrphans() {
-        const processes = this.deps.processes();
-        for (const directory of fs.readdirSync(this.active, { withFileTypes: true })) {
-            if (!directory.isDirectory())
+        // 生存を確かめる相手は、closeしていない他の持ち主だけ。居なければOSへ問い合わせない。
+        // この処理は5秒おきに全MCP processで回る。全processの一覧を取ると、processの多い端末で負荷になる。
+        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 unverified = [];
+        for (const directory of directories) {
+            let owner;
+            try {
+                owner = JSON.parse(fs.readFileSync(path.join(this.active, directory.name, "owner.json"), "utf8"));
+            }
+            catch {
+                continue; /* 形式の検査と失敗の扱いは下の回収で行う */
+            }
+            if (owner?.closed !== false || !Number.isSafeInteger(owner.pid) || typeof owner.started_identity !== "string")
                 continue;
-            const oldDir = path.join(this.active, directory.name);
-            if (oldDir === this.ownerDir)
+            const pid = owner.pid;
+            if (!this.deps.exists(pid)) {
+                alive.set(directory.name, false);
                 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);
+            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 });
+            }
+        }
+        for (const name of this.verifiedOwners.keys())
+            if (alive.get(name) !== true)
+                this.verifiedOwners.delete(name);
+        for (const directory of directories) {
+            const oldDir = path.join(this.active, directory.name);
             let owner;
             try {
                 owner = JSON.parse(fs.readFileSync(path.join(oldDir, "owner.json"), "utf8"));
@@ -394,7 +449,8 @@ export class ParentDeliveryManager {
             if (!Number.isSafeInteger(owner.pid) || typeof owner.started_identity !== "string" || typeof owner.closed !== "boolean") {
                 throw new AitermError("PARENT_DELIVERY_OWNER_INVALID: 配送所有者の形式が不正です", 2);
             }
-            if (!owner.closed && processes.some((entry) => entry.pid === owner.pid && entry.started_identity === owner.started_identity))
+            // 生死を確かめた後に現れた持ち主は、次の回で扱う。生きている持ち主の記録は引き取らない。
+            if (!owner.closed && alive.get(directory.name) !== false)
                 continue;
             for (const name of fs.readdirSync(oldDir).filter((name) => name !== "owner.json" && name.endsWith(".json"))) {
                 const oldFile = path.join(oldDir, name);

package/dist/parent-hook-diagnostic.js

@@ -0,0 +1,83 @@
+// 親配送hook（Claude Code・Cursor）の登録状態を、利用者設定の読取りだけで要約する。
+// 設定の本文、path、環境値は返さない。書込みと修復はaiterm-setupが所有する。
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import * as steer from "aiterm-steer-delivery";
+import { resolveAgentBin } from "./agent-resolver.js";
+import { AITERM_PROFILE } from "./steer-profile.js";
+const record = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const ready = { status: "ready", reason_code: null };
+const required = (reason_code) => ({ status: "setup_required", reason_code });
+const unreadable = { status: "unverified", reason_code: "settings_unreadable" };
+function readSettings(file) {
+    if (!existsSync(file))
+        return null;
+    try {
+        const value = JSON.parse(readFileSync(file, "utf8").replace(/^/u, ""));
+        return record(value) ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function detected(kind, home) {
+    try {
+        if (resolveAgentBin(kind))
+            return true;
+    }
+    catch { /* 解決できないCLIは未検出として扱う */ }
+    return kind === "cursor" && existsSync(join(home, ".cursor"));
+}
+/** aiterm-setupが登録するeventのすべてに、当製品のhook入口があり、その入口が実在するか。 */
+export function claudeParentHookDiagnostic(file) {
+    const settings = readSettings(file);
+    if (settings === undefined)
+        return unreadable;
+    if (settings === null || settings.hooks === undefined)
+        return required("hooks_not_registered");
+    if (!record(settings.hooks))
+        return unreadable;
+    if (settings.disableAllHooks === true)
+        return required("hooks_disabled");
+    const entry = AITERM_PROFILE.hooks.claude;
+    const owned = (value) => value === entry || value.endsWith(`/${entry}`) || value.endsWith(`\\${entry}`);
+    const scripts = [];
+    for (const event of Object.keys(steer.claudeParentHookEntries(AITERM_PROFILE, { command: "", script: entry }))) {
+        const groups = settings.hooks[event];
+        if (groups !== undefined && !Array.isArray(groups))
+            return unreadable;
+        const found = (groups ?? []).flatMap(group => record(group) && Array.isArray(group.hooks) ? group.hooks : [])
+            .filter(hook => record(hook) && hook.type === "command" && Array.isArray(hook.args) && typeof hook.args[0] === "string" && owned(hook.args[0]))
+            .map(hook => hook.args[0]);
+        if (found.length === 0)
+            return required("hooks_not_registered");
+        scripts.push(...found);
+    }
+    return scripts.every(script => existsSync(script)) ? ready : required("hook_script_missing");
+}
+export function cursorParentHookDiagnostic(file) {
+    const document = readSettings(file);
+    if (document === undefined)
+        return unreadable;
+    return document !== null && steer.cursorParentHooksRegistered(AITERM_PROFILE, document) ? ready : required("hooks_not_registered");
+}
+/** 呼出元がそのclient自身なら、CLIを解決できなくても設定を読む。それ以外の未検出clientは対象外とする。 */
+export function parentDeliveryDiagnostic(caller, options = {}) {
+    const home = options.home ?? process.env.HOME ?? homedir();
+    const detect = options.detect ?? ((kind) => detected(kind, home));
+    const absent = { status: "not_applicable", reason_code: null };
+    const hooks = {
+        claude: caller === "claude" || detect("claude")
+            ? claudeParentHookDiagnostic(options.claudeSettings ?? join(process.env.CLAUDE_CONFIG_DIR ?? join(home, ".claude"), "settings.json")) : absent,
+        cursor: caller === "cursor" || detect("cursor")
+            ? cursorParentHookDiagnostic(options.cursorHooks ?? steer.cursorHooksFile(home)) : absent,
+    };
+    return {
+        diagnostic_schema: "aiterm-mcp.parent-delivery-diagnostics.v1",
+        caller: caller ?? "other",
+        caller_status: caller ? hooks[caller].status : "not_applicable",
+        setup_command: AITERM_PROFILE.setup_command,
+        hooks,
+    };
+}

package/dist/process-runtime.js

@@ -75,6 +75,60 @@ export function readRuntimeProcesses() {
         };
     });
 }
+/**
+ * 指定したpidの開始時刻だけを引く。readRuntimeProcessesと同じ開始時刻を返し、存在しないpidは結果に含めない。
+ * 全processのargvを読む一覧取得は、processの多い端末で重い（定期実行から呼ばない）。
+ */
+export function readProcessIdentities(pids) {
+    const wanted = [...new Set(pids)];
+    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("/bin/ps", ["-o", "pid=,lstart=", "-p", wanted.join(",")], {
+            encoding: "utf8", env: { ...process.env, LC_ALL: "C" }, timeout: 10000,
+        });
+        // 該当するprocessが一つも無い時、psは何も出さずstatus 1で終わる。
+        if (result.error || (result.status !== 0 && !(result.status === 1 && !result.stdout.trim()))) {
+            throw new AitermError("OSのprocess一覧を取得できません", 2);
+        }
+        return result.stdout.split("\n").filter(line => line.trim()).map(line => {
+            const match = /^\s*(\d+)\s+(\S+\s+\S+\s+\d+\s+\S+\s+\d+)\s*$/.exec(line);
+            if (!match)
+                throw new AitermError("process一覧の形式を認識できません", 2);
+            return { pid: Number(match[1]), started_identity: match[2].trim() };
+        });
+    }
+    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') }",
+        "})",
+        "ConvertTo-Json -Compress -InputObject $rows",
+    ].join("\n");
+    const result = spawnSync(resolveWindowsPowerShell7(), ["-NoLogo", "-NoProfile", "-NonInteractive", "-EncodedCommand", Buffer.from(script, "utf16le").toString("base64")], {
+        encoding: "utf8", timeout: 15000, windowsHide: true,
+    });
+    if (result.error || result.status !== 0)
+        throw new AitermError("Windowsのnative process一覧を取得できません", 2);
+    let rows;
+    try {
+        rows = JSON.parse(result.stdout);
+    }
+    catch {
+        throw new AitermError("Windows process一覧のJSONを読めません", 2);
+    }
+    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)))
+            throw new AitermError("Windows process一覧のfieldが不正です", 2);
+        return { pid: row.pid, started_identity: new Date(row.started_identity).toISOString() };
+    });
+}
 // Windowsの親PIDは親の終了後も残り、別processへ再利用される。子より後に始まったprocessは
 // 本当の親ではないので、親子関係として辿らない（辿ると循環や無関係なprocessの混入が起きる）。
 export function parentProcess(row, byPid) {

package/dist/setup-cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { runSetup } from "./setup.js";
+import { runSetup, runParentHooksSetup } from "./setup.js";
 import { removeClaudeParentHooks, removeCursorParentHooks } from "./setup-integrations.js";
 import { homedir } from "node:os";
 import { join } from "node:path";
@@ -26,8 +26,20 @@ else if (args.length === 1 && args[0] === "--remove-cursor-parent-hooks") {
         process.exitCode = 2;
     }
 }
+else if (args.includes("--hooks-only")) {
+    // 利用者や他製品がMCP登録を所有する環境向け。hookの登録だけを行い、stdoutへは結果のJSONだけを出す。
+    if (args.some(arg => !["--hooks-only", "--json"].includes(arg)) || new Set(args).size !== args.length) {
+        process.stderr.write("aiterm-setup: 使い方: aiterm-setup --hooks-only [--json]\n");
+        process.exitCode = 2;
+    }
+    else {
+        const result = runParentHooksSetup();
+        process.stdout.write(`${JSON.stringify(result)}\n`);
+        process.exitCode = result.status === "ready" ? 0 : 2;
+    }
+}
 else if (args.length === 1 && ["--help", "-h"].includes(args[0])) {
-    process.stdout.write("使い方: aiterm-setup [--json] [--codex-steer enable|disable|status]\n依存準備、AIへの登録、MCPと端末の実動作確認を行います。対話実行ではAiterm単品かCodex Desktop Steer付きかを選べます。SteerはmacOS・Windows対応で、初回はCodexの再起動が必要です。disableは専用hookを解除し、statusは公式hookの登録・承認と再起動の必要性を確認します。旧中継はhook導入後に解除します。--jsonは対話せず、Steerの選択を維持します。\n旧版へ戻す前のClaude専用hook解除: --remove-claude-parent-hooks\n旧版へ戻す前のCursor専用hook解除: --remove-cursor-parent-hooks\n");
+    process.stdout.write("使い方: aiterm-setup [--json] [--codex-steer enable|disable|status]\n依存準備、AIへの登録、MCPと端末の実動作確認を行います。対話実行ではAiterm単品かCodex Desktop Steer付きかを選べます。SteerはmacOS・Windows対応で、初回はCodexの再起動が必要です。disableは専用hookを解除し、statusは公式hookの登録・承認と再起動の必要性を確認します。旧中継はhook導入後に解除します。--jsonは対話せず、Steerの選択を維持します。\nClaude Code・Cursorの親配送hookだけの登録（MCP登録・依存準備・Codex Steerには触れない）: --hooks-only\n旧版へ戻す前のClaude専用hook解除: --remove-claude-parent-hooks\n旧版へ戻す前のCursor専用hook解除: --remove-cursor-parent-hooks\n");
 }
 else {
     try {

package/dist/setup-integrations.js

@@ -81,6 +81,34 @@ export function mergeCursorParentHooks(file, registration) {
 export function removeCursorParentHooks(file) {
     return steer.removeCursorParentHooks(AITERM_PROFILE, file);
 }
+function registerClaudeParentHooks(home, registration, run, executable) {
+    const version = /\b(\d+)\.(\d+)\.(\d+)\b/.exec(run(executable, ["--version"]));
+    if (!version || Number(version[1]) < 2 || (Number(version[1]) === 2 && (Number(version[2]) < 1 || (Number(version[2]) === 1 && Number(version[3]) < 259)))) {
+        throw new SetupError("claude_parent_delivery_unavailable", "自動配送にはClaude Code 2.1.259以上が必要です。公式CLIを更新してください");
+    }
+    return mergeClaudeParentHooks(join(process.env.CLAUDE_CONFIG_DIR ?? join(home, ".claude"), "settings.json"), registration);
+}
+/** 親配送hookだけの登録。clientの検出条件とhookの中身は通常のsetupと同じで、MCP登録は読みも書きもしない。 */
+export function configureParentHooks(home, registration, run = runSetupCommand, resolveClient = resolveAgentBin) {
+    const results = {};
+    for (const client of ["claude", "cursor"]) {
+        try {
+            const executable = resolveClient(client);
+            if (!executable && !(client === "cursor" && existsSync(join(home, ".cursor")))) {
+                results[client] = { status: "not_detected" };
+                continue;
+            }
+            results[client] = { status: client === "claude"
+                    ? registerClaudeParentHooks(home, registration, run, executable)
+                    : mergeCursorParentHooks(join(home, ".cursor", "hooks.json"), registration) };
+        }
+        catch (error) {
+            process.stderr.write(`aiterm-setup: ${client}: ${error instanceof Error ? error.message : String(error)}\n`);
+            results[client] = { status: "failed", reason_code: error instanceof SetupError ? error.code : "hook_registration_failed" };
+        }
+    }
+    return results;
+}
 export function configureIntegrations(home, registration, run = runSetupCommand, resolveClient = resolveAgentBin) {
     const results = {};
     for (const client of ["claude", "codex", "grok", "cursor"]) {
@@ -97,11 +125,7 @@ export function configureIntegrations(home, registration, run = runSetupCommand,
                 if (client === "cursor")
                     mergeCursorParentHooks(join(home, ".cursor", "hooks.json"), registration);
                 if (client === "claude") {
-                    const version = /\b(\d+)\.(\d+)\.(\d+)\b/.exec(run(executable, ["--version"]));
-                    if (!version || Number(version[1]) < 2 || (Number(version[1]) === 2 && (Number(version[2]) < 1 || (Number(version[2]) === 1 && Number(version[3]) < 259)))) {
-                        throw new SetupError("claude_parent_delivery_unavailable", "自動配送にはClaude Code 2.1.259以上が必要です。公式CLIを更新してください");
-                    }
-                    mergeClaudeParentHooks(join(process.env.CLAUDE_CONFIG_DIR ?? join(home, ".claude"), "settings.json"), registration);
+                    registerClaudeParentHooks(home, registration, run, executable);
                 }
             }
             else if (client === "codex") {
@@ -120,11 +144,14 @@ 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");
-                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"]));
-                if (value.transport?.command !== registration.command || !isDeepStrictEqual(value.transport?.args, registration.args)) {
-                    throw new SetupError("config_readback_failed", "Codexのaiterm登録が一致しません");
+                // 公式CLIの追加は登録を作り直し、利用者が足した項目（待ち時間など）を落とす。同じ登録なら書き直さない。
+                if (existing?.transport?.command !== registration.command || !isDeepStrictEqual(existing?.transport?.args, registration.args)) {
+                    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"]));
+                    if (value.transport?.command !== registration.command || !isDeepStrictEqual(value.transport?.args, registration.args)) {
+                        throw new SetupError("config_readback_failed", "Codexのaiterm登録が一致しません");
+                    }
                 }
             }
             else {
@@ -132,13 +159,16 @@ export function configureIntegrations(home, registration, run = runSetupCommand,
                 if (!Array.isArray(servers))
                     throw new SetupError("config_readback_failed", "GrokのMCP一覧形式を確認できません");
                 const existing = servers.find((entry) => entry.name === "aiterm" && entry.scope === "user");
-                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"]));
-                // 公開CLIのJSON応答を照合する。未知schemaを成功へ丸めない。
-                const item = Array.isArray(value) ? value.find((entry) => entry.name === "aiterm") : null;
-                if (!item || item.command !== registration.command || !isDeepStrictEqual(item.args, registration.args)) {
-                    throw new SetupError("config_readback_failed", "Grokのaiterm登録が一致しません");
+                // Codexと同じく、同じ登録なら書き直さない。
+                if (existing?.command !== registration.command || !isDeepStrictEqual(existing?.args, registration.args)) {
+                    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"]));
+                    // 公開CLIのJSON応答を照合する。未知schemaを成功へ丸めない。
+                    const item = Array.isArray(value) ? value.find((entry) => entry.name === "aiterm") : null;
+                    if (!item || item.command !== registration.command || !isDeepStrictEqual(item.args, registration.args)) {
+                        throw new SetupError("config_readback_failed", "Grokのaiterm登録が一致しません");
+                    }
                 }
             }
             results[client] = { status: "ready" };

package/dist/setup.js

@@ -7,16 +7,33 @@ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
 import { CallToolResultSchema } from "@modelcontextprotocol/sdk/types.js";
 import { prepareBackend, runSetupCommand, SetupError } from "./setup-platform.js";
-import { configureIntegrations } from "./setup-integrations.js";
+import { configureIntegrations, configureParentHooks } from "./setup-integrations.js";
 import { configureCodexSteer, codexSteerSelected } from "./setup-codex-hooks.js";
 import { setupNodeExecutable } from "./setup-node.js";
-export function globalRegistration(run = runSetupCommand) {
+/** 実行中のNodeに付属するnpmの既定のglobal root。npmのprefixを環境変数や設定で別の場所へ向けていても変わらない。 */
+export function nodeDefaultGlobalRoot(execPath = process.execPath, platform = process.platform) {
+    return platform === "win32" ? join(dirname(execPath), "node_modules") : join(dirname(dirname(execPath)), "lib", "node_modules");
+}
+/**
+ * 登録するのはglobal導入した当packageだけ。npmの現在のglobal rootに加え、実行中のNodeの既定のglobal rootも導入先と認める。
+ * npmのprefixを利用者ごとの場所へ向けた環境では、PATH上のaiterm-setupが後者に属する（ADR 0077）。
+ */
+export function globalRegistration(run = runSetupCommand, options = {}) {
     const root = run(process.platform === "win32" ? "npm.cmd" : "npm", ["root", "-g"]).trim();
     if (!isAbsolute(root) || /[\r\n]/u.test(root))
         throw new SetupError("global_package_required", "npm global rootを確認できません");
-    const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
-    const installedRoot = join(root, "aiterm-mcp");
-    if (realpathSync(installedRoot) !== realpathSync(packageRoot)) {
+    const packageRoot = options.packageRoot ?? dirname(dirname(fileURLToPath(import.meta.url)));
+    const current = join(root, "aiterm-mcp");
+    const same = (candidate) => { try {
+        return realpathSync(candidate) === realpathSync(packageRoot);
+    }
+    catch {
+        return false;
+    } };
+    const installedRoot = [current, join(options.defaultRoot ?? nodeDefaultGlobalRoot(), "aiterm-mcp")].find(same);
+    if (!installedRoot) {
+        // どちらにも当packageが無い時の失敗は従来のまま（導入先が無ければここで読めずに落ちる）。
+        realpathSync(current);
         throw new SetupError("global_package_required", "npm install -g aiterm-mcp後にaiterm-setupを実行してください。一時npm cacheやsource checkoutは登録しません");
     }
     return { command: setupNodeExecutable(), args: [join(installedRoot, "dist", "index.js")] };
@@ -100,3 +117,28 @@ export async function runSetup(options = {}) {
     }
     return result;
 }
+/** Claude Code・Cursorの親配送hookだけを登録する。依存準備、端末の実動作確認、MCP登録、Codex Steerには触れない。 */
+export function runParentHooksSetup(options = {}) {
+    const result = { schema: "aiterm.parent-hooks-result.v1", status: "failed", hooks: {} };
+    const progress = options.progress ?? ((message) => process.stderr.write(`aiterm-setup: ${message}\n`));
+    let stage = "global_package";
+    try {
+        const registration = (options.registration ?? globalRegistration)();
+        stage = "hooks";
+        progress("検出したAI clientの親配送hookを登録して確認します");
+        result.hooks = (options.configure ?? configureParentHooks)(process.env.HOME ?? homedir(), registration);
+        if (Object.values(result.hooks).some((item) => item.status === "failed"))
+            result.reason_code = "hook_registration_failed";
+        else if (Object.values(result.hooks).every((item) => item.status === "not_detected")) {
+            result.status = "unsupported";
+            result.reason_code = "clients_not_detected";
+        }
+        else
+            result.status = "ready";
+    }
+    catch (error) {
+        result.reason_code = error instanceof SetupError ? error.code : `${stage}_failed`;
+        progress(error instanceof Error ? error.message : String(error));
+    }
+    return result;
+}

package/docs/DESIGN.md

@@ -15,6 +15,9 @@ Aitermは、AIがローカルshell、SSH、container、REPL、別agentの対話T
 Claude／CursorのJSONは参照先を原子的に更新して変更前backupを残す。Codex／Grokは公式CLIで登録・確認する。
 各AIの読戻しは登録内容の確認であり、端末の実動作はその前の公開MCP試験で確認する。
 失敗は理由付きJSONと非ゼロ終了で返す。対応外の自動導入と全AI未検出を成功扱いしない。
+global packageは、npmの現在のglobal rootか、実行中のNodeの既定のglobal rootにあるものを指す。
+CodexとGrokは登録が同じなら公式CLIで作り直さない。`aiterm-setup --hooks-only`はClaude Code・Cursorの親配送hookだけを登録し、
+依存準備、端末の実動作確認、MCP登録、Codex Steerに触れない。判断はADR 0077。
 
 ## Terminal model
 
@@ -133,6 +136,8 @@ Codexの配送記録と本文はAiterm stateの`parent-deliveries`へ保存す
 再接続後は終了したownerの記録だけを原子的に引き継ぐ。`waiting`は同じ境界から観測を再開し、
 `ready`は保存した本文を送る。送信中断は`unknown`として本文を残し、自動再送しない。
 受信口が明示拒否した場合は`failed`、子の異常終了はそのoutcomeを配送する。
+生存の確認は5秒おきにpidの存在だけをOSへ聞き、開始識別子の照合は初めて見たownerと60秒に1回だけ行う。
+全processの一覧は取らない。終了直後に同じpidが再利用された時だけ、引き継ぎが最長60秒遅れる（ADR 0078）。
 このstateは既存のPTY／harness stateと独立し、旧版は配送を再開しない。
 
 ### Claude Code親への自動配送
@@ -192,6 +197,8 @@ Claude Codeの初回テーマ選択は選択済みの項目を確定し、後続
 ログイン方式の選択はユーザーのアカウント設定として扱い、composerと誤認せず`vendor_onboarding_required`で止める。
 promptなしでも入力受付とharness生存を確認して`startup.ready`を返す。指定なしのpromptなし起動は
 従来どおり`startup.not_checked`で返す。初手receiptは未要求・未送信・送信済み未確認・開始確認を分ける。
+入力受付の待ちは30秒。画面が起動コマンドの表示のまま（agentがまだ何も描いていない）で切れた時だけ、
+起動から50秒まで待つ。Codex親の既定のtool timeout（60秒）の内側に収める（ADR 0078）。
 開始の証拠は送信後の実行表示、実行中の既知承認、または同じcursor以降の完了だけとし、残存なしでは代用しない。
 Codexの設定エラー等でCLIが終了した場合は、残った画面へ送らず未送信で止める。
 
@@ -316,6 +323,8 @@ privacy案内は現在の枠付きcomposerとmodel footerが見える場合だ
 製品所有のlocal stateに固定codeと集約metadataだけを保存し、network I/Oを持たない。工場reporterとの
 連携は明示opt-inの任意adapterであり、未設定時もAiterm本体は単独動作する。raw error、prompt、出力、
 transcript、path、credentialを保存・公開しない。
+親配送hook（Claude Code・Cursor）の登録状態は`src/parent-hook-diagnostic.ts`が利用者設定の読取りだけで要約し、
+2つ目のtextとして返す。1つ目のfactory向けJSONは項目も`overall`の意味も変えない（ADR 0077）。
 
 ## 変更条件
 

package/package.json

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