peertable 0.8.54 → 0.8.56

package/skill/scripts/install-skill.mjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+// skill配置だけを所有する。project、room、AIの設定ファイルは変更しない。
+import { existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, realpathSync, symlinkSync, unlinkSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+export const clients = Object.freeze(['claude', 'codex', 'grok', 'cursor'])
+export const packageRoot = realpathSync(fileURLToPath(new URL('../../', import.meta.url)))
+const fail = (code, message) => Object.assign(new Error(`${code}: ${message}`), { code })
+const stat = path => {
+  try { return lstatSync(path) } catch (error) { if (error.code === 'ENOENT') return null; throw error }
+}
+
+function ownedLink(target, source) {
+  if (resolve(target) === source) return true
+  // 旧手動配置はPeertable packageのskillへのリンクだけを移行する。
+  if (target.split(/[\\/]/u).at(-1) !== 'skill') return false
+  try {
+    const pkg = JSON.parse(readFileSync(join(dirname(target), 'package.json'), 'utf8'))
+    return pkg.name === 'peertable' && existsSync(join(target, 'SKILL.md'))
+  } catch (error) {
+    if (error.code === 'ENOENT' || error instanceof SyntaxError) return false
+    throw error
+  }
+}
+
+export function inspectSkill({ root = packageRoot, home = homedir(), targets } = {}) {
+  const source = realpathSync(join(root, 'skill'))
+  const version = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8')).version
+  const selected = targets?.length ? targets : clients.filter(client => existsSync(join(home, `.${client}`)))
+  for (const client of selected) {
+    if (!clients.includes(client)) throw fail('PEERTABLE_SKILL_TARGET_UNKNOWN', client)
+  }
+  const entries = [...new Set(selected)].map(client => {
+    const path = join(home, `.${client}`, 'skills', 'peertable')
+    const info = stat(path)
+    if (!info) return { client, path, status: 'missing' }
+    if (!info.isSymbolicLink()) return { client, path, status: 'conflict' }
+    const target = resolve(dirname(path), readlinkSync(path))
+    if (target === source) return { client, path, status: 'current' }
+    return { client, path, status: ownedLink(target, source) ? 'outdated' : 'conflict' }
+  })
+  return { schema: 'peertable.skill-install.v1', version, source, targets: entries,
+    status: !entries.length ? 'not_detected' : entries.every(entry => entry.status === 'current') ? 'ready' : 'required' }
+}
+
+export function installSkill(options = {}) {
+  const result = inspectSkill(options)
+  // 外部の既存資産との衝突は、どの導入先へも書き込む前に知らせる。
+  const conflicts = result.targets.filter(entry => entry.status === 'conflict')
+  if (conflicts.length) throw fail('PEERTABLE_SKILL_CONFLICT', conflicts.map(entry => entry.path).join(', '))
+  for (const entry of result.targets) {
+    if (entry.status === 'current') continue
+    mkdirSync(dirname(entry.path), { recursive: true })
+    // symlinkだけを取り替え、旧リンク先のsourceは一切変更しない。
+    if (entry.status === 'outdated') unlinkSync(entry.path)
+    symlinkSync(result.source, entry.path, process.platform === 'win32' ? 'junction' : 'dir')
+    entry.status = entry.status === 'missing' ? 'installed' : 'updated'
+    if (realpathSync(entry.path) !== result.source) throw fail('PEERTABLE_SKILL_VERIFY_FAILED', entry.path)
+  }
+  result.status = result.targets.length ? 'ready' : 'not_detected'
+  return result
+}
+
+export function skillCommand(args) {
+  const targets = []
+  let check = false
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index]
+    if (arg === '--json') continue
+    if (arg === '--check') { check = true; continue }
+    if (arg === '--target' && args[index + 1]) { targets.push(args[++index]); continue }
+    throw fail('PEERTABLE_SKILL_ARGUMENT_INVALID', arg)
+  }
+  return check ? inspectSkill({ targets }) : installSkill({ targets })
+}
+
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  try {
+    if (process.argv.includes('--postinstall') && process.env.npm_config_global !== 'true') process.exit(0)
+    const result = skillCommand(process.argv.slice(2).filter(arg => arg !== '--postinstall'))
+    console.log(JSON.stringify(result))
+    if (process.argv.includes('--check') && result.status !== 'ready') process.exitCode = 1
+  } catch (error) {
+    console.error(JSON.stringify({ schema: 'peertable.error.v1', code: error.code ?? 'PEERTABLE_SKILL_INSTALL_FAILED', message: error.message }))
+    process.exitCode = 1
+  }
+}

