@tyhld/conductor 0.12.77 → 0.12.79

package/dist/cli.js

@@ -15,7 +15,7 @@ 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 { createHeadlessState, headlessNextDelayMs, headlessTick, headlessTrackedCommandIds, parseRunnerMode, } from './headless.js';
 import { runViewCommand } from './view.js';
 import { createRelayRunner } from './relay-runner.js';
 import { installProcessGuards } from './process-guard.js';
@@ -30,6 +30,13 @@ import { BUILD_NUDGE_NAME, REQUIRED_ENV, createBuildRunner, createMemoStore, loa
  *   ★relay が無効な機では null のまま＝報告の中身は今までと1バイトも変わらない。
  */
 let relayStateForReport = null;
+/**
+ * 画面なし方式の状態の参照（★回収の道から「いま追っている便」を除くため・便 6ebba0d0）。
+ *   画面なし方式では実行中の便は headless の state.job に在り、relay.pending には入らない。
+ *   relay.pending だけを見ていたので除外が常に空になり、職人が報告を置いた直後に
+ *   報告が先に渡ってしまっていた。★画面あり方式では null のまま＝今までと同じ。
+ */
+let headlessStateForReport = null;
 /** git コマンドを安全に実行し、失敗したら null を返す（git でない/未インストール等）。 */
 function git(args) {
     try {
@@ -225,8 +232,14 @@ async function sendReport(cfg) {
     // ★未処理の報告ファイルの本文を中央へ届ける（便 79840008）。受け取られた物だけ処理済みにする（消さない）。
     //   ★配達役がいま追っている便の報告は送らない（完了の道が完了と一緒に渡すため）。
     if (pending.ids.length > 0) {
+        // 画面あり方式の除外（pending.id）は今までどおり。
         const tracking = relayStateForReport?.pending?.id;
-        await sendPendingReportFiles(cfg, { exclude: tracking ? [tracking] : [], rejectCounts: reportRejectCounts });
+        const exclude = tracking ? [tracking] : [];
+        // ★画面なし方式は、実行中の便（state.job）と再開待ちの便（pendingRetry）も除く。
+        if (headlessStateForReport !== null) {
+            exclude.push(...headlessTrackedCommandIds(headlessStateForReport));
+        }
+        await sendPendingReportFiles(cfg, { exclude, rejectCounts: reportRejectCounts });
     }
 }
 /** `conductor start`: 起動直後に1回 + 以後 intervalSec ごとに報告し続ける。 */
@@ -276,8 +289,6 @@ async function start(args) {
     //     ポーリングの間隔はこれまでどおり（15秒/承認待ち3秒）。耳が死んでいる間の保険として残す。
     let relayRunner = null;
     let nudgeWatcher = null;
-    // ★headless 方式の状態参照（sendReport のアダプタ用）。tmux のときは null のまま。
-    let headlessStateRef = null;
     if (cfg.relayEnabled) {
         if (cfg.runnerMode === 'headless') {
             // ── headless 方式（画面なし・便ごとに claude -p を起動する） ──
@@ -285,9 +296,10 @@ async function start(args) {
             console.log(`[headless] 有効: site=${cfg.site} mode=headless workDir=${workDir} ` +
                 `interval=${cfg.relayIntervalSec}s`);
             const hState = createHeadlessState();
-            headlessStateRef = hState;
             // 生存報告に「いま配れるか」を載せるため、内包する RelayState を参照する。
             relayStateForReport = hState.relay;
+            // ★回収の道から「いま追っている便」を除くための参照（便 6ebba0d0）。
+            headlessStateForReport = hState;
             const hCfg = { ...cfg, workDir };
             relayRunner = createRelayRunner({
                 tick: () => headlessTick(hCfg, hState, {

package/dist/headless.js

@@ -19,7 +19,7 @@ import { createInterface } from 'node:readline';
 import { createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
-import { CENTRAL_BUSY_HOLD_MAX_MS, RELAY_DELIVER_MAX, RELAY_FETCH_TIMEOUT_MS, RELAY_HEARTBEAT_INTERVAL_MS, RELAY_RESTORE_ORPHANS_ENABLED, buildAnchor, buildSendText, canDeliver, completeWithReport, createRelayState, deliveryReport, fetchCommand, fetchCommandStatus, fetchControl, fetchOrphans, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteReadiness, patchStatus, reconnectDelayMs, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
+import { CENTRAL_BUSY_HOLD_MAX_MS, RELAY_DELIVER_MAX, RELAY_FETCH_TIMEOUT_MS, RELAY_HEARTBEAT_INTERVAL_MS, RELAY_RESTORE_ORPHANS_ENABLED, buildAnchor, buildSendText, canDeliver, completeWithReport, createRelayState, deliveryReport, fetchCommand, fetchCommandStatus, fetchControl, fetchOrphans, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteReadiness, patchStatus, recoverStuckProcessedReports, reconnectDelayMs, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
 const log = (msg) => {
     console.log(`[headless] ${msg}`);
 };
@@ -34,6 +34,20 @@ export const HEADLESS_MAX_ATTEMPTS = 3;
 export const HEADLESS_EVENT_FLUSH_MS = 2_000;
 /** 実行中に stop_requested を確かめる間隔(ms)。 */
 export const HEADLESS_STOP_CHECK_MS = 15_000;
+/**
+ * 便の終了状態（done）を管制へ書き直す上限回数（★便 6ebba0d0・定数はここ1か所）。
+ *
+ * 【根拠】書けなかった便は畳まない＝その現場は次の便を配らない。だから上限は
+ *   「管制の短い不通なら必ず越えない／書けない便で現場を永久に塞がない」の両立で決める。
+ *   便を抱えている間の周回は min(relayIntervalSec, HEADLESS_EVENT_FLUSH_MS=2秒) ＝約2秒ごと。
+ *   300回 ≒ 約10分。ふつうの通信の途切れ（数秒〜数分）は必ず越えない一方、
+ *   どうしても書けない便（管制が消えた等）でも現場が塞がるのは約10分で終わる。
+ *   実障害（7969ea66）は人が気づくまで 9:08 → 10:49 の約1時間40分かかっていたので、
+ *   10分は十分短い。越えたときは黙って done にせず、理由つきで failed を書いて残す。
+ */
+export const HEADLESS_DONE_WRITE_MAX_TRIES = 300;
+/** 取り残しの後始末を回す間隔(ms)。★起動時は1回必ず回す（間隔の対象外）。 */
+export const HEADLESS_RECOVER_SWEEP_MS = 10 * 60 * 1000;
 /** イベントの text フィールドの上限(文字)。 */
 export const EVENT_TEXT_MAX = 500;
 /** 記録1行から取り出すイベントの上限(件)。1行に content が大量に入っていても溢れさせない。 */
@@ -259,6 +273,53 @@ export function validateActiveJobOwnership(rec, cfg) {
 // PATH に居ないため spawn('claude') が ENOENT で失敗する（実測 2026-10-01）。
 // conductor-run が node を探すのと同じ考え方で、既知の場所を順に探す。
 // ─────────────────────────────────────────────────────────────────────────────
+// ── Claude Code の版管理 ─────────────────────────────────────────────────
+//
+// 1台に複数の Claude Code が入っていると、古い方を使って通信の許可 "*" が
+// 効かない等の不具合が起きる（実測 2026-10-02 メインPC）。
+// 候補のうち実在する物の版を確かめ、いちばん新しい版を使う。
+// ─────────────────────────────────────────────────────────────────────────
+/**
+ * 必要な最低の版。これより古い Claude Code では職人を起動しない。
+ *
+ * 根拠: Claude Code 2.1.x 系で画面なし方式（-p, --output-format stream-json）と
+ * 通信の許可 "*"（allowedTools: "*"）が動くことが確かめられたのは太田さんの PC の
+ * 2.1.286（便 bcce7be9）。2.1.86 では "*" が効かない疑い（便 a9754912、メインPC）。
+ * 安全側に倒して 2.1.200 を最低とする（200 未満は "*" 対応が不明確な版）。
+ * ★確かめられた版は 2.1.286 だけなので、200 は推定の境界。
+ */
+export const CLAUDE_MIN_VERSION = '2.1.200';
+/** claude --version の出力から版番号を取り出す。取れなければ null。 */
+export function parseClaudeVersion(output) {
+    // "2.1.286 (Claude Code)" → "2.1.286"
+    const m = output.match(/(\d+\.\d+\.\d+)/);
+    return m ? m[1] : null;
+}
+/** 版番号を比べる。a > b なら正、a < b なら負、同じなら 0。 */
+export function compareVersions(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (diff !== 0)
+            return diff;
+    }
+    return 0;
+}
+/** claude の実行ファイルから版番号を取得する。取れなければ null。 */
+export function getClaudeVersion(binPath) {
+    try {
+        const out = execFileSync(binPath, ['--version'], {
+            timeout: 5_000,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        return parseClaudeVersion(out);
+    }
+    catch {
+        return null;
+    }
+}
 /** claude の実行ファイルの既知の候補を返す（新しい node の版から順）。 */
 function claudeBinCandidates() {
     const h = os.homedir();
@@ -293,27 +354,42 @@ function claudeBinCandidates() {
     return candidates;
 }
 /**
- * claude の実行ファイルのフルパスを返す。見つからなければ null。
+ * claude の実行ファイルのフルパスと版を返す。見つからなければ null。
  *
  * 探す順:
- *   1. 環境変数 CONDUCTOR_CLAUDE_BIN（テスト用の差し替え口）
- *   2. nvm の各 node 版の bin/claude（新しい版から）
- *   3. ~/.local/bin/claude
- *   4. ~/.claude/local/claude
- *   5. /usr/local/bin/claude, /usr/bin/claude
+ *   1. 環境変数 CONDUCTOR_CLAUDE_BIN（テスト用の差し替え口）→ 指定があればそれだけ
+ *   2. 候補のうち実在する物の版を確かめ、いちばん新しい版を使う
+ *   3. 版を確かめられない物は後回し（版が分かる物が1つもないときだけ使う）
  */
 export function resolveClaudeBin() {
     const override = process.env.CONDUCTOR_CLAUDE_BIN;
     if (override) {
-        if (existsSync(override))
-            return override;
+        if (!existsSync(override))
+            return null;
+        return { bin: override, version: getClaudeVersion(override) };
+    }
+    const existing = claudeBinCandidates().filter(c => existsSync(c));
+    if (existing.length === 0)
         return null;
+    // 版が分かる候補と分からない候補を分ける
+    const withVersion = [];
+    const withoutVersion = [];
+    for (const bin of existing) {
+        const ver = getClaudeVersion(bin);
+        if (ver) {
+            withVersion.push({ bin, version: ver });
+        }
+        else {
+            withoutVersion.push(bin);
+        }
     }
-    for (const candidate of claudeBinCandidates()) {
-        if (existsSync(candidate))
-            return candidate;
+    // 版が分かる候補の中でいちばん新しい物を選ぶ
+    if (withVersion.length > 0) {
+        withVersion.sort((a, b) => compareVersions(b.version, a.version));
+        return withVersion[0];
     }
-    return null;
+    // 版を確かめられない物だけ → 最初の候補を返す（後方互換）
+    return { bin: withoutVersion[0], version: null };
 }
 // ─────────────────────────────────────────────────────────────────────────────
 // 秘密のマスク
@@ -343,6 +419,24 @@ export function maskSecrets(text) {
     }
     return masked;
 }
+/**
+ * いま画面なし方式が追っている便の指示ID（★回収の道から除く物・便 6ebba0d0 の b）。
+ *
+ * 【なぜ要るか】30秒ごとの生存報告は、未処理の報告ファイルを「回収の道」
+ *   （POST /api/conductor/report/files・★この口は便を完了にしない）へ送る。
+ *   画面あり方式はそこで `relayState.pending.id` を除いていたが、画面なし方式では
+ *   実行中の便は `state.job` に在り `relay.pending` は一度も入らない＝除外が常に空だった。
+ *   そのため職人が報告を置いた直後（まだ動いている間）に報告が先に渡ってしまう。
+ * ★これは二重の守り。これが効かなくても completeWithReport だけで②③は通る。
+ */
+export function headlessTrackedCommandIds(state) {
+    const ids = [];
+    if (state.job !== null)
+        ids.push(state.job.commandId);
+    if (state.pendingRetry !== null)
+        ids.push(state.pendingRetry.cmd.id);
+    return ids;
+}
 // ─────────────────────────────────────────────────────────────────────────────
 // ヘルパー
 // ─────────────────────────────────────────────────────────────────────────────
@@ -692,15 +786,26 @@ function closeLog(ws) {
  * 【stdout】stream-json 形式。行ごとに JSON を出す。readline で1行ずつ読む。
  * 【stderr】蓄積して認証エラーの検出に使う。
  *
- * 【起動失敗】claude が見つからない（ENOENT）・実行権限がない（EACCES）などで
- *   spawn が失敗した場合、null を返す。呼び出し側はエラーイベントを管制へ送る。
+ * 【起動失敗】claude が見つからない（ENOENT）・実行権限がない（EACCES）・
+ *   版が古すぎるなどで起動しない場合、null を返す。呼び出し側はエラーイベントを管制へ送る。
+ *   失敗の理由は lastSpawnError に入る。
  */
+export let lastSpawnError = '';
 export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
-    const claudeBin = resolveClaudeBin();
-    if (claudeBin === null) {
-        log(`ERROR claude が見つかりません。探した場所: nvm の各版の bin, ~/.local/bin, ~/.claude/local, /usr/local/bin, /usr/bin`);
+    const resolved = resolveClaudeBin();
+    if (resolved === null) {
+        lastSpawnError = 'claude が見つかりません。探した場所: nvm の各版の bin, ~/.local/bin, ~/.claude/local, /usr/local/bin, /usr/bin';
+        log(`ERROR ${lastSpawnError}`);
         return null;
     }
+    const { bin: claudeBin, version: claudeVersion } = resolved;
+    // ── 最低版チェック ──
+    if (claudeVersion && compareVersions(claudeVersion, CLAUDE_MIN_VERSION) < 0) {
+        lastSpawnError = `Claude Code が古すぎます（${claudeBin} = ${claudeVersion}、最低 ${CLAUDE_MIN_VERSION}）。npm install -g @anthropic-ai/claude-code で更新してください`;
+        log(`ERROR ${lastSpawnError}`);
+        return null;
+    }
+    log(`claude bin=${claudeBin} version=${claudeVersion ?? 'unknown'}`);
     const env = { ...process.env };
     delete env.CLAUDECODE;
     delete env.ANTHROPIC_API_KEY;
@@ -762,6 +867,8 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
         sessionId,
         startedAt: Date.now(),
         attempt,
+        claudeBin,
+        claudeVersion,
         completed: false,
         exitCode: null,
         exitSignal: null,
@@ -934,7 +1041,9 @@ async function checkRunningJob(cfg, state) {
     if (job.completed) {
         await flushEvents(cfg, job);
         // ★消す前に本文を取る（`kc 現場名` が「直前の仕事」を出すために残す）。
-        const savedBody = loadActiveJob(cfg.site)?.body ?? '';
+        //   ★終了状態を書けずに持ち越した便は、次の周でも本文を失わないように覚えておく（便 6ebba0d0）。
+        const savedBody = loadActiveJob(cfg.site)?.body ?? job.savedBody ?? '';
+        job.savedBody = savedBody;
         clearActiveJob(cfg.site);
         const noteLastJob = (outcome, detail) => {
             saveLastJob(cfg.site, {
@@ -1001,19 +1110,43 @@ async function checkRunningJob(cfg, state) {
             return;
         }
         if (job.exitCode === 0) {
-            // 正常終了 → 完了を中央へ報告
-            const ok = await completeWithReport(cfg, job.commandId, log);
-            if (ok) {
+            // 正常終了 → 便の終了状態を管制へ確定させる。
+            // ★書けるまでやり直す（便 6ebba0d0）。以前は false のとき patchStatus を1回試し、
+            //   成否を見ずに state.job を畳んでいた＝誰も done を書いていないのに便を手放していた。
+            //   畳まない間は次の便を配らない／管制には生存報告と理由が残る。
+            if (await completeWithReport(cfg, job.commandId, log)) {
+                state.doneWriteTries?.delete(job.commandId);
                 log(`site=${cfg.site} id=${job.commandId} 完了（exit=0, attempt ${job.attempt}）`);
+                noteLastJob('done', '報告まで出しました');
+                state.job = null;
+                rs.lastHeartbeatAt = null;
+                return;
             }
-            else {
-                // 報告を書けなかった場合でも status=done だけは書く
-                await patchStatus(cfg, job.commandId, 'done');
-                log(`site=${cfg.site} id=${job.commandId} 完了（exit=0, 報告なし）`);
+            state.doneWriteTries ??= new Map();
+            const tries = (state.doneWriteTries.get(job.commandId) ?? 0) + 1;
+            state.doneWriteTries.set(job.commandId, tries);
+            if (tries < HEADLESS_DONE_WRITE_MAX_TRIES) {
+                // ★畳まない。次の tick でもう一度書く（★完了を落とさない）。
+                log(`WARN site=${cfg.site} id=${job.commandId} 便の終了状態を管制へ書けませんでした ` +
+                    `(${tries}/${HEADLESS_DONE_WRITE_MAX_TRIES}回目) → 畳まずに次の周でやり直します`);
+                return;
             }
-            noteLastJob('done', ok ? '報告まで出しました' : '報告は出せませんでした');
+            // 上限超え → 黙って done にせず、理由つきで残す（人が見て判断できる形）。
+            const reason = `便の終了状態を管制へ ${HEADLESS_DONE_WRITE_MAX_TRIES} 回書けませんでした` +
+                `（職人は exit=0 で終わっています。報告は手元の控えに残っています）`;
+            await patchStatus(cfg, job.commandId, 'failed', reason.slice(0, EVENT_TEXT_MAX));
+            await sendCommandEvents(cfg, job.commandId, [{
+                    type: 'error',
+                    text: reason.slice(0, EVENT_TEXT_MAX),
+                    at: new Date().toISOString(),
+                    attempt: job.attempt,
+                }]);
+            rs.abandoned.add(job.commandId);
+            state.doneWriteTries.delete(job.commandId);
+            noteLastJob('failed', reason);
             state.job = null;
             rs.lastHeartbeatAt = null;
+            log(`ERROR site=${cfg.site} id=${job.commandId} ${reason}`);
             return;
         }
         // 異常終了 → 次の tick で自動再開を試みる
@@ -1084,6 +1217,8 @@ async function checkRunningJob(cfg, state) {
             startedAt: new Date(job.startedAt).toISOString(),
             lastActivityAt: new Date(job.lastActivityAt).toISOString(),
             ...(job.process.pid !== undefined ? { pid: job.process.pid } : {}),
+            claudeBin: job.claudeBin,
+            ...(job.claudeVersion ? { claudeVersion: job.claudeVersion } : {}),
         });
     }
     // イベントバッファのフラッシュ
@@ -1180,7 +1315,7 @@ export async function restoreHeadlessOrphans(cfg, state) {
         const cmd = { id: pick.id, body: pick.body };
         const job = spawnClaudeProcess(cfg, cmd, sessionId, attempt, true);
         if (job === null) {
-            await patchStatus(cfg, pick.id, 'failed', 'claude が見つかりません（手元の孤児復元を中止）');
+            await patchStatus(cfg, pick.id, 'failed', `${lastSpawnError || 'claude が見つかりません'}（手元の孤児復元を中止）`);
             state.relay.abandoned.add(pick.id);
             log(`ERROR site=${cfg.site} id=${pick.id} 手元の孤児復元: claude が見つからない → 放棄`);
             return;
@@ -1238,10 +1373,10 @@ export async function restoreHeadlessOrphans(cfg, state) {
     const cmd = { id: pick.id, body: pick.body };
     const job = spawnClaudeProcess(cfg, cmd, sessionId, attempt, true);
     if (job === null) {
-        await patchStatus(cfg, pick.id, 'failed', 'claude が見つかりません（孤児復元を中止）');
+        await patchStatus(cfg, pick.id, 'failed', `${lastSpawnError || 'claude が見つかりません'}（孤児復元を中止）`);
         await sendCommandEvents(cfg, pick.id, [{
                 type: 'error',
-                text: 'claude が見つかりません（孤児復元を中止）',
+                text: `${lastSpawnError || 'claude が見つかりません'}（孤児復元を中止）`,
                 at: new Date().toISOString(),
                 attempt,
             }]);
@@ -1264,6 +1399,37 @@ export async function restoreHeadlessOrphans(cfg, state) {
         `孤児を復元して再開しました (session=${sessionId}, attempt ${attempt}/${HEADLESS_MAX_ATTEMPTS})`);
 }
 // ─────────────────────────────────────────────────────────────────────────────
+// 取り残しの後始末（便 6ebba0d0 の項目4）
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 「実プロセスが無い・報告は渡し済み・管制ではまだ終わっていない」便に done を書く。
+ *
+ * 【なぜ要るか】この便の直しより前に起きた取り残し（02b1e532 / 5db25cae / 7969ea66 と同じ形）は、
+ *   誰も done を書かないまま管制に残っている。人が手で完了にするまで次の便が始まらない。
+ *   中継が自分で気づいて、完了の道と同じ形で書き直す。
+ * 【★よそに書かない】見るのは自分の現場の控えだけ（控えの `site:` 欄で判定する）。
+ *   いま追っている便にも書かない。管制でまだ配られていない便（queued）にも書かない。
+ * 【間隔】state を渡したときは、起動時に1回＋以後 HEADLESS_RECOVER_SWEEP_MS ごと
+ *   （毎周 管制へ問い合わせると実行回数が増えるため）。state を渡さなければ必ず1回回す。
+ *
+ * 返り: done を書いた件数。
+ */
+export async function recoverStuckCommands(cfg, opts = {}) {
+    const now = opts.now ?? Date.now();
+    const state = opts.state;
+    if (state !== undefined) {
+        const last = state.lastRecoverAt ?? 0;
+        if (last > 0 && now - last < HEADLESS_RECOVER_SWEEP_MS)
+            return 0;
+        state.lastRecoverAt = now;
+    }
+    return recoverStuckProcessedReports(cfg, {
+        trackedIds: opts.trackedIds,
+        now,
+        logLine: log,
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
 // headless tick（relayTick の headless 版）
 // ─────────────────────────────────────────────────────────────────────────────
 /**
@@ -1319,6 +1485,11 @@ export async function headlessTick(cfg, state, hooks) {
             log('停止が解除されました。relayを再開します');
         }
         rs.lastHalted = false;
+        // ── 取り残しの後始末（★便 6ebba0d0 の項目4） ──
+        //   「実プロセスが無い・報告は渡し済み・管制ではまだ終わっていない」便に done を書く。
+        //   ★自分の PC・自分の現場の便だけ（判定は recoverStuckProcessedReports 側）。
+        //   ★停止トグルの確認より後に置く＝止められている現場では1バイトも書かない。
+        await recoverStuckCommands(cfg, { trackedIds: headlessTrackedCommandIds(state), state });
         // ── 異常終了後の自動再開（pendingRetry）──
         if (state.pendingRetry !== null) {
             const retry = state.pendingRetry;
@@ -1332,10 +1503,10 @@ export async function headlessTick(cfg, state, hooks) {
                 : sessionIdForCommand(retry.cmd.id, retry.attempt);
             const job = spawnClaudeProcess(cfg, retry.cmd, sessionId, retry.attempt, isResume);
             if (job === null) {
-                await patchStatus(cfg, retry.cmd.id, 'failed', 'claude が見つかりません（自動再開を中止）');
+                await patchStatus(cfg, retry.cmd.id, 'failed', `${lastSpawnError || 'claude が見つかりません'}（自動再開を中止）`);
                 await sendCommandEvents(cfg, retry.cmd.id, [{
                         type: 'error',
-                        text: 'claude が見つかりません（自動再開を中止）',
+                        text: `${lastSpawnError || 'claude が見つかりません'}（自動再開を中止）`,
                         at: new Date().toISOString(),
                         attempt: retry.attempt,
                     }]);
@@ -1389,10 +1560,10 @@ export async function headlessTick(cfg, state, hooks) {
         const job = spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume);
         if (job === null) {
             // ★起動失敗を管制へ知らせる（「起動しました」とは言わない）
-            await patchStatus(cfg, cmd.id, 'failed', 'claude が見つかりません（起動できませんでした）');
+            await patchStatus(cfg, cmd.id, 'failed', `${lastSpawnError || 'claude が見つかりません'}（起動できませんでした）`);
             await sendCommandEvents(cfg, cmd.id, [{
                     type: 'error',
-                    text: 'claude が見つかりません（起動できませんでした）',
+                    text: `${lastSpawnError || 'claude が見つかりません'}（起動できませんでした）`,
                     at: new Date().toISOString(),
                     attempt,
                 }]);
@@ -1433,6 +1604,8 @@ export function createHeadlessState() {
         attempts: new Map(),
         restored: false,
         pendingRetry: null,
+        doneWriteTries: new Map(),
+        lastRecoverAt: 0,
     };
 }
 /**

package/dist/relay.js

@@ -2458,32 +2458,51 @@ export async function patchStatus(cfg, id, status, report) {
  *   本文が来ないまま終わると「完了したが報告なし」だけが残った。報告はファイルにあるので、
  *   完了を送るその1回に必ず載せられる。
  *
- * 【★二重に送らない】職人が conductor_complete で先に完了させていたら、relay は何も送らない。
- *   中央へ1回だけ状態を尋ねて確かめる。尋ねられない（不通）ときは送る側に倒す
- *   ＝完了が落ちるより、同じ報告が2度書かれるほうが害が小さい（中央は上書き保存する）。
+ * 【★①②③は別の工程（えふさん確定 2026-10-02・便 6ebba0d0）】
+ *   ①報告を送る ／ ②便を終了状態へ確定する ／ ③次便を解放する は別の工程である。
+ *   ★①が既に済んでいても②③は必ず実行する。
+ *   【実障害 3件（02b1e532 / 5db25cae / 7969ea66）】画面なし方式では、職人が報告ファイルを
+ *     置いた直後（実プロセスはまだ生きている）に 30秒の周の「回収の道」
+ *     （POST /api/conductor/report/files・★この口は便を完了にしない）が報告を送り、
+ *     `processed/` へ移してしまう。その後 exit=0 でここが呼ばれても、以前の実装は
+ *     「処理済みなら、もう渡してある → 何もしない」で true を返していた。
+ *     ＝管制には誰も done を書かず、便は sent → stalled のまま残り、次の便が永久に始まらない。
+ *     （relay.ts の sendPendingReportFiles のコメントにこの落とし穴そのものが書いてあるが、
+ *       画面なし方式では除外が空になるため守られていなかった。）
+ *   だから【報告がどの段にあるか】と【便が終わっているか】を分けて見る。
+ *
+ * 【★二重完了にしない・開発履歴を2件にしない】
+ *   ・管制が「もう終わっている」と言う便には何も書かない（failed を done へ戻さない）。
+ *   ・報告が既に渡っている（処理済み）ときは、done だけを書いて本文は載せない
+ *     ＝同じ報告が開発履歴に2件並ばない。
  *
  * 【後片付け】管制へ書けたときだけ報告を【処理済み】にする（★消さない・2026-09-21）。
  *   書けなければ未処理のまま残す＝次tickでやり直せるし、管制も生存報告で気づける。
  *
- * 【★冪等（二重完了にしない）】報告が既に処理済みなら、この便はもう渡し終えている。
- *   中央へ問い合わせる前にそこで打ち切る＝MCP と報告ファイルの二経路から同じ便が来ても1回だけ扱う。
- * 返り: 追跡を畳んでよいか（true = 完了が確定した）。
+ * 返り: 追跡を畳んでよいか（true = 便の終了状態が確定した／false = 書けていない＝次の周でやり直す）。
  */
 export async function completeWithReport(cfg, id, logLine = log) {
-    // ★冪等の要: 処理済みの控えが在る＝この便はもう渡してある。何もしない（二重完了にしない）。
-    if (reportPhase(id) === 'processed') {
-        logLine(`site=${cfg.site} id=${id} の報告は処理済みです→送りません（二重完了にしない）`);
-        return true;
-    }
+    // ★①報告がどの段にあるか（送る工程の話）。②③の実行可否には使わない。
+    const phase = reportPhase(id);
+    // ★②便が終わっているか（確定の工程の話）。管制の真実だけを見る。
     const already = await fetchCommandStatus(cfg, id);
-    if (isTerminalCommandStatus(already)) {
-        // 職人が自分で完了させていた。★relay は二重に送らない（報告も上書きしない）。
-        //   ★控えは消さずに処理済みとして残す（MCP 経由でも同じ控えが残る・えふさん確定 2026-09-21）。
-        markReportProcessed(id);
-        logLine(`site=${cfg.site} id=${id} は職人が自分で完了させていた(status=${already})` +
+    if (isCentralFinished(already)) {
+        // 既に終端（職人の conductor_complete・人の操作・failed 等）。★何も書かない。
+        //   控えは消さずに処理済みとして残す（MCP 経由でも同じ控えが残る・えふさん確定 2026-09-21）。
+        if (phase === 'pending')
+            markReportProcessed(id);
+        logLine(`site=${cfg.site} id=${id} は管制で既に終わっています(status=${already})` +
             '→relayからは送りません（報告は控えとして処理済みにしました）');
         return true;
     }
+    if (phase === 'processed') {
+        // ★①は済み・②は未了。本文は渡してあるので、状態だけを書く（開発履歴を2件にしない）。
+        //   書けなければ false＝次の周でやり直す（完了を落とさない）。
+        if (!(await patchStatus(cfg, id, 'done')))
+            return false;
+        logLine(`site=${cfg.site} id=${id} done（報告は回収の道で渡し済み＝本文は添えない）`);
+        return true;
+    }
     const report = readReport(id);
     if (!(await patchStatus(cfg, id, 'done', report)))
         return false;
@@ -2493,6 +2512,98 @@ export async function completeWithReport(cfg, id, logLine = log) {
         (report !== null ? `（報告添付・${report.length}文字）` : '（報告ファイルなし＝完了のみ）'));
     return true;
 }
+/**
+ * 「実プロセスが無い・報告は渡し済み・管制ではまだ終わっていない」便に、便の終了状態だけを書く
+ * （★すでに起きている取り残しの後始末・便 6ebba0d0 の項目4）。
+ *
+ * 【どこから見つけるか】処理済みの控え（`processed/`）に自分の現場の報告が在るのに、管制では
+ *   まだ配達中（sent / running / delivering）の便。★控えの `site:` 欄が自分の現場の物だけを見る
+ *   ＝他の PC・他の現場の便には1バイトも書かない。
+ * 【なぜ queued を含めないか】queued はまだ誰にも配られていない＝この PC が完了にしてよい便ではない。
+ * 【なぜ failed を含めないか】failed を done へ戻さない（変えない決まり）。isCentralFinished が弾く。
+ *
+ * 返り: done を書いた件数。
+ */
+export async function recoverStuckProcessedReports(cfg, opts = {}) {
+    const logLine = opts.logLine ?? log;
+    const tracked = new Set(opts.trackedIds ?? []);
+    const ids = processedReportIds({
+        site: cfg.site,
+        env: opts.env,
+        limit: opts.limit ?? RECOVER_STUCK_LIMIT,
+        maxAgeMs: opts.maxAgeMs ?? RECOVER_STUCK_MAX_AGE_MS,
+        now: opts.now,
+    });
+    let written = 0;
+    for (const id of ids) {
+        if (tracked.has(id))
+            continue;
+        const status = await fetchCommandStatus(cfg, id);
+        if (status === null || !RECOVER_STUCK_STATUSES.has(status))
+            continue;
+        // ★完了の道と同じ形で書く（本文は渡し済みなので添えない）。
+        if (!(await patchStatus(cfg, id, 'done')))
+            continue;
+        written++;
+        logLine(`site=${cfg.site} id=${id} 取り残しの後始末: 報告は渡し済み・管制は ${status} のままだったので done を書きました`);
+    }
+    return written;
+}
+/** 後始末の対象にする便の状態（★配られた後の状態だけ。queued は含めない）。 */
+const RECOVER_STUCK_STATUSES = new Set(['sent', 'running', 'delivering']);
+/** 後始末で1回に見る控えの件数の上限。 */
+export const RECOVER_STUCK_LIMIT = 20;
+/** 後始末で見る控えの古さの上限（これより古い控えは見ない）。 */
+export const RECOVER_STUCK_MAX_AGE_MS = 48 * 60 * 60 * 1000;
+/**
+ * 処理済みの控え（`processed/`）のうち、指定の現場の物の指示IDを新しい順に返す。
+ *   ★控えの `site:` 欄が一致した物だけ（欄が無い古い形の控えは対象外＝よそに書かない安全側）。
+ */
+export function processedReportIds(opts) {
+    const now = opts.now ?? Date.now();
+    const maxAgeMs = opts.maxAgeMs ?? RECOVER_STUCK_MAX_AGE_MS;
+    const limit = Math.max(0, Math.floor(opts.limit ?? RECOVER_STUCK_LIMIT));
+    const found = new Map(); // 指示ID → 処理済みにした時刻(ms)
+    for (const dir of reportStoreDirs(opts.env)) {
+        let names;
+        try {
+            names = readdirSync(path.join(dir, PROCESSED_DIR));
+        }
+        catch {
+            continue;
+        }
+        for (const name of names) {
+            if (!name.endsWith('.md'))
+                continue;
+            const file = path.join(dir, PROCESSED_DIR, name);
+            let mtime;
+            try {
+                const st = statSync(file);
+                if (!st.isFile() || st.size === 0)
+                    continue;
+                mtime = st.mtimeMs;
+            }
+            catch {
+                continue;
+            }
+            if (now - mtime > maxAgeMs)
+                continue;
+            const raw = readIfFilled(file);
+            if (raw === null)
+                continue;
+            if (parseReport(raw).site !== opts.site)
+                continue;
+            const id = name.slice(0, -3);
+            const prev = found.get(id);
+            if (prev === undefined || mtime > prev)
+                found.set(id, mtime);
+        }
+    }
+    return [...found.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .map(([id]) => id)
+        .slice(0, limit);
+}
 /**
  * 指示 {id} 単体の現在 status を中央へ問う（外部完了検出の根治プローブ）。
  *   GET /api/conductor/commands/{id}（テナントトークン Bearer）。応答 JSON から status 文字列を拾う。

package/package.json

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