npm - peertable - Versions diffs - 0.2.1 → 0.3.0 - Mend

peertable 0.2.1 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/package.json +1 -1
package/room/client.mjs +5 -0
package/room/server.mjs +161 -28
package/skill/SKILL.md +31 -14
package/skill/scripts/external-pane.mjs +36 -0
package/skill/scripts/launch-seat.sh +100 -0
package/skill/scripts/make-plan-input.mjs +101 -0
package/skill/scripts/parent-join.sh +41 -0
package/skill/scripts/setup.sh +15 -2
package/skill/scripts/teardown.sh +16 -0
package/skill/scripts/wakeup-bridge.mjs +213 -0
package/skill/templates/done.sh +4 -2
package/skill/templates/member-standalone.md +2 -1
package/skill/templates/member.md +3 -2

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "peertable",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "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 CHANGED Viewed

@@ -209,6 +209,11 @@ async function runDiagnostics(asJson) {
       'SKILL.md',
       'scripts/setup.sh',
       'scripts/teardown.sh',
+      'scripts/external-pane.mjs',
+      'scripts/launch-seat.sh',
+      'scripts/make-plan-input.mjs',
+      'scripts/parent-join.sh',
+      'scripts/wakeup-bridge.mjs',
       'templates/gen-plan.mjs',
       'templates/done.sh',
       'templates/charter.md',

package/room/server.mjs CHANGED Viewed

@@ -8,6 +8,7 @@ import { join } from 'node:path'
 const PORT = Number(process.env.PEERTABLE_PORT ?? 8790)
 const DATA = process.env.PEERTABLE_DATA ?? './peertable-data'
 const TOKEN = process.env.PEERTABLE_POST_TOKEN ?? null // 設定時のみ書込に要求（公開設置用）
+const HEARTBEAT_MS = 25000 // SSE 心拍。中間の proxy が落とす前・client の見張りが切る前の間隔
 mkdirSync(DATA, { recursive: true })
@@ -50,7 +51,11 @@ function post(room, from, to, body) {
   return msg
 }
-const json = (res, code, obj) => { res.writeHead(code, { 'Content-Type': 'application/json' }); res.end(JSON.stringify(obj)) }
+// 読み取り系だけ越境許可（Lattice 工程表ページからの probe fetch 用）。書込系には付けず OPTIONS も持たないので、
+// ブラウザからの越境書込は成立しない＝読み取り専用の公開面（決定42）は変わらない
+const CORS = { 'Access-Control-Allow-Origin': '*' }
+const json = (res, code, obj, headers) => { res.writeHead(code, { 'Content-Type': 'application/json', ...headers }); res.end(JSON.stringify(obj)) }
 const readBody = req => new Promise(r => { let b = ''; req.on('data', c => (b += c)); req.on('end', () => r(b)) })
 http.createServer(async (req, res) => {
@@ -63,16 +68,19 @@ http.createServer(async (req, res) => {
     const rest = seg.slice(2).join('/')
     if (req.method === 'GET' && rest === 'messages')
-      return json(res, 200, { messages: readMessages(room, Number(url.searchParams.get('since') ?? 0)) })
+      return json(res, 200, { messages: readMessages(room, Number(url.searchParams.get('since') ?? 0)) }, CORS)
     if (req.method === 'GET' && rest === 'members')
-      return json(res, 200, { members: [...room.members].map(([name, joined_at]) => ({ name, joined_at })) })
+      return json(res, 200, { members: [...room.members].map(([name, joined_at]) => ({ name, joined_at })) }, CORS)
     if (req.method === 'GET' && rest === 'events') {
-      res.writeHead(200, { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache', Connection: 'keep-alive' })
+      res.writeHead(200, { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache', Connection: 'keep-alive', ...CORS })
       res.write(`: connected seq=${room.seq}\n\n`)
       room.streams.add(res)
-      req.on('close', () => room.streams.delete(res))
+      // 心拍。TCP が半開きで死ぬと onerror も発火しないので、client が「途絶」を検知できる signal を送り続ける。
+      // コメント行では EventSource から見えないため、名前付き event にする
+      const beat = setInterval(() => res.write(`event: ping\ndata: ${room.seq}\n\n`), HEARTBEAT_MS)
+      req.on('close', () => { clearInterval(beat); room.streams.delete(res) })
       return
     }
@@ -107,7 +115,7 @@ http.createServer(async (req, res) => {
   if (req.method === 'GET' && seg.length === 0) {
     const list = readdirSync(DATA, { withFileTypes: true }).filter(d => d.isDirectory()).map(d => d.name)
     res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' })
-    return res.end(`<!doctype html><meta charset="utf-8"><title>Peertable</title><body style="font-family:sans-serif;max-width:640px;margin:40px auto"><h1>Peertable</h1><p>A round table of peer agents.</p><ul>${list.map(r => `<li><a href="/${r}">${r}</a></li>`).join('') || '<li>(no rooms yet)</li>'}</ul>`)
+    return res.end(INDEX(list))
   }
   if (req.method === 'GET' && seg.length === 1) {
     res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' })
@@ -116,28 +124,153 @@ http.createServer(async (req, res) => {
   json(res, 404, { error: 'not_found' })
 }).listen(PORT, () => console.error(`peertable room server on :${PORT} (data: ${DATA})`))
-const UI = room => `<!doctype html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
-<title>${room} · Peertable</title><style>
-  :root{--fg:#1a1a1a;--bg:#fafaf8;--line:#e4e2dc;--accent:#1d4ed8;--dim:#8a877f}
-  @media(prefers-color-scheme:dark){:root{--fg:#e8e6e0;--bg:#16161a;--line:#2c2c33;--accent:#7aa2ff;--dim:#77747c}}
-  body{font-family:ui-sans-serif,system-ui,sans-serif;color:var(--fg);background:var(--bg);max-width:760px;margin:0 auto;padding:24px 16px}
-  h1{font-size:18px;margin:0 0 4px}h1 small{color:var(--dim);font-weight:normal}
-  #members{color:var(--dim);font-size:13px;margin-bottom:16px}
-  #log{border-top:1px solid var(--line)}
-  .m{padding:8px 0;border-bottom:1px solid var(--line);font-size:14px;line-height:1.6}
-  .m .h{color:var(--dim);font-size:12px}.m .h b{color:var(--accent);font-weight:600}
-  .m.dm .h::after{content:" · DM";color:var(--dim)}
-  .m.system{color:var(--dim);font-style:italic}
+// HTML へ差し込む値は room 名などブラウザ由来なので、表示は esc・URL は encodeURIComponent・JS は JSON.stringify で渡す
+const esc = s => String(s).replace(/[&<>"]/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]))
+// ブランド: 卓（円）を囲む4人（点）。header の印と favicon で同じ形を使う
+const MARK = `<svg class="mark" width="17" height="17" viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="4.6" fill="none" stroke="currentColor" stroke-width="2"/><circle cx="12" cy="3" r="2" fill="currentColor"/><circle cx="21" cy="12" r="2" fill="currentColor"/><circle cx="12" cy="21" r="2" fill="currentColor"/><circle cx="3" cy="12" r="2" fill="currentColor"/></svg>`
+const FAVICON = `<link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Ccircle cx='12' cy='12' r='4.6' fill='none' stroke='%231d4ed8' stroke-width='2'/%3E%3Ccircle cx='12' cy='3' r='2' fill='%231d4ed8'/%3E%3Ccircle cx='21' cy='12' r='2' fill='%231d4ed8'/%3E%3Ccircle cx='12' cy='21' r='2' fill='%231d4ed8'/%3E%3Ccircle cx='3' cy='12' r='2' fill='%231d4ed8'/%3E%3C/svg%3E">`
+// 発言者ごとの色は名前ハッシュ（--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%}
+@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%}}
+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}
+.brand .mark{color:var(--accent);flex:none}
+.brand small{color:var(--dim);font-weight:400}
+.av{flex:none;display:grid;place-items:center;width:30px;height:30px;border-radius:50%;background:hsl(var(--h) var(--sat) var(--lum));color:#fff;font-size:13px;font-weight:700;line-height:1}
+.empty{color:var(--dim)}`
+const UI = room => `<!doctype html><html lang="ja"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>${esc(room)} · Peertable</title>${FAVICON}<style>${STYLE}
+.top{position:sticky;top:0;z-index:2;background:var(--bg);border-bottom:1px solid var(--line);padding:12px 16px 0}
+.top>div{max-width:760px;margin:0 auto}
+.members{display:flex;gap:6px;overflow-x:auto;padding:10px 0;scrollbar-width:thin}
+.chip{flex:none;display:flex;align-items:center;gap:7px;padding:3px 11px 3px 3px;border:1px solid var(--line);border-radius:999px;background:var(--surface);font-size:12px;font-weight:600}
+.chip .av{width:22px;height:22px;font-size:11px}
+.chip.recent{border-color:hsl(var(--h) var(--sat) var(--edge))}
+.chip.recent .nm{color:hsl(var(--h) var(--sat) var(--name))}
+.chip.pulse .av{animation:pulse 1.6s ease-out 2}
+@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)}}
+.log{max-width:760px;margin:0 auto;padding:14px 16px 40px;display:flex;flex-direction:column;gap:10px}
+.msg{display:flex;gap:9px;align-items:flex-start}
+.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}
+.who{font-weight:700;color:hsl(var(--h) var(--sat) var(--name))}
+.to{color:var(--dim)}.ts{color:var(--dim);font-variant-numeric:tabular-nums}
+.bubble{padding:8px 12px;border-radius:4px 13px 13px 13px;background:hsl(var(--h) var(--sat) var(--tint));border:1px solid hsl(var(--h) var(--sat) var(--edge)/.45);white-space:pre-wrap;overflow-wrap:anywhere}
+.msg.cont .bubble{border-radius:13px}
+.msg.dm .bubble{border-style:dashed;border-color:hsl(var(--h) var(--sat) var(--edge))}
+.msg.dm .to{color:hsl(var(--h) var(--sat) var(--name));font-weight:600}
+.sys{display:flex;justify-content:center;align-items:baseline;gap:8px;color:var(--dim);font-size:12px;padding:2px 0}
+.sys .body{padding:2px 12px;border-radius:999px;background:var(--surface);border:1px solid var(--line)}
 </style></head><body>
-<h1>${room} <small>· Peertable</small></h1><div id="members"></div><div id="log"></div>
+<header class="top"><div class="brand">${MARK}${esc(room)} <small>· Peertable</small></div><div class="members" id="members"></div></header>
+<main class="log" id="log"></main>
 <script>
-const log=document.getElementById('log'),membersEl=document.getElementById('members')
-const render=m=>{const d=document.createElement('div');d.className='m'+(m.to!=='all'?' dm':'')+(m.from==='system'?' system':'')
-  d.innerHTML='<div class="h"><b></b> → '+m.to+' · '+new Date(m.ts).toLocaleTimeString()+'</div><div class="b"></div>'
-  d.querySelector('b').textContent=m.from;d.querySelector('.b').textContent=m.body;log.appendChild(d);window.scrollTo(0,document.body.scrollHeight)}
-const refreshMembers=async()=>{const r=await(await fetch('/api/${room}/members')).json()
-  membersEl.textContent='卓に居る: '+(r.members.map(m=>m.name).join('、')||'（まだ誰も居ない）')}
-fetch('/api/${room}/messages').then(r=>r.json()).then(r=>r.messages.forEach(render))
-new EventSource('/api/${room}/events').onmessage=e=>{render(JSON.parse(e.data));refreshMembers()}
-refreshMembers()
+const ROOM=${JSON.stringify(room)}
+const api=p=>'/api/'+encodeURIComponent(ROOM)+'/'+p
+const logEl=document.getElementById('log'),membersEl=document.getElementById('members')
+const el=(tag,cls,text)=>{const e=document.createElement(tag);if(cls)e.className=cls;if(text!=null)e.textContent=text;return e}
+const hue=n=>{let h=5381;for(let i=0;i<n.length;i++)h=(h*33+n.charCodeAt(i))|0;return Math.abs(h)%360}
+const initial=n=>{const c=[...String(n)][0];return c?c.toUpperCase():'?'}
+const stamp=at=>{const t=el('time','ts',at.toLocaleTimeString([],{hour:'2-digit',minute:'2-digit'}));t.dateTime=at.toISOString();t.title=at.toLocaleString();return t}
+const nearBottom=()=>window.innerHeight+window.scrollY>=document.body.offsetHeight-80
+let last=null,recent=null
+function render(m){
+  const at=new Date(m.ts)
+  if(m.from==='system'){const d=el('div','sys');d.appendChild(el('span','body',m.body));d.appendChild(stamp(at));logEl.appendChild(d);last=null;return}
+  const cont=last&&last.from===m.from&&last.to===m.to&&at-new Date(last.ts)<300000
+  const d=el('div','msg'+(m.to!=='all'?' dm':'')+(cont?' cont':''))
+  d.style.setProperty('--h',hue(m.from))
+  d.appendChild(el('div','av',initial(m.from)))
+  const body=el('div','body'),meta=el('div','meta')
+  meta.appendChild(el('span','who',m.from))
+  if(m.to!=='all')meta.appendChild(el('span','to','→ '+m.to))
+  meta.appendChild(stamp(at))
+  body.appendChild(meta);body.appendChild(el('div','bubble',m.body))
+  d.appendChild(body);logEl.appendChild(d);last=m
+}
+async function refreshMembers(){
+  const r=await(await fetch(api('members'))).json()
+  membersEl.textContent=''
+  if(!r.members.length){membersEl.appendChild(el('span','empty','（まだ誰も居ない）'));return}
+  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
+    c.title=m.name+'（参加 '+new Date(m.joined_at).toLocaleString()+'）'
+    c.appendChild(el('span','av',initial(m.name)));c.appendChild(el('span','nm',m.name))
+    membersEl.appendChild(c)
+  }
+}
+// 直近の発言者を光らせる＝いま手を動かしている子が一覧で見える
+function markActive(name){
+  recent=name;let known=false
+  for(const c of membersEl.children){
+    if(!c.dataset.name)continue
+    const hit=c.dataset.name===name;known=known||hit
+    c.classList.toggle('recent',hit)
+    if(hit){c.classList.remove('pulse');void c.offsetWidth;c.classList.add('pulse')}
+  }
+  if(!known)refreshMembers()
+}
+const BEAT=${HEARTBEAT_MS}
+let lastSeq=0,lastBeat=Date.now(),es=null,emptyEl=null,firstLoad=true,catching=false
+// seq で二重描画を弾く。張り直し後の追いつきと SSE の新着が重なっても同じ発言は1回しか出ない
+function apply(m){
+  if(m.seq<=lastSeq)return false
+  lastSeq=m.seq
+  if(emptyEl){emptyEl.remove();emptyEl=null}
+  render(m)
+  if(m.from!=='system')recent=m.from
+  return true
+}
+async function catchUp(force){
+  if(catching)return
+  catching=true
+  try{
+    const stick=force||nearBottom()
+    const r=await(await fetch(api('messages')+'?since='+lastSeq)).json()
+    const added=r.messages.filter(apply).length
+    if(!lastSeq&&!emptyEl){emptyEl=el('div','empty','（まだ発言がない）');logEl.appendChild(emptyEl)}
+    await refreshMembers()
+    if(added&&stick)window.scrollTo(0,document.body.scrollHeight)
+  }finally{catching=false}
+}
+function connect(){
+  if(es)es.close()
+  es=new EventSource(api('events'));lastBeat=Date.now()
+  es.onopen=()=>{lastBeat=Date.now();catchUp(firstLoad);firstLoad=false}
+  // 心拍は room の最新 seq を積んでくる。繋がったまま取りこぼした（＝途絶しないので watchdog が気づけない）
+  // 場合は、この差分だけが手掛かりになる
+  es.addEventListener('ping',e=>{lastBeat=Date.now();if(Number(e.data)>lastSeq)catchUp()})
+  es.onmessage=e=>{
+    lastBeat=Date.now()
+    const m=JSON.parse(e.data),stick=nearBottom()
+    if(!apply(m))return
+    if(m.from==='system')refreshMembers();else markActive(m.from)
+    if(stick)window.scrollTo(0,document.body.scrollHeight)
+  }
+}
+connect()
+// 半開きで死んだ接続は onerror を出さない＝心拍の途絶だけが唯一の手掛かり。見つけたら黙って諦めず張り直す
+setInterval(()=>{if(Date.now()-lastBeat>BEAT*2.5)connect()},BEAT/2)
+setInterval(refreshMembers,30000) // 退席（member DELETE）は発言を出さないので定期に取り直す
 </script></body></html>`
+const INDEX = list => `<!doctype html><html lang="ja"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>Peertable</title>${FAVICON}<style>${STYLE}
+.wrap{max-width:560px;margin:0 auto;padding:56px 16px}
+.tag{color:var(--dim);margin:6px 0 22px}
+.rooms{list-style:none;padding:0;margin:0;display:flex;flex-direction:column;gap:8px}
+.rooms a{display:flex;align-items:center;gap:9px;padding:11px 14px;border:1px solid var(--line);border-radius:11px;background:var(--surface);text-decoration:none;color:var(--fg);font-weight:650}
+.rooms a::before{content:"";width:7px;height:7px;border-radius:50%;background:var(--accent)}
+</style></head><body><div class="wrap">
+<div class="brand">${MARK}Peertable</div>
+<p class="tag">A round table of peer agents. No orchestrator at the head.</p>
+<ul class="rooms">${list.map(r => `<li><a href="/${encodeURIComponent(r)}">${esc(r)}</a></li>`).join('') || '<li class="empty">（まだ卓が無い）</li>'}</ul>
+</div></body></html>`

package/skill/SKILL.md CHANGED Viewed

@@ -21,30 +21,36 @@ description: 任意プロジェクトに Peertable チーム（対等メンバ
 - git 除外は `.git/info/exclude` を使う（`.gitignore` には触れない。決定34）
 - teardown 後にプロジェクトの diff がゼロになること
 - 例外は Lattice store（`.lattice/`）: Lattice 自身の作法に従う。setup が新規作成した場合だけ teardown で削除し、既存 store には plan の追加・削除とも Lattice の正規コマンド以外で触れない
+- もう1つの例外は `.lattice/project.json` の `external_pane` 欄（**Lattice 併用モードのみ**。決定53）。既存文書は `.team/project.json.bak` へ退避し、teardown が書き戻す。文書が無かった project では teardown が `project.json` ごと削除する
 ## setup
-1. **聞き取り**: 対象プロジェクトのパス / **工程正本（`Lattice 併用`＝既定 / `単独`）** / メンバー数とモデル・effort（モデル既定: Sonnet、effort既定: CLI 既定。モデル選定は作業の性質——設計か確定実装か——を軸にする。決定49）/ 初期タスク群（何を作るか）/ room 名（既定: プロジェクトのディレクトリ名）
+手順は **聞き取り → 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 を外から見た時に開けない）
    - **メンバー数の既定**: Lattice 併用なら plan compile 結果の幅（`max_frontier_width`）に合わせる（実測: 幅3→3人、第2 campaign で幅4→4人目追加）。frontier より多い席は最初から遊ぶ。単独モードには frontier が無いので既定の根拠も無く、聞き取りで決める
    - **モードの選び分け**: タスク間に依存があり並列境界の機械保証が要るなら Lattice 併用。依存の無い小規模作業で、対象プロジェクトに Lattice を持ち込みたくないなら単独。単独で失うのは task 間スケジューリングの機械保証だけで、円卓の核（room・憲章・宣言による協力）は変わらない（決定47）
 2. **命名**: メンバーに日本のアニメキャラ風の可愛い名前を都度決める（固定リストなし）。識別子（tmux セッション名・room 登録名・Lattice actor）はローマ字、表示・自己紹介は日本語（決定35）
-3. **scaffold**: `scripts/setup.sh <project> <room> <server_url> <plan_key|-> <peertable_repo> [tasks_file]` を実行する。`.team/`（憲章・roles/member.md ほか）と project root の `.mcp.json`（room MCP 定義。決定44）を templates から生成・置換し、`.git/info/exclude` へ `.team/` と `/.mcp.json` を追記し、作成記録を `.team/setup-state.json`（`mode` を含む）に残す
-   - **Lattice 併用**: `plan_key` に plan key を渡す。`.team/scripts/done.sh` も配られる
+3. **scaffold**: `PEERTABLE_PUBLIC_URL=<公開URL基底> scripts/setup.sh <project> <room> <server_url> <plan_key|-> <peertable_repo> [tasks_file]` を実行する。`.team/`（憲章・roles/member.md ほか）と project root の `.mcp.json`（room MCP 定義。決定44）を templates から生成・置換し、`.git/info/exclude` へ `.team/` と `/.mcp.json` を追記し、作成記録を `.team/setup-state.json`（`mode` を含む）に残す
+   - **Lattice 併用**: `plan_key` に plan key を渡す。`.team/scripts/done.sh` も配られる。加えて `scripts/external-pane.mjs` が対象 project の `.lattice/project.json` へ `external_pane`（工程表の右ペインに円卓を差す口。決定53）を書く
    - **単独**: `plan_key` に `-` を渡し、第6引数へ聞き取ったタスクを書いた本文ファイル（`- タスク名: 何をどこまでやるか` の箇条書き。中間ファイルは scratchpad で可）を渡す。`.team/tasks.md`（読み取り専用の議題表）が生成され、`roles/member.md` は単独版になる。`done.sh` は配られない。**議題表を渡さないと setup.sh はエラーで止まる**（空の議題表を作らない）
-4. **Lattice plan（Lattice 併用モードのみ・単独はこの手順ごとスキップ）**: `lattice status --json` で正本を判定する。`uninitialized` なら templates/gen-plan.mjs を雛形に聞き取ったタスクを plan 化して `lattice plan create`。初期化済みなら `todo migrate` の作法（Lattice 正典）に従う。設計メモは各タスクに必ず書く
+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. **メンバー起動**（メンバーごとに aiterm PTY で）:
-   - 起動前に `pty_list` で既存の `peer-*` 席を確認し、前の卓の残骸が残っていれば回収してから立てる（2026-08-08 に他 campaign 由来の残骸を99席実測）
-   - export: `PEERTABLE_URL` / `PEERTABLE_ROOM` / `PEERTABLE_MEMBER=<romaji>` / `PEERTABLE_POST_TOKEN`（`~/.config/peertable.env` から）。**Lattice 併用モードは加えて** `PEERTABLE_PLAN=<plan_key>` / `LATTICE_TODO_ACTOR_HOST` / `LATTICE_TODO_ACTOR_SESSION=<romaji>` / `LATTICE_TODO_ACTOR_AGENT=<romaji>`（単独モードでは不要——渡さない）
-   - 起動: `cd <project> && claude --model <model> [--effort <level>] --dangerously-skip-permissions --dangerously-load-development-channels server:room`（**channels は `--mcp-config` の MCP server を解決しない**（実測 2026-08-08・Claude Code v2.1.226・決定44）ため、room の MCP 定義は setup.sh が project root へ置く `.mcp.json` が正。`.git/info/exclude` 追加と teardown での撤去で不可侵原則を保つ。project に既存 `.mcp.json` があった場合 setup.sh は上書きせず警告を出すので、AI が手動 merge して teardown で復元する）
-   - ダイアログを画面確認しながら通す（MCP 同意 → 外部 import は状況判断 → bypass 承諾 → 開発 channel 警告）。バナーに `Channels (experimental) ... server:room` が出たら着席成立
-   - 着任指示: 「あなたは「<日本語名>」。.team/roles/member.md を読んで着任し、作業ループを開始せよ。全タスク完了の宣言まで自律的に続けること。」
-6. **親の着卓**（このセッション）: room API へ member 登録（名は bell 等）し、SSE を Monitor で張る。post も API 直（下記「親の operating notes」）
-7. **起動確認**: room の members に全員いる / 最初の claim が room に流れる（Lattice 併用モードはそれが Lattice へ到達している＝`lattice todo status --json` の active に出ることも確認する。単独モードは room の claim 宣言だけが到達の証拠）/ Web UI で観測できる、をチェックして報告する
+5. **メンバー起動**: メンバーごとに `scripts/launch-seat.sh <project> <name> <model> [claude|codex] [effort] [着任指示]` を実行する。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` を含む全変数を明示列挙する。モデル名は 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 が自動で行う）
+   - **黙って止まらないための三段**（決定58 の受信側の作法）: ①75秒なにも届かなければ自分から切って繋ぎ直す ②繋ぎ直したら `?since=<最終seq>` で切れていた間の発言を回収する ③**心拍が積んでくる room の最新 seq が自分より進んでいたら、繋がったままでも回収する**——③が要るのは、心拍が届き続ける限り①が原理的に発火しないため。**server 側の心拍（`event: ping`・25秒周期）が前提**なので、古い room サーバーへ繋ぐと①だけが効く形になる
+   - ログは `.team/wakeup-bridge.log`。**0件でも0件と出す**ので、起こせているか・取りこぼしていないかはログを見れば分かる。再現ハーネスは `experiments/bridge-catchup-repro.mjs`
+7. **親の着卓**（このセッション）: `scripts/parent-join.sh <project> [name] [kickoff_file]` で member 登録と kickoff 投稿を行い、SSE を Monitor で張る。以後の post も API 直（下記「親の operating notes」）
+8. **起動確認**: room の members に全員いる / 最初の claim が room に流れる（Lattice 併用モードはそれが Lattice へ到達している＝`lattice todo status --json` の active に出ることも確認する。単独モードは room の claim 宣言だけが到達の証拠）/ Web UI で観測できる、をチェックして報告する
 ## teardown
-`scripts/teardown.sh <project>` が機械部分を行う（room 名・server URL・作成記録は `.team/setup-state.json` から読むので引数は project だけ。書込トークンは環境変数 `PEERTABLE_POST_TOKEN`）: tmux セッション終了（先に殺す。`.team/` 消失後の参照事故防止）→ サーバー room 削除 → `.team/` 削除 → `.git/info/exclude` の追記行を戻す → setup が作った `.lattice/` なら削除。実行後 `git status` で diff ゼロを確認して報告する。
+`scripts/teardown.sh <project>` が機械部分を行う（room 名・server URL・作成記録は `.team/setup-state.json` から読むので引数は project だけ。書込トークンは環境変数 `PEERTABLE_POST_TOKEN`）: tmux セッション終了（先に殺す。`.team/` 消失後の参照事故防止）→ サーバー room 削除 → **外部ペインの復元**（`.lattice/project.json` を setup 前へ戻す。既存文書があったなら `.team/project.json.bak` から書き戻し、無かったなら削除する。`.team/` を消す前にやる——退避先がその中にある）→ `.team/` 削除 → `.git/info/exclude` の追記行を戻す → setup が作った `.lattice/` なら削除。実行後 `git status` で diff ゼロを確認して報告する。
 ## 親の operating notes（このセッションの振る舞い）
@@ -65,5 +71,16 @@ description: 任意プロジェクトに Peertable チーム（対等メンバ
 - Lattice 書込には actor 環境変数 3 点が必須
 - `--parallel-frontier` が要るのは、**ready が複数あって誰も着手していない frontier の最初の start だけ**（無いと `PARALLEL_DISPATCH_REQUIRED / parallel_frontier_requires_declaration` で弾かれる）。ready が1件だけ、または既に誰かが着手している frontier へ後から乗る場合は素の `start` でよい。フラグが効くのは**取る task が `next_ready` に居る時だけ**で、他人が着手済みの task へ付けると `PARALLEL_DISPATCH_INVALID / parallel_frontier_not_applicable` になる——「フラグが使えない」ではなく「**その task はもう空いていない**」の意味である（`Lattice src/todo-cli.mjs:698-704` が唯一の発生条件。independence の compile 状態は無関係で、未 compile でもフラグ付き start は通る。2026-08-08 実測）
 - 同時書込は `STORE_WRITE_CONFLICT` 等で明示的に負ける。1〜2 秒待って再実行すれば通る（正常系）
-- evidence は記述子 JSON。記述子ファイル自体も repo 内相対パスに置く（repo 外絶対パスは INVALID_ARGUMENTS）。`.team/scripts/done.sh` が正規経路
+- 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 はターン実行中でも素送信を受け付ける**（実測 2026-08-08）。busy 中に送った文言はそのターンの中で読まれ、指示どおりに動く（steering）。よって起床ブリッジは idle 待ちを持たない。busy の判定が要る場面では画面の `esc to interrupt` の有無が使える
+- **席の沈黙は「詰まり」と同義ではない。** 発言間隔やファイルの更新時刻から止まったと判定しない——実装が終わって検証に時間を使っているだけのことがある。判定は `tmux -S <sock> capture-pane -t peer-<名前> -p` で**実状態を読む**: `Cogitating…（N分）` なら長いターンの最中（通知はターン後にまとめて届くので、呼びかけを足しても速くならない）／選択ダイアログで止まっているなら既知の停止要因／`pane_dead=1` なら落ちている。**読み取りだけなら相手の作業を壊さない**ので、憶測を room へ流す前にこれを見る（2026-08-08 に2人が独立に踏み、先に憶測を流した側が訂正を出した）
+- **`claude-in-chrome` の呼び出しは返らないことがある**。原因は2種で、解き方が違う（2026-08-08 に席1つが9分半沈黙して実測）:
+  - **接続ブラウザが複数あって、拡張がどれを使うか選ばせている**——選択待ちのまま返らない。**AI 側から解ける**（オーナーに「どちらを使うか」を一言聞けば済む）。今回の実例はこちら。デバッグ接続が宙吊りのまま「Claude がこのブラウザのデバッグを開始しました［キャンセル］」バナーが残る形もあり、キャンセルを押せば呼び出しは即エラーで返る
+  - **ブラウザに alert/confirm 等のモーダルが出ている**——拡張が以後のコマンドを受け取れない。**AI 側から解けない**ので、人がダイアログを閉じるしかない
+  - 沈黙した席を見る側は、この2つを区別せずに「固着」と決めない。トークン受信が増え続けているなら止まっていない
+- **共有リソースを占める作業は着手前に room へ一言**。同じマシンに席が並ぶので、実測の宣言は「repo を汚さないか」だけでなく「**ブラウザ・ポート・常駐 process を占めないか**」まで含める。ブラウザを起こす席が複数あると、拡張の接続先が増えて他席の呼び出しが選択待ちに入りうる（2026-08-08 の停止例では原因ではなかったが、成立しうる経路として置く）
+- **シェルスクリプトで `$var` の直後に全角括弧を書かない**。bash が高位バイトを変数名の一部として食い、変数が空のまま何も言わずに出力から消える（2026-08-08 実測）。`${var}（…）` と閉じる。同様に `python3 -c` へ `{...}` を含む式をインラインで渡さない——シェルのブレース展開が刻む。ヒアドキュメントで渡す
 - channels はリサーチプレビュー。構文が変わったら V0 の要領で公式ドキュメント（code.claude.com/docs/en/channels-reference.md）を再確認する

package/skill/scripts/external-pane.mjs ADDED Viewed

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+// Peertable → Lattice 外部ペインコネクタ（決定53）。
+// usage: external-pane.mjs <project_dir> <room> <public_base>
+//
+// 対象プロジェクトの `.lattice/project.json` へ `external_pane`（title/url/probe_url）を書く。
+// Lattice 側（project-identity）は identity 文書のキー集合を検証するので、既存欄
+// （schema / project_id / display_name）を保ったまま完全な文書として書き直す。
+// 既存文書は `.team/project.json.bak` へ退避し、teardown がそれを戻す。
+//
+// stdout: 既存 project.json があったかを `true` / `false` の1行で出す（setup.sh が state へ記録する）
+// stderr: 人間向けの書き込み内容
+import { copyFileSync, existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from 'node:fs'
+import { basename, join } from 'node:path'
+const [proj, room, base] = process.argv.slice(2)
+const identity = join(proj, '.lattice', 'project.json')
+const preexisting = existsSync(identity)
+const current = preexisting ? JSON.parse(readFileSync(identity, 'utf8')) : {}
+if (preexisting) copyFileSync(identity, join(proj, '.team', 'project.json.bak'))
+// project_id は Lattice store が持つ値が正。setup 時点では store がまだ無いので、
+// 既存 identity → プロジェクトディレクトリ名 の順で決める（make-plan-input.mjs の既定と同じ）。
+const projectId = current.project_id ?? basename(realpathSync(proj))
+const root = base.replace(/\/+$/, '')
+const pane = { title: '円卓', url: `${root}/${room}`, probe_url: `${root}/api/${room}/members` }
+mkdirSync(join(proj, '.lattice'), { recursive: true })
+writeFileSync(identity, JSON.stringify({
+  schema: 'lattice.project_identity.v1',
+  project_id: projectId,
+  display_name: current.display_name ?? projectId,
+  external_pane: pane,
+}, null, 2) + '\n')
+process.stderr.write(`external pane: ${pane.url}（probe: ${pane.probe_url}・project_id: ${projectId}）\n`)
+process.stdout.write(preexisting ? 'true\n' : 'false\n')

package/skill/scripts/launch-seat.sh ADDED Viewed

@@ -0,0 +1,100 @@
+#!/bin/bash
+# 席を1つ立てる（tmux 作成 → env 注入 → エージェント起動 → 既知ダイアログ通過 → 着席確認）。
+# usage: launch-seat.sh <project_dir> <name> <model> [vendor] [effort] [brief]
+#   vendor: claude（既定）/ codex
+#   brief:  着席が成立したら送る着任指示（省略時は送らない）
+#
+# room 名・server URL・モード・plan key は <project>/.team/setup-state.json から読む（setup.sh の後に呼ぶ）。
+# 書込トークンは環境変数 PEERTABLE_POST_TOKEN、無ければ ~/.config/peertable.env から取る。
+# tmux は aiterm-mcp と同じソケットへ作るので、立てた席はそのまま pty_read / pty_send で読める。
+set -e
+proj="$1"; name="$2"; model="$3"; vendor="${4:-claude}"; effort="$5"; brief="$6"
+[ -n "$proj" ] && [ -n "$name" ] && [ -n "$model" ] || { echo "usage: launch-seat.sh <project_dir> <name> <model> [vendor] [effort] [brief]" >&2; exit 1; }
+sock="${PEERTABLE_TMUX_SOCKET:-${TMPDIR}claude-tmux-sockets/claude.sock}"
+sess="peer-$name"
+state="$proj/.team/setup-state.json"
+read -r room url mode plan <<EOF
+$(python3 -c "import json;d=json.load(open('$state'));print(d['room'],d['server_url'],d['mode'],d.get('plan_key') or '-')")
+EOF
+if [ -z "${PEERTABLE_POST_TOKEN:-}" ] && [ -f "$HOME/.config/peertable.env" ]; then
+  . "$HOME/.config/peertable.env"
+fi
+# 前の卓の残骸を回収してから立てる（同名セッションが残ると起動が黙って古い席に化ける）
+tmux -S "$sock" kill-session -t "$sess" 2>/dev/null || true
+tmux -S "$sock" new-session -d -s "$sess" -x 200 -y 50 -c "$proj"
+env_line="export PEERTABLE_URL=$url PEERTABLE_ROOM=$room PEERTABLE_MEMBER=$name PEERTABLE_POST_TOKEN=$PEERTABLE_POST_TOKEN"
+if [ "$mode" = "lattice" ]; then
+  env_line="$env_line PEERTABLE_PLAN=$plan LATTICE_TODO_ACTOR_HOST=${LATTICE_TODO_ACTOR_HOST:-mac} LATTICE_TODO_ACTOR_SESSION=$name LATTICE_TODO_ACTOR_AGENT=$name"
+fi
+tmux -S "$sock" send-keys -t "$sess" "$env_line" Enter
+sleep 1
+case "$vendor" in
+  claude)
+    cmd="claude --model $model"
+    [ -n "$effort" ] && cmd="$cmd --effort $effort"
+    cmd="$cmd --dangerously-skip-permissions --dangerously-load-development-channels server:room"
+    ;;
+  codex)
+    # Codex には channels が無いので room は stdio MCP として差す。
+    # `[mcp_servers.X.env]` は closed mode（親 env を継がない）ので全変数を明示列挙する
+    # （caveat `codex-cli-v0-130-0-mcp-servers-x-env-block-is-closed-mode-parent-env-not-inherited`）。
+    envtbl="PATH=\\\"$PATH\\\",PEERTABLE_URL=\\\"$url\\\",PEERTABLE_ROOM=\\\"$room\\\",PEERTABLE_MEMBER=\\\"$name\\\",PEERTABLE_POST_TOKEN=\\\"$PEERTABLE_POST_TOKEN\\\""
+    cmd="codex --model $model -C $proj --dangerously-bypass-approvals-and-sandbox"
+    cmd="$cmd -c 'mcp_servers.room.command=\"peertable-client\"'"
+    cmd="$cmd -c \"mcp_servers.room.env={$envtbl}\""
+    ;;
+  # 変数展開の直後に全角括弧を置かない（bash が高位バイトを変数名の一部として食い、
+  # 変数が空になって黙って情報が消える。2026-08-08 実測）。必ず ${var} で閉じる
+  *) echo "unknown vendor: ${vendor}（claude / codex）" >&2; exit 1 ;;
+esac
+tmux -S "$sock" send-keys -t "$sess" "$cmd" Enter
+# 既知ダイアログ（実測 2026-08-08・Claude Code v2.1.226 / Codex CLI v0.146.0）:
+#   claude ① 未信頼ディレクトリの workspace trust「1. Yes, I trust this folder」
+#          ② 開発 channel 警告「1. I am using this for local development」
+#   codex  ① ディレクトリ trust「1. Yes, continue」
+# いずれも既定の選択肢が正なので、文言を確認してから Enter を送る。信頼済みディレクトリでは
+# trust が出ないので、出た時だけ通す（順不同・出ないものは待たない）。
+# 着席の判定は claude=channels バナー / codex=セッションヘッダ。出なければ画面ごと出して落ちる。
+deadline=$((SECONDS + 90))
+seated=false
+while [ $SECONDS -lt $deadline ]; do
+  screen=$(tmux -S "$sock" capture-pane -t "$sess" -p)
+  if [ "$vendor" = "claude" ]; then
+    case "$screen" in *"Channels (experimental)"*"server:room"*) seated=true; break ;; esac
+  else
+    case "$screen" in *"OpenAI Codex (v"*) seated=true; break ;; esac
+  fi
+  case "$screen" in
+    # Codex の更新案内だけは既定（1. Update now）が誤り——立卓の途中で
+    # `npm install -g @openai/codex` が走る。1つ下の「2. Skip」を選ぶ
+    *"1. Update now"*)
+      tmux -S "$sock" send-keys -t "$sess" Down
+      sleep 1
+      tmux -S "$sock" send-keys -t "$sess" Enter ;;
+    *"1. Yes, I trust this folder"*|*"1. I am using this for local development"*|*"1. Yes, continue"*)
+      tmux -S "$sock" send-keys -t "$sess" Enter ;;
+  esac
+  sleep 2
+done
+if [ "$seated" != "true" ]; then
+  echo "着席しなかった: ${sess}（最後の画面を出す）" >&2
+  tmux -S "$sock" capture-pane -t "$sess" -p >&2
+  exit 1
+fi
+echo "seated: ${sess}（${vendor} / ${model}${effort:+ / $effort} / room=${room} / mode=${mode}）"
+if [ -n "$brief" ]; then
+  sleep 2
+  tmux -S "$sock" send-keys -t "$sess" "$brief"
+  sleep 1
+  tmux -S "$sock" send-keys -t "$sess" Enter
+  echo "briefed: $sess"
+fi

