@tyhld/conductor 0.12.97 → 0.12.99

package/dist/autoupdate.js

@@ -17,7 +17,7 @@
  *   ・入れ替えは全現場が空きのときだけ: 札を置く → 中継の1周ぶん待つ → もう一度空きを確かめる →
  *     版を名指しして入れる（取得先は毎回 https://registry.npmjs.org・@latest にしない）→
  *     全現場の常駐を起こし直す → 札を外す → 自己診断 → 管制へ（自己診断が届ける）。
- *   ・空きでなければ次の回に再挑戦。6時間空かなければ札を置いて新しい便を取らない形に移り、
+ *   ・空きでなければ次の回に再挑戦。30分空かなければ札を置いて新しい便を取らない形に移り、
  *     走っている便の終わりを待つ（★走っている便は止めない）。
  *   ・自己診断が FAIL → そのPCだけ前の版へ戻す → 自己診断（after-rollback＝rolledBack が管制へ届く）。
  *     戻しても FAIL なら、その版のまま止まって🟡（Claude Code・囲い・小さな試験が落ちたままなら
@@ -47,8 +47,18 @@ export const CONDUCTOR_REGISTRY_ARG = '--@tyhld:registry=https://registry.npmjs.
 export const CLAUDE_INSTALL_URL = 'https://claude.ai/install.sh';
 /** 管制が checkAgainMin を返さないときの間隔（分）。 */
 export const DEFAULT_CHECK_MIN = 15;
-/** 空きが来ないとき、札を置いて新しい便を取らない形に移るまでの長さ。 */
-export const BUSY_LIMIT_MS = 6 * 60 * 60 * 1000;
+/**
+ * 空きが来ないとき、札を置いて新しい便を取らない形に移るまでの長さ。
+ *
+ * 【30分にした理由（えふさん確定 2026-10-05・便 684ac785）】
+ *   以前は6時間。便が続いている機体（メインPC）は「全現場が同時に空く時」が来ないので、
+ *   新しい版への入れ替えが6時間待たされた。実物: メインPCの配り役が 0.12.92 のままで、
+ *   Codex 向けの配達文（0.12.95 から入った）が便に入らなかった。
+ *   札を置けば新しい便を取らなくなるので、走っている便が終わった時点で空きになる＝
+ *   30分で札を置くほうが、入れ替えまでの時間がはるかに短くなる。
+ *   ★走っている便は止めない（今までどおり）。札は入れ替えが済んだら外す（今までどおり）。
+ */
+export const BUSY_LIMIT_MS = 30 * 60 * 1000;
 /** 起こし直した常駐が立ち上がるのを待つ上限。 */
 export const RESTART_WAIT_MS = 120_000;
 /** 起こし直した常駐の様子を見る間隔。 */
