peertable 0.8.55 → 0.8.57

package/skill/scripts/change-seat.sh

@@ -1,277 +1,4 @@
 #!/bin/bash
-# 席の harness / model / effort を変更する。
-# usage: change-seat.sh <project_dir> <member> [--harness <harness>] [--model <model>] [--effort <effort>] [--parent <name>] [--reason <text>]
-#
-# **自然文の依頼を再解釈しない。** 依頼の意味・本人の意図・変更してよい局面を判断するのは親である AI で、
-# この script が受け取るのは親が確定した target だけである（旧 change-effort.sh の
-# 「本人→親の単独DMが `[effort変更依頼] <level>` と完全一致すること」という機械判定は廃止した。
-# 明確な自然文の依頼を、同じ文面の再送を求めて拒否していたため）。
-# この script が持つのは、親には出来ない外部境界の仕事だけである:
-#   現在の素性の取得 / target の live catalog 検証 / 同値no-op / busy保護 / 再起動 /
-#   metadata の読み返し / room 履歴 / 失敗時の旧設定への1回だけの明示rollback。
-#
-# 会話contextは引き継がない。作業状態はroomログ・工程正本・gitから再着任で回収する。
-set -eu
-
-# token値はこの制御processや再起動する席へ継承しない。launch後のroom記録も席別file経由で行う。
-unset PEERTABLE_POST_TOKEN
-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}"
-
-proj="${1:-}"; name="${2:-}"
-shift 2 2>/dev/null || true
-opt_harness=""; opt_model=""; opt_effort=""; parent="bell"; reason=""
-while [ $# -gt 0 ]; do
-  case "$1" in
-    --harness|--vendor) opt_harness="${2:-}"; shift 2 || true ;;  # --vendor は旧名互換
-    --model)  opt_model="${2:-}";  shift 2 || true ;;
-    --effort) opt_effort="${2:-}"; shift 2 || true ;;
-    --parent) parent="${2:-}";     shift 2 || true ;;
-    --reason) reason="${2:-}";     shift 2 || true ;;
-    *) echo "SEAT_CHANGE_ARGS_INVALID: 不明な引数 $1" >&2; exit 2 ;;
-  esac
-done
-[ -n "$proj" ] && [ -n "$name" ] || {
-  echo "SEAT_CHANGE_ARGS_INVALID: usage: change-seat.sh <project_dir> <member> [--harness <harness>] [--model <model>] [--effort <effort>] [--parent <name>] [--reason <text>]" >&2
-  exit 2
-}
-[ -n "$opt_model" ] || [ -n "$opt_effort" ] || {
-  echo "SEAT_CHANGE_ARGS_INVALID: --model と --effort の少なくとも一方が要る" >&2; exit 2
-}
-case "$name:$parent" in
-  *[!A-Za-z0-9._:-]*) echo "SEAT_CHANGE_ARGS_INVALID: member/parent名に使えない文字がある" >&2; exit 2 ;;
-esac
-
-state="$proj/.team/setup-state.json"
-[ -f "$state" ] || { echo "SEAT_CHANGE_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
-
-members=$(curl -sf "$url/api/$room/members") || {
-  echo "SEAT_CHANGE_ROOM_UNREACHABLE: membersを読めない" >&2; exit 1;
-}
-meta=$(printf '%s' "$members" | python3 -c '
-import json,sys
-name=sys.argv[1]
-member=next((m for m in json.load(sys.stdin).get("members",[]) if m.get("name")==name),None)
-if not member or (member.get("harness") or member.get("vendor")) not in ("claude","codex","grok") or not member.get("model"):
-    raise SystemExit(1)
-roles=member.get("roles") or []
-print("\t".join(((member.get("harness") or member.get("vendor")),member["model"],member.get("effort") or "",member.get("aiterm_session_id") or "",",".join(roles))))
-' "$name") || { echo "SEAT_CHANGE_MEMBER_METADATA_MISSING: ${name} のharness/modelが要る" >&2; exit 1; }
-IFS=$'\t' read -r old_harness old_model old_effort aiterm_session_id old_role <<EOF
-$meta
-EOF
-
-harness="${opt_harness:-$old_harness}"
-case "$harness" in
-  claude|codex|grok) ;;
-  *) echo "SEAT_CHANGE_HARNESS_UNSUPPORTED: harness=${harness}（claude / codex / grok のみ）" >&2; exit 2 ;;
-esac
-if [ "$harness" != "$old_harness" ] && { [ -z "$opt_model" ] || [ -z "$opt_effort" ]; }; then
-  echo "SEAT_CHANGE_ARGS_INVALID: harness変更には --model と --effort の明示指定が要る" >&2
-  exit 2
-fi
-model="${opt_model:-$old_model}"
-effort="${opt_effort:-$old_effort}"
-# effort を持たない席（CLI 既定で走っている席）へ model だけ渡すと、再起動で effort が確定してしまう。
-# 既定値をここへ埋めない——launch-seat.sh と同じく「席を立てる時に決める」（オーナー裁定）。
-[ -n "$effort" ] || {
-  echo "SEAT_CHANGE_EFFORT_UNKNOWN: ${name} の現在effortがmetadataに無い。--effort を明示する" >&2; exit 1
-}
-
-if [ "$model" = "$old_model" ] && [ "$effort" = "$old_effort" ] && [ "$harness" = "$old_harness" ]; then
-  echo "SEAT_CHANGE_NOOP: ${name} は既に model=${model} / effort=${effort}（再起動しない）"
-  exit 0
-fi
-
-sock="${PEERTABLE_TMUX_SOCKET:-${TMPDIR:-/tmp/}claude-tmux-sockets/claude.sock}"
-sess="peer-$name"
-tmux_at has-session -t "$sess" 2>/dev/null || {
-  echo "SEAT_CHANGE_SEAT_MISSING: ${sess}" >&2; exit 1;
-}
-screen=$(tmux_at capture-pane -t "$sess" -p -S -25 2>/dev/null) || {
-  echo "SEAT_CHANGE_SEAT_UNREADABLE: $sess" >&2; exit 1;
-}
-# busy の判定文字列は seat-status-bridge と同じ（Claude のステータス行にも Codex の `Working (…)` にも出る）
-case "$screen" in
-  *"esc to interrupt"*) echo "SEAT_CHANGE_SEAT_BUSY: ${sess} は処理中。本人がidleになってから再実行する" >&2; exit 1 ;;
-esac
-
-# target の検証は live 面だけを使い、古くなる hardcode を足さない。
-case "$harness" in
-  claude)
-    # Claude には非破壊で引ける model catalog が無い（`--help` の alias 例は catalog ではなく、
-    # 実際 2026-08-11 に `fable` は例に載ったまま live では unavailable だった）。
-    # よって **model 名は事前検証しない**——実 CLI の起動失敗と rollback が正式な検証境界である。
-    # effort は `--help` が live に列挙するので、そこから取る。
-    help_text=$(claude --help 2>/dev/null) || {
-      echo "SEAT_CHANGE_EFFORT_CATALOG_UNAVAILABLE: claude --help を読めない" >&2; exit 1;
-    }
-    levels=$(printf '%s' "$help_text" | python3 -c '
-import re,sys
-text=sys.stdin.read()
-i=text.find("--effort")
-m=re.search(r"\(([a-z0-9, ]+)\)", text[i:i+400]) if i>=0 else None
-if not m: raise SystemExit(1)
-print(" ".join(x.strip() for x in m.group(1).split(",") if x.strip()))
-') || {
-      echo "SEAT_CHANGE_EFFORT_CATALOG_UNAVAILABLE: claude --help が effort の水準を列挙しない" >&2; exit 1;
-    }
-    case " $levels " in
-      *" $effort "*) ;;
-      *) echo "SEAT_CHANGE_EFFORT_UNSUPPORTED: claude は effort=${effort} を提供していない（live: ${levels}）" >&2; exit 1 ;;
-    esac
-    ;;
-  codex)
-    catalog=$(codex debug models 2>/dev/null) || {
-      echo "SEAT_CHANGE_MODEL_CATALOG_UNAVAILABLE: codex debug models" >&2; exit 1;
-    }
-    verdict=$(printf '%s' "$catalog" | python3 -c '
-import json,sys
-model,effort=sys.argv[1:3]
-entry=next((m for m in json.load(sys.stdin).get("models",[]) if m.get("slug")==model),None)
-if entry is None:
-    print("model"); raise SystemExit(0)
-levels=[x.get("effort") for x in entry.get("supported_reasoning_levels",[])]
-print("ok" if effort in levels else "effort")
-' "$model" "$effort") || {
-      echo "SEAT_CHANGE_MODEL_CATALOG_UNAVAILABLE: codex debug models の出力を読めない" >&2; exit 1;
-    }
-    case "$verdict" in
-      model)  echo "SEAT_CHANGE_MODEL_UNSUPPORTED: codex catalog に model=${model} が無い" >&2; exit 1 ;;
-      effort) echo "SEAT_CHANGE_EFFORT_UNSUPPORTED: codex/${model} は effort=${effort} をcatalogで提供していない" >&2; exit 1 ;;
-    esac
-    ;;
-  grok)
-    catalog=$(grok models 2>/dev/null) || {
-      echo "SEAT_CHANGE_MODEL_CATALOG_UNAVAILABLE: grok models" >&2; exit 1;
-    }
-    if ! printf '%s' "$catalog" | python3 -c '
-import re,sys
-model=sys.argv[1]
-models=[]
-for line in sys.stdin:
-    match=re.match(r"^\s*[-*]\s+(\S+)", line)
-    if match: models.append(match.group(1))
-raise SystemExit(0 if model in models else 1)
-' "$model"; then
-      echo "SEAT_CHANGE_MODEL_UNSUPPORTED: grok catalog に model=${model} が無い" >&2
-      exit 1
-    fi
-    ;;
-esac
-
-changes=""
-[ "$harness" = "$old_harness" ] || changes="harness ${old_harness} → ${harness}"
-[ "$model" = "$old_model" ] || {
-  [ -z "$changes" ] || changes="$changes / "
-  changes="${changes}model ${old_model} → ${model}"
-}
-if [ "$effort" != "$old_effort" ]; then
-  [ -z "$changes" ] || changes="$changes / "
-  changes="${changes}effort ${old_effort:-default} → ${effort}"
-fi
-
-credential_file=$(env -u PEERTABLE_POST_TOKEN node "$credential_helper" path "$proj" "$room" "$name") || {
-  echo "SEAT_CHANGE_CREDENTIAL_MISSING: ${name} のroom credentialを特定できない" >&2; exit 1
-}
-
-if [ "$harness" = "$old_harness" ]; then
-  [ -n "$aiterm_session_id" ] || {
-    echo "SEAT_CHANGE_AITERM_SESSION_MISSING: ${name} にAiterm managed session_idが無い" >&2; exit 1
-  }
-  configure_args=("$aiterm_session_id")
-  [ -z "$opt_model" ] || configure_args+=(--model "$model")
-  [ -z "$opt_effort" ] || configure_args+=(--effort "$effort")
-  node "$script_dir/aiterm-configure.mjs" "${configure_args[@]}" >/dev/null || {
-    echo "SEAT_CHANGE_AITERM_CONFIGURE_FAILED: ${name} の設定は変更していない" >&2; exit 1
-  }
-  identity=$(python3 -c 'import json,sys;print(json.dumps({"name":sys.argv[1],"harness":sys.argv[2],"vendor":sys.argv[2],"model":sys.argv[3],"effort":sys.argv[4],"aiterm_session_id":sys.argv[5]}))' "$name" "$harness" "$model" "$effort" "$aiterm_session_id")
-  env -u PEERTABLE_POST_TOKEN node "$credential_helper" request "$credential_file" POST \
-    "$url/api/$room/members" "$identity" >/dev/null || {
-    echo "SEAT_CHANGE_CHANGED_BUT_METADATA_FAILED: ${name} は設定済み、room metadataを同期できない" >&2; exit 1
-  }
-  change_method="同一sessionを維持"
-else
-  leave="$script_dir/leave-seat.sh"
-  if ! "$leave" "$proj" "$name"; then
-    echo "SEAT_CHANGE_RESTART_PREPARE_FAILED: ${name} の旧席を安全に撤去できないため再起動しない" >&2
-    exit 1
-  fi
-  launch="$script_dir/launch-seat.sh"
-  [ -n "$old_role" ] || {
-    echo "SEAT_CHANGE_ROLE_MISSING: ${name} の role が無い（02_models の役割名が要る）" >&2
-    exit 1
-  }
-  brief="席設定が変更され（${changes}）、席を再起動しました。.team/roles/member.mdと工程正本・roomログから再着任し、進行中taskを続けてください。"
-  if ! "$launch" "$proj" "$name" --roles "$old_role" --model "$model" --effort "$effort" "$brief"; then
-    echo "SEAT_CHANGE_RESTART_FAILED: ${changes}。旧設定（harness=${old_harness} / model=${old_model} / effort=${old_effort:-default}）へrollbackする" >&2
-    rollback_brief="席設定の変更に失敗して旧設定へrollbackしました。.team/roles/member.mdと工程正本・roomログから再着任してください。"
-    if "$launch" "$proj" "$name" --roles "$old_role" --model "$old_model" --effort "$old_effort" "$rollback_brief"; then
-      echo "SEAT_CHANGE_ROLLED_BACK: ${name} は harness=${old_harness} / model=${old_model} / effort=${old_effort:-default} で再着席" >&2
-    else
-      echo "SEAT_CHANGE_ROLLBACK_FAILED: ${name} の席を手動で復旧する必要がある" >&2
-    fi
-    exit 1
-  fi
-  change_method="席を再起動"
-fi
-
-members_after=$(curl -sf "$url/api/$room/members") || {
-  echo "SEAT_CHANGE_CHANGED_BUT_UNVERIFIED: 席は再起動済み、membersを読めない" >&2; exit 1;
-}
-if ! printf '%s' "$members_after" | python3 -c '
-import json,sys
-name,harness,model,effort=sys.argv[1:5]
-m=next((m for m in json.load(sys.stdin).get("members",[]) if m.get("name")==name),{})
-raise SystemExit(0 if (m.get("harness") or m.get("vendor"))==harness and m.get("model")==model and m.get("effort")==effort else 1)
-' "$name" "$harness" "$model" "$effort"; then
-  echo "SEAT_CHANGE_CHANGED_BUT_UNVERIFIED: 席は再起動済み、member metadataが harness=${harness} / model=${model} / effort=${effort} でない" >&2
-  exit 1
-fi
-
-body="[席設定変更] ${parent} が ${name} の ${changes} に変更（${change_method}）"
-[ -z "$reason" ] || body="${body}。理由: ${reason}"
-history=$(node "$(dirname "$0")/post-message.mjs" --build-only "$parent" "$name" "$body")
-history_response=$(env -u PEERTABLE_POST_TOKEN node "$credential_helper" request "$credential_file" POST \
-  "$url/api/$room/messages" "$history") || {
-  echo "SEAT_CHANGE_CHANGED_BUT_HISTORY_FAILED: ${name} は ${changes} で再着席済み、room履歴の記録に失敗" >&2
-  exit 1
-}
-history_seq=$(printf '%s' "$history_response" | python3 -c '
-import json,sys
-try:
-    seq=json.load(sys.stdin).get("seq")
-except (ValueError, TypeError):
-    raise SystemExit(1)
-print(seq)
-raise SystemExit(0 if isinstance(seq, int) else 1)
-') || {
-  echo "SEAT_CHANGE_CHANGED_BUT_HISTORY_FAILED: ${name} は ${changes} で再着席済み、room履歴POST応答のseqを読めない" >&2
-  exit 1
-}
-
-messages_after=$(env -u PEERTABLE_POST_TOKEN node "$credential_helper" request "$credential_file" GET \
-  "$url/api/$room/messages") || {
-  echo "SEAT_CHANGE_CHANGED_BUT_HISTORY_FAILED: ${name} は ${changes} で再着席済み、room履歴を読み返せない" >&2
-  exit 1
-}
-if ! printf '%s' "$messages_after" | python3 -c '
-import json,sys
-seq,parent,name,body=sys.argv[1:5]
-try:
-    messages=json.load(sys.stdin).get("messages",[])
-except (ValueError, TypeError):
-    raise SystemExit(1)
-matched=next((m for m in messages if str(m.get("seq")) == seq), None)
-raise SystemExit(0 if matched and matched.get("from") == parent and matched.get("to") == name and matched.get("body") == body else 1)
-' "$history_seq" "$parent" "$name" "$body"; then
-  echo "SEAT_CHANGE_CHANGED_BUT_HISTORY_FAILED: ${name} は ${changes} で再着席済み、room履歴の読返しがtargetと一致しない" >&2
-  exit 1
-fi
-
-echo "SEAT_CHANGE_OK: ${name} ${changes}（parent=${parent}）"
+# 席変更は共通の公開API実装へ渡す。
+set -euo pipefail
+exec node "$(dirname "$0")/legacy-entry.mjs" change-seat "$@"

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