package/skill/scripts/make-plan-input.mjs ADDED Viewed

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+// タスク定義 JSON から `lattice plan create` の入力（lattice.plan_create_input.v4）を生成する。
+// usage: make-plan-input.mjs <tasks.json> [--project <dir>] [--out <path>]
+//   既定の出力先は <project>/.lattice/plan-create.json（`lattice status` が案内する場所）。
+//
+// 入力（tasks.json）:
+// {
+//   "plan_key": "lattice-integration",
+//   "project_id": "peertable",           // 省略時は project ディレクトリ名
+//   "plan_version": "v1",                // 省略時 v1
+//   "actor": { "host": "mac", "session": "setup", "agent": "bell" },   // 省略可
+//   "phase": { "id": "p1", "title": "…", "gate_policy": "audit" },     // 省略可（単一 Phase）
+//   "tasks": [
+//     { "id": "t1", "title": "…", "memo": "…", "deps": ["t0"] }        // deps は「先に終わる方」
+//   ]
+// }
+//
+// 手書きで2回踏んだ罠をここで潰す:
+//   1. hard_dependencies は (from.task_id, to.task_id) の昇順ソートが必須。崩れると
+//      `INPUT_INVALID / plan_create_schema_invalid / pointer:"/"` としか言われない
+//      （caveat `lattice-plan-create-hard-dependencies-from-to-pointer`）
+//   2. input_digest は input_digest 自身を除いたキー昇順の正規化 JSON の sha256
+import { createHash } from 'node:crypto'
+import { mkdirSync, readFileSync, realpathSync, writeFileSync } from 'node:fs'
+import { basename, dirname, join, relative, resolve } from 'node:path'
+const argv = process.argv.slice(2)
+let src = null
+let projectArg = '.'
+let outArg = null
+for (let i = 0; i < argv.length; i++) {
+  if (argv[i] === '--project') projectArg = argv[++i]
+  else if (argv[i] === '--out') outArg = argv[++i]
+  else src ??= argv[i]
+}
+if (!src) {
+  console.error('usage: make-plan-input.mjs <tasks.json> [--project <dir>] [--out <path>]')
+  process.exit(1)
+}
+const spec = JSON.parse(readFileSync(src, 'utf8'))
+const proj = realpathSync(resolve(projectArg))
+const out = resolve(outArg ?? join(proj, '.lattice', 'plan-create.json'))
+const projectId = spec.project_id ?? basename(proj)
+const planKey = spec.plan_key
+const phase = spec.phase ?? {}
+const phaseId = phase.id ?? 'p1'
+const ref = taskId => ({ project_id: projectId, plan_key: planKey, task_id: taskId })
+const deps = []
+for (const t of spec.tasks) for (const d of t.deps ?? []) deps.push({ from: ref(d), to: ref(t.id) })
+deps.sort((a, b) => a.from.task_id.localeCompare(b.from.task_id) || a.to.task_id.localeCompare(b.to.task_id))
+const input = {
+  schema: 'lattice.plan_create_input.v4',
+  project_id: projectId,
+  plan_key: planKey,
+  plan_version: spec.plan_version ?? 'v1',
+  actor: spec.actor ?? { host: 'mac', session: 'setup', agent: 'bell' },
+  // 記録時刻が未来だと弾かれうるので少し過去へ倒す（gen-plan.mjs から踏襲）
+  recorded_at: new Date(Date.now() - 60_000).toISOString(),
+  tasks: spec.tasks.map(t => ({
+    task_id: t.id,
+    title: t.title,
+    lane: t.lane ?? 'dev',
+    design_memo: t.memo,
+    narrative_ref: null,
+    narrative_anchor: null,
+    compile_binding: null,
+    parent_task_id: null,
+    phase_id: t.phase ?? phaseId,
+  })),
+  phases: [{
+    phase_id: phaseId,
+    title: phase.title ?? planKey,
+    gate_policy: phase.gate_policy ?? 'audit',
+    predecessor_phase_ids: [],
+    required_evidence_slots: phase.required_evidence_slots ?? ['result'],
+  }],
+  hard_dependencies: deps,
+  joins: [],
+  phase_accept_dependencies: [],
+  input_digest: '0'.repeat(64),
+}
+const canon = o => {
+  if (Array.isArray(o)) return o.map(canon)
+  if (o && typeof o === 'object') return Object.fromEntries(Object.keys(o).sort().map(k => [k, canon(o[k])]))
+  return o
+}
+const { input_digest, ...rest } = input
+input.input_digest = createHash('sha256').update(JSON.stringify(canon(rest))).digest('hex')
+mkdirSync(dirname(out), { recursive: true })
+writeFileSync(out, JSON.stringify(canon(input)) + '\n')
+// `lattice plan create --input` は repo root からの相対パスでないと `INPUT_INVALID / input_ref_invalid`
+// で弾かれるので、案内も相対で出す（絶対パスを貼れる形にしない）
+const rel = relative(proj, out)
+console.log(`${out}（${input.tasks.length} tasks / ${deps.length} deps）`)
+console.log(`次: cd ${proj} && lattice plan create --input ${rel}`)

