@tyhld/conductor 0.12.51 → 0.12.53

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;
             }
@@ -1669,12 +1697,8 @@ function runTmux(args) {
  * ★tmux の言い分（stderr）をログに出す。以前は `failed` としか出ず原因が追えなかった。
  */
 export function sendToTmux(site, text) {
-    const bufferName = `${RELAY_SEND_BUFFER_PREFIX}-${site}-${process.pid}-${Date.now()}`;
-    let file = null;
     try {
-        file = writeSendTmpFile(text);
-        runTmux(['load-buffer', '-b', bufferName, file]);
-        runTmux(['paste-buffer', '-d', '-p', '-b', bufferName, '-t', site]);
+        pasteToTmux(site, text);
         // 貼り付けの枠の外に、打った字として添え書きを置く（RELAY_DELIVERY_NOTE の説明）。
         runTmux(['send-keys', '-t', site, '-l', ` ${RELAY_DELIVERY_NOTE}`]);
         // ★Enter の前に一拍おく（RELAY_SUBMIT_PAUSE_MS の説明・便 b69c1608）。
@@ -1684,13 +1708,30 @@ export function sendToTmux(site, text) {
     }
     catch (err) {
         log(`WARN site=${site} 本文の投入に失敗（${text.length}文字）: ${describeExecError(err)}`);
+        return false;
+    }
+}
+/**
+ * 本文を一時ファイル → tmux のバッファ → 職人の窓へ貼る（貼るだけ。添え書きも Enter も送らない）。
+ * 失敗したら例外がそのまま飛ぶ。一時ファイルは必ず消し、貼る前に転んだバッファも消す
+ * （sendToTmux の【後始末】の説明）。
+ */
+function pasteToTmux(site, text) {
+    const bufferName = `${RELAY_SEND_BUFFER_PREFIX}-${site}-${process.pid}-${Date.now()}`;
+    let file = null;
+    try {
+        file = writeSendTmpFile(text);
+        runTmux(['load-buffer', '-b', bufferName, file]);
+        runTmux(['paste-buffer', '-d', '-p', '-b', bufferName, '-t', site]);
+    }
+    catch (err) {
         try {
             execFileSync('tmux', ['delete-buffer', '-b', bufferName], { stdio: 'ignore' });
         }
         catch {
             // 貼れていれば -d で既に消えている。無いバッファを消そうとしたエラーは無視してよい。
         }
-        return false;
+        throw err;
     }
     finally {
         if (file !== null) {
@@ -1704,6 +1745,165 @@ export function sendToTmux(site, text) {
     }
 }
 // ───────────────────────────────────────────────────────────────────────────
+// 貼り付けが入力欄に入ったのを確かめてから送る（便 963ddca3・★添え書きだけが届く事故の根治）
+//
+// 【何が起きたか（実障害 2026-09-23 minoru 便 af960f79／2026-09-24 ai-kana 便 0b637256）】
+//   職人の会話の記録（実物）を読むと、どちらも利用者の発言として記録されたのは
+//   「 （配達役より）上の貼り付けは…」の75字だけで、貼り付け（本文と便印）は入力欄に一度も入って
+//   いなかった。★配達役は貼り付けが入ったかを確かめず、続けて添え書きを打って Enter を押していた。
+//   だから職人が貼り付けを受け取れなかった瞬間に、添え書きだけが単独で送信された。
+//   2件とも職人の tmux ができてから 11〜30 秒の、職人を起動した直後の最初の便だった
+//   （同じ期間の会話を新しくした後の配達 12 件はすべて届いている）。
+// 【なぜ貼り付けが消えるか（試験用の tmux で本物の Claude Code 2.1.281 に当てて再現）】
+//   貼り付けと添え書きが【1回の読み込みでまとめて】職人に届くと、Claude Code は貼り付けを捨て、
+//   添え書きだけを入力欄に残す（入力欄は「 （配達役より）…」＝実障害の記録と1字も違わない）。
+//   配達役は貼り付けの直後に添え書きを打つので、職人が起動直後で読み込みが遅れていると、両方が
+//   たまって一度に読まれる（★ここは推定：実障害2件はどちらも起動直後の最初の便で、/clear から記録
+//   までが 8.8・9.2 秒と、届いた便のほとんど（6.1〜7.9 秒）より遅かった。職人の読み込みの遅れそのものは
+//   記録に残っていない）。
+//   そこへ1秒後の Enter が別に届き、添え書きだけが送信された。
+// 【根治】「貼る → 入力欄に入ったのを画面で確かめる → 添え書きを打つ → 入力欄に貼り付けと添え書きが
+//   そろっているのを確かめる → Enter」。★そろっていなければ Enter を押さない。
+//   ＝貼り付けが入らないかぎり、何も送信されない（添え書きだけが先に・単独で届く形が無い）。
+//   入らなければ、画面が入力待ちに戻るのを確かめてから貼り直す（上限あり）。時間で決め打ちしない。
+// ★入力欄に人が打ちかけた字があれば貼らない（人の入力に混ぜない）。
+// ★消すのは、配達役が打った添え書きの字だけ（貼り付けが入らず、添え書きだけが入力欄に残ったとき）。
+// ───────────────────────────────────────────────────────────────────────────
+/** 貼ってから入力欄に入るのを待つ長さ（1回ぶん・ミリ秒）。★待ちの上限であって、決め打ちの間ではない。 */
+export const RELAY_PASTE_LAND_MS = 5_000;
+/** 1回の配達の中で貼る回数の上限（入力欄に入らなかったときの貼り直しを含む）。 */
+export const RELAY_PASTE_MAX_TRIES = 3;
+/**
+ * 画面のいちばん下の入力欄（最後の ❯ の行から次の罫線まで）の文字。入力欄が無ければ null。
+ * ★折り返しは元に戻さない（呼び出し側で joinWrapped する）。
+ */
+export function inputBlock(cap) {
+    const lines = cap.split('\n');
+    let start = -1;
+    for (let k = lines.length - 1; k >= 0; k--) {
+        if (/^\s*❯/.test(lines[k])) {
+            start = k;
+            break;
+        }
+    }
+    if (start < 0)
+        return null;
+    const block = [];
+    for (let k = start; k < lines.length; k++) {
+        if (k > start && /^─{10,}/.test(lines[k].trim()))
+            break;
+        block.push(lines[k]);
+    }
+    return block.join('\n');
+}
+/** 画面の折り返しを戻す（改行と、続きの行の頭の空白を取る）。 */
+function joinWrapped(s) {
+    return s.replace(/\n[ \t]*/g, '');
+}
+/**
+ * 入力欄に、この便の貼り付けが入っているか。
+ *   ・長い貼り付けは Claude Code が `[Pasted text #1 +N lines]` と畳んで見せる（実測）。
+ *   ・短い貼り付けはそのまま見える＝本文の末尾の便印（CONDUCTOR_JOB:<id>）が完全一致で在るか。
+ */
+export function hasPasteInInput(cap, commandId) {
+    const block = inputBlock(cap);
+    if (block === null)
+        return false;
+    if (/\[Pasted text #\d+/.test(block))
+        return true;
+    return hasExactJobStamp(joinWrapped(block), commandId);
+}
+/** 入力欄に、配達役の添え書きが（全部）入っているか。 */
+function hasNoteInInput(cap) {
+    const block = inputBlock(cap);
+    return block !== null && block.replace(/\s/g, '').includes(RELAY_DELIVERY_NOTE.replace(/\s/g, ''));
+}
+/**
+ * 入力欄が「配達役が貼ってよい」状態か：入力欄が在り、貼り付け・添え書き・便印のどれも無い。
+ * ★人が打ちかけた字は画面の上では Claude Code の薄い字の例（Try "…"）と見分けられないので、
+ *   ここでは「配達役の物が残っていない」ことだけを見る（人の打ちかけは受付の確かめが別に守る）。
+ */
+function inputIsClear(cap, commandId) {
+    const block = inputBlock(cap);
+    if (block === null)
+        return false;
+    return !hasPasteInInput(cap, commandId) && !block.includes('（配達役より）');
+}
+/**
+ * 貼り付けが入力欄に入ったのを確かめてから、添え書きを打って送る（Claude の職人向け）。
+ * ★Enter を押すのは「入力欄に貼り付けと添え書きの両方がある」ときだけ。
+ */
+export async function deliverToTmux(site, text, commandId, d = {
+    capture: () => tmuxCapture(site),
+    paste: (t) => pasteToTmux(site, t),
+    typeNote: () => runTmux(['send-keys', '-t', site, '-l', ` ${RELAY_DELIVERY_NOTE}`]),
+    // 打った字の数だけ BSpace（先頭の空白1字を含む）。★配達役が打った字しか消さない。
+    eraseNote: () => runTmux(['send-keys', '-t', site, '-N', String([...` ${RELAY_DELIVERY_NOTE}`].length), 'BSpace']),
+    enter: () => runTmux(['send-keys', '-t', site, 'Enter']),
+    pause: pauseSync,
+    sleep,
+    ready: () => isIdleStable(site, 'claude'),
+}, o = {
+    landMs: RELAY_PASTE_LAND_MS,
+    pollMs: 250,
+    maxTries: RELAY_PASTE_MAX_TRIES,
+}) {
+    let pastes = 0;
+    const landed = async () => {
+        for (let t = 0;; t += o.pollMs) {
+            const cap = d.capture();
+            if (cap !== null && hasPasteInInput(cap, commandId))
+                return true;
+            if (t >= o.landMs)
+                return false;
+            await d.sleep(o.pollMs);
+        }
+    };
+    try {
+        for (let round = 0; round < o.maxTries; round++) {
+            // ★入力を受け取れる状態（入力待ちで落ち着いた画面）を確かめてから触る。
+            if (!(await d.ready())) {
+                await d.sleep(o.pollMs);
+                continue;
+            }
+            const cap = d.capture();
+            if (cap === null)
+                return { result: 'failed', pastes };
+            // ★まだ1度も貼っていないのに入力欄に貼り付けがあるなら、それが配達役の物だと言えるのは
+            //   この便の印（完全一致）が見えるときだけ。畳まれた貼り付けは誰の物か分からないので触らない。
+            if (pastes === 0 && hasPasteInInput(cap, commandId) && !hasExactJobStamp(joinWrapped(inputBlock(cap) ?? ''), commandId)) {
+                return { result: 'not-clear', pastes };
+            }
+            if (!hasPasteInInput(cap, commandId)) {
+                // 前の回の貼り付けも入っていない。配達役の物ではない残りがあれば貼らない。
+                if (!inputIsClear(cap, commandId))
+                    return { result: 'not-clear', pastes };
+                d.paste(text);
+                pastes++;
+                if (!(await landed()))
+                    continue; // ★入らなかった＝何も打たずに次の回へ
+            }
+            if (!hasNoteInInput(d.capture() ?? '')) {
+                d.typeNote();
+                d.pause(RELAY_SUBMIT_PAUSE_MS);
+            }
+            const before = d.capture();
+            if (before !== null && hasPasteInInput(before, commandId) && hasNoteInInput(before)) {
+                d.enter();
+                return { result: 'submitted', pastes };
+            }
+            // ★そろっていない＝Enter を押さない。添え書きだけが残っていれば、打った字だけ消す。
+            if (before !== null && !hasPasteInInput(before, commandId) && hasNoteInInput(before))
+                d.eraseNote();
+        }
+    }
+    catch (err) {
+        log(`WARN site=${site} 本文の投入に失敗（${text.length}文字）: ${describeExecError(err)}`);
+        return { result: 'failed', pastes };
+    }
+    return { result: 'not-landed', pastes };
+}
+// ───────────────────────────────────────────────────────────────────────────
 // 受付の確かめ（便 b69c1608）
 //
 // 【なぜ要るか】送信の Enter が職人に届いても、Claude Code が送信として受け付けたとは限らない
@@ -1785,28 +1985,151 @@ 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 hasPendingDeliveryInInput(cap) {
-    const lines = cap.split('\n');
-    let start = -1;
-    for (let k = lines.length - 1; k >= 0; k--) {
-        if (/^\s*❯/.test(lines[k])) {
-            start = k;
-            break;
-        }
+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;
     }
-    if (start < 0)
+    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;
-    const block = [];
-    for (let k = start; k < lines.length; k++) {
-        if (k > start && /^─{10,}/.test(lines[k].trim()))
+    }
+    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;
-        block.push(lines[k]);
+        }
+        if (d.pendingInInput()) {
+            reason = '入力欄に便が残ったまま送信されない（貼り直すと二重に入るので貼り直さない）';
+            break;
+        }
+        if (!(await d.idle())) {
+            reason = '職人がアイドルでないので貼り直さなかった';
+            continue; // この回は貼り直さずに、もう一度だけ印を待つ（回数は数える＝待ちは有限）
+        }
+        if (await d.repaste()) {
+            repasted++;
+            reason = '';
+        }
+        else {
+            reason = '貼り直しに失敗';
+        }
     }
-    return block.join('\n').includes('（配達役より）');
+    // ★返す直前にもう一度だけ見る（最後の待ちの直後に印が出た場合を取りこぼさない）。
+    if (d.stampSeen())
+        return { received: true, repasted, resent, reason: '' };
+    return { received: false, repasted, resent, reason };
+}
+/**
+ * 入力欄（画面のいちばん下の ❯ から次の罫線まで）に、配達役の添え書きが残っているか。
+ * ★押し直してよいのは「こちらが入れた便が入力欄に残っている」ときだけ、を確かめるために使う。
+ */
+export function hasPendingDeliveryInInput(cap) {
+    const block = inputBlock(cap);
+    return block !== null && block.includes('（配達役より）');
 }
 // ───────────────────────────────────────────────────────────────────────────
 // 1便1context：配る直前に職人の会話を新しくする（便 87a1a28a・★既定オフ）
@@ -1823,13 +2146,10 @@ export function hasPendingDeliveryInInput(cap) {
 // ───────────────────────────────────────────────────────────────────────────
 /** 会話を新しくできたかを待つ長さ（ミリ秒）。 */
 export const RELAY_FRESH_CONFIRM_MS = 10_000;
-/**
- * 会話が新しくなってから配るまでに置く間（ミリ秒）。
- * ★実測（試験用の tmux・本物の Claude Code）：新しい会話のファイルができた1秒後に貼り付けると、
- *   入力欄がまだ整っておらず【貼り付けた本文が落ち、添え書きだけが送信された】（職人は「貼り付けが
- *   届いていない」と答えて止まった）。間を置いたうえで、画面が入力待ちで落ち着いたことも確かめる。
- */
-export const RELAY_FRESH_SETTLE_MS = 3_000;
+// ★会話が新しくなった後に「決め打ちの間」は置かない（便 963ddca3）。以前は 3 秒待っていたが、
+//   職人を起動した直後の最初の便では 3 秒待っても貼り付けが落ちた（実障害2件）。入力を受け取れる
+//   状態かは時間では分からないので、①画面が入力待ちで落ち着くのを待ち、②貼った後に入力欄へ入った
+//   のを画面で確かめる（deliverToTmux）。入らなければ何も送らずに貼り直す。
 /** その作業場所の会話の記録のファイル名の一覧。読めなければ空。 */
 export function listTranscripts(cwd, env = process.env) {
     try {
@@ -1859,9 +2179,14 @@ export async function freshenContext(site, cwd, d = {
     }
     for (let t = 0;; t += o.pollMs) {
         if (d.listSessions().some((n) => !before.has(n))) {
-            // ★新しい会話ができた直後は入力欄が整っていない（RELAY_FRESH_SETTLE_MS の説明）。
-            await d.sleep(RELAY_FRESH_SETTLE_MS);
-            return d.ready();
+            // ★新しい会話ができたら、画面が入力待ちで落ち着くのを待つ（上限は waitMs・決め打ちの間は置かない）。
+            for (let u = 0;; u += o.pollMs) {
+                if (await d.ready())
+                    return true;
+                if (u >= o.waitMs)
+                    return false;
+                await d.sleep(o.pollMs);
+            }
         }
         if (t >= o.waitMs)
             return false;
@@ -2163,9 +2488,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 +2508,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 +2518,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 +2981,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 +3042,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,7 +3275,27 @@ export async function relayTick(cfg, state, hooks) {
             : undefined;
         const text = buildSendText(cmd.body, cfg.site, anchor, kindOf(cfg), context);
         const sendStartedAt = Date.now();
-        if (!sendToTmux(cfg.site, text)) {
+        // ★Claude の職人へは受領確認を使う（便 7d810bbb）。Codex は会話の記録の形が違うので今までどおり。
+        const useAck = kindOf(cfg) === 'claude';
+        // ★Claude の職人へは「貼り付けが入力欄に入ったのを確かめてから添え書きと Enter」（便 963ddca3）。
+        //   入らなければ何も送信しない＝添え書きだけが届く形が無い。
+        let landed = true;
+        if (useAck) {
+            const d = await deliverToTmux(cfg.site, text, cmd.id);
+            if (d.result === 'failed' || d.result === 'not-clear') {
+                // 職人には何も送っていない。status は queued のまま据え置く（今までの送信失敗と同じ）。
+                log(d.result === 'failed'
+                    ? `本文の投入に失敗, keep queued: ${cfg.site}/${cmd.id}`
+                    : `WARN site=${cfg.site} id=${cmd.id} 入力欄に配達役の物ではない字が残っているので貼らずに次の周で確かめ直します`);
+                return;
+            }
+            landed = d.result === 'submitted';
+            if (!landed) {
+                log(`WARN site=${cfg.site} id=${cmd.id} 貼り付けが入力欄に入らない（${d.pastes}回貼った）。` +
+                    '★何も送信していません→本文未着として管制へ知らせます');
+            }
+        }
+        else if (!sendToTmux(cfg.site, text)) {
             // 送信失敗（sendToTmux は内部で例外も握って false を返す）。status は queued のまま据え置く。
             // 失敗の理由（tmux の stderr）は sendToTmux が直前の行に出している。
             log(`本文の投入に失敗, keep queued: ${cfg.site}/${cmd.id}`);
@@ -2881,40 +3318,62 @@ export async function relayTick(cfg, state, hooks) {
             delivered: true,
             sentMarked: false,
             screenDoneWide: false,
+            ...(useAck ? { markAs: 'delivering' } : {}),
         };
         // 累計配達回数を通算（絶対上限 RELAY_DELIVER_MAX の基準）。
         markDelivered(state, cmd.id);
         // 新しい指示の生存ハートビートは先頭から数え直す（前指示のスロットルを引き継がない）。
         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以降で書けるまでやり直す
+        log(`site=${cfg.site} id=${cmd.id} ${landed ? '配達しました' : '配達を試みましたが貼り付けが入らず、何も送信していません'}`);
+        // ★配った時点で管制へ印を書く（便 7d810bbb）。Claude の職人は「配達中(受領確認待ち)」、
+        //   それ以外は今までどおり「配達済み(sent)」。書けなければ次tick以降で書けるまでやり直す
         //   （markSentAtCentral）。★書けなくても再配達はしない。
         await markSentAtCentral(cfg, state);
+        if (!useAck || state.pending === null)
+            return;
+        if (!landed) {
+            // ★貼り付けが入らなかった＝職人は何も受け取っていない。本文未着として知らせ、追跡を外す
+            //   （7d810bbb の道）。★配り直さない・ほかの便も配らない（配り直すのは人の手番）。
+            state.pending.ack = 'missing';
+            state.pending.ackSent = false;
+            await sendAckAtCentral(cfg, state);
+            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回の配達の中の貼り直し）。★貼り直しも、入力欄に
+                //   入ったのを確かめてからでないと添え書きも Enter も送らない（便 963ddca3）。
+                repaste: async () => (await deliverToTmux(cfg.site, text, cmd.id)).result === 'submitted',
+                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.51",
+  "version": "0.12.53",
   "description": "采配くん管制の見守りアプリ（conductor-agent）。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
   "type": "module",
   "bin": {