peertable 0.3.6 → 0.3.8

package/README.ja.md

@@ -1,3 +1,9 @@
+<p align="center">
+  <img src=".github/og.png" alt="Peertable — 風化した円卓の遺構。誰の席も高くない" width="100%">
+  <br>
+  <sub><em>この画像は、誰の席も高く置かれない、一つの円卓を囲む対等な仲間の姿を表しています。</em></sub>
+</p>
+
 # Peertable
 
 **A round table of peer agents. No orchestrator at the head.**
@@ -67,14 +73,24 @@ docker compose -f deploy/compose.yaml up -d
 
 `http://localhost:8790` を開くと、全 room にライブ Web ビュー（SSE）が付く。**Web UI は観戦専用**——書込は全て API 経由で、`PEERTABLE_POST_TOKEN` 設定時はトークン必須。外から届く設置では必ずトークンを設定する。
 
-**2. メンバーを着席させる:**
+ライブビューはメンバーごとに vendor / model / effort と**稼働状態**（作業中・待機・**承認待ち**（許可ダイアログで止まっている）・停止）を出す。作業中の席はアイコンが動き、完了宣言（`[done]` / `[完了]` / `受理:` 等）の瞬間に席の上へ印が浮く。状態変化は SSE で押し込むので、30秒の再取得を待たず観測周期（約8秒）で切り替わる。発言にはログ番号（`[123]`）が付き、ライブ新着はブロック単位で現れる。**点が付かない席は「誰も報告していない席」**——状態の送信は別プロセス（スキルが起こす）で、**書けない時は常駐せずに死ぬ**ので「起きているのに黙っている」状態は存在しない。
+
+API: `GET /api/<room>/messages` / `members` / `summary`（約120バイト・`seq`・`last_ts`・`member_count`）/ `events`（SSE）、`POST /api/<room>/messages` / `members`。
+
+**2. メンバーを着席させる。** room の MCP 定義は**プロジェクト root の `.mcp.json`** に置く:
+
+```jsonc
+// <project>/.mcp.json
+{ "mcpServers": { "room": { "command": "peertable-client", "args": [] } } }
+```
 
 ```bash
 export PEERTABLE_URL=http://localhost:8790 PEERTABLE_ROOM=myproject PEERTABLE_MEMBER=hinata
-claude --mcp-config .team/mcp.json \
-      --dangerously-load-development-channels server:room
+claude --dangerously-load-development-channels server:room
 ```
 
+**`--mcp-config` で渡してはいけない。** channels はその経路の MCP server を解決せず、バナーに `server:room · no MCP server configured with that name` が出て**room の配達だけが黙って死ぬ**（Claude Code v2.1.226 で実測・決定44）。スキルを使えば自動で置かれ、teardown で戻る。
+
 **3. あるいはスキルに全部やらせる** — `skill/` を `~/.claude/skills/peertable` にリンクして、セッションに一言:
 
 > 円卓を立てて
@@ -85,7 +101,9 @@ claude --mcp-config .team/mcp.json \
 
 ## 状態
 
-2026-08-08 に end-to-end 検証済み。オーケストレーターなしの完全な一周——2 メンバーが相談し、claim し、インターフェースを交渉し、見つけた罠を共有し、相互検品して小さなプロジェクトを出荷——を**外部介入ゼロ**で完走。設計文書と決定履歴（51 決定）は [docs/plan.md](docs/plan.md)。
+動いており、**自分自身の開発に使っている**。2026-08-08 に end-to-end 検証済み——オーケストレーターなしの完全な一周（2 メンバーが相談し、claim し、インターフェースを交渉し、見つけた罠を共有し、相互検品して小さなプロジェクトを出荷）を**外部介入ゼロ**で完走。以後、Peertable 自身への変更も卓が出している。直近は 2026-08-10 に上記の稼働状態表示を2席の卓で実装し、**各タスクを書いていない側の席が独立に監査**して受理した。
+
+設計文書と決定履歴（**73 決定**）は [docs/plan.md](docs/plan.md)。
 
 Claude Code channels はリサーチプレビューのため、フラグ・プロトコルは変わりうる。
 

package/README.md

@@ -1,3 +1,9 @@
+<p align="center">
+  <img src=".github/og.png" alt="Peertable — an ancient weathered round table where every place is equal" width="100%">
+  <br>
+  <sub><em>This image represents equal peers gathering around one shared table, with no seat raised above another.</em></sub>
+</p>
+
 # Peertable
 
 **A round table of peer agents. No orchestrator at the head.**
@@ -76,9 +82,15 @@ Standalone gives up machine-guaranteed scheduling across tasks — nothing else.
 
 ```
 room/     room server (zero-dependency Node) + per-session MCP channel client
-skill/    "peertable" skill for Claude Code: setup / disband (teardown) of a full table
-docs/     plan.md — the living design document & decision log (Japanese)
-experiments/  verification harnesses (V1 channels, V2 Lattice concurrency, V3 full loop)
+skill/    "peertable" skill for Claude Code: setup / disband (teardown) of a full table,
+          plus the seat launcher and the wake-up / seat-state / run bridges
+deploy/   compose + Caddy snippet for running the room server as a resident service
+docs/     plan.md — the living design document & decision log (Japanese),
+          plus one plan_*.md per campaign
+evidence/ per-task completion evidence referenced by the Lattice plan store
+experiments/  verification harnesses — one per pitfall we actually hit, each pinning the
+          behaviour so it cannot silently regress (channels, Lattice concurrency, the full
+          loop, pane-state classification, token resolution, teardown, …)
 ```
 
 ## Quick start
@@ -97,15 +109,25 @@ docker compose -f deploy/compose.yaml up -d
 
 Open `http://localhost:8790` — every room gets a live web view (SSE). **The web UI is spectator-only**: all writes go through the API and require `PEERTABLE_POST_TOKEN` when set. Set the token whenever the server is reachable from outside.
 
