@tyhld/conductor 0.12.81 → 0.12.82

package/README.md

@@ -106,6 +106,19 @@ APPLY=1 bash scripts/update-allowed-domains.sh  # 実際に配る
   これを流さないと職人の動きは変わりません（`update-guard.sh ①-d`。同一なら何もしません）。
 - **`setup.sh` からは呼びません**。顧客機の初期設置に大きなダウンロードを足すと設置そのものが止まるためです（ADR-010）。
 
+### 職人が始まるのに要る物（先頭の確かめ・0.12.82〜）
+
+1行インストーラ（`sales-template/install.sh`）と `scripts/update-guard.sh` は、**設定を配る前に**次を確かめ、足りなければ止まって「人が打つ1行」を出します。★台本は自分で `sudo` を打たず、何も入れません。
+
+- **職人のソフト（Claude Code）が 2.1.282 以上**（えふさん確定 2026-10-02）。中継と同じ場所を同じ順で探し、いちばん新しい版で判定します。上げ方は入れ方で違います。
+  - ネイティブ導入（`~/.local/bin/claude`）… `~/.local/bin/claude update`
+  - npm 導入（nvm の bin）… `npm install -g @anthropic-ai/claude-code@latest`
+- **囲いの部品（Linux・WSL）**: `bwrap`（bubblewrap）と `socat`。無いと職人が安全のため起動を断ります（設定 `sandbox.failIfUnavailable`）。
+  - `sudo apt-get install -y bubblewrap socat`
+  - sudo のパスワードが分からないとき（WSL・Windows の PowerShell で）: `wsl.exe -u root apt-get install -y bubblewrap socat`
+  - Mac は囲いが OS に組み込みなので求めません。分からない機は止めずに「確かめられませんでした」と出します。
+- 確認だけ（`bash scripts/update-guard.sh`）のときは、職人が管制へ知らせる口（ai-kana の MCP）がつながっているかも1行で出します（止めません）。
+
 ---
 
 ## 使い方

package/dist/headless.js

@@ -16,7 +16,7 @@
  */
 import { execFileSync, spawn } from 'node:child_process';
 import { createInterface } from 'node:readline';
