peertable 0.4.10 → 0.4.12

package/README.ja.md

@@ -107,9 +107,9 @@ Codex では、スキルが所有する room MCP block をプロジェクトの
 
 動いており、**自分自身の開発に使っている**。2026-08-08 に end-to-end 検証済み——オーケストレーターなしの完全な一周（2 メンバーが相談し、claim し、インターフェースを交渉し、見つけた罠を共有して小さなプロジェクトを出荷）を**外部介入ゼロ**で完走。2026-08-13の実席ライフサイクルでは、作業席が親を通じてsession contextを保ったままmodel / effortを変更し、再起動後はroomと工程正本から再着任した。2026-08-14にはGrok 4.6席の着席、room参加、同一sessionの4.6↔4.5変更、DM起床を実機で確認した。2026-08-17にGrok席はidle待ち、broadcastは本文を残し、tmuxの無い親でbridge cursorが止まらないよう直した。
 
-現在のnpm releaseは **peertable 0.4.10**。
+現在のnpm releaseは **peertable 0.4.12**。
 
-設計文書と決定履歴（**89 決定**）は [docs/plan.md](docs/plan.md)。
+設計文書と決定履歴（**91 決定**）は [docs/plan.md](docs/plan.md)。
 
 Claude Code channels はリサーチプレビューのため、フラグ・プロトコルは変わりうる。
 

package/README.md

