aiterm-mcp 0.58.3 → 0.59.0

package/dist/user-config.js

@@ -0,0 +1,138 @@
+// 利用者の設定file（harnessが既定を保存するfile）を、席の切り替えの前後で元の値へ戻すための部品（ADR 0114）。
+// harnessの切り替えの命令は、席だけでなく利用者の既定も書き換える（Claude Codeの /fast、Codexの /fast、Grokの --model と /model）。
+// 席の切り替えを席だけに留めるため、「読む → 切り替える → 戻す」を、processをまたぐ鍵で1つずつにする。
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { isDeepStrictEqual } from "node:util";
+import { AitermError } from "./errors.js";
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+// 鍵を握ったままprocessが落ちた時に、後の人が引き取るまでの時間。1回の切り替え（画面の待ちと公式の口の呼び出し）より十分長く取る。
+const LOCK_STALE_MS = 120_000;
+const LOCK_WAIT_MS = 150_000;
+const LOCK_POLL_MS = 120;
+/**
+ * 設定fileを触る切り替えを、同じ端末の全てのAitermの間で1つずつにする。鍵は設定fileの隣に作る
+ * （Aitermの置き場はprocessごとに変えられるが、設定fileの場所は全員が同じに見る）。
+ * 設定fileの置き場が無い・書けない時は、harnessも書けないので鍵なしで通す。
+ */
+export async function withUserConfigLock(configPath, action) {
+    const lock = `${configPath}.aiterm-lock`;
+    if (!fs.existsSync(path.dirname(configPath)))
+        return action();
+    const deadline = Date.now() + LOCK_WAIT_MS;
+    for (;;) {
+        try {
+            fs.mkdirSync(lock);
+            break;
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== "EEXIST")
+                return action();
+        }
+        let age = 0;
+        try {
+            age = Date.now() - fs.statSync(lock).mtimeMs;
+        }
+        catch {
+            continue;
+        }
+        if (age > LOCK_STALE_MS) {
+            try {
+                fs.rmSync(lock, { recursive: true, force: true });
+            }
+            catch { /* 先に誰かが片付けた */ }
+            continue;
+        }
+        if (Date.now() > deadline) {
+            throw new AitermError(`USER_CONFIG_LOCK_TIMEOUT: ${configPath} を触る切り替えが、ほかの席で続いています。何も変えていません。`, 2);
+        }
+        await sleep(LOCK_POLL_MS + Math.floor(Math.random() * LOCK_POLL_MS));
+    }
+    try {
+        try {
+            fs.writeFileSync(path.join(lock, "owner"), `${process.pid}\n`);
+        }
+        catch { /* 持ち主の控えは調べる時のため。無くても動く */ }
+        return await action();
+    }
+    finally {
+        try {
+            fs.rmSync(lock, { recursive: true, force: true });
+        }
+        catch { /* 残っても、古くなれば次の人が引き取る */ }
+    }
+}
+/** fileの今の中身。無い・読めない時はnull。 */
+export function readFileOrNull(file) {
+    try {
+        return fs.readFileSync(file);
+    }
+    catch {
+        return null;
+    }
+}
+function writeInPlace(file, body) {
+    let mode = 0o600;
+    try {
+        mode = fs.statSync(file).mode & 0o777;
+    }
+    catch { /* 無ければ0600で作る */ }
+    const temp = `${file}.aiterm-restore-${process.pid}`;
+    fs.writeFileSync(temp, body, { mode });
+    try {
+        fs.renameSync(temp, file);
+    }
+    catch (error) {
+        // Windowsでは、ほかのprocessがfileを開いている間、置き換えに失敗する事がある。途中のfileを残さず、呼び手に次の回で試させる。
+        try {
+            fs.unlinkSync(temp);
+        }
+        catch { /* 残っても中身は前の値 */ }
+        throw error;
+    }
+}
+/**
+ * JSONの設定fileの、最上位の項目（1つ、または複数）を、切り替えの前の値へ戻す。
+ * - 項目が前と同じで、ほかの項目の値も同じ（harnessが書き直して並びが変わっただけ）なら、前の中身をそのまま書き戻す。
+ * - ほかの項目が変わっていたら（ほかの人の書き込み、harnessの控えの更新）、その項目だけを直して、ほかは今のまま残す。
+ * - 今のfileが無い・JSONとして読めない時、前の中身が読めない時は触らない。
+ * 戻り値は、書き戻したかどうか。
+ */
+export function restoreJsonSetting(file, before, key) {
+    const keys = typeof key === "string" ? [key] : key;
+    const now = readFileOrNull(file);
+    if (now === null)
+        return false;
+    if (before !== null && now.equals(before))
+        return false;
+    let current;
+    let previous = null;
+    try {
+        current = JSON.parse(now.toString("utf8"));
+        if (before !== null)
+            previous = JSON.parse(before.toString("utf8"));
+    }
+    catch {
+        return false;
+    }
+    if (!current || typeof current !== "object" || Array.isArray(current))
+        return false;
+    if (previous !== null && (typeof previous !== "object" || Array.isArray(previous)))
+        return false;
+    const edited = { ...current };
+    for (const name of keys) {
+        if (previous !== null && Object.hasOwn(previous, name))
+            edited[name] = previous[name];
+        else
+            delete edited[name];
+    }
+    if (before !== null && isDeepStrictEqual(edited, previous)) {
+        writeInPlace(file, before);
+        return true;
+    }
+    if (isDeepStrictEqual(edited, current))
+        return false;
+    writeInPlace(file, `${JSON.stringify(edited, null, 2)}\n`);
+    return true;
+}

