@tyhld/conductor 0.12.52 → 0.12.54

package/dist/cli.js

@@ -13,7 +13,9 @@ import { execFileSync, spawnSync } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import os from 'node:os';
+import path from 'node:path';
 import { RELAY_FETCH_TIMEOUT_MS, createRelayState, deliveryReport, parseAgentKind, reconnectDelayMs, relayTick, tmuxHasSession, pendingReportIds, sendPendingReportFiles, sweepProcessedReports, } from './relay.js';
+import { createHeadlessState, headlessNextDelayMs, headlessTick, parseRunnerMode, } from './headless.js';
 import { createRelayRunner } from './relay-runner.js';
 import { installProcessGuards } from './process-guard.js';
 import { registerNudgeTarget, unregisterNudgeTarget, watchNudges, } from './nudge.js';
@@ -144,6 +146,9 @@ function loadConfig(args) {
         }
         promptIntervalSec = parsed;
     }
+    // ★配達方式（えふさん確定）。既定 'tmux'。'headless' で画面なし方式に切り替わる。
+    //   秘密ではないので ~/.conductor.env には入れない（systemd の drop-in か直接の export）。
+    const runnerMode = parseRunnerMode(process.env.CONDUCTOR_RUNNER_MODE);
     return {
         url: url.replace(/\/+$/, ''),
         token,
@@ -157,6 +162,7 @@ function loadConfig(args) {
         promptIntervalSec,
         agentKind,
         freshContext,
+        runnerMode,
     };
 }
 /** 1回分の報告を送る。送信結果（HTTPステータス）をログ表示する。 */
@@ -167,7 +173,8 @@ async function sendReport(cfg) {
         branch: detectBranch(),
         status: cfg.status,
         lastAction: cfg.lastAction,
-        artisanReady: tmuxHasSession(cfg.site),
+        // headless 方式では tmux セッションは使わない。ジョブ実行中または空きで待機中なら ready。
+        artisanReady: cfg.runnerMode === 'headless' ? cfg.relayEnabled : tmuxHasSession(cfg.site),
     };
     // ★relay が動いている機だけ、2段目（いま配れるか）を足す。
     //   未配達でないときは秒数と指示idを載せない＝管制で「遅れ」を数えない。