@@ -0,0 +1,129 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { changeSeat, validateTarget } from './change-seat.mjs'
+
+const catalog = { claude: '--effort <level> (low, medium, high, max)',
+  codex: JSON.stringify({ models: [{ slug: 'model-a', supported_reasoning_levels: [{ effort: 'high' }, { effort: 'max' }] }] }),
+  grok: 'Available models:\n  - grok-a\n  * grok-b (default)' }
+const catalogDependencies = { resolveCommand: (command, argv) => ({ command, argv }), execute: command => catalog[command] }
+
+function fixture(t) {
+  const project = mkdtempSync(join(tmpdir(), 'peertable-change-'))
+  t.after(() => rmSync(project, { recursive: true, force: true }))
+  mkdirSync(join(project, '.team'))
+  writeFileSync(join(project, '.team', 'setup-state.json'), JSON.stringify({ room: 'room', server_url: 'http://example', mode: 'standalone' }))
+  let member = { name: 'alice', harness: 'claude', vendor: 'claude', model: 'old', effort: 'high', roles: ['実装者'], mission: '使命', aiterm_session_id: 'seat' }
+  const events = [], messages = []
+  const observation = { exists: true, state: 'idle', harness_alive: true, process_identity: { pid: 42, started_identity: 'old-start' } }
+  const dependencies = { ...catalogDependencies,
+    runScript: () => '/資格path',
+    api: {
+      members: async () => [{ ...member }],
+      request: async (path, options = {}) => {
+        events.push({ path, options })
+        if (path === 'members') { member = { ...member, ...options.body }; return member }
+        if (options.method === 'POST') {
+          const message = { ...options.body, seq: messages.length + 1 }
+          messages.push(message)
+          return message
+        }
+        return { messages }
+      },
+    },
+    aiterm: {
+      observe: async () => observation,
+      structured: async (tool, args) => {
+        events.push({ tool, args })
+        return { session_id: args.session_id, model: args.model ?? member.model, reasoning_effort: args.reasoning_effort ?? member.effort }
+      },
+    },
+    launchSeat: async options => {
+      events.push({ launch: options })
+      member = { ...member, model: options.model, harness: options.harness, vendor: options.harness, effort: options.effort }
+    },
+  }
+  return { project, dependencies, events, messages, observation, member: () => member, options: { project, name: 'alice' } }
+}
+
+test('本人DMの定型検査をせず、model・effortの各変更を同じsessionへ渡し履歴を読む', async t => {
+  for (const target of [{ model: 'new' }, { effort: 'max' }, { model: 'new', effort: 'max' }]) {
+    const f = fixture(t)
+    const result = await changeSeat({ ...f.options, ...target, reason: '自然文の依頼を親が判断' }, f.dependencies)
+    assert.equal(result.status, 'changed')
+    assert.equal(f.events.filter(event => event.launch).length, 0)
+    assert.deepEqual(f.events.find(event => event.tool).args, { session_id: 'seat', ...(target.model ? { model: target.model } : {}), ...(target.effort ? { reasoning_effort: target.effort } : {}) })
+    assert.equal(f.member().model, target.model ?? 'old')
+    assert.equal(f.member().effort, target.effort ?? 'high')
+    assert.equal(f.messages.length, 1)
+    assert.match(f.messages[0].body, /自然文の依頼を親が判断/)
+  }
+})
+test('同値はAPI変更なし、busy・未知harnessは席を触らない', async t => {
+  const f = fixture(t)
+  assert.equal((await changeSeat({ ...f.options, effort: 'high' }, f.dependencies)).status, 'unchanged')
+  f.observation.state = 'busy'
+  await assert.rejects(changeSeat({ ...f.options, effort: 'max' }, f.dependencies), { code: 'SEAT_CHANGE_SEAT_BUSY' })
+  await assert.rejects(changeSeat({ ...f.options, harness: 'unknown', model: 'x', effort: 'high' }, f.dependencies), { code: 'SEAT_CHANGE_HARNESS_UNSUPPORTED' })
+  assert.equal(f.events.length, 0)
+})
+test('公式catalogの未知値と取得失敗は固定値へ置き換えない', () => {
+  validateTarget('codex', 'model-a', 'max', catalogDependencies)
+  validateTarget('grok', 'grok-b', 'high', catalogDependencies)
+  assert.throws(() => validateTarget('claude', 'x', 'ultra', catalogDependencies), { code: 'SEAT_CHANGE_EFFORT_UNSUPPORTED' })
+  assert.throws(() => validateTarget('codex', 'missing', 'max', catalogDependencies), { code: 'SEAT_CHANGE_MODEL_UNSUPPORTED' })
+  assert.throws(() => validateTarget('codex', 'model-a', 'ultra', catalogDependencies), { code: 'SEAT_CHANGE_EFFORT_UNSUPPORTED' })
+  assert.throws(() => validateTarget('grok', 'missing', 'high', catalogDependencies), { code: 'SEAT_CHANGE_MODEL_UNSUPPORTED' })
+  assert.throws(() => validateTarget('claude', 'x', 'high', { ...catalogDependencies, execute: () => { throw new Error('catalog取得失敗') } }), /catalog取得失敗/)
+})
+test('configure失敗と応答不一致はmetadataを変更せず再起動もしない', async t => {
+  for (const fail of [true, false]) {
+    const f = fixture(t)
+    f.dependencies.aiterm.structured = async () => { if (fail) throw new Error('configure失敗'); return { session_id: 'other', reasoning_effort: 'max' } }
+    await assert.rejects(changeSeat({ ...f.options, effort: 'max' }, f.dependencies), fail ? /configure失敗/ : { code: 'SEAT_CHANGE_AITERM_RESULT_MISMATCH' })
+    assert.equal(f.member().effort, 'high')
+    assert.equal(f.events.length, 0)
+  }
+})
+test('harness交代は役割とmissionを保って一度再着任し、履歴を一度残す', async t => {
+  const f = fixture(t)
+  await changeSeat({ ...f.options, harness: 'codex', model: 'model-a', effort: 'max' }, f.dependencies)
+  const launches = f.events.filter(event => event.launch)
+  assert.equal(launches.length, 1)
+  assert.equal(launches[0].launch.roles, '実装者')
+  assert.equal(launches[0].launch.mission, '使命')
+  assert.equal(f.messages.length, 1)
+  assert.equal(f.member().harness, 'codex')
+})
+test('既存席を止める前の失敗はそのまま返し、席を失った時だけ旧設定へ一度復旧する', async t => {
+  for (const stopped of [false, true]) {
+    const f = fixture(t)
+    let launches = 0
+    f.dependencies.launchSeat = async () => {
+      launches++
+      if (launches === 1) {
+        if (stopped) { f.observation.exists = false; f.observation.harness_alive = false }
+        throw new Error('着任失敗')
+      }
+    }
+    await assert.rejects(changeSeat({ ...f.options, harness: 'codex', model: 'model-a', effort: 'max' }, f.dependencies), stopped ? { code: 'SEAT_CHANGE_ROLLED_BACK' } : /着任失敗/)
+    assert.equal(launches, stopped ? 2 : 1)
+    assert.equal(f.messages.length, 0)
+  }
+})
+test('台帳・履歴の読返し不一致は変更成立を装わない', async t => {
+  for (const broken of ['metadata', 'history']) {
+    const f = fixture(t)
+    const request = f.dependencies.api.request
+    f.dependencies.api.request = async (path, options) => {
+      if (broken === 'metadata' && path === 'members') return {}
+      if (broken === 'history' && path === 'messages' && !options) return { messages: [] }
+      return request(path, options)
+    }
+    await assert.rejects(changeSeat({ ...f.options, effort: 'max' }, f.dependencies), {
+      code: broken === 'metadata' ? 'SEAT_CHANGE_CHANGED_BUT_UNVERIFIED' : 'SEAT_CHANGE_CHANGED_BUT_HISTORY_FAILED',
+    })
+  }
+})

