peertable 0.3.8 → 0.3.10

package/skill/scripts/teardown.sh

@@ -13,6 +13,8 @@
 # 工程の記録は、卓そのものより寿命が長い**。ゲスト project を汚さない不可侵原則は `--purge` が持つ。
 set -e
 proj="$1"
+script_dir=$(cd "$(dirname "$0")" && pwd -P)
+peertable_repo=$(cd "$script_dir/../.." && pwd -P)
 mode=archive
 for arg in "${@:2}"; do
   case "$arg" in
@@ -255,8 +257,9 @@ if [ "$mode" = archive ]; then
     # 過去ログが一続きの会話に見えてしまう**（次の campaign の発言と地続きになる）
     body="解散。この卓はここまで。参加者: ${seat_names}。部屋と過去ログはこのまま残り、次の卓も同じ部屋で続く。"
     python3 -c "
-import json,sys,urllib.request
-req=urllib.request.Request('$url/api/$room/messages', method='POST',
+import json,sys,urllib.parse,urllib.request
+room_path=urllib.parse.quote('$room', safe='')
+req=urllib.request.Request('$url/api/' + room_path + '/messages', method='POST',
   data=json.dumps({'from':'system','to':'system','body':'''$body'''}).encode(),
   headers={'Content-Type':'application/json','X-Peertable-Token':'$PEERTABLE_POST_TOKEN'})
 urllib.request.urlopen(req, timeout=10).read()
@@ -268,7 +271,7 @@ urllib.request.urlopen(req, timeout=10).read()
       c=$(curl -s -o /dev/null -w '%{http_code}' -X DELETE "$url/api/$room/members/$name" -H "X-Peertable-Token: $PEERTABLE_POST_TOKEN" || true)
       [ "$c" = 200 ] && n=$((n + 1))
     done <<<"$member_lines"
-    did "メンバー登録の解除（${n}名）— **部屋と過去ログは残す**（$url/$room）"
+    did "メンバー登録の解除（${n}名）— **部屋と過去ログは残す**（${url}/${room}）"
   fi
 # room 削除は --purge だけ。トークンを要する唯一の段で、ここだけが外部サービスへの依存境界
 elif [ "$log_saved" = no ]; then
@@ -299,6 +302,12 @@ else
   skip "外部ペイン（登録なし）"
 fi
 
+if node "$script_dir/ensure-codex-room-mcp.mjs" remove "$proj" "$peertable_repo"; then
+  did "Codex project設定からPeertable room MCPを撤去"
+else
+  miss "Codex project設定のPeertable room MCPを撤去できない"
+fi
+
 rm -rf "$proj/.team"
 did ".team/ 削除"
 

package/skill/scripts/todo-extraction-from-plan.mjs

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+// 稼働中 campaign へ独立欠陥 ToDo を軽量に追加するための正規入口。
+//
+// 背景: main plan の migrate 時に narrative_ref へ #L 行番号を持たせなかったため、
+// `lattice todo split` が `predecessor_source_inventory_unavailable` で機構的に失敗した
+// （実測 2026-08-11。docs/plan_peertable-autonomy-runtime-fx-20260811.md f4）。`todo revise` は
+// 使えるが desired_plan 全体・source_cutover_batch を要求する重量級 API で、発見者が親裁定なしに
+// 選べる手段ではない。このツールは「計画 Markdown に `### <task_id> <title>` 見出しで task を書く
+// →本ツールで extraction.json を自動生成→`lattice todo migrate` で新規 companion plan として起票」
+// という軽量な代替経路を提供する。既存 plan への task 追加は、新規 companion plan を作り
+// `lattice todo dependency connect` で前提へ接続する（このツールは新規 plan の migrate 入力生成
+// だけを担う。稼働中 plan への revise は対象外）。
+//
+// usage:
+//   node todo-extraction-from-plan.mjs <plan.md> <plan_key> --project <project_id> --agent <name>
+//     [--session <name>] [--host <name>] [--lane <lane>] [--out <path>]
+//
+// 計画 Markdown の規約: `# <root見出し>` → `## <section見出し>` → `### <task_id> <title>` の3階層。
+// 各 `###` 見出しの本文（次の `#`/`##`/`###` 見出しまで）が design_memo になる。
+import { accessSync, constants, existsSync, readFileSync, realpathSync, writeFileSync } from 'node:fs'
+import { execFileSync } from 'node:child_process'
+import { dirname, isAbsolute, join, relative, resolve } from 'node:path'
+
+function usage(message) {
+  if (message) console.error(`ERROR: ${message}`)
+  console.error('usage: todo-extraction-from-plan.mjs <plan.md> <plan_key> --project <id> --agent <name> [--session <name>] [--host <name>] [--lane <lane>] [--out <path>]')
+  process.exit(1)
+}
+
+function fail(code, message, nextAction) {
+  console.error(`${code}: ${message}`)
+  if (nextAction) console.error(`next: ${nextAction}`)
+  process.exit(1)
+}
+
+const args = process.argv.slice(2)
+if (args.length < 2 || args[0].startsWith('--')) usage('plan.md と plan_key は最初の2つの位置引数')
+const [planPath, planKey, ...rest] = args
+const opts = { project: null, agent: null, session: null, host: 'mac', lane: 'defect', out: null }
+for (let i = 0; i < rest.length; i += 2) {
+  const key = rest[i]?.replace(/^--/, '')
+  if (!(key in opts)) usage(`unknown flag: ${rest[i]}`)
+  opts[key] = rest[i + 1]
+}
+if (!opts.project) usage('--project は必須')
+if (!opts.agent) usage('--agent は必須')
+if (!opts.session) opts.session = opts.agent
+
+let absolutePlanPath
+try {
+  absolutePlanPath = realpathSync(resolve(planPath))
+} catch {
+  fail('PLAN_NOT_FOUND', `${planPath} を実在fileとして解決できない`, '実在する計画Markdownを指定する')
+}
+let repoRoot
+try {
+  repoRoot = realpathSync(execFileSync('git', ['-C', dirname(absolutePlanPath), 'rev-parse', '--show-toplevel'], { encoding: 'utf8' }).trim())
+} catch {
+  fail('PLAN_REPO_UNRESOLVED', `${planPath} の所属git repoを解決できない`, 'git管理下の計画Markdownを指定する')
+}
+
+const setupStatePath = join(repoRoot, '.team', 'setup-state.json')
+let latticeCli = process.env.LATTICE_CLI?.trim() ?? ''
+let latticeCliSource = 'LATTICE_CLI'
+if (!latticeCli) {
+  latticeCliSource = setupStatePath
+  if (!existsSync(setupStatePath)) {
+    fail(
+      'LATTICE_CLI_UNRESOLVED',
+      `LATTICE_CLIが未指定で ${setupStatePath} も存在しない`,
+      'Peertable setupの正規手順で .team/setup-state.json を生成するか、LATTICE_CLI=<実行可能file> を明示する',
+    )
+  }
+  let setupState
+  try {
+    setupState = JSON.parse(readFileSync(setupStatePath, 'utf8'))
+  } catch {
+    fail(
+      'PEERTABLE_SETUP_STATE_INVALID',
+      `${setupStatePath} をJSONとして読めない`,
+      'Peertable setupの正規手順で setup-state.json を再生成する',
+    )
+  }
+  latticeCli = typeof setupState.lattice_cli === 'string' ? setupState.lattice_cli.trim() : ''
+  if (!latticeCli) {
+    fail(
+      'LATTICE_CLI_UNRESOLVED',
+      `${setupStatePath} に lattice_cli が無い`,
+      'Peertable setupの正規手順で lattice_cli を記録するか、LATTICE_CLI=<実行可能file> を明示する',
+    )
+  }
+}
+try {
+  latticeCli = realpathSync(latticeCli)
+  accessSync(latticeCli, constants.X_OK)
+} catch {
+  fail(
+    'LATTICE_CLI_INVALID',
+    `${latticeCliSource} の lattice CLI が実行可能fileではない: ${latticeCli}`,
+    latticeCliSource === 'LATTICE_CLI'
+      ? 'LATTICE_CLI=<実行可能な lattice CLI> を指定する'
+      : 'Peertable setupの正規手順で setup-state.json の lattice_cli を再生成する',
+  )
+}
+const latticePkgSrc = join(dirname(dirname(latticeCli)), 'src', 'todo-contracts.mjs')
+const { todoSelfDigest } = await import(latticePkgSrc)
+
+const planPathFromRoot = relative(repoRoot, absolutePlanPath)
+if (isAbsolute(planPathFromRoot) || planPathFromRoot.startsWith(`..${process.platform === 'win32' ? '\\' : '/'}`) || planPathFromRoot === '..') {
+  fail('PLAN_OUTSIDE_REPO', `${planPath} は ${repoRoot} の外にある`, 'repo内の計画Markdownを指定する')
+}
+const relPlanPath = execFileSync('git', ['-C', repoRoot, 'ls-files', '--full-name', planPathFromRoot], { encoding: 'utf8' }).trim()
+if (!relPlanPath) usage(`${planPath} は git 管理下にない（先に commit すること）`)
+const dirty = execFileSync('git', ['-C', repoRoot, 'status', '--porcelain', '--', relPlanPath], { encoding: 'utf8' }).trim()
+if (dirty) usage(`${relPlanPath} に未 commit の変更がある。先に commit してから実行すること`)
+const sourceCommit = execFileSync('git', ['-C', repoRoot, 'rev-parse', 'HEAD'], { encoding: 'utf8' }).trim()
+
+const text = readFileSync(join(repoRoot, relPlanPath), 'utf8')
+const lines = text.split('\n')
+
+let rootHeading = null
+let sectionHeading = null
+const tasks = []
+let current = null // { taskId, title, startLine, headingPath }
+
+const flush = (endLineExclusive) => {
+  if (!current) return
+  const bodyLines = lines.slice(current.startLine, endLineExclusive)
+  while (bodyLines.length && bodyLines[0].trim() === '') bodyLines.shift()
+  while (bodyLines.length && bodyLines.at(-1).trim() === '') bodyLines.pop()
+  const designMemo = bodyLines.join('\n').trim()
+  if (!designMemo) usage(`task ${current.taskId} の design_memo が空`)
+  tasks.push({ ...current, designMemo })
+  current = null
+}
+
+for (let i = 0; i < lines.length; i += 1) {
+  const line = lines[i]
+  const h1 = /^# (.+)$/.exec(line)
+  const h2 = /^## (.+)$/.exec(line)
+  const h3 = /^### (\S+) (.+)$/.exec(line)
+  if (h1) { flush(i); rootHeading = h1[1]; sectionHeading = null; continue }
+  if (h2) { flush(i); sectionHeading = h2[1]; continue }
+  if (h3) {
+    flush(i)
+    if (!rootHeading || !sectionHeading) usage(`行${i + 1}: task見出しの前に # と ## の見出しが要る`)
+    current = {
+      taskId: h3[1], title: h3[2], startLine: i + 1,
+      headingPath: [rootHeading, sectionHeading, `${h3[1]} ${h3[2]}`],
+      headingLine: i + 1,
+    }
+  }
+}
+flush(lines.length)
+if (tasks.length === 0) usage('`### <task_id> <title>` 見出しが1つも見つからない')
+
+const migrationContext = {
+  carry_over_ref: null, condition: null, evidence_refs: [], external_canonical_ref: null,
+  h_required: false, notes: [],
+}
+
+const extraction = {
+  actor: { agent: opts.agent, host: opts.host, session: opts.session },
+  hard_dependencies: [],
+  joins: [],
+  plan_key: planKey,
+  plan_version: 'v1',
+  project_id: opts.project,
+  recorded_at: new Date(Date.now() - 60_000).toISOString().replace(/\.\d+Z$/, (m) => m.length === 5 ? m : '.000Z'),
+  schema: 'lattice.todo_extraction.v3',
+  tasks: tasks.map(({ taskId, title, headingPath, headingLine, designMemo }) => ({
+    compile_binding: null,
+    completion: null,
+    design_memo: designMemo,
+    disposition: 'register_pending',
+    lane: opts.lane,
+    migration_context: migrationContext,
+    narrative_ref: relPlanPath,
+    source: {
+      checkbox_state: 'absent',
+      heading_path: headingPath,
+      markdown_depth: 3,
+      origin_line: headingLine,
+      origin_plan_ref: relPlanPath,
+      parent_task_id: null,
+      source_commit: sourceCommit,
+    },
+    start: null,
+    task_id: taskId,
+    title,
+  })),
+  extraction_digest: '0'.repeat(64),
+}
+extraction.extraction_digest = todoSelfDigest(extraction, 'extraction_digest')
+
+const outPath = opts.out ?? join(repoRoot, `.lattice/extraction-${planKey}.json`)
+writeFileSync(outPath, JSON.stringify(extraction, null, 2) + '\n')
+console.log(`written: ${outPath} (${tasks.length} tasks: ${tasks.map((t) => t.taskId).join(', ')})`)
+console.log(`next: lattice todo migrate --input ${outPath} --dry-run --json`)

package/skill/scripts/upgrade-team-assets.sh

@@ -0,0 +1,224 @@
+#!/bin/bash
+# 既存卓へ、Peertable が所有する generated asset だけを現行 template へ同期する。
+# usage: upgrade-team-assets.sh <project_dir>
+set -euo pipefail
+
+if [ "$#" -ne 1 ]; then
+  echo 'PEERTABLE_UPGRADE_USAGE: upgrade-team-assets.sh <project_dir>' >&2
+  exit 2
+fi
+
+script_dir=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+repo_dir=$(CDPATH= cd -- "$script_dir/../.." && pwd)
+
+node --input-type=module - "$1" "$repo_dir" <<'NODE'
+import { chmodSync, lstatSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs'
+import { createHash, randomBytes } from 'node:crypto'
+import { dirname, join, resolve } from 'node:path'
+
+const projectArg = process.argv[2]
+const repoDir = process.argv[3]
+
+function fail(code, detail) {
+  console.error(JSON.stringify({
+    schema: 'peertable.generated_assets_upgrade_result.v1',
+    result: 'rejected',
+    code,
+    detail,
+  }))
+  process.exit(1)
+}
+
+function lstatOrNull(path) {
+  try {
+    return lstatSync(path)
+  } catch (error) {
+    if (error?.code === 'ENOENT') return null
+    fail('PEERTABLE_UPGRADE_PATH_UNREADABLE', `${path}: ${error.message}`)
+  }
+}
+
+function requireRegularFile(path, code, label) {
+  const stat = lstatOrNull(path)
+  if (!stat || stat.isSymbolicLink() || !stat.isFile()) {
+    fail(code, `${label}: ${path}`)
+  }
+  return stat
+}
+
+function validateDirectory(path, required, label) {
+  const stat = lstatOrNull(path)
+  if (!stat) {
+    if (required) fail('PEERTABLE_GENERATED_ASSET_UNSAFE_PATH', `${label} が無い: ${path}`)
+    return false
+  }
+  if (stat.isSymbolicLink() || !stat.isDirectory()) {
+    fail('PEERTABLE_GENERATED_ASSET_UNSAFE_PATH', `${label} がsymlinkまたはdirectoryでない: ${path}`)
+  }
+  return true
+}
+
+function validateTargetPath(project, relativePath) {
+  const parts = relativePath.split('/')
+  let current = project
+  for (const part of parts.slice(0, -1)) {
+    current = join(current, part)
+    validateDirectory(current, part === '.team', `管理asset親 ${part}`)
+  }
+  const target = join(project, relativePath)
+  const stat = lstatOrNull(target)
+  if (stat && (stat.isSymbolicLink() || !stat.isFile())) {
+    fail('PEERTABLE_GENERATED_ASSET_UNSAFE_PATH', `管理assetがsymlinkまたはregular fileでない: ${target}`)
+  }
+  return { target, stat }
+}
+
+function templateText(repo, relativePath) {
+  const path = join(repo, relativePath)
+  requireRegularFile(path, 'PEERTABLE_GENERATED_ASSET_TEMPLATE_INVALID', 'template')
+  try {
+    return readFileSync(path)
+  } catch (error) {
+    fail('PEERTABLE_GENERATED_ASSET_TEMPLATE_INVALID', `${path}: ${error.message}`)
+  }
+}
+
+function sha256(content) {
+  return createHash('sha256').update(content).digest('hex')
+}
+
+function renderMember(template, state) {
+  if (state.mode === 'standalone') return template
+  const phases = state.phases
+  const scope = phases.length === 0
+    ? 'この卓の claim 範囲は plan 全体（phase 指定なしで立っている）。'
+    : `**この卓の claim 範囲は phase ${phases.join(' ')} の task だけ**。範囲外の phase の task は、ready に見えていても取らない——同じ plan へ別 campaign が相乗りしている時、範囲外を取ると他卓の工程を横取りする（越境が2回実測されたことへの対処）。範囲外に手を入れる必要が出たら room へ出して裁定を仰ぐ。`
+  return template
+    .toString('utf8')
+    .replaceAll('{{PLAN_KEY}}', state.plan_key)
+    .replaceAll('{{CLAIM_SCOPE}}', scope)
+}
+
+function loadState(project) {
+  const path = join(project, '.team', 'setup-state.json')
+  requireRegularFile(path, 'PEERTABLE_SETUP_STATE_INVALID', 'setup-state.json')
+  let state
+  try {
+    state = JSON.parse(readFileSync(path, 'utf8'))
+  } catch (error) {
+    fail('PEERTABLE_SETUP_STATE_INVALID', `${path}: JSONを読めない: ${error.message}`)
+  }
+  if (!state || typeof state !== 'object' || Array.isArray(state)) {
+    fail('PEERTABLE_SETUP_STATE_INVALID', 'setup-state.json はobjectでなければならない')
+  }
+  if (!['lattice', 'standalone'].includes(state.mode)) {
+    fail('PEERTABLE_SETUP_STATE_INVALID', `modeが不正: ${String(state.mode)}`)
+  }
+  if (typeof state.room !== 'string' || !state.room || typeof state.server_url !== 'string' || !state.server_url) {
+    fail('PEERTABLE_SETUP_STATE_INVALID', 'room/server_url が不正')
+  }
+  if (typeof state.plan_key !== 'string') {
+    fail('PEERTABLE_SETUP_STATE_INVALID', 'plan_key がstringでない')
+  }
+  if (state.mode === 'lattice' && !state.plan_key) {
+    fail('PEERTABLE_SETUP_STATE_INVALID', 'lattice mode の plan_key が空')
+  }
+  if (state.phases !== undefined && (!Array.isArray(state.phases) || state.phases.some(phase => typeof phase !== 'string' || !phase))) {
+    fail('PEERTABLE_SETUP_STATE_INVALID', 'phases がstring配列でない')
+  }
+  return { ...state, phases: state.phases ?? [] }
+}
+
+function writeAtomically(target, content, mode) {
+  const temporary = join(dirname(target), `.${target.split('/').at(-1)}.upgrade-${process.pid}-${randomBytes(6).toString('hex')}.tmp`)
+  try {
+    writeFileSync(temporary, content, { mode })
+    chmodSync(temporary, mode)
+    renameSync(temporary, target)
+  } catch (error) {
+    try { lstatSync(temporary); unlinkSync(temporary) } catch {}
+    fail('PEERTABLE_GENERATED_ASSET_WRITE_FAILED', `${target}: ${error.message}`)
+  }
+}
+
+function main() {
+  if (!projectArg || !repoDir) fail('PEERTABLE_UPGRADE_USAGE', 'project_dir が無い')
+  const projectStat = lstatOrNull(projectArg)
+  if (!projectStat || projectStat.isSymbolicLink() || !projectStat.isDirectory()) {
+    fail('PEERTABLE_UPGRADE_PROJECT_INVALID', `project directoryが不正: ${projectArg}`)
+  }
+  const project = resolve(projectArg)
+  const repo = resolve(repoDir)
+  validateDirectory(join(project, '.team'), true, '.team')
+  validateDirectory(join(repo, 'skill'), true, 'Peertable repo')
+  const state = loadState(project)
+
+  const common = [
+    ['.team/CLAUDE.md', 'skill/templates/charter.md', 0o644],
+    ['.team/roles/parent.md', 'skill/templates/parent.md', 0o644],
+  ]
+  const modeSpecific = state.mode === 'lattice'
+    ? [
+        ['.team/roles/member.md', 'skill/templates/member.md', 0o644],
+        ['.team/scripts/done.sh', 'skill/templates/done.sh', 0o755],
+      ]
+    : [['.team/roles/member.md', 'skill/templates/member-standalone.md', 0o644]]
+  const definitions = [...common, ...modeSpecific]
+
+  const prepared = definitions.map(([relativePath, sourcePath, mode]) => {
+    const { target, stat } = validateTargetPath(project, relativePath)
+    const source = templateText(repo, sourcePath)
+    const content = relativePath === '.team/roles/member.md' && state.mode === 'lattice'
+      ? Buffer.from(renderMember(source, state), 'utf8')
+      : source
+    return { relativePath, sourcePath, target, stat, content, mode }
+  })
+
+  const changes = prepared.map(item => {
+    if (!item.stat) return { path: item.relativePath, action: 'created', sha256: sha256(item.content) }
+    const current = readFileSync(item.target)
+    const mode = item.stat.mode & 0o777
+    if (current.equals(item.content) && mode === item.mode) {
+      return { path: item.relativePath, action: 'unchanged', sha256: sha256(item.content) }
+    }
+    return { path: item.relativePath, action: current.equals(item.content) ? 'mode-updated' : 'updated', sha256: sha256(item.content) }
+  })
+  const obsolete = ['.team/scripts/start.sh', '.team/scripts/start-event.mjs']
+    .map(relativePath => ({ relativePath, ...validateTargetPath(project, relativePath) }))
+
+  // 全対象の安全性・template・差分を先に確定してから、管理allowlistだけへ書く。
+  for (const [index, item] of prepared.entries()) {
+    const change = changes[index]
+    if (change.action === 'unchanged') continue
+    const parent = dirname(item.target)
+    mkdirSync(parent, { recursive: true, mode: 0o755 })
+    if (change.action === 'mode-updated') chmodSync(item.target, item.mode)
+    else writeAtomically(item.target, item.content, item.mode)
+  }
+
+  const removed = []
+  for (const { relativePath, target, stat } of obsolete) {
+    if (!stat) continue
+    unlinkSync(target)
+    removed.push(relativePath)
+  }
+
+  console.log(JSON.stringify({
+    schema: 'peertable.generated_assets_upgrade_result.v1',
+    result: 'ok',
+    project,
+    mode: state.mode,
+    managed: prepared.map(item => ({ path: item.relativePath, source: item.sourcePath, sha256: sha256(item.content) })),
+    changes,
+    removed,
+    changed_count: changes.filter(change => change.action !== 'unchanged').length + removed.length,
+  }))
+}
+
+try {
+  main()
+} catch (error) {
+  if (error?.code && typeof error.message === 'string') fail('PEERTABLE_GENERATED_ASSET_UPGRADE_FAILED', error.message)
+  fail('PEERTABLE_GENERATED_ASSET_UPGRADE_FAILED', String(error))
+}
+NODE