package/skill/scripts/parent-join.sh ADDED Viewed

@@ -0,0 +1,41 @@
+#!/bin/bash
+# 親（ベル等）が room へ着卓し、必要なら kickoff を投げる。
+# usage: parent-join.sh <project_dir> [name] [kickoff_file]
+#   name 既定は bell。kickoff_file を渡すとその本文を全員宛で1回投稿する
+#   （複数行・記号を安全に運ぶためファイル渡しにしている。引数のインライン渡しはしない）。
+# 親は MCP を後付けできないので room へは HTTP API 直で入る（決定40 の operating notes）。
+set -e
+proj="$1"; name="${2:-bell}"; kickoff="$3"
+state="$proj/.team/setup-state.json"
+room=$(python3 -c "import json;print(json.load(open('$state'))['room'])")
+url=$(python3 -c "import json;print(json.load(open('$state'))['server_url'])")
+if [ -z "${PEERTABLE_POST_TOKEN:-}" ] && [ -f "$HOME/.config/peertable.env" ]; then
+  . "$HOME/.config/peertable.env"
+fi
+member=$(python3 - "$name" <<'PY'
+import json, sys
+print(json.dumps({'name': sys.argv[1]}))
+PY
+)
+curl -sf -X POST "$url/api/$room/members" \
+  -H "X-Peertable-Token: $PEERTABLE_POST_TOKEN" -H 'content-type: application/json' \
+  -d "$member" > /dev/null
+echo "joined: ${name}（room=${room}）"
+if [ -n "$kickoff" ]; then
+  # JSON の組み立てはヒアドキュメントで行う。`-c` にインラインで書くと本文の `{...}`
+  # をシェルのブレース展開が刻んで壊す（2026-08-08 実測）
+  body=$(python3 - "$name" "$kickoff" <<'PY'
+import json, sys
+print(json.dumps({'from': sys.argv[1], 'to': 'all', 'body': open(sys.argv[2]).read().strip()}))
+PY
+)
+  curl -sf -X POST "$url/api/$room/messages" \
+    -H "X-Peertable-Token: $PEERTABLE_POST_TOKEN" -H 'content-type: application/json' \
+    -d "$body" > /dev/null
+  echo "kickoff posted: $kickoff"
+fi
+curl -sf "$url/api/$room/members" | python3 -c "import json,sys;print('members:', ', '.join(m['name'] for m in json.load(sys.stdin)['members']))"

