@tyhld/conductor 0.12.53 → 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/package.json

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