aiterm-mcp 0.29.30 → 0.29.31

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.29.31] - 2026-09-04
+
+### Fixed
+
+- agent session への打鍵前に、pane tty 上の agent が前面プロセスグループでなければ `fg` で前面へ戻し、tty が cooked（icanon/echo）なら `raw -echo` へ戻してから送る（`pty_send` dispatch・起動時 prompt・`agent_steer`）。Codex 0.153 はツール実行後に前面を bash へ返したまま動き続ける／termios を cooked のまま残すことがあり、貼付本文が bash に落ちて `^[[200~` が生で残っていた（実測 2026-09-04）。dispatch receipt に `pane_input_recovery` を追加。判定は `ps -t` の STAT と `stty -a` だけを使う。
+
+### Changed
+
+- push時のCIをLinux 1環境へ絞り、WindowsはWindows固有ファイルの変更時だけ、3環境の全テストは週1回の定期実行だけにした。tag起点のnpm公開はmain CIの成功を待たず、既定ブランチの祖先確認だけで進める。
+- `npm run release -- <version>`でversion同期・CHANGELOG見出し・commit・tag・MCPB・GitHub Releaseを一回で行う。
+
 ## [0.29.30] - 2026-09-02
 
 ### Fixed
@@ -1529,7 +1540,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.29.30...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.29.31...HEAD
+[0.29.31]: https://github.com/kitepon/aiterm-mcp/compare/v0.29.30...v0.29.31
 [0.29.30]: https://github.com/kitepon/aiterm-mcp/compare/v0.29.29...v0.29.30
 [0.29.29]: https://github.com/kitepon/aiterm-mcp/compare/v0.29.28...v0.29.29
 [0.29.28]: https://github.com/kitepon/aiterm-mcp/compare/v0.29.27...v0.29.28

package/README.ja.md

@@ -153,7 +153,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.29.30** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.29.31** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -496,10 +496,11 @@ npm test           # build してから node:test 回帰スイート（tmux ま
 npm link           # ローカルで `aiterm-mcp` を PATH に
 ```
 
-開発中は変更に直結するfocused testを先にローカルで実行します。GitHub Actionsは実装の依存関係から
-必要なテストを選び、依存を確定できない変更とrelease変更だけ3環境の全テストへ広げます。
-tag起点のnpm公開は、同じcommitのmain CIが3環境greenであり、tagged commitが`origin/main`の
-祖先であることを確認した後だけ実行します。tag側で同じ3環境試験は繰り返しません。
+開発中は変更に直結するfocused testを先にローカルで実行します。GitHub Actionsはpushごとにself-hostedの
+`linux-workstation` 1環境で試験を回し、Windows固有ファイルを触った変更だけ`windows-native`を加え、
+3環境（`macos-native`、`linux-workstation`、`windows-native`）の全テストは週1回の健康診断だけで回します。
+`npm run release -- <version>`がversion同期・commit・tag・GitHub Releaseを一回で行い、tag起点のnpm公開は
+tagged commitが`origin/main`の祖先であることだけを確認して、他のCI結果を待ちません。
 
 共通進行は`src/core.ts`、harness固有は`src/harnesses/`、OS差は`src/tmux-runtime.ts`／`src/agent-resolver.ts`、reducerは`src/rtk.ts`、公開面は`src/index.ts`が所有する。現行設計は[`docs/DESIGN.md`](docs/DESIGN.md)、release手順は[`docs/RELEASE.md`](docs/RELEASE.md)を正とする。`prototype/python/`はreducerの歴史的移植元であり、pytest reducerは本家rtk 0.42.0と一致する（上記の`FAILED`行の差異だけは意図的・回帰テストで固定）。
 

package/README.md

@@ -169,7 +169,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.29.30** · 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.29.31** · 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
 
@@ -542,11 +542,12 @@ npm test           # build, then the node:test regression suite (requires tmux o
 npm link           # put `aiterm-mcp` on PATH locally
 ```
 