@@ -143,9 +143,9 @@ It interviews you, names the members, scaffolds `.team/` (charter + roles, isola
 
 Working, and used to build itself. First verified end-to-end on 2026-08-08 with a full no-orchestrator loop: two members consulted, claimed, negotiated an interface, shared a discovered pitfall, and shipped a small project with **zero external intervention**. A 2026-08-13 real-seat lifecycle verified in-place model/effort changes and restart recovery. On 2026-08-14, a Grok 4.6 seat joined the room, changed 4.6↔4.5 in the same session, and woke on a direct message in a live acceptance run. On 2026-08-17 the wake-up path was corrected so Grok seats wait for idle, broadcasts keep their body, and a parent without a tmux seat cannot stall the bridge cursor.
 
-The current npm release is **peertable 0.4.10**.
+The current npm release is **peertable 0.4.12**.
 
-The design document and decision log (**89 decisions**, in Japanese) live in [docs/plan.md](docs/plan.md).
+The design document and decision log (**91 decisions**, in Japanese) live in [docs/plan.md](docs/plan.md).
 
 Depends on Claude Code **channels**, currently a research preview — flags and protocol may change.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peertable",
-  "version": "0.4.10",
+  "version": "0.4.12",
   "description": "A round table of peer agents. No orchestrator at the head. Turn Claude Code, Codex, and Grok sessions into a team of equal, long-lived peers.",
   "type": "module",
   "license": "MIT",

package/room/client.mjs

@@ -11,7 +11,7 @@ import { fileURLToPath } from 'node:url'
 
 // client.mjs 側のハードコード版数。package.json の version と一致していることを
 // diagnostics の version_consistency が見る（2 つの版数源の drift 検出。決定45）
-const MCP_VERSION = '0.4.10'
+const MCP_VERSION = '0.4.12'
 const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
 
 const USAGE = `usage:
@@ -287,9 +287,11 @@ async function runDiagnostics(asJson) {
       'scripts/teardown.sh',
       'scripts/external-pane.mjs',
       'scripts/launch-seat.sh',
+      'scripts/resolve-seat-placement.mjs',
       'scripts/tmux-at.bash',
       'scripts/tmux-socket.mjs',
       'scripts/seat-identity.mjs',
+      'scripts/pid-alive.mjs',
       'scripts/parent-watch.mjs',
       'scripts/seat-credential.mjs',
       'scripts/ensure-room-mcp.mjs',

package/skill/SKILL.md

@@ -28,7 +28,7 @@ description: 任意プロジェクトに Peertable チーム（対等メンバ
 ## Peertableの正規席と委譲入口
 
 Peertableのメンバー席は、aiterm-mcpの外部PTYに長寿命で着席させる。新しい席は
-`env -u PEERTABLE_POST_TOKEN scripts/launch-seat.sh <project> <name> <model> <vendor> <effort> [brief]`で起こし、既存席の分担・起床・確認は
+`env -u PEERTABLE_POST_TOKEN scripts/launch-seat.sh <project> <name> <role> [brief]`で起こし、既存席の分担・起床・確認は
 `mcp__aiterm__pty_read` / `mcp__aiterm__pty_send` / `mcp__aiterm__pty_key`、roomの`read_unread` / `post`、
 Latticeの`todo`で行う。通常shellのために開いた短命PTYと、メンバーが着席する長寿命PTYは別物である。
 
@@ -49,7 +49,7 @@ script は内部で Aiterm の公開 `claude_agent` / `codex_agent` / `grok_agen
 
 手順は **聞き取り → script → 着任指示** の3段である。scripts が機械部分を全部持つので、AI が手で tmux を組み立てることはしない。
 
-1. **聞き取り**: 対象プロジェクトのパス / **工程正本（`Lattice 併用`＝既定 / `単独`）** / メンバー数とモデル・effort（モデル×effortの選定は dotagents `docs/02_models.md` の役割→順位表を正とし、席の主任務の役割（実装・局所コーディング・監査・反証・調査 等）で引く。**effort は既定値を置かない——席ごとに必ず決める**。`launch-seat.sh` の effort は必須引数で、未指定は着席前に非ゼロ終了する。決定49改・2026-08-19: 旧「設計か確定実装か」の2値軸と既定Sonnetを廃止し、選定正本を02_models順位表へ移管）/ 初期タスク群（何を作るか）/ room 名（既定: プロジェクトのディレクトリ名）/ **公開URL基底**（Lattice 併用のみ。外部ペインに書く URL。クオ環境は `https://peertable.kitepon.dev`。未指定なら room サーバーの URL がそのまま入る＝LAN URL は Lattice を外から見た時に開けない）
+1. **聞き取り**: 対象プロジェクトのパス / **工程正本（`Lattice 併用`＝既定 / `単独`）** / メンバー数と**役割**（dotagents `docs/02_models.md` の役割名そのもの。未指定・未知は着席しない。model×effort は `launch-seat.sh` が順位表1位から機械解決する——呼び出し側が model / vendor / effort を渡して正本を迂回しない。決定49改・決定91）/ 初期タスク群（何を作るか）/ room 名（既定: プロジェクトのディレクトリ名）/ **公開URL基底**（Lattice 併用のみ。外部ペインに書く URL。クオ環境は `https://peertable.kitepon.dev`。未指定なら room サーバーの URL がそのまま入る＝LAN URL は Lattice を外から見た時に開けない）
    - **メンバー数の既定**: Lattice 併用なら plan compile 結果の幅（`max_frontier_width`）に合わせる（実測: 幅3→3人、第2 campaign で幅4→4人目追加）。frontier より多い席は最初から遊ぶ。単独モードには frontier が無いので既定の根拠も無く、聞き取りで決める
    - **運用中のworker席数の標準は「ready＋activeな実装ToDo数」（決定68）**: 監査専任席はworker数、reclaim、scale-down候補へ含めず、最終試験結果を待って監査を担う。claimできるToDoが無いworker席は仕事を発明せず、最終手段として親だけへ待機DMする
    - **モードの選び分け**: タスク間に依存があり並列境界の機械保証が要るなら Lattice 併用。依存の無い小規模作業で、対象プロジェクトに Lattice を持ち込みたくないなら単独。単独で失うのは task 間スケジューリングの機械保証だけで、円卓の核（room・憲章・宣言による協力）は変わらない（決定47）
@@ -61,7 +61,7 @@ script は内部で Aiterm の公開 `claude_agent` / `codex_agent` / `grok_agen
 4. **Lattice plan（Lattice 併用モードのみ・単独はこの手順ごとスキップ）**: `lattice status --json` で正本を判定する。`uninitialized` なら聞き取ったタスクを JSON へ落として `scripts/make-plan-input.mjs <tasks.json> --project <project>` で `plan create` 入力を生成し、`lattice plan create --input .lattice/plan-create.json` を打つ。初期化済みなら `todo migrate` の作法（Lattice 正典）に従う。設計メモは各タスクに必ず書く
    - `make-plan-input.mjs` が digest 計算と `hard_dependencies` の `(from,to)` 昇順ソートを持つ（**手書きで2回踏んだ罠**。順序が崩れると `INPUT_INVALID / pointer:"/"` としか言われない）。`project_id` の既定は project ディレクトリ名で、`external-pane.mjs` が書く `project.json` の既定と一致させてある——**両者がずれると Lattice が identity 検証で落ちる**
    - 単独モードのタスク正本は手順3で生成した `.team/tasks.md` だけである。状態（誰が持っているか・何が終わったか）は持たせない——claim と完了は room の宣言だけが正（決定48 の延長）。ミニタスクトラッカーを別途作らない（決定36）
-5. **メンバー起動**: メンバーごとに `env -u PEERTABLE_POST_TOKEN scripts/launch-seat.sh <project> <name> <model> <claude|codex|grok> <effort> [着任指示]` を実行する。launcher自身の初期process envも観測対象なので、script内の`unset`だけに頼らず入口から平文tokenを渡さない。**vendor・effort とも必須引数**（未指定は usage を出して非ゼロ終了。既定値をコードへ埋めない——席を立てる時に決める）。tmux 作成（aiterm と同じソケットなので、立った席はそのまま `pty_read`/`pty_send` で読める）→ credential file path注入 → 起動 → 既知ダイアログ通過 → 着席確認まで1回で行き、着席しなければ最後の画面を出して非ゼロで落ちる（黙って進まない）
+5. **メンバー起動**: メンバーごとに `env -u PEERTABLE_POST_TOKEN scripts/launch-seat.sh <project> <name> <role> [着任指示]` を実行する。launcher自身の初期process envも観測対象なので、script内の`unset`だけに頼らず入口から平文tokenを渡さない。**role は必須**（02_models の役割名。未指定・`worker` 既定・未知の名前は着席前に非ゼロ終了）。model / vendor / effort は順位表から解決する。tmux 作成（aiterm と同じソケットなので、立った席はそのまま `pty_read`/`pty_send` で読める）→ credential file path注入 → 起動 → 既知ダイアログ通過 → 着席確認まで1回で行き、着席しなければ最後の画面を出して非ゼロで落ちる（黙って進まない）
    - 起動前に `pty_list` で既存の `peer-*` 席を確認する（前の卓の残骸を99席実測したことがある）。同名の席は launch-seat.sh が落としてから立て直す
    - 着任指示を第6引数に渡すと着席後に送る。文面: 「あなたは「<日本語名>」。.team/roles/member.md を読んで着任し、作業ループを開始せよ。全タスク完了の宣言まで自律的に続けること。」
    - 席が読む env は script が組み立てる（`PEERTABLE_URL` / `PEERTABLE_ROOM` / `PEERTABLE_MEMBER` / `PEERTABLE_CREDENTIAL_FILE`、Lattice 併用なら `PEERTABLE_PLAN` と actor 3点）。token値は席別`0600` fileにだけ置き、pathだけを席へ渡す。**channels は `--mcp-config` の MCP server を解決しない**（実測 2026-08-08・Claude Code v2.1.226・決定44）ため、room の MCP 定義は setup.sh が project root へ置く `.mcp.json` が正。Peertable管理下fileはlaunch時にもcurrent-tree clientへ同期する。project に既存 `.mcp.json` があった場合は無断更新せず`SEAT_ROOM_MCP_STALE`で止まるので、AI がroom定義を手動mergeしてteardownで復元する
@@ -230,7 +230,7 @@ witness をどう生成するかは**対象 project 側の作法に従う**（La
 - evidence は記述子 JSON。記述子ファイル自体も repo 内相対パスに置く（repo 外絶対パスは INVALID_ARGUMENTS）。`.team/scripts/done.sh` が正規経路。証跡の置き場は **`evidence/<plan_key>/<task_id>.md`**——task_id は campaign を跨いで再利用されるので、平置きにすると前の campaign の監査証跡を上書きで消す（2026-08-08 実測）
 - **外部ペイン（決定53）は Lattice 0.50.0 以降が要る。** それ以前の Lattice に `external_pane` 入りの `project.json` を差すと、identity 検証が完全一致キーで落ちて `lattice todo status` ごと死ぬ（`PROJECT_IDENTITY_INVALID / identity_schema_invalid`・0.49.0 で実測）。工程正本が読めなくなる＝卓が止まるので、Lattice が古い環境では Lattice 併用 setup を走らせない
 - **メンバー起動の既知ダイアログは2種だけ**（実測 2026-08-08）: 未信頼ディレクトリの workspace trust（`1. Yes, I trust this folder`）と開発 channel 警告（`1. I am using this for local development`）。`--dangerously-skip-permissions` を付けているので MCP 同意ダイアログは出ない。信頼済みディレクトリでは trust も出ない
-- **Codex 席のダイアログは2種で、片方は既定が誤り**（Codex CLI v0.146.0・実測）: ディレクトリ trust（`1. Yes, continue`＝既定で正しい）と、**更新案内（`1. Update now`）は既定のまま Enter を押すと立卓の途中で `npm install -g @openai/codex` が走る**。1つ下の「2. Skip」を選ぶ。更新案内は毎回は出ないので、出た時だけ通す
+- **Codex 席のダイアログは3種で、更新案内と hooks の既定は誤り**（Codex CLI v0.146.0 および 2026-08-20 実測）: ディレクトリ trust（`1. Yes, continue`＝既定で正しい）。**更新案内（`1. Update now`）は既定のまま Enter を押すと立卓の途中で `npm install -g @openai/codex` が走る**ので「2. Skip」。**`Hooks need review` は room MCP 初期化より前に出る**（`SEAT_ROOM_MCP_NOT_READY` のまま rollback）。`launch-seat.sh` は「2. Trust all and continue」を通す。失敗時は rollback 前に `.team/<name>-pane-on-fail.txt` を残す。待ち時間のポーリングで代用しない
 - **Codex はターン実行中でも素送信を受け付ける**（実測 2026-08-08）。busy 中に送った文言はそのターンの中で読まれ、指示どおりに動く（steering）。Codex 席の起床は idle 待ちを持たない
 - **Grok はターン実行中の素送信を今の仕事へ混ぜない**（実測 2026-08-17・Grok Build TUI 既定 `follow_up_behavior=queue`）。届いた文は入力キューへ積まれ、次の user ターンになる。起床ブリッジは Grok 席だけ pane が idle になるまで送らない。busy の判定は `esc to interrupt`、待ち中の `send a message to interrupt`、番号付きキュー＋`Enter:send now`
 - **席の沈黙は「詰まり」と同義ではない。** 発言間隔やファイルの更新時刻から止まったと判定しない——実装が終わって検証に時間を使っているだけのことがある。判定は `tmux_at capture-pane -t peer-<名前> -p`（POSIX は `tmux -S <sock>`、Windows psmux は `tmux -L aiterm-<hash>`。決定88）で**実状態を読む**: 画面に **`esc to interrupt` が在れば長いターンの最中**（通知はターン後にまとめて届くので、呼びかけを足しても速くならない）／選択ダイアログで止まっているなら既知の停止要因／`pane_dead=1` なら落ちている。**スピナーの動名詞（`Cogitating…` 等）で判定しない**——毎回ランダムなので語そのものは使わない（2026-08-08 実測）。Fable のツール実行中は `… (7m 48s` の経過時間行と `/btw` の `without interrupting Claude's current work` が固定句として出る。思考中は `thinking with` / `almost done thinking`。**`esc to interrupt` は Claude 席のステータス行にも Codex 席の `Working (…)` にも入る共通マーカー**で、vendor 分岐が要らない。**読み取りだけなら相手の作業を壊さない**ので、憶測を room へ流す前にこれを見る（2026-08-08 に2人が独立に踏み、先に憶測を流した側が訂正を出した）

package/skill/scripts/aiterm-configure.mjs

@@ -16,7 +16,7 @@ if (!session_id || (!model && !reasoning_effort)) {
 // Aiterm のmanaged session metadataは実行時state root（macOSではTMPDIR）にある。
 // stdio transportの既定環境は親のTMPDIRを落とすため、同じ公開serverへ明示継承する。
 const transport = new StdioClientTransport({ command: 'aiterm-mcp', env: process.env })
-const client = new Client({ name: 'peertable-seat-configure', version: '0.4.10' })
+const client = new Client({ name: 'peertable-seat-configure', version: '0.4.12' })
 await client.connect(transport)
 const result = await client.callTool({
   name: 'agent_configure',

package/skill/scripts/aiterm-launch.mjs

@@ -8,7 +8,7 @@ if (!session_name || !['claude', 'codex', 'grok'].includes(vendor) || !model ||
   throw new Error('SEAT_AITERM_LAUNCH_ARGS_INVALID')
 }
 
-const client = new Client({ name: 'peertable-seat-launch', version: '0.4.10' })
+const client = new Client({ name: 'peertable-seat-launch', version: '0.4.12' })
 await client.connect(new StdioClientTransport({ command: 'aiterm-mcp', env: process.env }))
 const env_vars = [
   'PEERTABLE_URL', 'PEERTABLE_ROOM', 'PEERTABLE_MEMBER', 'PEERTABLE_CREDENTIAL_FILE',

package/skill/scripts/change-seat.sh

@@ -59,9 +59,9 @@ name=sys.argv[1]
 member=next((m for m in json.load(sys.stdin).get("members",[]) if m.get("name")==name),None)
 if not member or member.get("vendor") not in ("claude","codex","grok") or not member.get("model"):
     raise SystemExit(1)
-print("\t".join((member["vendor"],member["model"],member.get("effort") or "",member.get("aiterm_session_id") or "")))
+print("\t".join((member["vendor"],member["model"],member.get("effort") or "",member.get("aiterm_session_id") or "",member.get("role") or "")))
 ' "$name") || { echo "SEAT_CHANGE_MEMBER_METADATA_MISSING: ${name} のvendor/modelが要る" >&2; exit 1; }
-IFS=$'\t' read -r old_vendor old_model old_effort aiterm_session_id <<EOF
+IFS=$'\t' read -r old_vendor old_model old_effort aiterm_session_id old_role <<EOF
 $meta
 EOF
 
@@ -202,11 +202,15 @@ else
     exit 1
   fi
   launch="$script_dir/launch-seat.sh"
+  [ -n "$old_role" ] || {
+    echo "SEAT_CHANGE_ROLE_MISSING: ${name} の role が無い（02_models の役割名が要る）" >&2
+    exit 1
+  }
   brief="席設定が変更され（${changes}）、席を再起動しました。.team/roles/member.mdと工程正本・roomログから再着任し、進行中taskを続けてください。"
-  if ! "$launch" "$proj" "$name" "$model" "$vendor" "$effort" "$brief"; then
+  if ! "$launch" "$proj" "$name" "$old_role" "$brief" --model "$model" --vendor "$vendor" --effort "$effort"; then
     echo "SEAT_CHANGE_RESTART_FAILED: ${changes}。旧設定（vendor=${old_vendor} / model=${old_model} / effort=${old_effort:-default}）へrollbackする" >&2
     rollback_brief="席設定の変更に失敗して旧設定へrollbackしました。.team/roles/member.mdと工程正本・roomログから再着任してください。"
-    if "$launch" "$proj" "$name" "$old_model" "$old_vendor" "$old_effort" "$rollback_brief"; then
+    if "$launch" "$proj" "$name" "$old_role" "$rollback_brief" --model "$old_model" --vendor "$old_vendor" --effort "$old_effort"; then
       echo "SEAT_CHANGE_ROLLED_BACK: ${name} は vendor=${old_vendor} / model=${old_model} / effort=${old_effort:-default} で再着席" >&2
     else
       echo "SEAT_CHANGE_ROLLBACK_FAILED: ${name} の席を手動で復旧する必要がある" >&2

package/skill/scripts/ensure-bridge.sh

@@ -18,7 +18,7 @@ if [ $# -eq 0 ] && [ -f "$record" ]; then
 fi
 if [ -f "$record" ]; then
   pid=$(node -e 'try{process.stdout.write(String(require(process.argv[1]).pid||""))}catch{}' "$record")
-  if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then exit 0; fi
+  if [ -n "$pid" ] && node "$(dirname "$0")/pid-alive.mjs" "$pid"; then exit 0; fi
   if ! "$force" && grep -q 'WRITE_DENIED' "$log" 2>/dev/null; then echo "${name}-bridge: 前回はWRITE_DENIEDで終了。--forceを指定すること" >&2; exit 1; fi
 fi
 # shellcheck disable=SC1091
@@ -30,7 +30,10 @@ session="peertable-${name}-${room}"
 # 新しい bridge が1バイトも動いていない段階で success を返す——「起動していないのに
 # 起動したと言う」＝この supervisor が塞ぐはずの穴そのものになる。
 rm -f "$record"
-: > "$log"
+if ! node -e 'import { writeFileSync } from "node:fs"; writeFileSync(process.argv[1], "")' "$log"; then
+  echo "${name}-bridge: log を切り詰められないので追記する" >&2
+  : >> "$log" || true
+fi
 # **手渡された env を常駐へ渡す。** 新しい session が継ぐのは tmux *server* の環境であって
 # 呼び出し元 client の環境ではないので、素で起こすと `PEERTABLE_TMUX_SOCKET` の手渡しが黙って消え、
 # 常駐が別の socket（本番の既定）を観測しにいく（2026-08-11 実測）。決定73 と同じ形の裏返しである。

package/skill/scripts/ensure-codex-room-mcp.mjs

@@ -64,6 +64,7 @@ function expectedBlock(addedNewline) {
   const explicitEnv = seatEnvNames
     .filter((name) => process.env[name] !== undefined && process.env[name] !== '')
     .map((name) => `${name} = ${JSON.stringify(process.env[name])}`)
+  if (process.env.PATH) explicitEnv.unshift(`PATH = ${JSON.stringify(process.env.PATH)}`)
   return [
     `# BEGIN PEERTABLE ROOM MCP added_newline=${addedNewline ? '1' : '0'}`,
     '[mcp_servers.room]',

package/skill/scripts/launch-seat.sh

@@ -1,25 +1,41 @@
 #!/bin/bash
 # 席を1つ立てる（tmux 作成 → env 注入 → エージェント起動 → 既知ダイアログ通過 → 着席確認）。
-# usage: launch-seat.sh <project_dir> <name> <model> <vendor> <effort> [brief] [role]
-#   vendor: claude / codex / grok
-#   effort: 必須。既定値をコードへ埋めない——席を立てる時に決める（オーナー裁定）
+# usage: launch-seat.sh <project_dir> <name> <role> [brief] [--model <model> --vendor <vendor> --effort <effort>]
+#   role: 必須。dotagents docs/02_models.md の役割名（未指定・未知は着席前に拒否）
+#   model / vendor / effort: 省略時は 02_models 順位表から機械解決する。上書きするなら3つとも必須
 #   brief:  着席が成立したら送る着任指示（省略時は送らない）
 #
 # room 名・server URL・モード・plan key は <project>/.team/setup-state.json から読む（setup.sh の後に呼ぶ）。
 # 書込トークンは helper が ~/.config/peertable.env から席別 0600 file へ移し、pathだけを席へ渡す。
 # tmux は aiterm-mcp と同じソケットへ作るので、立てた席はそのまま pty_read / pty_send で読める。
 set -e
-proj="$1"; name="$2"; model="$3"; vendor="$4"; effort="$5"; brief="$6"; role="${7:-worker}"
-[ -n "$proj" ] && [ -n "$name" ] && [ -n "$model" ] && [ -n "$vendor" ] && [ -n "$effort" ] || {
-  echo "usage: launch-seat.sh <project_dir> <name> <model> <vendor> <effort> [brief]" >&2; exit 1;
+usage() {
+  echo "usage: launch-seat.sh <project_dir> <name> <role> [brief] [--model <model> --vendor <vendor> --effort <effort>]" >&2
 }
-if [ "$vendor" = "claude" ]; then
-  case "$effort" in
-    low|medium|high|xhigh|max) ;;
-    *) echo "unknown effort: ${effort}（claude は low|medium|high|xhigh|max）" >&2; exit 1 ;;
+proj="$1"; name="$2"; role="$3"
+[ -n "$proj" ] && [ -n "$name" ] && [ -n "$role" ] || { usage; exit 1; }
+shift 3
+brief=""
+opt_model=""; opt_vendor=""; opt_effort=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --model) opt_model="${2:-}"; shift 2 ;;
+    --vendor) opt_vendor="${2:-}"; shift 2 ;;
+    --effort) opt_effort="${2:-}"; shift 2 ;;
+    --*) echo "SEAT_LAUNCH_ARGS_INVALID: 不明な引数 $1" >&2; usage; exit 1 ;;
+    *)
+      if [ -z "$brief" ]; then brief="$1"; shift
+      else echo "SEAT_LAUNCH_ARGS_INVALID: 余分な引数 $1" >&2; usage; exit 1
+      fi
+      ;;
   esac
+done
+if [ -n "$opt_model$opt_vendor$opt_effort" ]; then
+  [ -n "$opt_model" ] && [ -n "$opt_vendor" ] && [ -n "$opt_effort" ] || {
+    echo "SEAT_LAUNCH_PLACEMENT_INCOMPLETE: --model / --vendor / --effort は3つ揃える" >&2
+    exit 1
+  }
 fi
-case "$role" in worker|auditor) ;; *) echo "unknown seat role: ${role}（worker / auditor）" >&2; exit 1 ;; esac
 
 if [ -n "${PEERTABLE_MEMBER:-}" ]; then
   echo "SEAT_LAUNCH_DELEGATED_CHILD_FORBIDDEN: PEERTABLE_MEMBER=${PEERTABLE_MEMBER} を継承した呼出元からの席起動を拒否" >&2
@@ -33,6 +49,7 @@ credential_helper="${PEERTABLE_CREDENTIAL_HELPER:-$(dirname "$0")/seat-credentia
 room_mcp_helper="${PEERTABLE_ROOM_MCP_HELPER:-$(dirname "$0")/ensure-room-mcp.mjs}"
 codex_room_mcp_helper="${PEERTABLE_CODEX_ROOM_MCP_HELPER:-$(dirname "$0")/ensure-codex-room-mcp.mjs}"
 aiterm_launch_helper="${PEERTABLE_AITERM_LAUNCH_HELPER:-$(dirname "$0")/aiterm-launch.mjs}"
+placement_helper="${PEERTABLE_PLACEMENT_HELPER:-$(dirname "$0")/resolve-seat-placement.mjs}"
 # shellcheck disable=SC1091
 . "$(dirname "$0")/tmux-at.bash"
 peertable_repo=$(cd "$(dirname "$0")/../.." && pwd -P)
@@ -41,6 +58,32 @@ credential_file=""
 credential_persist=false
 aiterm_session_id=""
 
+if [ -n "$opt_model" ]; then
+  model="$opt_model"; vendor="$opt_vendor"; effort="$opt_effort"
+  echo "SEAT_PLACEMENT_OVERRIDE: ${role} → ${vendor} / ${model} / ${effort}"
+else
+  placement=$(node "$placement_helper" "$role") || exit "$?"
+  IFS=$'\t' read -r model vendor effort rank <<EOF
+$(python3 -c 'import json,sys;p=json.load(sys.stdin);print("\t".join((p["model"],p["vendor"],p.get("effort") or "",str(p["rank"]))))' <<<"$placement")
+EOF
+  echo "SEAT_PLACEMENT: ${role} → ${vendor} / ${model}${effort:+ / $effort}（02_models ${rank}位）"
+  python3 -c 'import json,sys
+p=json.load(sys.stdin)
+for item in p.get("dropped") or []:
+    print("SEAT_PLACEMENT_DROPPED: rank %s %s %s" % (item.get("rank"), item.get("reason"), item.get("cell") or ""), file=sys.stderr)
+' <<<"$placement" || true
+fi
+case "$vendor" in
+  claude|codex|grok) ;;
+  *) echo "SEAT_LAUNCH_VENDOR_UNSUPPORTED: vendor=${vendor}" >&2; exit 1 ;;
+esac
+if [ "$vendor" = "claude" ] && [ -n "$effort" ]; then
+  case "$effort" in
+    low|medium|high|xhigh|max) ;;
+    *) echo "unknown effort: ${effort}（claude は low|medium|high|xhigh|max）" >&2; exit 1 ;;
+  esac
+fi
+
 # brief は tmux のコマンド引数へ直接載せない。長さを着席前に検証してから一時 file へ置き、
 # tmux の buffer 経由で貼る。入力を受理できない時は model preflight・tmux・member 登録を
 # 一つも行わず、何が拒否されたかを機械的に読める形で返す。
