peertable 0.8.54 → 0.8.56

package/skill/scripts/launch-seat.test.mjs

@@ -0,0 +1,159 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { EventEmitter } from 'node:events'
+import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, existsSync, rmSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { launchSeat } from './launch-seat.mjs'
+import { runScript } from './project-scaffold.mjs'
+
+function fixture(t, harness = 'claude') {
+  const project = mkdtempSync(join(tmpdir(), 'peertable-launch-'))
+  t.after(() => rmSync(project, { recursive: true, force: true }))
+  mkdirSync(join(project, '.team'))
+  writeFileSync(join(project, '.mcp.json'), JSON.stringify({ mcpServers: { room: { command: 'node' }, other: { command: 'other' } } }))
+  writeFileSync(join(project, '.team', 'setup-state.json'), JSON.stringify({ room: 'room', server_url: 'http://example', mode: 'standalone' }))
+  const events = []
+  const member = { name: 'alice', harness, model: 'fixture-model', roles: ['実装者'], aiterm_session_id: 'peer-alice', pid: 23 }
+  const options = { project, name: 'alice', roles: '実装者', brief: '着任してください' }
+  const dependencies = {
+    resolveCommand: (command, argv) => ({ command, argv }),
+    runScript: (file, args) => {
+      events.push({ file, args })
+      if (file === 'resolve-seat-placement.mjs') return JSON.stringify({ settings: { model: 'fixture-model', harness, effort: 'high' }, roles: ['実装者'] })
+      return '/資格path'
+    },
+    execFileSync: () => { events.push({ preflight: true }) },
+    leaveSeat: async (_project, _name, rollback) => { events.push({ leave: true, rollback: Boolean(rollback) }) },
+    ensureProjectRuntime: async () => { events.push({ runtime: true }) },
+    spawn: (executable, args) => {
+      events.push({ wait: { executable, args } })
+      const waiter = new EventEmitter()
+      waiter.unref = () => {}
+      return waiter
+    },
+    api: { members: async () => [member], request: async (path, options) => { events.push({ path, options }) } },
+    aiterm: {
+      sessions: async () => [],
+      observe: async () => ({ state: 'busy', exists: true, harness_alive: true, process_identity: { pid: 23, started_identity: 'native-start', argv_digest: 'digest' }, observed_at: 'now' }),
+      structured: async (tool, args) => {
+        events.push({ tool, args })
+        if (tool === 'agent_launch') return { session_id: 'peer-alice', startup: { status: 'ready' } }
+        if (tool === 'agent_approval') return { status: 'none' }
+        if (tool === 'pty_send') return { mode: 'agent_dispatch', event_cursor: 0, submit_residue: false, wait_process: { executable: 'opaque-waiter', args: ['opaque-cursor'] } }
+        throw new Error(`予期しないAPI: ${tool}`)
+      },
+    },
+  }
+  return { options, dependencies, events, member }
+}
+
+test('起動準備・登録・runtimeの成立後に長い日本語briefを一度だけ公開APIへ渡す', async t => {
+  const f = fixture(t)
+  f.options.brief = '長い着任指示。'.repeat(2000)
+  const result = await launchSeat(f.options, f.dependencies)
+  assert.equal(result.status, 'ready')
+  assert.equal(result.turn_started, true)
+  const sent = f.events.filter(event => event.tool === 'pty_send')
+  assert.equal(sent.length, 1)
+  assert.equal(sent[0].args.text, f.options.brief)
+  assert.ok(f.events.findIndex(event => event.runtime) < f.events.indexOf(sent[0]))
+  const launch = f.events.find(event => event.tool === 'agent_launch')
+  assert.equal(launch.args.trust_project, true)
+  assert.equal(Object.hasOwn(launch.args, 'prompt'), false)
+  assert.equal(launch.args.env_vars.includes('PEERTABLE_POST_TOKEN'), false)
+  assert.deepEqual(f.events.find(event => event.wait).wait, { executable: 'opaque-waiter', args: ['opaque-cursor'] })
+})
+
+test('モデル実測失敗とサイズ超過は既存席へ触らない', async t => {
+  const f = fixture(t)
+  f.dependencies.execFileSync = () => { throw new Error('モデル利用不可') }
+  await assert.rejects(launchSeat(f.options, f.dependencies), /モデル利用不可/)
+  assert.equal(f.events.some(event => event.leave), false)
+  f.events.length = 0
+  await assert.rejects(launchSeat({ ...f.options, brief: 'あ'.repeat(22000) }, f.dependencies), { code: 'LAUNCH_BRIEF_TOO_LONG' })
+  assert.equal(f.events.length, 0)
+})
+
+test('起動未確認と別sessionの応答ではbriefを送らず撤去する', async t => {
+  for (const receipt of [{ session_id: 'peer-alice', startup: { status: 'not_checked' } }, { session_id: 'other', startup: { status: 'ready' } }]) {
+    const f = fixture(t)
+    f.dependencies.aiterm.structured = async (tool) => {
+      assert.equal(tool, 'agent_launch')
+      return receipt
+    }
+    await assert.rejects(launchSeat(f.options, f.dependencies), { code: 'SEAT_STARTUP_NOT_READY' })
+    assert.equal(f.events.filter(event => event.rollback).length, 1)
+  }
+})
+
+test('送信後の不成立は再送せず、撤去失敗も消さず返す', async t => {
+  const f = fixture(t)
+  const structured = f.dependencies.aiterm.structured
+  f.dependencies.aiterm.structured = async (tool, args) => tool === 'pty_send'
+    ? { ...await structured(tool, args), submit_residue: true } : structured(tool, args)
+  f.dependencies.leaveSeat = async (_project, _name, rollback) => { if (rollback) throw new Error('公開停止失敗') }
+  await assert.rejects(launchSeat(f.options, f.dependencies), error => error instanceof AggregateError && /公開停止失敗/.test(error.message))
+  assert.equal(f.events.filter(event => event.tool === 'pty_send').length, 1)
+})
+
+test('room台帳が不完全なら起動済みとして報告しない', async t => {
+  const f = fixture(t)
+  delete f.member.pid
+  f.options.brief = ''
+  await assert.rejects(launchSeat(f.options, f.dependencies), { code: 'SEAT_LEDGER_INCOMPLETE' })
+  assert.equal(f.events.filter(event => event.rollback).length, 1)
+})
+test('TUI準備完了でもroom未登録なら成功せず撤去する', async t => {
+  const f = fixture(t)
+  t.mock.timers.enable({ apis: ['Date'] })
+  f.dependencies.api.members = async () => {
+    t.mock.timers.tick(90_001)
+    return []
+  }
+  await assert.rejects(launchSeat(f.options, f.dependencies), { code: 'SEAT_ROOM_MCP_NOT_READY' })
+  assert.equal(f.events.filter(event => event.rollback).length, 1)
+  assert.equal(f.events.some(event => event.tool === 'pty_send'), false)
+})
+test('Lattice併用の席identityとactorを公開launcherのenvへ明示する', async t => {
+  const f = fixture(t)
+  writeFileSync(join(f.options.project, '.team', 'setup-state.json'), JSON.stringify({ room: 'room', server_url: 'http://example', mode: 'lattice', plan_key: 'plan' }))
+  f.dependencies.ensureProjectRuntime = async (_project, { env }) => {
+    assert.equal(env.PEERTABLE_PLAN, 'plan')
+    assert.equal(env.LATTICE_TODO_ACTOR_SESSION, 'alice')
+    assert.equal(env.LATTICE_TODO_ACTOR_AGENT, 'alice')
+    assert.ok(env.LATTICE_TODO_ACTOR_HOST)
+  }
+  await launchSeat(f.options, f.dependencies)
+  const keys = f.events.find(event => event.tool === 'agent_launch').args.env_vars
+  for (const key of ['PEERTABLE_MEMBER', 'PEERTABLE_PLAN', 'LATTICE_CLI', 'LATTICE_TODO_ACTOR_HOST', 'LATTICE_TODO_ACTOR_SESSION', 'LATTICE_TODO_ACTOR_AGENT']) assert.ok(keys.includes(key), key)
+})
+test('CodexとGrokは席専用homeへ設定し、共有設定を保つ', async t => {
+  for (const harness of ['codex', 'grok']) {
+    const f = fixture(t, harness)
+    const home = join(f.options.project, 'fixture-home')
+    const shared = join(home, `.${harness}`)
+    mkdirSync(shared, { recursive: true })
+    writeFileSync(join(shared, 'auth.json'), '{"fixture":"auth"}')
+    writeFileSync(join(shared, 'config.toml'), 'model = "shared-config"\n')
+    f.dependencies.home = home
+    const script = f.dependencies.runScript
+    f.dependencies.runScript = (file, args, options) => ['grok-seat-config.mjs', 'ensure-codex-room-mcp.mjs'].includes(file)
+      ? runScript(file, args, options) : script(file, args, options)
+    let preflightHome
+    f.dependencies.execFileSync = (_command, _args, options) => {
+      if (harness !== 'grok') return
+      preflightHome = options.env.GROK_HOME
+      assert.notEqual(preflightHome, shared)
+      assert.equal(readFileSync(join(preflightHome, 'auth.json'), 'utf8'), '{"fixture":"auth"}')
+      assert.doesNotMatch(readFileSync(join(preflightHome, 'config.toml'), 'utf8'), /shared-config/)
+    }
+    await launchSeat(f.options, f.dependencies)
+    assert.equal(readFileSync(join(shared, 'config.toml'), 'utf8'), 'model = "shared-config"\n')
+    const privateHome = join(f.options.project, '.team', 'seats', harness === 'grok' ? 'alice.grok-home' : 'alice.codex')
+    assert.equal(readFileSync(join(privateHome, 'auth.json'), 'utf8'), '{"fixture":"auth"}')
+    assert.doesNotMatch(readFileSync(join(privateHome, 'config.toml'), 'utf8'), /shared-config/)
+    if (preflightHome) assert.equal(existsSync(preflightHome), false)
+    assert.ok(f.events.find(event => event.tool === 'agent_launch').args.env_vars.includes(harness === 'grok' ? 'GROK_HOME' : 'CODEX_HOME'))
+  }
+})