-Development uses focused local tests first. GitHub Actions selects tests from the changed implementation's
-dependency graph and expands unknown or release changes to the full suite on the self-hosted
-`macos-native`, `linux-workstation`, and `windows-native` runners. Tag-triggered npm publishing reuses
-the successful main CI for the same commit instead of repeating it, and runs only after the tagged commit
-is confirmed on `origin/main`. The native
+Development uses focused local tests first. GitHub Actions runs the suite on the self-hosted
+`linux-workstation` runner for every push, adds `windows-native` only when Windows-specific files change,
+and runs all three runners (`macos-native`, `linux-workstation`, `windows-native`) once a week as a health
+check. `npm run release -- <version>` syncs the version, commits, tags, and publishes the GitHub Release in
+one command; tag-triggered npm publishing checks only that the tagged commit is on `origin/main` and does not
+wait for another CI run. The native
 Windows runner needs psmux ≥ 3.3.8 and Git for Windows on its PATH, and must run as an
 interactive Windows user; `NETWORK SERVICE` lacks the per-user environment the pane shell and
 harness CLIs rely on and is not a valid runner identity.

package/dist/core.js

@@ -108,6 +108,129 @@ function paneCurrentCommand(name) {
         return "";
     return normalizePaneCommand(r.stdout.trim());
 }
