@tyhld/conductor 0.12.86 → 0.12.87

package/dist/headless.js

@@ -19,7 +19,7 @@ import { createInterface } from 'node:readline';
 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, noteDrain, noteReadiness, patchStatus, recoverStuckProcessedReports, reconnectDelayMs, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
+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, deliverJobEndFacts, deliveryReport, fetchCommand, fetchCommandStatus, fetchControl, fetchOrphans, flushPendingJobEndFacts, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteDrain, noteReadiness, patchStatus, recoverStuckProcessedReports, reconnectDelayMs, reportPhase, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
 import { claudePinPath, readClaudePinLine, } from './autoupdate-flags.js';
 const log = (msg) => {
     console.log(`[headless] ${msg}`);
@@ -528,6 +528,35 @@ export function maskSecrets(text) {
     }
     return masked;
 }
+/**
+ * 便の終わり方を決める（★純粋関数＝単体テストできる・便 915694ac）。
+ *
+ * ★本文を渡せなかったことが先。職人が何も受け取っていないという事実は、
+ *   ほかのどの終わり方よりも強い（やり直しても同じ結果になる）。
+ */
+export function jobEndKindOf(j) {
+    if (j.bodyHandoff === 'failed')
+        return 'not_started';
+    if (j.timedOut)
+        return 'timeout';
+    if (j.stopped)
+        return 'stopped';
+    if (j.authError)
+        return 'auth_error';
+    return j.exitCode === 0 ? 'completed' : 'error';
+}
+/**
+ * 本文を渡せなかった便として、走っている処理を止めるか（★純粋関数・便 915694ac）。
+ *
+ * ★画面なし方式は中継が自分で処理を立ち上げて本文を渡す。
+ *   ・'done'    … 渡せた → 何もしない（★本文未着と申告しない・追跡を続ける）
+ *   ・'pending' … まだ確かめ中 → 何もしない（迷ったら触らない）
+ *   ・'failed'  … 渡せなかった → 止めて理由つきで管制へ届ける
+ *   既に止めた便・上限時間で止めた便は、その終わり方の後始末に任せる。
+ */
+export function shouldAbortForBodyHandoff(j) {
+    return j.bodyHandoff === 'failed' && !j.stopped && !j.timedOut;
+}
 /**
  * いま画面なし方式が追っている便の指示ID（★回収の道から除く物・便 6ebba0d0 の b）。
  *
@@ -1003,6 +1032,8 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
         stderrLog: logs?.stderrLog ?? null,
         eventsLog: logs?.eventsLog ?? null,
         durationMs: 0,
+        finishedAt: null,
+        bodyHandoff: 'pending',
     };
     // spawn の 'error' イベント（ENOENT 等は非同期で届く。同期例外と両方捕まえる）
     proc.on('error', (err) => {
@@ -1010,22 +1041,46 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
             job.completed = true;
             job.exitCode = -1;
             job.exitSignal = null;
+            job.finishedAt = Date.now();
             job.stderrBuf += `\nspawn error: ${err.message}`;
         }
     });
     // stdin: 指示本文を書いて閉じる
+    //
+    // ★「渡せたか」を事実として残す（えふさん確定 2026-10-02・便 915694ac）。
+    //   これまでは stdin のエラーをまるごと握り潰していたので、本文を1バイトも渡せていなくても
+    //   中継は管制へ「配達済み(sent)」と書いていた＝職人が受け取っていない便を実行中にしていた。
+    //   逆に、渡せた便を「本文未着」と申告してしまう道も作らない（下の headlessTick を参照）。
+    const noteHandoffFailed = (why) => {
+        if (job.bodyHandoff === 'done')
+            return; // 既に書けている（閉じたあとの後始末のエラーは数えない）
+        job.bodyHandoff = 'failed';
+        job.bodyHandoffError ??= why;
+    };
     if (proc.stdin) {
-        // stdin の write エラーは spawn 失敗時に起きうる（握り潰す）
-        proc.stdin.on('error', () => { });
-        if (isResume) {
-            proc.stdin.write(RESUME_PROMPT);
+        // ★エラーは握り潰さず、理由として残す（投げると中継の輪が止まるので、throw はしない）。
+        proc.stdin.on('error', (err) => {
+            noteHandoffFailed(`職人の処理へ本文を渡せませんでした（標準入力: ${err.message}）`);
+        });
+        const text = isResume
+            ? RESUME_PROMPT
+            : buildSendText(cmd.body, cfg.site, buildAnchor(cmd.id), kindOf(cfg));
+        try {
+            // ★書き出しが本当に流れ切ってから 'done' にする（返事を待たずに「渡せた」と言わない）。
+            proc.stdin.write(text, (err) => {
+                if (err)
+                    noteHandoffFailed(`職人の処理へ本文を渡せませんでした（書き出し: ${err.message}）`);
+                else if (job.bodyHandoff === 'pending')
+                    job.bodyHandoff = 'done';
+            });
+            proc.stdin.end();
         }
-        else {
-            const anchor = buildAnchor(cmd.id);
-            const text = buildSendText(cmd.body, cfg.site, anchor, kindOf(cfg));
-            proc.stdin.write(text);
+        catch (err) {
+            noteHandoffFailed(`職人の処理へ本文を渡せませんでした（${err instanceof Error ? err.message : String(err)}）`);
         }
-        proc.stdin.end();
+    }
+    else {
+        noteHandoffFailed('職人の処理の入口（標準入力）が開かなかったので、本文を渡せませんでした');
     }
     // stdout: stream-json を行ごとに読み、CommandEvent に変換してバッファへ。ログファイルにも書く。
     if (proc.stdout) {
@@ -1071,6 +1126,7 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
         job.completed = true;
         job.exitCode = code;
         job.exitSignal = signal?.toString() ?? null;
+        job.finishedAt = Date.now();
         job.durationMs = Date.now() - job.startedAt;
         closeLog(job.stdoutLog);
         closeLog(job.stderrLog);
@@ -1174,6 +1230,42 @@ async function checkRunningJob(cfg, state) {
                 ...(detail !== undefined ? { detail } : {}),
             });
         };
+        // ★終了の事実を管制へ必ず届ける（えふさん確定 2026-10-02・便 915694ac）。
+        //
+        // 【えふさん確定】便ID付き報告が到着 ＋ Claude Code プロセス終了 ＋ 中継が終了結果を取得
+        //   まで揃ってはじめて「職人の作業終了」。だから中継は【終わり方に関係なく】終わった事実を届ける。
+        // 【ここ（分かれ道の手前）で1回だけ送る理由】終わり方ごとの枝の中で送ると、
+        //   ・終了状態を書けずに次の周へ持ち越す枝（下の done が書けないとき）では毎周送ってしまう
+        //   ・追跡をやめる枝（放棄・試行上限）では送り忘れる
+        //   の両方が起きる。★「プロセスが終わった」ことは枝に関係なく1つの事実なので、ここで1回送る。
+        // 【送る物】中継が実際に取れた物だけ（終了コードが無ければ null＝つかめていないと伝える）。
+        //   ★作り話の終了を送らない。「報告を出せたか」は報告ファイルの有無だけで見る
+        //     （★中身の言葉は1文字も読まない＝2026-09-23 の確定のまま）。
+        // 【届かなければ】控えが手元に残り、次の周の flushPendingJobEndFacts が届くまでやり直す。
+        if (!job.endFactsTold) {
+            job.endFactsTold = true;
+            const endKind = jobEndKindOf({
+                bodyHandoff: job.bodyHandoff,
+                timedOut: job.timedOut,
+                stopped: job.stopped,
+                authError: isAuthError(job),
+                exitCode: job.exitCode,
+            });
+            await deliverJobEndFacts(cfg, {
+                commandId: job.commandId,
+                site: cfg.site,
+                finishedAt: new Date(job.finishedAt ?? Date.now()).toISOString(),
+                endKind,
+                exitCode: job.exitCode,
+                exitSignal: job.exitSignal,
+                reportDelivered: reportPhase(job.commandId) !== 'none',
+                // ★画面なし方式は中継が自分で立ち上げた処理なので、終わりを直接つかんでいる。
+                //   つかめていないときは false を送る（1-3 の「つかめていない」と同じ形）。
+                processEndObserved: job.finishedAt !== null,
+                startedAt: new Date(job.startedAt).toISOString(),
+                detail: job.bodyHandoffError ?? `attempt ${job.attempt}/${HEADLESS_MAX_ATTEMPTS}`,
+            }, { logLine: log });
+        }
         if (job.timedOut) {
             // 上限時間で強制停止した → 管制へ理由つきで failed を記録する
             const elapsed = Math.round((Date.now() - job.startedAt) / 1000);
@@ -1302,6 +1394,28 @@ async function checkRunningJob(cfg, state) {
     }
     // ── 実行中のプロセスの監視 ──
     const now = Date.now();
+    // ★本文を渡せなかったことが後から分かったとき（便 915694ac）。
+    //   画面なし方式は中継が自分で処理を立ち上げて本文を渡す。渡せていなければ職人は何も
+    //   受け取っていないので、動いているふりをさせず、理由つきで管制へ届けて止める。
+    //   ★渡せた便（'done'）・まだ確かめ中の便（'pending'）には何もしない＝追跡を続ける。
+    if (shouldAbortForBodyHandoff(job)) {
+        const why = job.bodyHandoffError ?? '職人の処理へ本文を渡せませんでした';
+        log(`ERROR site=${cfg.site} id=${job.commandId} ${why} → 止めて管制へ知らせます`);
+        await patchStatus(cfg, job.commandId, 'failed', why.slice(0, EVENT_TEXT_MAX));
+        await sendCommandEvents(cfg, job.commandId, [{
+                type: 'error',
+                text: why.slice(0, EVENT_TEXT_MAX),
+                at: new Date().toISOString(),
+                attempt: job.attempt,
+            }]);
+        rs.abandoned.add(job.commandId);
+        // ★stopped を立ててから止める＝終了の後始末で「異常終了 → 自動再開」の道へ入らない
+        //   （本文が渡っていないので、同じことをやり直しても同じ結果になる。二重に走らせない）。
+        //   終わり方は 'not_started' として届く（上の endKind は本文の未渡しを先に見る）。
+        job.stopped = true;
+        await stopJob(job);
+        return;
+    }
     // stop_requested の確認（間隔を置いて中央へ問い合わせる）
     if (now - job.lastStopCheckAt >= HEADLESS_STOP_CHECK_MS) {
         job.lastStopCheckAt = now;
@@ -1603,6 +1717,10 @@ export async function headlessTick(cfg, state, hooks) {
             log('停止が解除されました。relayを再開します');
         }
         rs.lastHalted = false;
+        // ── 届いていない「終了の事実」の送り直し（★便 915694ac・黙って捨てない） ──
+        //   ★停止トグルの確認より後に置く＝止められている現場では外へ出ない。
+        //   ★追跡をやめた便・「本文未着」と申告された便の分も、ここで届くまでやり直す。
+        await flushPendingJobEndFacts(cfg, { logLine: log });
         // ── 取り残しの後始末（★便 6ebba0d0 の項目4） ──
         //   「実プロセスが無い・報告は渡し済み・管制ではまだ終わっていない」便に done を書く。
         //   ★自分の PC・自分の現場の便だけ（判定は recoverStuckProcessedReports 側）。
@@ -1695,6 +1813,35 @@ export async function headlessTick(cfg, state, hooks) {
             log(`ERROR site=${cfg.site} id=${cmd.id} claude が見つからない → 放棄`);
             return;
         }
+        // ★本文を渡せなかったことが起動のその場で分かったとき（入口が開かない・書き出しが例外）。
+        //   「配達済み(sent)」を1バイトも書かずに、理由つきで管制へ届けて放棄する（便 915694ac）。
+        //   ★渡せた便・まだ確かめ中の便は、今までどおりそのまま進む（追跡を続ける）。
+        if (job.bodyHandoff === 'failed') {
+            const why = job.bodyHandoffError ?? '職人の処理へ本文を渡せませんでした';
+            await stopJob(job);
+            await patchStatus(cfg, cmd.id, 'failed', why.slice(0, EVENT_TEXT_MAX));
+            await sendCommandEvents(cfg, cmd.id, [{
+                    type: 'error',
+                    text: why.slice(0, EVENT_TEXT_MAX),
+                    at: new Date().toISOString(),
+                    attempt,
+                }]);
+            await deliverJobEndFacts(cfg, {
+                commandId: cmd.id,
+                site: cfg.site,
+                finishedAt: new Date().toISOString(),
+                endKind: 'not_started',
+                exitCode: job.exitCode,
+                exitSignal: job.exitSignal,
+                reportDelivered: false,
+                processEndObserved: job.finishedAt !== null,
+                startedAt: new Date(job.startedAt).toISOString(),
+                detail: why,
+            }, { logLine: log });
+            rs.abandoned.add(cmd.id);
+            log(`ERROR site=${cfg.site} id=${cmd.id} ${why} → 放棄（配達済みとは書きません）`);
+            return;
+        }
         state.job = job;
         saveActiveJob(cfg.site, { commandId: cmd.id, body: cmd.body, sessionId, attempt, startedAt: Date.now(), site: cfg.site, machine: cfg.machine, workDir: cfg.workDir, gitOrigin: resolveGitOrigin(cfg.workDir) ?? undefined, pid: job.process.pid, postedAt: cmd.sentAt });
         markDelivered(rs, cmd.id);

package/dist/relay.js

@@ -2957,6 +2957,154 @@ export async function sendHeartbeat(cfg, id, busy = false, liveness) {
         log(`site=${cfg.site} id=${id} heartbeat -> 失敗: ${err instanceof Error ? err.message : String(err)}（縮退で安全）`);
     }
 }
+/** 届けられなかった「終了の事実」の置き場。 */
+export function jobEndDir(env = process.env) {
+    const base = (env.CONDUCTOR_STATE_DIR ?? '').trim();
+    return base
+        ? path.join(base, 'job-end')
+        : path.join(env.HOME ?? os.homedir(), '.local', 'state', 'conductor', 'job-end');
+}
+/** 1便ぶんの控えのファイル名（★現場と指示IDの両方を入れる＝別の現場の便と混ざらない）。 */
+export function jobEndFactsPath(site, commandId, env = process.env) {
+    const safe = (s) => s.replace(/[^A-Za-z0-9._-]/g, '_');
+    return path.join(jobEndDir(env), `${safe(site)}__${safe(commandId)}.json`);
+}
+/** 人向けの一言の上限（管制の列を汚さない）。 */
+const JOB_END_DETAIL_MAX = 500;
+/**
+ * 管制へ送る本文（★純粋関数＝単体テストできる）。
+ *
+ * ★`state` も `busy` も入れない（上の約束④）。
+ * ★項目名は管制の側の便（ai-kana）が読む物なので、勝手に変えない。
+ */
+export function jobEndFactsBody(f) {
+    const body = {
+        // ★この印が在る生存報告は「終わりの知らせ」。管制が知らないうちは黙って捨てられる。
+        jobEnded: true,
+        finishedAt: f.finishedAt,
+        endKind: f.endKind,
+        exitCode: f.exitCode,
+        exitSignal: f.exitSignal,
+        reportDelivered: f.reportDelivered,
+        processEndObserved: f.processEndObserved,
+    };
+    // ★立ち上がった時刻は管制が既に読める項目（startedAt）なので、分かるときだけ添える。
+    if (f.startedAt !== undefined)
+        body.startedAt = f.startedAt;
+    if (f.detail !== undefined && f.detail !== '')
+        body.jobEndDetail = f.detail.slice(0, JOB_END_DETAIL_MAX);
+    return body;
+}
+/** 控えを手元に書く（★届くまで消さない）。書けたか返す。 */
+export function saveJobEndFacts(f, env = process.env) {
+    try {
+        mkdirSync(jobEndDir(env), { recursive: true });
+        writeFileSync(jobEndFactsPath(f.site, f.commandId, env), JSON.stringify(f) + '\n');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 控えを消す（★届いたときだけ呼ぶ）。 */
+export function clearJobEndFacts(site, commandId, env = process.env) {
+    try {
+        const p = jobEndFactsPath(site, commandId, env);
+        if (existsSync(p))
+            unlinkSync(p);
+    }
+    catch {
+        // 消せなくても次の周でもう一度送るだけ（管制の側は冪等）。
+    }
+}
+/** その現場の、まだ届いていない「終了の事実」を読む（壊れた控えは飛ばす）。 */
+export function pendingJobEndFacts(site, env = process.env) {
+    const dir = jobEndDir(env);
+    let names;
+    try {
+        names = readdirSync(dir).filter((n) => n.endsWith('.json'));
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const n of names.sort()) {
+        try {
+            const raw = readFileSync(path.join(dir, n), 'utf8').trim();
+            if (!raw)
+                continue;
+            const f = JSON.parse(raw);
+            // ★自分の現場の便だけ送る（1台で複数の現場の中継が動くため）。
+            if (!f || f.site !== site || !f.commandId || !f.finishedAt)
+                continue;
+            out.push(f);
+        }
+        catch {
+            // 読めない控えは飛ばす（消さない＝人が見つけられるように残す）。
+        }
+    }
+    return out;
+}
+/**
+ * 「終了の事実」を管制へ1回送る。届いたら true。
+ * ★失敗は投げない（中継の輪を止めない）。false を返して、呼び出し側が控えを残す。
+ */
+export async function sendJobEndFacts(cfg, f, opts = {}) {
+    const doFetch = opts.fetchImpl ?? fetch;
+    const logLine = opts.logLine ?? (() => { });
+    try {
+        const res = await doFetch(`${cfg.url}/api/conductor/commands/${encodeURIComponent(f.commandId)}/seen`, {
+            method: 'PATCH',
+            headers: { Authorization: `Bearer ${cfg.token}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify(jobEndFactsBody(f)),
+            signal: AbortSignal.timeout(RELAY_FETCH_TIMEOUT_MS),
+        });
+        if (res.ok)
+            return true;
+        logLine(`site=${cfg.site} id=${f.commandId} 終了の事実 -> HTTP ${res.status}（控えを残して次の周でやり直します）`);
+        return false;
+    }
+    catch (err) {
+        logLine(`site=${cfg.site} id=${f.commandId} 終了の事実 -> 失敗: ` +
+            `${err instanceof Error ? err.message : String(err)}（控えを残して次の周でやり直します）`);
+        return false;
+    }
+}
+/**
+ * 「終了の事実」を控えに書いてから送る（★順番が肝）。
+ *   先に控えを書くので、送信中に中継が落ちても事実は失われない。送れたら控えを消す。
+ *   送れなければ残して、次の周の flushPendingJobEndFacts がやり直す。
+ */
+export async function deliverJobEndFacts(cfg, f, opts = {}) {
+    const env = opts.env ?? process.env;
+    saveJobEndFacts(f, env);
+    const ok = await sendJobEndFacts(cfg, f, opts);
+    if (ok) {
+        clearJobEndFacts(f.site, f.commandId, env);
+        opts.logLine?.(`site=${cfg.site} id=${f.commandId} 終了の事実を管制へ届けました` +
+            `（終わり方=${f.endKind} 終了コード=${f.exitCode ?? '不明'} 報告=${f.reportDelivered === null ? '不明' : f.reportDelivered ? 'あり' : 'なし'}）`);
+    }
+    return ok;
+}
+/** 届いていない「終了の事実」をまとめて送り直す（★1周に1回・届くまで何周でも）。 */
+export async function flushPendingJobEndFacts(cfg, opts = {}) {
+    const env = opts.env ?? process.env;
+    let sent = 0;
+    let kept = 0;
+    for (const f of pendingJobEndFacts(cfg.site, env)) {
+        if (await sendJobEndFacts(cfg, f, opts)) {
+            clearJobEndFacts(f.site, f.commandId, env);
+            sent++;
+        }
+        else {
+            kept++;
+        }
+    }
+    if (sent > 0 || kept > 0) {
+        opts.logLine?.(`site=${cfg.site} 終了の事実の送り直し: 届いた ${sent} 件・残り ${kept} 件`);
+    }
+    return { sent, kept };
+}
 /**
  * いま「作業中です」と手を挙げる（busy:true を載せる）かを決める純粋関数。
  *
@@ -3304,6 +3452,9 @@ export async function relayTick(cfg, state, hooks) {
         // pending 分岐も新規指示の取得も従来どおり動く（pending を落とす目的を殺さない）。
         // 停止中(relayHalted)でも続けるのは、既に送った指示の後始末は進めるという既存方針と同じ。
         await keepaliveTick(cfg, state);
+        // ── 届いていない「終了の事実」の送り直し（★便 915694ac・黙って捨てない） ──
+        //   既に送った便の後始末なので、停止中(relayHalted)でも続ける（keepaliveTick と同じ方針）。
+        await flushPendingJobEndFacts(cfg, { logLine: log });
         // ── 完了マーカー検出（pending があれば最優先・停止中でも継続） ──
         if (state.pending) {
             // ★この周の結末を「配った便の完了待ち」として記録する（案B-1）。ここで1回呼べば、
@@ -3338,6 +3489,23 @@ export async function relayTick(cfg, state, hooks) {
             if (state.pending.ack === 'missing') {
                 // ★本文未着と決めた便。職人は仕事を受け取っていないので、完了検出も生存通知もしない。
                 //   知らせを送れたら sendAckAtCentral が追跡をやめる。★配り直さない。
+                // ★終了の事実も同じ項目で届ける（便 915694ac・1-1「追跡をやめた便・本文未着と申告した便でも届ける」）。
+                //   画面へ貼る方式では実プロセスを中継が持っていないので、終わりは【つかめていない】と伝える
+                //   （processEndObserved:false・終了コードは null）。★作り話の終了を送らない。
+                if (!state.pending.endFactsTold) {
+                    state.pending.endFactsTold = true;
+                    await deliverJobEndFacts(cfg, {
+                        commandId: state.pending.id,
+                        site: cfg.site,
+                        finishedAt: new Date().toISOString(),
+                        endKind: 'not_started',
+                        exitCode: null,
+                        exitSignal: null,
+                        reportDelivered: reportPhase(state.pending.id) !== 'none',
+                        processEndObserved: false,
+                        detail: '配り役が本文未着と申告した便（職人の処理は中継が持っていない）',
+                    }, { logLine: log });
+                }
                 await sendAckAtCentral(cfg, state);
                 if (state.pending !== null && Date.now() - state.pending.sentAt > RELAY_PENDING_TIMEOUT_MS) {
                     // 管制へ知らせられないまま上限を過ぎた。★印も書けていなければ、管制は queued のまま返す
@@ -3365,6 +3533,20 @@ export async function relayTick(cfg, state, hooks) {
                     const report = notice.report.trim().length > 0 ? notice.report : null;
                     if (await patchStatus(cfg, state.pending.id, 'done', report)) {
                         log(`site=${cfg.site} id=${state.pending.id} done（Codexの通知${report != null ? '・報告添付' : ''}）`);
+                        // ★終了の事実を同じ項目で届ける（便 915694ac・1-3）。この配り方では実プロセスを
+                        //   中継が持っていないので、終わりは【つかめていない】と伝える（終了コードは null）。
+                        //   届けるのは「中継が完了を確かめた」という事実だけ。★作り話の終了を送らない。
+                        await deliverJobEndFacts(cfg, {
+                            commandId: state.pending.id,
+                            site: cfg.site,
+                            finishedAt: new Date().toISOString(),
+                            endKind: 'completed',
+                            exitCode: null,
+                            exitSignal: null,
+                            reportDelivered: report != null || reportPhase(state.pending.id) !== 'none',
+                            processEndObserved: false,
+                            detail: '配り役が完了の知らせで確かめた（職人の処理は中継が持っていない）',
+                        }, { logLine: log });
                         state.pending = null;
                     }
                     return;
@@ -3374,8 +3556,22 @@ export async function relayTick(cfg, state, hooks) {
             if (below !== null && hasStandaloneDone(below, cfg.site)) {
                 // ★報告は画面から読まない。職人が書いたファイルを読む（relayReportDirs / readReport）。
                 //   画面を読む方式は窓が 16〜34 行しかなく、9/5 以降 162 回すべて失敗していた（調査 d1d16a56）。
+                const reportThere = reportPhase(state.pending.id) !== 'none';
                 const ok = await completeWithReport(cfg, state.pending.id, log);
                 if (ok) {
+                    // ★終了の事実を同じ項目で届ける（便 915694ac・1-3）。画面へ貼る方式では実プロセスを
+                    //   中継が持っていないので、終わりは【つかめていない】と伝える（終了コードは null）。
+                    await deliverJobEndFacts(cfg, {
+                        commandId: state.pending.id,
+                        site: cfg.site,
+                        finishedAt: new Date().toISOString(),
+                        endKind: 'completed',
+                        exitCode: null,
+                        exitSignal: null,
+                        reportDelivered: reportThere,
+                        processEndObserved: false,
+                        detail: '配り役が画面の完了の合図で確かめた（職人の処理は中継が持っていない）',
+                    }, { logLine: log });
                     state.pending = null;
                 }
                 return; // sent 中は新規取得しない

package/package.json

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

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 "① 前提チェック"
 

package/scripts/hooks/policy.py

@@ -2147,18 +2147,100 @@ def rm_path_risk(path: str, work_dir: str = None) -> str:
     return 'safe'
 
 
+# 削除命令の語そのもの（字面を探すための形）。
+_RM_WORD_RE = re.compile(r'\brm\b')
+
+# ★探すだけの道具（引数に書かれた「探す言葉」は実行されない）。
+#   【なぜ要るか（実物 2026-10-02）】職人が鉄則や台本を調べるとき、探す言葉に
+#     「rm -rf .git」のような字が入る。それを削除命令として読むと、調べる作業が毎回止まる。
+#   ★ここで免じるのは【引用符で囲まれた中に在る字】だけ。囲みの外に在る削除命令は1件も免じない。
+_SEARCH_ONLY_VERBS = frozenset(_RECURSIVE_GREP_VERBS | _HIDDEN_SEARCH_VERBS)
+
+# 引用符で囲まれた1かたまり（中に同じ引用符を含まない形）。
+# ★名前を _QUOTED_RE にしない（上の「プログラムの中の文字列リテラル」と別物）。
+_QUOTED_SPAN_RE = re.compile(r"'[^']*'|\"[^\"]*\"")
+
+
+def _blank_quoted(text: str) -> str:
+    """引用符で囲まれた中身を同じ長さの空白にする（★長さと位置を変えない）。"""
+    return _QUOTED_SPAN_RE.sub(lambda m: ' ' * len(m.group(0)), text)
+
+
+def _is_search_only(toks) -> bool:
+    """このセグメントが「探すだけ」の呼び出しか（下位コマンドの形も見る）。"""
+    verb = verb_of(toks)
+    if verb in _SEARCH_ONLY_VERBS:
+        return True
+    # `git grep …`（版管理の道具の探す口）も探すだけ。
+    return bool(toks) and verb == 'git' and any(t in _SEARCH_ONLY_VERBS for t in toks[1:3])
+
+
+def _rm_only_in_search_words(command: str) -> bool:
+    """削除命令の字が【探すだけの道具の引用符の中】にだけ在るか。
+
+    ★免じるのはこれが True のときだけ。少しでも判断が付かなければ False（＝止める側へ倒す）。
+      ・引用符の外に削除命令の字が在るセグメントが1つでも在れば False。
+      ・引用符の中に在っても、そのセグメントが探すだけの道具でなければ False。
+      ・どこにも見つからなければ False（ヒアドキュメントの本文など、
+        引用符を割らない読み方では覆えない字面＝安全側）。
+    """
+    found_in_search_words = False
+    for seg in split_commands(command, bodies=False):
+        has_rm = bool(_RM_WORD_RE.search(seg))
+        if not has_rm:
+            continue
+        if _RM_WORD_RE.search(_blank_quoted(seg)):
+            return False  # 囲みの外に在る＝本物の削除命令として扱う
+        if not _is_search_only(tokens_of(seg)):
+            return False
+        found_in_search_words = True
+    return found_in_search_words
+
+
+def _rm_target_risk(token: str, work_dir: str = None) -> str:
+    """削除の対象1つぶんの危険度。★シェルの飾り付きの字面と素の字面の、危ない方を採る。
+
+    【なぜ両方見るか（実物 2026-10-02）】`$(rm -rf .git)` の対象は `.git)` として取り出され、
+      閉じ括弧が付いているせいで保護対象（.git）に当たらず素通りしていた。
+      飾りを剥がした字面も測り、危ない方を採る＝今まで止めていた形は1件も緩まない。
+    """
+    risks = {rm_path_risk(token, work_dir=work_dir)}
+    bare = token.strip().strip(_REDIRECT_TRIM)
+    if bare != token:
+        risks.add(rm_path_risk(bare, work_dir=work_dir))
+    if 'dangerous' in risks:
+        return 'dangerous'
+    if 'unknown' in risks:
+        return 'unknown'
+    return 'safe'
+
+
 def _rm_danger(command: str, work_dir: str = None):
+    """削除命令の対象を全部見て、危険なものがあれば理由を返す。
+
+    ★止める側の読み方（機械的な区切り）は変えない。探すだけの道具の「探す言葉」に
+      当たったときだけ、最後に免じる（_rm_only_in_search_words）。
+    """
+    hit = _rm_danger_scan(command, work_dir=work_dir)
+    if hit is None:
+        return None
+    if _rm_only_in_search_words(command):
+        return None
+    return hit
+
+
+def _rm_danger_scan(command: str, work_dir: str = None):
     """再帰的 rm の対象パスを全部見て、危険なものがあれば理由を返す。"""
     if work_dir is None:
         work_dir = os.environ.get('CONDUCTOR_WORK_DIR') or None
-    for m in re.finditer(r'\brm\b', command):
+    for m in _RM_WORD_RE.finditer(command):
         seg = _SPLIT_RE.split(command[m.end():], maxsplit=1)[0]
         toks = seg.split()
         flags = [t for t in toks if t.startswith('-')]
         recursive = any(('r' in f.lstrip('-').lower()) or f in ('--recursive',) for f in flags)
         paths = [t for t in toks if not t.startswith('-')]
         for p in paths:
-            risk = rm_path_risk(p, work_dir=work_dir)
+            risk = _rm_target_risk(p, work_dir=work_dir)
             if risk == 'dangerous':
                 return f'rm on dangerous path ({p})'
             if risk == 'unknown' and recursive:

package/scripts/hooks/test_policy.py

@@ -1912,6 +1912,70 @@ finally:
     else:
         os.environ['CONDUCTOR_WORK_DIR'] = _wd_env2
 
+# ─────────────────────────────────────────────────────────────────────────────
+# 検索の「探す言葉」の中の削除命令（便 915694ac・えふさん確定 2026-10-02）
+#
+# 【実物】職人が鉄則や台本を調べるとき、探す言葉に「rm -rf .git」のような字が入る。
+#   番人はそれを削除命令として読み、調べる作業を毎回止めていた。
+# 【直し】探すだけの道具（grep 系・rg 系・git grep）の【引用符の中】に在る字は、
+#   削除命令として数えない。囲みの外に在る字は1件も免じない。
+# ★安全は1件も緩めない＝下の「止まり続ける形」をすべて固定する。
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== 探す言葉の中の削除命令は、削除命令として読まない ===')
+_SEARCH_OK = [
+    "grep -rn 'rm ' skills docs",
+    'grep -rn "rm -rf" skills',
+    "grep -n 'rm -rf .git' skills/conductor-craftsman/SKILL.md",
+    "grep -rn 'rm -r /tmp/claude-1000/sagyou' skills",
+    "grep -rln 'rm -r ~' docs",
+    'grep -rn "rm -rf $HOME" docs',
+    "git grep -n 'rm -rf .git' -- skills docs",
+    "rg -n 'rm -rf /' docs",
+    "rg 'rm -rf .tyhld' skills",
+    "grep -rn '-f なしの rm -r' skills",
+]
+for _c in _SEARCH_OK:
+    check(f'探す言葉: {_c}', policy.decide_bash(_c)['decision'], policy.ALLOW)
+
+print('\n=== 探す言葉に見せても、本当に消す形は止まり続ける ===')
+# ★この一覧はえふさん確定（2026-10-02）の「今までどおり止まること」の全件。
+_STILL_DENY = [
+    # 包みの中（bash -c・sh -c・eval）
+    "bash -c 'rm -rf .git'",
+    'sh -c "rm -rf .git"',
+    "eval 'rm -rf .git'",
+    'bash -c "grep -rn \'x\' docs; rm -rf .git"',
+    # 命令の置き換え（$( ) と ` `）
+    '$(rm -rf .git)',
+    'echo $(rm -rf .git)',
+    'X=$(rm -rf .git)',
+    '`rm -rf .git`',
+    'echo `rm -rf .git`',
+    '$(rm -r ~)',
+    # ; && | で続けた後ろ
+    'echo x; rm -rf .git',
+    "grep -rn 'x' docs && rm -rf .git",
+    "grep -rn 'x' docs | rm -rf .git",
+    "grep -rn 'rm -rf' docs; rm -r .tyhld",
+    # 探す命令に見せかけて後ろで消す形
+    "grep -rn 'rm -rf .git' docs; rm -rf .git",
+    "grep -rn 'rm -rf' skills && rm -r ~",
+    # xargs・find の -exec（消す先が字面に出る形）
+    'xargs rm -rf .git',
+    "find . -name '*.tmp' -exec rm -rf .git {} +",
+    'find docs -type f -exec rm -r {} +',
+    # 変数・* を含む再帰削除（今までどおり）
+    'rm -rf $DIR/x',
+    'rm -rf build/*',
+]
+for _c in _STILL_DENY:
+    check(f'止まり続ける: {_c}', policy.decide_bash(_c)['decision'], policy.DENY)
+
+print('\n=== -f なしの実在パスの削除は今までどおり通る ===')
+for _c in ['rm -r /tmp/claude-1000/sagyou', 'rm /tmp/claude-1000/a.html',
+           'rm -rf node_modules', 'rm -rf dist']:
+    check(f'通る: {_c}', policy.decide_bash(_c)['decision'], policy.ALLOW)
+
 # ─────────────────────────────────────────────────────────────────────────────
 print('\n' + '=' * 72)
 if failures:

package/scripts/update-guard.sh

@@ -80,7 +80,7 @@ info() { echo "[update-guard] $*"; }
 warn() { echo "[update-guard] 注意: $*" >&2; }
 fail() { echo "[update-guard] エラー: $*" >&2; exit 1; }
 
-# >>> preflight >>>   ★この印の間が正本。install.sh と update-guard.sh で1文字も違わないことをテストが固定する。
+# >>> preflight >>>   ★この印の間が正本。install.sh・update-guard.sh・setup.sh の3つで1文字も違わないことをテストが固定する。
 # ═════════════════════════════════════════════════════════════════════════════
 # 先頭の確かめ（職人が始まるのに要る物・便 ff8f4be9）
 #
@@ -125,6 +125,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
@@ -133,6 +141,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
@@ -142,7 +151,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/skills/conductor-craftsman/SKILL.md

@@ -109,7 +109,7 @@ description: 采配くんの便（プロンプト末尾に CONDUCTOR_JOB:<id>
    - ① **起動は必ず `chromium_sandbox=False`**（`--no-sandbox`）。付けないと起動できない。
    - ② **道具は共有の場所を使う。自分でダウンロードしない。** python は `$HOME/.tyhld/pw-venv/bin/python`、`PLAYWRIGHT_BROWSERS_PATH` は `$HOME/.tyhld/pw-browsers`。**無ければそこで止めて「人の手番＝`APPLY=1 bash scripts/pw-browser-install.sh`」と報告する。** `playwright install` も `pip install playwright` も職人は実行しない（毎便まるごとダウンロードが走り、便が遅くなる。通信自体は鉄則12のとおり許可済みだが、取りに行かないのが本筋＝ADR-010）。
    - ③ **localhost の画面検品は proxy を指定しない。** プロキシ `localhost:3128` はサンドボックスの中にしか居ないので、外部URLへ出るときだけ Playwright の proxy オプションへ明示指定する（環境変数は拾われない）。`ECONNREFUSED` なら回避せず**未実施として報告**する。
-   - ④ 検品用の使い捨て画面（確認だけのHTML/スクリプト）は**リポジトリの中に作らない。置き場は `/tmp/claude-1000/`**（鉄則13）。リポジトリの中に作ってしまったものはコミット前に削除する。ただしリポジトリ直下は番人が `rm` を止めるので、**自分で消そうとせず報告する**（鉄則13）。
+   - ④ 検品用の使い捨て画面（確認だけのHTML/スクリプト）は**リポジトリの中に作らない。置き場は `/tmp/claude-1000/`**（鉄則13）。リポジトリの中に作ってしまったものはコミット前に削除する。**自分で作った物に限り、`-f` を付けない `rm -r` と実在のパスの名指しで消し、消した物を報告に書く**（鉄則13）。★止められたら別の消し方を探さず報告する。
 9. **pnpm は取りに行かない・版を指定しない（ADR-015）** — ★`npx --yes pnpm@10 …` と打たない（毎回ダウンロードが走る）。`pnpm` とだけ打てば、そのリポジトリの `packageManager` の版が corepack で自動的に使われる。
    - ★**必ずリポジトリの中で打つ。** 版の指定はディレクトリごとに効くので、リポジトリの外（ホーム等）から `--filter` で呼ぶと既定の新しい版が動き `ERR_PNPM_UNSUPPORTED_ENGINE` で弾かれる（実測）。
    - `pnpm` が見つからない／版が合わないときは、回避せず**人の手番＝`corepack enable`** と報告する。`npm i -g pnpm` は打たない（corepack と衝突する）。
@@ -120,10 +120,17 @@ description: 采配くんの便（プロンプト末尾に CONDUCTOR_JOB:<id>
     - **電話は自由。** 外への通信（npm / GitHub / API / ドキュメント取得など）は許可済みなので、`Network request outside of sandbox` は出ない。**通信のために止まらない・人を待たない**。最後まで自走して完了まで行く。
     - **金庫は禁止。** 秘密の持ち出し（`curl -d @.env` / `cp .env` / `tar ~/.ssh` / `base64 .env` / `echo $DATABASE_URL` など）は**番人が今までどおり止める**。通信が自由になったこととは**別の仕組み**なので、「通信が許可されたから秘密も送れる」は成り立たない。本番DB・secret・`.env`・`hooks`・`.tyhld`・`.ssh` への書き込み禁止もそのまま。
     - **それでも塞がれたら回避しない。** `curl: (56) CONNECT tunnel failed, response 403` のように通信が塞がれたときは、**意図的に閉じてある接続先**（例: 本番DBへの直結）か、設定がその機体にまだ届いていないかのどちらか。**別経路を探さず、そこで止めて報告する**（人の手番＝`APPLY=1 bash scripts/update-guard.sh` → 職人を再起動）。
-13. **使い捨てファイルはリポジトリの中に作らない（えふさん決定 2026-09-03）**
-    - **実機検品・検証用の使い捨てファイル（HTML・画像・ログ等）は、リポジトリの中に作らない。`/tmp/claude-1000/` に置く。リポジトリ直下に作ってしまった場合は自分で消そうとせず、報告に「残骸あり・場所」と書く。**
-    - **なぜ。** 実機 2026-09-03: ai-saku の画面便（PR#258・PR#269）で、検品用の使い捨てページ `_layout-check.html` をリポジトリ直下に作り、消そうとして番人（`rm` on dangerous path）に止められ、人が2回 `rm` した。**番人の `rm` 制限は正しい（緩めない）。悪いのは置き場。**
-    - 置き場を `/tmp/claude-1000/` にすれば、番人に止められることも、残骸がコミットに混ざることも起きない（根治＝鉄則10）。Playwright の検品ページも同じ（鉄則8-④）。
+13. **使い捨てファイルはリポジトリの中に作らない（えふさん決定 2026-09-03／えふさん確定 2026-10-02・判断6 で後片付けの形を改めた）**
+    - **実機検品・検証用の使い捨てファイル（HTML・画像・ログ等）は、リポジトリの中に作らない。`/tmp/claude-1000/` に置く。**
+    - **リポジトリの中（直下を含む）に作ってしまったときの後片付け（えふさん確定 2026-10-02・判断6）。自分で作った物に限り、`-f` を付けない `rm -r` と実在のパスの名指しで消し、消した物を報告に書く。**
+      - 通る例: `rm -r ./_layout-check.html` ／ `rm -r node_modules/.tmp-作業名`（★実在のパスを名指し・`-f` を付けない）
+      - ★**はじめから在った物には触らない。** 自分が作った物かどうか分からなければ消さず、報告に「残骸あり・場所」と書く。
+      - ★**`.git`・`.claude/hooks`・`.tyhld` は、相対パスでも削除禁止**（番人が止める。緩めない）。
+      - ★**`-f` 付きの再帰削除（`rm -rf` 等）・変数や `*` を含む形は止まる**（禁止の一覧と番人）。
+      - ★**止められたら別の消し方（`find -delete`・`python -c` 等）を探さず、消せなかった場所を報告に書く**（鉄則4）。
+    - **なぜ（置き場の話）。** 実機 2026-09-03: ai-saku の画面便（PR#258・PR#269）で、検品用の使い捨てページ `_layout-check.html` をリポジトリ直下に作り、`rm -rf` で消そうとして止められ、人が2回消した。**禁止の一覧と番人の制限は正しい（緩めない）。悪いのは置き場。**
+    - **なぜ（後片付けの話を改めた理由）。** 旧い文言は「リポジトリ直下は番人が `rm` を止めるので自分で消さず報告」だった。実測（便 fb248f6e）では、`-f` を付けない `rm -r` と実在のパスの名指しなら、リポジトリ直下の自分の作業ファイルも通る。止まるのは `-f` 付きと変数・`*` 入りだけ。**止まらない形を「止まる」と書いていると、職人が自分の残骸を残したまま便を終える**ので、実物に合わせた（番人・禁止の一覧は1行も変えていない）。
+    - 置き場を `/tmp/claude-1000/` にすれば、止められることも、残骸がコミットに混ざることも起きない（根治＝鉄則10）。Playwright の検品ページも同じ（鉄則8-④）。
 14. **`.env` 類（`.env`・`.env.local`・`.env.example` などの雛形も含む）は職人が書き換えない（えふさん確定 2026-09-18・便 3d11f913）**
     - **番人は `.env` 本体も `.env.example` などの雛形も、書き込みを止める**（Write／Edit の設定 deny と、Bash の `echo`／`tee`／`sed -i`／`cp`／`mv` などを、経路を問わず同じ結果にそろえた）。読み込みは今までどおり（雛形は読める・本物は読めない）。
     - **なぜ。** 雛形（`.env.example`）は普通は秘密値を置かないが、「exampleだから常に安全」と番人へ例外を作ると、将来誤って実値が書かれたときの穴になる（利便性より安全側・えふさん確定）。
@@ -155,6 +162,7 @@ description: 采配くんの便（プロンプト末尾に CONDUCTOR_JOB:<id>
 - **`-f` 付き、または中身が変わる場所を指す再帰の `rm`**（`rm -rf`・`rm -fr`・`rm -r -f`・`rm -R`・`rm --recursive`／`rm -r "$DIR/x"`・`rm -r build/*` のように変数や `*` を含む）→ 止まる。`-f` 付きは配布している禁止の一覧（現場の `.claude/settings.json` の deny）で**必ず**止まる（番人より先に効く＝消す先が作業ファイルでも通らない・便 fb248f6e）。変数・`*` は番人が止める。**`-f` を付けず、消す先を実在のパスで名指しする**（`/tmp/claude-1000/` の下・鉄則13）。★止められたら**別の消し方を探さず**（`find -delete`・`python -c` 等に回らない）、消せなかった場所を報告に書く（鉄則4）。
   - 通る例: `rm -r /tmp/claude-1000/作業名` ／ `rm -r node_modules/.tmp-作業名`（★`-f` を付けない・自分で作った物だけ）
   - 止まる例: `rm -rf /tmp/claude-1000/作業名`（禁止の一覧）／ `rm -r "$DIR/x"`・`rm -r build/*`（番人）／ `rm -r .git`・`rm -r .claude/hooks`・`rm -r .tyhld`（番人＝相対パスでも消せない）
+  - ★**探すだけの道具の「探す言葉」に `rm …` と書いても、もう止まらない**（便 915694ac で直した）。鉄則や台本を調べるときの `grep -rn 'rm -rf .git' skills`・`git grep -n 'rm -r' -- skills`・`rg 'rm -rf /' docs` は通る。★囲みの外に書いた `rm` は今までどおり測るので、`grep -rn 'x' docs; rm -rf .git` のように**後ろで消す形は止まる**。
 - **作業場所が変数のままの `git push`**（`git -C "$DIR" push`・行き先のブランチを確かめられない形）→ 止まる。**リポの中で、ブランチを名指しして** `git push -u origin <作業ブランチ名>`。
 
 ## 便の終え方