@tyhld/conductor 0.12.50 → 0.12.52

package/dist/relay.js

@@ -925,8 +925,14 @@ export function isTerminalCommandStatus(status) {
  * cancelled/canceled/abandoned のみを見るので、再配達の可否ではこの2つを足して判断する。
  *   - dismissed: ②画面で人が却下（devlog-tracker: commands/[id]/dismiss/route.ts が status='dismissed'）
  *   - timeout  : 中央 sweep が doneAt を打って終端化（devlog-tracker: lib/conductor.ts の sweep）
+ *   - instruction_missing : 本文未着（便 7d810bbb）。管制が占有を外した＝配り役は追わない
  */
-const CENTRAL_EXTRA_TERMINAL_STATUSES = new Set(['dismissed', 'timeout']);
+const CENTRAL_EXTRA_TERMINAL_STATUSES = new Set(['dismissed', 'timeout', 'instruction_missing']);
+/**
+ * 管制の「本文未着」（★便 7d810bbb・中央 ai-kana 214c474e）。職人は仕事を受け取っていない。
+ *   管制は現場の占有を外し、人の判断（配り直す／中身を見る）を待つ。★配り役はこの便を追わない・配り直さない。
+ */
+export const INSTRUCTION_MISSING_STATUS = 'instruction_missing';
 /**
  * 中央がこの指示を「もう終わっている」と言っているか（純粋関数）。
  *   done / failed / cancelled / canceled / abandoned / dismissed / timeout のいずれか。
@@ -1395,11 +1401,31 @@ export function pendingReportIds(env, limit = PENDING_REPORTS_MAX) {
 //   ・★配達役は完了にしない・便の状態の値を書かない（中央も完了にしない＝止まった便を「回収必要」まで進めるだけ）。
 //   ・★配達役がいま追っている便の報告は送らない。それは完了の道（completeWithReport）が読んで完了と一緒に
 //     渡す。先に processed/ へ移すと、completeWithReport が「渡し済み」とみなして完了を書かなくなる。
+//     ★例外は「作業なし・本文未着」の報告だけ（isInstructionMissingReport・便 7d810bbb）。この報告は
+//     完了にしない物なので、完了の道が書かなくなってもよい（むしろ完了にしてはいけない）。
 // ───────────────────────────────────────────────────────────────────────────
 /** 1回に送る報告ファイルの件数の上限（★中央の FILE_INTAKE_LIMIT と同じ値にすること）。 */
 export const REPORT_FILES_BATCH = 20;
 /** 1周で送る件数の上限（多すぎる分は次の周に回す＝落とさない）。 */
 export const REPORT_FILES_MAX_PER_ROUND = 100;
+/**
+ * 報告ファイルが「作業なし・本文未着」を示しているか（★便 7d810bbb）。純粋関数。
+ *
+ * 【なぜ要るか（実障害 af960f79）】本文を受け取れなかった職人が「本文未着・作業なし」の報告を置いたが、
+ *   その便は配り役が追跡中だったので送られず（下の決まり）、30分の時間切れまで管制に届かなかった。
+ * 【★ここで決めるのは「追跡中でも送ってよいか」だけ】完了にはしない・便の状態の値も書かない。
+ *   管制は中身の言葉ではなく便の状態で扱う（中央 214c474e：未着の便は完了にも PASS にもしない）。
+ * 【判定】両方がそろったときだけ true（片方だけでは送らない＝通常の完了報告を巻き込まない）:
+ *   ① 作業なし … `outcome: no_change`（囲みが閉じていない古い形でも行として読む）
+ *   ② 本文未着 … 「本文未着」または `instruction_missing` と書かれている
+ */
+export function isInstructionMissingReport(raw) {
+    const text = String(raw ?? '');
+    const parsed = parseReport(text);
+    const noWork = parsed.outcome === 'no_change' || /^[ \t]*outcome[ \t]*:[ \t]*no_change[ \t]*$/im.test(text);
+    const missing = /本文未着|instruction_missing/i.test(text);
+    return noWork && missing;
+}
 /**
  * 未処理の報告ファイルの全文を中央へ送り、受け取られた物だけ処理済みにする。
  * 返り: 送った件数・処理済みにした件数・未処理のまま残した件数。
@@ -1411,11 +1437,13 @@ export async function sendPendingReportFiles(cfg, opts = {}) {
     const exclude = new Set(opts.exclude ?? []);
     const items = [];
     for (const id of pendingReportIds(env, REPORT_FILES_MAX_PER_ROUND).ids) {
-        if (exclude.has(id))
-            continue;
         for (const file of pendingCandidates(id, env)) {
             const raw = readIfFilled(file);
             if (raw !== null) {
+                // ★追跡中の便の報告は送らない（今までどおり）。ただし「作業なし・本文未着」だけは送る
+                //   （便 7d810bbb）。完了の道はその便を完了にしないので、ここで送らないと管制に届かない。
+                if (exclude.has(id) && !isInstructionMissingReport(raw))
+                    break;
                 items.push({ id, raw });
                 break;
             }
@@ -1785,6 +1813,144 @@ export function hasSubmittedRecord(cwd, commandId, sinceMs, env = process.env) {
     }
     return false;
 }
+// ───────────────────────────────────────────────────────────────────────────
+// 受領確認（配達開始 → 受領確認 → 実行開始・★えふさん確定 2026-09-23・便 7d810bbb）
+//
+// 【なぜ要るか（実障害 2026-09-23・便 af960f79／minoru）】
+//   会話を新しくした直後に本文の貼り付けが落ち、添え書きだけが送信された。職人は便の印も本文も
+//   受け取っていないのに、配り役は「送れた＝配達した」として中央を【実行中(sent)】にしていたので、
+//   30分の時間切れまで誰も気づけなかった。中央は 214c474e で「配達中(delivering) → 受領確認 →
+//   実行中(sent)」と「本文未着(instruction_missing)」の道を用意した。配り役はここでその知らせを送る。
+//
+// 【★ACK の条件（えふさん確定・1文字も変えない）】
+//   ACKは「画面に何か出た」ではなく instruction_id 一致を必須にする。
+//   職人画面に `CONDUCTOR_JOB:<instruction_id>` 相当の便印が実際に現れ、送ったinstruction_idと
+//   完全一致したことを確認して初めてACK。
+//
+// 【★「相当の便印」に会話の記録を使う理由】
+//   ・画面の入力欄に印が見えていても、まだ送信されていないことがある（b69c1608 の実物＝Enter が改行に
+//     取り込まれた）。それを受領と数えると、af960f79 と同じ「受け取っていないのに実行中」が起きる。
+//   ・職人（Claude Code）は全画面表示で、送信された発言の印は数秒で流れて消える（ADR-023）。
+//   ★職人が送信を受け付けた瞬間に、その発言が会話の記録へ書かれる。そこに【この便を貼った後の時刻で】
+//     【利用者の発言として】印が在り、【指示IDが完全一致】したときだけ受領とみなす。
+// ───────────────────────────────────────────────────────────────────────────
+/** 指示IDとして続きうる文字（これが印の直後に続いたら「別の便の印」＝一致とみなさない）。 */
+const JOB_ID_CHAR = /[0-9A-Za-z_-]/;
+/**
+ * 文字列の中に、この便の印（`CONDUCTOR_JOB:<id>`）が【完全一致】で在るか。純粋関数。
+ *   ・`CONDUCTOR_JOB:<id>` の直後に指示IDの文字が続く物（＝別の便の印・前方一致）は数えない。
+ *   ・別の便の印がいくつ在っても、この便の印が無ければ false。
+ */
+export function hasExactJobStamp(text, commandId) {
+    if (!commandId)
+        return false;
+    const needle = `${SEND_ANCHOR_PREFIX}:${commandId}`;
+    for (let at = text.indexOf(needle); at >= 0; at = text.indexOf(needle, at + 1)) {
+        const next = text.charAt(at + needle.length);
+        if (next === '' || !JOB_ID_CHAR.test(next))
+            return true;
+    }
+    return false;
+}
+/**
+ * この便を貼った後（sinceMs 以降）に、職人の会話の記録へ、この便の印が【利用者の発言として】
+ * 【完全一致で】書かれたか。★受領確認（ACK）の唯一の根拠。
+ *   ・時刻が sinceMs より前の記録（＝前の便・前に配った同じ便の残り）は数えない（猶予も取らない）。
+ *   ・時刻の無い記録は数えない（新しく出たと言えない）。
+ *   ・利用者の発言でない記録（職人の返答などに印が引用された物）は数えない。
+ * ★中身は照合するだけで、どこにも写さない・記録しない。
+ */
+export function hasJobStampSince(cwd, commandId, sinceMs, env = process.env) {
+    const dir = claudeTranscriptDir(cwd, env);
+    const needle = `${SEND_ANCHOR_PREFIX}:${commandId}`;
+    let names;
+    try {
+        names = readdirSync(dir).filter((n) => n.endsWith('.jsonl'));
+    }
+    catch {
+        return false;
+    }
+    for (const n of names) {
+        const file = path.join(dir, n);
+        try {
+            // 貼った後に書かれていないファイルは見ない（★ファイルの時刻は粗いことがあるので、ここだけ5秒の猶予。
+            //   新しく出たかの判定そのものは、下の行ごとの時刻で猶予なしに行う）。
+            if (statSync(file).mtimeMs < sinceMs - 5_000)
+                continue;
+            const text = readFileSync(file, 'utf8');
+            if (!text.includes(needle))
+                continue;
+            for (const line of text.split('\n')) {
+                if (!hasExactJobStamp(line, commandId))
+                    continue;
+                try {
+                    const o = JSON.parse(line);
+                    const at = o.timestamp ? Date.parse(o.timestamp) : NaN;
+                    if (o.type === 'user' && Number.isFinite(at) && at >= sinceMs)
+                        return true;
+                }
+                catch {
+                    // 壊れた行は飛ばす。
+                }
+            }
+        }
+        catch {
+            // 読めないファイルは飛ばす（受け取ったとは言えない）。
+        }
+    }
+    return false;
+}
+/** 印が現れなかったときに貼り直す上限（★えふさん確定「2回まで貼り直し」）。 */
+export const RELAY_ACK_MAX_REPASTE = 2;
+/**
+ * 印が現れるのを待ち、現れなければ貼り直す（★2回まで）。★自分では中央へ何も送らない。
+ *
+ *   1回ぶん … 受付の確かめ（confirmSubmitted）：印を待ち、入力欄に便が残っていれば Enter だけ押し直す。
+ *   現れない … 次のどれかなら【貼り直さない】（二重に入れない・割り込まない）:
+ *                ・入力欄にこちらの便が残っている（貼り直すと入力欄に2つ入る）
+ *                ・職人がアイドルでない（添え書きだけ受け取って返事をしている最中など）
+ *              どれでもなければ本文を貼り直す（上限 RELAY_ACK_MAX_REPASTE 回）。
+ * ★受領とみなすのは stampSeen（送った指示IDと完全一致・貼った後に新しく出た印）が true のときだけ。
+ */
+export async function awaitDeliveryAck(d, o = {
+    waitMs: RELAY_SUBMIT_CONFIRM_MS,
+    pollMs: 1_000,
+    maxResend: RELAY_SUBMIT_MAX_RESEND,
+    maxRepaste: RELAY_ACK_MAX_REPASTE,
+}) {
+    let repasted = 0;
+    let resent = 0;
+    let reason = '';
+    for (let round = 0;; round++) {
+        const r = await confirmSubmitted({ accepted: d.stampSeen, pendingInInput: d.pendingInInput, pressEnter: d.pressEnter, sleep: d.sleep }, o);
+        resent += r.resent;
+        if (r.result !== 'unconfirmed')
+            return { received: true, repasted, resent, reason: '' };
+        if (round >= o.maxRepaste) {
+            reason = reason || `貼り直し${repasted}回のあとも印が現れない`;
+            break;
+        }
+        if (d.pendingInInput()) {
+            reason = '入力欄に便が残ったまま送信されない（貼り直すと二重に入るので貼り直さない）';
+            break;
+        }
+        if (!(await d.idle())) {
+            reason = '職人がアイドルでないので貼り直さなかった';
+            continue; // この回は貼り直さずに、もう一度だけ印を待つ（回数は数える＝待ちは有限）
+        }
+        if (d.repaste()) {
+            repasted++;
+            reason = '';
+        }
+        else {
+            reason = '貼り直しに失敗';
+        }
+    }
+    // ★返す直前にもう一度だけ見る（最後の待ちの直後に印が出た場合を取りこぼさない）。
+    if (d.stampSeen())
+        return { received: true, repasted, resent, reason: '' };
+    return { received: false, repasted, resent, reason };
+}
 /**
  * 入力欄（画面のいちばん下の ❯ から次の罫線まで）に、配達役の添え書きが残っているか。
  * ★押し直してよいのは「こちらが入れた便が入力欄に残っている」ときだけ、を確かめるために使う。
@@ -2163,9 +2329,14 @@ export async function markSentAtCentral(cfg, state) {
         return false;
     if (pending.sentMarked)
         return true;
-    if (await patchStatus(cfg, pending.id, 'sent')) {
+    // ★Claude の職人へ配った便は「配達中(delivering)」を書く（便 7d810bbb）。実行中(sent)へ進めるのは
+    //   受領の知らせ（sendAckAtCentral）だけ。★それ以外（Codex・孤児の復元）は今までどおり sent。
+    const mark = pending.markAs ?? 'sent';
+    if (await patchStatus(cfg, pending.id, mark)) {
         pending.sentMarked = true;
-        log(`site=${cfg.site} id=${pending.id} 配達済み(sent)を管制へ記録`);
+        log(mark === 'delivering'
+            ? `site=${cfg.site} id=${pending.id} 配達中(delivering＝受領確認待ち)を管制へ記録`
+            : `site=${cfg.site} id=${pending.id} 配達済み(sent)を管制へ記録`);
         return true;
     }
     // 書けなかった。理由を中央に聞いて、やり直す意味があるかだけ判断する。
@@ -2178,7 +2349,7 @@ export async function markSentAtCentral(cfg, state) {
         state.lastHeartbeatAt = null;
         return false;
     }
-    if (centralStatus === 'sent') {
+    if (centralStatus === 'sent' || (mark === 'delivering' && centralStatus === 'delivering')) {
         // 既に印が付いている（別経路／409 の相手が自分自身だった等）。書き直す必要はない。
         pending.sentMarked = true;
         log(`site=${cfg.site} id=${pending.id} 中央は既に sent＝配達済みの記録は完了とみなす`);
@@ -2188,6 +2359,72 @@ export async function markSentAtCentral(cfg, state) {
         `(中央status=${centralStatus ?? '不明'})→次tickで再試行（★再配達はしない）`);
     return false;
 }
+/**
+ * 受領の知らせを管制へ送る（★便 7d810bbb・中央の受け口は ai-kana 214c474e）。
+ *   POST /api/conductor/commands/<id>/ack  body { site, received: true | false }
+ *   返り { ok, id, status, applied, reason }（applied:false＝管制は二重に動かさなかった）。
+ *
+ * 【送る条件】pending.ack が決まっていて、まだ送っておらず、★「配達中」の印を先に書けていること
+ *   （印より先に受領を送ると、管制は queued の便として受け流す＝知らせが消える）。
+ * 【★職人の作業を止めない】ここは管制へ知らせるだけ。職人の窓には1文字も触らない。
+ *   管制が応えない・遅い（上限 RELAY_FETCH_TIMEOUT_MS）・5xx のときは false を返し、次tickでやり直す。
+ * 【received:false を送れたら】その便の追跡をやめる（占有を外す）。★配り直しはしない
+ *   （配り直すのは人が管制で【配り直す】を押したとき＝そのとき管制が queued に戻す）。
+ *
+ * @returns 知らせを送り終えた（または送る物が無い）なら true。
+ */
+export async function sendAckAtCentral(cfg, state, logLine = log) {
+    const pending = state.pending;
+    if (pending === null || pending.ack === undefined)
+        return true;
+    if (pending.ackSent)
+        return true;
+    if (!pending.sentMarked)
+        return false; // 配達中の印が先。書けてから送る。
+    const received = pending.ack === 'received';
+    let done = false;
+    try {
+        const res = await fetch(`${cfg.url}/api/conductor/commands/${encodeURIComponent(pending.id)}/ack`, {
+            method: 'POST',
+            headers: { ...authHeaders(cfg), 'Content-Type': 'application/json' },
+            body: JSON.stringify({ site: cfg.site, received }),
+            // ★上限時間は必須（無応答の管制で輪が止まるのを防ぐ・RELAY_FETCH_TIMEOUT_MS 参照）。
+            signal: AbortSignal.timeout(RELAY_FETCH_TIMEOUT_MS),
+        });
+        const data = (await res.json().catch(() => null));
+        const why = String(data?.reason ?? data?.error ?? '').slice(0, 200);
+        if (res.ok) {
+            done = true;
+            logLine(`site=${cfg.site} id=${pending.id} 受領の知らせ(received:${received}) -> ` +
+                `status=${String(data?.status ?? '?')} applied=${String(data?.applied ?? '?')}${why ? `（${why}）` : ''}`);
+        }
+        else if (res.status >= 400 && res.status < 500 && res.status !== 408 && res.status !== 429) {
+            // 送り直しても変わらない断り（現場ちがい・知らない便・形の誤り）。★繰り返さない。
+            done = true;
+            logLine(`WARN site=${cfg.site} id=${pending.id} 受領の知らせ(received:${received}) -> HTTP ${res.status}` +
+                `（送り直さない）${why ? `: ${why}` : ''}`);
+        }
+        else {
+            logLine(`site=${cfg.site} id=${pending.id} 受領の知らせ(received:${received}) -> HTTP ${res.status}` +
+                '（次の周でやり直す・職人の作業は止めない）');
+        }
+    }
+    catch (err) {
+        logLine(`site=${cfg.site} id=${pending.id} 受領の知らせ(received:${received}) -> 失敗: ` +
+            `${err instanceof Error ? err.message : String(err)}（次の周でやり直す・職人の作業は止めない）`);
+    }
+    if (!done)
+        return false;
+    pending.ackSent = true;
+    if (!received) {
+        // ★本文未着：追跡をやめる（占有を外す）。★配り直さない＝abandoned にも入れない
+        //   （人が【配り直す】を押したら管制が queued に戻す。そのときは普通に配る）。
+        logLine(`site=${cfg.site} id=${pending.id} 本文未着として管制へ知らせた→追跡をやめる（配り直すのは人の手番）`);
+        state.pending = null;
+        state.lastHeartbeatAt = null;
+    }
+    return true;
+}
 /**
  * このtickで生存ハートビート(bare)を送るかを決める純粋関数（I/Oなし＝単体テスト可能）。
  *
@@ -2585,6 +2822,25 @@ export async function relayTick(cfg, state, hooks) {
                 if (state.pending === null)
                     return; // 中央が終端＝追跡を畳んだ。次tickで通常経路へ。
             }
+            // ── 受領の知らせ（★便 7d810bbb・送れるまで毎tick やり直す・職人の作業は止めない） ──
+            if (state.pending.ack === 'missing') {
+                // ★本文未着と決めた便。職人は仕事を受け取っていないので、完了検出も生存通知もしない。
+                //   知らせを送れたら sendAckAtCentral が追跡をやめる。★配り直さない。
+                await sendAckAtCentral(cfg, state);
+                if (state.pending !== null && Date.now() - state.pending.sentAt > RELAY_PENDING_TIMEOUT_MS) {
+                    // 管制へ知らせられないまま上限を過ぎた。★印も書けていなければ、管制は queued のまま返す
+                    //   ＝勝手に配り直さないよう、この常駐の中では二度と配らない（ADR-023 の穴止めと同じ）。
+                    if (!state.pending.sentMarked)
+                        state.abandoned.add(state.pending.id);
+                    log(`WARN site=${cfg.site} id=${state.pending.id} 本文未着の知らせを管制へ送れないまま上限→追跡をやめる（配り直しはしない）`);
+                    state.pending = null;
+                    state.lastHeartbeatAt = null;
+                }
+                return;
+            }
+            if (state.pending.ack === 'received' && !state.pending.ackSent) {
+                await sendAckAtCentral(cfg, state);
+            }
             // アンカー（今回送信の境界）より下だけを見て DONE:{site} 単独行を探す。
             // churn で古い DONE が押し出されても・過去ジョブの DONE が窓に残っても、誤検出/見逃しなし。
             // ★アンカーが既に流れて消えている場合は、一度アンカーを見ていれば画面全体を見る
@@ -2627,7 +2883,9 @@ export async function relayTick(cfg, state, hooks) {
             const idle = looksIdleFor(cap, kindOf(cfg));
             if (state.pending.sentMarked && idle) {
                 const centralStatus = await fetchCommandStatus(cfg, state.pending.id);
-                if (isTerminalCommandStatus(centralStatus)) {
+                // ★本文未着(instruction_missing)も追跡をやめる（便 7d810bbb）。管制は占有を外して人の判断待ちに
+                //   出している＝ここで待ち続けると次の便が拾えない。★配り直さない（人が決める）。
+                if (isTerminalCommandStatus(centralStatus) || centralStatus === INSTRUCTION_MISSING_STATUS) {
                     log(`site=${cfg.site} id=${state.pending.id} は中央で終端(status=${centralStatus})を確認` +
                         '（外部完了検出・キュー有無に依らず）→ 追跡解除し次tickで新規取得');
                     state.pending = null;
@@ -2858,6 +3116,8 @@ export async function relayTick(cfg, state, hooks) {
             : undefined;
         const text = buildSendText(cmd.body, cfg.site, anchor, kindOf(cfg), context);
         const sendStartedAt = Date.now();
+        // ★Claude の職人へは受領確認を使う（便 7d810bbb）。Codex は会話の記録の形が違うので今までどおり。
+        const useAck = kindOf(cfg) === 'claude';
         if (!sendToTmux(cfg.site, text)) {
             // 送信失敗（sendToTmux は内部で例外も握って false を返す）。status は queued のまま据え置く。
             // 失敗の理由（tmux の stderr）は sendToTmux が直前の行に出している。
@@ -2881,6 +3141,7 @@ export async function relayTick(cfg, state, hooks) {
             delivered: true,
             sentMarked: false,
             screenDoneWide: false,
+            ...(useAck ? { markAs: 'delivering' } : {}),
         };
         // 累計配達回数を通算（絶対上限 RELAY_DELIVER_MAX の基準）。
         markDelivered(state, cmd.id);
@@ -2888,33 +3149,45 @@ export async function relayTick(cfg, state, hooks) {
         state.lastHeartbeatAt = null;
         noteReadiness(state, 'delivered', cmd.id);
         log(`site=${cfg.site} id=${cmd.id} 配達しました`);
-        // ★職人が本当に受け付けたかを、職人の会話の記録（指示ID）で確かめる。未受付のときだけ Enter を
-        //   押し直す（便 b69c1608）。★確かめの結果で配達済みの扱いは変えない（二重に配らない）。
-        if (kindOf(cfg) === 'claude') {
-            const cwd = tmuxPaneCwd(cfg.site);
-            if (cwd) {
-                const r = await confirmSubmitted({
-                    accepted: () => hasSubmittedRecord(cwd, cmd.id, sendStartedAt),
-                    pendingInInput: () => {
-                        const c = tmuxCapture(cfg.site);
-                        return c !== null && hasPendingDeliveryInInput(c);
-                    },
-                    pressEnter: () => {
-                        try {
-                            runTmux(['send-keys', '-t', cfg.site, 'Enter']);
-                        }
-                        catch {
-                            // 押せなくても次の確かめで分かる（受け付けられていなければ unconfirmed で残る）。
-                        }
-                    },
-                    sleep,
-                });
-                log(`site=${cfg.site} id=${cmd.id} 受付の確かめ: ${r.result}（押し直し ${r.resent} 回）`);
-            }
-        }
-        // ★配達の直後に「配達済み(sent)」を管制へ書く。書けなければ次tick以降で書けるまでやり直す
+        // ★配った時点で管制へ印を書く（便 7d810bbb）。Claude の職人は「配達中(受領確認待ち)」、
+        //   それ以外は今までどおり「配達済み(sent)」。書けなければ次tick以降で書けるまでやり直す
         //   （markSentAtCentral）。★書けなくても再配達はしない。
         await markSentAtCentral(cfg, state);
+        if (!useAck || state.pending === null)
+            return;
+        // ── 受領確認（★えふさん確定：送った instruction_id と完全一致した印を確かめて初めて ACK） ──
+        //   印を待ち、入力欄に残っていれば Enter だけ押し直し（b69c1608）、現れなければ2回まで貼り直す。
+        //   ★一致の確かめに使うのは、この便を貼った後（sendStartedAt 以降）に新しく出た記録だけ。
+        const pending = state.pending;
+        const cwd = tmuxPaneCwd(cfg.site);
+        const r = cwd === null
+            ? { received: false, repasted: 0, resent: 0, reason: '職人の作業場所が分からず、印を確かめられない（貼り直さない）' }
+            : await awaitDeliveryAck({
+                stampSeen: () => hasJobStampSince(cwd, cmd.id, sendStartedAt),
+                pendingInInput: () => {
+                    const c = tmuxCapture(cfg.site);
+                    return c !== null && hasPendingDeliveryInInput(c);
+                },
+                pressEnter: () => {
+                    try {
+                        runTmux(['send-keys', '-t', cfg.site, 'Enter']);
+                    }
+                    catch {
+                        // 押せなくても次の確かめで分かる（印が出なければ未着として扱う）。
+                    }
+                },
+                idle: () => isIdleStable(cfg.site, kindOf(cfg)),
+                // ★同じ本文をそのまま貼り直す（配達回数は数えない＝1回の配達の中の貼り直し）。
+                repaste: () => sendToTmux(cfg.site, text),
+                sleep,
+            });
+        log(`site=${cfg.site} id=${cmd.id} 受領の確かめ: ${r.received ? '印が一致（受領）' : `印が現れない（本文未着）: ${r.reason}`}` +
+            `（Enter押し直し ${r.resent} 回・貼り直し ${r.repasted} 回）`);
+        if (state.pending !== pending)
+            return; // 待っている間に畳まれていたら何もしない（念のため）。
+        pending.ack = r.received ? 'received' : 'missing';
+        pending.ackSent = false;
+        await sendAckAtCentral(cfg, state);
     }
     finally {
         state.running = false;

package/package.json

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

package/skills/conductor-craftsman/SKILL.md

@@ -44,6 +44,66 @@ description: 采配くんの便（プロンプト末尾に CONDUCTOR_JOB:<id>
    - ★**合流したかの確かめ方（題名では判定しない・えふさん確定 2026-09-18）。** 合流完了の判定はコミット題名では行わない。GitHub上で対象PRが MERGED であること、merge先が意図したbase branchであること、merge後のbase branchに対象PRの変更内容が含まれることを確認する。（squash merge / merge commit / rebase merge の方式に依存しない確認にする）
      - ★これは共通正本 `claude-code-operations.md §11.3` と、この鉄則7 の2か所を正本にする（各リポの CLAUDE.md へは複製しない）。
      - 確かめ方の例（値は実際の番号・ブランチ名に置き換える）：`gh pr view 番号 --json state,baseRefName,mergeCommit` で、`state` が `MERGED`、`baseRefName` が意図した base branch（ふつうは `main`）であることを見る。`git fetch origin` のあと `git merge-base --is-ancestor mergeCommitのoid origin/base` が成功する（＝合流でできたコミットが base に含まれる）ことを見る。`gh pr diff 番号` の変更が、`git diff` や `git show origin/base:ファイル` で base branch に入っていることを、変更したファイルごとに見比べる。
+   - ★**上の4つ（保護の確認・CI・合流・合流後の確かめ）を1回で流す形**（便 03bef270）。★**確かめは1つも省いていない**：段の名前（`protect` / `ci` / `merge` / `verify`）付きで結果を出し、**落ちた段で止まる**。`--admin` は使わない。確かめを減らしたいときにこの塊を削らない。
+     そのままコピーして、1回の実行として流す（`PR=<PR番号>`）。手で1つずつ打つ従来の手順も、そのまま有効。
+   ```bash
+   #!/usr/bin/env bash
+   # 鉄則7 の4つの確かめ（保護 → CI → 合流 → 合流後）を1回で流す。確かめは1つも省かない。
+   # 使い方: PR=<PR番号> bash <この塊>   落ちた段は NG[段名] で分かる。★--admin は使わない。
+   set -uo pipefail
+   PR="${PR:?PR=<PR番号> が要る}"
+   ng() { printf 'NG[%s] %s\n' "$1" "$2" >&2; exit 1; }
+   ok() { printf 'OK[%s] %s\n' "$1" "$2"; }
+   V() { gh pr view "$PR" --json "$1" --jq "$2" 2>/dev/null; }
+
+   # ① 保護 … 必須の検査が1件以上のときだけ「保護あり」。0・404・403・失敗は「保護なし」へ倒す。
+   BASE="$(V baseRefName .baseRefName)"; [ -n "$BASE" ] || ng protect '合流先を読めない'
+   SLUG="$(gh repo view --json nameWithOwner --jq .nameWithOwner 2>/dev/null)"
+   [ -n "$SLUG" ] || ng protect 'リポジトリを読めない'
+   N="$(gh api "repos/$SLUG/branches/$BASE/protection/required_status_checks" --jq '.contexts | length' 2>/dev/null)"
+   case "$N" in ''|*[!0-9]*) N=0 ;; esac
+   if [ "$N" -ge 1 ]; then PROT=yes; else PROT=no; fi
+   ok protect "base=$BASE 保護=$PROT（必須の検査 $N 件）"
+
+   # ② CI … リンクが /actions/runs/ の行だけを CI と数える（Vercel は数えない）。
+   ROLL="$(V statusCheckRollup '[.statusCheckRollup[]? | {u:(.detailsUrl//.targetUrl//""), s:(.status//""), c:((.conclusion//.state//"")|ascii_upcase)} | select(.u|test("/actions/runs/"))]')"
+   [ -n "$ROLL" ] || ng ci 'CI の一覧を読めない'
+   read -r TOTAL RUNNING RED NOTPASS <<<"$(printf '%s' "$ROLL" | jq -r '[length,
+     ([.[]|select(.s!="" and .s!="COMPLETED")]|length),
+     ([.[]|select(.s=="COMPLETED" or .s=="")|select(.c|test("^(SUCCESS|NEUTRAL|SKIPPED)$")|not)]|length),
+     ([.[]|select(.c|test("^(SUCCESS|NEUTRAL|SKIPPED)$")|not)]|length)] | @tsv')"
+   [ "${TOTAL:-0}" -ge 1 ] || ng ci 'このリポに CI が無い（鉄則7-④: 手元で検査を流し、人の判断で合流する）'
+   [ "$RED" -eq 0 ] || ng ci "CI が赤（$RED 件）"
+   if [ "$PROT" = no ]; then
+     [ "$RUNNING" -eq 0 ] || ng ci "CI が実行中（$RUNNING 件・終わってから確かめ直す）"
+     [ "$NOTPASS" -eq 0 ] || ng ci "pass でない CI がある（$NOTPASS 件）"
+   fi
+   ok ci "CI $TOTAL 件・赤 0 件（保護=$PROT）"
+
+   # ③ 合流 … 保護あり＝予約（緑になり次第 GitHub が合流）／保護なし＝緑を確かめたうえで合流。
+   if [ "$PROT" = yes ]; then
+     gh pr merge "$PR" --auto --merge --delete-branch || ng merge '合流の予約に失敗（鉄則7-② で確かめ直す。旗を足さない）'
+     ok merge '保護あり＝合流を予約した'
+   else
+     gh pr merge "$PR" --merge --delete-branch || ng merge '合流に失敗'
+     ok merge '保護なし＝CI の緑を確かめてから合流した'
+   fi
+
+   # ④ 合流後 … MERGED・base が意図どおり・変更が base に入っている（題名では判定しない）。
+   END=$(( $(date +%s) + ${WAIT:-600} ))
+   while :; do
+     ST="$(V state .state)"
+     [ "$ST" = MERGED ] && break
+     [ "$(date +%s)" -lt "$END" ] || ng verify "まだ MERGED でない（state=$ST）"
+     sleep 15
+   done
+   GOT="$(V baseRefName .baseRefName)"
+   [ "$GOT" = "$BASE" ] || ng verify "合流先が違う（$GOT ≠ $BASE）"
+   OID="$(V mergeCommit .mergeCommit.oid)"; [ -n "$OID" ] || ng verify '合流コミットを読めない'
+   git fetch origin --quiet || ng verify 'fetch に失敗'
+   git merge-base --is-ancestor "$OID" "origin/$BASE" || ng verify "変更が origin/$BASE に入っていない"
+   ok verify "MERGED / base=$BASE / $OID が origin/$BASE に入っている"
+   ```
 8. **ブラウザ検品（Playwright）の作法** — ★取りに行かない。PCに1回だけ入れた共有の道具を指すだけ（ADR-010）。
    - ① **起動は必ず `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）。
@@ -69,6 +129,15 @@ description: 采配くんの便（プロンプト末尾に CONDUCTOR_JOB:<id>
     - **雛形（`.env.example` など）を直すときの正しい形＝「案を作る→人が1回で反映」。** 職人は変更後の中身を**リポジトリの外（`/tmp/claude-1000/` の下）**に作り、報告に次の2つを載せる。① 変更の**差分**（何を足す／消すか）。② 人が**素のターミナルで1回貼るだけで反映できる1つのコマンド**（例：`cp /tmp/claude-1000/<下書き> <リポ>/.env.example`）。★このコマンドは**人が自分のターミナルで**打つ（職人の番人は人の端末には掛からない）。職人が `.env.example` を直接書き換えようとしても番人が止めるので、**回避せず、この形で案を出す**。
     - **本物の `.env`・`.env.local` は、これまでどおり中身も書き込みも扱わない**（秘密の値は1文字も読まない・書かない＝鉄則12の金庫）。
 
+## 番人に止められる常連（こう書くと止まる → 代わりにこう書く）
+
+止まる書き方を最初から使わなければ、打ち直しの往復が要らない。★番人の判定は変えない（弱めない）。
+
+- **cd を `&&` でつなぐ**（`cd 先 && 何か`・cd とリダイレクトを同じ行に混ぜる）→ 止まる。**cd は作業のはじめに1回だけ単独で**打ち、以後は絶対パスか `git -C <実際のパス>`（鉄則2）。
+- **`.npmrc` を読む**（`cat ~/.npmrc` など）→ 止まる。**中身は見に行かない。** 差分は対象を名指しで `git diff -- src docs`、全体で見たいときは除いて `git diff -- . ':(exclude).npmrc'`（鉄則1）。
+- **中身が変わる場所を指す再帰の `rm`**（`rm -rf "$DIR/x"`・`rm -rf build/*` のように変数や `*` を含む）→ 止まる。**消す先を実在のパスで名指しする**（例 `rm -rf /tmp/claude-1000/作業名`・鉄則13）。
+- **作業場所が変数のままの `git push`**（`git -C "$DIR" push`・行き先のブランチを確かめられない形）→ 止まる。**リポの中で、ブランチを名指しして** `git push -u origin <作業ブランチ名>`。
+
 ## 便の終え方
 
 便の最後には、配達役が付けた1行「【便の終え方】…報告の置き場: ～／最終行: DONE:<現場> とだけ出力／完了の知らせ: conductor_complete を commandId="<指示ID>" で1回だけ」と、管理用ジョブ印 `CONDUCTOR_JOB:<指示ID>` がある。作業がすべて終わったら、この節のとおりに次の順で終える（便 a5306df2：以前は便ごとに付いていた全文を、ここへ寄せた）。