-**2. Seat a member session:**
+The live view shows, per member: vendor / model / reasoning effort, and a **working state** — 作業中 (busy) · 待機 (idle) · 承認待ち (blocked on a permission prompt) · 停止 (dead). A busy seat's avatar animates; a completion (`[done]` / `[完了]` / `受理:` …) pops a marker over the seat. State changes are pushed over SSE, so the icon turns within the observer's polling interval (~8s), not on the next 30-second refresh. Messages carry their log number (`[123]`) for quoting, and live arrivals reveal block by block. **A seat with no dot is one nobody is reporting on** — the state feed is a separate opt-in process (the skill starts it for you), and it refuses to run if it cannot write, so "running but silent" cannot happen.
+
+Endpoints: `GET /api/<room>/messages` · `GET /api/<room>/members` · `GET /api/<room>/summary` (≈120 bytes: `seq`, `last_ts`, `member_count`) · `GET /api/<room>/events` (SSE) · `POST /api/<room>/messages` · `POST /api/<room>/members`.
+
+**2. Seat a member session.** The room MCP definition must live in the **project-root `.mcp.json`**:
+
+```jsonc
+// <project>/.mcp.json
+{ "mcpServers": { "room": { "command": "peertable-client", "args": [] } } }
+```
 
 ```bash
 export PEERTABLE_URL=http://localhost:8790 PEERTABLE_ROOM=myproject PEERTABLE_MEMBER=hinata
-claude --mcp-config .team/mcp.json \
-      --dangerously-load-development-channels server:room
+claude --dangerously-load-development-channels server:room
 ```
 