-import { createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 import { CENTRAL_BUSY_HOLD_MAX_MS, RELAY_DELIVER_MAX, RELAY_FETCH_TIMEOUT_MS, RELAY_HEARTBEAT_INTERVAL_MS, RELAY_RESTORE_ORPHANS_ENABLED, buildAnchor, buildSendText, canDeliver, completeWithReport, createRelayState, deliveryReport, fetchCommand, fetchCommandStatus, fetchControl, fetchOrphans, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteReadiness, patchStatus, recoverStuckProcessedReports, reconnectDelayMs, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
@@ -282,13 +282,13 @@ export function validateActiveJobOwnership(rec, cfg) {
 /**
  * 必要な最低の版。これより古い Claude Code では職人を起動しない。
  *
- * 根拠: Claude Code 2.1.x 系で画面なし方式（-p, --output-format stream-json）と
- * 通信の許可 "*"（allowedTools: "*"）が動くことが確かめられたのは太田さんの PC の
- * 2.1.286（便 bcce7be9）。2.1.86 では "*" が効かない疑い（便 a9754912、メインPC）。
- * 安全側に倒して 2.1.200 を最低とする（200 未満は "*" 対応が不明確な版）。
- * ★確かめられた版は 2.1.286 だけなので、200 は推定の境界。
+ * えふさん確定（2026-10-02・判断1）: 2.1.282。
+ * 根拠: 公式文書（code.claude.com/docs/en/managed-settings）が、管理設定の安全側の
+ * 決まりに Claude Code v2.1.282 以降を求めている。通信の許可 "*" が効くと実測できたのは
+ * 2.1.286（便 bcce7be9）。2.1.86 では効かない疑い（便 a9754912、メインPC）。
+ * ★scripts/preflight.sh の CLAUDE_MIN_VERSION も同じ値にする（試験で一致を固定）。
  */
-export const CLAUDE_MIN_VERSION = '2.1.200';
+export const CLAUDE_MIN_VERSION = '2.1.282';
 /** claude --version の出力から版番号を取り出す。取れなければ null。 */
 export function parseClaudeVersion(output) {
     // "2.1.286 (Claude Code)" → "2.1.286"
@@ -320,8 +320,42 @@ export function getClaudeVersion(binPath) {
         return null;
     }
 }
+/**
+ * 選ばれた claude の入れ方に合う「更新の1行」を返す（そのままコピペで動く形）。
+ *
+ * 入れ方は2通り在り、上げ方が違う（実測 2026-10-02 ノートPC: ネイティブ導入は
+ * npm の1行では上がらず、claude update で 2.1.70 → 2.1.287 になった）。
+ *   - ネイティブ導入（~/.local/bin/claude → ~/.local/share/claude/versions/…、
+ *     または ~/.claude/local/claude）… その claude で `update`
+ *   - npm 導入（実体が node_modules/@anthropic-ai/claude-code の下、または nvm の bin）
+ *     … その bin の npm で `install -g @anthropic-ai/claude-code@latest`
+ *   - 見分けられない … 両方を書く
+ */
+export function claudeUpdateHint(bin) {
+    let real = bin;
+    try {
+        real = realpathSync(bin);
+    }
+    catch {
+        // 実体を辿れなくても、置き場の名前だけで見分ける
+    }
+    const h = os.homedir();
+    const npmLine = (dir) => `PATH="${dir}:$PATH" npm install -g @anthropic-ai/claude-code@latest`;
+    const isNpm = (p) => p.includes('/node_modules/@anthropic-ai/claude-code/') || p.includes('/.nvm/versions/node/');
+    const isNative = (p) => p.startsWith(path.join(h, '.local', 'share', 'claude') + '/') ||
+        p.startsWith(path.join(h, '.claude', 'local') + '/');
+    if (isNpm(real) || isNpm(bin)) {
+        return `npm 導入の更新: ${npmLine(path.dirname(bin))}`;
+    }
+    if (isNative(real) || isNative(bin)) {
+        return `ネイティブ導入の更新: "${bin}" update`;
+    }
+    return `入れ方を見分けられませんでした。ネイティブ導入なら "${bin}" update ／ npm 導入なら npm install -g @anthropic-ai/claude-code@latest`;
+}
+/** ホームの外に在る、claude の既知の置き場（既定の候補）。 */
+export const CLAUDE_SYSTEM_BIN_DIRS = ['/usr/local/bin', '/usr/bin'];
 /** claude の実行ファイルの既知の候補を返す（新しい node の版から順）。 */
-function claudeBinCandidates() {
+function claudeBinCandidates(systemDirs) {
     const h = os.homedir();
     const candidates = [];
     // nvm の各 node 版の bin（新しい版から）
@@ -350,7 +384,7 @@ function claudeBinCandidates() {
         }
     }
     // その他の既知の場所
-    candidates.push(path.join(h, '.local', 'bin', 'claude'), path.join(h, '.claude', 'local', 'claude'), '/usr/local/bin/claude', '/usr/bin/claude');
+    candidates.push(path.join(h, '.local', 'bin', 'claude'), path.join(h, '.claude', 'local', 'claude'), ...systemDirs.map(d => path.join(d, 'claude')));
     return candidates;
 }
 /**
@@ -360,15 +394,18 @@ function claudeBinCandidates() {
  *   1. 環境変数 CONDUCTOR_CLAUDE_BIN（テスト用の差し替え口）→ 指定があればそれだけ
  *   2. 候補のうち実在する物の版を確かめ、いちばん新しい版を使う
  *   3. 版を確かめられない物は後回し（版が分かる物が1つもないときだけ使う）
+ *
+ * systemDirs はホームの外の置き場（既定 /usr/local/bin・/usr/bin）。試験は機体に
+ * 依らないよう、ここを作り物のフォルダに差し替える。
  */
-export function resolveClaudeBin() {
+export function resolveClaudeBin(systemDirs = CLAUDE_SYSTEM_BIN_DIRS) {
     const override = process.env.CONDUCTOR_CLAUDE_BIN;
     if (override) {
         if (!existsSync(override))
             return null;
         return { bin: override, version: getClaudeVersion(override) };
     }
-    const existing = claudeBinCandidates().filter(c => existsSync(c));
+    const existing = claudeBinCandidates(systemDirs).filter(c => existsSync(c));
     if (existing.length === 0)
         return null;
     // 版が分かる候補と分からない候補を分ける
@@ -792,6 +829,8 @@ function closeLog(ws) {
  */
 export let lastSpawnError = '';
 export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
+    // 前の失敗の理由を持ち越さない（理由の無い失敗に古い理由が付かないように）
+    lastSpawnError = '';
     const resolved = resolveClaudeBin();
     if (resolved === null) {
         lastSpawnError = 'claude が見つかりません。探した場所: nvm の各版の bin, ~/.local/bin, ~/.claude/local, /usr/local/bin, /usr/bin';
@@ -801,7 +840,8 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
     const { bin: claudeBin, version: claudeVersion } = resolved;
     // ── 最低版チェック ──
     if (claudeVersion && compareVersions(claudeVersion, CLAUDE_MIN_VERSION) < 0) {
-        lastSpawnError = `Claude Code が古すぎます（${claudeBin} = ${claudeVersion}、最低 ${CLAUDE_MIN_VERSION}）。npm install -g @anthropic-ai/claude-code で更新してください`;
+        // ★候補のうちいちばん新しい物でも最低版より古い＝全部が古いときだけここに来る
+        lastSpawnError = `Claude Code が古すぎるため仕事を始めません（${claudeBin} = ${claudeVersion}、必要な版 ${CLAUDE_MIN_VERSION} 以上）。${claudeUpdateHint(claudeBin)}`;
         log(`ERROR ${lastSpawnError}`);
         return null;
     }
@@ -851,7 +891,8 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
         });
     }
     catch (err) {
-        log(`ERROR claude の起動に失敗しました (${claudeBin}): ${err instanceof Error ? err.message : String(err)}`);
+        lastSpawnError = `claude の起動に失敗しました (${claudeBin}): ${err instanceof Error ? err.message : String(err)}`;
+        log(`ERROR ${lastSpawnError}`);
         return null;
     }
     const logs = openRunLogs(cmd.id, attempt);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tyhld/conductor",
-  "version": "0.12.81",
+  "version": "0.12.82",
   "description": "采配くん管制の見守りアプリ（conductor-agent）。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
   "type": "module",
   "bin": {

package/sales-template/install.sh

@@ -387,6 +387,172 @@ run() {
   "$@"
 }
 
+# >>> preflight >>>   ★この印の間が正本。install.sh と update-guard.sh で1文字も違わないことをテストが固定する。
+# ═════════════════════════════════════════════════════════════════════════════
+# 先頭の確かめ（職人が始まるのに要る物・便 ff8f4be9）
+#
+# 【なぜ要るか（実機 2026-10-02・ノートPC）】
+#   便 7901973d が3回続けて起動に失敗した。囲いの部品 bubblewrap・socat が入っておらず、
+#   設定 sandbox.failIfUnavailable のため職人が起動を断っていた。更新までは気づかれずに動き、
+#   更新の後に職人が始まらなくなった。また、最低版（えふさん確定 2.1.282）より古い
+#   Claude Code では中継が職人を始めない。＝設定を配る前にここで気づき、人が打つ1行を出す。
+#
+# 【決め】
+#   ・確かめるだけ。★台本が自分で sudo を打たない・勝手に入れない（人の窓）。
+#   ・Claude Code は中継（src/headless.ts の resolveClaudeBin）と同じ場所を同じ順で探し、
+#     いちばん新しい版で判定する（CONDUCTOR_CLAUDE_BIN の指定があればそれだけ）。
+#   ・囲いの部品は、その機の仕組みに要る物だけを見る。
+#       Linux（WSL を含む）… bwrap と socat
+#       Mac               … OS に組み込み（追加の部品は要らない）＝何も求めない
+#       それ以外           … 止めずに「確かめられませんでした」と出す
+#   ・出す1行は、そのままコピペで動く形（山かっこの穴埋めなし）。
+#
+# 【使い方】preflight_check <claude が無いときの扱い: need|later>
+#   結果: PREFLIGHT_NG（足りない物の説明と1行。空なら通過）／PREFLIGHT_INFO（止めない注意）
+#         ／PREFLIGHT_CLAUDE_BIN（中継が使うはずの claude・見つからなければ空）
+#   ★later … 後の段で Claude Code を入れる台本（1行インストーラ）用。無いことだけは止めない
+#     （古いときは止める）。
+# ═════════════════════════════════════════════════════════════════════════════
+# ★src/headless.ts の CLAUDE_MIN_VERSION と同じ値（テストで一致を固定）。
+PREFLIGHT_CLAUDE_MIN='2.1.282'
+
+# a が b より古いか（数字3つだけを見る。読めない字は 0＝古い扱い）。
+preflight_ver_lt() {
+  local a="${1%%-*}" b="${2%%-*}" i x y
+  local -a A B
+  IFS='.' read -r -a A <<< "$a"
+  IFS='.' read -r -a B <<< "$b"
+  for i in 0 1 2; do
+    x="${A[i]:-0}"; y="${B[i]:-0}"
+    [[ "$x" =~ ^[0-9]+$ ]] || x=0
+    [[ "$y" =~ ^[0-9]+$ ]] || y=0
+    if (( x < y )); then return 0; fi
+    if (( x > y )); then return 1; fi
+  done
+  return 1
+}
+
+# 中継と同じ候補を同じ順で出す（1行に1つ）。
+preflight_claude_candidates() {
+  if [[ -n "${CONDUCTOR_CLAUDE_BIN:-}" ]]; then
+    printf '%s\n' "$CONDUCTOR_CLAUDE_BIN"
+    return 0
+  fi
+  local d
+  local -a nv=()
+  for d in "$HOME/.nvm/versions/node"/v*; do
+    [[ -d "$d" ]] && nv+=("${d##*/}")
+  done
+  if (( ${#nv[@]} > 0 )); then
+    # 新しい node の版から（v24.21.0 → 24 21 0 で降順）
+    while IFS= read -r d; do
+      printf '%s\n' "$HOME/.nvm/versions/node/$d/bin/claude"
+    done < <(printf '%s\n' "${nv[@]}" | sort -t. -k1.2,1nr -k2,2nr -k3,3nr)
+  fi
+  printf '%s\n' "$HOME/.local/bin/claude" "$HOME/.claude/local/claude" /usr/local/bin/claude /usr/bin/claude
+}
+
+# その claude の入れ方に合う更新の1行（src/headless.ts の claudeUpdateHint と同じ見分け方）。
+preflight_claude_update_line() {
+  local bin="$1" real="$1" t i
+  # 実体を辿る（★readlink -f は使わない＝無いパスでも文字列を返すため。1段ずつ辿る）
+  for i in 1 2 3 4 5 6 7 8; do
+    [[ -L "$real" ]] || break
+    t="$(readlink "$real" 2>/dev/null || true)"
+    [[ -n "$t" ]] || break
+    case "$t" in
+      /*) real="$t" ;;
+      *)  real="$(dirname "$real")/$t" ;;
+    esac
+  done
+  case "$real$bin" in
+    */node_modules/@anthropic-ai/claude-code/*|*/.nvm/versions/node/*)
+      printf '    PATH="%s:$PATH" npm install -g @anthropic-ai/claude-code@latest\n' "$(dirname "$bin")"
+      return 0 ;;
+  esac
+  case "$real" in
+    "$HOME"/.local/share/claude/*|"$HOME"/.claude/local/*)
+      printf '    "%s" update\n' "$bin"
+      return 0 ;;
+  esac
+  printf '    （入れ方を見分けられませんでした。どちらか合う方を打ってください）\n'
+  printf '    ネイティブ導入なら: "%s" update\n' "$bin"
+  printf '    npm 導入なら      : npm install -g @anthropic-ai/claude-code@latest\n'
+}
+
+preflight_check() {
+  local claude_mode="${1:-need}" c v best='' best_v='' unknown='' os missing=''
+  PREFLIGHT_NG=''
+  PREFLIGHT_INFO=''
+  PREFLIGHT_CLAUDE_BIN=''
+
+  # ── ① Claude Code が在り、最低版以上か ──
+  while IFS= read -r c; do
+    [[ -n "$c" && -x "$c" ]] || continue
+    v="$("$c" --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -n 1 || true)"
+    if [[ -z "$v" ]]; then
+      [[ -n "$unknown" ]] || unknown="$c"
+      continue
+    fi
+    if [[ -z "$best_v" ]] || preflight_ver_lt "$best_v" "$v"; then
+      best="$c"; best_v="$v"
+    fi
+  done < <(preflight_claude_candidates)
+
+  # shellcheck disable=SC2034  # update-guard.sh の ⓪-b が使う（install.sh では使わない）
+  PREFLIGHT_CLAUDE_BIN="${best:-$unknown}"
+  if [[ -n "$best_v" ]]; then
+    if preflight_ver_lt "$best_v" "$PREFLIGHT_CLAUDE_MIN"; then
+      PREFLIGHT_NG+="■ 職人のソフト（Claude Code）が古いです（${best} = ${best_v}、必要な版 ${PREFLIGHT_CLAUDE_MIN} 以上）。"$'\n'
+      PREFLIGHT_NG+="  この機の入れ方に合う1行:"$'\n'
+      PREFLIGHT_NG+="$(preflight_claude_update_line "$best")"$'\n'
+    else
+      PREFLIGHT_INFO+="✓ 職人のソフト（Claude Code）: ${best} = ${best_v}（必要な版 ${PREFLIGHT_CLAUDE_MIN} 以上）"$'\n'
+    fi
+  elif [[ -n "$unknown" ]]; then
+    # ★中継も版の読めない claude は止めずに使う。ここでも止めない（作りをそろえる）。
+    PREFLIGHT_INFO+="⚠ 職人のソフト（Claude Code）の版を確かめられませんでした（${unknown}）。"$'\n'
+  elif [[ "$claude_mode" == "need" ]]; then
+    PREFLIGHT_NG+="■ 職人のソフト（Claude Code）が見つかりません。"$'\n'
+    PREFLIGHT_NG+="  入れる1行:"$'\n'
+    PREFLIGHT_NG+="    npm install -g @anthropic-ai/claude-code@latest"$'\n'
+  fi
+
+  # ── ② 囲いの部品（その機の仕組みに要る物だけ） ──
+  os="$(uname -s 2>/dev/null || echo unknown)"
+  case "$os" in
+    Linux)
+      command -v bwrap >/dev/null 2>&1 || missing+=' bwrap（bubblewrap）'
+      command -v socat >/dev/null 2>&1 || missing+=' socat'
+      if [[ -n "$missing" ]]; then
+        PREFLIGHT_NG+="■ 囲いの部品が足りません:${missing}"$'\n'
+        PREFLIGHT_NG+="  （無いと、職人が安全のため起動を断ります）"$'\n'
+        if command -v apt-get >/dev/null 2>&1; then
+          PREFLIGHT_NG+="  入れる1行（Ubuntu のパスワードを聞かれます）:"$'\n'
+          PREFLIGHT_NG+="    sudo apt-get install -y bubblewrap socat"$'\n'
+          # ★WSL かどうか（検査は CONDUCTOR_PROC_VERSION_FILE で見本を渡せる・既定は本物）
+          if [[ -r "${CONDUCTOR_PROC_VERSION_FILE:-/proc/version}" ]] && grep -qi microsoft "${CONDUCTOR_PROC_VERSION_FILE:-/proc/version}"; then
+            PREFLIGHT_NG+="  sudo のパスワードが分からないとき（Windows の PowerShell で打つ）:"$'\n'
+            PREFLIGHT_NG+="    wsl.exe -u root apt-get install -y bubblewrap socat"$'\n'
+          fi
+        else
+          PREFLIGHT_NG+="  この機の入れ方で bubblewrap と socat を入れてください（apt-get が見つかりません）。"$'\n'
+        fi
+      else
+        PREFLIGHT_INFO+="✓ 囲いの部品: bwrap・socat"$'\n'
+      fi
+      ;;
+    Darwin)
+      PREFLIGHT_INFO+="✓ 囲いの部品: Mac は OS に組み込み（追加の部品は要りません）"$'\n'
+      ;;
+    *)
+      PREFLIGHT_INFO+="⚠ 囲いの部品: この機（${os}）では確かめられませんでした（止めずに進みます）。"$'\n'
+      ;;
+  esac
+  [[ -z "$PREFLIGHT_NG" ]]
+}
+# <<< preflight <<<
+
 # ═════════════════════════════════════════════════════════════════════════════
 # ⓪ 引数と土台の確認
 # ═════════════════════════════════════════════════════════════════════════════
@@ -475,6 +641,22 @@ MSG
     ;;
 esac
 
+# --- 職人が始まるのに要る物（★先頭で確かめる・台本は自分で入れない） -----------
+# Claude Code がまだ無いのはかまわない（⑥で入れる）。古いとき・囲いの部品が無いときは止まる。
+PREFLIGHT_GUIDE=''
+if preflight_check later; then
+  printf '%s' "$PREFLIGHT_INFO" | sed 's/^/  /'
+else
+  printf '%s' "$PREFLIGHT_INFO" | sed 's/^/  /'
+  PREFLIGHT_GUIDE="$(printf '職人が始まるのに要る物が足りません。次の1行を打ってください。\n\n%s' "$PREFLIGHT_NG")"
+  if [[ "$DRY_RUN" == "1" ]]; then
+    printf '%s\n' "$PREFLIGHT_GUIDE" | sed 's/^/  /'
+    plan '足りない物があるため、ここで案内して止まります'
+  else
+    halt "$PREFLIGHT_GUIDE"
+  fi
+fi
+
 # --- WSL のときは systemd（常駐の仕組み）が要る -------------------------------
 # 【なぜ止めるか】systemd が無いと、采配くんの常駐（指示を受け取り続ける係）を
 #   登録できない。ここを飛ばして先へ進めると、設置は成功したように見えて
@@ -710,6 +892,11 @@ else
   record '職人: 入れた'
 fi
 
+# ★入っていた・入れた職人が、最低版以上か（古いと中継が仕事を始めない）。
+if [[ "$DRY_RUN" != "1" ]] && ! preflight_check need; then
+  halt "$(printf '職人が始まるのに要る物が足りません。次の1行を打ってください。\n\n%s' "$PREFLIGHT_NG")"
+fi
+
 # ═════════════════════════════════════════════════════════════════════════════
 # ⑦ 職人のログイン（★お客さまの手番・ここで止まることがある）
 # ═════════════════════════════════════════════════════════════════════════════

package/sales-template/setup.sh

@@ -264,7 +264,9 @@ sed_replace() {  # sed_replace <置換式> <ファイル>
 # ★常駐の生死を OS ごとに確かめる（自己点検⑦で使う）。
 service_is_running() {  # service_is_running <systemd のユニット名> <launchd のラベル>
   if [[ "$OS_KIND" == "mac" ]]; then
-    launchctl list 2>/dev/null | grep -q "[[:space:]]$2\$"
+    # ★grep -q は一致した時点で読むのをやめ、launchctl の残りの書き込みが SIGPIPE（141）になる。
+    #   pipefail の下ではそれが「動いていない」に化けるので、grep に最後まで読ませる。
+    launchctl list 2>/dev/null | grep "[[:space:]]$2\$" >/dev/null
   else
     systemctl --user is-active --quiet "$1"
   fi

package/scripts/hooks/test_policy.py

@@ -28,6 +28,12 @@ import summary_ja  # noqa: E402
 
 failures = []
 
+# ★機体に依らなくする: 採配くんの職人の中で流すと、中継が渡した CONDUCTOR_SITE・
+#   CONDUCTOR_MACHINE が入っていて、cwd から決まるはずの現場名を上書きする
+#   （ノートPCでだけ NG 3件・CI では無い）。ここで外し、上書きの試験は値を注入して確かめる。
+for _k in ('CONDUCTOR_SITE', 'CONDUCTOR_MACHINE'):
+    os.environ.pop(_k, None)
+
 
 def check(label, got, want):
     ok = got == want
@@ -1186,6 +1192,11 @@ _NEV = {'hook_event_name': 'Notification', 'notification_type': 'permission_prom
         'cwd': '/home/fshim/projects/devlog-tracker', 'session_id': 'sess-9'}
 _pay = notification_hook.build_payload(_NEV)
 check('現場名が入る', _pay['site'], 'devlog-tracker')
+os.environ['CONDUCTOR_SITE'] = 'override-site'
+try:
+    check('現場名は CONDUCTOR_SITE が cwd より先に効く', notification_hook.build_payload(_NEV)['site'], 'override-site')
+finally:
+    os.environ.pop('CONDUCTOR_SITE', None)
 check('sessionId は空でない', bool(_pay['sessionId']), True)
 check('端末で押すことが本文に書いてある', '端末' in _pay['question'], True)
 check('管制からは押せないと書いてある', '管制からは押せません' in _pay['question'], True)

package/scripts/update-guard.sh

@@ -80,6 +80,217 @@ info() { echo "[update-guard] $*"; }
 warn() { echo "[update-guard] 注意: $*" >&2; }
 fail() { echo "[update-guard] エラー: $*" >&2; exit 1; }
 
+# >>> preflight >>>   ★この印の間が正本。install.sh と update-guard.sh で1文字も違わないことをテストが固定する。
+# ═════════════════════════════════════════════════════════════════════════════
+# 先頭の確かめ（職人が始まるのに要る物・便 ff8f4be9）
+#
+# 【なぜ要るか（実機 2026-10-02・ノートPC）】
+#   便 7901973d が3回続けて起動に失敗した。囲いの部品 bubblewrap・socat が入っておらず、
+#   設定 sandbox.failIfUnavailable のため職人が起動を断っていた。更新までは気づかれずに動き、
+#   更新の後に職人が始まらなくなった。また、最低版（えふさん確定 2.1.282）より古い
+#   Claude Code では中継が職人を始めない。＝設定を配る前にここで気づき、人が打つ1行を出す。
+#
+# 【決め】
+#   ・確かめるだけ。★台本が自分で sudo を打たない・勝手に入れない（人の窓）。
+#   ・Claude Code は中継（src/headless.ts の resolveClaudeBin）と同じ場所を同じ順で探し、
+#     いちばん新しい版で判定する（CONDUCTOR_CLAUDE_BIN の指定があればそれだけ）。
+#   ・囲いの部品は、その機の仕組みに要る物だけを見る。
+#       Linux（WSL を含む）… bwrap と socat
+#       Mac               … OS に組み込み（追加の部品は要らない）＝何も求めない
+#       それ以外           … 止めずに「確かめられませんでした」と出す
+#   ・出す1行は、そのままコピペで動く形（山かっこの穴埋めなし）。
+#
+# 【使い方】preflight_check <claude が無いときの扱い: need|later>
+#   結果: PREFLIGHT_NG（足りない物の説明と1行。空なら通過）／PREFLIGHT_INFO（止めない注意）
+#         ／PREFLIGHT_CLAUDE_BIN（中継が使うはずの claude・見つからなければ空）
+#   ★later … 後の段で Claude Code を入れる台本（1行インストーラ）用。無いことだけは止めない
+#     （古いときは止める）。
+# ═════════════════════════════════════════════════════════════════════════════
+# ★src/headless.ts の CLAUDE_MIN_VERSION と同じ値（テストで一致を固定）。
+PREFLIGHT_CLAUDE_MIN='2.1.282'
+
+# a が b より古いか（数字3つだけを見る。読めない字は 0＝古い扱い）。
+preflight_ver_lt() {
+  local a="${1%%-*}" b="${2%%-*}" i x y
+  local -a A B
+  IFS='.' read -r -a A <<< "$a"
+  IFS='.' read -r -a B <<< "$b"
+  for i in 0 1 2; do
+    x="${A[i]:-0}"; y="${B[i]:-0}"
+    [[ "$x" =~ ^[0-9]+$ ]] || x=0
+    [[ "$y" =~ ^[0-9]+$ ]] || y=0
+    if (( x < y )); then return 0; fi
+    if (( x > y )); then return 1; fi
+  done
+  return 1
+}
+
+# 中継と同じ候補を同じ順で出す（1行に1つ）。
+preflight_claude_candidates() {
+  if [[ -n "${CONDUCTOR_CLAUDE_BIN:-}" ]]; then
+    printf '%s\n' "$CONDUCTOR_CLAUDE_BIN"
+    return 0
+  fi
+  local d
+  local -a nv=()
+  for d in "$HOME/.nvm/versions/node"/v*; do
+    [[ -d "$d" ]] && nv+=("${d##*/}")
+  done
+  if (( ${#nv[@]} > 0 )); then
+    # 新しい node の版から（v24.21.0 → 24 21 0 で降順）
+    while IFS= read -r d; do
+      printf '%s\n' "$HOME/.nvm/versions/node/$d/bin/claude"
+    done < <(printf '%s\n' "${nv[@]}" | sort -t. -k1.2,1nr -k2,2nr -k3,3nr)
+  fi
+  printf '%s\n' "$HOME/.local/bin/claude" "$HOME/.claude/local/claude" /usr/local/bin/claude /usr/bin/claude
+}
+
+# その claude の入れ方に合う更新の1行（src/headless.ts の claudeUpdateHint と同じ見分け方）。
+preflight_claude_update_line() {
+  local bin="$1" real="$1" t i
+  # 実体を辿る（★readlink -f は使わない＝無いパスでも文字列を返すため。1段ずつ辿る）
+  for i in 1 2 3 4 5 6 7 8; do
+    [[ -L "$real" ]] || break
+    t="$(readlink "$real" 2>/dev/null || true)"
+    [[ -n "$t" ]] || break
+    case "$t" in
+      /*) real="$t" ;;
+      *)  real="$(dirname "$real")/$t" ;;
+    esac
+  done
+  case "$real$bin" in
+    */node_modules/@anthropic-ai/claude-code/*|*/.nvm/versions/node/*)
+      printf '    PATH="%s:$PATH" npm install -g @anthropic-ai/claude-code@latest\n' "$(dirname "$bin")"
+      return 0 ;;
+  esac
+  case "$real" in
+    "$HOME"/.local/share/claude/*|"$HOME"/.claude/local/*)
+      printf '    "%s" update\n' "$bin"
+      return 0 ;;
+  esac
+  printf '    （入れ方を見分けられませんでした。どちらか合う方を打ってください）\n'
+  printf '    ネイティブ導入なら: "%s" update\n' "$bin"
+  printf '    npm 導入なら      : npm install -g @anthropic-ai/claude-code@latest\n'
+}
+
+preflight_check() {
+  local claude_mode="${1:-need}" c v best='' best_v='' unknown='' os missing=''
+  PREFLIGHT_NG=''
+  PREFLIGHT_INFO=''
+  PREFLIGHT_CLAUDE_BIN=''
+
+  # ── ① Claude Code が在り、最低版以上か ──
+  while IFS= read -r c; do
+    [[ -n "$c" && -x "$c" ]] || continue
+    v="$("$c" --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -n 1 || true)"
+    if [[ -z "$v" ]]; then
+      [[ -n "$unknown" ]] || unknown="$c"
+      continue
+    fi
+    if [[ -z "$best_v" ]] || preflight_ver_lt "$best_v" "$v"; then
+      best="$c"; best_v="$v"
+    fi
+  done < <(preflight_claude_candidates)
+
+  # shellcheck disable=SC2034  # update-guard.sh の ⓪-b が使う（install.sh では使わない）
+  PREFLIGHT_CLAUDE_BIN="${best:-$unknown}"
+  if [[ -n "$best_v" ]]; then
+    if preflight_ver_lt "$best_v" "$PREFLIGHT_CLAUDE_MIN"; then
+      PREFLIGHT_NG+="■ 職人のソフト（Claude Code）が古いです（${best} = ${best_v}、必要な版 ${PREFLIGHT_CLAUDE_MIN} 以上）。"$'\n'
+      PREFLIGHT_NG+="  この機の入れ方に合う1行:"$'\n'
+      PREFLIGHT_NG+="$(preflight_claude_update_line "$best")"$'\n'
+    else
+      PREFLIGHT_INFO+="✓ 職人のソフト（Claude Code）: ${best} = ${best_v}（必要な版 ${PREFLIGHT_CLAUDE_MIN} 以上）"$'\n'
+    fi
+  elif [[ -n "$unknown" ]]; then
+    # ★中継も版の読めない claude は止めずに使う。ここでも止めない（作りをそろえる）。
+    PREFLIGHT_INFO+="⚠ 職人のソフト（Claude Code）の版を確かめられませんでした（${unknown}）。"$'\n'
+  elif [[ "$claude_mode" == "need" ]]; then
+    PREFLIGHT_NG+="■ 職人のソフト（Claude Code）が見つかりません。"$'\n'
+    PREFLIGHT_NG+="  入れる1行:"$'\n'
+    PREFLIGHT_NG+="    npm install -g @anthropic-ai/claude-code@latest"$'\n'
+  fi
+
+  # ── ② 囲いの部品（その機の仕組みに要る物だけ） ──
+  os="$(uname -s 2>/dev/null || echo unknown)"
+  case "$os" in
+    Linux)
+      command -v bwrap >/dev/null 2>&1 || missing+=' bwrap（bubblewrap）'
+      command -v socat >/dev/null 2>&1 || missing+=' socat'
+      if [[ -n "$missing" ]]; then
+        PREFLIGHT_NG+="■ 囲いの部品が足りません:${missing}"$'\n'
+        PREFLIGHT_NG+="  （無いと、職人が安全のため起動を断ります）"$'\n'
+        if command -v apt-get >/dev/null 2>&1; then
+          PREFLIGHT_NG+="  入れる1行（Ubuntu のパスワードを聞かれます）:"$'\n'
+          PREFLIGHT_NG+="    sudo apt-get install -y bubblewrap socat"$'\n'
+          # ★WSL かどうか（検査は CONDUCTOR_PROC_VERSION_FILE で見本を渡せる・既定は本物）
+          if [[ -r "${CONDUCTOR_PROC_VERSION_FILE:-/proc/version}" ]] && grep -qi microsoft "${CONDUCTOR_PROC_VERSION_FILE:-/proc/version}"; then
+            PREFLIGHT_NG+="  sudo のパスワードが分からないとき（Windows の PowerShell で打つ）:"$'\n'
+            PREFLIGHT_NG+="    wsl.exe -u root apt-get install -y bubblewrap socat"$'\n'
+          fi
+        else
+          PREFLIGHT_NG+="  この機の入れ方で bubblewrap と socat を入れてください（apt-get が見つかりません）。"$'\n'
+        fi
+      else
+        PREFLIGHT_INFO+="✓ 囲いの部品: bwrap・socat"$'\n'
+      fi
+      ;;
+    Darwin)
+      PREFLIGHT_INFO+="✓ 囲いの部品: Mac は OS に組み込み（追加の部品は要りません）"$'\n'
+      ;;
+    *)
+      PREFLIGHT_INFO+="⚠ 囲いの部品: この機（${os}）では確かめられませんでした（止めずに進みます）。"$'\n'
+      ;;
+  esac
+  [[ -z "$PREFLIGHT_NG" ]]
+}
+# <<< preflight <<<
+
+info "⓪ 職人が始まるのに要る物の確かめ（★設定を配る前・ここで足りなければ1バイトも配りません）"
+if preflight_check need; then
+  printf '%s' "$PREFLIGHT_INFO" | sed 's/^/[update-guard]    /'
+else
+  printf '%s' "$PREFLIGHT_INFO" | sed 's/^/[update-guard]    /'
+  printf '%s' "$PREFLIGHT_NG" | sed 's/^/[update-guard]    /' >&2
+  if [[ "$SYNC_ONLY" == "1" ]]; then
+    # ★同期モード（無人・1時間ごと）は設定の中身を作り変えない（番人のコードと配線だけ）。
+    #   ここで止めると番人の直しまで届かなくなるので、知らせて続ける。
+    warn "職人が始まるのに要る物が足りません（上記）。同期モードなので番人のコードと配線だけ続けます。"
+  else
+    warn "職人が始まるのに要る物が足りません（上記）。★設定は1バイトも配っていません。"
+    warn "  上の1行を打ってから、もう一度このスクリプトを流してください。"
+    exit 1
+  fi
+fi
+
+# ─── ⓪-b 職人が管制へ知らせる口（ai-kana の MCP）が使えるか（★確認だけのときだけ・止めない） ───
+# 【なぜ要るか（実機 2026-10-02・便 fb248f6e）】職人の会話に ai-kana の道具が1つも出ず、完了の知らせ
+#   （conductor_complete）も開発履歴の読み取りもできなかった。便を配る前に人が気づけるよう、
+#   確認だけのときに `claude mcp list` の結果を1行で出す。
+# ★確認だけ（APPLY なし・同期モードでない）のときだけ流す＝適用・1時間ごとの同期では外へ問い合わせない。
+# ★鍵・トークンの値は読まない・出さない（出すのは「つながっているか」だけ）。
+if [[ "$APPLY" != "1" && "$SYNC_ONLY" != "1" && -n "${PREFLIGHT_CLAUDE_BIN:-}" ]]; then
+  info "⓪-b 職人が管制へ知らせる口（ai-kana）の確かめ（確認だけ・止めません）"
+  if command -v timeout >/dev/null 2>&1; then
+    mcp_out="$(timeout 60 "$PREFLIGHT_CLAUDE_BIN" mcp list 2>/dev/null || true)"
+  else
+    mcp_out="$("$PREFLIGHT_CLAUDE_BIN" mcp list 2>/dev/null || true)"
+  fi
+  mcp_ok="$(printf '%s\n' "$mcp_out" | grep -E '^(claude\.ai )?ai-kana: .*Connected' | sed -E 's/: .* - /: /' || true)"
+  mcp_ng="$(printf '%s\n' "$mcp_out" | grep -E '^(claude\.ai )?ai-kana: ' | grep -v 'Connected' | sed -E 's/: .* - /: /' || true)"
+  if [[ -n "$mcp_ok" ]]; then
+    printf '%s\n' "$mcp_ok" | sed 's/^/[update-guard]    ✓ /'
+    [[ -z "$mcp_ng" ]] || printf '%s\n' "$mcp_ng" | sed 's/^/[update-guard]    （予備・使っていない）/'
+  else
+    warn "職人が管制へ知らせる口（ai-kana）がつながっていません。便は動きますが、完了の知らせと開発履歴の読み書きができません。"
+    [[ -z "$mcp_ng" ]] || printf '%s\n' "$mcp_ng" | sed 's/^/[update-guard]    /' >&2
+    warn "  人の手番（1手ずつ）: ① Ubuntu の画面で claude と打つ ② 画面の中で /mcp と打つ"
+    warn "    ③ ai-kana を選んで Enter → Authenticate を選ぶ ④ 開いたブラウザでログインする ⑤ /exit で閉じる"
+    warn "    （claude.ai ai-kana のほうは https://claude.ai の設定 → コネクタ で ai-kana を有効にする）"
+  fi
+fi
+
+
 # ─── ①-src 配り元を決める（★公開済みの正規版だけ・便 4061dd71） ──────────────
 # 【なぜ要るか（実測 2026-09-16・開発履歴 6b405ae6）】
 #   1時間ごとの自動同期の本体が /home/fshim/projects/conductor/scripts/update-guard.sh