package/docs/DESIGN.md

@@ -63,6 +63,16 @@ agentの席への`pty_send`は、任意の`preface`（本文の前に置く1行
 空行と本文を1回の貼り付けで入れる。貼り付けた長い文をClaude Codeが`<pasted_content>`で包んでも、前置きは包みの外に出る。
 ほかのharnessの席へは1つにつないで貼る。`preface`は入力欄がそのまま読むので、1行・200字以内・制御文字なし・行頭が記号や空白でない・
 `@`を含まない文だけを通し、外れた時は打鍵前に断る。
+呼び手が`preface`を渡さない時も、Claude Codeの席へ送る文が包まれる長さ（改行3つ以上か800字以上。`claudeWrapsPaste`）なら、Aitermが既定の1行
+（`AGENT_DEFAULT_PREFACE`。出所だけを言う）を同じ形で入れる。新しいturn・差し込み・起動時の文で同じ。起動時に席へ渡す文で、この1行の見分け方を教える（ADR 0116）。
+
+Claude Codeの席へ送る前に、今の画面が選ぶ画面（最後の行が`Enter to confirm · Esc to cancel`で、上に番号の行がある。`claudeLiveSelectMenu`）で
+ないかを読む。利用枠に当たったClaude Codeが自分で開く`/rate-limit-options`の画面は、Escで閉じてから送る。見覚えの無い選ぶ画面には何も打たずに
+断る。選ぶ画面は貼り付けを捨ててEnterだけを読み、打鍵の数字と「j」「k」を選択の操作として読むので、そのまま送ると文が消える（ADR 0117）。
+
+席のprocessの環境には、起動の印（`AITERM_AGENT_LAUNCH_ID`ほか`AITERM_AGENT_*`）を入れる。印は席が起こした子にも継がれる。起動の時点で会話IDが
+決まるClaude CodeとGrokの席には、席の会話ID（`AITERM_AGENT_VENDOR_SESSION_ID`）も入れ、席そのものの会話かを値で見分けられるようにする（ADR 0118）。
+素の端末（`pty_open`）には`AITERM_AGENT_*`を入れない。
 
 Codexは回答を流している間、画面に動作中の行を出さない。`pty_send`の振り分けは、Codexの席に限り、画面が入力待ちでも、この起動の記録の
 最後の境界がturnの開始で、processが生きていて、0.4秒おいて見直しても記録が同じturnのままで画面が動いている時を、動いていると数える
@@ -171,6 +181,7 @@ hookコマンドはCodexが使うshellで評価される。Windowsでは引用
 承認省略flagを恒久設定へ書かない。利用者の別hookを承認しない。
 選択と配送の所有記録は`~/.config/aiterm-mcp/codex-parent-hooks/`に置く。
 Nodeは`src/setup-node.ts`でHomebrewの同じformulaの`opt`へ正規化し、更新で消えるCellar実体を保存しない。
+動いているprocessが自分のNodeを起こす時・呼び手へ渡す時も、`src/live-node.ts`で今ある場所を引く（`process.execPath`を直接使わない。ADR 0113）。
 
 新規の起動差し替えは作らない。旧中継の設定は新しいhookの確認後に従来の解除処理で復元する。
 macOSの専用LaunchAgent、Windowsのユーザー環境変数、所有外の値の保持は旧adapterが担う。

package/docs/RELEASE.md

@@ -11,6 +11,9 @@ Aitermのreleaseはこのrepositoryが所有する。`.github/workflows/product-
 - 版番号だけの変更はJSONの実差分で識別し、Linuxでbuildと配布metadata・pack・文書確認を行う。依存や実行設定の変更は省略しない。
   文書だけなら文書検査、実装と文書の混在なら関連試験と文書検査を行う。
 - 週1回の定期実行（月曜 03:00 JST）と手動実行は、指定された環境で全テストを回す。定期実行の対象は3環境である。
+- pushは、同じcommitの全テスト（手動実行か定期実行）がもう通っている環境を流さない。枝で手動実行を通してからmainへ早送りすると、
+  mainのpushは変更分類と関門だけで終わる。通っている環境が一部の時は、残りの環境だけを流す。GitHubへ聞けない時は、選んだ環境を全部流す。
+  同じcommitのpush・pull requestの成功は、試験を絞っている事があるので数えない（ADR 0115）。
 - tag push: 所有確認と、tagged commitが`origin/main`の祖先であることの確認だけを行い、npmへprovenance付きで
   publishする。同じcommitのmain CIの結果は待たない。
 
@@ -19,6 +22,8 @@ Aitermのreleaseはこのrepositoryが所有する。`.github/workflows/product-
 1. 変更に直結するfocused testを手元で通す。full regressionは手元で回さず、CIに任せる。
    個別試験も`node --import ./test/seat-env.mjs --test ...`で起動する。稼働中の席の保存場所を試験へ継承しない。
 2. `CHANGELOG.md`の`## [Unreleased]`へ内容を書き、mainへcommitしてpushする。
+   3環境の全テストを先に通しておく時は、枝をpushして手動実行（`gh workflow run ci.yml --ref <枝> -f environment=all -f comparison_base=<前の公開commit>`）を
+   1回流し、通ったcommitをそのままmainへ早送りする。Windowsの全テストは1回で済む。
 3. 一回で公開する。
 
    ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.58.3",
+  "version": "0.59.0",
   "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": [
@@ -72,7 +72,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "aiterm-steer-delivery": "^0.4.3",
+    "aiterm-steer-delivery": "^0.4.6",
     "ws": "8.21.3",
     "zod": "^4.4.3"
   },