package/skill/scripts/leave-seat.mjs

@@ -0,0 +1,42 @@
+// 席の停止を公開APIで確かめてから、Peertableの登録とcredentialを撤去する。
+import { existsSync, rmSync } from 'node:fs'
+import { join } from 'node:path'
+import { AitermClient } from './aiterm-client.mjs'
+import { RoomApi } from './room-api.mjs'
+import { findSeatSession } from './seat-session.mjs'
+import { projectPath, readSetup, runScript, fail } from './project-scaffold.mjs'
+
+export async function leaveSeat(project, name, { aiterm, api, credentialCommand = runScript } = {}) {
+  if (!name || !/^[A-Za-z0-9._:-]+$/.test(name)) fail('SEAT_LEAVE_ARGS_INVALID', 'member名に使えない文字があります')
+  project = projectPath(project)
+  const state = readSetup(project)
+  const env = { ...process.env }
+  delete env.PEERTABLE_POST_TOKEN
+  const credential = args => credentialCommand('seat-credential.mjs', args, { env }).trim()
+  let file = credential(['path', project, state.room, name])
+  if (!existsSync(file)) file = credential(['prepare', project, state.room, name])
+  api ??= new RoomApi(state, { credential: file })
+  const ownAiterm = !aiterm
+  aiterm ??= new AitermClient({ env })
+  try {
+    const member = (await api.members()).find(item => item.name === name)
+    const sessions = await aiterm.sessions(['PEERTABLE_MEMBER', 'PEERTABLE_ROOM'])
+    // 台帳が消えた直後の再実行でも、同じroomの残存席を公開環境情報で特定する。
+    const session = member
+      ? findSeatSession(member, sessions, state.room)
+      : sessions.find(item => item.environment?.PEERTABLE_MEMBER === name && item.environment?.PEERTABLE_ROOM === state.room)
+    if (session) {
+      await aiterm.call('pty_close', { session_id: session.session_id })
+      if ((await aiterm.sessions()).some(item => item.session_id === session.session_id)) {
+        fail('SEAT_LEAVE_SESSION_FAILED', `${session.session_id} が停止後も残っています`)
+      }
+    }
+    await api.request(`members/${encodeURIComponent(name)}`, { method: 'DELETE' })
+    if ((await api.members()).some(item => item.name === name)) fail('SEAT_LEAVE_MEMBER_FAILED', `${name} の登録が残っています`)
+    for (const suffix of ['.grok-home', '.codex']) rmSync(join(project, '.team', 'seats', name + suffix), { recursive: true, force: true })
+    credential(['remove', project, file])
+    return { schema: 'peertable.seat-leave.v1', status: 'left', member: name, session_id: session?.session_id ?? null }
+  } finally {
+    if (ownAiterm) await aiterm.close()
+  }
+}