package/skill/scripts/setup.sh CHANGED Viewed

@@ -55,6 +55,19 @@ fi
 lattice_preexisting=false
 [ -d "$proj/.lattice" ] && lattice_preexisting=true
-printf '{"room":"%s","server_url":"%s","mode":"%s","plan_key":"%s","added_exclude":%s,"lattice_preexisting":%s,"added_root_mcp":%s,"added_mcp_exclude":%s}\n' \
-  "$room" "$url" "$mode" "$plan" "$added_exclude" "$lattice_preexisting" "$added_root_mcp" "$added_mcp_exclude" > "$tdir/setup-state.json"
+# Lattice 併用モードだけ、工程表の右ペインへ円卓を差す（決定53・明示的コネクタ）。
+# 公開URL基底は `PEERTABLE_PUBLIC_URL`（クオ環境: https://peertable.kitepon.dev）。
+# 未設定なら room サーバーの URL をそのまま使う——LAN URL は Lattice を外から見た時に開けないので、
+# 書いた URL は必ず標準エラーへ出す。
+external_pane=false
+project_json_preexisting=false
+public_url=""
+if [ "$mode" = "lattice" ]; then
+  public_url="${PEERTABLE_PUBLIC_URL:-$url}"
+  project_json_preexisting=$(node "$repo/skill/scripts/external-pane.mjs" "$proj" "$room" "$public_url")
+  external_pane=true
+fi
+printf '{"room":"%s","server_url":"%s","public_url":"%s","mode":"%s","plan_key":"%s","added_exclude":%s,"lattice_preexisting":%s,"added_root_mcp":%s,"added_mcp_exclude":%s,"external_pane":%s,"project_json_preexisting":%s}\n' \
+  "$room" "$url" "$public_url" "$mode" "$plan" "$added_exclude" "$lattice_preexisting" "$added_root_mcp" "$added_mcp_exclude" "$external_pane" "$project_json_preexisting" > "$tdir/setup-state.json"
 echo "scaffold done: $tdir"

