@tyhld/conductor 0.12.81 → 0.12.83

package/dist/view.js

@@ -8,6 +8,8 @@
  *   ＝「見えない」だけでなく「触ると危ない」状態だった。
  *
  * 【この画面の約束（えふさん確定 2026-10-02）】
+ *   ⓪ 既定は「開いたまま流れ続ける」（判断7・便 a56e49bf）。流れ続ける部分は
+ *      src/view-stream.ts に置く。このファイルは「いまの様子を1回出す」（--once）形を持つ。
  *   ① 通常＝人間向けの日本語／詳細＝Claude Code の生ログ の2段構成。
  *      以前の画面をそのまま流すのではなく、非エンジニアが読んで分かる形にする。
  *   ② 「🟠 作業中」と出してよいのは、実プロセスが動いている ＋ 最近の作業記録がある
@@ -472,27 +474,40 @@ export function readRawLogLines(v) {
 // 入口（cli.ts が呼ぶ）
 // ─────────────────────────────────────────────────────────────────────────────
 /**
- * `conductor view <現場名> [--detail]` の本体。
- * ★何も起動しない・通信しない・入力を受け付けない。画面に出して終わる。
+ * `conductor view <現場名> [--once] [--detail]` の本体。
+ * ★何も起動しない・通信しない・入力を受け付けない。
+ *
+ * 【既定は「開いたまま流れ続ける」（えふさん確定 2026-10-02・判断7）】
+ *   画面あり方式の頃のように、開いておけば職人の動きが下へ流れ続ける。
+ *   Ctrl+C で抜ける（★抜けても職人・見守り役には何も起きない）。
+ * 【--once】これまでどおり「いまの様子を1回出して終わる」（古い呼び方を壊さない）。
+ * 【--detail】生の記録（秘密は隠したもの）も続けて出す。意味は変えない。
  */
-export function runViewCommand(argv) {
+export async function runViewCommand(argv) {
     const detail = argv.includes('--detail');
+    const once = argv.includes('--once');
     const site = argv.find((a) => !a.startsWith('-'));
     if (site === undefined || site.length === 0) {
-        console.error('使い方: conductor view <現場名> [--detail]');
+        console.error('使い方: conductor view <現場名> [--once] [--detail]');
         return 2;
     }
-    // ★現場のフォルダが無い＝この PC の現場ではない。何も作らずに知らせる。
+    // ★現場のフォルダが無い＝この PC の現場ではない。何も作らずに、次の1手を添えて知らせる。
     const projectDir = path.join(os.homedir(), 'projects', site);
     if (!existsSync(projectDir)) {
         console.error(`そんな現場はありません: ${site}`);
+        console.error('次の1手：このPCの現場の名前は ls ~/projects で確かめられます（大文字小文字も合わせてください）。');
         return 1;
     }
-    const v = collectSiteView(site);
-    console.log(renderNormalView(v));
-    if (detail) {
-        console.log('');
-        console.log(renderDetailView(v, readRawLogLines(v)));
+    if (once) {
+        const v = collectSiteView(site);
+        console.log(renderNormalView(v));
+        if (detail) {
+            console.log('');
+            console.log(renderDetailView(v, readRawLogLines(v)));
+        }
+        return 0;
     }
-    return 0;
+    // ★流れ続ける画面は別のファイルに置く（--once の道は1バイトも変えない）。
+    const { runFollowCommand } = await import('./view-stream.js');
+    return runFollowCommand(site, detail);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tyhld/conductor",
-  "version": "0.12.81",
+  "version": "0.12.83",
   "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