@@ -266,39 +273,60 @@ async function start(args) {
     //     ポーリングの間隔はこれまでどおり（15秒/承認待ち3秒）。耳が死んでいる間の保険として残す。
     let relayRunner = null;
     let nudgeWatcher = null;
+    // ★headless 方式の状態参照（sendReport のアダプタ用）。tmux のときは null のまま。
+    let headlessStateRef = null;
     if (cfg.relayEnabled) {
-        console.log(`[relay] 有効: site=${cfg.site} interval=${cfg.relayIntervalSec}s ` +
-            `（承認待ちの間だけ ${cfg.promptIntervalSec}s に短縮）` +
-            `（tmuxセッション "${cfg.site}" がアイドルのときだけ送信します）`);
-        const relayState = createRelayState();
-        // 生存報告に「いま配れるか」を載せるための参照（便 600d2a6a）。
-        relayStateForReport = relayState;
-        relayRunner = createRelayRunner({
-            tick: () => relayTick(cfg, relayState, {
-                // ★管制へつながらない状態から戻った瞬間に1回だけ呼ばれる。
-                //   既にある口（現場の生存報告）を1回叩き、管制の一覧の札をすぐ正しく戻す。
-                onCentralReconnect: () => {
-                    console.log('[relay] 管制へ現場の生存報告を1回送り直します（再接続の直後）');
-                    void sendReport(cfg);
+        if (cfg.runnerMode === 'headless') {
+            // ── headless 方式（画面なし・便ごとに claude -p を起動する） ──
+            const workDir = path.resolve(os.homedir(), 'projects', cfg.site);
+            console.log(`[headless] 有効: site=${cfg.site} mode=headless workDir=${workDir} ` +
+                `interval=${cfg.relayIntervalSec}s`);
+            const hState = createHeadlessState();
+            headlessStateRef = hState;
+            // 生存報告に「いま配れるか」を載せるため、内包する RelayState を参照する。
+            relayStateForReport = hState.relay;
+            const hCfg = { ...cfg, workDir };
+            relayRunner = createRelayRunner({
+                tick: () => headlessTick(hCfg, hState, {
+                    onCentralReconnect: () => {
+                        console.log('[headless] 管制へ現場の生存報告を1回送り直します（再接続の直後）');
+                        void sendReport(cfg);
+                    },
+                }),
+                nextDelayMs: () => headlessNextDelayMs(hState, cfg.relayIntervalSec),
+                onError: (err) => {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.log(`[headless] site=${cfg.site} tick で例外: ${msg}（次回に再試行）`);
                 },
-            }),
-            // ★管制へつながらない間だけ、再試行の間隔（5秒→10→20→40→60秒・上限後は60秒のまま永久に）。
-            //   つながっていれば従来どおり: 承認プロンプト待ちの間だけ短い間隔、それ以外は通常間隔
-            //   （★間隔は耳を付けても変えない＝線が切れている間はこのポーリングがそのまま肩代わりする保険）。
-            nextDelayMs: () => relayState.central.failures > 0
-                ? reconnectDelayMs(relayState.central.failures)
-                : (relayState.promptPending ? cfg.promptIntervalSec : cfg.relayIntervalSec) * 1000,
-            onError: (err) => {
-                // ループは絶対に止めない（1回の失敗で relay が死ぬと配達も承認も止まる）。
-                const msg = err instanceof Error ? err.message : String(err);
-                console.log(`[relay] site=${cfg.site} tick で例外: ${msg}（次回に再試行）`);
-            },
-        });
+            });
+        }
+        else {
+            // ── tmux 方式（従来どおり） ──
+            console.log(`[relay] 有効: site=${cfg.site} mode=tmux interval=${cfg.relayIntervalSec}s ` +
+                `（承認待ちの間だけ ${cfg.promptIntervalSec}s に短縮）` +
+                `（tmuxセッション "${cfg.site}" がアイドルのときだけ送信します）`);
+            const relayState = createRelayState();
+            // 生存報告に「いま配れるか」を載せるための参照（便 600d2a6a）。
+            relayStateForReport = relayState;
+            relayRunner = createRelayRunner({
+                tick: () => relayTick(cfg, relayState, {
+                    onCentralReconnect: () => {
+                        console.log('[relay] 管制へ現場の生存報告を1回送り直します（再接続の直後）');
+                        void sendReport(cfg);
+                    },
+                }),
+                nextDelayMs: () => relayState.central.failures > 0
+                    ? reconnectDelayMs(relayState.central.failures)
+                    : (relayState.promptPending ? cfg.promptIntervalSec : cfg.relayIntervalSec) * 1000,
+                onError: (err) => {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.log(`[relay] site=${cfg.site} tick で例外: ${msg}（次回に再試行）`);
+                },
+            });
+        }
         void relayRunner.run(); // 起動直後に1回。以後は自分で次を積む。
         // ADR-066 便2c: 耳の常駐(conductor ear / この機に1本)からの呼び鈴を受ける。
-        //   ・自分の合図ファイル（空ファイル）を用意する＝「この現場のrelayが動いている」の名簿登録も兼ねる。
-        //   ・呼び鈴が鳴ったらポーリング1周を前倒しするだけ。合図に中身は無く、指示は従来どおり取得APIから取る。
-        //   ・呼び鈴が来なくても・耳が落ちていても、上のポーリングがそのまま動く（耳は加速装置であって依存先ではない）。
+        //   ★headless でも同じ呼び鈴を受ける（指示取得を前倒しする仕組みは方式を問わない）。
         const registered = registerNudgeTarget(cfg.site);
         if (registered !== null) {
             console.log(`[relay] 合図の受け口: ${registered}（耳からの「今すぐ1周」を受けます）`);
@@ -457,6 +485,9 @@ function printUsage() {
         '  CONDUCTOR_RELAY_INTERVAL_SEC  relayポーリング間隔・秒（既定: 15）',
         '  CONDUCTOR_RELAY_PROMPT_INTERVAL_SEC  承認待ちの間だけ使う短い間隔・秒（既定: 3）',
         '',
+        '配達方式の切替（★PCごとに設定。relay を再起動すると切り替わる）:',
+        '  CONDUCTOR_RUNNER_MODE        tmux（既定）か headless。headless は便ごとに claude -p を起動する画面なし方式',
+        '',
         '管制につながらないとき（★relayは止まりません。待って再試行し、戻ったら自動で通常へ）:',
         '  RELAY_FETCH_TIMEOUT_MS    管制への問い合わせ1回の上限・ミリ秒（既定: 20000）',
         '  RELAY_RECONNECT_BASE_MS   再試行の最初の待ち・ミリ秒（既定: 5000。以後 倍々に伸ばす）',

package/dist/headless.js

@@ -0,0 +1,570 @@
+/**
+ * @tyhld/conductor — headless runner（画面なし方式）。
+ *
+ * tmux の代わりに、便ごとに `claude -p` を子プロセスで起動する。
+ *
+ * 【同時1指示】走る子プロセスは常に1つだけ。tmux 方式と同じ「1現場同時1指示」の不変条件を守る。
+ * 【入れ子防止】CLAUDECODE=1 は子プロセスの環境から外す（Claude Code が入れ子起動をブロックするため）。
+ * 【鍵の保護】ANTHROPIC_API_KEY も外す（今の tmux 起動と同じ。子プロセスは自分の鍵を使う）。
+ * 【秘密のマスク】進捗イベントを管制へ送る前に、鍵・トークン・パスワードをマスクする。
+ *
+ * 【なぜ切り出すか】headless 方式は tmux 方式とは配達・完了検出・状態管理が根本的に違う。
+ *   tmux: 「常駐する職人の画面へ貼り付ける → 画面の DONE 行を監視する」
+ *   headless: 「便ごとにプロセスを起動する → プロセスの終了を検出する」
+ *   同じ relayTick に分岐を詰め込むと壊れやすいので、独立したモジュールにする。
+ *   共通の管制との通信（fetchControl, fetchCommand, patchStatus 等）は relay.ts から使う。
+ */
+import { spawn } from 'node:child_process';
+import { createInterface } from 'node:readline';
+import { RELAY_DELIVER_MAX, RELAY_FETCH_TIMEOUT_MS, RELAY_HEARTBEAT_INTERVAL_MS, RELAY_PENDING_TIMEOUT_MS, RELAY_RESTORE_ORPHANS_ENABLED, buildAnchor, buildSendText, canDeliver, completeWithReport, createRelayState, deliveryReport, fetchCommand, fetchCommandStatus, fetchControl, fetchOrphans, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteReadiness, patchStatus, reconnectDelayMs, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
+const log = (msg) => {
+    console.log(`[headless] ${msg}`);
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// 定数
+// ─────────────────────────────────────────────────────────────────────────────
+/** 子プロセスへ SIGTERM を送ってから SIGKILL までの猶予(ms)。 */
+export const HEADLESS_KILL_GRACE_MS = 10_000;
+/** 1つの便を自動再開する最大試行回数（これを超えたら failed にして諦める）。 */
+export const HEADLESS_MAX_ATTEMPTS = 3;
+/** 進捗イベントのバッチ送信間隔(ms)。この間隔でバッファを管制へ流す。 */
+export const HEADLESS_EVENT_FLUSH_MS = 2_000;
+/** 実行中に stop_requested を確かめる間隔(ms)。 */
+export const HEADLESS_STOP_CHECK_MS = 15_000;
+/** イベントの text フィールドの上限(文字)。 */
+export const EVENT_TEXT_MAX = 500;
+/** resume 時に職人へ渡す続行指示。 */
+const RESUME_PROMPT = '前回の作業の続きを行ってください。中断された箇所から再開してください。';
+// ─────────────────────────────────────────────────────────────────────────────
+// 秘密のマスク
+// ─────────────────────────────────────────────────────────────────────────────
+/** 秘密の値を検出するパターン。マッチした部分を *** に置換してからイベントを送る。 */
+const SECRET_PATTERNS = [
+    /(?:CONDUCTOR_TOKEN|ANTHROPIC_API_KEY|API_KEY|SECRET_KEY|PASSWORD|DATABASE_URL|SUPABASE_SERVICE_ROLE_KEY)\s*[=:]\s*\S+/gi,
+    /Bearer\s+[A-Za-z0-9._~+/=-]{10,}/g,
+    /sk-ant-[A-Za-z0-9-]{20,}/g,
+    /sk-[A-Za-z0-9]{20,}/g,
+];
+export function maskSecrets(text) {
+    let masked = text;
+    for (const re of SECRET_PATTERNS) {
+        // 毎回 lastIndex をリセット（gフラグ付き RegExp の再利用に必要）。
+        re.lastIndex = 0;
+        masked = masked.replace(re, (m) => {
+            const sepIdx = m.search(/[=:]\s*/);
+            if (sepIdx >= 0) {
+                const afterSep = m.indexOf(m[sepIdx]) + 1;
+                return m.slice(0, afterSep) + '***';
+            }
+            if (/^Bearer\s/i.test(m))
+                return 'Bearer ***';
+            return '***';
+        });
+    }
+    return masked;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// ヘルパー
+// ─────────────────────────────────────────────────────────────────────────────
+/** commandId からセッション ID を作る（resume で再利用する決定的な値）。 */
+export function sessionIdForCommand(commandId) {
+    return `conductor-${commandId}`;
+}
+/** stream-json の1行を CommandEvent に変換する。無関係な行は null。 */
+export function streamEventToCommandEvent(parsed, attempt) {
+    const now = new Date().toISOString();
+    const type = parsed.type;
+    const subtype = parsed.subtype;
+    if (type === 'assistant' && subtype === 'text') {
+        const text = String(parsed.text ?? '').slice(0, EVENT_TEXT_MAX);
+        if (text.length === 0)
+            return null;
+        return { type: 'progress', text: maskSecrets(text), at: now, attempt };
+    }
+    if (type === 'assistant' && subtype === 'tool_use') {
+        const name = String(parsed.name ?? 'unknown');
+        return { type: 'tool', text: maskSecrets(`tool: ${name}`).slice(0, EVENT_TEXT_MAX), at: now, attempt };
+    }
+    if (type === 'result') {
+        if (subtype === 'error') {
+            const errText = String(parsed.error ?? '').slice(0, EVENT_TEXT_MAX);
+            return { type: 'error', text: maskSecrets(errText), at: now, attempt };
+        }
+        const resultText = String(parsed.result ?? '').slice(0, EVENT_TEXT_MAX);
+        return { type: 'result', text: maskSecrets(resultText), at: now, attempt };
+    }
+    return null;
+}
+/** 子プロセスの stderr から認証エラーを検出する。 */
+export function isAuthError(job) {
+    const s = job.stderrBuf.toLowerCase();
+    return (s.includes('401') ||
+        s.includes('unauthorized') ||
+        s.includes('authentication failed') ||
+        s.includes('invalid api key') ||
+        s.includes('invalid_api_key'));
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 子プロセスの起動と停止
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * claude -p を子プロセスとして起動する。
+ *
+ * 【環境変数】
+ *   CLAUDECODE を外す … 入れ子防止の解除。これが残っていると claude -p が起動しない。
+ *   ANTHROPIC_API_KEY を外す … 今の tmux 起動と同じ。子プロセスは自分の鍵で認証する。
+ *   CONDUCTOR_SITE, CONDUCTOR_MACHINE を渡す … フック（hooks）が管制と話すために使う。
+ *
+ * 【stdin】
+ *   初回: 指示本文（buildSendText で組み立てた1つのメッセージ）を書いて閉じる。
+ *   resume: 続行指示を書いて閉じる。
+ *
+ * 【stdout】stream-json 形式。行ごとに JSON を出す。readline で1行ずつ読む。
+ * 【stderr】蓄積して認証エラーの検出に使う。
+ */
+export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
+    const env = { ...process.env };
+    delete env.CLAUDECODE;
+    delete env.ANTHROPIC_API_KEY;
+    env.CONDUCTOR_SITE = cfg.site;
+    env.CONDUCTOR_MACHINE = cfg.machine;
+    const args = [
+        '-p',
+        '--output-format', 'stream-json',
+        '--permission-mode', cfg.permissionMode ?? 'acceptEdits',
+        '--session-id', sessionId,
+    ];
+    if (isResume)
+        args.push('--resume');
+    const proc = spawn('claude', args, {
+        cwd: cfg.workDir,
+        env,
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    const job = {
+        commandId: cmd.id,
+        process: proc,
+        sessionId,
+        startedAt: Date.now(),
+        attempt,
+        completed: false,
+        exitCode: null,
+        exitSignal: null,
+        stopped: false,
+        eventBuffer: [],
+        lastFlushAt: Date.now(),
+        lastStopCheckAt: Date.now(),
+        stderrBuf: '',
+    };
+    // stdin: 指示本文を書いて閉じる
+    if (proc.stdin) {
+        if (isResume) {
+            proc.stdin.write(RESUME_PROMPT);
+        }
+        else {
+            const anchor = buildAnchor(cmd.id);
+            const text = buildSendText(cmd.body, cfg.site, anchor, kindOf(cfg));
+            proc.stdin.write(text);
+        }
+        proc.stdin.end();
+    }
+    // stdout: stream-json を行ごとに読み、CommandEvent に変換してバッファへ
+    if (proc.stdout) {
+        const rl = createInterface({ input: proc.stdout });
+        rl.on('line', (line) => {
+            try {
+                const parsed = JSON.parse(line);
+                const event = streamEventToCommandEvent(parsed, attempt);
+                if (event)
+                    job.eventBuffer.push(event);
+            }
+            catch {
+                // JSON でないか壊れている行 — 無視
+            }
+        });
+    }
+    // stderr: 蓄積（認証エラー検出用。上限5000字で先頭を切り落とす）
+    if (proc.stderr) {
+        proc.stderr.on('data', (chunk) => {
+            job.stderrBuf += chunk.toString('utf8');
+            if (job.stderrBuf.length > 5000) {
+                job.stderrBuf = job.stderrBuf.slice(-3000);
+            }
+        });
+    }
+    // 終了検出
+    proc.on('exit', (code, signal) => {
+        job.completed = true;
+        job.exitCode = code;
+        job.exitSignal = signal?.toString() ?? null;
+    });
+    return job;
+}
+/**
+ * 子プロセスを停止する。SIGTERM → 猶予 → SIGKILL。
+ * プロセスが既に終わっていれば何もしない。
+ */
+export async function stopJob(job) {
+    if (job.completed)
+        return;
+    const proc = job.process;
+    proc.kill('SIGTERM');
+    // 猶予の間に終了するのを待つ
+    const died = await Promise.race([
+        new Promise((resolve) => {
+            proc.once('exit', () => resolve(true));
+        }),
+        new Promise((resolve) => {
+            setTimeout(() => resolve(false), HEADLESS_KILL_GRACE_MS);
+        }),
+    ]);
+    if (!died && !job.completed) {
+        proc.kill('SIGKILL');
+        // SIGKILL は必ず効くので短く待つ
+        await new Promise((resolve) => {
+            const t = setTimeout(resolve, 1000);
+            proc.once('exit', () => {
+                clearTimeout(t);
+                resolve();
+            });
+        });
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// イベント送信
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 管制の events API へイベントを送る。
+ * POST /api/conductor/commands/{commandId}/events
+ */
+export async function sendCommandEvents(cfg, commandId, events) {
+    if (events.length === 0)
+        return true;
+    try {
+        const res = await fetch(`${cfg.url}/api/conductor/commands/${commandId}/events`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${cfg.token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ events }),
+            signal: AbortSignal.timeout(RELAY_FETCH_TIMEOUT_MS),
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/** バッファに溜まったイベントを管制へ送り、バッファを空にする。 */
+export async function flushEvents(cfg, job) {
+    if (job.eventBuffer.length === 0)
+        return;
+    const events = job.eventBuffer.splice(0);
+    job.lastFlushAt = Date.now();
+    // 送信失敗は握り潰す（最善努力。進捗が欠けても作業は止まらない）。
+    await sendCommandEvents(cfg, job.commandId, events);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 実行中ジョブの監視
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 実行中のジョブを1tick分チェックする。
+ * 完了・停止・タイムアウト・生存通知・イベントフラッシュを処理する。
+ */
+async function checkRunningJob(cfg, state) {
+    const job = state.job;
+    if (job === null)
+        return;
+    const rs = state.relay;
+    // ── 完了したプロセスの後始末 ──
+    if (job.completed) {
+        await flushEvents(cfg, job);
+        if (job.stopped) {
+            // stop_requested で止めた
+            await sendCommandEvents(cfg, job.commandId, [{
+                    type: 'stopped',
+                    text: `stop_requested により停止 (exit=${job.exitCode}, signal=${job.exitSignal})`,
+                    at: new Date().toISOString(),
+                    attempt: job.attempt,
+                }]);
+            state.job = null;
+            rs.lastHeartbeatAt = null;
+            log(`site=${cfg.site} id=${job.commandId} stop_requested で停止`);
+            return;
+        }
+        if (isAuthError(job)) {
+            // 認証エラー → 再試行しない
+            await sendCommandEvents(cfg, job.commandId, [{
+                    type: 'auth_error',
+                    text: maskSecrets(`認証エラー (exit=${job.exitCode}): ${job.stderrBuf.slice(0, 300)}`).slice(0, EVENT_TEXT_MAX),
+                    at: new Date().toISOString(),
+                    attempt: job.attempt,
+                }]);
+            // ★patchStatus は 'failed' を受け付けないので、放棄だけして中央の stalled/timeout に委ねる。
+            rs.abandoned.add(job.commandId);
+            state.job = null;
+            rs.lastHeartbeatAt = null;
+            log(`WARN site=${cfg.site} id=${job.commandId} 認証エラー → 再試行しない`);
+            return;
+        }
+        if (job.exitCode === 0) {
+            // 正常終了 → 完了を中央へ報告
+            const ok = await completeWithReport(cfg, job.commandId, log);
+            if (ok) {
+                log(`site=${cfg.site} id=${job.commandId} 完了（exit=0, attempt ${job.attempt}）`);
+            }
+            else {
+                // 報告を書けなかった場合でも status=done だけは書く
+                await patchStatus(cfg, job.commandId, 'done');
+                log(`site=${cfg.site} id=${job.commandId} 完了（exit=0, 報告なし）`);
+            }
+            state.job = null;
+            rs.lastHeartbeatAt = null;
+            return;
+        }
+        // 異常終了 → 次の tick で自動再開を試みる
+        await sendCommandEvents(cfg, job.commandId, [{
+                type: 'error',
+                text: maskSecrets(`異常終了 (exit=${job.exitCode}, signal=${job.exitSignal}): ${job.stderrBuf.slice(0, 300)}`).slice(0, EVENT_TEXT_MAX),
+                at: new Date().toISOString(),
+                attempt: job.attempt,
+            }]);
+        const nextAttempt = (state.attempts.get(job.commandId) ?? job.attempt) + 1;
+        if (nextAttempt > HEADLESS_MAX_ATTEMPTS) {
+            log(`WARN site=${cfg.site} id=${job.commandId} 試行回数上限(${HEADLESS_MAX_ATTEMPTS}) → 放棄`);
+            rs.abandoned.add(job.commandId);
+        }
+        else {
+            log(`WARN site=${cfg.site} id=${job.commandId} 異常終了(exit=${job.exitCode}) → ` +
+                `次の tick で再開を試みます (attempt ${nextAttempt}/${HEADLESS_MAX_ATTEMPTS})`);
+        }
+        state.job = null;
+        rs.lastHeartbeatAt = null;
+        return;
+    }
+    // ── 実行中のプロセスの監視 ──
+    const now = Date.now();
+    // stop_requested の確認（間隔を置いて中央へ問い合わせる）
+    if (now - job.lastStopCheckAt >= HEADLESS_STOP_CHECK_MS) {
+        job.lastStopCheckAt = now;
+        const status = await fetchCommandStatus(cfg, job.commandId);
+        if (status === 'stop_requested' || isTerminalCommandStatus(status)) {
+            log(`site=${cfg.site} id=${job.commandId} ${status} → SIGTERM`);
+            job.stopped = true;
+            await stopJob(job);
+            return;
+        }
+    }
+    // タイムアウト
+    if (now - job.startedAt > RELAY_PENDING_TIMEOUT_MS) {
+        log(`WARN site=${cfg.site} id=${job.commandId} タイムアウト(${Math.round((now - job.startedAt) / 1000)}s) → SIGTERM`);
+        job.stopped = true;
+        await stopJob(job);
+        return;
+    }
+    // 生存ハートビート
+    const throttleOk = rs.lastHeartbeatAt === null || now - rs.lastHeartbeatAt >= RELAY_HEARTBEAT_INTERVAL_MS;
+    if (throttleOk) {
+        rs.lastHeartbeatAt = now;
+        await sendHeartbeat(cfg, job.commandId, true);
+    }
+    // イベントバッファのフラッシュ
+    if (now - job.lastFlushAt >= HEADLESS_EVENT_FLUSH_MS && job.eventBuffer.length > 0) {
+        await flushEvents(cfg, job);
+    }
+    // 可観測性
+    noteReadiness(rs, 'busy', job.commandId);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// PC 再起動後の孤児復元
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * sent孤児を1件取得し、--resume で再開する（起動時1回）。
+ *
+ * PC 再起動後、「やっています(sent)」のまま残った便を中央から見つけ、
+ * 決定的なセッション ID（conductor-{commandId}）で resume する。
+ * Claude Code はセッションを ~/.claude/ に保存するので、同じセッション ID で
+ * 再開すれば前回の途中から続けられる。
+ *
+ * ★tmux 方式の restoreOrphans と同じ呼び出し経路（fetchOrphans → selectOrphanToRestore）
+ *   を使う。headless では復元 = 即座に子プロセスを起動する（tmux のように pending に積んで待つ
+ *   のではなく、直接 resume する）。
+ */
+export async function restoreHeadlessOrphans(cfg, state) {
+    if (!RELAY_RESTORE_ORPHANS_ENABLED)
+        return;
+    if (state.job !== null)
+        return; // 既にジョブ実行中
+    const orphans = await fetchOrphans(cfg);
+    const pick = selectOrphanToRestore(orphans, null);
+    if (pick === null)
+        return;
+    const sessionId = sessionIdForCommand(pick.id);
+    const attempt = (state.attempts.get(pick.id) ?? 0) + 1;
+    state.attempts.set(pick.id, attempt);
+    if (attempt > HEADLESS_MAX_ATTEMPTS) {
+        state.relay.abandoned.add(pick.id);
+        log(`WARN site=${cfg.site} id=${pick.id} 孤児復元: 試行回数上限 → 放棄`);
+        return;
+    }
+    // ★孤児は resume で再開する（元の指示本文ではなく続行プロンプトを渡す）。
+    const cmd = { id: pick.id, body: pick.body };
+    const job = spawnClaudeProcess(cfg, cmd, sessionId, attempt, true);
+    state.job = job;
+    markDelivered(state.relay, pick.id);
+    state.relay.lastHeartbeatAt = null;
+    noteReadiness(state.relay, 'delivered', pick.id);
+    await sendCommandEvents(cfg, pick.id, [{
+            type: 'resumed',
+            text: `孤児復元: attempt ${attempt}/${HEADLESS_MAX_ATTEMPTS} (PC再起動後の自動再開)`,
+            at: new Date().toISOString(),
+            attempt,
+        }]);
+    log(`site=${cfg.site} id=${pick.id} ` +
+        `孤児を復元して再開しました (session=${sessionId}, attempt ${attempt}/${HEADLESS_MAX_ATTEMPTS})`);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// headless tick（relayTick の headless 版）
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * headless 方式の1tick。relayTick の代わりに createRelayRunner へ渡す。
+ *
+ * 【共通の管制通信】fetchControl, fetchCommand, patchStatus は relay.ts のものをそのまま使う。
+ * 【違い】配達は tmux ではなく子プロセスの起動。完了検出はプロセスの終了。
+ */
+export async function headlessTick(cfg, state, hooks) {
+    const rs = state.relay;
+    if (rs.running)
+        return;
+    rs.running = true;
+    rs.promptPending = false;
+    try {
+        // ── 起動時1回の孤児復元（PC再起動後の拾い直し） ──
+        // cli.ts を触らず「起動時1回」を実現するため、最初の tick でだけ復元する。
+        // 失敗しても再試行しない（フラグを先に立てる＝起動を妨げない／多重実行防止）。
+        if (!state.restored) {
+            state.restored = true;
+            await restoreHeadlessOrphans(cfg, state);
+        }
+        // ── 実行中のジョブの監視 ──
+        if (state.job !== null) {
+            await checkRunningJob(cfg, state);
+            return; // ジョブ実行中は新規取得しない
+        }
+        // ── 管制との線を確かめる ──
+        const ctl = await fetchControl(cfg);
+        if (!ctl.ok) {
+            log(noteCentralDown(rs, ctl.detail, Date.now()));
+            return;
+        }
+        const reconnected = noteCentralUp(rs, Date.now());
+        if (reconnected !== null) {
+            log(reconnected);
+            rs.lastHeartbeatAt = null;
+            hooks?.onCentralReconnect?.();
+        }
+        // ── 停止フラグ確認 ──
+        const haltedBySite = ctl.relayEnabled === false;
+        if (ctl.relayHalted || haltedBySite) {
+            if (rs.lastHalted !== true) {
+                log(haltedBySite
+                    ? `この現場(${cfg.site})の relay送信トグルがOFF(停止)のため送信しません`
+                    : 'relay停止中(緊急停止スイッチON)のため送信しません');
+            }
+            rs.lastHalted = true;
+            noteReadiness(rs, 'halted', null);
+            return;
+        }
+        if (rs.lastHalted === true) {
+            log('停止が解除されました。relayを再開します');
+        }
+        rs.lastHalted = false;
+        // ── 新規指示の取得 ──
+        const cmd = await fetchCommand(cfg);
+        if (!cmd) {
+            noteReadiness(rs, 'no-command', null);
+            return;
+        }
+        // ── 放棄ガード ──
+        if (rs.abandoned.has(cmd.id))
+            return;
+        // ── 配達回数上限 ──
+        if (!canDeliver(rs, cmd.id)) {
+            rs.abandoned.add(cmd.id);
+            log(`WARN site=${cfg.site} id=${cmd.id} 配達回数上限(${RELAY_DELIVER_MAX}) → 以後配達しない`);
+            return;
+        }
+        // ── 試行回数 ──
+        const attempt = (state.attempts.get(cmd.id) ?? 0) + 1;
+        state.attempts.set(cmd.id, attempt);
+        if (attempt > HEADLESS_MAX_ATTEMPTS) {
+            rs.abandoned.add(cmd.id);
+            log(`WARN site=${cfg.site} id=${cmd.id} 試行回数上限(${HEADLESS_MAX_ATTEMPTS}) → 放棄`);
+            return;
+        }
+        // ── claude -p を起動 ──
+        const sessionId = sessionIdForCommand(cmd.id);
+        const isResume = attempt > 1;
+        const job = spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume);
+        state.job = job;
+        markDelivered(rs, cmd.id);
+        rs.lastHeartbeatAt = null;
+        noteReadiness(rs, 'delivered', cmd.id);
+        // ★管制へ配達の印を書く
+        await patchStatus(cfg, cmd.id, 'sent');
+        if (isResume) {
+            await sendCommandEvents(cfg, cmd.id, [{
+                    type: 'resumed',
+                    text: `attempt ${attempt}/${HEADLESS_MAX_ATTEMPTS} (自動再開)`,
+                    at: new Date().toISOString(),
+                    attempt,
+                }]);
+        }
+        log(`site=${cfg.site} id=${cmd.id} ` +
+            `${isResume ? '再開' : '起動'}しました (session=${sessionId}, attempt ${attempt}/${HEADLESS_MAX_ATTEMPTS})`);
+    }
+    finally {
+        rs.running = false;
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 状態の生成とアダプタ
+// ─────────────────────────────────────────────────────────────────────────────
+/** headless 用の初期状態を作る。内包する RelayState は createRelayState() で作る。 */
+export function createHeadlessState() {
+    return {
+        relay: createRelayState(),
+        job: null,
+        attempts: new Map(),
+        restored: false,
+    };
+}
+/**
+ * headless 方式の配達状況を生存報告用に返す（cli.ts の sendReport が使う）。
+ * RelayState の deliveryReport をそのまま返す。
+ */
+export function headlessDeliveryReport(state) {
+    return deliveryReport(state.relay);
+}
+/** headless 方式の次の tick までの待ち(ms)。cli.ts の適応スケジューラが使う。 */
+export function headlessNextDelayMs(state, intervalSec) {
+    const rs = state.relay;
+    // 管制へつながらない間は再試行の間隔（指数バックオフ）
+    if (rs.central.failures > 0) {
+        return reconnectDelayMs(rs.central.failures);
+    }
+    // ジョブ実行中はイベントフラッシュ間隔で早く回す
+    if (state.job !== null) {
+        return Math.min(intervalSec * 1000, HEADLESS_EVENT_FLUSH_MS);
+    }
+    // 通常間隔
+    return intervalSec * 1000;
+}
+/** 環境変数から runner mode を読む。未設定・不明な値は 'tmux'（既定・後退させない）。 */
+export function parseRunnerMode(raw) {
+    const v = (raw ?? '').trim().toLowerCase();
+    if (v === 'headless')
+        return 'headless';
+    return 'tmux';
+}

package/dist/relay.js

@@ -1697,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）。
@@ -1712,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) {
@@ -1732,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 が送信として受け付けたとは限らない
@@ -1938,7 +2110,7 @@ export async function awaitDeliveryAck(d, o = {
             reason = '職人がアイドルでないので貼り直さなかった';
             continue; // この回は貼り直さずに、もう一度だけ印を待つ（回数は数える＝待ちは有限）
         }
-        if (d.repaste()) {
+        if (await d.repaste()) {
             repasted++;
             reason = '';
         }
@@ -1956,23 +2128,8 @@ export async function awaitDeliveryAck(d, o = {
  * ★押し直してよいのは「こちらが入れた便が入力欄に残っている」ときだけ、を確かめるために使う。
  */
 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;
-        }
-    }
-    if (start < 0)
-        return false;
-    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').includes('（配達役より）');
+    const block = inputBlock(cap);
+    return block !== null && block.includes('（配達役より）');
 }
 // ───────────────────────────────────────────────────────────────────────────
 // 1便1context：配る直前に職人の会話を新しくする（便 87a1a28a・★既定オフ）
@@ -1989,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 {
@@ -2025,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;
@@ -3118,7 +3277,25 @@ export async function relayTick(cfg, state, hooks) {
         const sendStartedAt = Date.now();
         // ★Claude の職人へは受領確認を使う（便 7d810bbb）。Codex は会話の記録の形が違うので今までどおり。
         const useAck = kindOf(cfg) === 'claude';
-        if (!sendToTmux(cfg.site, text)) {
+        // ★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}`);
@@ -3148,13 +3325,21 @@ export async function relayTick(cfg, state, hooks) {
         // 新しい指示の生存ハートビートは先頭から数え直す（前指示のスロットルを引き継がない）。
         state.lastHeartbeatAt = null;
         noteReadiness(state, 'delivered', cmd.id);
-        log(`site=${cfg.site} id=${cmd.id} 配達しました`);
+        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 以降）に新しく出た記録だけ。
@@ -3177,8 +3362,9 @@ export async function relayTick(cfg, state, hooks) {
                     }
                 },
                 idle: () => isIdleStable(cfg.site, kindOf(cfg)),
-                // ★同じ本文をそのまま貼り直す（配達回数は数えない＝1回の配達の中の貼り直し）。
-                repaste: () => sendToTmux(cfg.site, text),
+                // ★同じ本文を貼り直す（配達回数は数えない＝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}`}` +

package/package.json

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