package/skill/scripts/leave-seat.sh

@@ -1,93 +1,4 @@
 #!/bin/bash
-# 1席だけを通常退席させ、runtime credentialまで同じ境界で撤去する。
-# usage: leave-seat.sh <project_dir> <member>
-set -u
-
-unset PEERTABLE_POST_TOKEN
-proj="${1:-}"
-name="${2:-}"
-[ -n "$proj" ] && [ -n "$name" ] || {
-  echo "SEAT_LEAVE_ARGS_INVALID: leave-seat.sh <project_dir> <member>" >&2
-  exit 2
-}
-case "$name" in
-  *[!A-Za-z0-9._:-]*) echo "SEAT_LEAVE_ARGS_INVALID: member名に使えない文字がある" >&2; exit 2 ;;
-esac
-
-script_dir=$(cd "$(dirname "$0")" && pwd -P)
-# shellcheck disable=SC1091
-. "$script_dir/tmux-at.bash"
-credential_helper="${PEERTABLE_CREDENTIAL_HELPER:-$script_dir/seat-credential.mjs}"
-state="$proj/.team/setup-state.json"
-[ -f "$state" ] || { echo "SEAT_LEAVE_STATE_MISSING: $state" >&2; exit 1; }
-read -r room url <<EOF
-$(python3 -c "import json;d=json.load(open('$state'));print(d['room'],d['server_url'])")
-EOF
-
-credential_file=$(env -u PEERTABLE_POST_TOKEN node "$credential_helper" path "$proj" "$room" "$name") || exit 1
-# 旧席などでcredentialだけ欠けている時は、sessionを止める前に復元する。
-# ここで失敗すれば席は生きたままなので、member登録だけ残る半退席を作らない。
-if [ ! -r "$credential_file" ] || [ ! -s "$credential_file" ]; then
-  credential_file=$(env -u PEERTABLE_POST_TOKEN node "$credential_helper" prepare "$proj" "$room" "$name") || {
-    echo "SEAT_LEAVE_CREDENTIAL_PREPARE_FAILED: $name" >&2
-    exit 1
-  }
-fi
-default_socket=$(node "$script_dir/tmux-socket.mjs" 2>/dev/null || true)
-members=$(curl -sf "$url/api/$room/members" 2>/dev/null || true)
-read -r member_socket target <<EOF
-$(python3 - "$name" "$default_socket" "$members" <<'PY'
-import json, sys
-name, default_socket, raw = sys.argv[1:4]
-try:
-    member = next((x for x in json.loads(raw).get('members', []) if x.get('name') == name), {})
-except Exception:
-    member = {}
-observe = member.get('observe') or {}
-print(observe.get('tmux_socket') or default_socket, observe.get('tmux_target') or f'peer-{name}')
-PY
-)
-EOF
-
-failed=0
-if tmux_at has-session -t "$target" 2>/dev/null; then
-  if ! tmux_at kill-session -t "$target"; then
-    echo "SEAT_LEAVE_SESSION_FAILED: $target" >&2
-    failed=1
-  elif tmux_at has-session -t "$target" 2>/dev/null; then
-    echo "SEAT_LEAVE_SESSION_FAILED: $target が撤去後も残っている" >&2
-    failed=1
-  fi
-elif tmux_at list-sessions >/dev/null 2>&1; then
-  : # serverへ到達でき、対象sessionが無い
-elif [ -n "${member_socket:-}" ] && [ ! -S "${member_socket}" ]; then
-  # socketファイル自体が消えている＝tmux serverごと死んでいる（OS再起動等）。
-  # 席のprocessは存在しえないので「畳めない」ではなく「畳む対象が無い」が正
-  # （実被弾 2026-08-29: Mac再起動後のresumeが全席でここに落ちて再起動できなかった）
-  echo "SEAT_LEAVE_SESSION_GONE: tmux socket消失（${member_socket}）。畳む対象なしとして続行" >&2
-else
-  echo "SEAT_LEAVE_SESSION_UNREADABLE: ${member_socket:-tmux}" >&2
-  failed=1
-fi
-
-# live clientを止めたと確認できない時は、member/identity/credentialを先に消して
-# 「退席済み」に見せない。観測面を残したままtyped failureで止める。
-[ "$failed" -eq 0 ] || exit 1
-
-encoded_name=$(python3 -c 'import sys,urllib.parse;print(urllib.parse.quote(sys.argv[1],safe=""))' "$name")
-if ! env -u PEERTABLE_POST_TOKEN node "$credential_helper" request "$credential_file" DELETE \
-  "$url/api/$room/members/$encoded_name" >/dev/null; then
-  echo "SEAT_LEAVE_MEMBER_FAILED: $name" >&2
-  failed=1
-fi
-
-# 席の本人性は台帳の member 行が持つ（席file廃止 2026-08-22）。上の member DELETE が identity も撤去する
-rm -rf "$proj/.team/seats/${name}.grok-home"
-rm -rf "$proj/.team/seats/${name}.codex"
-if ! env -u PEERTABLE_POST_TOKEN node "$credential_helper" remove "$proj" "$credential_file"; then
-  echo "SEAT_LEAVE_CREDENTIAL_FAILED: $name" >&2
-  failed=1
-fi
-
-[ "$failed" -eq 0 ] || exit 1
-echo "SEAT_LEAVE_OK: ${name}（session / room member / seat identity / credential を撤去）"
+# 既存の引数を共通の製品入口へ渡す。
+set -euo pipefail
+exec node "$(dirname "$0")/legacy-entry.mjs" leave-seat "$@"