@@ -328,10 +371,49 @@ room_ready_deadline=$((SECONDS + 30))
 room_ready=false
 grok_trust_accepted=false
 mcp_consent_accepted=false
+codex_hooks_accepted=false
+codex_update_accepted=false
+codex_trust_accepted=false
 while [ $SECONDS -lt "$room_ready_deadline" ]; do
   # Grok Build は初めて開く作業treeで、room MCPを初期化する前にworkspace trustを尋ねる。
   # Peertableが正式に着席させるtreeなので、この既知文言だけを一度通す。未知の確認画面を
   # 汎用的に承認するfallbackにはしない。承認後のMCP初期化時間は改めて30秒確保する。
+  if [ "$vendor" = codex ]; then
+    codex_screen=$(tmux_at capture-pane -t "$sess" -p 2>/dev/null || true)
+    if [ "$codex_update_accepted" != true ]; then
+      case "$codex_screen" in
+        *"Update now"*)
+          if tmux_at send-keys -t "$sess" Down && tmux_at send-keys -t "$sess" Enter; then
+            codex_update_accepted=true
+            room_ready_deadline=$((SECONDS + 30))
+            echo "codex update prompt: skipped"
+          fi
+          ;;
+      esac
+    fi
+    if [ "$codex_hooks_accepted" != true ]; then
+      case "$codex_screen" in
+        *"Hooks need review"*)
+          if tmux_at send-keys -t "$sess" Down && tmux_at send-keys -t "$sess" Enter; then
+            codex_hooks_accepted=true
+            room_ready_deadline=$((SECONDS + 30))
+            echo "codex hooks prompt: trust all"
+          fi
+          ;;
+      esac
+    fi
+    if [ "$codex_trust_accepted" != true ]; then
+      case "$codex_screen" in
+        *"Yes, continue"*)
+          if tmux_at send-keys -t "$sess" Enter; then
+            codex_trust_accepted=true
+            room_ready_deadline=$((SECONDS + 30))
+            echo "codex directory trust: accepted"
+          fi
+          ;;
+      esac
+    fi
+  fi
   if [ "$vendor" = grok ] && [ "$grok_trust_accepted" != true ]; then
     grok_screen=$(tmux_at capture-pane -t "$sess" -p 2>/dev/null || true)
     case "$grok_screen" in
