@tyhld/conductor 0.12.80 → 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/cli.js

@@ -195,6 +195,9 @@ async function sendReport(cfg) {
             body.undeliveredSec = d.undeliveredSec;
         if (d.queuedCommandId !== null)
             body.queuedCommandId = d.queuedCommandId;
+        // ★配った便の完了待ちの長さ（'waiting-done' のときだけ）。管制が長すぎる待ちを見つけられる。
+        if (d.waitingSec !== null)
+            body.waitingSec = d.waitingSec;
     }
     // ★未処理の報告（まだ管制へ渡せていない控え）の指示IDを載せる（便 57c04e6d）。
     //   1件も無ければ載せない＝今までと同じ本文。多すぎるときは上限までにして総数を添える。
@@ -348,6 +351,10 @@ async function start(args) {
         }
         nudgeWatcher = watchNudges(cfg.site, () => {
             console.log(`[relay] site=${cfg.site} 耳から合図 → 指示の取得を前倒しします`);
+            // ★合図が空振りしたときに理由を1行出せるよう、受けた時刻を relay へ渡す（案B-3）。
+            //   relayTick が「前の周が走行中」「追跡中」で return するとき、しぼり付きで理由を記録する。
+            if (relayStateForReport)
+                relayStateForReport.nudgedAt = Date.now();
             void relayRunner?.run();
         });
     }

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/dist/relay.js

@@ -239,6 +239,8 @@ export function createRelayState() {
         abandoned: new Set(),
         promptPending: false,
         busyRaisedId: null,
+        nudgedAt: null,
+        lastNudgeLogAt: null,
         central: { failures: 0, detail: '', downSince: null },
         readiness: createReadiness(),
     };