package/skill/scripts/cli.mjs

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+// npmが公開するPeertable操作入口。
+import { skillCommand } from './install-skill.mjs'
+import { setupProject, resumeProject } from './project-runtime.mjs'
+import { launchSeat } from './launch-seat.mjs'
+import { leaveSeat } from './leave-seat.mjs'
+import { diagnoseProject } from './doctor.mjs'
+import { teardownProject } from './teardown.mjs'
+import { changeSeat } from './change-seat.mjs'
+
+function projectOptions(args, { seat = false } = {}) {
+  const options = { project: args[0], phases: [] }
+  let index = 1
+  if (seat) options.name = args[index++]
+  const names = { '--room': 'room', '--url': 'url', '--tasks': 'tasks', '--plan': 'plan',
+    '--roles': 'roles', '--mission': 'mission', '--model': 'model', '--effort': 'effort', '--harness': 'harness', '--vendor': 'harness', '--brief': 'brief', '--parent': 'parent', '--reason': 'reason' }
+  for (; index < args.length; index++) {
+    const arg = args[index]
+    if (arg === '--json') continue
+    if (arg === '--no-probe') { options.probe = false; continue }
+    if (arg === '--repair') { options.repair = true; continue }
+    if (arg === '--purge') { options.purge = true; continue }
+    if (arg === '--archive') { options.purge = false; continue }
+    const key = names[arg]
+    if (!key && arg !== '--phase') throw new Error(`未対応の引数: ${arg}`)
+    const value = args[++index]
+    if (!value || value.startsWith('--')) throw new Error(`${arg}の値を指定してください`)
+    if (arg === '--phase') options.phases.push(value)
+    else options[key] = value
+  }
+  return options
+}
+
+const [command, ...args] = process.argv.slice(2)
+try {
+  if (command === 'install') {
+    const result = skillCommand(args)
+    console.log(JSON.stringify(result))
+    if (args.includes('--check') && result.status !== 'ready') process.exitCode = 1
+  } else if (command === 'diagnostics') {
+    const result = args[0] && !args[0].startsWith('--')
+      ? await diagnoseProject(projectOptions(args)) : skillCommand(['--check', ...args])
+    console.log(JSON.stringify(result))
+    if (result.status !== 'ready') process.exitCode = 1
+  } else if (command === 'setup' || command === 'resume') {
+    console.log(JSON.stringify(await (command === 'setup' ? setupProject : resumeProject)(projectOptions(args))))
+  } else if (command === 'launch') {
+    console.log(JSON.stringify(await launchSeat(projectOptions(args, { seat: true }))))
+  } else if (command === 'change') {
+    console.log(JSON.stringify(await changeSeat(projectOptions(args, { seat: true }))))
+  } else if (command === 'leave') {
+    if (args.length !== 2) throw new Error('leaveにはprojectと席名を指定してください')
+    console.log(JSON.stringify(await leaveSeat(args[0], args[1])))
+  } else if (command === 'teardown') {
+    console.log(JSON.stringify(await teardownProject(projectOptions(args))))
+  } else if (!command || ['--help', '-h', 'help'].includes(command)) {
+    console.log(`Peertable
+  peertable install [--target claude|codex|grok|cursor] [--json]
+  peertable diagnostics [--target claude|codex|grok|cursor] [--json]
+  peertable diagnostics <project> [--repair]
+  peertable setup <project> --room <room> --url <URL> --tasks <file>
+  peertable setup <project> --room <room> --url <URL> --plan <plan> [--phase <id>]
+  peertable resume <project> [--plan <plan>] [--phase <id>] [--no-probe]
+  peertable launch <project> <name> --roles <roles> [--harness <harness>] [--model <model>] [--effort <effort>] [--brief <text>]
+  peertable leave <project> <name>
+  peertable change <project> <name> [--harness <harness>] [--model <model>] [--effort <effort>]
+  peertable teardown <project> [--purge]
+
+installはskillを配置・更新します。対象AIは既存のホームディレクトリから検出します。
+setup/resumeは明示したprojectの生成物とruntimeを更新し、実動作を確認します。`)
+  } else {
+    throw Object.assign(new Error(`未対応のコマンド: ${command}`), { code: 'PEERTABLE_COMMAND_UNKNOWN' })
+  }
+} catch (error) {
+  console.error(JSON.stringify({ schema: 'peertable.error.v1', code: error.code ?? 'PEERTABLE_COMMAND_FAILED', message: error.message, ...(error.result ? { result: error.result } : {}) }))
+  process.exitCode = 1
+}