-The `room` entry in `.team/mcp.json` is just `{ "command": "peertable-client" }`. The member gets four tools — `post`, `read_unread`, `read_log`, `members` — and a channel that wakes it whenever teammates speak. (`--dangerously-load-development-channels` is required while channels are in research preview; custom channels aren't on the allowlist yet.)
+**Do not pass it via `--mcp-config`.** Channels do not resolve MCP servers given that way: the banner prints `server:room · no MCP server configured with that name` and room delivery goes silent while everything else looks fine (measured on Claude Code v2.1.226; decision 44 in [docs/plan.md](docs/plan.md)). The skill handles this for you and reverts the file on teardown.
+
+The member gets four tools — `post`, `read_unread`, `read_log`, `members` — and a channel that wakes it whenever teammates address it. (`--dangerously-load-development-channels` is required while channels are in research preview; custom channels aren't on the allowlist yet.)
 
 **3. Or let the skill do all of it** — link `skill/` as `~/.claude/skills/peertable`, then tell your session:
 
@@ -115,7 +137,9 @@ It interviews you, names the members, scaffolds `.team/` (charter + roles, isola
 
 ## Status
 
-Working, verified end-to-end on 2026-08-08 — including a full no-orchestrator loop: two members consulted, claimed, negotiated an interface, shared a discovered pitfall, cross-reviewed and shipped a small project with **zero external intervention**. The design document and decision log (51 decisions, in Japanese) live in [docs/plan.md](docs/plan.md).
+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, cross-reviewed and shipped a small project with **zero external intervention**. Since then the table has repeatedly been the thing that ships changes to Peertable itself — most recently (2026-08-10) the live seat-state surface described above, built by a two-member table whose every task was independently audited by the member who did not write it.
+
+The design document and decision log (**73 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.3.6",
+  "version": "0.3.8",
   "description": "A round table of peer agents. No orchestrator at the head. Turn Claude Code sessions into a team of equal, long-lived peers.",
   "type": "module",
   "license": "MIT",

package/room/client.mjs

@@ -5,12 +5,13 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js'
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js'
 import { existsSync, readFileSync } from 'node:fs'
+import { execFileSync } from 'node:child_process'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
 // client.mjs 側のハードコード版数。package.json の version と一致していることを
 // diagnostics の version_consistency が見る（2 つの版数源の drift 検出。決定45）
-const MCP_VERSION = '0.3.6'
+const MCP_VERSION = '0.3.8'
 const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
 
 const USAGE = `usage:
@@ -121,10 +122,38 @@ await mcp.connect(new StdioServerTransport())
 // 素性（vendor/model/effort）は launch-seat.sh が env へ入れる。**登録のたびに載せる**——
 // 登録は client の起動ごとに繰り返し起きるので、1回きりの経路に置くと
 // member の状態が失われた時に二度と戻らない（server 側は渡された欄だけ更新する upsert）
+function observeSelf() {
+  if (!process.env.TMUX) {
+    process.stderr.write('peertable-client: observe unavailable: TMUX 不在\n')
+    return null
+  }
+  if (!process.env.TMUX_PANE) {
+    process.stderr.write('peertable-client: observe unavailable: TMUX_PANE 不在\n')
+    return null
+  }
+  const socket = process.env.TMUX.split(',')[0]
+  if (!socket) {
+    process.stderr.write('peertable-client: observe unavailable: TMUX の socket が空\n')
+    return null
+  }
+  try {
+    const target = execFileSync('tmux', ['-S', socket, 'display-message', '-p', '-t', process.env.TMUX_PANE, '#S'], {
+      encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'],
+    }).trim()
+    if (!target) throw new Error('session 名が空')
+    return { tmux_socket: socket, tmux_target: target }
+  } catch (error) {
+    process.stderr.write(`peertable-client: observe unavailable: ${error.message}\n`)
+    return null
+  }
+}
+
+const observe = observeSelf()
 const IDENTITY = Object.fromEntries(Object.entries({
   vendor: process.env.PEERTABLE_VENDOR,
   model: process.env.PEERTABLE_MODEL,
   effort: process.env.PEERTABLE_EFFORT,
+  observe,
 }).filter(([, v]) => v))
 await fetch(api('members'), { method: 'POST', headers, body: JSON.stringify({ name: ME, ...IDENTITY }) })
 {
@@ -144,7 +173,12 @@ async function subscribe() {
         while ((i = buf.indexOf('\n\n')) >= 0) {
           const frame = buf.slice(0, i)
           buf = buf.slice(i + 2)
-          const data = frame.split('\n').filter(l => l.startsWith('data: ')).map(l => l.slice(6)).join('')
+          const lines = frame.split('\n')
+          // 名前付きイベント（ping/member等）はチャット発言ではない。明示的に読み飛ばす——
+          // 現状は relevant() が宛先無しの payload を弾いて偶然安全なだけで、将来のイベント追加が
+          // 席を起こす経路を open のままにしない
+          if (lines.some(l => l.startsWith('event: '))) continue
+          const data = lines.filter(l => l.startsWith('data: ')).map(l => l.slice(6)).join('')
           if (!data) continue
           const m = JSON.parse(data)
           if (!relevant(m)) continue

package/room/server.mjs

@@ -25,12 +25,17 @@ function loadRoom(name, create = false) {
   const dir = join(DATA, name)
   if (create) mkdirSync(dir, { recursive: true })
   const logPath = join(dir, 'log.jsonl')
-  const seq = existsSync(logPath) ? readFileSync(logPath, 'utf8').split('\n').filter(Boolean).length : 0
+  const lines = existsSync(logPath) ? readFileSync(logPath, 'utf8').split('\n').filter(Boolean) : []
+  const seq = lines.length
+  // last_ts は summary 用。末尾行を1回 parse するだけ（既にこの読み出しで行数を数えているので追加I/Oはゼロ）。
+  // 壊れた末尾行で throw すると loadRoom は全エンドポイントの入口なので巻き添えで死ぬ→null に落とす
+  let lastTs = null
+  if (lines.length) { try { lastTs = JSON.parse(lines.at(-1)).ts ?? null } catch { lastTs = null } }
   const membersPath = join(dir, 'members.json')
   // members の値は `{ joined_at, …任意欄 }`。旧形式（値が ISO 文字列）もそのまま読める
   const stored = existsSync(membersPath) ? Object.entries(JSON.parse(readFileSync(membersPath, 'utf8'))) : []
   const members = new Map(stored.map(([n, v]) => [n, typeof v === 'string' ? { joined_at: v } : v]))
-  const room = { name, dir, logPath, membersPath, seq, members, streams: new Set() }
+  const room = { name, dir, logPath, membersPath, seq, last_ts: lastTs, members, streams: new Set() }
   rooms.set(name, room)
   return room
 }
@@ -73,6 +78,15 @@ function normalizeAudience(to, toNames) {
   return { to: null, to_names: names }
 }
 
+// SSE の member イベントで押し込む欄。閲覧者が気づく欄だけに絞る（POST /members 参照）
+const MEMBER_EVENT_FIELDS = ['status', 'busy_since', 'vendor', 'model', 'effort']
+
+// room ログへは書かない・system 発言も出さない稼働状態の push。post() とは別の経路
+function emitMember(room, name, meta) {
+  const chunk = `event: member\ndata: ${JSON.stringify({ name, ...meta })}\n\n`
+  for (const res of room.streams) res.write(chunk)
+}
+
 function post(room, from, to, body, toNames = null) {
   const msg = {
     seq: ++room.seq, ts: new Date().toISOString(), from, body,
@@ -80,6 +94,7 @@ function post(room, from, to, body, toNames = null) {
     ...(toNames ? { to_names: toNames } : {}),
   }
   appendFileSync(room.logPath, JSON.stringify(msg) + '\n')
+  room.last_ts = msg.ts // 正本へ書けてから更新する
   const chunk = `data: ${JSON.stringify(msg)}\n\n`
   for (const res of room.streams) res.write(chunk)
   return msg
@@ -110,6 +125,11 @@ http.createServer(async (req, res) => {
         capabilities: { member_observation_v1: true },
       }, CORS)
 
+    if (req.method === 'GET' && rest === 'summary')
+      return json(res, 200, {
+        schema: 'peertable.summary.v1', room: room.name, seq: room.seq, last_ts: room.last_ts, member_count: room.members.size,
+      }, CORS)
+
     if (req.method === 'GET' && rest === 'events') {
       res.writeHead(200, { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache', Connection: 'keep-alive', ...CORS })
       res.write(`: connected seq=${room.seq}\n\n`)
@@ -142,11 +162,16 @@ http.createServer(async (req, res) => {
       // **渡された欄だけ更新し、渡されなかった欄は既存を保つ**——席の client は `{name}` だけで
       // 登録するので、これが無いと再接続のたびに素性が消える。`joined_at` は最初の登録を保つ。
       const known = room.members.get(name)
-      room.members.set(name, { joined_at: known?.joined_at ?? new Date().toISOString(), ...known, ...meta })
+      const merged = { joined_at: known?.joined_at ?? new Date().toISOString(), ...known, ...meta }
+      room.members.set(name, merged)
       saveMembers(room)
       // **system 発言は本当に新規の時だけ**。欄の更新で「参加した」を流すと、状態を数秒ごとに
       // 送る消費者が卓の全席を起こし続ける（既存メンバーへの再 POST で実測・room [285]）
       if (!known) post(room, 'system', name, `${name} が参加した`)
+      // 閲覧者が気づく欄が変わった時だけ member イベントを流す。status_at（心拍のたび必ず変わる）と
+      // pane_token_hint（作業中に刻み変わる）は対象外——含めると数秒ごとに再描画が走り稼働アニメがちらつく
+      else if (MEMBER_EVENT_FIELDS.some(f => known[f] !== merged[f]))
+        emitMember(room, name, merged)
       return json(res, 200, { ok: true })
     }
     if (req.method === 'DELETE' && seg[2] === 'members' && seg[3]) {
@@ -184,8 +209,8 @@ const FAVICON = `<link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://
 // 発言者ごとの色は名前ハッシュ（--h）から作る。彩度・明度だけテーマで持ち替えれば dark/light 両方が成立する
 const STYLE = `
 *{box-sizing:border-box}
-:root{color-scheme:light dark;--fg:#1a1a1a;--bg:#f7f6f3;--surface:#fff;--line:#e4e2dc;--accent:#1d4ed8;--dim:#8a877f;--sat:55%;--lum:45%;--name:32%;--tint:96%;--edge:82%;--busy:#1f9d55;--idle:#b9b6ae;--dead:#d03b3b}
-@media(prefers-color-scheme:dark){:root{--fg:#e8e6e0;--bg:#141418;--surface:#1e1e24;--line:#2c2c33;--accent:#7aa2ff;--dim:#8b8892;--sat:48%;--lum:56%;--name:75%;--tint:18%;--edge:32%;--busy:#3ecf7e;--idle:#4d4b52;--dead:#ff6b6b}}
+:root{color-scheme:light dark;--fg:#1a1a1a;--bg:#f7f6f3;--surface:#fff;--line:#e4e2dc;--accent:#1d4ed8;--dim:#8a877f;--sat:55%;--lum:45%;--name:32%;--tint:96%;--edge:82%;--busy:#1f9d55;--idle:#b9b6ae;--dead:#d03b3b;--blocked:#d97706}
+@media(prefers-color-scheme:dark){:root{--fg:#e8e6e0;--bg:#141418;--surface:#1e1e24;--line:#2c2c33;--accent:#7aa2ff;--dim:#8b8892;--sat:48%;--lum:56%;--name:75%;--tint:18%;--edge:32%;--busy:#3ecf7e;--idle:#4d4b52;--dead:#ff6b6b;--blocked:#f0a63a}}
 body{margin:0;font-family:ui-sans-serif,system-ui,-apple-system,"Hiragino Kaku Gothic ProN","Noto Sans JP",sans-serif;font-size:14px;line-height:1.65;color:var(--fg);background:var(--bg)}
 a{color:var(--accent)}
 .brand{display:flex;align-items:center;gap:8px;font-size:15px;font-weight:650;letter-spacing:.01em}
@@ -205,6 +230,7 @@ const UI = room => `<!doctype html><html lang="ja"><head><meta charset="utf-8"><
 .chip .st.busy{background:var(--busy)}
 .chip .st.idle{background:var(--idle)}
 .chip .st.dead{background:var(--dead)}
+.chip .st.blocked{background:var(--blocked)}
 .chip .st.unknown{background:transparent;box-shadow:inset 0 0 0 1.5px var(--dim)}
 .metapop{position:fixed;z-index:20;background:var(--surface);border:1px solid var(--line);border-radius:10px;padding:8px 10px;font-size:12px;box-shadow:0 6px 20px rgba(0,0,0,.18);max-width:70vw}
 .metapop .metaname{font-weight:600;margin-bottom:2px}
@@ -217,8 +243,10 @@ const UI = room => `<!doctype html><html lang="ja"><head><meta charset="utf-8"><
 .chip.is-busy .av{animation:seat-working 1.15s ease-in-out infinite;box-shadow:0 0 0 2px color-mix(in srgb,var(--busy) 38%,transparent)}
 .chip.is-busy.pulse .av{animation:seat-working 1.15s ease-in-out infinite,pulse 1.6s ease-out 2}
 .chip.is-busy .st{animation:seat-beat .8s ease-in-out infinite alternate}
+.chip.is-blocked .av{animation:seat-blocked 2.2s ease-in-out infinite}
 @keyframes seat-working{0%,100%{transform:translateY(0) rotate(-2deg)}50%{transform:translateY(-2px) rotate(2deg)}}
 @keyframes seat-beat{from{transform:scale(.78);opacity:.7}to{transform:scale(1.28);opacity:1}}
+@keyframes seat-blocked{0%,100%{opacity:1}50%{opacity:.5}}
 .victory{position:fixed;z-index:30;left:var(--victory-x);top:var(--victory-y);pointer-events:none;color:var(--busy);font-size:13px;font-weight:800;letter-spacing:.03em;text-shadow:0 1px 0 var(--surface);animation:victory-rise 1.45s cubic-bezier(.18,.8,.3,1) both}
 @keyframes victory-rise{0%{opacity:0;transform:translate(-50%,8px) scale(.75)}18%{opacity:1;transform:translate(-50%,-7px) scale(1.08)}72%{opacity:1;transform:translate(-50%,-15px) scale(1)}100%{opacity:0;transform:translate(-50%,-27px) scale(.92)}}
 @keyframes pulse{from{box-shadow:0 0 0 0 hsl(var(--h) var(--sat) var(--lum)/.6)}to{box-shadow:0 0 0 9px hsl(var(--h) var(--sat) var(--lum)/0)}}
@@ -227,7 +255,10 @@ const UI = room => `<!doctype html><html lang="ja"><head><meta charset="utf-8"><
 .msg.flow,.sys.flow{animation:message-flow .36s cubic-bezier(.22,1,.36,1) both}
 @keyframes message-flow{from{opacity:0;transform:translateY(12px)}to{opacity:1;transform:translateY(0)}}
 @media (prefers-reduced-motion:reduce){.msg.flow,.sys.flow{animation:none}}
-@media (prefers-reduced-motion:reduce){.chip.is-busy .av,.chip.is-busy .st,.victory{animation:none}}
+@media (prefers-reduced-motion:reduce){.chip.is-busy .av,.chip.is-busy .st,.chip.is-blocked .av,.victory{animation:none}}
+.bubble.reveal>*{animation:block-in .32s cubic-bezier(.22,1,.36,1) both}
+@keyframes block-in{from{opacity:0;transform:translateY(6px)}to{opacity:1;transform:translateY(0)}}
+@media (prefers-reduced-motion:reduce){.bubble.reveal>*{animation:none}}
 .msg.cont{margin-top:-8px}.msg.cont .av{visibility:hidden;height:0}.msg.cont .meta{display:none}
 .msg .body{min-width:0;max-width:100%}
 .meta{display:flex;align-items:baseline;gap:7px;flex-wrap:wrap;margin:0 0 3px 2px;font-size:12px}
@@ -353,17 +384,19 @@ async function refreshMembers(){
   for(const m of r.members){
     const c=el('span','chip'+(m.name===recent?' recent':''))
     c.style.setProperty('--h',hue(m.name));c.dataset.name=m.name
-    // 素性は任意欄。名乗っていない席は行ごと出ない（空欄を「不明」として見せない）
-    const meta=[m.model&&(m.vendor?m.vendor+' / '+m.model:m.model),m.effort&&('effort '+m.effort)].filter(Boolean)
+    // 素性は任意欄。名乗っていない席は行ごと出ない（空欄を「不明」として見せない）。
+    // vendor/model/effort を1行へ畳む（launch-seat.sh:108 の着席ログと読み口を揃える。effort の語は出さない）
+    const idParts=[m.vendor,m.model,m.effort].filter(Boolean)
+    const meta=[idParts.length?idParts.join(' / '):null].filter(Boolean)
     // 稼働状態は**報告が新しい時だけ**採る。途絶えたら unknown へ落とす——古い状態を出し続けるのが
     // いちばん悪い（動いていない席を「動いている」と見せる）。閾値は bridge の心拍30秒の3倍
     const age=m.status_at?Date.now()-Date.parse(m.status_at):Infinity
     const st=(m.status&&age<STATUS_STALE_MS)?m.status:(m.status?'unknown':null)
     if(st)c.classList.add('is-'+st)
-    if(st)meta.push('状態 '+({busy:'作業中',idle:'待機',dead:'停止',unknown:'不明（報告が途絶えている）'}[st]??st))
+    if(st)meta.push('状態 '+({busy:'作業中',idle:'待機',dead:'停止',blocked:'承認待ち',unknown:'不明(報告が途絶えている)'}[st]??st))
     const usage=[]
     const busyAge=m.busy_since?Date.now()-Date.parse(m.busy_since):NaN
-    if(st==='busy'&&Number.isFinite(busyAge)&&busyAge>=0)usage.push('継続 '+elapsed(busyAge))
+    if((st==='busy'||st==='blocked')&&Number.isFinite(busyAge)&&busyAge>=0)usage.push('継続 '+elapsed(busyAge))
     if(Number.isSafeInteger(m.pane_token_hint)&&m.pane_token_hint>=0)usage.push(compactCount(m.pane_token_hint)+' tokens')
     if(usage.length)meta.push('消費目安 '+usage.join(' / ')+'（pane観測）')
     c.title=m.name+'（参加 '+new Date(m.joined_at).toLocaleString()+'）'+(meta.length?'\\n'+meta.join('\\n'):'')
@@ -418,14 +451,19 @@ function celebrate(name){
 }
 const BEAT=${HEARTBEAT_MS}
 const STATUS_STALE_MS=90000 // 稼働状態の鮮度。これを過ぎた報告は unknown（bridge 心拍30秒の3倍）
-let lastSeq=0,lastBeat=Date.now(),es=null,emptyEl=null,firstLoad=true,catching=false
+let lastSeq=0,lastBeat=Date.now(),es=null,emptyEl=null,firstLoad=true,catching=false,memberDebounce=null
 // seq で二重描画を弾く。張り直し後の追いつきと SSE の新着が重なっても同じ発言は1回しか出ない
 function apply(m,live=false){
   if(m.seq<=lastSeq)return false
   lastSeq=m.seq
   if(emptyEl){emptyEl.remove();emptyEl=null}
   const row=render(m)
-  if(live)row.classList.add('flow')
+  if(live){
+    row.classList.add('flow')
+    // ライブ新着だけ、バブル内の各ブロックへ順に出現アニメを当てる。実際の生成とは同期しない単なる演出
+    const bub=row.querySelector('.bubble')
+    if(bub){bub.classList.add('reveal');[...bub.children].forEach((c,i)=>{c.style.animationDelay=(Math.min(i,8)*90)+'ms'})}
+  }
   if(m.from!=='system')recent=m.from
   return true
 }
@@ -451,6 +489,8 @@ function connect(){
   // 心拍は room の最新 seq を積んでくる。繋がったまま取りこぼした（＝途絶しないので watchdog が気づけない）
   // 場合は、この差分だけが手掛かりになる
   es.addEventListener('ping',e=>{lastBeat=Date.now();if(Number(e.data)>lastSeq)catchUp()})
+  // 稼働状態・素性の変化。既存の refreshMembers() を150msデバウンスで呼ぶ（部分更新は実装しない）
+  es.addEventListener('member',()=>{clearTimeout(memberDebounce);memberDebounce=setTimeout(refreshMembers,150)})
   es.onmessage=e=>{
     lastBeat=Date.now()
     const m=JSON.parse(e.data),stick=nearBottom()

package/skill/SKILL.md

@@ -29,7 +29,7 @@ description: 任意プロジェクトに Peertable チーム（対等メンバ
 
 手順は **聞き取り → script → 着任指示** の3段である。scripts が機械部分を全部持つので、AI が手で tmux を組み立てることはしない。
 
-1. **聞き取り**: 対象プロジェクトのパス / **工程正本（`Lattice 併用`＝既定 / `単独`）** / メンバー数とモデル・effort（モデル既定: Sonnet、effort既定: CLI 既定。モデル選定は作業の性質——設計か確定実装か——を軸にする。決定49）/ 初期タスク群（何を作るか）/ room 名（既定: プロジェクトのディレクトリ名）/ **公開URL基底**（Lattice 併用のみ。外部ペインに書く URL。クオ環境は `https://peertable.kitepon.dev`。未指定なら room サーバーの URL がそのまま入る＝LAN URL は Lattice を外から見た時に開けない）
+1. **聞き取り**: 対象プロジェクトのパス / **工程正本（`Lattice 併用`＝既定 / `単独`）** / メンバー数とモデル・effort（モデル既定: Sonnet。**effort は既定値を置かない——席ごとに必ず決める**。`launch-seat.sh` の effort は必須引数で、未指定は着席前に非ゼロ終了する。モデル選定は作業の性質——設計か確定実装か——を軸にする。決定49）/ 初期タスク群（何を作るか）/ 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 が無いので既定の根拠も無く、聞き取りで決める
    - **運用中の席数の標準は「ready＋activeな実装ToDo数」（決定68）**: 起動時の幅は計画値、この式は生きた実測値で、campaignが進めば自然に縮む。標準を上回った席は親が縮退する。監査・受入は実装席が兼ねる（決定67）ので監査要員を席数に数えない。claimできるToDoが無い席は仕事を発明せず（依頼されていない監査・照会・自主レビュー禁止）、待機宣言して黙るか親に畳まれる
    - **モードの選び分け**: タスク間に依存があり並列境界の機械保証が要るなら Lattice 併用。依存の無い小規模作業で、対象プロジェクトに Lattice を持ち込みたくないなら単独。単独で失うのは task 間スケジューリングの機械保証だけで、円卓の核（room・憲章・宣言による協力）は変わらない（決定47）
@@ -41,22 +41,25 @@ description: 任意プロジェクトに Peertable チーム（対等メンバ
 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. **メンバー起動**: メンバーごとに `scripts/launch-seat.sh <project> <name> <model> [claude|codex] [effort] [着任指示]` を実行する。tmux 作成（aiterm と同じソケットなので、立った席はそのまま `pty_read`/`pty_send` で読める）→ env 注入 → 起動 → 既知ダイアログ通過 → 着席確認まで1回で行き、着席しなければ最後の画面を出して非ゼロで落ちる（黙って進まない）
+5. **メンバー起動**: メンバーごとに `scripts/launch-seat.sh <project> <name> <model> <claude|codex> <effort> [着任指示]` を実行する。**vendor・effort とも必須引数**（未指定は usage を出して非ゼロ終了。既定値をコードへ埋めない——席を立てる時に決める）。tmux 作成（aiterm と同じソケットなので、立った席はそのまま `pty_read`/`pty_send` で読める）→ env 注入 → 起動 → 既知ダイアログ通過 → 着席確認まで1回で行き、着席しなければ最後の画面を出して非ゼロで落ちる（黙って進まない）
    - 起動前に `pty_list` で既存の `peer-*` 席を確認する（前の卓の残骸を99席実測したことがある）。同名の席は launch-seat.sh が落としてから立て直す
    - 着任指示を第6引数に渡すと着席後に送る。文面: 「あなたは「<日本語名>」。.team/roles/member.md を読んで着任し、作業ループを開始せよ。全タスク完了の宣言まで自律的に続けること。」
    - 席が読む env は script が組み立てる（`PEERTABLE_URL` / `PEERTABLE_ROOM` / `PEERTABLE_MEMBER` / `PEERTABLE_POST_TOKEN`、Lattice 併用なら `PEERTABLE_PLAN` と actor 3点）。**channels は `--mcp-config` の MCP server を解決しない**（実測 2026-08-08・Claude Code v2.1.226・決定44）ため、room の MCP 定義は setup.sh が project root へ置く `.mcp.json` が正。project に既存 `.mcp.json` があった場合 setup.sh は上書きせず警告を出すので、AI が手動 merge して teardown で復元する
    - **Codex 席**（`vendor=codex`）: Codex には channels が無いので、room は `-c` 上書きの stdio MCP として差す（`mcp_servers.room.command="peertable-client"` と `mcp_servers.room.env={…}`）。**env は closed mode で親環境を継がない**ので `PATH` を含む全変数を明示列挙する。effortはmember metadataだけでなく`model_reasoning_effort`へも同じ値を渡す。モデル名は ChatGPT アカウントで使える slug を渡す（`~/.codex/config.toml` の `model` が既定値の参考。使えない slug は起動後の最初のターンで 400 になって初めて分かる）。Codex 席を混ぜたら**必ず起床ブリッジを立てる**（下記）——立てないと room の新着で起きない
-6. **起床ブリッジ（Codex 席がある時だけ）**: `nohup node scripts/wakeup-bridge.mjs <project> <codex席名>… > <project>/.team/wakeup-bridge.log 2>&1 &`。room の SSE を購読し、明示的にその席宛の新着（自分の発言は除く）だけを tmux へ素送信して起こす。**Codex はターン実行中でも素送信を受け付け、その文言をそのターンの中で読む**（実測）ので idle 待ちはしない。停止は `node scripts/wakeup-bridge.mjs <project> --stop`（teardown.sh が自動で行う）
+6. **起床ブリッジ（Codex 席がある時だけ）**: `scripts/ensure-bridge.sh <project> wakeup <codex席名>…`。room の SSE を購読し、明示的にその席宛の新着（自分の発言は除く）だけを tmux へ素送信して起こす。ensure は専用 tmux session で起動し、bridge の `ready_at` を待つ。確認できなければログ末尾を出して非ゼロで終わる。**Codex はターン実行中でも素送信を受け付け、その文言をそのターンの中で読む**（実測）ので idle 待ちはしない。停止は `node scripts/wakeup-bridge.mjs <project> --stop`（teardown.sh が自動で行う）
    - **黙って止まらないための三段**（決定58 の受信側の作法）: ①75秒なにも届かなければ自分から切って繋ぎ直す ②繋ぎ直したら `?since=<最終seq>` で切れていた間の発言を回収する ③**心拍が積んでくる room の最新 seq が自分より進んでいたら、繋がったままでも回収する**——③が要るのは、心拍が届き続ける限り①が原理的に発火しないため。**server 側の心拍（`event: ping`・25秒周期）が前提**なので、古い room サーバーへ繋ぐと①だけが効く形になる
    - ログは `.team/wakeup-bridge.log`。**0件でも0件と出す**ので、起こせているか・取りこぼしていないかはログを見れば分かる。再現ハーネスは `experiments/bridge-catchup-repro.mjs`
 
-6.5 **席の稼働状態ブリッジ（任意）**: `nohup node scripts/seat-status-bridge.mjs <project> > <project>/.team/seat-status-bridge.log 2>&1 &`。**room の members に居る席だけ**の tmux pane を読み（`peer-<名前>`）、`busy`（画面に `esc to interrupt` が在る。**Claude 席・Codex 席の共通マーカーで、スピナーの語は毎回変わるので使わない**）／`idle`／`dead`（`pane_dead`・セッション消失）を判定して room サーバーへ送る。**AI は使わず、席へは1バイトも送らない**。参加者一覧に点が出て、**報告が途絶えたら `unknown`（中空の輪）へ落ちる**——古い状態を出し続けない。**server が稼働状態を保持しない版なら1件も送らない**（送ると保存されないうえに system 発言を撒く）。停止は `node scripts/seat-status-bridge.mjs <project> --stop`（**teardown.sh が自動で行う**）
-   - **起こすかは卓の任意**（setup は自動で起こさない）。起こしたら**必ず teardown で止まる**——止め忘れると、`.team/` と一緒に pid 記録が消えて **`--stop` でも止められない常駐**が残る
+6.5 **席の稼働状態ブリッジ（setup.sh が自動で起こす）**: 手順3の scaffold が `ensure-bridge.sh <project> seat-status` で起こすので、**AI が手で叩く段は無い**。観測先は member の `observe: {tmux_socket, tmux_target}` を優先し、無い既存memberだけ `peer-<名前>` へ後方互換で落とす。socket は明示env → aiterm POSIX既定 → 検証済み`/tmp/aiterm-*.sock`1本 → 既定パスの順で解決し、bashからは`tmux-socket.mjs`を呼ぶ。既に立っている席はclient再起動まで`observe`を自己申告しないため、`peer-`以外の席で記述子が要る時は席かclientを再起動する。WSLではbridgeが読む**WSL側**の版が正で、Windows側だけの更新では直らない。
+   - **setup が起こし、teardown が止める（対称）。** 2026-08-10 までは「起こすかは卓の任意」で手で `nohup` する設計だったが、それが2つの失敗を招いたので変えた: 起こし忘れと、**トークンを持たないシェルで起こすこと**。後者は実害が出た——`~/.config/peertable.env` の `export` 欠落により、`source` した shell から起こした常駐がトークンを持たず、**4時間 HTTP 403 を撃ち続けた**。参加者一覧には点が1つも出ず、**「起こしていない」と見分けがつかなかった**
+   - **書込トークンは起こす側の env に依存しない。** ブリッジ自身が `launch-seat.sh:25-27` と同じ規則で解決する（env が先・無ければ `~/.config/peertable.env` を読む。`export` の有無を問わない）。同じ規則を `run-bridge.mjs` も使う
+   - **書けない常駐は生まれない。** 一度も書けていないまま送信が全件失敗したら `SEAT_STATUS_BRIDGE_WRITE_DENIED` で常駐に入らず死ぬ。一度書けた後の連続失敗は10回で `SEAT_STATUS_BRIDGE_UNREACHABLE`（wakeup-bridge と同じ本数・決定54）。**席がまだ立っていない tick は失敗に数えない**ので、setup 直後に起こしても死なない
+   - 止め忘れると `.team/` と一緒に pid 記録が消えて **`--stop` でも止められない常駐**が残る（teardown が自動で止めるので通常経路では起きない）
 
 6.7 **effort変更（本人要請→親実行）**: 本人は親だけへ`[effort変更依頼] <level>`を明示DMする。親は席がidleなのを確認して`skill/scripts/change-effort.sh <project> <member> <level> [parent_name]`を実行する。scriptは未使用の本人DMを機械確認し、room membersのvendor/modelを保って席を再起動し、metadataを読み返してから本人宛へ変更履歴を残す。同じ依頼の再利用、busy席、Claudeの未知level、Codex model catalogに無いlevelは再起動前にtyped拒否する。新設定での起動失敗時は旧effortで1回だけ明示rollbackし、両方失敗なら手動復旧が必要だと非0で出す。
    - **会話contextは引き継がない**。本人は作業を安全に中断できる時だけ依頼し、再起動後はrole・工程正本・roomログから再着任する。変更できたのに履歴記録だけ失敗した場合も成功へ丸めず、`EFFORT_CHANGE_CHANGED_BUT_HISTORY_FAILED`で現在状態を明示する
 
-7. **親の着卓**（このセッション）: `scripts/parent-join.sh <project> [name] [model] [effort]` で member 登録を行い、**bell宛DM番犬**を Monitor で張る（形は下記「親の operating notes」の番犬仕様）。broadcastのkickoffは廃止済み。以後の post も API 直（同 notes）
+7. **親の着卓**（このセッション）: `scripts/parent-join.sh <project> [name] [model] [effort]` で member 登録を行う。**`effort` は任意のまま据え置く**——席は `launch-seat.sh` が `--effort` で実際に設定するので「渡した値＝実挙動」だが、親は既に走っているセッションで自分の effort を機械的に知る経路が無く、推測して載せると画面が嘘をつく。**bell宛DM番犬**を Monitor で張る（形は下記「親の operating notes」の番犬仕様）。broadcastのkickoffは廃止済み。以後の post も API 直（同 notes）
 8. **起動確認**: room の members に全員いる / 最初の claim が room に流れる（Lattice 併用モードはそれが Lattice へ到達している＝`lattice todo status --json` の active に出ることも確認する。単独モードは room の claim 宣言だけが到達の証拠）/ Web UI で観測できる、をチェックして報告する
 
 ## teardown
@@ -95,7 +98,7 @@ description: 任意プロジェクトに Peertable チーム（対等メンバ
 - **席の作法の正本は `templates/member.md` の「Lattice の実行層へ自分の着手を載せる」節**（intake→intervention 判定→attach→作業→`todo done`→accept の順・1席1 intake・禁止操作・検証の回し方・成果の正本）。ここに二重化しない
 - **席は自分の pid を装置へ渡す（attach）。** その pid は `.team/seats/<名前>.json`（`launch-seat.sh` が着席直後に書く）が持ち、席は読んで `schema` を足すだけで attach input になる。**raw argv を保存しない**——Codex 起動の argv には `PEERTABLE_POST_TOKEN` が載るので、保存すれば秘密の複製になる（2026-08-09 実測）。持つのは digest だけ
 - **run-bridge は可視化の中継であって、必須経路ではない**（決定63）。落ちていても席は自分で intake / attach / accept を打てるし、介入も `lattice run intake intervention --run <ref> --task <id>` で自分で読める。**見えなくなるだけ**である
-- **ブリッジの起動**: `PEERTABLE_POST_TOKEN=… nohup node scripts/run-bridge.mjs <project> [--lattice <path>] > <project>/.team/run-bridge.log 2>&1 &`。停止は `node scripts/run-bridge.mjs <project> --stop`（**teardown.sh が自動で行う**）。**spool dir も席名も取らない**（配車をしないので要らない。渡すと typed error で落ちる）。ADR 0157 の作法（pid 記録・起動時に前の記録を掃除・SIGTERM→SIGKILL）はそのまま
+- **ブリッジの起動**: `scripts/ensure-bridge.sh <project> run [--lattice <path>]`。停止は `node scripts/run-bridge.mjs <project> --stop`（**teardown.sh が自動で行う**）。**spool dir も席名も取らない**（配車をしないので要らない。渡すと typed error で落ちる）。ADR 0157 の作法（pid 記録・起動時に前の記録を掃除・SIGTERM→SIGKILL）はそのまま
   - `--lattice <path>` は release 前の source tree を実測する時に使う。**PATH の install は version 表示が同じでも未 publish の schema を読めない**（2026-08-09 に卓で3件実測）
   - bridge が返すのは2つだけで**どちらも読み取り**: `[run] <run-id> intake=[…] accepted=[…] hold=[…] closed=…`（変化時だけ）と、`hold` になった intake をその作業を始めた席宛へ返す `[介入]`
 
@@ -170,7 +173,8 @@ witness をどう生成するかは**対象 project 側の作法に従う**（La
   - **再着卓の契機は Monitor stream の終了通知**（2026-08-08 実測。1日に2回——引き継ぎ時と障害復旧後）。親の側には「途絶した」と教えてくれるものが他に無いので、**Monitor が終わったら再着卓の手順に入る**と決めておく
   - **順序の要点は「room と工程正本を読み終えるまで発言しない」**。読む前に喋ると、自分が行き違いを作る側になる（実例あり）
   - **やらないこと**: 復帰の挨拶で席を起こさない。作業の再確認を席へ聞いて回らない——**現在地は上の1〜2で取れる**ので、聞くのは席の時間を奪うだけである
-- **宛先の規律**: postはメンバー名または必要なメンバー名の配列だけを受理し、broadcast shortcutはtyped拒否する。channels/起床ブリッジが起こすのも明示宛先だけ。roomログは宛先に関係なく全員がpullで読める（決定42）ので、宛先は秘匿ではなく「今起こす必要がある相手」を表す
+- **宛先の規律**: postはメンバー名または必要なメンバー名の配列だけを受理し、broadcast shortcutはtyped拒否する。channels/起床ブリッジが起こすのも明示宛先だけ。roomログは宛先に関係なく全員がpullで読める（§16）ので、宛先は秘匿ではなく「今起こす必要がある相手」を表す
+- **親（bell）宛DMを受理してよいのは決定71の3種だけ**: ①done報告・監査受理要請、②オーナー承認gateに関わる物件、③親・オーナーにしか解けないblocker・裁定依頼（`[effort変更依頼]`はこれに該当）。進捗・調整・意見・待機宣言のDMが届いても、それはroomへ流すべき内容だったというだけで、親は実務へ落とさない（発言規律・決定43はそのまま）。同じ基準は席同士のDMにも及ぶ——**同報・返答不要の情報共有目的の複数宛先は禁止**で、判断基準は「この宛先は受け取って何をする？」に答えられるかである
 - **発言規律（決定43・正典 §3.4）**: 親の room 発言は ①監査結果の事実（受理／異議。「次はこうせよ」を続けない）②承認 gate の状態 ③オーナー裁定の伝達（必ず「オーナー裁定」と明示）の3種だけ。メンバー間合意の再掲・とりまとめ・次タスクの指名・frontier の解説は、内容が正しくても**しない**——親が言い直した瞬間に出典が親へ書き換わり、卓が上下オーケストレーションへ滑る（初回実運用で実測）。裁定依頼が来たら自分で判断せず、オーナー宛の議題として運ぶ
 - 督促の検出源は room の報告途絶と Lattice 工程表の乖離。**単独円卓モードでは工程表が無いので、検出源は `.team/tasks.md` の議題と room ログの照合だけになる**——完走の判定も同じで、全議題に完了報告が揃ったことを親が room ログで確認し、散会を宣言する（この確認と宣言が単独モードの done gate である）
 - **席の縮退も親の進行権能**（散会と同じ性質。決定51）: frontier が細って遊休席が出たら親が畳む。順序を守る——①対象席へ名指しで通告 ②本人に WIP と未報告の作業が無いことを確認する（本人が「まだ持っている」と言えば畳まない。判断は情報を持つ本人がする）③`pty_close` でセッションを終了 ④`curl -X DELETE $URL/api/$ROOM/members/<名前> -H "X-Peertable-Token: $TOKEN"` ⑤縮退をroomログへ記録し、直後に対応が必要な席だけを宛先にする。**先に member を消すと本人が最後の報告を出せない**

package/skill/scripts/archive-room-log.py

@@ -3,7 +3,7 @@
 
 usage:
   archive-room-log.py <server_url> <room> <out.md>   ログを書き出す
-  archive-room-log.py --members <server_url> <room>  member 名を空白区切りで出す（席を畳む相手）
+  archive-room-log.py --members [--json] <server_url> <room>  member を出す（席を畳む相手）
 
 本文は投稿時の Markdown をそのまま置く（引用ブロックで包むと表とコードが崩れる）。
 本文の無い発言（過去に本文なし POST が着地した分）は、欠落と分かる形で残す——
@@ -21,9 +21,13 @@ def fetch(url, path):
 
 def main(argv):
     if argv[:1] == ["--members"]:
-        url, room = argv[1], argv[2]
+        as_json = argv[1:2] == ["--json"]
+        url, room = argv[2:4] if as_json else argv[1:3]
         members = fetch(url, f"/api/{room}/members")["members"]
-        print(" ".join(m["name"] for m in members))
+        if as_json:
+            print(json.dumps([{"name": m["name"], "observe": m.get("observe")} for m in members]))
+        else:
+            print(" ".join(m["name"] for m in members))
         return 0
 
     url, room, out = argv[0], argv[1], argv[2]

package/skill/scripts/ensure-bridge.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+# bridge を tmux に常駐させ、最初の ready_at まで待つ薄い supervisor。
+set -euo pipefail
+
+proj="$1"; name="$2"; shift 2
+case "$name" in seat-status) script="seat-status-bridge.mjs" ;; wakeup) script="wakeup-bridge.mjs" ;; run) script="run-bridge.mjs" ;; *) echo "usage: ensure-bridge.sh <project> <seat-status|wakeup|run> [args...]" >&2; exit 1 ;; esac
+team="$proj/.team"; record="$team/$name-bridge.json"; log="$team/$name-bridge.log"
+force=false
+if [ "${1:-}" = "--force" ]; then force=true; shift; fi
+if [ $# -eq 0 ] && [ -f "$record" ]; then
+  saved=()
+  while IFS= read -r arg; do saved+=("$arg"); done < <(node -e 'const x=require(process.argv[1]); for (const a of x.args||[]) console.log(a)' "$record")
+  set -- "${saved[@]}"
+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 ! "$force" && grep -q 'WRITE_DENIED' "$log" 2>/dev/null; then echo "${name}-bridge: 前回はWRITE_DENIEDで終了。--forceを指定すること" >&2; exit 1; fi
+fi
+sock=$(node "$(dirname "$0")/tmux-socket.mjs")
+room=$(node -e 'process.stdout.write(require(process.argv[1]).room)' "$team/setup-state.json")
+session="peertable-${name}-${room}"
+# **死んだ記録をここで消す。** 残すと下の loop が前回の `ready_at` を読んで、
+# 新しい bridge が1バイトも動いていない段階で success を返す——「起動していないのに
+# 起動したと言う」＝この supervisor が塞ぐはずの穴そのものになる。
+rm -f "$record"
+: > "$log"
+# **手渡された env を常駐へ渡す。** 新しい session が継ぐのは tmux *server* の環境であって
+# 呼び出し元 client の環境ではないので、素で起こすと `PEERTABLE_TMUX_SOCKET` の手渡しが黙って消え、
+# 常駐が別の socket（本番の既定）を観測しにいく（2026-08-11 実測）。決定73 と同じ形の裏返しである。
+env_prefix=""
+for v in PEERTABLE_TMUX_SOCKET PEERTABLE_POST_TOKEN PEERTABLE_URL; do
+  eval "val=\${$v:-}"
+  [ -n "$val" ] && env_prefix="$env_prefix $v=$(printf '%q' "$val")"
+done
+# **session が在るだけでは常駐が生きている証拠にならない**（中の node だけ死んで殻が残る）。
+# 上で pid 生存を確かめて here まで来た＝生きていないので、殻は畳んでから立て直す。
+tmux -S "$sock" kill-session -t "$session" 2>/dev/null || true
+tmux -S "$sock" new-session -d -s "$session" "env${env_prefix} node $(dirname "$0")/$script $(printf '%q ' "$proj" "$@") >> $(printf '%q' "$log") 2>&1"
+for _ in $(seq 1 30); do
+  if [ -f "$record" ] && node -e 'process.exit(require(process.argv[1]).ready_at?0:1)' "$record"; then
+    # **末尾は本物の改行にする。** `"\\n"` と書くと JS がリテラルの `\`+`n` を足し、
+    # record が JSON として壊れる——`--stop` も次回起動も `JSON.parse` で落ちて、
+    # 「止められない・建て直せない常駐」ができる（2026-08-11 実測）。一時 file→rename で原子的に。
+    node -e 'const fs=require("fs");const p=process.argv[1],a=process.argv.slice(2);
+      const t=`${p}.${process.pid}.tmp`;
+      fs.writeFileSync(t,JSON.stringify({...JSON.parse(fs.readFileSync(p,"utf8")),args:a})+"\n");
+      fs.renameSync(t,p)' "$record" "$@"
+    exit 0
+  fi
+  sleep .5
+done
+echo "${name}-bridge: ready_at を待てなかった。ログ末尾:" >&2
+tail -n 20 "$log" >&2 || true
+exit 1