@@ -569,7 +579,7 @@ export async function runUpdater(d) {
         const waited = now.getTime() - Date.parse(s.busySince);
         if (waited >= BUSY_LIMIT_MS) {
             placeDrain(d, s);
-            return done(d, s, 'draining', `${comp} ${want} へ入れ替えたいが、6時間空きが来ません。札を置いて、走っている便（${busy.join(',')}）の終わりを待ちます`);
+            return done(d, s, 'draining', `${comp} ${want} へ入れ替えたいが、30分空きが来ません。札を置いて、走っている便（${busy.join(',')}）の終わりを待ちます`);
         }
         return done(d, s, 'busy', `作業中の便があるので入れ替えません（${busy.join(',')}）。次の回に再挑戦します`);
     }

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, ackResumeSignal, buildAnchor, buildSendText, canDeliver, completeWithReport, createRelayState, deliverJobEndFacts, deliveryReport, fetchCommand, fetchCommandStatus, fetchControl, fetchOrphans, flushPendingJobEndFacts, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteDrain, noteReadiness, patchStatus, recoverStuckProcessedReports, reconnectDelayMs, FINISH_GATE_KINDS, reportDelivery, 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, ackResumeSignal, buildAnchor, buildSendText, canDeliver, completeWithReport, createRelayState, deliverJobEndFacts, deliveryReport, fetchCommand, fetchCommandStatus, fetchControl, fetchOrphans, flushPendingJobEndFacts, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteDrain, noteReadiness, patchStatus, recoverStuckProcessedReports, reconnectDelayMs, WAIT_CLOSED_STATUS, FINISH_GATE_KINDS, reportDelivery, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
 import { claudePinPath, readClaudePinLine, } from './autoupdate-flags.js';
 const log = (msg) => {
     console.log(`[headless] ${msg}`);
@@ -1792,8 +1792,10 @@ export const RESUME_MEMO_MAX = 200;
  *   perm_wait … 人の手番で止まっている（本番操作待ちの便はここで待つ）。この現場を占有し続ける。
  *   sent      … 配達済みのまま（管制が戻した・まだ閉じていない）。
  * ★done / failed / dismissed / queued では起こさない（終わった便・まだ配っていない便を起こさない）。
+ * ★待ちの綴りは1か所（relay.ts の WAIT_CLOSED_STATUS）。「起こせる状態」と「完了を書かない状態」が
+ *   食い違うと、起こせない便を完了にする／完了にできる便を起こそうとする、のどちらかが起きる。
  */
-export const RESUMABLE_CENTRAL_STATUSES = new Set(['perm_wait', 'sent']);
+export const RESUMABLE_CENTRAL_STATUSES = new Set([WAIT_CLOSED_STATUS, 'sent']);
 /** 「この便は続きから起こせる」の控えを覚えておく件数の上限。 */
 export const RESUMABLE_MEMO_MAX = 20;
 /** 現場ごとの「使い終わった合図」の記録ファイル。 */

package/dist/relay.js

@@ -316,6 +316,11 @@ export const RELAY_SKIP_WARN_THRESHOLD = 6;
  *   中央が便を抱える上限（CENTRAL_BUSY_HOLD_MAX_MS＝3時間）と同じ値にそろえる。
  */
 export const RELAY_CODEX_TURN_HOLD_MAX_MS = CENTRAL_BUSY_HOLD_MAX_MS;
+/**
+ * 受け皿の名前をそろえる仕事（登録簿の書き出し・読まれない受け皿の始末）の間隔。
+ *   ★配達の判断には1バイトも関わらない。フォルダを見に行くので毎周はやらない。
+ */
+export const RELAY_CODEX_TRAY_TIDY_MS = 10 * 60 * 1000;
 /** 初期状態を作る。 */
 export function createRelayState() {
     return {
@@ -337,6 +342,7 @@ export function createRelayState() {
         lastNudgeLogAt: null,
         codexTurnOpen: null,
         codexNoticeSeen: false,
+        codexTrayTidiedAt: null,
         central: { failures: 0, detail: '', downSince: null },
         readiness: createReadiness(),
     };
@@ -1046,11 +1052,22 @@ export function buildAnchor(id) {
 //   現場ごとの受け皿へ1行書く。relay はそれを読み、**既存の完了経路**（patchStatus done+report）
 //   へそのまま橋渡しする。＝完了を中央へ伝える道は今までどおり1本のまま。
 // ───────────────────────────────────────────────────────────────────────────
-/** Codex の受け皿の置き場。受け口スクリプトと同じ決め方にする。 */
+/**
+ * Codex の受け皿の置き場。受け口スクリプトと同じ決め方にする。
+ *
+ * ★試験のあいだは、置き場を名指ししていなければ【使い捨ての置き場】へ倒す（便 684ac785）。
+ *   受け皿には本物の便の完了が入っている（~/.tyhld/codex-notify）。試験が置き場を渡し忘れると、
+ *   本物の受け皿を読んで消す・控えや登録簿を書き足す、が起こり得る。tmux の隔てと同じ考えで、
+ *   「試験を書く人が渡し忘れても本物に触れない」ようにしておく（人の約束に頼らない）。
+ */
 export function codexNotifyDir(env = process.env) {
     const explicit = (env.CONDUCTOR_CODEX_NOTIFY_DIR ?? '').trim();
     if (explicit)
         return explicit;
+    if (isUnderTest(env)) {
+        // ★プロセスごとに別の置き場（試験ファイルは別プロセスで走るので、互いに混ざらない）。
+        return path.join(os.tmpdir(), `conductor-test-codex-notify-${process.pid}`);
+    }
     const home = (env.HOME ?? '').trim();
     return home ? path.join(home, '.tyhld', 'codex-notify') : '';
 }
@@ -1261,6 +1278,254 @@ export function pickCodexNoticeFor(site, job, env = process.env) {
     return { notice, skipped, skippedFile: recordSkippedCodexNotices(site, skipped, env) };
 }
 // ───────────────────────────────────────────────────────────────────────────
+// 現場の登録簿と、読まれない受け皿の始末（★便 684ac785）
+//
+// 【何が起きていたか（実物 2026-10-04）】受け口（scripts/codex/codex-notify.py）は現場名を
+//   「Codex を起動したフォルダの名前」から決めていた。Codex を【現場の下のフォルダ】で
+//   起動すると、配り役が読まない名前の受け皿ができる。
+//     現場 codex-probe（配り役は codex-probe.jsonl を読む）
+//       ~/codex-probe        で起動 → codex-probe.jsonl  … 読まれる
+//       ~/codex-probe/video-lab で起動 → video-lab.jsonl … ★誰にも読まれない（30件・36KB）
+//   同じずれは「現場名とフォルダ名が違う現場」でも起きる（sites.sh: plus1 → plus1-foryou）。
+//
+// 【根治の2本立て】
+//   ① 受け口が【配り役の現場名】で書く。そのために配り役が現場名と作業フォルダを
+//      登録簿（<受け皿の置き場>/sites.json）へ書き出す。受け口は配達文の `DONE:<現場>` を
+//      第一に見て、無いときこの登録簿を引く（codex-notify.py の resolve_site）。
+//   ② 既に溜まっている【読まれない受け皿】を、人の手を借りずに控えへ回す
+//      （sweepStrayCodexNotices）。★消さない＝中身は1行も失わずに控えへ移す。
+// ───────────────────────────────────────────────────────────────────────────
+/** 現場の登録簿のファイル名（★codex-notify.py の SITES_REGISTRY と同じ名前）。 */
+export const CODEX_SITES_REGISTRY = 'sites.json';
+/** 現場名として使える字（★scripts/sites.sh の is_valid_site_name と同じ）。 */
+const SITE_NAME_OK = /^[A-Za-z0-9_-]+$/;
+/** 登録簿のパス。受け皿の置き場が分からなければ ''。 */
+export function codexSitesRegistryPath(env = process.env) {
+    const dir = codexNotifyDir(env);
+    return dir ? path.join(dir, CODEX_SITES_REGISTRY) : '';
+}
+/** 登録簿を読む（無い・壊れている → 空）。 */
+export function readCodexSiteRegistry(env = process.env) {
+    const file = codexSitesRegistryPath(env);
+    if (!file)
+        return [];
+    let raw;
+    try {
+        raw = readFileSync(file, 'utf8');
+    }
+    catch {
+        return [];
+    }
+    try {
+        const o = JSON.parse(raw);
+        if (!Array.isArray(o.sites))
+            return [];
+        const out = [];
+        for (const e of o.sites) {
+            if (typeof e !== 'object' || e === null)
+                continue;
+            const r = e;
+            const site = typeof r.site === 'string' ? r.site.trim() : '';
+            const workDir = typeof r.workDir === 'string' ? r.workDir.trim() : '';
+            if (!SITE_NAME_OK.test(site) || workDir === '')
+                continue;
+            out.push({
+                site,
+                workDir,
+                machine: typeof r.machine === 'string' ? r.machine : undefined,
+                at: typeof r.at === 'string' ? r.at : undefined,
+            });
+        }
+        return out;
+    }
+    catch {
+        return []; // 壊れていたら空から書き直す（配達の道は止めない）
+    }
+}
+/**
+ * 自分の現場を登録簿へ書き込む（ほかの現場の行は1つも落とさない）。
+ * 返り: 実際に書いたか（中身が同じなら書かない＝毎周の書き込みを増やさない）。
+ * ★失敗しても false を返すだけ（登録簿が無くても受け口は ③④ の決め方へ倒れる）。
+ */
+export function recordCodexSite(entry, env = process.env, now = new Date()) {
+    const file = codexSitesRegistryPath(env);
+    if (!file)
+        return false;
+    if (!SITE_NAME_OK.test(entry.site) || entry.workDir.trim() === '')
+        return false;
+    const current = readCodexSiteRegistry(env);
+    const mine = current.find((e) => e.site === entry.site);
+    if (mine && mine.workDir === entry.workDir && mine.machine === entry.machine)
+        return false;
+    const next = [
+        ...current.filter((e) => e.site !== entry.site),
+        { site: entry.site, workDir: entry.workDir, machine: entry.machine, at: now.toISOString() },
+    ].sort((a, b) => (a.site < b.site ? -1 : a.site > b.site ? 1 : 0));
+    try {
+        mkdirSync(path.dirname(file), { recursive: true });
+        const tmp = `${file}.tmp`;
+        writeFileSync(tmp, `${JSON.stringify({ sites: next }, null, 2)}\n`, 'utf8');
+        renameSync(tmp, file); // 置き換えは原子的＝受け口が書きかけを読まない
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * その現場の作業フォルダを決める（登録簿に書く値・★純粋関数）。
+ *
+ * paneCwd（職人の窓がいま居る場所）から上へたどり、名前が現場名と同じ先祖が在ればそこ。
+ * 無ければ、現場の置き場の定番（`~/projects/<現場>` → `~/<現場>`）のうち paneCwd を含む物。
+ * どれでもなければ paneCwd そのまま（★その下で動く Codex の知らせは正しく届く）。
+ * paneCwd が読めなければ `~/projects/<現場>`（headless と同じ既定）。
+ */
+export function codexSiteWorkDir(site, paneCwd, home) {
+    const fallback = path.join(home, 'projects', site);
+    const cwd = (paneCwd ?? '').trim();
+    if (cwd === '' || !path.isAbsolute(cwd))
+        return fallback;
+    const norm = path.normalize(cwd);
+    for (let cur = norm;;) {
+        if (path.basename(cur) === site)
+            return cur;
+        const parent = path.dirname(cur);
+        if (parent === cur)
+            break;
+        cur = parent;
+    }
+    const under = (dir) => norm === dir || norm.startsWith(`${dir}${path.sep}`);
+    for (const cand of [path.join(home, 'projects', site), path.join(home, site)]) {
+        if (under(cand))
+            return cand;
+    }
+    return norm;
+}
+/**
+ * 【配り役が読まない名前の受け皿】を、控えへ回す（★消さない・人が手で片付けなくて済む形）。
+ *
+ * 対象の見分け方: 受け皿の置き場に在る `<名前>.jsonl` のうち、
+ *   ・自分の受け皿（`<現場>.jsonl`）ではない
+ *   ・控え（`*.skipped.jsonl`）でも登録簿でもない
+ *   ・★`<名前>` が【この現場の作業フォルダの下に実在するフォルダの名前】
+ * ＝古い受け口が「現場の下のフォルダで起動した Codex」のために作ってしまった受け皿だけ。
+ *   ほかの現場の受け皿を巻き込まない（名前が自分の作業フォルダの下に無ければ触らない）。
+ *
+ * 中身は1行も捨てず `<現場>.skipped.jsonl` へ理由つきで移し、空になった受け皿を取り除く。
+ * ★どの便の完了にも使わない（控えは配り役が完了として読む場所ではない）。
+ */
+export function sweepStrayCodexNotices(site, workDir, env = process.env) {
+    const dir = codexNotifyDir(env);
+    if (!dir || workDir.trim() === '')
+        return [];
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const subNames = subdirNamesUnder(workDir);
+    const out = [];
+    for (const name of names) {
+        if (!name.endsWith('.jsonl'))
+            continue;
+        if (name.endsWith('.skipped.jsonl'))
+            continue;
+        const base = name.slice(0, -'.jsonl'.length);
+        if (base === site || !SITE_NAME_OK.test(base))
+            continue;
+        if (!subNames.has(base))
+            continue;
+        const file = path.join(dir, name);
+        let lines;
+        try {
+            lines = completeJsonlLines(readFileSync(file, 'utf8')).filter((l) => l.trim() !== '');
+        }
+        catch {
+            continue;
+        }
+        const entries = lines.map((line) => {
+            let report = '';
+            let jobId = null;
+            let threadId = null;
+            let turnId = null;
+            let at = null;
+            try {
+                const o = JSON.parse(line);
+                report = typeof o.report === 'string' ? o.report : line;
+                jobId = typeof o.jobId === 'string' && o.jobId.trim() !== '' ? o.jobId.trim() : null;
+                threadId = o.threadId ?? null;
+                turnId = o.turnId ?? null;
+                at = parseNoticeAt(o.at);
+            }
+            catch {
+                report = line; // 読めない行も中身をそのまま残す（捨てない）
+            }
+            return {
+                notice: { site, report, threadId, turnId, jobId, at },
+                why: `配り役が読まない名前の受け皿に入っていた知らせ（受け口の古い版・受け皿=${name}）`,
+            };
+        });
+        recordSkippedCodexNotices(site, entries, env);
+        try {
+            unlinkSync(file); // 中身は控えへ移してある＝1行も失わない
+        }
+        catch {
+            /* 消せなくても次の回にまた移すだけ（控えは同じ内容が増えるが、完了には使われない） */
+        }
+        out.push({ tray: name, moved: entries.length });
+    }
+    return out;
+}
+/**
+ * 受け皿の名前をそろえる（1周ぶん・★Codex の現場だけ）。
+ *   ① この現場の「現場名 ↔ 作業フォルダ」を登録簿へ書く（受け口がこれを引いて受け皿の名前を決める）。
+ *   ② 配り役が読まない名前の受け皿を控えへ回す（中身は1行も捨てない）。
+ * ★RELAY_CODEX_TRAY_TIDY_MS ごとに1回だけ。配達の判断には関わらない（失敗しても配達は進む）。
+ */
+export function tidyCodexTrays(cfg, state, deps = {}) {
+    const now = deps.now ?? Date.now();
+    if (state.codexTrayTidiedAt !== null && now - state.codexTrayTidiedAt < RELAY_CODEX_TRAY_TIDY_MS) {
+        return;
+    }
+    state.codexTrayTidiedAt = now;
+    const logLine = deps.logLine ?? log;
+    const home = deps.home ?? os.homedir();
+    const paneCwd = (deps.paneCwd ?? tmuxPaneCwd)(cfg.site);
+    const workDir = codexSiteWorkDir(cfg.site, paneCwd, home);
+    if (recordCodexSite({ site: cfg.site, workDir, machine: cfg.machine }, deps.env)) {
+        logLine(`site=${cfg.site} 現場の登録簿を書きました（作業フォルダ=${workDir}）` +
+            '＝この下のどのフォルダで Codex が動いても、知らせはこの現場の受け皿に入ります');
+    }
+    for (const swept of sweepStrayCodexNotices(cfg.site, workDir, deps.env)) {
+        logLine(`site=${cfg.site} 配り役が読まない受け皿 ${swept.tray} の ${swept.moved} 件を、` +
+            'どの便の完了にも使わず控えへ回しました（中身は消していません）');
+    }
+}
+/** 作業フォルダの下（深さ2まで）に在るフォルダの名前。読めなければ空。 */
+function subdirNamesUnder(workDir) {
+    const out = new Set();
+    const walk = (dir, depth) => {
+        let kids;
+        try {
+            kids = readdirSync(dir, { withFileTypes: true })
+                .filter((d) => d.isDirectory() && !d.name.startsWith('.') && d.name !== 'node_modules')
+                .map((d) => d.name);
+        }
+        catch {
+            return;
+        }
+        for (const k of kids) {
+            out.add(k);
+            if (depth > 1)
+                walk(path.join(dir, k), depth - 1);
+        }
+    };
+    walk(workDir, 2);
+    return out;
+}
+// ───────────────────────────────────────────────────────────────────────────
 // Codex の最後の返事に書いてもらう「機械で読める囲み」（便 cfa9eeec）
 //
 // 【なぜ要るか（実測 2026-10-04・codex-cli 0.160.0・便 f8ac8674 / 4c9f5049）】
@@ -1588,6 +1853,38 @@ export function isCentralFinished(status) {
     const s = status.trim().toLowerCase();
     return isTerminalCommandStatus(s) || CENTRAL_EXTRA_TERMINAL_STATUSES.has(s);
 }
+/**
+ * 管制が「人の手番で待っている（＝まだ終わっていない）」と言うときの status（★綴りは1か所）。
+ *
+ * 本番操作の承認が長引いた便は、職人が `conductor_complete` を `waitForProdOp:true` で呼ぶと
+ * `done` にならずこの状態のまま閉じられる（管制 ai-kana PR #425）。本番操作が済むと管制の合図で
+ * 【同じ便の続き】から起きる（headless.ts の RESUMABLE_CENTRAL_STATUSES も同じ1語を使う）。
+ */
+export const WAIT_CLOSED_STATUS = 'perm_wait';
+/**
+ * 中央が「この便は人の手番で待っている＝まだ終わっていない」と言っているか（純粋関数）。
+ *
+ * 【なぜ要るか（便 f20dd761）】待ちのまま閉じた便を、職人の `DONE:` の1行やプロセスの正常終了で
+ *   配り役が `done` にしてしまうと、合図では二度と起きない（「終端は起こさない＝Fail Closed」は
+ *   正しいので緩めない）。だから【完了を書く前に】中央へ聞いて、待ちで閉じられていれば書かない。
+ *
+ * 【★確かめられる材料はこれだけ】配り役がいま使っている口
+ *   `GET /api/conductor/commands/{id}` は status しか返さない（statusNote も依頼の行も返らない）。
+ *   つまり「本番操作の待ち」か「それ以外の人待ち」かは、この口では見分けられない。
+ * 【どちらへ倒すか＝書かない側】理由は取り返しのつきかた:
+ *   ・書いてしまうと終端＝二度と起こせない（作業がまるごと失われる）。
+ *   ・書かないでおけば、この状態は管制の RECOVERABLE_STATUSES に入っているので、職人の
+ *     `conductor_complete` でも人の操作でも、あとから `done` へ回収できる。
+ *   ＝「待ちでない便の完了」は取りこぼしても回収できるが、「待ちの便の完了」は回収できない。
+ * 【★中央不達（null）は今までどおり】status を読めないときは false＝従来の動きへ無損失で縮退する
+ *   （読めないだけで全部の便が終われなくなる形にしない）。この穴を塞ぐには管制側が要る
+ *   （報告の「要判断」に、どの口に何が要るかを書いた）。
+ */
+export function isWaitClosedCommandStatus(status) {
+    if (status === null)
+        return false;
+    return status.trim().toLowerCase() === WAIT_CLOSED_STATUS;
+}
 /**
  * sent孤児を pending 構造へ変換する純粋関数（★送信はしない）。
  *   - anchor は buildAnchor(id) で再生成（id 不変＝アンカー不変）＝完了検出の境界が復元前と揃う。
@@ -1757,7 +2054,17 @@ export function fullCompletionGuide(site, commandId) {
         `reportに理由を書いてください。ブランチを切らない読み取り専用の作業では outcome=no_change を渡してください` +
         `（branchは省略可）。` +
         // ★nextWork（次の独立作業候補）は必ず書く（conductor_complete の説明と同じ・便 a5306df2 で両方にそろえた）。
-        `nextWork（次の独立作業候補）は必ず書いてください（無ければ「なし」と理由）。\n\n`);
+        `nextWork（次の独立作業候補）は必ず書いてください（無ければ「なし」と理由）。\n\n` +
+        // ★本番操作の承認待ちで「待ち」のまま閉じる手番だけの例外（便 f20dd761・管制 PR #425）。
+        //   ここに書いてある決まりは、鉄則の「便の終え方」の⑤と中身を同じに保つ（等しさの試験が見る）。
+        `★本番操作の承認が長引いて、便を「待ち」のまま閉じるときだけは例外です。` +
+        `conductor_complete を waitForProdOp:true（分かれば prodOpRequestId も）で呼ぶと、` +
+        `便は完了にならず「本番操作の承認待ち」のまま閉じます。` +
+        `★この手番では ${marker} の行を出さないでください` +
+        `（出すと配り役の完了検出がこの便を完了＝終端にしてしまい、本番操作が済んでも続きから起こせなくなります）。` +
+        `報告ファイルは置いてよいです（報告ファイルだけでは便は完了になりません）。` +
+        `本番操作が済むと、管制の合図で同じ便の続きから起きます。続きを行い、` +
+        `本当に終わったときに今までどおり（${marker} も出して）終えてください。\n\n`);
 }
 /**
  * Codex の職人へ付ける完了案内（便 cfa9eeec・★Claude 向けは shortCompletionLine）。
@@ -1815,11 +2122,54 @@ export function codexCompletionGuide(site, commandId) {
 }
 // ───────────────────────────────────────────────────────────────────────────
 // tmux I/O（失敗は握りつぶして null/false。送らない側に倒すため）
+//
+// 【★試験が本物の職人の画面へ1文字も送れない作り（便 684ac785）】
+//   実地の事故 2026-10-04（便 99fc49c0）: 配達の道を通る試験を【実物と同じ現場名】
+//   （codex-probe）で書いてしまい、動いている Codex の画面へ試験の文が貼られ、
+//   Codex が 38 秒の追加ターンを走らせた。
+//   そのときの直しは「試験の現場名を存在しない名前に変える」＝★人の約束だった。
+//   約束は破られる（次に試験を書く人が実物の名前を使えば、また届く）。
+//
+//   ★だから【送り先そのもの】を仕組みで隔てる。tmux は `-L <名前>` で
+//     【別のサーバ（別のソケット）】に話しかける。本物の職人は【既定のサーバ】に居るので、
+//     試験のあいだ必ず `-L` を挟めば、同じ現場名を書いても本物には構造的に届かない。
+//   ★この挟み込みは、tmux を呼ぶ道を1本（tmuxExec）に寄せたうえで、そこだけで行う。
+//     「試験かどうか」は Node の試験ランナーが自分で立てる印（NODE_TEST_CONTEXT）で測る＝
+//     試験を書く人が設定を書き忘れても必ず効く（約束に頼らない）。
 // ───────────────────────────────────────────────────────────────────────────
+/** 試験のあいだ使う tmux サーバの名前（★本物の職人が居る既定のサーバとは別物）。 */
+export const TMUX_TEST_SERVER = 'conductor-test';
+/**
+ * いま試験の中で動いているか。★Node の試験ランナー（`node --test`）が子プロセスへ必ず渡す印を見る。
+ *   実測（node 24.15.0）: 試験ファイルのプロセスでは `NODE_TEST_CONTEXT=child-v8`。
+ *   ＝試験を書く人が何も書かなくても効く（人の約束に頼らない）。
+ */
+export function isUnderTest(env = process.env) {
+    return (env.NODE_TEST_CONTEXT ?? '').trim() !== '';
+}
+/**
+ * tmux を呼ぶときに必ず前へ置く引数（どのサーバに話しかけるか）。
+ *   - `CONDUCTOR_TMUX_SERVER` が在れば、その名前のサーバ（試験が自分で立てたサーバを指すため）。
+ *   - 無く、かつ試験の中なら、試験用のサーバ（★本物には届かない）。
+ *   - ふだんの運用では空＝既定のサーバ（今までと1バイトも変わらない）。
+ */
+export function tmuxServerArgs(env = process.env) {
+    const explicit = (env.CONDUCTOR_TMUX_SERVER ?? '').trim();
+    if (explicit !== '')
+        return ['-L', explicit];
+    return isUnderTest(env) ? ['-L', TMUX_TEST_SERVER] : [];
+}
+/**
+ * tmux を呼ぶ【唯一の口】。★ここ以外から tmux を起動しない
+ *   （見張りの試験 relay-test-tmux-isolation が、口が1つのままかを字面で確かめる）。
+ */
+function tmuxExec(args, opts) {
+    return execFileSync('tmux', [...tmuxServerArgs(), ...args], opts);
+}
 /** tmux セッション {site} が存在するか。tmux 未インストール時も false。 */
 export function tmuxHasSession(site) {
     try {
-        execFileSync('tmux', ['has-session', '-t', site], { stdio: 'ignore' });
+        tmuxExec(['has-session', '-t', site], { stdio: 'ignore' });
         return true;
     }
     catch {
@@ -1841,7 +2191,7 @@ export const RELAY_CAPTURE_SCROLLBACK_LINES = 2000;
  */
 export function tmuxCapture(site) {
     try {
-        return execFileSync('tmux', ['capture-pane', '-t', site, '-p', '-S', `-${RELAY_CAPTURE_SCROLLBACK_LINES}`], {
+        return tmuxExec(['capture-pane', '-t', site, '-p', '-S', `-${RELAY_CAPTURE_SCROLLBACK_LINES}`], {
             stdio: ['ignore', 'pipe', 'ignore'],
             encoding: 'utf8',
         });
@@ -2500,7 +2850,7 @@ function describeExecError(err) {
 }
 /** tmux を1回呼ぶ。失敗時は stderr を積んだ例外がそのまま飛ぶ。 */
 function runTmux(args) {
-    execFileSync('tmux', args, { stdio: ['ignore', 'ignore', 'pipe'] });
+    tmuxExec(args, { stdio: ['ignore', 'ignore', 'pipe'] });
 }
 /**
  * tmux へ本文を1メッセージとして送り、貼り付けの枠の外に添え書き（RELAY_DELIVERY_NOTE）を打ち、
@@ -2563,7 +2913,7 @@ function pasteToTmux(site, text) {
     }
     catch (err) {
         try {
-            execFileSync('tmux', ['delete-buffer', '-b', bufferName], { stdio: 'ignore' });
+            tmuxExec(['delete-buffer', '-b', bufferName], { stdio: 'ignore' });
         }
         catch {
             // 貼れていれば -d で既に消えている。無いバッファを消そうとしたエラーは無視してよい。
@@ -2765,10 +3115,10 @@ export const RELAY_SUBMIT_MAX_RESEND = 3;
 /** tmux のペインがいま居る場所（職人の作業場所）。取れなければ null。 */
 export function tmuxPaneCwd(site) {
     try {
-        const out = execFileSync('tmux', ['display-message', '-p', '-t', site, '#{pane_current_path}'], {
+        const out = String(tmuxExec(['display-message', '-p', '-t', site, '#{pane_current_path}'], {
             encoding: 'utf8',
             stdio: ['ignore', 'pipe', 'ignore'],
-        }).trim();
+        })).trim();
         return out || null;
     }
     catch {
@@ -3251,8 +3601,27 @@ export async function fetchCommand(cfg) {
  *     null/未指定なら report は送らず status のみ（従来どおり）。
  *   - 409（他が sent 中などの安全弁）→ false（送らない）。
  *   - 200 → true。
+ *
+ * 【★完了（done）だけは、書く前に中央へ聞く（便 f20dd761）】
+ *   待ちのまま閉じられた便（isWaitClosedCommandStatus）に `done` を書くと、その便は終端になり
+ *   管制の合図では二度と起きない。職人の作法（「待ちで閉じた手番では DONE: を出さない」）だけに
+ *   頼らず、★完了を書く道そのものを1か所でふさぐ（ここを通らずに done を書く道は無い）。
+ *   ・`done` 以外（delivering / sent / failed）は1バイトも動きが変わらない。
+ *     ★failed は塞がない：起こし直しに失敗した等の「動かせない事実」は管制へ届かないと困る
+ *       （headless の再開の道は、起こせなかったとき perm_wait の便へ failed と理由を書く）。
+ *   ・返りは true＝「書かなかったが、やり直す意味も無い（便の状態は管制が持っている）」。
+ *     呼び出し側は追跡を畳んでよい。false（＝次の周でやり直す）に倒すと、画面なし方式が
+ *     上限回数のあとに `failed` を書いてしまい、待ちの便を殺す。
  */
 export async function patchStatus(cfg, id, status, report) {
+    if (status === 'done') {
+        const held = await fetchCommandStatus(cfg, id);
+        if (isWaitClosedCommandStatus(held)) {
+            log(`site=${cfg.site} id=${id} 完了は書きません（管制は status=${held}＝人の手番で待っています）` +
+                '→本番操作が済めば管制の合図で同じ便の続きから起きます');
+            return true;
+        }
+    }
     try {
         const payload = report != null ? { status, report } : { status };
         const res = await fetch(`${cfg.url}/api/conductor/commands/${encodeURIComponent(id)}`, {
@@ -3330,6 +3699,18 @@ export async function completeWithReport(cfg, id, logLine = log) {
                 : '→relayからは送りません（報告は控えとして処理済みにしました）'));
         return true;
     }
+    if (isWaitClosedCommandStatus(already)) {
+        // ★待ちのまま閉じられた便（本番操作の承認待ち・管制 PR #425）。★完了を1バイトも書かない。
+        //   職人の作法（「待ちで閉じた手番では DONE: を出さない」）が守られなくても、画面の DONE でも
+        //   プロセスの正常終了でも、ここで止まる＝合図で同じ便の続きから起こせる状態を壊さない。
+        //   ★報告ファイルは「処理済み」に移さない。移すと職人が続きで書き直した報告と混ざる
+        //     （移さなくても回収の道が送る＝その口は便を完了にしない）。
+        //   ★返りは true＝追跡を畳んでよい。管制はこの便で現場を占有し続けるので、次の便は配られない。
+        logLine(`site=${cfg.site} id=${id} は待ちのまま閉じられています(status=${already})` +
+            '→完了は書きません（本番操作が済めば管制の合図で同じ便の続きから起きます）' +
+            (phase === 'none' ? '' : `／報告は手元の控えに残します（${phase}）`));
+        return true;
+    }
     if (phase === 'processed') {
         // ★①は済み・②は未了。本文は渡してあるので、状態だけを書く（開発履歴を2件にしない）。
         //   書けなければ false＝次の周でやり直す（完了を落とさない）。
@@ -4511,6 +4892,9 @@ export async function relayTick(cfg, state, hooks) {
         // 配ったときに受け皿に残っていて誤って取り込まれる、という筋道が構造的に消える。
         // ★併せて「前のターンがまだ途中」の札を下ろす（終わったと分かったので次を配れる）。
         if (kindOf(cfg) === 'codex') {
+            // ★受け皿の名前をそろえる（登録簿の書き出し・読まれない受け皿の始末・便 684ac785）。
+            //   配達の判断には関わらない＝ここで何が起きても、この下の始末と配達は今までどおり進む。
+            tidyCodexTrays(cfg, state);
             const left = pickCodexNoticeFor(cfg.site, null);
             if (left.skipped.length > 0) {
                 state.codexNoticeSeen = true;

package/package.json

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

package/scripts/codex/codex-notify.py

@@ -37,6 +37,28 @@
   これが無かったせいで、配り役は「最新の1行＝いま追っている便の完了」としか読めず、
   前の便のターンの知らせを次の便の完了として取り込んだ（便 1427b428 が19秒で done）。
 
+【★受け皿の名前を、配り役が読む現場名に必ず合わせる（2026-10-05・便 684ac785）】
+  旧: 現場名＝`os.path.basename(cwd)`。Codex を【現場の下のフォルダ】で起動すると、
+      配り役が読まない名前の受け皿ができ、そこへ入れた知らせは誰にも読まれなかった。
+      実物: 現場 codex-probe（配り役は codex-probe.jsonl を読む）で、Codex を
+      ~/codex-probe/video-lab で起動 → video-lab.jsonl に 30 件・36KB が溜まった。
+  ★同じずれは「現場名とフォルダ名が違う現場」でも起きる（sites.sh の対応表:
+      plus1 → ~/projects/plus1-foryou）。だから【フォルダ名から推測しない】のが根治。
+  新: 上から順に決める（resolve_site）。
+    ① 配達文に書かれた現場名 … 配り役は便の本文へ必ず完了の合図 `DONE:<現場>` を書く
+       （relay.ts の buildSendText → shortCompletionLine / codexCompletionGuide）。
+       ★これは配り役が「自分の現場名」として書いた字そのもの＝受け皿の名前の正本。
+       案内は本文の【後ろ】に足されるので、本文が別の現場名を引用していても
+       【最後の DONE:】が配り役の現場名になる。
+    ② 現場の登録簿 … 配り役が書く `<受け皿の置き場>/sites.json`（現場名 ↔ 作業フォルダ）。
+       cwd を含む作業フォルダの現場名を引く（いちばん長く一致する物）。
+       ★人が手で打ったターン（配達文が無い）でも、ここで正しい現場に入る。
+    ③ git の頂上フォルダ名 … 配り役の現場名の決め方（cli.ts の detectSite）と同じ。
+       ★ホームより上へはたどらない（現場の作業フォルダは必ずホームの下に在るので、
+         ホームより上に置かれた `.git` を現場名として拾わない）。
+    ④ それも分からなければ作業フォルダの名前（今までどおり）。
+  ★どれでも決められない知らせは【捨てない】。理由つきで控え（UNRESOLVED_FILE）へ残す。
+
 【やること】残す通知だけを、現場ごとの受け皿へ1行足す。
   置き場: $CONDUCTOR_CODEX_NOTIFY_DIR（既定 $HOME/.tyhld/codex-notify）/<現場>.jsonl
   ★中央へは送らない。送るのは relay の仕事（完了の経路は1本に保つ）。
@@ -57,6 +79,25 @@ REPORT_MARK = 'CONDUCTOR_REPORT'
 # 指示本文の末尾に付く管理用ジョブ印。
 JOB_STAMP = re.compile(r'CONDUCTOR_JOB:\s*([0-9A-Za-z][0-9A-Za-z-]{7,})')
 
+# 配達文に必ず入る完了の合図（`DONE:<現場>`）。★配り役が書いた現場名そのもの。
+#   空白は挟まない形だけを見る（配り役が出す字は必ずこの形。地の文の「DONE: 〜」を拾わない）。
+SITE_STAMP = re.compile(r'DONE:([A-Za-z0-9_-]+)')
+
+# 現場名として使える字（scripts/sites.sh の is_valid_site_name と同じ）。
+#   ★受け皿の名前はこの字だけ＝パスの区切りや `..` が名前に入らない（置き場の外へ出さない）。
+SITE_NAME_OK = re.compile(r'^[A-Za-z0-9_-]+$')
+
+# 配り役が書く現場の登録簿（現場名 ↔ 作業フォルダ）。★relay.ts の CODEX_SITES_REGISTRY と同じ名前。
+SITES_REGISTRY = 'sites.json'
+
+# 現場を1つに決められなかった知らせの控え。
+#   ★`.skipped.jsonl` で終わる名前にする＝配り役は受け皿として読まない・始末の対象にもしない。
+UNRESOLVED_FILE = '_unresolved.skipped.jsonl'
+
+# 控えに残す行数の上限（古い物から落とす＝受け皿の隣で際限なく育たせない）。
+#   ★relay.ts の CODEX_SKIPPED_NOTICE_MAX_LINES と同じ値にそろえる。
+UNRESOLVED_MAX_LINES = 200
+
 
 def notify_dir(env=None):
     env = os.environ if env is None else env
@@ -68,10 +109,115 @@ def notify_dir(env=None):
 
 
 def site_of(cwd):
-    """現場名＝作業フォルダの名前（relay の現場名と同じ決め方）。"""
+    """作業フォルダの名前（★これ単体では現場名にならない。resolve_site の最後の手段）。"""
     return os.path.basename(str(cwd or '').rstrip('/')) or ''
 
 
+def site_from_instruction(payload):
+    """配達文に書かれた現場名（`DONE:<現場>` の【最後】の出現）。無ければ ''。
+
+    配り役は便の本文のうしろへ完了の合図を必ず足すので、本文が別の現場名を引用していても
+    最後の出現が配り役の現場名になる（relay.ts の buildSendText の組み立て順）。
+    """
+    msgs = payload.get('input-messages')
+    if not isinstance(msgs, list):
+        return ''
+    found = ''
+    for m in msgs:
+        if not isinstance(m, str):
+            continue
+        for hit in SITE_STAMP.finditer(m):
+            found = hit.group(1)
+    return found
+
+
+def site_from_registry(cwd, env=None):
+    """配り役の登録簿から、cwd を含む作業フォルダの現場名を引く。引けなければ ''。
+
+    ★いちばん長く一致する作業フォルダの現場を選ぶ（入れ子の現場でも取り違えない）。
+    """
+    target = str(cwd or '').strip()
+    if not target:
+        return ''
+    target = os.path.normpath(target)
+    base = notify_dir(env)
+    if not base:
+        return ''
+    try:
+        with open(os.path.join(base, SITES_REGISTRY), encoding='utf-8') as f:
+            data = json.load(f)
+    except Exception:  # noqa: BLE001
+        return ''
+    entries = data.get('sites') if isinstance(data, dict) else None
+    if not isinstance(entries, list):
+        return ''
+    best_site, best_len = '', -1
+    for e in entries:
+        if not isinstance(e, dict):
+            continue
+        name = str(e.get('site') or '').strip()
+        work = str(e.get('workDir') or '').strip()
+        if not SITE_NAME_OK.match(name) or not work:
+            continue
+        work = os.path.normpath(work)
+        if target == work or target.startswith(work.rstrip(os.sep) + os.sep):
+            if len(work) > best_len:
+                best_site, best_len = name, len(work)
+    return best_site
+
+
+def git_top_name(cwd, env=None):
+    """git の頂上フォルダの名前（配り役の detectSite と同じ決め方）。無ければ ''。
+
+    ★git は起動しない（受け口は Codex の終わりに毎回走るので、速く・絶対に転ばないこと）。
+      `.git` が在るいちばん近い先祖をたどるだけ。worktree（`.git` がファイル）も同じに見つかる。
+    ★cwd がホームの下に在るときは、ホームより上へは出ない。現場の作業フォルダは必ずホームの下に在る
+      （sites.sh: `$HOME/projects/<現場>` か `$HOME/<現場>`）ので、ホームより上に置かれた `.git`
+      （例 `/tmp/.git`）を現場名として拾ってしまわないため。
+    """
+    env = os.environ if env is None else env
+    cur = str(cwd or '').strip()
+    if not cur or not os.path.isabs(cur):
+        return ''
+    cur = os.path.normpath(cur)
+    home = (env.get('HOME') or '').strip()
+    home = os.path.normpath(home) if home else ''
+    stop_at_home = bool(home) and (cur == home or cur.startswith(home.rstrip(os.sep) + os.sep))
+    while True:
+        if os.path.exists(os.path.join(cur, '.git')):
+            return os.path.basename(cur)
+        if stop_at_home and cur == home:
+            return ''
+        parent = os.path.dirname(cur)
+        if parent == cur:
+            return ''
+        cur = parent
+
+
+def resolve_site(payload, env=None):
+    """受け皿の名前（＝配り役が読む現場名）を決める。返り: (現場名, 決め方／決められない理由)。
+
+    決められなければ ('', 理由)。★呼ぶ側はその知らせを捨てず、控えへ残す。
+    """
+    stamped = site_from_instruction(payload)
+    if stamped and SITE_NAME_OK.match(stamped):
+        return stamped, 'job-stamp'
+    cwd = str(payload.get('cwd') or '')
+    from_reg = site_from_registry(cwd, env)
+    if from_reg:
+        return from_reg, 'site-registry'
+    top = git_top_name(cwd, env)
+    if top and SITE_NAME_OK.match(top):
+        return top, 'git-toplevel'
+    base = site_of(cwd)
+    if base and SITE_NAME_OK.match(base):
+        return base, 'cwd-basename'
+    return '', (
+        '現場を1つに決められない（配達文の DONE: も登録簿も git の頂上も無く、'
+        f'作業フォルダの名前も現場名に使えない: cwd={cwd!r}）'
+    )
+
+
 def is_internal_turn(payload):
     """Codex 内部のターン（題名を付ける・会話をまとめ直す）なら True（＝人の指示の完了ではない）。"""
     msgs = payload.get('input-messages')
@@ -107,19 +253,76 @@ def job_id_of(payload):
     return found
 
 
-def decide(payload):
-    """受け取った通知をどう扱うか。返り: (残すか, 現場名, 報告本文, 理由)"""
+def decide(payload, env=None):
+    """受け取った通知をどう扱うか。返り: (残すか, 現場名, 報告本文, 理由)
+
+    ★現場名が決まらなかったときは (False, '', 報告本文, 理由) を返す。呼ぶ側は【捨てずに】
+      控えへ残す（理由が 'unresolved-site:' で始まる物がそれ）。
+    """
     if not isinstance(payload, dict):
         return False, '', '', 'not-json-object'
     if payload.get('type') != 'agent-turn-complete':
         return False, '', '', 'other-type'
     if is_internal_turn(payload):
         return False, '', '', 'internal-turn'
-    site = site_of(payload.get('cwd'))
-    if not site:
-        return False, '', '', 'no-site'
     report = payload.get('last-assistant-message')
-    return True, site, report if isinstance(report, str) else '', ''
+    report = report if isinstance(report, str) else ''
+    site, how = resolve_site(payload, env)
+    if not site:
+        return False, '', report, f'unresolved-site:{how}'
+    return True, site, report, how
+
+
+def notice_line(payload, site, report):
+    """受け皿へ書く1行。"""
+    return json.dumps(
+        {
+            'site': site,
+            'report': report,
+            'threadId': payload.get('thread-id'),
+            'turnId': payload.get('turn-id'),
+            # ★どの便のターンの知らせかを配り役が確かめられるようにする（便 99fc49c0）。
+            'jobId': job_id_of(payload),
+            'at': datetime.datetime.now(datetime.timezone.utc).isoformat(),
+        },
+        ensure_ascii=False,
+    )
+
+
+def keep_unresolved(payload, report, why, env=None):
+    """現場を決められなかった知らせを、理由つきで控えへ残す（★捨てない）。
+
+    返り: 書けた控えのパス／''。古い行から落として UNRESOLVED_MAX_LINES 行までに収める。
+    """
+    target_dir = notify_dir(env)
+    if not target_dir:
+        return ''
+    file = os.path.join(target_dir, UNRESOLVED_FILE)
+    line = json.dumps(
+        {
+            'skippedAt': datetime.datetime.now(datetime.timezone.utc).isoformat(),
+            'why': why,
+            'site': None,
+            'cwd': payload.get('cwd'),
+            'jobId': job_id_of(payload),
+            'threadId': payload.get('thread-id'),
+            'turnId': payload.get('turn-id'),
+            'report': report,
+        },
+        ensure_ascii=False,
+    )
+    try:
+        os.makedirs(target_dir, exist_ok=True)
+        kept = []
+        if os.path.exists(file):
+            with open(file, encoding='utf-8') as f:
+                kept = [l for l in f.read().split('\n') if l.strip()]
+        lines = (kept + [line])[-UNRESOLVED_MAX_LINES:]
+        with open(file, 'w', encoding='utf-8') as f:
+            f.write('\n'.join(lines) + '\n')
+        return file
+    except Exception:  # noqa: BLE001
+        return ''
 
 
 def main(argv):
@@ -130,28 +333,19 @@ def main(argv):
         payload = json.loads(raw)
     except Exception:  # noqa: BLE001
         return 0  # 読めない通知は黙って捨てる（Codex を止めない）
-    keep, site, report, _reason = decide(payload)
+    keep, site, report, reason = decide(payload)
     if not keep:
+        # ★現場を決められなかった知らせだけは、捨てずに控えへ残す（便 684ac785）。
+        if reason.startswith('unresolved-site:'):
+            keep_unresolved(payload, report, reason[len('unresolved-site:'):])
         return 0
     target_dir = notify_dir()
     if not target_dir:
         return 0
     try:
         os.makedirs(target_dir, exist_ok=True)
-        line = json.dumps(
-            {
-                'site': site,
-                'report': report,
-                'threadId': payload.get('thread-id'),
-                'turnId': payload.get('turn-id'),
-                # ★どの便のターンの知らせかを配り役が確かめられるようにする（便 99fc49c0）。
-                'jobId': job_id_of(payload),
-                'at': datetime.datetime.now(datetime.timezone.utc).isoformat(),
-            },
-            ensure_ascii=False,
-        )
         with open(os.path.join(target_dir, f'{site}.jsonl'), 'a', encoding='utf-8') as f:
-            f.write(line + '\n')
+            f.write(notice_line(payload, site, report) + '\n')
     except Exception:  # noqa: BLE001
         return 0
     return 0

package/scripts/hooks/finish_gate.py

@@ -37,6 +37,8 @@
   ・人が答えるべき問いかけで終わった … 人の判断が先（ADR-024 §3 の取りこぼしを作らない）
   ・便の本文に「合流は人が行う」と書いてある … (1) を見ない（ADR-007）
   ・PR を作っていない便・読むだけの便 … (1) は当たらない（開いた PR が無いので何も起きない）
+  ・★本番操作の承認待ちで「待ち」のまま閉じた手番 … 便が終わる手番ではないので (1)(2) を見ない
+    （便 f20dd761・closed_as_prod_op_wait）。(3) は今までどおり見る＝背景の待ちは殺されるため。
 """
 import json
 import os
@@ -357,6 +359,55 @@ def background_residue(task_ids):
             + '・'.join(task_ids[:5]) + '）')
 
 
+# ─────────────────────────────────────────────────────────────────────────────
+# ★本番操作の承認待ちで「待ち」のまま閉じた手番（便 f20dd761・管制 PR #425）
+#
+# 【なぜ要るか】本番操作の承認が長引いたとき、職人は `conductor_complete` を
+#   `waitForProdOp:true` で呼び、便を完了にせず「本番操作の承認待ち」のまま閉じて手番を終える。
+#   この手番は【便が終わる手番ではない】ので、関門が「終え方を満たしていない」として
+#   差し戻してはいけない。差し戻すと、承認を待つために閉じたい手番が閉じられず、
+#   上限まで止めたあと「途中で終わった」の控えだけが残る（実際には何も途中ではない）。
+#
+# 【何を見ないことにするか】
+#   ・report（報告が無い・下書き） … 便はまだ終わっていない＝最終版の報告を求める場面ではない。
+#   ・pr（PR が開いたまま）        … 承認待ちの本番操作が PR の中身そのものであることがある。
+# 【★background は今までどおり見る】手番を閉じれば背景の待ちは殺される。これは待ちで閉じても
+#   同じなので、ここだけは差し戻す（起きたときに同じ所からやり直せる）。
+#
+# 【どう見分けるか＝実物だけ】会話の記録に残る道具の返りを見る。管制は待ちで閉じたとき
+#   `waitClosed: true` と `doneLineForbidden: true` を返す（便IDも同じ返りに入る）。
+#   ★3つが【同じ1行（＝同じ記録）】にそろったときだけ「待ちで閉じた」と読む
+#     ＝報告の文章の中でこの機能を説明しても、取り違えない（便 99fc49c0 と同じ作法で便IDに縛る）。
+# ─────────────────────────────────────────────────────────────────────────────
+#: 管制が「待ちのまま閉じた」と返す印（★字面は ai-kana の conductor_complete の返りと同じ）。
+#: ★会話の記録では、道具の返りが「JSON の中の文字列」として入ることがあり、そのときは
+#:   引用符が `\"` に escape されている。どちらの形でも読めるようにする（実物2通り）。
+_WAIT_CLOSED_RE = re.compile(r'waitClosed[\\"\s]*:[\\"\s]*true')
+#: 「この手番では DONE: を出さないでください」の機械で読む印。
+_DONE_FORBIDDEN_RE = re.compile(r'doneLineForbidden[\\"\s]*:[\\"\s]*true')
+
+
+def closed_as_prod_op_wait(transcript_path, command_id):
+    """この手番が「本番操作の承認待ちで閉じた」ものか（読めなければ False＝今までどおり見る）。"""
+    if not transcript_path or not os.path.isfile(transcript_path) or not command_id:
+        return False
+    needle = str(command_id)
+    try:
+        with open(transcript_path, encoding='utf-8', errors='replace') as f:
+            for line in f:
+                if needle not in line:
+                    continue
+                if _WAIT_CLOSED_RE.search(line) and _DONE_FORBIDDEN_RE.search(line):
+                    return True
+    except Exception:  # noqa: BLE001
+        return False
+    return False
+
+
+#: 待ちで閉じた手番では見ない残りの種類（★background はここに入れない）。
+WAIT_CLOSED_SKIP_KINDS = ('report', 'pr')
+
+
 # ─────────────────────────────────────────────────────────────────────────────
 # (1) PR が開いたまま・合流の予約中のまま
 # ─────────────────────────────────────────────────────────────────────────────

package/scripts/hooks/stop_hook.py

@@ -269,16 +269,23 @@ def collect_residues(data, command_id, env=None):
     work_dir = (env.get('CONDUCTOR_WORK_DIR') or '').strip() or (data.get('cwd') or '')
     residues = {}
 
+    # ★本番操作の承認待ちで「待ち」のまま閉じた手番か（便 f20dd761）。
+    #   便が終わる手番ではないので、報告と PR は見ない（背景の待ちだけは今までどおり見る）。
+    wait_closed = finish_gate.closed_as_prod_op_wait(
+        data.get('transcript_path'), command_id)
+
     # (2) 報告 … 置き場の実物を見る。
-    residues['report'] = finish_gate.report_residue(
-        finish_gate.read_report_text(command_id, env))
+    if not wait_closed:
+        residues['report'] = finish_gate.report_residue(
+            finish_gate.read_report_text(command_id, env))
 
     # (3) 背景に回した待ち … 会話の記録の実物を見る。
+    #     ★待ちで閉じた手番でも見る（手番を閉じれば背景の待ちは殺される＝同じ事故が起きる）。
     residues['background'] = finish_gate.background_residue(
         finish_gate.outstanding_background_tasks(data.get('transcript_path')))
 
     # (1) PR … 便の本文が「合流は人が行う／合流しない」と言っていれば見ない（ADR-007）。
-    if not finish_gate.human_merge_requested(load_job_body(site, env)) and work_dir:
+    if not wait_closed and not finish_gate.human_merge_requested(load_job_body(site, env)) and work_dir:
         residues['pr'] = finish_gate.open_pr_residue(
             finish_gate.read_open_prs(work_dir, finish_gate.current_branch(work_dir)))
     return {k: v for k, v in residues.items() if v}

package/scripts/hooks/test_gate_prod_op_wait.py

@@ -0,0 +1,208 @@
+#!/usr/bin/env python3
+"""便の終わりの関門は「本番操作の承認待ちで閉じた手番」を差し戻さない（便 f20dd761）。
+
+  実行: python3 scripts/hooks/test_gate_prod_op_wait.py
+  1件でも期待と違えば exit 1。
+
+【なぜ要るか】
+  管制（ai-kana PR #425）は、本番操作の承認が長引いた便を `conductor_complete` の
+  `waitForProdOp:true` で【完了にせず】「本番操作の承認待ち」のまま閉じられるようにした。
+  その手番は【便が終わる手番ではない】。ところが関門は、報告が最終版でないこと・PR が
+  開いたままであることを「終え方を満たしていない」として差し戻す。
+  ＝承認を待つために閉じたい手番が閉じられず、上限まで止めたあとで「途中で終わった」の
+  控えだけが残る（実際には何も途中ではない）。
+
+【ここで固定すること】
+  (A) 待ちで閉じた印の読み方 … 便ID・waitClosed・doneLineForbidden が【同じ1行】に
+      そろったときだけ「待ちで閉じた」と読む（★よその便の印・説明の文では読まない）
+  (B) 待ちで閉じた手番は、報告が無い／下書き／PR が開いたままでも差し戻さない
+  (C) ★背景に回した待ちは、待ちで閉じた手番でも今までどおり差し戻す
+      （手番を閉じれば背景の待ちは殺される＝同じ事故が起きる）
+  (D) ★空振り確認：印が無い（今までの便の）手番は、今までどおり差し戻す
+
+★空振り確認（この試験の中だけ）:
+  ・印の行を外す → (B) が落ちる（＝(B) は印が効いていることを見ている）
+  ・closed_as_prod_op_wait を常に False にする → (B) が落ちる
+  ・WAIT_CLOSED_SKIP_KINDS に 'background' を足す → (C) が落ちる
+"""
+import json
+import os
+import sys
+import tempfile
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+import finish_gate  # noqa: E402
+import stop_hook  # noqa: E402
+
+failures = []
+
+
+def check(label, got, want):
+    ok = got == want
+    if not ok:
+        failures.append(f'{label}: got={got!r} want={want!r}')
+    print(f'{"OK " if ok else "NG "} {label:66} {str(got)[:46]}')
+
+
+def truthy(label, got):
+    ok = bool(got)
+    if not ok:
+        failures.append(f'{label}: got={got!r} want=真')
+    print(f'{"OK " if ok else "NG "} {label:66} {str(got)[:46]}')
+
+
+SANDBOX = tempfile.mkdtemp(prefix='gate-prod-op-wait-')
+ENV = {'HOME': SANDBOX, 'XDG_STATE_HOME': os.path.join(SANDBOX, 'state'),
+       'CONDUCTOR_RUNNER_MODE': 'headless', 'CONDUCTOR_SITE': 'demo'}
+JOB = 'f20dd761-a8e9-4696-aefe-b639b0834bc2'
+OTHER = '97f99a17-4941-4479-8e56-f1e735cb0b90'
+
+JOB_LINE = f'{{"text":"CONDUCTOR_JOB:{JOB}"}}'
+#: 背景の仕事が始まった印（★test_finish_gate.py と同じ、会話の記録に残る実物の形）。
+START = '{"toolUseResult":{"stdout":"","backgroundTaskId":"%s"}}'
+
+#: 管制が待ちで閉じたときに返す1行（★実物と同じ字面＝ai-kana の conductor_complete の返り）。
+#:  形① 道具の返りが「JSON の中の文字列」として入る（引用符が \" に escape される）。
+WAIT_REPLY = (
+    '{"type":"tool_result","content":"{\\"ok\\":true,\\"commandId\\":\\"%s\\",'
+    '\\"completed\\":false,\\"waitClosed\\":true,\\"status\\":\\"perm_wait\\",'
+    '\\"waitLabel\\":\\"本番操作の承認待ち\\",\\"doneLineForbidden\\":true}"}'
+)
+#:  形② 道具の返りが素の JSON として入る（escape なし）。
+WAIT_REPLY_PLAIN = (
+    '{"toolUseResult":{"ok":true,"commandId":"%s","completed":false,'
+    '"waitClosed":true,"status":"perm_wait","doneLineForbidden":true}}'
+)
+
+
+def transcript(lines, name):
+    p = os.path.join(SANDBOX, name)
+    with open(p, 'w', encoding='utf-8') as f:
+        f.write('\n'.join(lines) + '\n')
+    return p
+
+
+def put_job_body(body, site='demo'):
+    d = os.path.join(ENV['XDG_STATE_HOME'], 'conductor')
+    os.makedirs(d, exist_ok=True)
+    with open(os.path.join(d, f'active-job-{site}.json'), 'w', encoding='utf-8') as f:
+        json.dump({'commandId': JOB, 'body': body, 'site': site}, f)
+
+
+def drop_report(command_id=JOB):
+    for f in finish_gate.report_files(command_id, ENV):
+        if os.path.isfile(f):
+            os.remove(f)
+
+
+def put_report(text, command_id=JOB):
+    d = os.path.join(ENV['XDG_STATE_HOME'], 'conductor', 'reports')
+    os.makedirs(d, exist_ok=True)
+    with open(os.path.join(d, f'{command_id}.md'), 'w', encoding='utf-8') as f:
+        f.write(text)
+
+
+def clear_counts(command_id=JOB):
+    for p in (finish_gate.counts_path(command_id, ENV), finish_gate.residue_path(command_id, ENV)):
+        if os.path.isfile(p):
+            os.remove(p)
+
+
+def block(t):
+    return stop_hook.finish_gate_block({'transcript_path': t, 'cwd': SANDBOX}, ENV)
+
+
+put_job_body('本番操作の承認を待って、待ちのまま閉じてください')
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('=== (A) 待ちで閉じた印の読み方（★便IDに縛る） ===')
+# ─────────────────────────────────────────────────────────────────────────────
+t_ok = transcript([JOB_LINE, WAIT_REPLY % JOB], 'a-ok.jsonl')
+check('便ID＋waitClosed＋doneLineForbidden が同じ1行 → 待ちで閉じた',
+      finish_gate.closed_as_prod_op_wait(t_ok, JOB), True)
+
+t_plainjson = transcript([JOB_LINE, WAIT_REPLY_PLAIN % JOB], 'a-plain.jsonl')
+check('★escape されていない形（素の JSON）でも読める',
+      finish_gate.closed_as_prod_op_wait(t_plainjson, JOB), True)
+
+t_other = transcript([JOB_LINE, WAIT_REPLY % OTHER], 'a-other.jsonl')
+check('★よその便の印では読まない',
+      finish_gate.closed_as_prod_op_wait(t_other, JOB), False)
+
+t_split = transcript([JOB_LINE,
+                      '{"text":"この便は \\"waitClosed\\": true で閉じました"}',
+                      f'{{"text":"{JOB} の話"}}'], 'a-split.jsonl')
+check('★印が別の行に散っている（説明の文）→ 読まない',
+      finish_gate.closed_as_prod_op_wait(t_split, JOB), False)
+
+t_half = transcript([JOB_LINE,
+                     '{"type":"tool_result","content":"{\\"commandId\\":\\"%s\\",'
+                     '\\"waitClosed\\":true}"}' % JOB], 'a-half.jsonl')
+check('★片方の印だけ（doneLineForbidden が無い）→ 読まない',
+      finish_gate.closed_as_prod_op_wait(t_half, JOB), False)
+
+check('会話の記録が無い → 読まない（今までどおり見る側へ倒す）',
+      finish_gate.closed_as_prod_op_wait(os.path.join(SANDBOX, 'nope.jsonl'), JOB), False)
+check('便IDが分からない → 読まない',
+      finish_gate.closed_as_prod_op_wait(t_ok, ''), False)
+check('見ない残りは報告と PR の2つだけ（背景は入れない）',
+      sorted(finish_gate.WAIT_CLOSED_SKIP_KINDS), ['pr', 'report'])
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (B) 待ちで閉じた手番は差し戻さない ===')
+# ─────────────────────────────────────────────────────────────────────────────
+clear_counts()
+drop_report()
+check('報告が1つも無くても止めない', block(t_ok), None)
+
+clear_counts()
+put_report('---\ninstruction_id: x\n---\n\n報告（作成中）この見出しは最終版で差し替える')
+check('報告が下書きのままでも止めない', block(t_ok), None)
+
+clear_counts()
+put_report('やりました。')   # 囲みが無い＝形が整っていない
+check('報告の形が整っていなくても止めない', block(t_ok), None)
+
+clear_counts()
+check('★残りを集める段で、報告と PR が1つも入っていない',
+      sorted(stop_hook.collect_residues({'transcript_path': t_ok, 'cwd': SANDBOX}, JOB, ENV)),
+      [])
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (C) ★背景に回した待ちは、待ちで閉じた手番でも差し戻す ===')
+# ─────────────────────────────────────────────────────────────────────────────
+clear_counts()
+drop_report()
+t_bg = transcript([JOB_LINE, WAIT_REPLY % JOB, START % 'b32iul78k'], 'c-bg.jsonl')
+msg = block(t_bg)
+truthy('背景の待ちが残っていれば止める', msg)
+truthy('  背景の待ちだと言う', '背景' in (msg or ''))
+check('★止める理由は背景だけ（報告・PR は混ざらない）',
+      sorted(stop_hook.collect_residues({'transcript_path': t_bg, 'cwd': SANDBOX}, JOB, ENV)),
+      ['background'])
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (D) ★空振り確認：印が無い手番は今までどおり差し戻す ===')
+# ─────────────────────────────────────────────────────────────────────────────
+clear_counts()
+drop_report()
+t_plain = transcript([JOB_LINE], 'd-plain.jsonl')
+truthy('印が無い＋報告が無い → 止める（関門は効いたまま）', block(t_plain))
+
+clear_counts()
+put_report('---\ninstruction_id: x\n---\n\n報告（作成中）差し替える')
+truthy('印が無い＋下書き → 止める', block(t_plain))
+
+clear_counts()
+drop_report()
+truthy('★印の行を外すと (B) の形でも止まる＝(B) は印が効いていることを見ている',
+       block(transcript([JOB_LINE], 'd-noflag.jsonl')))
+
+print('\n' + '=' * 72)
+if failures:
+    print(f'NG {len(failures)} 件')
+    for f in failures:
+        print('  - ' + f)
+    sys.exit(1)
+print('OK すべて期待どおり')

package/skills/conductor-craftsman/SKILL.md

@@ -201,5 +201,12 @@ description: 采配くんの便（プロンプト末尾に CONDUCTOR_JOB:<id>
    - 可能なら次も一緒に渡す（すべて任意・分かる範囲でよく、渡さなくても完了する）：`branch=`作った作業ブランチ名（`git rev-parse --abbrev-ref HEAD`）、`baseBranch=`分岐元（通常 main）、`headSha=`最後のコミット（短縮可）、`pushed=`push したか（true/false）、`filesChanged=`変更したファイル数、`prTitle=`お客さま（非エンジニア）がそのまま読む題名（rebase/squash/lint 等の専門用語を避け、やさしい日本語で）、`prNumber=`既に PR がある場合のみ、`outcome=`pushed（変更して push した）／no_change（変更不要だった）／blocked（衝突・要判断・許可待ち等で完了できなかった）のどれか。
    - **blocked のときも必ず conductor_complete を呼び、report に理由を書く。**
    - ブランチを切らない**読み取り専用の作業では outcome=no_change** を渡す（branch は省略可）。
+⑤ **★本番操作の承認を待って「待ち」のまま閉じる手番だけは、`DONE:` の行を出さない**（えふさん確定 2026-10-04 の 3・便 97f99a17）。
+   - **どんな手番か** … 本番操作（本番の反映など）の承認が長引き、便をいったん「待ち」にして手番を閉じるとき。④を `waitForProdOp:true`（分かれば `prodOpRequestId` も）で呼ぶ。便は `done` にならず**本番操作の承認待ち**のまま閉じ、返事に `waitClosed: true` と `doneLineForbidden: true` が返る。
+   - **この手番ですること** … ①②のとおり**報告ファイルは置いてよい**（報告ファイルだけでは便は完了にならない）。④は `waitForProdOp:true` で呼ぶ。★**③の `DONE:<現場>` の行は出さない。**
+   - **なぜ出さないか** … `DONE:` を出すと配り役の完了検出がこの便を完了（終端）にしてしまい、本番操作が済んでも**続きから起こせなくなる**（「終端は起こさない」は正しい決まりなので緩めない）。
+   - **そのあと** … 本番操作が済むと、管制の**合図で同じ便の続きから起きる**。続きを行い、**本当に終わったときに ⓪〜④ のとおり（`DONE:<現場>` も出して）終える**。★却下・失敗・時間切れでは起きない（理由つきで人の手番で止まる）。
+   - ★**待ちで閉じていない便の終え方は1つも変わらない。** `waitForProdOp` を渡さない呼び出しは今までどおり（③の `DONE:<現場>` も出す）。
+   - ★**便の終わりの関門は、待ちで閉じた手番を「報告が無い」「PR が開いたまま」では差し戻さない**（背景に回した待ちが残っていれば、今までどおり差し戻す＝手番を閉じると殺されるのは待ちで閉じても同じ）。
 
 **作業中の確認の一言説明** — 作業中にユーザー確認（許可を求めるプロンプト）が出る操作では、その一言説明（description）を英語ではなく日本語で、「プルリクエストを作成する」「テストを実行する」のように「何をするか」が一目で分かる簡潔な形（〜を作成する／実行する／削除する 等）で書く。この説明は管制の確認カードにそのまま表示され、非エンジニアのお客さまが読んで許可を判断する。