package/skill/scripts/doctor.mjs

@@ -0,0 +1,53 @@
+// 診断はPeertableの記録とAitermの公開観測を照合する。repairはbridgeだけを直す。
+import { existsSync } from 'node:fs'
+import { execFileSync } from 'node:child_process'
+import { join } from 'node:path'
+import { AitermClient } from './aiterm-client.mjs'
+import { RoomApi } from './room-api.mjs'
+import { seatSessionId } from './seat-session.mjs'
+import { bridgeRecordLive } from './bridge-record-live.mjs'
+import { ensureBridge } from './ensure-project-runtime.mjs'
+import { projectPath, readSetup, readJson } from './project-scaffold.mjs'
+import { resolveLatticeInvocation } from './seat-usage.mjs'
+
+export async function diagnoseProject(options) {
+  const project = projectPath(options.project)
+  const state = readSetup(project)
+  const api = new RoomApi(state)
+  const aiterm = new AitermClient()
+  const checks = []
+  const check = async (name, action) => {
+    try { const result = await action(); checks.push({ name, status: 'ok', ...result }); return result }
+    catch (error) { checks.push({ name, status: 'failed', message: error.message }); return null }
+  }
+  try {
+    await check('room到達', () => api.request('summary'))
+    const listed = await check('member台帳', async () => ({ members: await api.members() }))
+    await check('Aitermと預け仕事の公開観測', async () => ({ sessions: (await aiterm.sessions(['PEERTABLE_MEMBER', 'PEERTABLE_ROOM'])).length }))
+    for (const member of listed?.members ?? []) {
+      if (member.delivery?.kind === 'parent_watch' || !seatSessionId(member)) continue
+      await check(`席 ${member.name}`, async () => {
+        if (!member.roles?.length || !member.model || !member.pid || !member.started_identity || !member.argv_digest) throw new Error('台帳の素性・本人性が不完全です')
+        const observed = await aiterm.observe(seatSessionId(member))
+        if (!observed.exists || observed.state === 'dead') throw new Error('席が停止しています。peertable resumeで再開してください')
+        const identity = observed.process_identity
+        if (!identity || identity.pid !== member.pid || identity.started_identity !== member.started_identity || identity.argv_digest !== member.argv_digest) throw new Error('台帳と現在のプロセス本人性が一致しません')
+        return { state: observed.state, session_id: observed.session_id }
+      })
+    }
+    for (const kind of ['alarm', 'seat-status', 'wakeup']) await check(`${kind} bridge`, async () => {
+      const path = join(project, '.team', `${kind}-bridge.json`)
+      const live = () => existsSync(path) && bridgeRecordLive(readJson(path))
+      let repaired = false
+      if (!live() && options.repair) { await ensureBridge(project, kind, { aiterm }); repaired = true }
+      if (!live()) throw new Error('起動記録が無いか、process・進捗が停止しています')
+      return { repaired, pid: readJson(path).pid }
+    })
+    checks.push({ name: '読了ack', status: (listed?.members ?? []).some(member => member.read_seq !== undefined) ? 'ok' : 'unknown', reason: 'memberのread_seqで判定' })
+    if (state.mode === 'lattice') await check('Lattice工程', async () => {
+      const invocation = resolveLatticeInvocation(process.env.LATTICE_CLI || state.lattice_cli || 'lattice', ['status', '--json'])
+      return JSON.parse(execFileSync(invocation.command, invocation.argv, { cwd: project, encoding: 'utf8' }))
+    })
+    return { schema: 'peertable.diagnostics.v1', status: checks.some(item => item.status === 'failed') ? 'failed' : 'ready', project, room: state.room, checks }
+  } finally { await aiterm.close() }
+}