+// ---- pane 入力の到達性（agent が tty の前面か・tty が raw か）----
+// 打鍵が届く先は pane tty の前面プロセスグループだけであり、TUI は raw termios で読む。
+// Codex 0.153 はツール実行のあと、①前面を子 shell（bash）へ返したまま agent が背面（STAT S）で
+// 動き続ける、②前面へ戻っても termios を子 shell の cooked（icanon/echo）のまま残す、の2形を出す
+// （実測 2026-09-04: Codex 席3つが順に該当。貼付本文が bash に落ちて `^[[200~` が生で残り、
+// 打鍵が行バッファに溜まって `^L` が echo された）。どちらも PTY の状態であり aiterm が所有する。
+// 停止（T）だけでなく背面で動く（S）agent も `fg` で前面へ戻せる。判定は OS が直接教える
+// `ps -t <tty>` の STAT `+`／`T` と `stty -f <tty> -a` だけを使い、画面の文字列で推測しない。
+const PANE_TTY_SHELLS = new Set([...SHELLS, "tcsh", "csh", "ksh"]);
+const AGENT_FOREGROUND_RECOVERY_TIMEOUT_MS = 3_000;
+const AGENT_FOREGROUND_RECOVERY_POLL_MS = 200;
+// harness の実プロセスを command 行から見分ける。agent が起動した子（bash -lc、ssh、git 等）は agent ではない。
+const AGENT_COMMAND_PATTERNS = {
+    codex: /(^|[\s/])codex([\s]|$)/,
+    claude: /(^|[\s/])claude([\s]|$)/,
+    grok: /(^|[\s/])grok(-[^\s/]+)?([\s]|$)/,
+    composer: /(^|[\s/])(composer|grok(-[^\s/]+)?)([\s]|$)/,
+    cursor: /(^|[\s/])(cursor-agent|agent)([\s]|$)/,
+};
+/**
+ * `ps -t <tty> -o stat=,command=` の出力を分類する（純粋関数）。
+ * ログイン shell は command が `-zsh` のように先頭 `-` 付きで出るので剥がして判定する。
+ */
+export function classifyPaneTtyProcesses(psOutput, agentPattern = /./) {
+    const state = {
+        agentPresent: false, agentForeground: false, agentStopped: false, toolForeground: false, foregroundShell: null,
+    };
+    for (const raw of psOutput.split("\n")) {
+        const m = raw.trim().match(/^(\S+)\s+(.*)$/);
+        if (!m)
+            continue;
+        const stat = m[1];
+        const command = m[2];
+        const base = ((command.split(/\s+/, 1)[0] ?? "").split("/").pop() ?? "").replace(/^-/, "");
+        if (PANE_TTY_SHELLS.has(base)) {
+            // session leader（STAT の `s`）が pane の login shell。agent が起動した子 shell（`bash -lc …`）は
+            // `s` を持たない。前面の子 shell は「ツール実行中」であり、fg も stty も触らない。
+            if (stat.includes("+")) {
+                if (stat.includes("s"))
+                    state.foregroundShell = base;
+                else
+                    state.toolForeground = true;
+            }
+            continue;
+        }
+        if (!agentPattern.test(command)) {
+            if (stat.includes("+"))
+                state.toolForeground = true;
+            continue;
+        }
+        state.agentPresent = true;
+        if (stat.includes("+"))
+            state.agentForeground = true;
+        if (stat.startsWith("T"))
+            state.agentStopped = true;
+    }
+    return state;
+}
+/** `stty -a` の出力が cooked（icanon または echo が有効）かを判定する（純粋関数）。 */
+export function termiosIsCooked(sttyOutput) {
+    const tokens = sttyOutput.split(/[\s;]+/);
+    return tokens.includes("icanon") || tokens.includes("echo");
+}
+function paneTtyOf(name) {
+    const r = tmux("display-message", "-p", "-t", name, "#{pane_tty}");
+    if (r.code !== 0)
+        return null;
+    const tty = r.stdout.trim();
+    return tty.startsWith("/dev/") ? tty : null;
+}
+/**
+ * agent session への打鍵前に、agent が tty の前面で raw で読める状態にする。
+ * 戻り値は行った回復（"fg" / "fg_stopped" / "stty_raw"）。何もしなければ空。
+ * agent が tty 上に実在しない時は触らない（ready gate が入力受付不能として止める）。
+ */
+export async function ensureAgentOwnsPaneInput(name, kind) {
+    if (isWin)
+        return [];
+    const tty = paneTtyOf(name);
+    if (!tty)
+        return [];
+    const ttyId = tty.replace(/^\/dev\//, "");
+    const psEnv = { ...process.env, LC_ALL: "C" };
+    const observe = () => classifyPaneTtyProcesses(spawnSync("/bin/ps", ["-t", ttyId, "-o", "stat=,command="], { encoding: "utf8", timeout: 5000, env: psEnv }).stdout ?? "", AGENT_COMMAND_PATTERNS[kind]);
+    const recovery = [];
+    let state = observe();
+    // agent が起動したツール／子 shell が前面なら、その tty 状態はツールの物。fg も stty も触らず ready gate に任せる。
+    if (state.toolForeground)
+        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");
+        const deadline = performance.now() + AGENT_FOREGROUND_RECOVERY_TIMEOUT_MS;
+        for (;;) {
+            await sleep(AGENT_FOREGROUND_RECOVERY_POLL_MS);
+            state = observe();
+            if (state.agentForeground)
+                break;
+            if (performance.now() >= deadline) {
+                throw new AitermError(`AGENT_TUI_BACKGROUNDED session=${name} foreground=${state.foregroundShell ?? "不明"}\n` +
+                    "pane tty 上に agent が実在するが前面プロセスグループでなく、fg でも前面へ戻りません。" +
+                    "打鍵は shell に落ちるため送信していません。pty_read(screen:true) で画面を確認してください。", 2);
+            }
+        }
+        recovery.push(wasStopped ? "fg_stopped" : "fg");
+    }
+    if (state.agentPresent && !state.toolForeground) {
+        // 別 tty を指す flag は macOS/BSD が `-f`、Linux（coreutils）が `-F`。OS 差はここ一箇所で吸収する。
+        const ttyFlag = process.platform === "linux" ? "-F" : "-f";
+        const stty = spawnSync("/bin/stty", [ttyFlag, tty, "-a"], { encoding: "utf8", timeout: 5000, env: psEnv });
+        if (stty.status === 0 && termiosIsCooked(stty.stdout ?? "")) {
+            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);
+            }
+            recovery.push("stty_raw");
+        }
+    }
+    return recovery;
+}
 function paneCurrentCommandForMark(name) {
     const foreground = paneCurrentCommand(name);
     if (!isWin || foreground === "powershell" || foreground === "pwsh")
@@ -2658,6 +2781,9 @@ export async function sendInitialAgentPrompt(name, text, o = {}) {
         throw new AitermError(`agent session '${name}' は起動時 prompt の完了待ちです。初回応答完了後に再度操作してください。`, 2);
     }
     setInitialPromptState(meta, "not_sent");
+    // 起動直後の hooks 実行で bash が前面に残ると ready gate が恒久 false になり、brief 未送信で
+    // 席が巻き戻る（実測 2026-09-04: Codex 0.153 の初回起動が3回中2回）。打鍵の前に前面と raw を整える。
+    await ensureAgentOwnsPaneInput(name, meta.kind);
     let ready = await waitAgentTuiReady(name, meta, o.ready_timeout ?? AGENT_TUI_READY_TIMEOUT_MS);
     // 無人Claude起動でCLI自身が順に出す、bypass mode確認とworkspace trustだけを
     // 起動処理の一部として進める。通常turn中の権限確認やMCP承認には触れない。
@@ -2941,6 +3067,7 @@ export async function dispatchAgentTurn(name, text, o = {}) {
     const claudeColdStart = meta.kind === "claude"
         && agentCompletionCursor(meta) === 0
         && readClaudeOperationMarker(meta) === null;
+    const paneInputRecovery = await ensureAgentOwnsPaneInput(name, meta.kind);
     if (meta.kind !== "claude" || claudeColdStart) {
         const ready = await waitAgentTuiReady(name, meta, o.ready_timeout ?? AGENT_TUI_READY_TIMEOUT_MS);
         if (!ready.ready) {
@@ -3001,6 +3128,7 @@ export async function dispatchAgentTurn(name, text, o = {}) {
         event_cursor: startOffset,
         operation_id: operationId,
         submit_residue: residue.residue,
+        pane_input_recovery: paneInputRecovery,
     };
 }
 export async function steerAgentTurn(name, text) {
@@ -3016,8 +3144,11 @@ export async function steerAgentTurn(name, text) {
         vendor: meta.kind,
         harness: agentHarness(meta.kind),
     };
-    if (!isAgentTuiBusy(meta.kind, captureScreen(name, AGENT_TUI_READY_LINES)))
-        return { ...receipt, delivery: "idle" };
+    // 前面回復は busy 判定より先（bash 前面のままだと画面の実行中マーカーを読んでも打鍵が届かない）。
+    const paneInputRecovery = await ensureAgentOwnsPaneInput(name, meta.kind);
+    if (!isAgentTuiBusy(meta.kind, captureScreen(name, AGENT_TUI_READY_LINES))) {
+        return { ...receipt, delivery: "idle", pane_input_recovery: paneInputRecovery };
+    }
     send(name, text, {
         enter: false,
         force: true,
@@ -3028,7 +3159,7 @@ export async function steerAgentTurn(name, text) {
     });
     await sleep(AGENT_SUBMIT_DELAY_MS);
     sendKey(name, "Enter");
-    return { ...receipt, delivery: "steered" };
+    return { ...receipt, delivery: "steered", pane_input_recovery: paneInputRecovery };
 }
 export async function runClaudeOperation({ session_id: name, action, operation_id: operationIdInput, text, }) {
     assertSessionName(name);

package/dist/index.js

@@ -149,6 +149,8 @@ server.registerTool("pty_send", {
         // dispatch後のsubmit座礁観測（additive）。true=composerに送信textの残存を確認（submit未成立の疑い）/
         // false=残存を観測せず（成立の保証ではない）/ null=通常送信・判定不能。
         submit_residue: z.boolean().nullable(),
+        // dispatch前に行った pane 入力の回復（"fg" / "fg_stopped" / "stty_raw"）。通常送信では省略（additive）。
+        pane_input_recovery: z.array(z.string()).optional(),
     },
 }, async ({ session_id, text, enter, mark, force, rtk, raw }) => {
     try {
@@ -180,6 +182,7 @@ server.registerTool("pty_send", {
                     vendor: receipt.vendor,
                     harness: receipt.harness,
                     submit_residue: receipt.submit_residue,
+                    pane_input_recovery: receipt.pane_input_recovery,
                 },
             };
         }

package/docs/RELEASE.md

@@ -1,53 +1,43 @@
 # Release
 
-Aitermのreleaseはこのrepositoryが所有する。`.github/workflows/product-full-ci.yml`が変更影響選択、3環境runnerと
+Aitermのreleaseはこのrepositoryが所有する。`.github/workflows/product-full-ci.yml`が変更影響選択、runnerと
 製品gateの正本であり、dotagentsの工場CIは横断受入のconsumerであってreleaseを制御しない。
 
-## Version同期
+## CIの範囲
 
-新versionでは次を同じ値へ更新する。
+- push／pull request: `linux-workstation` 1環境。変更した実装の依存graphから試験を選び、依存を確定できない変更は
+  Linuxの全テストへ広げる。Windows固有ファイル（`src/windows-powershell.ts`、`src/psmux-send-worker.ts`、
+  `test/windows-*.test.mjs`）を触った変更だけ`windows-native`を加える。
+- 週1回の定期実行（月曜 03:00 JST）と手動実行だけが、`macos-native`、`linux-workstation`、`windows-native`の
+  3環境で全テストを回す。
+- tag push: 所有確認と、tagged commitが`origin/main`の祖先であることの確認だけを行い、npmへprovenance付きで
+  publishする。同じcommitのmain CIの結果は待たない。
 
-- `package.json`と`package-lock.json`
-- `server.json`
-- `mcpb/manifest.json`
-- `README.md`と`README.ja.md`の現行公開版
-- `CHANGELOG.md`の新version見出し、`Unreleased`比較先、新version比較link
+実測（2026-09-02）: Linux 2分、macOS 2分、Windows 6分。全環境展開ではWindowsが常にcritical pathになる。
 
-同じversionのtagやnpm packageを移動・上書きしない。失敗版はそのまま残し、修正版を次のversionで出す。
-
-## Local gate
+## Release手順
 
-変更に直結するfocused testを通した後、最終確認を一度だけ行う。
+1. 変更に直結するfocused testを手元で通す。full regressionは手元で回さず、CIに任せる。
+2. `CHANGELOG.md`の`## [Unreleased]`へ内容を書き、mainへcommitしてpushする。
+3. 一回で公開する。
 
-```bash
-npm ci
-npm test
-npm pack --dry-run
-npm run mcpb:build
-```
+   ```bash
+   npm run release -- <version>
+   ```
 
-MCPBのstaged serverでversion、16 tools、stderr 0、必要なruntime JavaScriptの同梱を確認する。
+   scriptはversion同期（`package.json`、`package-lock.json`、`server.json`、`mcpb/manifest.json`、`README.md`と`README.ja.md`の現行公開版）、
+   CHANGELOG見出しと比較link、metadata検査、release commit、main push、`v<version>` tag push、
+   MCPB build、GitHub Release作成までを行う。tag pushがnpm publish、Release作成がOfficial MCP Registry登録を起動する。
+   scriptはその完了を待たない。
 
-## Mainと公開
+4. 後で確認する: `npm view aiterm-mcp@<version> version`、Official Registryの`io.github.kitepon/aiterm-mcp`。
 
-1. release commitを`main`へpushする。version・manifest・workflowを含むrelease変更は未分類変更として`macos-native`、`linux-workstation`、`windows-native`の全テストへ広がり、3環境をgreenにする。
-2. `npm run verify:release-commit`で対象commitが`origin/main`の祖先かつworktree cleanであることを確認する。
-3. 同じcommitへ`v<version>` tagを付けてpushする。tag CIは同じcommitのmain CI成功を確認し、3環境試験を再実行せずnpmへprovenance付きでpublishする。
-4. build済みMCPBを添付したGitHub Releaseを公開する。release eventがOfficial MCP Registry登録を起動する。
-5. npm、GitHub Release、Official Registryが同じversionを返すまで確認する。
-
-CI callerは同じrepositoryの`./.github/workflows/product-full-ci.yml`だけを呼ぶ。製品側の変更影響選択、
-全テストへの明示的な拡張、3環境runner、release gateを外部repositoryへ移さず、dotagentsの変更や停止からAitermの受入を独立させる。
+同じversionのtagやnpm packageを移動・上書きしない。失敗版はそのまま残し、修正版を次のversionで出す。
 
 ## 公開後smoke
 
-公式npm packageを隔離またはglobal installし、次を確認する。
-
-- `aiterm-mcp`、`aiterm-wait`、`aiterm-runtime-errors`の3 bins。
-- MCP initializeのversion、16 tools、stderr 0。
-- POSIXはtmux、Windows nativeはpsmux 3.3.8以上とPowerShell 7。
-- 変更に触れたharnessの起動、non-blocking dispatch、wait outcome、transcript回収、`pty_close`後の残骸ゼロ。
-- Official Registryが`io.github.kitepon/aiterm-mcp`の同じversionをactive／latestとして返す。
+公式npm packageを隔離またはglobal installし、変更に触れたharnessの起動、non-blocking dispatch、wait outcome、
+transcript回収、`pty_close`後の残骸ゼロを確認する。
 
 ## 利用者の更新と巻き戻し
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.29.30",
+  "version": "0.29.31",
   "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": [
@@ -60,6 +60,7 @@
     "build": "node scripts/clean-build.mjs && tsc",
     "mcpb:build": "npm run build && node scripts/build-mcpb.mjs && npm ci --omit=dev --ignore-scripts --no-audit --no-fund --prefix dist/mcpb-stage/server && npx --yes @anthropic-ai/mcpb@2.1.2 validate dist/mcpb-stage/manifest.json && npx --yes @anthropic-ai/mcpb@2.1.2 pack dist/mcpb-stage dist/aiterm-mcp.mcpb",
     "verify:release-commit": "node scripts/verify-release-commit.mjs",
+    "release": "node scripts/release.mjs",
     "test:docs": "node --test test/repository-contract.test.mjs",
     "prepublishOnly": "npm run verify:release-commit && npm run build",
     "start": "node dist/index.js",