@@ -277,12 +279,58 @@ export function noteReadiness(state, next, commandId, now = Date.now()) {
 export function deliveryReport(state, now = Date.now()) {
     const r = state.readiness;
     const blocked = BLOCKED_STATES.has(r.state) && r.commandId !== null;
+    const waiting = r.state === 'waiting-done' && r.commandId !== null;
     return {
         deliveryState: r.state,
         queuedCommandId: blocked ? r.commandId : null,
         undeliveredSec: blocked ? Math.max(0, Math.round((now - r.since) / 1000)) : null,
+        waitingSec: waiting ? Math.max(0, Math.round((now - r.since) / 1000)) : null,
     };
 }
+/**
+ * 配った便の完了を待っている1周を記録する（★無言の周をなくす・案B-2）。
+ *
+ * 【なぜ要るか】追跡中(pending)の周は、理由を1行も書かずに return する経路が複数あった。
+ *   `noteBusyEdge` は【変わり目だけ】出す設計なので、同じ状態が続く限り何も出ない。
+ *   「作業中の可能性ありスキップ」のログは pending が無い周にしか到達しない。
+ *   ＝実機 2026-10-02 は、空の入力待ち画面を「作業中」と誤読したまま10分以上、
+ *   現場のログに1行も出なかった。**この1行があれば即座に原因が分かった。**
+ *
+ * 【★画面をどう読んだかを必ず書く】これが要。「経過」だけでは誤読に気づけない。
+ * 【★記録を埋めない】生存通知と同じしぼり（RELAY_HEARTBEAT_INTERVAL_MS=150秒）に相乗りする。
+ *
+ * @returns 実際に1行出したら true（しぼりで出さなかったら false）。
+ */
+export function noteWaitingDone(state, site, screen, askedCentral, logLine, now = Date.now()) {
+    const p = state.pending;
+    if (p === null)
+        return false;
+    const last = p.lastWaitLogAt ?? null;
+    if (last !== null && now - last < RELAY_HEARTBEAT_INTERVAL_MS)
+        return false;
+    p.lastWaitLogAt = now;
+    logLine(`site=${site} id=${p.id} 完了待ち（経過${Math.max(0, Math.round((now - p.sentAt) / 1000))}s` +
+        `・画面=${screen}・中央へ問い合わせ=${askedCentral ? 'した' : 'しない'}）`);
+    return true;
+}
+/**
+ * 合図（耳からの「今すぐ1周」）を受けたのに取得へ進まなかった理由を1行出す（★案B-3）。
+ *   ★しぼり（RELAY_HEARTBEAT_INTERVAL_MS）付き＝記録を埋めない。出したら合図は消費する。
+ *
+ * @returns 実際に1行出したら true。
+ */
+export function noteNudgeSkipped(state, site, reason, logLine, now = Date.now()) {
+    if (state.nudgedAt === null)
+        return false;
+    state.nudgedAt = null; // 合図は1回ぶん。消費して次の合図を待つ。
+    if (state.lastNudgeLogAt !== null &&
+        now - state.lastNudgeLogAt < RELAY_HEARTBEAT_INTERVAL_MS) {
+        return false;
+    }
+    state.lastNudgeLogAt = now;
+    logLine(`site=${site} 合図を受けましたが${reason}のため、この周では指示を取得しません`);
+    return true;
+}
 /**
  * 管制へつながらないときの、次の再試行までの待ち時間(ms)。純粋関数（I/Oなし＝単体テスト可能）。
  *
@@ -425,6 +473,16 @@ export const CODEX_MARKERS = [
 export const CODEX_BUSY_MARKERS = ['esc to interrupt', 'working ('];
 /** Codex の選択メニューのカーソル（実測: U+203A）。★Claude の `❯`(U+276F) とは別物。 */
 export const CODEX_MENU_CURSOR = '›';
+/**
+ * Codex の「待機」に要求する、入力欄の行の位置（末尾から何行以内か）。
+ *
+ * 【根拠（実測）】0.160.0 の起動画面は末尾の空行を落とすと
+ *   `› Ask Codex to do anything` / 空行 / `GPT-6.1-Sol default · ~/codex-probe` / `? for shortcuts`
+ *   ＝入力欄は末尾から4行目。0.152.1 の待機画面は末尾から2〜3行目（test/relay-agent-kind.test.ts）。
+ *   余裕を見て8行に取る。★画面を覆う表示（警告・全画面のダイアログ）では入力欄が
+ *   1行も見えないので、何行に取っても弾ける＝この値は「見えている待機」を取りこぼさないための幅。
+ */
+export const CODEX_IDLE_INPUT_WITHIN_LINES = 8;
 /**
  * 種類ごとの目印を返す。★関数にしてあるのは、定数の宣言順に縛られないようにするため
  * （CLAUDE_MARKERS などはこの下で宣言される）。
@@ -434,29 +492,52 @@ export function agentProfile(kind) {
         return {
             markers: CODEX_MARKERS,
             busyMarkers: CODEX_BUSY_MARKERS,
+            // ★Codex は回転印を見ない（起動画面の点字ロゴを作業中と誤読する＝調査 67f8c51f）。
+            busyGlyphs: [],
             cursor: CODEX_MENU_CURSOR,
             idleRule: 'not-busy',
+            idleInputLineWithin: CODEX_IDLE_INPUT_WITHIN_LINES,
         };
     }
     return {
         markers: CLAUDE_MARKERS,
         busyMarkers: BUSY_MARKERS,
+        // ★claude は従来どおり BUSY_GLYPHS そのまま（判定を1文字も変えない）。
+        busyGlyphs: BUSY_GLYPHS,
         cursor: '❯',
         idleRule: 'prompt',
+        idleInputLineWithin: null,
     };
 }
 /** 種類を見て「作業中か」を判定する。claude は従来の hasBusySignal と同一。 */
 export function hasBusySignalFor(text, kind) {
     if (kind === 'claude')
         return hasBusySignal(text);
+    const profile = agentProfile(kind);
     const regionText = busyScanRegion(text);
     const lower = regionText.toLowerCase();
-    if (agentProfile(kind).busyMarkers.some((m) => lower.includes(m)))
+    if (profile.busyMarkers.some((m) => lower.includes(m)))
         return true;
-    if (BUSY_GLYPHS.some((g) => regionText.includes(g)))
+    // ★回転印は種類ごとの表から引く（Codex は空＝見ない）。従来は BUSY_GLYPHS を共有していた。
+    if (profile.busyGlyphs.some((g) => regionText.includes(g)))
         return true;
     return false;
 }
+/**
+ * 「入力欄の行（cursor で始まる最後の行）が末尾から within 行以内に在るか」を返す純粋関数。
+ *   ★枠の装飾（│ など）は剥がしてから見る。末尾の空行は数えない（tmux は下を空行で埋める）。
+ */
+export function hasInputLineNearBottom(text, cursor, within) {
+    const lines = text.replace(/\r/g, '').split('\n');
+    while (lines.length > 0 && lines[lines.length - 1].trim() === '')
+        lines.pop();
+    const from = Math.max(0, lines.length - within);
+    for (let i = lines.length - 1; i >= from; i--) {
+        if (lines[i].replace(/^[│|╎┃\s]+/, '').startsWith(cursor))
+            return true;
+    }
+    return false;
+}
 /**
  * 画面テキストから「アイドルか」を判定する純粋関数（判定(a)）。
  *   方針:「確実な処理中シグナル（esc to interrupt / compacting / スピナーグリフ）が無く、
@@ -698,12 +779,21 @@ export function looksLikeAgent(text, kind) {
 export function looksIdleFor(text, kind) {
     if (kind === 'claude')
         return looksIdle(text);
+    const profile = agentProfile(kind);
     if (hasBusySignalFor(text, kind))
         return false;
     if (hasChoiceMenuFor(text, kind))
         return false;
     // ★その窓が Codex だと分かるときだけ「待機」と言い切る。分からない窓は待機にしない。
-    return looksLikeAgent(text, kind);
+    if (!looksLikeAgent(text, kind))
+        return false;
+    // ★入力欄が末尾付近に見えることを必須にする（案C-2・AgentProfile.idleInputLineWithin 参照）。
+    //   画面を覆う表示（0.160.0 の警告の表示など）は入力欄を隠すので、ここで弾ける。
+    if (profile.idleInputLineWithin !== null &&
+        !hasInputLineNearBottom(text, profile.cursor, profile.idleInputLineWithin)) {
+        return false;
+    }
+    return true;
 }
 /**
  * 画面テキストに「完了マーカー DONE:{site} が単独で出力されているか」を判定する純粋関数。
@@ -2894,6 +2984,7 @@ export function startKeepalive(state, pending, now) {
         anchor: pending.anchor,
         startedAt: now,
         lastHeartbeatAt: null,
+        lastCentralProbeAt: null,
         screenDoneUsable: true,
     };
     return true;
@@ -2916,8 +3007,12 @@ export function decideKeepalive(input) {
         return 'wait';
     if (input.doneSeen)
         return 'done';
-    if (input.alive)
+    if (input.alive) {
+        // ★alive が続いていても、しぼりが空いたら中央へ答え合わせする（画面の誤読から必ず抜ける道）。
+        if (input.centralProbeOk === true)
+            return 'alive-probe';
         return input.throttleOk ? 'heartbeat' : 'wait';
+    }
     if (input.idle)
         return 'probe';
     return 'wait';
@@ -2970,9 +3065,34 @@ export async function keepaliveTick(cfg, state, deps = {}) {
         alive: cap !== null && (kaBusySignal || kaMenu),
         idle: cap !== null && looksIdleFor(cap, kindOf(cfg)),
         throttleOk: ka.lastHeartbeatAt === null || now - ka.lastHeartbeatAt >= RELAY_HEARTBEAT_INTERVAL_MS,
+        // ★中央への答え合わせのしぼり。生存通知と同じ150秒（RELAY_HEARTBEAT_INTERVAL_MS）。
+        centralProbeOk: ka.lastCentralProbeAt === null || now - ka.lastCentralProbeAt >= RELAY_HEARTBEAT_INTERVAL_MS,
     });
     if (action === 'wait')
         return;
+    if (action === 'alive-probe') {
+        // ★画面は「作業中」に見えるが、中央にも必ず聞く（画面の誤読から抜ける唯一の道・案A-2）。
+        ka.lastCentralProbeAt = now;
+        const alive = await getStatus(cfg, ka.id);
+        if (isCentralFinished(alive)) {
+            logLine(`site=${cfg.site} id=${ka.id} 見張り終了: 中央で終端(status=${alive})を確認` +
+                '（画面は作業中に見えたが中央の真実で畳む）');
+            noteBusyEdge(state, cfg.site, ka.id, false, logLine);
+            state.keepalive = null;
+            return;
+        }
+        // 終端でない＝従来の 'heartbeat' と同じ扱い（手は挙げたまま生存通知）。しぼりは尊重する。
+        const raiseAlive = shouldRaiseBusy(kaBusySignal, kaMenu);
+        noteBusyEdge(state, cfg.site, ka.id, raiseAlive, logLine);
+        if (ka.lastHeartbeatAt === null || now - ka.lastHeartbeatAt >= RELAY_HEARTBEAT_INTERVAL_MS) {
+            ka.lastHeartbeatAt = now;
+            logLine(`site=${cfg.site} id=${ka.id} 見張り継続: 職人は生きています→生存通知` +
+                `（中央へ問い合わせ=した・status=${alive ?? '不明'}` +
+                `・経過${Math.round((now - ka.startedAt) / 1000)}s）`);
+            await heartbeat(cfg, ka.id, raiseAlive);
+        }
+        return;
+    }
     if (action === 'heartbeat') {
         ka.lastHeartbeatAt = now;
         const raise = shouldRaiseBusy(kaBusySignal, kaMenu);
@@ -3102,8 +3222,11 @@ export async function restoreOrphans(cfg, state) {
     log(`site=${cfg.site} id=${pick.id} を sent孤児から pending へ復元（★配達はしない・DONE待ちと生存通知だけ）`);
 }
 export async function relayTick(cfg, state, hooks) {
-    if (state.running)
+    if (state.running) {
+        // ★合図を受けていたなら、空振りした理由を1行残す（しぼり付き・案B-3）。
+        noteNudgeSkipped(state, cfg.site, '前の周がまだ走っている', log);
         return; // 前回の tick が走行中ならスキップ
+    }
     state.running = true;
     // 承認待ちの観測値は毎tick「出ていない」から始める（下でプロンプトを検知したときだけ true にする）。
     // ここで false に戻しておくと、プロンプトが消えた／pending が無い／早期 return のどの経路でも、
@@ -3135,9 +3258,18 @@ export async function relayTick(cfg, state, hooks) {
         await keepaliveTick(cfg, state);
         // ── 完了マーカー検出（pending があれば最優先・停止中でも継続） ──
         if (state.pending) {
-            const cap = tmuxCapture(cfg.site);
-            if (cap === null)
+            // ★この周の結末を「配った便の完了待ち」として記録する（案B-1）。ここで1回呼べば、
+            //   以下のどの return 経路を通っても管制の札が 'delivered' のまま固まらない。
+            //   同じ状態・同じ指示の間 since は動かないので、待っている長さがそのまま測れる。
+            noteReadiness(state, 'waiting-done', state.pending.id);
+            // ★合図が来ていたなら、取得へ進まない理由を1行残す（しぼり付き・案B-3）。
+            noteNudgeSkipped(state, cfg.site, `配った便(id=${state.pending.id})の完了を待っている`, log);
+            const cap = (hooks?.capture ?? tmuxCapture)(cfg.site);
+            if (cap === null) {
+                // ★無言で返さない（案B-2）。画面が読めない周も、しぼり付きで1行残す。
+                noteWaitingDone(state, cfg.site, '読めない', false, log);
                 return; // tmux未取得: 次回再確認
+            }
             // ── 完了検出の走査範囲を広げてよいかの観測（★状態更新には使わない・ADR-023） ──
             // アンカーを一度でも画面で見たら、以後アンカーが流れて消えても全画面から DONE を拾ってよい
             // （ADR-020 の根拠）。★ここで観測するのは「どこまで見てよいか」だけで、配達の成否や
@@ -3211,9 +3343,25 @@ export async function relayTick(cfg, state, hooks) {
             // 【副シグナル温存＝無損失縮退】中央 status が読めない(null＝エンドポイント未実装/不達)ときだけ、
             //   従来の detectExternalDone（別idが配れる＝終端の確証）へフォールバックする。中央側 status API が
             //   入るまではこの副シグナルが従来どおり効き、入った後は主シグナル(status)が確実に固着を断つ。
-            // HTTP コストを抑えるため「印が付いている＋アイドル」のときだけ probe する（busyな通常作業中は叩かない）。
+            // 【★画面の判定から切り離す（根治・案A-2・調査 67f8c51f）】
+            //   従来の条件は「印が付いている＋**画面がアイドルに見える**」だった。ところが画面の目印は
+            //   職人側の版上げで必ず壊れる。実機 2026-10-02 は Codex 0.160.0 の起動画面（点字のロゴ）を
+            //   「作業中」と誤読し、idle が永久に false になった＝**中央の真実を知る唯一の道が閉じた**。
+            //   中央でとうに done の便を15分抱え、そのあと見張りへ渡って最長3時間ふさがった。
+            //   ＝画面が外れたら逃げ道も消える、という構造そのものが穴。
+            //   そこで条件を「印が付いている」だけにし、代わりに時計でしぼる:
+            //     ・アイドルに見える周 … 従来どおり毎tick叩く（★いちばん速い道は1バイトも遅くしない）
+            //     ・それ以外の周      … 150秒（RELAY_HEARTBEAT_INTERVAL_MS・生存通知と同じ時計）に1回
+            //   ＝HTTP の増分は1指示あたり最大で150秒に1回。画面の読み取りが外れても、中央で終わった便は
+            //     必ず150秒以内の周で追跡解除され、次の便が配られる。
             const idle = looksIdleFor(cap, kindOf(cfg));
-            if (state.pending.sentMarked && idle) {
+            const probeBase = state.pending.lastStatusProbeAt ?? state.pending.sentAt;
+            const probeDue = Date.now() - probeBase >= RELAY_HEARTBEAT_INTERVAL_MS;
+            const askedCentral = state.pending.sentMarked && (idle || probeDue);
+            // ★画面をどう読んだかを必ず残す（案B-2）。これが1行あれば今回の誤読は即座に分かった。
+            noteWaitingDone(state, cfg.site, idle ? '待機' : '作業中', askedCentral, log);
+            if (askedCentral) {
+                state.pending.lastStatusProbeAt = Date.now();
                 const centralStatus = await fetchCommandStatus(cfg, state.pending.id);
                 // ★本文未着(instruction_missing)も追跡をやめる（便 7d810bbb）。管制は占有を外して人の判断待ちに
                 //   出している＝ここで待ち続けると次の便が拾えない。★配り直さない（人が決める）。
@@ -3226,7 +3374,9 @@ export async function relayTick(cfg, state, hooks) {
                 }
                 // 中央 status が未知(null)のときのみ、従来の副シグナル（別idが配信可能＝終端の確証）で救う。
                 //   中央が sent/queued 等の「生存中」を明示的に返した場合は解除しない（中央の真実を尊重）。
-                if (centralStatus === null) {
+                // ★副シグナルは「アイドル」を根拠の一部にしている（detectExternalDone）。だから画面が
+                //   アイドルに見える周だけ叩く＝従来と同じ条件・同じ結論。無駄な取得も増やさない。
+                if (centralStatus === null && idle) {
                     const next = await fetchCommand(cfg);
                     const nextId = next?.id ?? null;
                     if (detectExternalDone({
@@ -3498,7 +3648,15 @@ export async function relayTick(cfg, state, hooks) {
         // 新しい指示の生存ハートビートは先頭から数え直す（前指示のスロットルを引き継がない）。
         state.lastHeartbeatAt = null;
         noteReadiness(state, 'delivered', cmd.id);
-        log(`site=${cfg.site} id=${cmd.id} ${landed ? '配達しました' : '配達を試みましたが貼り付けが入らず、何も送信していません'}`);
+        // ★記録の文面を事実に合わせる（案C-4・調査 67f8c51f）。
+        //   「貼り付けが入力欄に入ったか」を確かめているのは、受領確認を通る職人（claude）だけ。
+        //   それ以外（Codex）は tmux へ送れたかしか見ていないので、画面を覆う表示（起動画面・警告の
+        //   表示）へ打ち込んで本文が捨てられても「配達しました」と書いていた＝人が記録を信じて誤診した
+        //   （実機 2026-10-02）。確認が入る（要判断3）までの間、書く言葉を実際に確かめた範囲に合わせる。
+        //   ★claude の文面は1文字も変えない。
+        log(useAck
+            ? `site=${cfg.site} id=${cmd.id} ${landed ? '配達しました' : '配達を試みましたが貼り付けが入らず、何も送信していません'}`
+            : `site=${cfg.site} id=${cmd.id} 送信しました（入力欄に入ったかは未確認）`);
         // ★配った時点で管制へ印を書く（便 7d810bbb）。Claude の職人は「配達中(受領確認待ち)」、
         //   それ以外は今までどおり「配達済み(sent)」。書けなければ次tick以降で書けるまでやり直す
         //   （markSentAtCentral）。★書けなくても再配達はしない。

package/package.json

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