aiterm-mcp 0.61.5 → 0.61.6

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.61.6] - 2026-10-22
+
+### Fixed
+
+- Agent startup waits asynchronously for the existing metadata mutex before checking pane ownership, restoring its terminal mode, or accepting startup-menu keys. A short concurrent writer after promptless native creation no longer turns an otherwise valid launch into `unknown`. Stops, uncertain slots, generation changes and the existing lock-acquisition deadline still refuse further effects; no launch or input is replayed.
+
 ## [0.61.5] - 2026-10-22
 
 ### Fixed
@@ -2736,7 +2742,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.61.5...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.61.6...HEAD
+[0.61.6]: https://github.com/kitepon/aiterm-mcp/compare/v0.61.5...v0.61.6
 [0.61.5]: https://github.com/kitepon/aiterm-mcp/compare/v0.61.4...v0.61.5
 [0.61.4]: https://github.com/kitepon/aiterm-mcp/compare/v0.61.3...v0.61.4
 [0.61.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.61.2...v0.61.3

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.61.5** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.61.6** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -559,6 +559,7 @@ MCPの本体を初めて使う時まで起こさない中継の後ろにAiterm
 
 `agent_launch({ harness, cwd, trust_project: true })`はpromptなしでも既知のworkspace・project hooks・MCP初期同意を
 進め、入力受付とharness生存を確認して`startup.status="ready"`を返す。指定なしのpromptなし起動は`not_checked`。
+起動準備は競合するmetadata保存が終わるのを待って続行する。端末回復と起動メニューの各キーでは世代・停止状態を再確認し、native起動が未確認になった場合は自動再実行せず診断用に保持する。
 Claude Code初回起動の文字表示テーマ選択では、画面で選択済みの項目を確定して起動を続ける。
 続いてログイン方式の選択が出た場合は`vendor_onboarding_required`を返す。公式の対話型Claude Code CLIで初回設定を完了する。
 入力受付の待ちは30秒。混んだ端末でagentの画面がまだ描かれていない間に切れた時だけ、起動から50秒まで待つ。

package/README.md

@@ -227,7 +227,7 @@ collection is off by default and performs no network I/O. It ships via
 tag-triggered CI with npm provenance (OIDC Trusted Publishing); the GitHub
 Release re-registers the Official MCP Registry entry.
 
-**Status:** actively maintained · current public release **v0.61.5** · 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.61.6** · 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
 
@@ -600,6 +600,7 @@ Owner start times are checked through `/proc` on Linux; elsewhere an existing PI
 
 `agent_launch({ harness, cwd, trust_project: true })` completes known workspace, project-hook, and project-MCP startup
 consent even without a prompt, then verifies input readiness and harness liveness before returning `startup.status="ready"`.
+Startup checks wait for concurrent metadata writers before continuing. Each terminal recovery or startup-menu key still checks the current generation and stop state; an uncertain native launch remains available for status inspection without automatic replay.
 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

package/dist/core.js

@@ -209,7 +209,10 @@ function paneTtyOf(name) {
  * agent が tty 上に実在しない時は触らない（ready gate が入力受付不能として止める）。
  */
 export async function ensureAgentOwnsPaneInput(name, kind) {
-    assertExecutionContext(name);
+    // Startup resumes after native creation/readiness awaits. A short metadata
+    // writer is not a reason to abandon that already created launch. Wait for
+    // admission, then run the unchanged source/target/generation checks.
+    await withExecutionNativeAdmission(name, () => assertExecutionContext(name));
     if (isWin)
         return [];
     const tty = paneTtyOf(name);
@@ -225,9 +228,11 @@ export async function ensureAgentOwnsPaneInput(name, kind) {
         return [];
     if (state.agentPresent && !state.agentForeground) {
         const wasStopped = state.agentStopped;
-        tmux("send-keys", "-t", name, "C-u");
-        tmux("send-keys", "-l", "-t", name, "fg");
-        tmux("send-keys", "-t", name, "Enter");
+        await withExecutionNativeAdmission(name, () => {
+            tmux("send-keys", "-t", name, "C-u");
+            tmux("send-keys", "-l", "-t", name, "fg");
+            tmux("send-keys", "-t", name, "Enter");
+        });
         const deadline = performance.now() + AGENT_FOREGROUND_RECOVERY_TIMEOUT_MS;
         for (;;) {
             await sleep(AGENT_FOREGROUND_RECOVERY_POLL_MS);
@@ -250,11 +255,13 @@ export async function ensureAgentOwnsPaneInput(name, kind) {
             // stty is a native mutation outside tmux's command gate. Recheck the
             // captured device and the shared request generation/fence immediately
             // before dispatch; a replaced pane must not inherit the old tty repair.
-            beforeExecutionEffect(name, () => {
-                if (paneTtyOf(name) !== tty)
-                    throw new ExecutionError("EXECUTION_STALE_GENERATION");
+            const set = await withExecutionNativeAdmission(name, () => {
+                beforeExecutionEffect(name, () => {
+                    if (paneTtyOf(name) !== tty)
+                        throw new ExecutionError("EXECUTION_STALE_GENERATION");
+                });
+                return spawnSync("/bin/stty", [ttyFlag, tty, "raw", "-echo"], { encoding: "utf8", timeout: 5000, env: psEnv });
             });
-            const set = spawnSync("/bin/stty", [ttyFlag, tty, "raw", "-echo"], { encoding: "utf8", timeout: 5000, env: psEnv });
             if (set.status !== 0) {
                 throw new AitermError(`AGENT_TTY_COOKED session=${name}\n` +
                     `tty が icanon/echo のままで raw へ戻せません: ${(set.stderr ?? "").trim() || `code=${set.status}`}。送信していません。`, 2);
@@ -4230,7 +4237,7 @@ async function prepareAgentInput(name, meta, options) {
         handled.add(action.kind);
         const keys = action.selected ? action.keys.slice(0, -1) : action.keys;
         for (const key of keys) {
-            sendKey(name, key, { preserveAgentOperation: true });
+            await withExecutionNativeAdmission(name, () => sendKey(name, key, { preserveAgentOperation: true }));
             await sleep(AGENT_SUBMIT_DELAY_MS);
         }
         if (action.selected) {
@@ -4238,14 +4245,14 @@ async function prepareAgentInput(name, meta, options) {
             let moved = await waitStartupSelection(name, action.selected);
             if (!moved && keys.length > 0) {
                 for (const key of keys) {
-                    sendKey(name, key, { preserveAgentOperation: true });
+                    await withExecutionNativeAdmission(name, () => sendKey(name, key, { preserveAgentOperation: true }));
                     await sleep(AGENT_SUBMIT_DELAY_MS);
                 }
                 moved = await waitStartupSelection(name, action.selected);
             }
             if (!moved)
                 break;
-            sendKey(name, action.keys.at(-1), { preserveAgentOperation: true });
+            await withExecutionNativeAdmission(name, () => sendKey(name, action.keys.at(-1), { preserveAgentOperation: true }));
             await sleep(AGENT_SUBMIT_DELAY_MS);
         }
         ready = await waitAgentTuiReady(name, meta, options.ready_timeout ?? AGENT_TUI_READY_TIMEOUT_MS);

package/docs/DESIGN.md

@@ -29,6 +29,8 @@ POSIXのraw tty回復もnative作用であり、tmux打鍵と同じ受付を通
 実stty直前にも同じdeviceを確認する。停止や世代/tty交代後に古いdeviceへ回復を発行しない。
 一つのRPCが複数のnative作用を発行するときも、各回に同じissued slotとsource/target世代・停止を再確認する。
 agentの貼付け・Enterの同期区間は、既存metadata mutexを非同期に取得してから実行する。
+native作成後に再開する起動準備も同じ非同期取得を通す。pane所有検査、fg/stty回復、
+起動メニューの各キーを短い同期区間で実行し、待機後の停止・世代・slot検査を省略しない。
 mutexをawait中へ持ち越さず、同じ同期stack内の各gateが発行記録を永続化してからnative作用へ進む。
 検証済みsourceと同世代への通常sendがissuedである間も、そのsourceの送信先が別ならoutgoing RPCは継続できる。
 incomingのslotを解放・書換・成功扱いせず、unknown・管理操作・世代不一致は従来どおり拒否する。

package/package.json

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