package/skill/scripts/teardown.sh CHANGED Viewed

@@ -13,7 +13,23 @@ lat_pre=$(python3 -c "import json;print(json.load(open('$state'))['lattice_preex
 added_mcp=$(python3 -c "import json;d=json.load(open('$state'));print(d.get('added_root_mcp', d.get('root_mcp_json_fallback', False)))")
 added_mcp_ex=$(python3 -c "import json;d=json.load(open('$state'));print(d.get('added_mcp_exclude', d.get('root_mcp_json_fallback', False)))")
+# Codex 席の起床ブリッジ（決定54）。常駐 process なので、`.team/` を消す前に確実に止める
+if [ -f "$proj/.team/wakeup-bridge.json" ]; then
+  node "$(dirname "$0")/wakeup-bridge.mjs" "$proj" --stop
+fi
+# 外部ペイン（決定53）。`.team/` を消す前に戻す——退避先が `.team/` の中にある
+ext=$(python3 -c "import json;print(json.load(open('$state')).get('external_pane', False))")
+pj_pre=$(python3 -c "import json;print(json.load(open('$state')).get('project_json_preexisting', False))")
 curl -sf -X DELETE "$url/api/$room" -H "X-Peertable-Token: ${PEERTABLE_POST_TOKEN:-}" > /dev/null
+if [ "$ext" = "True" ] || [ "$ext" = "true" ]; then
+  if [ "$pj_pre" = "True" ] || [ "$pj_pre" = "true" ]; then
+    cp "$proj/.team/project.json.bak" "$proj/.lattice/project.json"
+  else
+    rm -f "$proj/.lattice/project.json"
+  fi
+fi
 rm -rf "$proj/.team"
 if [ "$added_mcp" = "True" ] || [ "$added_mcp" = "true" ]; then
   rm -f "$proj/.mcp.json"

package/skill/scripts/wakeup-bridge.mjs ADDED Viewed

@@ -0,0 +1,213 @@
+#!/usr/bin/env node
+// Codex 席の起床ブリッジ。room の SSE を購読し、その席宛（または全員宛）の新着が来たら
+// tmux の席へ素送信して起こす。Claude 席は channels が同じ役をするので対象外。
+//
+// usage: wakeup-bridge.mjs <project_dir> <seat> [seat...]     起動（前面。nohup で常駐させる）
+//        wakeup-bridge.mjs <project_dir> --stop               停止
+//
+// 生死の作法は Lattice ADR 0157 に倣う: 自分の pid を記録に置き、起動時に前の記録を掃除し、
+// 止まらなければ黙って諦めず typed error で落ちる。
+//
+// 実測（2026-08-08・Codex CLI v0.146.0）: Codex は**ターン実行中でも素送信を受け付ける**。
+// 送った文言はそのターンの中で読まれ、指示どおりに動いた（steering が効く）。したがって
+// idle 待ちの経路は持たない——待ちを入れると、混んでいる席ほど起床が遅れる。
+import { execFile } from 'node:child_process'
+import { existsSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { promisify } from 'node:util'
+const run = promisify(execFile)
+const [proj, ...rest] = process.argv.slice(2)
+if (!proj || rest.length === 0) {
+  console.error('usage: wakeup-bridge.mjs <project_dir> <seat> [seat...] | <project_dir> --stop')
+  process.exit(1)
+}
+const record = join(proj, '.team', 'wakeup-bridge.json')
+const sock = process.env.PEERTABLE_TMUX_SOCKET ?? `${process.env.TMPDIR}claude-tmux-sockets/claude.sock`
+const alive = pid => { try { process.kill(pid, 0); return true } catch { return false } }
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const log = line => console.log(`[${new Date().toISOString()}] ${line}`)
+async function stopRecorded() {
+  if (!existsSync(record)) return
+  const { pid } = JSON.parse(readFileSync(record, 'utf8'))
+  if (!alive(pid)) { unlinkSync(record); log(`死んだ記録を掃除した（pid ${pid}）`); return }
+  process.kill(pid, 'SIGTERM')
+  for (let i = 0; i < 25 && alive(pid); i++) await sleep(200)
+  if (alive(pid)) {
+    process.kill(pid, 'SIGKILL')
+    for (let i = 0; i < 15 && alive(pid); i++) await sleep(200)
+  }
+  if (alive(pid)) {
+    console.error(`WAKEUP_BRIDGE_STOP_FAILED: pid ${pid} が SIGKILL でも止まらない`)
+    process.exit(1)
+  }
+  if (existsSync(record)) unlinkSync(record)
+  log(`前のブリッジを停止した（pid ${pid}）`)
+}
+await stopRecorded()
+if (rest[0] === '--stop') process.exit(0)
+const seats = rest
+const state = JSON.parse(readFileSync(join(proj, '.team', 'setup-state.json'), 'utf8'))
+const { room, server_url: url } = state
+writeFileSync(record, JSON.stringify({
+  pid: process.pid, room, server_url: url, seats, started_at: new Date().toISOString(),
+}) + '\n')
+const cleanup = () => { if (existsSync(record)) unlinkSync(record); process.exit(0) }
+process.on('SIGTERM', cleanup)
+process.on('SIGINT', cleanup)
+// 席ごとに未配達を溜めて、2秒ごとにまとめて1回起こす（連投で席を何度も起こさない）
+const pending = new Map(seats.map(s => [s, []]))
+async function wake(seat, msgs) {
+  const last = msgs[msgs.length - 1]
+  const text = msgs.length === 1
+    ? `room に新着あり（${last.from} → ${last.to}）。read_unread で読むこと。`
+    : `room に新着 ${msgs.length} 件（最新: ${last.from} → ${last.to}）。read_unread で読むこと。`
+  try {
+    await run('tmux', ['-S', sock, 'send-keys', '-t', `peer-${seat}`, text])
+    await sleep(400)
+    await run('tmux', ['-S', sock, 'send-keys', '-t', `peer-${seat}`, 'Enter'])
+    log(`起こした: ${seat} ← ${msgs.length} 件（最新 seq ${last.seq}）`)
+  } catch (error) {
+    // 席が畳まれていれば tmux が落ちる。黙って飲まず、毎回出す（何件落としたかも出す）
+    log(`起こせなかった: ${seat} ← ${msgs.length} 件（最新 seq ${last.seq}）: ${error.message.split('\n')[0]}`)
+  }
+}
+setInterval(async () => {
+  for (const [seat, msgs] of pending) {
+    if (msgs.length === 0) continue
+    pending.set(seat, [])
+    await wake(seat, msgs)
+  }
+}, 2000)
+function dispatch(msg) {
+  for (const seat of seats) {
+    if (msg.from === seat) continue
+    if (msg.to !== 'all' && msg.to !== seat) continue
+    pending.get(seat).push(msg)
+  }
+}
+// 再接続で取りこぼさないために、配達済みの最大 seq を持つ。
+// SSE は切れている間の発言を後から届けてくれないので、繋ぎ直したら必ず穴を埋める。
+let lastSeq = 0
+function dispatchNew(msg) {
+  // seq の無いイベントで lastSeq を汚さない。`undefined <= 数値` は false なので、
+  // 素通しにすると lastSeq が undefined に化け、以後の比較が全部 false になって
+  // 「取りこぼし回収が毎回 since=undefined で 0 件」という静かな故障になる（実測で踏んだ）
+  if (typeof msg.seq !== 'number') {
+    log(`seq を持たないイベントを捨てた: ${JSON.stringify(msg).slice(0, 120)}`)
+    return
+  }
+  if (msg.seq <= lastSeq) return
+  lastSeq = msg.seq
+  dispatch(msg)
+}
+// 繋がったまま黙って死ぬ接続を検出する。SSE は無音でも生きていられるので、
+// 「切れた」ではなく「一定時間なにも届かない」を異常として扱い、自分から切って繋ぎ直す。
+// 直後に since で追いつくので、無音が正常だった場合も取りこぼしは出ない。
+// server の心拍が 25 秒周期（`room/server.mjs` の HEARTBEAT_MS）なので、その3倍を無音の閾値にする。
+const IDLE_MS = 75_000
+// 起動直後の1回だけは配達しない。既に流れ終わった過去ログで席を起こしても意味がなく、
+// 卓が長いほど巨大な起床通知になる。初回は「ここまでは読んだこと」にして頭出しするだけ。
+let primed = false
+let catching = false
+async function catchUp(reason) {
+  // 再接続直後と心拍由来の回収が重なると二重に取りにいく。取りこぼし回収は1本だけ走らせる
+  if (catching) return
+  catching = true
+  try {
+    const res = await fetch(`${url}/api/${room}/messages?since=${lastSeq}`)
+    if (!res.ok) throw new Error(`messages ${res.status}`)
+    const { messages } = await res.json()
+    if (!primed) {
+      primed = true
+      if (messages.length > 0) lastSeq = messages[messages.length - 1].seq
+      log(`頭出し: seq ${lastSeq} まで既読として開始する`)
+      return
+    }
+    log(`取りこぼし確認（${reason}・since ${lastSeq}）: ${messages.length} 件`)
+    for (const msg of messages) dispatchNew(msg)
+  } finally {
+    catching = false
+  }
+}
+// 心拍の data は room の最新 seq である（kotoha の `859bc21`）。これが自分の lastSeq より
+// 進んでいたら「繋がったままなのに取りこぼしている」証拠になる。**watchdog はこの穴を原理的に
+// 見つけられない**——心拍が届き続ける限り最終受信時刻は更新され続けるので、途絶判定に一生
+// 引っかからない。だから常時流れてくる心拍そのものを取りこぼし検出に使う。
+function onHeartbeat(dataLine) {
+  const head = Number(dataLine)
+  if (!Number.isFinite(head) || head <= lastSeq) return
+  log(`心拍が示す最新 seq ${head} に追いついていない（手元 ${lastSeq}）`)
+  catchUp('心拍の差分').catch(error => log(`心拍由来の回収に失敗: ${error.message}`))
+}
+let failures = 0
+log(`bridge start: room=${room} seats=${seats.join(',')} pid=${process.pid}`)
+for (;;) {
+  try {
+    const abort = new AbortController()
+    let lastByteAt = Date.now()
+    const watchdog = setInterval(() => {
+      if (Date.now() - lastByteAt > IDLE_MS) {
+        log(`受信途絶 ${Math.round(IDLE_MS / 1000)} 秒。接続が黙って死んだとみなして繋ぎ直す`)
+        abort.abort()
+      }
+    }, 5000)
+    try {
+      const res = await fetch(`${url}/api/${room}/events`, { signal: abort.signal })
+      if (!res.ok) throw new Error(`events ${res.status}`)
+      failures = 0
+      log('SSE 接続')
+      await catchUp('再接続')
+      let buf = ''
+      for await (const chunk of res.body) {
+        lastByteAt = Date.now()
+        buf += Buffer.from(chunk).toString('utf8')
+        const parts = buf.split('\n\n')
+        buf = parts.pop()
+        for (const part of parts) {
+          const lines = part.split('\n')
+          // SSE の1フレームは `event:` と `data:` の複数行で来る。名前付きイベント
+          // （server の心拍 `event: ping` / `data: 1` 等）は発言ではないので配達しない。
+          // `data:` だけ拾う実装だと心拍の `1` が発言として流れ込む（kotoha [106] の指摘）
+          const name = lines.find(l => l.startsWith('event: '))?.slice(7).trim()
+          const line = lines.find(l => l.startsWith('data: '))
+          if (name === 'ping') { if (line) onHeartbeat(line.slice(6)); continue }
+          if (name !== undefined && name !== 'message') continue
+          if (line) dispatchNew(JSON.parse(line.slice(6)))
+        }
+      }
+      log('SSE 切断（再接続する）')
+    } finally {
+      clearInterval(watchdog)
+    }
+  } catch (error) {
+    // 自分で切った時（watchdog の abort）は失敗ではない——数えると健全な再接続で落ちてしまう
+    if (error.name === 'AbortError') {
+      log('再接続する')
+    } else {
+      failures++
+      log(`SSE 失敗 ${failures} 回目: ${error.message}`)
+      // 落ちっぱなしを黙って再試行し続けない。連続失敗が続いたら記録を外して落ちる
+      if (failures >= 10) {
+        console.error('WAKEUP_BRIDGE_UNREACHABLE: room の SSE へ10回連続で繋げない')
+        if (existsSync(record)) unlinkSync(record)
+        process.exit(1)
+      }
+    }
+  }
+  await sleep(2000)
+}

package/skill/templates/done.sh CHANGED Viewed

@@ -1,10 +1,12 @@
 #!/bin/bash
 # usage: .team/scripts/done.sh <task_id>
-# evidence/<task_id>.md（commit 済みであること）から記述子を作り lattice todo done を実行する。
+# evidence/<plan_key>/<task_id>.md（commit 済みであること）から記述子を作り lattice todo done を実行する。
 # plan key は環境変数 PEERTABLE_PLAN から取る。
+# 証跡を plan key で仕切るのは、task_id が campaign を跨いで再利用される（t1, t2, …）ため。
+# 平置きだと次の campaign の t1 が前の campaign の t1 の監査証跡を上書きで消す（2026-08-08 実測）。
 set -e
 t="$1"
-f="evidence/$t.md"
+f="evidence/$PEERTABLE_PLAN/$t.md"
 oid=$(git hash-object -w "$f")
 digest=$(shasum -a 256 "$f" | cut -d' ' -f1)
 # 記述子は repo 内の相対パスに置く（repo 外の絶対パスは --evidence が INVALID_ARGUMENTS で弾く）

package/skill/templates/member-standalone.md CHANGED Viewed

@@ -7,7 +7,7 @@
 ## 作業ループ
 1. `.team/tasks.md` で議題を見る。`read_log` で既存の claim と完了報告を照合し、まだ誰も持っていないものを選ぶ
-2. 憲章の手順で room に `[claim] <タスク>` を全員宛で宣言し、直後に `read_unread` で先行 claim が無いか確かめる
+2. 憲章の手順で room に `[claim] <タスク>` を全員宛で宣言し、直後に `read_unread` で先行 claim が無いか確かめる。**`[claim]` は独立した1発言で出す**——完了報告や他タスクの話と同じ発言に畳まない。宣言としては有効でも、後から機械的に追えなくなり、監査が「宣言が無い」と誤読する（2026-08-08 実測）。単独モードでは room ログが唯一の正本なので、より効く
 3. 実装する。インターフェースなど他タスクに影響する決定は、決めた時点で room 全員宛に一行で共有する
 4. 完了手順:
    - 何を作り、どう確認したかを自分で確かめる（テスト・実行・実測。「たぶん動く」で閉じない）
@@ -23,5 +23,6 @@
 - 誰が何を持っているかを機械に問い合わせられない卓である。claim と完了の宣言を落とした瞬間に重複作業になるので、宣言を省かない
 - room の新着通知が来たら read_unread で読む。返事が要るものには post で応える
+- **Codex 席の場合**: 起床は channels ではなく wakeup-bridge が担う。`room に新着あり（<誰> → <宛先>）。read_unread で読むこと。` が端末へ直接届くので、Claude 席と同じく read_unread で読む。**作業中でも割り込んで届く**（そのターンの中で読まれる）ので、届いたらその場で手を止めて読み、返事が要るなら post してから元の作業へ戻る。自分の発言では起きない
 - 全タスクの完了報告が揃ったかの判定と散会の宣言は親が行う。自分の担当が終わっても散会宣言までは卓に残り、仲間の求めに応える
 - 憲章（.team/CLAUDE.md）が全ての基底である

package/skill/templates/member.md CHANGED Viewed

@@ -5,11 +5,11 @@
 ## 作業ループ
 1. `lattice todo status --json` で ready なタスクを見る
-2. 憲章の手順で room に claim を宣言する
+2. 憲章の手順で room に claim を宣言する。**`[claim]` は独立した1発言で出す**——完了報告や他タスクの話と同じ発言に畳まない。宣言としては有効でも、後から機械的に追えなくなり、監査が「宣言が無い」と誤読する（2026-08-08 実測）
 3. `lattice todo start --plan {{PLAN_KEY}} --task <id>` で着手を記録する。**誰も着手しておらず ready が2件以上ある frontier の先頭を取る時だけ `--parallel-frontier` が必須**（無いと `PARALLEL_DISPATCH_REQUIRED / parallel_frontier_requires_declaration` で弾かれる）。ready が1件だけ、または既に誰かが着手している frontier へ後から乗る時は素の start でよい
 4. 実装する。インターフェースなど他タスクに影響する決定は、決めた時点で room 全員宛に一行で共有する
 5. 完了手順:
-   - 証跡ファイル `evidence/<task_id>.md` に「何を作り、どう確認したか」を書く
+   - 証跡ファイル `evidence/{{PLAN_KEY}}/<task_id>.md` に「何を作り、どう確認したか」を書く（ディレクトリが無ければ作る。task_id は campaign を跨いで再利用されるので、平置きにすると前の campaign の証跡を上書きで消す）
    - 変更ファイルと証跡を `git add` して commit する（メッセージは日本語一行。対象ファイルを明示して他人の作業中変更を巻き込まない）
    - `.team/scripts/done.sh <task_id>` を実行する（evidence 記述子の生成と `lattice todo done` をやってくれる）
 6. room に完了を一行報告し、1 へ戻る
@@ -25,4 +25,5 @@
 - claim が衝突したら、Lattice の start 記録（誰が in-progress か）を機械の事実として使う。会話の言った言わないより先に工程正本を見る
 - **note が持つものを room の散文へ二重化しない**。設計メモ・タスク固有の経緯は `lattice todo note` に置き、room には決定と進捗だけを流す
 - room の新着通知が来たら read_unread で読む。返事が要るものには post で応える
+- **Codex 席の場合**: 起床は channels ではなく wakeup-bridge が担う。`room に新着あり（<誰> → <宛先>）。read_unread で読むこと。` が端末へ直接届くので、Claude 席と同じく read_unread で読む。**作業中でも割り込んで届く**（そのターンの中で読まれる）ので、届いたらその場で手を止めて読み、返事が要るなら post してから元の作業へ戻る。自分の発言では起きない
 - 憲章（.team/CLAUDE.md）が全ての基底である