package/skill/scripts/leave-seat.test.mjs

@@ -0,0 +1,53 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync, existsSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { leaveSeat } from './leave-seat.mjs'
+
+function fixture(t, failure) {
+  const project = mkdtempSync(join(tmpdir(), 'peertable-leave-'))
+  t.after(() => rmSync(project, { recursive: true, force: true }))
+  mkdirSync(join(project, '.team', 'seats', 'alice.grok-home'), { recursive: true })
+  writeFileSync(join(project, '.team', 'setup-state.json'), JSON.stringify({ room: 'room-a', server_url: 'http://localhost', mode: 'standalone' }))
+  const token = join(project, '.team', 'token')
+  writeFileSync(token, 'test')
+  const events = []
+  let members = [{ name: 'alice', aiterm_session_id: 'seat-a' }]
+  let sessions = [{ session_id: 'seat-a', environment: { PEERTABLE_MEMBER: 'alice', PEERTABLE_ROOM: 'room-a' } }, { session_id: 'other', environment: { PEERTABLE_MEMBER: 'bob', PEERTABLE_ROOM: 'room-b' } }]
+  const api = {
+    members: async () => members,
+    request: async (path, options) => { events.push(options.method); members = []; return {} },
+  }
+  const aiterm = {
+    sessions: async () => { if (failure === 'list') throw new Error('API停止'); return sessions },
+    call: async (tool, args) => { events.push(tool); if (failure === 'close') throw new Error('停止失敗'); sessions = sessions.filter(item => item.session_id !== args.session_id) },
+  }
+  const credentialCommand = (_script, args) => { if (args[0] === 'remove') { events.push('credential-remove'); rmSync(token) }; return token }
+  return { project, token, events, api, aiterm, credentialCommand, sessions: () => sessions, members: () => members }
+}
+
+test('公開APIで停止を確認してから登録と秘密を消し、他のroomを保つ', async t => {
+  const f = fixture(t)
+  const result = await leaveSeat(f.project, 'alice', f)
+  assert.equal(result.status, 'left')
+  assert.deepEqual(f.events, ['pty_close', 'DELETE', 'credential-remove'])
+  assert.deepEqual(f.sessions().map(item => item.session_id), ['other'])
+  assert.equal(existsSync(f.token), false)
+  assert.equal(existsSync(join(f.project, '.team', 'seats', 'alice.grok-home')), false)
+})
+
+for (const failure of ['list', 'close']) test(`Aitermの${failure}失敗では登録とcredentialを保つ`, async t => {
+  const f = fixture(t, failure)
+  await assert.rejects(leaveSeat(f.project, 'alice', f))
+  assert.equal(f.members().length, 1)
+  assert.equal(existsSync(f.token), true)
+  assert.equal(f.events.includes('DELETE'), false)
+})
+
+test('同じ識別子でも別roomの席は停止しない', async t => {
+  const f = fixture(t)
+  f.sessions()[0].environment.PEERTABLE_ROOM = 'another-room'
+  await assert.rejects(leaveSeat(f.project, 'alice', f), { code: 'PEERTABLE_SEAT_SESSION_IDENTITY_CONFLICT' })
+  assert.deepEqual(f.events, [])
+})

