@tyhld/conductor 0.12.85 → 0.12.87

package/dist/selfcheck.js

@@ -20,7 +20,7 @@
  *
  * 【結果】手元の控え（~/.local/state/conductor/selfcheck/last.json と history/）に必ず残す。
  *   管制の口が在れば送る（★口が無い・届かないときも落ちない＝送れなかったことを控えに書くだけ）。
- *   送る中身は buildSelfcheckPayload の1か所（口の形は ai-kana の便 2f5eb92c が決める）。
+ *   送る中身は buildSelfcheckPayload の1か所（口の形は ai-kana の便 2f5eb92c が決めた形・便 29babc5d で合わせた）。
  */
 import { spawnSync } from 'node:child_process';
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync, } from 'node:fs';
@@ -33,7 +33,12 @@ import { readDrain } from './autoupdate-flags.js';
 // ─────────────────────────────────────────────────────────────────────────────
 // 形
 // ─────────────────────────────────────────────────────────────────────────────
-export const SELFCHECK_TRIGGERS = ['daily', 'after-conductor', 'after-claude', 'after-rollback', 'manual'];
+/**
+ * きっかけの名前。管制が知っているのは daily / after-conductor / after-claude / after-rollback の4つで、
+ * 知らない語（manual・candidate）は管制が null に倒す（便 2f5eb92c の決まり）。
+ *   candidate … 更新係が新しい候補の版を見つけたときに流す（候補を管制へ届けるため・便 29babc5d）
+ */
+export const SELFCHECK_TRIGGERS = ['daily', 'after-conductor', 'after-claude', 'after-rollback', 'manual', 'candidate'];
 export const defaultExec = (cmd, args, opts = {}) => {
     const r = spawnSync(cmd, args, {
         cwd: opts.cwd,
@@ -57,8 +62,16 @@ export const defaultExec = (cmd, args, opts = {}) => {
 export function selfcheckDir(home) {
     return path.join(home, '.local', 'state', 'conductor', 'selfcheck');
 }
-/** 管制の受け口（★1か所。口の形は ai-kana の便 2f5eb92c に合わせてここだけ直す）。 */
-export const SELFCHECK_ENDPOINT = '/api/conductor/selfcheck';
+/**
+ * 管制の受け口（★1か所）。ai-kana の便 2f5eb92c が作った「機体の自己診断の結果と版を受ける口」。
+ *   ★以前は /api/conductor/selfcheck へ別の形で送っていて、管制に届いていなかった（便 29babc5d で直した）。
+ */
+export const SELFCHECK_ENDPOINT = '/api/conductor/machines/selfcheck';
+/**
+ * Claude Code の公式の安定版の番号が置かれている所（★公式の導入台本 https://claude.ai/install.sh が
+ * 版を取りに行くのと同じ置き場。2026-10-02 に台本の中身で確かめた・stable=2.1.285）。
+ */
+export const CLAUDE_STABLE_URL = 'https://downloads.claude.ai/claude-code-releases/stable';
 /** 控えの数の上限（古い物から消す）。 */
 export const SELFCHECK_HISTORY_MAX = 30;
 /** 小さな試験の上限時間。 */
@@ -367,9 +380,10 @@ export function npmBesideNode(execPath = process.execPath) {
     const beside = path.join(path.dirname(execPath), 'npm');
     return existsSync(beside) ? beside : null;
 }
-/** ⑤ GitHub・npm（外側。内側は小さな試験の後で足す） */
+/** ⑤ GitHub・npm（外側。内側は小さな試験の後で足す）。公開 npm の latest も返す（候補に使う）。 */
 function checkNetworkOutside(d, version) {
     const item = { key: 'network', label: 'GitHub・npm への通信', ok: null, detail: [] };
+    let latest = null;
     const npm = d.findNpm();
     if (!npm)
         fail(item, 'fault', `配布物の node の隣に npm がありません（${path.dirname(process.execPath)}）`);
@@ -377,6 +391,8 @@ function checkNetworkOutside(d, version) {
         const env = { ...d.env, PATH: `${path.dirname(npm)}:${d.env.PATH ?? ''}` };
         const r = d.exec(npm, ['view', '@tyhld/conductor', 'version', '--@tyhld:registry=https://registry.npmjs.org'], { env, timeoutMs: 60_000 });
         const v = r.stdout.trim().match(/^\d+\.\d+\.\d+\S*/)?.[0];
+        if (r.status === 0 && v)
+            latest = v;
         if (r.status === 0 && v)
             pass(item, `公開 npm の @tyhld/conductor = ${v}${version && v !== version ? `（この機は ${version}）` : ''}`);
         else
@@ -400,7 +416,35 @@ function checkNetworkOutside(d, version) {
         else
             fail(item, 'fault', `GitHub の API へ届きません（終了 ${api.status}）`);
     }
-    return item;
+    return { item, latest };
+}
+const SEMVER = /^\d+\.\d+\.\d+$/;
+/** 公式の安定版の番号を聞く（★取れなければ null・自己診断の合否には使わない）。 */
+export async function fetchClaudeStable(fetchImpl) {
+    try {
+        const res = await fetchImpl(CLAUDE_STABLE_URL, { redirect: 'manual', signal: AbortSignal.timeout(15_000) });
+        if (!res.ok)
+            return null;
+        const v = (await res.text()).trim();
+        return SEMVER.test(v) ? v : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 候補の版（入っている版より新しい物だけ）。★先行機かどうかはこの機では決めない（管制が決める）。
+ *   conductor   … 公開 npm の latest
+ *   claude-code … 公式の安定版（えふさん確定 2026-10-02 夜：安定版を追う）
+ */
+export function pickCandidates(installed, found) {
+    const out = [];
+    const newer = (v, now) => v !== null && SEMVER.test(v) && (now === null || !SEMVER.test(now) || compareVersions(v, now) > 0);
+    if (newer(found.conductor, installed.conductor))
+        out.push({ component: 'conductor', version: found.conductor });
+    if (newer(found.claude, installed.claude))
+        out.push({ component: 'claude-code', version: found.claude });
+    return out;
 }
 /** 囲いの設定だけを配布物の雛形から取り出す（★作業場所が現場と同じ囲いになるように）。 */
 function siteSettingsFor(distRoot) {
@@ -499,18 +543,41 @@ function checkGuard(d, work) {
     }
     return item;
 }
-/** 管制へ送る中身（★1か所）。口の形が決まったらここだけ合わせる。 */
+/** 項目ごとの合否（管制の checks）。見られなかった項目は skip。 */
+export function checksOf(r) {
+    const out = {};
+    for (const i of r.items)
+        out[i.key] = i.ok === true ? 'pass' : i.ok === false ? 'fail' : 'skip';
+    return out;
+}
+/**
+ * 管制へ送る中身（★1か所）。管制の決まり（便 2f5eb92c・POST /api/conductor/machines/selfcheck）の欄で送る。
+ *   必須: machine・result（★小文字の "pass" / "fail"）
+ *   決まりの欄: trigger・checks・conductorVersion・conductorBin・claudeVersion・claudeBin・rolledBack・
+ *             humanActionKind・humanActionCommand・candidates
+ *   ★いままでの詳しい中身（items・humanActions・mcp・drain・claudePin・usage）も一緒に載せる
+ *     （管制は知らない欄を黙って捨てる＝害が無い。手元の控えと同じ中身を残しておける）。
+ *   ★rolledBack は「直前に旧版へ戻したか」＝きっかけが after-rollback のときだけ true。
+ *   ★人の手番は管制の行が1つなので、最初の1件を載せる（全部は humanActions に在る）。
+ */
 export function buildSelfcheckPayload(r) {
+    const first = r.humanActions[0];
     return {
         schema: r.schema,
         machine: r.machine,
         trigger: r.trigger,
-        result: r.result,
+        result: r.result === 'PASS' ? 'pass' : 'fail',
+        checks: checksOf(r),
         startedAt: r.startedAt,
         finishedAt: r.finishedAt,
         conductorVersion: r.conductorVersion,
+        conductorBin: r.conductorBin,
         claudeVersion: r.claude.version,
         claudeBin: r.claude.bin,
+        rolledBack: r.trigger === 'after-rollback',
+        humanActionKind: first ? first.what : null,
+        humanActionCommand: first ? first.command : null,
+        candidates: r.candidates,
         claudePin: r.claude.pin.state === 'none' ? null : r.claude.pin,
         drain: r.drain,
         mcp: r.mcp,
@@ -556,8 +623,21 @@ export async function sendSelfcheck(d, r) {
             signal: AbortSignal.timeout(20_000),
         });
         const json = (res.headers.get('content-type') ?? '').includes('application/json');
-        if (res.ok && json)
+        if (res.ok && json) {
+            // ★管制は表がまだ無い（SQL を貼る前）とき 200 で { ok:false, note:「まだ準備中」 } と答える。
+            //   受け取られていないので「送れた」と数えない（落ちもしない）。
+            let body = {};
+            try {
+                body = (await res.json());
+            }
+            catch {
+                return { sent: false, detail: `HTTP ${res.status}（答えを読めません）` };
+            }
+            if (body.ok === false) {
+                return { sent: false, detail: `HTTP ${res.status}（管制は受け取っていません: ${typeof body.note === 'string' ? body.note : '理由なし'}）` };
+            }
             return { sent: true, detail: `HTTP ${res.status}` };
+        }
         if (res.ok || (res.status >= 300 && res.status < 400)) {
             return { sent: false, detail: `HTTP ${res.status}（JSON の答えではない＝管制にまだ受け口がありません）` };
         }
@@ -578,7 +658,8 @@ export async function runSelfcheck(d, trigger) {
         const claude = checkClaude(d);
         const central = await checkCentral(d);
         const sandbox = checkSandboxParts(d);
-        const network = checkNetworkOutside(d, version);
+        const net = checkNetworkOutside(d, version);
+        const network = net.item;
         const guard = checkGuard(d, path.join(runDir, 'work'));
         // ⑥ 小さな試験（③の MCP・④の書き込み・⑤の内側の通信もここで見る）
         const headless = { key: 'headless', label: '小さな headless 試験', ok: null, detail: [] };
@@ -640,6 +721,7 @@ export async function runSelfcheck(d, trigger) {
         }
         const items = [conductor, claude.item, central, sandbox, network, headless, guard];
         const humanActions = items.flatMap((i) => i.human ?? []);
+        const candidates = pickCandidates({ conductor: version, claude: claude.version }, { conductor: net.latest, claude: await fetchClaudeStable(d.fetchImpl) });
         return {
             schema: 'conductor-selfcheck/1',
             machine: d.machine,
@@ -661,6 +743,8 @@ export async function runSelfcheck(d, trigger) {
                     durationMs: sum.result.durationMs,
                 }
                 : null,
+            conductorBin: path.join(d.distRoot, 'dist', 'cli.js'),
+            candidates,
         };
     }
     finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tyhld/conductor",
-  "version": "0.12.85",
+  "version": "0.12.87",
   "description": "采配くん管制の見守りアプリ（conductor-agent）。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
   "type": "module",
   "bin": {
@@ -23,6 +23,8 @@
     "scripts/dist-source.sh",
     "scripts/conductor-run.sh",
     "scripts/tyhld-selfcheck.sh",
+    "scripts/tyhld-autoupdate.sh",
+    "scripts/autoupdate-install.sh",
     "scripts/kc.sh",
     "scripts/codex",
     "!scripts/codex/__pycache__",

package/sales-template/install.sh

@@ -106,6 +106,12 @@ APT_PACKAGES=(
   python3-pip
   python3-venv
   rsync
+  # ★囲い（sandbox）の部品。無いと職人が起動を断る（設定 sandbox.failIfUnavailable のため）。
+  #   えふさん確定 2026-10-02・判断1(b)＝1行インストーラでここまで入れる。
+  #   実物（2026-10-02・ノートPC）: これが無くて便 7901973d が3回続けて起動に失敗した。
+  #   ★先頭の確かめ（preflight）は残す＝入れられなかった機では止まって案内する。
+  bubblewrap        # 囲いの本体。職人の書き込みを決めた場所だけに閉じる
+  socat             # 囲いの中と外をつなぐ通信の中継
 )
 
 # 確認だけモード（何も入れない・何も聞かない）。
@@ -387,7 +393,7 @@ run() {
   "$@"
 }
 
-# >>> preflight >>>   ★この印の間が正本。install.sh と update-guard.sh で1文字も違わないことをテストが固定する。
+# >>> preflight >>>   ★この印の間が正本。install.sh・update-guard.sh・setup.sh の3つで1文字も違わないことをテストが固定する。
 # ═════════════════════════════════════════════════════════════════════════════
 # 先頭の確かめ（職人が始まるのに要る物・便 ff8f4be9）
 #
@@ -432,6 +438,14 @@ preflight_ver_lt() {
   return 1
 }
 
+# ホームの外の置き場（★src/headless.ts の CLAUDE_SYSTEM_BIN_DIRS と同じ・テストで一致を固定）。
+#   ★検査だけが作り物のフォルダに差し替える（CONDUCTOR_PREFLIGHT_SYSTEM_DIRS）。
+#     HOME を隔離してもここは絶対パスなので、機体に claude が在ると検査が機体に依って落ちる
+#     （実測 2026-10-02 メインPC: /usr/bin/claude = 2.1.86）。中継の側は便 ff8f4be9 で
+#     同じ差し替え（resolveClaudeBin(systemDirs)）を入れてある。作りをそろえる。
+#   ★差し替えても安全は変わらない（探す場所が変わるだけ・見つからなければ need では止まる）。
+PREFLIGHT_SYSTEM_BIN_DIRS="${CONDUCTOR_PREFLIGHT_SYSTEM_DIRS-/usr/local/bin:/usr/bin}"
+
 # 中継と同じ候補を同じ順で出す（1行に1つ）。
 preflight_claude_candidates() {
   if [[ -n "${CONDUCTOR_CLAUDE_BIN:-}" ]]; then
@@ -440,6 +454,7 @@ preflight_claude_candidates() {
   fi
   local d
   local -a nv=()
+  local -a sysdirs=()
   for d in "$HOME/.nvm/versions/node"/v*; do
     [[ -d "$d" ]] && nv+=("${d##*/}")
   done
@@ -449,7 +464,12 @@ preflight_claude_candidates() {
       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
+  printf '%s\n' "$HOME/.local/bin/claude" "$HOME/.claude/local/claude"
+  IFS=':' read -r -a sysdirs <<< "$PREFLIGHT_SYSTEM_BIN_DIRS"
+  for d in ${sysdirs[@]+"${sysdirs[@]}"}; do
+    [[ -n "$d" ]] && printf '%s\n' "$d/claude"
+  done
+  return 0
 }
 
 # その claude の入れ方に合う更新の1行（src/headless.ts の claudeUpdateHint と同じ見分け方）。

package/sales-template/setup.sh

@@ -287,6 +287,207 @@ else
 fi
 SVC_RESTART_HINT="${SVC_RESTART_CMD} を実行してください"
 
+# ─── ⓪ 職人が始まるのに要る物の確かめ（★install.sh・update-guard.sh と同じ正本） ──
+# 【なぜ setup.sh にも入れるか（えふさん確定 2026-10-02・判断5-1／前便 ff8f4be9 の要判断3）】
+#   setup.sh を単独で打つ道（Mac・試作の型・開発機の作り直し）は、1行インストーラを通らない。
+#   その道だけ確かめが無いと、囲いの部品が無い機・古い Claude Code の機に設置してしまい、
+#   設置は成功したのに職人が1件も始まらない（実物 2026-10-02・便 7901973d が3回続けて起動失敗）。
+# ★印の間は3つの台本で1文字も違わない（test/preflight.test.ts が固定する）。ここを手で直さない。
+# >>> preflight >>>   ★この印の間が正本。install.sh・update-guard.sh・setup.sh の3つで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
+}
+
+# ホームの外の置き場（★src/headless.ts の CLAUDE_SYSTEM_BIN_DIRS と同じ・テストで一致を固定）。
+#   ★検査だけが作り物のフォルダに差し替える（CONDUCTOR_PREFLIGHT_SYSTEM_DIRS）。
+#     HOME を隔離してもここは絶対パスなので、機体に claude が在ると検査が機体に依って落ちる
+#     （実測 2026-10-02 メインPC: /usr/bin/claude = 2.1.86）。中継の側は便 ff8f4be9 で
+#     同じ差し替え（resolveClaudeBin(systemDirs)）を入れてある。作りをそろえる。
+#   ★差し替えても安全は変わらない（探す場所が変わるだけ・見つからなければ need では止まる）。
+PREFLIGHT_SYSTEM_BIN_DIRS="${CONDUCTOR_PREFLIGHT_SYSTEM_DIRS-/usr/local/bin:/usr/bin}"
+
+# 中継と同じ候補を同じ順で出す（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=()
+  local -a sysdirs=()
+  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"
+  IFS=':' read -r -a sysdirs <<< "$PREFLIGHT_SYSTEM_BIN_DIRS"
+  for d in ${sysdirs[@]+"${sysdirs[@]}"}; do
+    [[ -n "$d" ]] && printf '%s\n' "$d/claude"
+  done
+  return 0
+}
+
+# その 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 <<<
+
+step "⓪ 職人が始まるのに要る物の確かめ（★ここで足りなければ1つも置きません）"
+# ★`later`（職人が【無いこと】だけはここで止めない）を使う理由。
+#   setup.sh は Claude Code を入れないが、「無い」ときの案内は ① が持っている
+#   （入れる2行＋ログインの手順＝お客さまがそのまま読める形）。ここで `need` にすると
+#   その案内に届かず、短い1行だけで終わってしまう。★古い版・囲いの部品不足は、ここで止める。
+if preflight_check later; then
+  if [[ -n "$PREFLIGHT_INFO" ]]; then printf '%s' "$PREFLIGHT_INFO"; fi
+else
+  printf '%s' "$PREFLIGHT_INFO" >&9
+  echo >&9
+  printf '%s' "$PREFLIGHT_NG" >&9
+  echo "[setup] 上の1行を打ってから、もう一度 setup.sh を実行してください。" >&9
+  exit 1
+fi
+
 # ─── ① 前提チェック ──────────────────────────────────────────────────────────
 step "① 前提チェック"