@@ -371,6 +453,8 @@ while [ $SECONDS -lt "$room_ready_deadline" ]; do
 done
 if [ "$room_ready" != true ]; then
   echo "SEAT_ROOM_MCP_NOT_READY: room member登録を観測できない（無関係MCP warningとroom不成立を分離。席をrollbackする）" >&2
+  tmux_at capture-pane -t "$sess" -p >"$proj/.team/${name}-pane-on-fail.txt" 2>/dev/null || true
+  echo "pane saved: $proj/.team/${name}-pane-on-fail.txt" >&2
   exit 1
 fi
 echo "room ready: ${room}/${name}"
@@ -460,7 +544,7 @@ seat_pid=""
 pane_pid=$(tmux_at list-panes -t "$sess" -F '#{pane_pid}' 2>/dev/null | head -1 || true)
 seat_ident=""
 if [ -n "$pane_pid" ]; then
-  seat_ident=$(node "$(dirname "$0")/seat-identity.mjs" "$pane_pid" 2>/dev/null || true)
+  seat_ident=$(node "$(dirname "$0")/seat-identity.mjs" "$pane_pid") || seat_ident=""
 fi
 if [ -n "$seat_ident" ]; then
   seat_pid=$(python3 -c "import json,sys;print(json.load(sys.stdin)['pid'])" <<<"$seat_ident")

