aiterm-mcp 0.52.2 → 0.52.3

package/CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.52.3] - 2026-10-05
+
+### 修正
+
+- Claude Code親の配送hookの登録を、`args`を使わずshellを通す1行で書く（aiterm-steer-delivery 0.2.0、ADR 0089）。
+  Grokは共有の`~/.claude/settings.json`のhookも動かすが、`args`を落として`command`だけを動かす。
+  0.52.2までの`command=node, args=[claude-parent-hook.js]`の形では、Grokがnodeだけを起こし、nodeがhookの入力を
+  scriptとして読んで、会話の終わりのたびに`[stdin]:1`で失敗の記録を残していた（Grok 1.0.46、LinuxとWindowsで再現）。
+  POSIXは`exec '<node>' '<hook>'`、Windowsは`& '<node>' '<hook>'; exit (Get-Variable LASTEXITCODE -ValueOnly)`と
+  `shell: "powershell"`。`aiterm-setup`（`--hooks-only`も）を流すと、0.52.2までの登録をこの形へ置き換える。
+  Grokから起こされたhookは何もせず0で終わる。PreToolUseのhookは、間に挟まるshellではなくClaude Code本体を
+  依頼元として記録する。
+- Windowsで、Claude Code親へ子の回答が届いているのに、配送が`CLAUDE_PARENT_HOOK_CLOSED`（結果不明）で終わる事があった。
+  process表を読む間（約1秒）に受信hookが本文を出し終えて終わると、出し終えた後のhookを「途中で終わった」と数えていた。
+- `diagnostics`の親配送hookの状態は、0.52.2までの登録と新しい登録のどちらも「登録済み」と読む。
+
+### 注意
+
+- 0.52.2以前へ戻す時は、旧版のinstall前に`aiterm-setup --remove-claude-parent-hooks`を実行する。
+  0.52.2以前は新しい形の登録を自分の物と数えず、もう1組を足す。
+- Windowsでは、子の回答を待っているhook1つにつき、Claude Codeが起こすPowerShellのprocessが1つ残る。
+
 ## [0.52.2] - 2026-10-05
 
 ### 修正