package/skill/scripts/install-skill.test.mjs

@@ -0,0 +1,84 @@
+import assert from 'node:assert/strict'
+import { lstatSync, mkdirSync, mkdtempSync, readFileSync, realpathSync, rmSync, symlinkSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { tmpdir } from 'node:os'
+import test from 'node:test'
+import { inspectSkill, installSkill } from './install-skill.mjs'
+
+function fixture(t) {
+  const dir = mkdtempSync(join(tmpdir(), 'peertable-skill-'))
+  t.after(() => rmSync(dir, { recursive: true, force: true }))
+  const home = join(dir, 'home with spaces')
+  mkdirSync(home)
+  function pkg(name, version) {
+    const root = join(dir, name)
+    mkdirSync(join(root, 'skill'), { recursive: true })
+    writeFileSync(join(root, 'package.json'), JSON.stringify({ name: 'peertable', version }))
+    writeFileSync(join(root, 'skill', 'SKILL.md'), `---\nname: peertable\n---\n${version}\n`)
+    return root
+  }
+  return { home, pkg, root: pkg('package 1', '1.0.0') }
+}
+
+test('初回配置と再実行で同じskillを公開しAI設定とprojectを保持する', t => {
+  const { root, home } = fixture(t)
+  const targets = ['claude', 'codex', 'grok', 'cursor']
+  for (const client of targets) {
+    mkdirSync(join(home, `.${client}`))
+    writeFileSync(join(home, `.${client}`, 'config.toml'), '# 独自設定\n')
+  }
+  mkdirSync(join(home, 'project', '.team'), { recursive: true })
+  writeFileSync(join(home, 'project', '.team', 'setup-state.json'), '{"room":"既存room"}\n')
+  const first = installSkill({ root, home })
+  assert.equal(first.status, 'ready')
+  assert.deepEqual(first.targets.map(entry => entry.status), targets.map(() => 'installed'))
+  const inodes = first.targets.map(entry => lstatSync(entry.path).ino)
+  const second = installSkill({ root, home })
+  assert.deepEqual(second.targets.map(entry => entry.status), targets.map(() => 'current'))
+  assert.deepEqual(second.targets.map(entry => lstatSync(entry.path).ino), inodes)
+  for (const entry of first.targets) {
+    assert.equal(realpathSync(entry.path), realpathSync(join(root, 'skill')))
+    assert.equal(readFileSync(join(home, `.${entry.client}`, 'config.toml'), 'utf8'), '# 独自設定\n')
+  }
+  assert.equal(readFileSync(join(home, 'project', '.team', 'setup-state.json'), 'utf8'), '{"room":"既存room"}\n')
+})
+
+test('更新は旧Peertableへの手動リンクを移行し旧sourceを保持する', t => {
+  const { root, home, pkg } = fixture(t)
+  installSkill({ root, home, targets: ['codex'] })
+  const updatedRoot = pkg('package 2', '2.0.0')
+  const result = installSkill({ root: updatedRoot, home, targets: ['codex'] })
+  assert.equal(result.targets[0].status, 'updated')
+  assert.equal(readFileSync(join(home, '.codex', 'skills', 'peertable', 'SKILL.md'), 'utf8'), '---\nname: peertable\n---\n2.0.0\n')
+  assert.equal(readFileSync(join(root, 'skill', 'SKILL.md'), 'utf8'), '---\nname: peertable\n---\n1.0.0\n')
+})
+
+test('独自ディレクトリとの衝突は全導入先への書込みより前に止まる', t => {
+  const { root, home } = fixture(t)
+  const custom = join(home, '.codex', 'skills', 'peertable')
+  mkdirSync(custom, { recursive: true })
+  writeFileSync(join(custom, 'SKILL.md'), '利用者の独自skill')
+  assert.throws(() => installSkill({ root, home, targets: ['claude', 'codex'] }), { code: 'PEERTABLE_SKILL_CONFLICT' })
+  assert.equal(readFileSync(join(custom, 'SKILL.md'), 'utf8'), '利用者の独自skill')
+  assert.throws(() => lstatSync(join(home, '.claude')), { code: 'ENOENT' })
+})
+
+test('別製品へのリンクは上書きせず、診断は読み取りだけを行う', t => {
+  const { root, home } = fixture(t)
+  const custom = join(home, 'custom')
+  mkdirSync(custom)
+  const destination = join(home, '.grok', 'skills', 'peertable')
+  mkdirSync(join(home, '.grok', 'skills'), { recursive: true })
+  symlinkSync(custom, destination, process.platform === 'win32' ? 'junction' : 'dir')
+  assert.equal(inspectSkill({ root, home }).targets[0].status, 'conflict')
+  assert.throws(() => installSkill({ root, home }), { code: 'PEERTABLE_SKILL_CONFLICT' })
+  assert.equal(realpathSync(destination), realpathSync(custom))
+})
+
+test('未検出AIを作らず明示targetだけを導入する', t => {
+  const { root, home } = fixture(t)
+  assert.equal(installSkill({ root, home }).status, 'not_detected')
+  assert.throws(() => installSkill({ root, home, targets: ['unknown'] }), { code: 'PEERTABLE_SKILL_TARGET_UNKNOWN' })
+  assert.equal(installSkill({ root, home, targets: ['cursor'] }).targets[0].client, 'cursor')
+  assert.throws(() => lstatSync(join(home, '.codex')), { code: 'ENOENT' })
+})

package/skill/scripts/launch-seat.mjs

@@ -0,0 +1,156 @@
+// 正規着座。TUIの準備・入力・観測はAiterm、席の設定・台帳はPeertableが所有する。
+import { execFileSync, spawn } from 'node:child_process'
+import { chmodSync, copyFileSync, existsSync, mkdirSync, mkdtempSync, rmSync } from 'node:fs'
+import { homedir, hostname, tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { AitermClient } from './aiterm-client.mjs'
+import { RoomApi } from './room-api.mjs'
+import { passSeatApproval } from './seat-approval.mjs'
+import { leaveSeat } from './leave-seat.mjs'
+import { ensureProjectRuntime } from './ensure-project-runtime.mjs'
+import { projectPath, readSetup, runScript, fail } from './project-scaffold.mjs'
+import { packageRoot } from './install-skill.mjs'
+import { resolveWindowsCommand } from './platform/windows/resolve-lattice-command.mjs'
+
+const delay = ms => new Promise(resolve => setTimeout(resolve, ms))
+const harnessIds = { claude: 'claude-code', codex: 'codex-cli', grok: 'grok-cli' }
+
+function prepareHarness(project, name, harness, env, script, home) {
+  if (harness === 'grok' || harness === 'codex') {
+    const key = harness === 'grok' ? 'GROK_HOME' : 'CODEX_HOME'
+    env[key] = join(project, '.team', 'seats', name + (harness === 'grok' ? '.grok-home' : '.codex'))
+    mkdirSync(env[key], { recursive: true })
+    const auth = join(home, `.${harness}`, 'auth.json')
+    if (existsSync(auth)) {
+      copyFileSync(auth, join(env[key], 'auth.json'))
+      chmodSync(join(env[key], 'auth.json'), 0o600)
+    } else if (harness === 'grok') fail('SEAT_GROK_AUTH_MISSING', 'Grokの認証がありません')
+    if (harness === 'grok') script('grok-seat-config.mjs', [project, join(env[key], 'config.toml')], { env })
+    else script('ensure-codex-room-mcp.mjs', ['ensure', project, packageRoot], { env })
+  }
+}
+
+export async function launchSeat(options, dependencies = {}) {
+  if (process.env.PEERTABLE_MEMBER) fail('SEAT_LAUNCH_DELEGATED_CHILD_FORBIDDEN', '席から別席は起動できません')
+  const project = projectPath(options.project)
+  const { name, brief = '' } = options
+  if (!name || !/^[A-Za-z0-9._:-]+$/.test(name)) fail('SEAT_LAUNCH_ARGS_INVALID', '有効な席名を指定してください')
+  if (!options.roles) fail('SEAT_LAUNCH_ARGS_INVALID', '役割を指定してください')
+  if (Buffer.byteLength(brief) > 65536) fail('LAUNCH_BRIEF_TOO_LONG', '着任指示の上限は65536 bytesです')
+  const env = { ...process.env }
+  const home = dependencies.home ?? homedir()
+  const script = dependencies.runScript ?? runScript
+  const execute = dependencies.execFileSync ?? execFileSync
+  const leave = dependencies.leaveSeat ?? leaveSeat
+  const ensureRuntime = dependencies.ensureProjectRuntime ?? ensureProjectRuntime
+  delete env.PEERTABLE_POST_TOKEN
+  delete env.PEERTABLE_TMUX_SOCKET
+  const placementArgs = ['--roles', options.roles]
+  for (const key of ['model', 'effort', 'harness']) if (options[key]) placementArgs.push(`--${key}`, options[key])
+  const placement = JSON.parse(script('resolve-seat-placement.mjs', placementArgs, { env }))
+  const { model, harness, effort } = placement.settings
+  if (!harnessIds[harness]) fail('SEAT_LAUNCH_HARNESS_UNSUPPORTED', harness)
+  script('upgrade-team-assets.mjs', [project], { env })
+  const state = readSetup(project)
+  // 非対話のモデル実測は、既存席を畳む前に行う。
+  const preflightArgs = harness === 'codex' ? ['exec', '--model', model, '--skip-git-repo-check', 'ping']
+    : harness === 'grok' ? ['--model', model, '--reasoning-effort', effort, '-p', 'ping'] : ['--model', model, '-p', 'ping']
+  const preflight = (dependencies.resolveCommand ?? resolveWindowsCommand)(harness, preflightArgs)
+  const preflightEnv = { ...env }
+  let preflightHome
+  try {
+    if (harness === 'grok') {
+      preflightHome = mkdtempSync(join(tmpdir(), 'peertable-model-'))
+      copyFileSync(join(home, '.grok', 'auth.json'), join(preflightHome, 'auth.json'))
+      chmodSync(join(preflightHome, 'auth.json'), 0o600)
+      preflightEnv.GROK_HOME = preflightHome
+      script('grok-seat-config.mjs', [project, join(preflightHome, 'config.toml')], { env: preflightEnv })
+    }
+    execute(preflight.command, preflight.argv, { cwd: tmpdir(), env: preflightEnv, encoding: 'utf8', timeout: 120_000, stdio: ['ignore', 'pipe', 'pipe'] })
+  } finally { if (preflightHome) rmSync(preflightHome, { recursive: true, force: true }) }
+
+  // 登録前に中断した席も、公開envで同じroomの本人と確認して撤去する。
+  await leave(project, name)
+  const credential = script('seat-credential.mjs', ['prepare', project, state.room, name], { env })
+  Object.assign(env, {
+    PEERTABLE_URL: state.server_url, PEERTABLE_ROOM: state.room, PEERTABLE_MEMBER: name,
+    PEERTABLE_CREDENTIAL_FILE: credential, PEERTABLE_HARNESS: harness, PEERTABLE_VENDOR: harness,
+    PEERTABLE_MODEL: model, PEERTABLE_EFFORT: effort || '', PEERTABLE_ROLE: placement.roles[0],
+    PEERTABLE_ROLES: placement.roles.join(','), PEERTABLE_MISSION: options.mission || '',
+  })
+  if (state.mode === 'lattice') Object.assign(env, {
+    PEERTABLE_PLAN: state.plan_key, LATTICE_CLI: state.lattice_cli || env.LATTICE_CLI || 'lattice',
+    LATTICE_TODO_ACTOR_HOST: env.LATTICE_TODO_ACTOR_HOST || hostname(),
+    LATTICE_TODO_ACTOR_SESSION: name, LATTICE_TODO_ACTOR_AGENT: name,
+  })
+  const api = dependencies.api ?? new RoomApi(state, { credential })
+  const aiterm = dependencies.aiterm ?? new AitermClient({ env })
+  const sessionId = `peer-${name}`
+  let launched = false
+  try {
+    prepareHarness(project, name, harness, env, script, home)
+    const before = await aiterm.sessions()
+    if (before.some(session => session.session_id === sessionId)) fail('SEAT_SESSION_CONFLICT', `${sessionId} が既に存在します`)
+    launched = true
+    const launch = await aiterm.structured('agent_launch', {
+      session_name: sessionId, harness: harnessIds[harness], model, reasoning_effort: effort,
+      cwd: project, trust_project: true,
+      env_vars: [
+        'PEERTABLE_URL', 'PEERTABLE_ROOM', 'PEERTABLE_MEMBER', 'PEERTABLE_CREDENTIAL_FILE',
+        'PEERTABLE_HARNESS', 'PEERTABLE_VENDOR', 'PEERTABLE_MODEL', 'PEERTABLE_EFFORT',
+        'PEERTABLE_ROLE', 'PEERTABLE_ROLES', 'PEERTABLE_MISSION', 'PEERTABLE_PLAN',
+        'LATTICE_CLI', 'LATTICE_TODO_ACTOR_HOST', 'LATTICE_TODO_ACTOR_SESSION', 'LATTICE_TODO_ACTOR_AGENT',
+        'GROK_HOME', 'CODEX_HOME',
+      ].filter(key => env[key] !== undefined),
+    }, 'aiterm.agent-launch-result.v1')
+    if (launch.session_id !== sessionId || launch.startup?.status !== 'ready') {
+      fail('SEAT_STARTUP_NOT_READY', `${name} の起動準備が完了していません: ${launch.startup?.reason ?? 'startup応答なし'}`)
+    }
+    const readyDeadline = Date.now() + 90_000
+    for (;;) {
+      await passSeatApproval(aiterm, sessionId, harness)
+      const registered = (await api.members()).find(member => member.name === name)
+      if (registered) break
+      if (Date.now() >= readyDeadline) fail('SEAT_ROOM_MCP_NOT_READY', `${name} のroom参加登録を確認できません`)
+      await delay(1000)
+    }
+    const observed = await aiterm.observe(sessionId)
+    if (!observed.process_identity) fail('SEAT_IDENTITY_UNAVAILABLE', `${name} の本人性を確認できません`)
+    await api.request('members', { method: 'POST', body: {
+      name, ...observed.process_identity, identity_recorded_at: observed.observed_at,
+    } })
+    await ensureRuntime(project, { env })
+    let turnStarted = false
+    if (brief) {
+      const receipt = await aiterm.structured('pty_send', { session_id: sessionId, text: brief }, 'aiterm.pty-send-result.v1')
+      if (receipt.mode !== 'agent_dispatch' || receipt.submit_residue || receipt.event_cursor == null || !receipt.wait_process) {
+        fail('LAUNCH_BRIEF_SEND_FAILED', `${name} の着任指示が成立していません`)
+      }
+      let completion = null
+      const wp = receipt.wait_process
+      const waiter = (dependencies.spawn ?? spawn)(wp.executable, wp.args, { detached: true, stdio: 'ignore', env })
+      waiter.on('error', error => { completion = { error } })
+      waiter.on('exit', code => { completion = { code } })
+      waiter.unref()
+      const deadline = Date.now() + 60_000
+      for (;;) {
+        if (completion?.error) throw completion.error
+        if (completion && completion.code !== 0) fail('LAUNCH_BRIEF_TURN_FAILED', `完了観測がexit ${completion.code}を返しました`)
+        const current = await aiterm.observe(sessionId)
+        if (current.state === 'busy' || completion?.code === 0) { turnStarted = true; break }
+        await passSeatApproval(aiterm, sessionId, harness)
+        if (Date.now() >= deadline) fail('LAUNCH_BRIEF_TURN_NOT_STARTED', `${name} の実ターン開始を確認できません`)
+        await delay(1000)
+      }
+    }
+    const stored = (await api.members()).find(member => member.name === name)
+    if (!stored?.model || !stored.roles?.length || !stored.aiterm_session_id || !stored.pid) fail('SEAT_LEDGER_INCOMPLETE', `${name} の台帳が不完全です`)
+    return { schema: 'peertable.seat-launch.v1', status: 'ready', member: name, session_id: sessionId, placement, turn_started: turnStarted }
+  } catch (error) {
+    if (launched) {
+      try { await leave(project, name, { aiterm, api }) }
+      catch (rollback) { throw new AggregateError([error, rollback], `着座失敗後の撤去も失敗しました: ${error.message}; ${rollback.message}`) }
+    } else script('seat-credential.mjs', ['remove', project, credential], { env })
+    throw error
+  } finally { if (!dependencies.aiterm) await aiterm.close() }
+}