@tyhld/conductor 0.12.85 → 0.12.87

package/dist/cli.js

@@ -26,6 +26,7 @@ import { ensureEnvFilePermissions } from './env-file-perm.js';
 import { createCentralPorts } from './build-central.js';
 import { drainReport, readDrain } from './autoupdate-flags.js';
 import { runSelfcheckCommand } from './selfcheck.js';
+import { runAutoupdateCommand } from './autoupdate.js';
 import { BUILD_NUDGE_NAME, REQUIRED_ENV, createBuildRunner, createMemoStore, loadBuildRunnerConfig, } from './build-runner.js';
 /**
  * relay の状態の参照（生存報告に「いま配れるか」を載せるため）。
@@ -499,8 +500,9 @@ function printUsage() {
         '  conductor build-runner                                            この機に1本の「司令塔」（試作の段取り役）',
         '  conductor setup <現場名> [フォルダ] [--profile <default|proto>]     采配くんをこのPCに設置する（初回の1回だけ）',
         '  conductor view <現場名> [--once] [--detail]                        その現場の今を見るだけの画面（kc の実体）',
-        '  conductor selfcheck [--trigger <daily|after-conductor|after-claude|after-rollback|manual>] [--json] [--no-send]',
+        '  conductor selfcheck [--trigger <daily|after-conductor|after-claude|after-rollback|manual|candidate>] [--json] [--no-send]',
         '                                                                    この機の自己診断（副作用なし・結果は手元の控えと管制へ）',
+        '  conductor autoupdate [--boot]                                     自社PCの更新係（鍵が無い機では何もしない・systemd から呼ぶ）',
         '',
         '見るだけの画面（conductor view ＝ kc 現場名）:',
         '  いま職人が何をしているかを、やさしい日本語で見るだけの画面です。',
@@ -590,6 +592,10 @@ async function main() {
             // ★自己診断（便 b7bd5e43・A1）。副作用なし（commit・push・PR・合流・配備・公開をしない）。
             process.exit(await runSelfcheckCommand(process.argv.slice(3)));
             break;
+        case 'autoupdate':
+            // ★更新係（便 29babc5d・A3）。鍵（~/.tyhld/bin/autoupdate/enabled）が無い機では何もしない。
+            process.exit(await runAutoupdateCommand(process.argv.slice(3)));
+            break;
         case 'view':
             // ★見るだけの画面。職人も tmux も relay も起動せず、入力も受け付けない。
             //   既定は「開いたまま流れ続ける」ので、Ctrl+C まで戻らない（--once は1回で戻る）。

package/dist/headless.js

@@ -19,7 +19,7 @@ import { createInterface } from 'node:readline';
 import { createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, 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, noteDrain, noteReadiness, patchStatus, recoverStuckProcessedReports, 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, deliverJobEndFacts, deliveryReport, fetchCommand, fetchCommandStatus, fetchControl, fetchOrphans, flushPendingJobEndFacts, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteDrain, noteReadiness, patchStatus, recoverStuckProcessedReports, reconnectDelayMs, reportPhase, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
 import { claudePinPath, readClaudePinLine, } from './autoupdate-flags.js';
 const log = (msg) => {
     console.log(`[headless] ${msg}`);
@@ -528,6 +528,35 @@ export function maskSecrets(text) {
     }
     return masked;
 }
+/**
+ * 便の終わり方を決める（★純粋関数＝単体テストできる・便 915694ac）。
+ *
+ * ★本文を渡せなかったことが先。職人が何も受け取っていないという事実は、
+ *   ほかのどの終わり方よりも強い（やり直しても同じ結果になる）。
+ */
+export function jobEndKindOf(j) {
+    if (j.bodyHandoff === 'failed')
+        return 'not_started';
+    if (j.timedOut)
+        return 'timeout';
+    if (j.stopped)
+        return 'stopped';
+    if (j.authError)
+        return 'auth_error';
+    return j.exitCode === 0 ? 'completed' : 'error';
+}
+/**
+ * 本文を渡せなかった便として、走っている処理を止めるか（★純粋関数・便 915694ac）。
+ *
+ * ★画面なし方式は中継が自分で処理を立ち上げて本文を渡す。
+ *   ・'done'    … 渡せた → 何もしない（★本文未着と申告しない・追跡を続ける）
+ *   ・'pending' … まだ確かめ中 → 何もしない（迷ったら触らない）
+ *   ・'failed'  … 渡せなかった → 止めて理由つきで管制へ届ける
+ *   既に止めた便・上限時間で止めた便は、その終わり方の後始末に任せる。
+ */
+export function shouldAbortForBodyHandoff(j) {
+    return j.bodyHandoff === 'failed' && !j.stopped && !j.timedOut;
+}
 /**
  * いま画面なし方式が追っている便の指示ID（★回収の道から除く物・便 6ebba0d0 の b）。
  *
@@ -1003,6 +1032,8 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
         stderrLog: logs?.stderrLog ?? null,
         eventsLog: logs?.eventsLog ?? null,
         durationMs: 0,
+        finishedAt: null,
+        bodyHandoff: 'pending',
     };
     // spawn の 'error' イベント（ENOENT 等は非同期で届く。同期例外と両方捕まえる）
     proc.on('error', (err) => {
@@ -1010,22 +1041,46 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
             job.completed = true;
             job.exitCode = -1;
             job.exitSignal = null;
+            job.finishedAt = Date.now();
             job.stderrBuf += `\nspawn error: ${err.message}`;
         }
     });
     // stdin: 指示本文を書いて閉じる
+    //
+    // ★「渡せたか」を事実として残す（えふさん確定 2026-10-02・便 915694ac）。
+    //   これまでは stdin のエラーをまるごと握り潰していたので、本文を1バイトも渡せていなくても
+    //   中継は管制へ「配達済み(sent)」と書いていた＝職人が受け取っていない便を実行中にしていた。
+    //   逆に、渡せた便を「本文未着」と申告してしまう道も作らない（下の headlessTick を参照）。
+    const noteHandoffFailed = (why) => {
+        if (job.bodyHandoff === 'done')
+            return; // 既に書けている（閉じたあとの後始末のエラーは数えない）
+        job.bodyHandoff = 'failed';
+        job.bodyHandoffError ??= why;
+    };
     if (proc.stdin) {
-        // stdin の write エラーは spawn 失敗時に起きうる（握り潰す）
-        proc.stdin.on('error', () => { });
-        if (isResume) {
-            proc.stdin.write(RESUME_PROMPT);
+        // ★エラーは握り潰さず、理由として残す（投げると中継の輪が止まるので、throw はしない）。
+        proc.stdin.on('error', (err) => {
+            noteHandoffFailed(`職人の処理へ本文を渡せませんでした（標準入力: ${err.message}）`);
+        });
+        const text = isResume
+            ? RESUME_PROMPT
+            : buildSendText(cmd.body, cfg.site, buildAnchor(cmd.id), kindOf(cfg));
+        try {
+            // ★書き出しが本当に流れ切ってから 'done' にする（返事を待たずに「渡せた」と言わない）。
+            proc.stdin.write(text, (err) => {
+                if (err)
+                    noteHandoffFailed(`職人の処理へ本文を渡せませんでした（書き出し: ${err.message}）`);
+                else if (job.bodyHandoff === 'pending')
+                    job.bodyHandoff = 'done';
+            });
+            proc.stdin.end();
         }
-        else {
-            const anchor = buildAnchor(cmd.id);
-            const text = buildSendText(cmd.body, cfg.site, anchor, kindOf(cfg));
-            proc.stdin.write(text);
+        catch (err) {
+            noteHandoffFailed(`職人の処理へ本文を渡せませんでした（${err instanceof Error ? err.message : String(err)}）`);
         }
-        proc.stdin.end();
+    }
+    else {
+        noteHandoffFailed('職人の処理の入口（標準入力）が開かなかったので、本文を渡せませんでした');
     }
     // stdout: stream-json を行ごとに読み、CommandEvent に変換してバッファへ。ログファイルにも書く。
     if (proc.stdout) {
@@ -1071,6 +1126,7 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
         job.completed = true;
         job.exitCode = code;
         job.exitSignal = signal?.toString() ?? null;
+        job.finishedAt = Date.now();
         job.durationMs = Date.now() - job.startedAt;
         closeLog(job.stdoutLog);
         closeLog(job.stderrLog);
@@ -1174,6 +1230,42 @@ async function checkRunningJob(cfg, state) {
                 ...(detail !== undefined ? { detail } : {}),
             });
         };
+        // ★終了の事実を管制へ必ず届ける（えふさん確定 2026-10-02・便 915694ac）。
+        //
+        // 【えふさん確定】便ID付き報告が到着 ＋ Claude Code プロセス終了 ＋ 中継が終了結果を取得
+        //   まで揃ってはじめて「職人の作業終了」。だから中継は【終わり方に関係なく】終わった事実を届ける。
+        // 【ここ（分かれ道の手前）で1回だけ送る理由】終わり方ごとの枝の中で送ると、
+        //   ・終了状態を書けずに次の周へ持ち越す枝（下の done が書けないとき）では毎周送ってしまう
+        //   ・追跡をやめる枝（放棄・試行上限）では送り忘れる
+        //   の両方が起きる。★「プロセスが終わった」ことは枝に関係なく1つの事実なので、ここで1回送る。
+        // 【送る物】中継が実際に取れた物だけ（終了コードが無ければ null＝つかめていないと伝える）。
+        //   ★作り話の終了を送らない。「報告を出せたか」は報告ファイルの有無だけで見る
+        //     （★中身の言葉は1文字も読まない＝2026-09-23 の確定のまま）。
+        // 【届かなければ】控えが手元に残り、次の周の flushPendingJobEndFacts が届くまでやり直す。
+        if (!job.endFactsTold) {
+            job.endFactsTold = true;
+            const endKind = jobEndKindOf({
+                bodyHandoff: job.bodyHandoff,
+                timedOut: job.timedOut,
+                stopped: job.stopped,
+                authError: isAuthError(job),
+                exitCode: job.exitCode,
+            });
+            await deliverJobEndFacts(cfg, {
+                commandId: job.commandId,
+                site: cfg.site,
+                finishedAt: new Date(job.finishedAt ?? Date.now()).toISOString(),
+                endKind,
+                exitCode: job.exitCode,
+                exitSignal: job.exitSignal,
+                reportDelivered: reportPhase(job.commandId) !== 'none',
+                // ★画面なし方式は中継が自分で立ち上げた処理なので、終わりを直接つかんでいる。
+                //   つかめていないときは false を送る（1-3 の「つかめていない」と同じ形）。
+                processEndObserved: job.finishedAt !== null,
+                startedAt: new Date(job.startedAt).toISOString(),
+                detail: job.bodyHandoffError ?? `attempt ${job.attempt}/${HEADLESS_MAX_ATTEMPTS}`,
+            }, { logLine: log });
+        }
         if (job.timedOut) {
             // 上限時間で強制停止した → 管制へ理由つきで failed を記録する
             const elapsed = Math.round((Date.now() - job.startedAt) / 1000);
@@ -1302,6 +1394,28 @@ async function checkRunningJob(cfg, state) {
     }
     // ── 実行中のプロセスの監視 ──
     const now = Date.now();
+    // ★本文を渡せなかったことが後から分かったとき（便 915694ac）。
+    //   画面なし方式は中継が自分で処理を立ち上げて本文を渡す。渡せていなければ職人は何も
+    //   受け取っていないので、動いているふりをさせず、理由つきで管制へ届けて止める。
+    //   ★渡せた便（'done'）・まだ確かめ中の便（'pending'）には何もしない＝追跡を続ける。
+    if (shouldAbortForBodyHandoff(job)) {
+        const why = job.bodyHandoffError ?? '職人の処理へ本文を渡せませんでした';
+        log(`ERROR site=${cfg.site} id=${job.commandId} ${why} → 止めて管制へ知らせます`);
+        await patchStatus(cfg, job.commandId, 'failed', why.slice(0, EVENT_TEXT_MAX));
+        await sendCommandEvents(cfg, job.commandId, [{
+                type: 'error',
+                text: why.slice(0, EVENT_TEXT_MAX),
+                at: new Date().toISOString(),
+                attempt: job.attempt,
+            }]);
+        rs.abandoned.add(job.commandId);
+        // ★stopped を立ててから止める＝終了の後始末で「異常終了 → 自動再開」の道へ入らない
+        //   （本文が渡っていないので、同じことをやり直しても同じ結果になる。二重に走らせない）。
+        //   終わり方は 'not_started' として届く（上の endKind は本文の未渡しを先に見る）。
+        job.stopped = true;
+        await stopJob(job);
+        return;
+    }
     // stop_requested の確認（間隔を置いて中央へ問い合わせる）
     if (now - job.lastStopCheckAt >= HEADLESS_STOP_CHECK_MS) {
         job.lastStopCheckAt = now;
@@ -1603,6 +1717,10 @@ export async function headlessTick(cfg, state, hooks) {
             log('停止が解除されました。relayを再開します');
         }
         rs.lastHalted = false;
+        // ── 届いていない「終了の事実」の送り直し（★便 915694ac・黙って捨てない） ──
+        //   ★停止トグルの確認より後に置く＝止められている現場では外へ出ない。
+        //   ★追跡をやめた便・「本文未着」と申告された便の分も、ここで届くまでやり直す。
+        await flushPendingJobEndFacts(cfg, { logLine: log });
         // ── 取り残しの後始末（★便 6ebba0d0 の項目4） ──
         //   「実プロセスが無い・報告は渡し済み・管制ではまだ終わっていない」便に done を書く。
         //   ★自分の PC・自分の現場の便だけ（判定は recoverStuckProcessedReports 側）。
@@ -1695,6 +1813,35 @@ export async function headlessTick(cfg, state, hooks) {
             log(`ERROR site=${cfg.site} id=${cmd.id} claude が見つからない → 放棄`);
             return;
         }
+        // ★本文を渡せなかったことが起動のその場で分かったとき（入口が開かない・書き出しが例外）。
+        //   「配達済み(sent)」を1バイトも書かずに、理由つきで管制へ届けて放棄する（便 915694ac）。
+        //   ★渡せた便・まだ確かめ中の便は、今までどおりそのまま進む（追跡を続ける）。
+        if (job.bodyHandoff === 'failed') {
+            const why = job.bodyHandoffError ?? '職人の処理へ本文を渡せませんでした';
+            await stopJob(job);
+            await patchStatus(cfg, cmd.id, 'failed', why.slice(0, EVENT_TEXT_MAX));
+            await sendCommandEvents(cfg, cmd.id, [{
+                    type: 'error',
+                    text: why.slice(0, EVENT_TEXT_MAX),
+                    at: new Date().toISOString(),
+                    attempt,
+                }]);
+            await deliverJobEndFacts(cfg, {
+                commandId: cmd.id,
+                site: cfg.site,
+                finishedAt: new Date().toISOString(),
+                endKind: 'not_started',
+                exitCode: job.exitCode,
+                exitSignal: job.exitSignal,
+                reportDelivered: false,
+                processEndObserved: job.finishedAt !== null,
+                startedAt: new Date(job.startedAt).toISOString(),
+                detail: why,
+            }, { logLine: log });
+            rs.abandoned.add(cmd.id);
+            log(`ERROR site=${cfg.site} id=${cmd.id} ${why} → 放棄（配達済みとは書きません）`);
+            return;
+        }
         state.job = job;
         saveActiveJob(cfg.site, { commandId: cmd.id, body: cmd.body, sessionId, attempt, startedAt: Date.now(), site: cfg.site, machine: cfg.machine, workDir: cfg.workDir, gitOrigin: resolveGitOrigin(cfg.workDir) ?? undefined, pid: job.process.pid, postedAt: cmd.sentAt });
         markDelivered(rs, cmd.id);

package/dist/relay.js

@@ -2957,6 +2957,154 @@ export async function sendHeartbeat(cfg, id, busy = false, liveness) {
         log(`site=${cfg.site} id=${id} heartbeat -> 失敗: ${err instanceof Error ? err.message : String(err)}（縮退で安全）`);
     }
 }
+/** 届けられなかった「終了の事実」の置き場。 */
+export function jobEndDir(env = process.env) {
+    const base = (env.CONDUCTOR_STATE_DIR ?? '').trim();
+    return base
+        ? path.join(base, 'job-end')
+        : path.join(env.HOME ?? os.homedir(), '.local', 'state', 'conductor', 'job-end');
+}
+/** 1便ぶんの控えのファイル名（★現場と指示IDの両方を入れる＝別の現場の便と混ざらない）。 */
+export function jobEndFactsPath(site, commandId, env = process.env) {
+    const safe = (s) => s.replace(/[^A-Za-z0-9._-]/g, '_');
+    return path.join(jobEndDir(env), `${safe(site)}__${safe(commandId)}.json`);
+}
+/** 人向けの一言の上限（管制の列を汚さない）。 */
+const JOB_END_DETAIL_MAX = 500;
+/**
+ * 管制へ送る本文（★純粋関数＝単体テストできる）。
+ *
+ * ★`state` も `busy` も入れない（上の約束④）。
+ * ★項目名は管制の側の便（ai-kana）が読む物なので、勝手に変えない。
+ */
+export function jobEndFactsBody(f) {
+    const body = {
+        // ★この印が在る生存報告は「終わりの知らせ」。管制が知らないうちは黙って捨てられる。
+        jobEnded: true,
+        finishedAt: f.finishedAt,
+        endKind: f.endKind,
+        exitCode: f.exitCode,
+        exitSignal: f.exitSignal,
+        reportDelivered: f.reportDelivered,
+        processEndObserved: f.processEndObserved,
+    };
+    // ★立ち上がった時刻は管制が既に読める項目（startedAt）なので、分かるときだけ添える。
+    if (f.startedAt !== undefined)
+        body.startedAt = f.startedAt;
+    if (f.detail !== undefined && f.detail !== '')
+        body.jobEndDetail = f.detail.slice(0, JOB_END_DETAIL_MAX);
+    return body;
+}
+/** 控えを手元に書く（★届くまで消さない）。書けたか返す。 */
+export function saveJobEndFacts(f, env = process.env) {
+    try {
+        mkdirSync(jobEndDir(env), { recursive: true });
+        writeFileSync(jobEndFactsPath(f.site, f.commandId, env), JSON.stringify(f) + '\n');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 控えを消す（★届いたときだけ呼ぶ）。 */
+export function clearJobEndFacts(site, commandId, env = process.env) {
+    try {
+        const p = jobEndFactsPath(site, commandId, env);
+        if (existsSync(p))
+            unlinkSync(p);
+    }
+    catch {
+        // 消せなくても次の周でもう一度送るだけ（管制の側は冪等）。
+    }
+}
+/** その現場の、まだ届いていない「終了の事実」を読む（壊れた控えは飛ばす）。 */
+export function pendingJobEndFacts(site, env = process.env) {
+    const dir = jobEndDir(env);
+    let names;
+    try {
+        names = readdirSync(dir).filter((n) => n.endsWith('.json'));
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const n of names.sort()) {
+        try {
+            const raw = readFileSync(path.join(dir, n), 'utf8').trim();
+            if (!raw)
+                continue;
+            const f = JSON.parse(raw);
+            // ★自分の現場の便だけ送る（1台で複数の現場の中継が動くため）。
+            if (!f || f.site !== site || !f.commandId || !f.finishedAt)
+                continue;
+            out.push(f);
+        }
+        catch {
+            // 読めない控えは飛ばす（消さない＝人が見つけられるように残す）。
+        }
+    }
+    return out;
+}
+/**
+ * 「終了の事実」を管制へ1回送る。届いたら true。
+ * ★失敗は投げない（中継の輪を止めない）。false を返して、呼び出し側が控えを残す。
+ */
+export async function sendJobEndFacts(cfg, f, opts = {}) {
+    const doFetch = opts.fetchImpl ?? fetch;
+    const logLine = opts.logLine ?? (() => { });
+    try {
+        const res = await doFetch(`${cfg.url}/api/conductor/commands/${encodeURIComponent(f.commandId)}/seen`, {
+            method: 'PATCH',
+            headers: { Authorization: `Bearer ${cfg.token}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify(jobEndFactsBody(f)),
+            signal: AbortSignal.timeout(RELAY_FETCH_TIMEOUT_MS),
+        });
+        if (res.ok)
+            return true;
+        logLine(`site=${cfg.site} id=${f.commandId} 終了の事実 -> HTTP ${res.status}（控えを残して次の周でやり直します）`);
+        return false;
+    }
+    catch (err) {
+        logLine(`site=${cfg.site} id=${f.commandId} 終了の事実 -> 失敗: ` +
+            `${err instanceof Error ? err.message : String(err)}（控えを残して次の周でやり直します）`);
+        return false;
+    }
+}
+/**
+ * 「終了の事実」を控えに書いてから送る（★順番が肝）。
+ *   先に控えを書くので、送信中に中継が落ちても事実は失われない。送れたら控えを消す。
+ *   送れなければ残して、次の周の flushPendingJobEndFacts がやり直す。
+ */
+export async function deliverJobEndFacts(cfg, f, opts = {}) {
+    const env = opts.env ?? process.env;
+    saveJobEndFacts(f, env);
+    const ok = await sendJobEndFacts(cfg, f, opts);
+    if (ok) {
+        clearJobEndFacts(f.site, f.commandId, env);
+        opts.logLine?.(`site=${cfg.site} id=${f.commandId} 終了の事実を管制へ届けました` +
+            `（終わり方=${f.endKind} 終了コード=${f.exitCode ?? '不明'} 報告=${f.reportDelivered === null ? '不明' : f.reportDelivered ? 'あり' : 'なし'}）`);
+    }
+    return ok;
+}
+/** 届いていない「終了の事実」をまとめて送り直す（★1周に1回・届くまで何周でも）。 */
+export async function flushPendingJobEndFacts(cfg, opts = {}) {
+    const env = opts.env ?? process.env;
+    let sent = 0;
+    let kept = 0;
+    for (const f of pendingJobEndFacts(cfg.site, env)) {
+        if (await sendJobEndFacts(cfg, f, opts)) {
+            clearJobEndFacts(f.site, f.commandId, env);
+            sent++;
+        }
+        else {
+            kept++;
+        }
+    }
+    if (sent > 0 || kept > 0) {
+        opts.logLine?.(`site=${cfg.site} 終了の事実の送り直し: 届いた ${sent} 件・残り ${kept} 件`);
+    }
+    return { sent, kept };
+}
 /**
  * いま「作業中です」と手を挙げる（busy:true を載せる）かを決める純粋関数。
  *
@@ -3304,6 +3452,9 @@ export async function relayTick(cfg, state, hooks) {
         // pending 分岐も新規指示の取得も従来どおり動く（pending を落とす目的を殺さない）。
         // 停止中(relayHalted)でも続けるのは、既に送った指示の後始末は進めるという既存方針と同じ。
         await keepaliveTick(cfg, state);
+        // ── 届いていない「終了の事実」の送り直し（★便 915694ac・黙って捨てない） ──
+        //   既に送った便の後始末なので、停止中(relayHalted)でも続ける（keepaliveTick と同じ方針）。
+        await flushPendingJobEndFacts(cfg, { logLine: log });
         // ── 完了マーカー検出（pending があれば最優先・停止中でも継続） ──
         if (state.pending) {
             // ★この周の結末を「配った便の完了待ち」として記録する（案B-1）。ここで1回呼べば、
@@ -3338,6 +3489,23 @@ export async function relayTick(cfg, state, hooks) {
             if (state.pending.ack === 'missing') {
                 // ★本文未着と決めた便。職人は仕事を受け取っていないので、完了検出も生存通知もしない。
                 //   知らせを送れたら sendAckAtCentral が追跡をやめる。★配り直さない。
+                // ★終了の事実も同じ項目で届ける（便 915694ac・1-1「追跡をやめた便・本文未着と申告した便でも届ける」）。
+                //   画面へ貼る方式では実プロセスを中継が持っていないので、終わりは【つかめていない】と伝える
+                //   （processEndObserved:false・終了コードは null）。★作り話の終了を送らない。
+                if (!state.pending.endFactsTold) {
+                    state.pending.endFactsTold = true;
+                    await deliverJobEndFacts(cfg, {
+                        commandId: state.pending.id,
+                        site: cfg.site,
+                        finishedAt: new Date().toISOString(),
+                        endKind: 'not_started',
+                        exitCode: null,
+                        exitSignal: null,
+                        reportDelivered: reportPhase(state.pending.id) !== 'none',
+                        processEndObserved: false,
+                        detail: '配り役が本文未着と申告した便（職人の処理は中継が持っていない）',
+                    }, { logLine: log });
+                }
                 await sendAckAtCentral(cfg, state);
                 if (state.pending !== null && Date.now() - state.pending.sentAt > RELAY_PENDING_TIMEOUT_MS) {
                     // 管制へ知らせられないまま上限を過ぎた。★印も書けていなければ、管制は queued のまま返す
@@ -3365,6 +3533,20 @@ export async function relayTick(cfg, state, hooks) {
                     const report = notice.report.trim().length > 0 ? notice.report : null;
                     if (await patchStatus(cfg, state.pending.id, 'done', report)) {
                         log(`site=${cfg.site} id=${state.pending.id} done（Codexの通知${report != null ? '・報告添付' : ''}）`);
+                        // ★終了の事実を同じ項目で届ける（便 915694ac・1-3）。この配り方では実プロセスを
+                        //   中継が持っていないので、終わりは【つかめていない】と伝える（終了コードは null）。
+                        //   届けるのは「中継が完了を確かめた」という事実だけ。★作り話の終了を送らない。
+                        await deliverJobEndFacts(cfg, {
+                            commandId: state.pending.id,
+                            site: cfg.site,
+                            finishedAt: new Date().toISOString(),
+                            endKind: 'completed',
+                            exitCode: null,
+                            exitSignal: null,
+                            reportDelivered: report != null || reportPhase(state.pending.id) !== 'none',
+                            processEndObserved: false,
+                            detail: '配り役が完了の知らせで確かめた（職人の処理は中継が持っていない）',
+                        }, { logLine: log });
                         state.pending = null;
                     }
                     return;
@@ -3374,8 +3556,22 @@ export async function relayTick(cfg, state, hooks) {
             if (below !== null && hasStandaloneDone(below, cfg.site)) {
                 // ★報告は画面から読まない。職人が書いたファイルを読む（relayReportDirs / readReport）。
                 //   画面を読む方式は窓が 16〜34 行しかなく、9/5 以降 162 回すべて失敗していた（調査 d1d16a56）。
+                const reportThere = reportPhase(state.pending.id) !== 'none';
                 const ok = await completeWithReport(cfg, state.pending.id, log);
                 if (ok) {
+                    // ★終了の事実を同じ項目で届ける（便 915694ac・1-3）。画面へ貼る方式では実プロセスを
+                    //   中継が持っていないので、終わりは【つかめていない】と伝える（終了コードは null）。
+                    await deliverJobEndFacts(cfg, {
+                        commandId: state.pending.id,
+                        site: cfg.site,
+                        finishedAt: new Date().toISOString(),
+                        endKind: 'completed',
+                        exitCode: null,
+                        exitSignal: null,
+                        reportDelivered: reportThere,
+                        processEndObserved: false,
+                        detail: '配り役が画面の完了の合図で確かめた（職人の処理は中継が持っていない）',
+                    }, { logLine: log });
                     state.pending = null;
                 }
                 return; // sent 中は新規取得しない