package/skill/scripts/parent-watch.mjs

@@ -120,6 +120,16 @@ let state = await ensurePrimed()
 if (mode === '--prime') process.exit(0)
 
 const alive = pid => { try { process.kill(pid, 0); return true } catch { return false } }
+function stopPid(pid) {
+  try { process.kill(pid, 'SIGTERM') } catch { return }
+  const deadline = Date.now() + 2000
+  while (Date.now() < deadline && alive(pid)) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 50)
+  }
+  if (alive(pid)) {
+    try { process.kill(pid, 'SIGKILL') } catch {}
+  }
+}
 function acquireLock() {
   try {
     writeFileSync(lockPath, `${process.pid}\n`, { flag: 'wx', mode: 0o600 })
@@ -127,13 +137,13 @@ function acquireLock() {
     if (error.code !== 'EEXIST') throw error
     let owner = null
     try { owner = Number(readFileSync(lockPath, 'utf8').trim()) } catch {}
-    if (Number.isSafeInteger(owner) && !alive(owner)) {
-      unlinkSync(lockPath)
-      writeFileSync(lockPath, `${process.pid}\n`, { flag: 'wx', mode: 0o600 })
-      return
+    if (Number.isSafeInteger(owner) && owner === process.pid) return
+    if (Number.isSafeInteger(owner) && alive(owner)) {
+      process.stderr.write(`PARENT_WATCH_REPLACING: pid ${owner}\n`)
+      stopPid(owner)
     }
-    console.error(`PARENT_WATCH_ALREADY_RUNNING: pid ${Number.isSafeInteger(owner) ? owner : '不明'}`)
-    process.exit(1)
+    try { unlinkSync(lockPath) } catch {}
+    writeFileSync(lockPath, `${process.pid}\n`, { flag: 'wx', mode: 0o600 })
   }
 }
 function releaseLock() {

package/skill/scripts/pid-alive.mjs

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+// Windows Git Bash の kill -0 は Win32 pid を見ない。Node の process.kill は見る。
+const pid = Number(process.argv[2])
+if (!Number.isInteger(pid) || pid <= 0) process.exit(2)
+try {
+  process.kill(pid, 0)
+  process.exit(0)
+} catch {
+  process.exit(1)
+}

package/skill/scripts/resolve-seat-placement.mjs

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+// 02_models.md の役割→1位〜3位から、着席可能な vendor / model / effort を解決する。
+// 具体モデル名はここに持たない。台帳と順位表をその場で読む。
+import { existsSync, readFileSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const EFFORT = /×\s*(none|low|medium|high|xhigh|max|ultra)/iu
+const vendorOf = (modelName) => {
+  const name = String(modelName).trim()
+  if (/^claude\b/iu.test(name)) return 'claude'
+  if (/^gpt\b|^gpt-/iu.test(name)) return 'codex'
+  if (/^grok\b/iu.test(name)) return 'grok'
+  return null
+}
+
+const fail = (code, message) => {
+  process.stderr.write(`${code}: ${message}\n`)
+  process.exit(2)
+}
+
+export function findModelsDoc({ env = process.env, exists = existsSync, scriptDir = here } = {}) {
+  if (env.PEERTABLE_MODELS_DOC) return resolve(env.PEERTABLE_MODELS_DOC)
+  if (env.DOTAGENTS_ROOT) return join(resolve(env.DOTAGENTS_ROOT), 'docs/02_models.md')
+  const sibling = resolve(scriptDir, '../../../dotagents/docs/02_models.md')
+  if (exists(sibling)) return sibling
+  return null
+}
+
+const stripCell = (cell) => String(cell ?? '').replace(/\*\*/g, '').trim()
+
+const parseMarkdownTable = (block) => {
+  const lines = block.split('\n').map((line) => line.trim()).filter((line) => line.startsWith('|'))
+  if (lines.length < 3) return []
+  const headers = lines[0].split('|').slice(1, -1).map((cell) => stripCell(cell))
+  return lines.slice(2).map((line) => {
+    const cells = line.split('|').slice(1, -1).map((cell) => stripCell(cell))
+    return Object.fromEntries(headers.map((header, index) => [header, cells[index] ?? '']))
+  })
+}
+
+const section = (markdown, heading) => {
+  const start = markdown.indexOf(`## ${heading}`)
+  if (start < 0) return ''
+  const rest = markdown.slice(start)
+  const next = rest.search(/\n## /)
+  return next < 0 ? rest : rest.slice(0, next)
+}
+
+const slugOf = (cell) => {
+  const alias = cell.match(/alias\s+`([^`]+)`/u)
+  if (alias) return alias[1]
+  const slug = cell.match(/`([^`]+)`/u)
+  return slug ? slug[1] : null
+}
+
+export function parseLedger(markdown) {
+  const rows = parseMarkdownTable(section(markdown, 'モデル台帳'))
+  return rows.flatMap((row) => {
+    const name = row['モデル']
+    const slug = slugOf(row['slug'] ?? '')
+    const vendor = vendorOf(name)
+    if (!name || !slug || !vendor) return []
+    return [{ name, slug, vendor }]
+  })
+}
+
+const parseCell = (cell) => {
+  const raw = stripCell(cell)
+  if (!raw || raw === '—' || raw === '-') return null
+  if (raw.includes('オーナー指定')) return { skip: 'owner-pin', cell: raw }
+  if (/^ChatGPT/iu.test(raw) || raw.includes('gpt-connector')) return { skip: 'not-a-seat', cell: raw }
+  const effortMatch = raw.match(EFFORT)
+  const modelKey = raw.split('×')[0]
+    .replace(/（[^）]*）/gu, '')
+    .replace(/\([^)]*\)/gu, '')
+    .trim()
+  if (!modelKey) return { skip: 'unparseable', cell: raw }
+  return {
+    modelKey,
+    effort: effortMatch ? effortMatch[1].toLowerCase() : null,
+    cell: raw,
+  }
+}
+
+const matchLedger = (modelKey, ledger) => {
+  const key = modelKey.toLowerCase()
+  const exact = ledger.find((row) => row.name.toLowerCase() === key)
+  if (exact) return exact
+  const contained = ledger.filter((row) => row.name.toLowerCase().includes(key) || key.includes(row.name.toLowerCase()))
+  if (contained.length === 1) return contained[0]
+  const token = ledger.filter((row) => row.name.toLowerCase().split(/\s+/u).includes(key))
+  if (token.length === 1) return token[0]
+  return null
+}
+
+export function resolveSeatPlacement(role, markdown, { source = '' } = {}) {
+  const wanted = String(role ?? '').trim()
+  if (!wanted) {
+    return { error: 'SEAT_ROLE_REQUIRED', message: 'role が空（02_models の役割名が要る）' }
+  }
+  const ranks = parseMarkdownTable(section(markdown, '順位表（役割→1位〜3位）'))
+  const row = ranks.find((item) => item['役割'] === wanted)
+  if (!row) {
+    const known = ranks.map((item) => item['役割']).filter(Boolean)
+    return { error: 'SEAT_ROLE_UNKNOWN', message: `未知の役割: ${wanted}（${known.join(' / ')}）` }
+  }
+  const ledger = parseLedger(markdown)
+  const dropped = []
+  for (const rank of [1, 2, 3]) {
+    const parsed = parseCell(row[`${rank}位`])
+    if (!parsed) continue
+    if (parsed.skip) {
+      dropped.push({ rank, reason: parsed.skip, cell: parsed.cell })
+      continue
+    }
+    const hit = matchLedger(parsed.modelKey, ledger)
+    if (!hit) {
+      dropped.push({ rank, reason: 'not-in-ledger', cell: parsed.cell })
+      continue
+    }
+    if (hit.slug === 'haiku') {
+      return { role: wanted, rank, vendor: hit.vendor, model: hit.slug, effort: '', source, dropped }
+    }
+    if (!parsed.effort) {
+      dropped.push({ rank, reason: 'effort-missing', cell: parsed.cell })
+      continue
+    }
+    return {
+      role: wanted,
+      rank,
+      vendor: hit.vendor,
+      model: hit.slug,
+      effort: parsed.effort,
+      source,
+      dropped,
+    }
+  }
+  return {
+    error: 'SEAT_PLACEMENT_UNRESOLVABLE',
+    message: `${wanted} を着席可能な vendor/model/effort へ解決できない`,
+    dropped,
+  }
+}
+
+const isMain = process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)
+if (isMain) {
+  const role = process.argv[2]
+  const doc = findModelsDoc()
+  if (!doc) {
+    fail('SEAT_MODELS_DOC_MISSING', '02_models.md が見つからない（PEERTABLE_MODELS_DOC または DOTAGENTS_ROOT を渡す）')
+  }
+  if (!existsSync(doc)) {
+    fail('SEAT_MODELS_DOC_MISSING', `02_models.md が無い: ${doc}`)
+  }
+  const result = resolveSeatPlacement(role, readFileSync(doc, 'utf8'), { source: doc })
+  if (result.error) fail(result.error, result.message)
+  process.stdout.write(`${JSON.stringify(result)}\n`)
+}

package/skill/scripts/seat-identity.mjs

@@ -2,15 +2,29 @@
 // pane_pid から Lattice attach 用の pid / lstart / argv を1件に決める。
 // POSIX は ps。Windows は Win32_Process（ps -Ao は Git Bash で unknown option -- A）。
 import { execFileSync } from 'node:child_process'
-
-const panePid = process.argv[2]
-if (!/^\d+$/.test(panePid || '')) {
-  console.error('usage: seat-identity.mjs <pane_pid>')
-  process.exit(2)
-}
+import { resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
 
 const AGENT = /(?:claude|codex|grok|composer)(?:\.cmd|\.exe)?(?:\s|$)/iu
 
+export function parseWinCreationDate(value) {
+  if (value instanceof Date) {
+    if (Number.isNaN(value.getTime())) throw new Error('pid の CreationDate を解釈できない')
+    return value.toISOString()
+  }
+  if (typeof value === 'number' && Number.isFinite(value)) {
+    const parsed = new Date(value)
+    if (Number.isNaN(parsed.getTime())) throw new Error('pid の CreationDate を解釈できない')
+    return parsed.toISOString()
+  }
+  const text = String(value ?? '').trim()
+  const microsoft = /^\/Date\((-?\d+)(?:[+-]\d+)?\)\/$/u.exec(text)
+  if (microsoft) return new Date(Number(microsoft[1])).toISOString()
+  const parsed = new Date(text)
+  if (Number.isNaN(parsed.getTime())) throw new Error(`pid の CreationDate を解釈できない: ${text}`)
+  return parsed.toISOString()
+}
+
 function posixIdentity(pid) {
   const table = execFileSync('ps', ['-Ao', 'pid=,ppid=,pgid='], { encoding: 'utf8' })
   const leaders = table.split('\n').flatMap((line) => {
@@ -43,16 +57,24 @@ function winIdentity(pid) {
   if (AGENT.test(String(self.CommandLine || ''))) chosen = self
   else if (agentKids.length === 1) chosen = agentKids[0]
   else if (children.length === 1) chosen = children[0]
-  const started = chosen.CreationDate ? new Date(chosen.CreationDate).toISOString() : ''
+  const started = chosen.CreationDate ? parseWinCreationDate(chosen.CreationDate) : ''
   const argv = String(chosen.CommandLine || '').trim()
   if (!started || !argv) throw new Error('pid の CreationDate/CommandLine を観測できない')
   return { pid: Number(chosen.ProcessId), started_identity: started, argv }
 }
 
-try {
-  const ident = process.platform === 'win32' ? winIdentity(panePid) : posixIdentity(panePid)
-  process.stdout.write(`${JSON.stringify(ident)}\n`)
-} catch (error) {
-  console.error(error.message || error)
-  process.exit(1)
+const isCli = process.argv[1] && fileURLToPath(import.meta.url) === resolve(process.argv[1])
+if (isCli) {
+  const panePid = process.argv[2]
+  if (!/^\d+$/.test(panePid || '')) {
+    console.error('usage: seat-identity.mjs <pane_pid>')
+    process.exit(2)
+  }
+  try {
+    const ident = process.platform === 'win32' ? winIdentity(panePid) : posixIdentity(panePid)
+    process.stdout.write(`${JSON.stringify(ident)}\n`)
+  } catch (error) {
+    console.error(error.message || error)
+    process.exit(1)
+  }
 }