@@ -2135,7 +2157,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.52.2...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.52.3...HEAD
+[0.52.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.52.2...v0.52.3
 [0.52.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.52.1...v0.52.2
 [0.52.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.52.0...v0.52.1
 [0.52.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.51.3...v0.52.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.52.2** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.52.3** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -655,7 +655,7 @@ Claude Codeは2.1.259以上の対話sessionに対応する。`aiterm-setup`が
 
 `/clear`などで会話を終了すると未送信の旧回答の配送を止め、本文は保存する。受信hookの上限は24時間で、終了や出力失敗を成功扱いしない。hookが無効な場合は送信前に明示errorにし、waiterへ黙って切り替えない。Claude Desktopのチャット、Web、`agent_id`付きの会話（`--agent`起動とnative subagent）はこの受信契約に含めない。
 
-hookを持たない旧版へ戻す時は、install前に`aiterm-setup --remove-claude-parent-hooks`を実行する。Aiterm専用hookだけを解除し、他製品のhookと設定は保持する。
+hookを持たない旧版、または0.52.2以前へ戻す時は、install前に`aiterm-setup --remove-claude-parent-hooks`を実行する。Aiterm専用hookだけを解除し、他製品のhookと設定は保持する。
 
 Cursor親（`clientInfo.name`が`cursor-vscode`）も同じ完了観測と本文保存を使う。`aiterm-setup`が`~/.cursor/hooks.json`へ`afterMCPExecution`と`postToolUse`を追加し、他製品のhookと順序は保持する。hookが無い場合は子への送信前に`CURSOR_PARENT_HOOK_UNAVAILABLE`で止める。作業を続けていれば次のツール返りへ`additional_context`で本文が差し込まれ、ターンを終える前にreceiptの`wait_process`を背景で起動しておけばidle中の完了でも起きられる。`wait_command`はnull。`submitted`はhookまたは受け口が本文を受け取った状態であり、modelの読了ではない。24時間以内に受け取りが無ければ`failed`とし、本文は残して自動再送しない。解除は`aiterm-setup --remove-cursor-parent-hooks`。Cursor Cloud Agent／Background Agentはこの受信契約に含めない。
 

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.52.2** · runs on Linux · WSL2 · macOS · native Windows (tmux on POSIX, the tmux-CLI-compatible [psmux](https://github.com/psmux/psmux) on native Windows — no WSL required) · MIT · see the [CHANGELOG](CHANGELOG.md).
+**Status:** actively maintained · current public release **v0.52.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
 
@@ -696,7 +696,7 @@ Claude Codeは2.1.259以上の対話sessionに対応する。`aiterm-setup`が
 
 `/clear`等の会話終了後は未送信の旧回答を送らず、本文を保存する。受信hookの上限は24時間。hookの終了・出力失敗・無効化を成功扱いせず、別の待機経路へ黙って切り替えない。Claude Desktopのチャット、Web、`agent_id`付きの会話（`--agent`起動とnative subagent）はこの受信契約に含めない。
 
-hookを持たない旧版へ戻す時は、install前に`aiterm-setup --remove-claude-parent-hooks`を実行する。Aiterm専用hookだけを解除し、他製品のhookと設定は保持する。
+hookを持たない旧版、または0.52.2以前へ戻す時は、install前に`aiterm-setup --remove-claude-parent-hooks`を実行する。Aiterm専用hookだけを解除し、他製品のhookと設定は保持する。
 
 Cursor parents (`clientInfo.name` of `cursor-vscode`) use the same completion capture. `aiterm-setup` adds `afterMCPExecution` and `postToolUse` to `~/.cursor/hooks.json` and keeps every other hook and its position. A missing registration fails the dispatch with `CURSOR_PARENT_HOOK_UNAVAILABLE` before the child is sent. While the parent keeps calling tools, the answer is injected through `additional_context` on the next tool result. If the parent ends the turn, start the receipt `wait_process` in the background first; that receiver exits when the answer arrives. `wait_command` is null. `submitted` means the hook or the receiver claimed the text, not that the model has read it. No claim within 24 hours is `failed`, the text is kept, and nothing is resent. Remove only Aiterm's entries with `aiterm-setup --remove-cursor-parent-hooks`. Cursor Cloud Agents and Background Agents are outside this contract.
 

package/dist/core.js

@@ -2125,9 +2125,6 @@ async function acquireAgentSendFileLock(name, deadline, waitMs) {
             }
         }
         if (dead && reapDeadAgentSendLock(name, replacedToken) === "stuck") {
-            // BellTeamのため: 先頭の「agent session '<名前>' に、終了した送信のlockを片付ける途中で残った印があります。」と、
-            // 文中の「文字列は送信していません。」で見分け、pty_close→起動し直しへ回している（2026-10-05）。
-            // この文面と、pty_closeがこの印を片付ける事を変える時は、変える前に知らせる。
             throw new AitermError(`agent session '${name}' に、終了した送信のlockを片付ける途中で残った印があります。` +
                 `自動回収は並行送信の混線を招くため行いません。文字列は送信していません。` +
                 `pty_listで対象を確認し、pty_closeでsessionを閉じてから同じIDで再作成してください`, 2);

package/dist/parent-hook-diagnostic.js

@@ -40,21 +40,15 @@ export function claudeParentHookDiagnostic(file) {
         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 }))) {
+    // 登録の形（0.52.2までの`args`形式と、今のshellを通す1行）は配送ライブラリが読む。ここで`args`を直接読まない。
+    for (const event of Object.keys(steer.claudeParentHookEntries(AITERM_PROFILE, { command: "", script: AITERM_PROFILE.hooks.claude }))) {
         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");
+    if (!steer.claudeParentHooksRegistered(AITERM_PROFILE, settings))
+        return required("hooks_not_registered");
+    return steer.claudeParentHookScripts(AITERM_PROFILE, settings).every(script => existsSync(script)) ? ready : required("hook_script_missing");
 }
 export function cursorParentHookDiagnostic(file) {
     const document = readSettings(file);

package/docs/DESIGN.md

@@ -186,6 +186,11 @@ hookはNodeの実行ファイルと引数配列で直接起動し、shellやWind
 子の予約は既存の`parent-deliveries/claims`で共有し、親の種類をまたぐ並行送信を防ぐ。
 hookとの受け渡しはAiterm stateの`claude-parent-hooks`へ置く。
 
+hookの登録は、`args`を使わずshellを通す1行で書く（ADR 0089）。POSIXは`exec '<node>' '<hook>'`、Windowsは
+`& '<node>' '<hook>'; exit (Get-Variable LASTEXITCODE -ValueOnly)`と`shell: "powershell"`。同じ設定をGrokも読み、
+`args`を落として`command`だけを動かすためである。Grokから起こされたhookは何もせず0で終わる。
+PreToolUseのhookは、間に挟まるshellを飛ばして、Claude Code本体を依頼元のprocessとして記録する。
+
 `PostToolUse`は`asyncRewake:true`で待機し、保存済み本文をstderrへ出してexit 2を返す。
 exit 2はClaudeが規定する再開信号であり、子の成功・失敗は本文の`outcome`で区別する。
 親は待機中も別作業や次のturnへ進める。Claudeの画面では`Stop hook feedback`として届く。

package/docs/RELEASE.md

@@ -83,8 +83,9 @@ aiterm-setup --json
 互換launcherを共有していた場合はAitermのSteer選択だけを解除し、所有外の起動設定を保持する。
 回答record schemaは従来と共通であり、新方式のSteer相当配送も`queued_submission_id`を保持する。
 
-Claude親配送hookのない旧版へ戻す場合は、旧版のinstall前に`aiterm-setup --remove-claude-parent-hooks`を
-実行する。Aiterm専用の3 hookだけを解除し、他製品のhookと設定を保持する。
+Claude親配送hookのない旧版、または0.52.2以前へ戻す場合は、旧版のinstall前に`aiterm-setup --remove-claude-parent-hooks`を
+実行する。Aiterm専用の3 hookだけを解除し、他製品のhookと設定を保持する。0.52.2以前は、shellを通す1行の登録（ADR 0089）を
+自分の物と数えず、もう1組を足す。
 
 ```bash
 npm install -g "aiterm-mcp@<known-good-version>"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.52.2",
+  "version": "0.52.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": [
@@ -71,7 +71,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "aiterm-steer-delivery": "^0.1.12",
+    "aiterm-steer-delivery": "^0.2.0",
     "ws": "8.21.3",
     "zod": "^4.4.3"
   },