package/skill/scripts/legacy-entry.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+// 既存のshell入口は引数だけを翻訳し、処理順序を共通CLIへ集める。
+const [entry, ...args] = process.argv.slice(2)
+let command = entry
+let translated = args
+if (entry === 'setup') {
+  const [project, room, url, plan, _legacyRoot, ...tail] = args
+  translated = [project, '--room', room, '--url', url]
+  if (plan && plan !== '-') translated.push('--plan', plan)
+  if (tail[0] && !tail[0].startsWith('--')) {
+    const tasks = tail.shift()
+    if (tasks !== '-') translated.push('--tasks', tasks)
+  }
+  translated.push(...tail)
+} else if (entry === 'launch-seat') {
+  command = 'launch'
+  const [project, name, ...tail] = args
+  translated = [project, name]
+  let roles = false
+  while (tail.length) {
+    const arg = tail.shift()
+    if (arg.startsWith('--')) {
+      const value = tail.shift()
+      translated.push(arg, value)
+      if (arg === '--roles') roles = true
+    } else if (!roles) { translated.push('--roles', arg); roles = true }
+    else translated.push('--brief', arg)
+  }
+} else if (entry === 'leave-seat') command = 'leave'
+else if (entry === 'change-seat') command = 'change'
+else if (entry === 'doctor') command = 'diagnostics'
+process.argv = [process.execPath, new URL('./cli.mjs', import.meta.url).pathname, command, ...translated]
+await import('./cli.mjs')

package/skill/scripts/platform/windows/resolve-lattice-command.mjs

@@ -1,9 +1,20 @@
+import { existsSync } from 'node:fs'
+import { win32 } from 'node:path'
+
 export function resolveWindowsCommand(cli, argv, {
   platform = process.platform,
-  exists,
+  exists = existsSync,
+  pathEnv = process.env.PATH ?? '',
   pwsh = 'pwsh.exe',
 } = {}) {
   if (platform !== 'win32') return { command: cli, argv }
+  if (!/[\\/]/u.test(cli)) {
+    for (const directory of pathEnv.split(';').filter(Boolean)) {
+      const candidates = /\.(?:exe|ps1|cmd|bat)$/iu.test(cli) ? [cli] : [`${cli}.exe`, `${cli}.ps1`]
+      const found = candidates.map(name => win32.join(directory, name)).find(exists)
+      if (found) { cli = found; break }
+    }
+  }
   const lower = cli.toLowerCase()
   if (lower.endsWith('.exe')) return { command: cli, argv }
 

package/skill/scripts/project-runtime.mjs

@@ -0,0 +1,95 @@
+// setup/resumeは、対象projectの生成物更新とruntimeの確認までを連続して行う。
+import { join } from 'node:path'
+import { AitermClient } from './aiterm-client.mjs'
+import { RoomApi } from './room-api.mjs'
+import { findSeatSession, seatSessionId } from './seat-session.mjs'
+import { scaffoldProject, ensureProjectRoomMcp, projectPath, readSetup, runScript, writeJson, fail } from './project-scaffold.mjs'
+import { ensureProjectRuntime } from './ensure-project-runtime.mjs'
+
+const delay = ms => new Promise(resolve => setTimeout(resolve, ms))
+const targets = members => members.filter(member => member.delivery?.kind !== 'parent_watch' && (member.harness ?? member.vendor) && seatSessionId(member))
+
+export async function seatsToResume(aiterm, members, sessions, room) {
+  const relaunch = []
+  for (const member of members) {
+    if (member.delivery?.kind === 'parent_watch' || !(member.harness ?? member.vendor)) continue
+    const session = findSeatSession(member, sessions, room)
+    if (session) {
+      const observation = await aiterm.observe(session.session_id)
+      if (observation.harness_alive === true && !['dead', 'missing'].includes(observation.state)) continue
+      if (observation.exists && observation.harness_alive !== false && !['dead', 'missing'].includes(observation.state)) {
+        fail('RESUME_MEMBER_OBSERVATION_UNKNOWN', `${member.name}: ${observation.reason}`)
+      }
+    }
+    if (!member.roles?.length) fail('RESUME_MEMBER_ROLES_MISSING', `${member.name} の役割がありません`)
+    relaunch.push(member)
+  }
+  return relaunch
+}
+
+export async function verifyProjectRuntime(api, { probe = true, heartbeatTimeout = 90_000, probeTimeout = 120_000 } = {}) {
+  let members
+  const deadline = Date.now() + heartbeatTimeout
+  for (;;) {
+    members = targets(await api.members())
+    const pending = members.filter(member => member.status_reason !== 'fresh')
+    if (!pending.length) break
+    if (Date.now() >= deadline) fail('RESUME_HEARTBEAT_STALE', pending.map(member => `${member.name}(${member.status_reason})`).join(', '))
+    await delay(3000)
+  }
+  if (!probe || !members.length) return { heartbeat: members.length, probe: probe ? 'no_targets' : 'disabled' }
+  const names = members.map(member => member.name)
+  const saved = await api.request('messages', { method: 'POST', body: {
+    from: 'resume', to: names.length === 1 ? names[0] : names,
+    body: '[resume-probe] 配達経路の確認。応答不要・読み流してよい。',
+  } })
+  const probeDeadline = Date.now() + probeTimeout
+  for (;;) {
+    const { delivery } = await api.request(`deliveries?seq=${saved.seq}`)
+    const pending = names.filter(name => delivery?.[name]?.state !== 'delivered')
+    if (!pending.length) return { heartbeat: members.length, probe: 'delivered', seq: saved.seq }
+    if (Date.now() >= probeDeadline) fail('RESUME_PROBE_UNDELIVERED', pending.map(name => `${name}=${delivery?.[name]?.state ?? 'unknown'}`).join(', '))
+    await delay(3000)
+  }
+}
+
+export async function setupProject(options) {
+  const project = projectPath(options.project)
+  const aiterm = new AitermClient()
+  try {
+    // 公開依存の不足は、projectへ生成物を置く前に明示する。
+    await aiterm.sessions()
+    const scaffold = scaffoldProject({ ...options, project })
+    if (scaffold.action === 'resume') return await resumeProject({ ...options, project }, { aiterm })
+    const runtime = await ensureProjectRuntime(project, { aiterm })
+    return { schema: 'peertable.setup-result.v1', status: 'ready', project, room: readSetup(project).room, runtime }
+  } finally { await aiterm.close() }
+}
+
+export async function resumeProject(options, dependencies = {}) {
+  const project = projectPath(options.project)
+  let state = readSetup(project)
+  const aiterm = dependencies.aiterm ?? new AitermClient()
+  try {
+    const sessions = await aiterm.sessions(['PEERTABLE_MEMBER', 'PEERTABLE_ROOM'])
+    const credential = runScript('seat-credential.mjs', ['prepare', project, state.room, 'runtime'])
+    const api = new RoomApi(state, { credential })
+    const members = await api.members()
+    const relaunch = await seatsToResume(aiterm, members, sessions, state.room)
+    ensureProjectRoomMcp(project, state)
+    if (options.plan) {
+      state = { ...state, mode: 'lattice', plan_key: options.plan, phases: options.phases ?? [] }
+      writeJson(join(project, '.team', 'setup-state.json'), state)
+      runScript('external-pane.mjs', [project, state.room, process.env.PEERTABLE_PUBLIC_URL || state.public_url || state.server_url])
+    }
+    runScript('upgrade-team-assets.mjs', [project])
+    for (const member of relaunch) {
+      const { launchSeat } = await import('./launch-seat.mjs')
+      await launchSeat({ project, name: member.name, roles: member.roles.join(','), harness: member.harness ?? member.vendor,
+        model: member.model, effort: member.effort, mission: member.mission })
+    }
+    const runtime = await ensureProjectRuntime(project, { aiterm, env: { ...process.env, PEERTABLE_CREDENTIAL_FILE: credential } })
+    const verified = await verifyProjectRuntime(api, { probe: options.probe !== false })
+    return { schema: 'peertable.resume-result.v1', status: 'ready', project, room: state.room, relaunched: relaunch.map(member => member.name), runtime, verified }
+  } finally { if (!dependencies.aiterm) await aiterm.close() }
+}

package/skill/scripts/project-runtime.test.mjs

@@ -0,0 +1,29 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { seatsToResume, verifyProjectRuntime } from './project-runtime.mjs'
+
+const member = { name: 'alice', harness: 'codex', aiterm_session_id: 'seat', roles: ['実装者'] }
+const sessions = [{ session_id: 'seat', environment: { PEERTABLE_MEMBER: 'alice', PEERTABLE_ROOM: 'room' } }]
+test('sessionが残っていてもharness死亡なら復帰し、生存席は保つ', async () => {
+  for (const [state, alive, count] of [['dead', false, 1], ['idle', true, 0], ['busy', true, 0]]) {
+    const aiterm = { observe: async () => ({ exists: true, state, harness_alive: alive }) }
+    assert.equal((await seatsToResume(aiterm, [member], sessions, 'room')).length, count)
+  }
+  assert.deepEqual(await seatsToResume({}, [member], [], 'room'), [member])
+})
+test('判定不能と役割不足は副作用前に明示し、親は復帰対象にしない', async () => {
+  const aiterm = { observe: async () => ({ exists: true, state: 'unknown', harness_alive: null, reason: 'harness_process_unresolved' }) }
+  await assert.rejects(seatsToResume(aiterm, [member], sessions, 'room'), { code: 'RESUME_MEMBER_OBSERVATION_UNKNOWN' })
+  await assert.rejects(seatsToResume({}, [{ ...member, roles: [] }], [], 'room'), { code: 'RESUME_MEMBER_ROLES_MISSING' })
+  assert.deepEqual(await seatsToResume({}, [{ ...member, delivery: { kind: 'parent_watch' } }], [], 'room'), [])
+})
+test('fresh heartbeatと宛先別deliveredを読んで再開の配達を確認する', async () => {
+  const calls = []
+  const api = { members: async () => [{ ...member, status_reason: 'fresh' }], request: async (path, options) => {
+    calls.push({ path, options })
+    return path === 'messages' ? { seq: 7 } : { delivery: { alice: { state: 'delivered' } } }
+  } }
+  assert.deepEqual(await verifyProjectRuntime(api), { heartbeat: 1, probe: 'delivered', seq: 7 })
+  assert.equal(calls[0].options.body.to, 'alice')
+  assert.equal(calls[1].path, 'deliveries?seq=7')
+})