@tyhld/conductor 0.12.71 → 0.12.73

package/dist/cli.js

@@ -16,6 +16,7 @@ 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 { runViewCommand } from './view.js';
 import { createRelayRunner } from './relay-runner.js';
 import { installProcessGuards } from './process-guard.js';
 import { registerNudgeTarget, unregisterNudgeTarget, watchNudges, } from './nudge.js';
@@ -468,6 +469,12 @@ function printUsage() {
         '  conductor ear                                                     この機に1本の「耳」（合図の受け取り役）',
         '  conductor build-runner                                            この機に1本の「司令塔」（試作の段取り役）',
         '  conductor setup <現場名> [フォルダ] [--profile <default|proto>]     采配くんをこのPCに設置する（初回の1回だけ）',
+        '  conductor view <現場名> [--detail]                                 その現場の今を見るだけの画面（kc の実体）',
+        '',
+        '見るだけの画面（conductor view ＝ kc 現場名）:',
+        '  いま職人が何をしているかを、やさしい日本語で見るだけの画面です。',
+        '  ★職人（Claude Code）・tmux・relay を起動しません。入力も受け付けません（抜けるだけ）。',
+        '  --detail を付けると、職人の生の記録（秘密は隠したもの）も続けて出します。',
         '',
         '設置の型（--profile。既定は default＝今までどおり）:',
         '  default  ふつうの現場。従来と同じ設定を置きます。',
@@ -545,6 +552,10 @@ async function main() {
             // ★引数はそのまま setup.sh へ渡す（judgement は全部インストーラ側）。
             runSetupCommand(process.argv.slice(3));
             break;
+        case 'view':
+            // ★見るだけの画面。職人も tmux も relay も起動せず、入力も受け付けない。
+            process.exit(runViewCommand(process.argv.slice(3)));
+            break;
         case 'version':
         case '-v':
         case '--version':

package/dist/headless.js

@@ -36,6 +36,31 @@ export const HEADLESS_EVENT_FLUSH_MS = 2_000;
 export const HEADLESS_STOP_CHECK_MS = 15_000;
 /** イベントの text フィールドの上限(文字)。 */
 export const EVENT_TEXT_MAX = 500;
+/** 記録1行から取り出すイベントの上限(件)。1行に content が大量に入っていても溢れさせない。 */
+export const EVENT_MAX_PER_LINE = 8;
+/** 1つの便で管制へ送るイベントの上限(件)。これを超えた分は捨てる（生の記録の全量は外へ出さない）。 */
+export const EVENT_MAX_PER_JOB = 2_000;
+/**
+ * 工程の区切りの1行を拾う印（職人の鉄則が出す形）。
+ * 例: `進捗: 既存の画面構成を確認しました` → 「既存の画面構成を確認しました」
+ * ★全角コロンも受ける（日本語入力のままでも通る形にする）。
+ */
+export const PROGRESS_MARKER_RE = /^\s*進捗\s*[:：]\s*(.+)$/;
+/**
+ * 職人の発言から「工程の区切りの1行」を取り出す。印が無ければ null。
+ * ★複数行の発言の中に印の行があれば、最初の1本だけを拾う。
+ */
+export function extractProgressLine(text) {
+    for (const line of text.split('\n')) {
+        const m = PROGRESS_MARKER_RE.exec(line);
+        if (m) {
+            const body = m[1].trim();
+            if (body.length > 0)
+                return body;
+        }
+    }
+    return null;
+}
 /** resume 時に職人へ渡す続行指示。 */
 const RESUME_PROMPT = '前回の作業の続きを行ってください。中断された箇所から再開してください。';
 /** 実行ログの保存先ルート。 */
@@ -70,6 +95,25 @@ export function resolveGitOrigin(workDir) {
         return null;
     }
 }
+/**
+ * その番号のプロセスが今も動いているかを OS に聞く。
+ *
+ * ★signal 0 は「送らずに存在と権限だけ確かめる」。動いていれば例外なし、
+ *   居なければ ESRCH で例外。番号が無い（起動に失敗した）ときは動いていない扱い。
+ * ★「作業中」と出してよいかの判定にこれを使う（えふさん確定 2026-10-02）。
+ */
+export function isProcessAlive(pid) {
+    if (typeof pid !== 'number' || !Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // EPERM = 居るが自分のものではない。ここでは「居る」として扱う。
+        return err?.code === 'EPERM';
+    }
+}
 /** 実行中のジョブをファイルに書く（中継が死んでも拾い直せるように）。 */
 export function saveActiveJob(site, record) {
     try {
@@ -89,6 +133,38 @@ export function clearActiveJob(site) {
     }
     catch { /* ignore */ }
 }
+/** 現場ごとの「直前に終わった仕事」の記録ファイルのパスを返す。 */
+export function lastJobPath(site) {
+    return path.join(ACTIVE_JOB_DIR, `last-job-${site}.json`);
+}
+/** 直前に終わった仕事を書く。失敗しても作業は止めない。 */
+export function saveLastJob(site, record) {
+    try {
+        mkdirSync(ACTIVE_JOB_DIR, { recursive: true });
+        writeFileSync(lastJobPath(site), JSON.stringify(record) + '\n');
+    }
+    catch (err) {
+        log(`WARN last-job の保存に失敗: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/** 直前に終わった仕事を読む。無ければ null。 */
+export function loadLastJob(site) {
+    try {
+        const p = lastJobPath(site);
+        if (!existsSync(p))
+            return null;
+        const raw = readFileSync(p, 'utf8').trim();
+        if (!raw)
+            return null;
+        const rec = JSON.parse(raw);
+        if (!rec.commandId)
+            return null;
+        return rec;
+    }
+    catch {
+        return null;
+    }
+}
 /** 起動時に前回の実行中ジョブを読む。無ければ null。 */
 export function loadActiveJob(site) {
     try {
@@ -288,30 +364,124 @@ export function sessionIdForCommand(commandId, attempt = 1) {
     const hex = attempt.toString(16).padStart(4, '0');
     return commandId.slice(0, -4) + hex;
 }
-/** stream-json の1行を CommandEvent に変換する。無関係な行は null。 */
-export function streamEventToCommandEvent(parsed, attempt) {
+/**
+ * 操作1件を人が読める1行にする。
+ *
+ * ★出どころは職人が書く説明文（description）を第一とする（便 fbaba4b1 のえふさん確定）。
+ *   description が無い道具（Read / Grep / Skill など）は、道具の名前と、
+ *   秘密を含まないと決めた項目（対象のファイル・探す語）だけを添える。
+ * ★生のコマンド文字列（input.command）は添えない。全量を PC の外へ出さないため。
+ */
+export function toolUseLabel(name, input) {
+    const desc = typeof input?.description === 'string' ? input.description.trim() : '';
+    if (desc.length > 0)
+        return desc;
+    for (const key of ['file_path', 'path', 'notebook_path', 'pattern', 'skill', 'subagent_type']) {
+        const v = input?.[key];
+        if (typeof v === 'string' && v.trim().length > 0)
+            return `${name}: ${v.trim()}`;
+    }
+    return name;
+}
+/**
+ * 記録の中の「文字か、文字の配列か、text ブロックの配列」を1本の文字列にする。
+ * tool_result の content と、result 行の errors（★実物は素の文字列の配列）の両方に使う。
+ */
+function flattenText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((b) => {
+            if (typeof b === 'string')
+                return b;
+            if (typeof b === 'object' && b !== null)
+                return String(b.text ?? '');
+            return '';
+        })
+            .filter((s) => s.length > 0)
+            .join('\n');
+    }
+    return '';
+}
+/** 秘密を隠して上限で切った CommandEvent を作る。中身が空なら null。 */
+function makeEvent(type, raw, at, attempt) {
+    const text = maskSecrets(raw.trim()).slice(0, EVENT_TEXT_MAX);
+    if (text.length === 0)
+        return null;
+    return { type, text, at, attempt };
+}
+/**
+ * stream-json の1行から CommandEvent を取り出す。無関係な行は空配列。
+ *
+ * 【実物の形（2026-10-02 この現場の便 fbaba4b1 の attempt-1.jsonl で実測）】
+ *   ★`type:'assistant'` に subtype は無く、中身は `message.content` の配列。
+ *     配列の要素は `{type:'text',text}` / `{type:'thinking'}` / `{type:'tool_use',name,input}`。
+ *   ★`type:'user'` も `message.content` の配列で、`{type:'tool_result',is_error,content}` が入る。
+ *   ★`type:'result'` は `subtype:'success'`（result 項目あり）か
+ *     `subtype:'error_during_execution'`（★result 項目が無く errors がある）。
+ *
+ * 【なぜ直したか】以前はここが `type:'assistant' && subtype:'text'` を見ていた。
+ *   実物にその形は1件も無いため、1便のあいだ送れていたのは最後の result 1件だけで、
+ *   管制から「いま何をしているか」が消えていた（＝画面なし方式にした時の退行）。
+ *
+ * 【1行から複数件出る】1つの assistant 行に発言と操作が同時に入るので、配列を返す。
+ */
+export function streamEventsFromLine(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)
+    const out = [];
+    const push = (e) => {
+        if (e !== null && out.length < EVENT_MAX_PER_LINE)
+            out.push(e);
+    };
+    const content = (() => {
+        const msg = parsed.message;
+        if (typeof msg !== 'object' || msg === null)
             return null;
-        return { type: 'progress', text: maskSecrets(text), at: now, attempt };
+        const c = msg.content;
+        return Array.isArray(c) ? c : null;
+    })();
+    if (type === 'assistant' && content !== null) {
+        for (const block of content) {
+            if (block?.type === 'text') {
+                const text = String(block.text ?? '');
+                // ★工程の区切りの印が在ればその1行だけを送る（人向けの表示はこれを使う）。
+                const marked = extractProgressLine(text);
+                push(makeEvent('progress', marked ?? text, now, attempt));
+            }
+            else if (block?.type === 'tool_use') {
+                const input = typeof block.input === 'object' && block.input !== null
+                    ? block.input
+                    : undefined;
+                push(makeEvent('tool', toolUseLabel(String(block.name ?? 'unknown'), input), now, attempt));
+            }
+            // thinking は送らない（人向けの表示に使わないうえ、量が多い）。
+        }
+        return out;
     }
-    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 === 'user' && content !== null) {
+        for (const block of content) {
+            // ★失敗した操作だけを送る。成功した操作の生出力は量が多く、外へ出す必要もない。
+            if (block?.type === 'tool_result' && block.is_error === true) {
+                push(makeEvent('error', flattenText(block.content), now, attempt));
+            }
+        }
+        return out;
     }
     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 };
+        if (parsed.is_error === true || subtype === 'error_during_execution') {
+            // ★error_during_execution には result 項目が無い。errors を使う。
+            const text = String(parsed.result ?? '') || flattenText(parsed.errors) || `失敗しました (${subtype ?? 'result'})`;
+            push(makeEvent('error', text, now, attempt));
         }
-        const resultText = String(parsed.result ?? '').slice(0, EVENT_TEXT_MAX);
-        return { type: 'result', text: maskSecrets(resultText), at: now, attempt };
+        else {
+            push(makeEvent('result', String(parsed.result ?? ''), now, attempt));
+        }
+        return out;
     }
-    return null;
+    return out;
 }
 /**
  * stream-json の1行から認証エラーを検出する。
@@ -372,14 +542,22 @@ export function isAuthError(job) {
 // ─────────────────────────────────────────────────────────────────────────────
 // 実行ログ
 // ─────────────────────────────────────────────────────────────────────────────
-/** 実行ログのディレクトリを作り、stdout / stderr の WriteStream を返す。 */
+/** 人向けの進捗の記録ファイルのパスを返す（`kc 現場名` の通常表示が読む）。 */
+export function eventsLogPath(commandId, attempt) {
+    return path.join(RUNS_DIR, commandId, `attempt-${attempt}.events.jsonl`);
+}
+/** 実行ログのディレクトリを作り、stdout / stderr / 進捗 の WriteStream を返す。 */
 function openRunLogs(commandId, attempt) {
     try {
         const dir = path.join(RUNS_DIR, commandId);
         mkdirSync(dir, { recursive: true });
         const stdoutLog = createWriteStream(path.join(dir, `attempt-${attempt}.jsonl`), { flags: 'a' });
         const stderrLog = createWriteStream(path.join(dir, `attempt-${attempt}.stderr.log`), { flags: 'a' });
-        return { stdoutLog, stderrLog };
+        // ★生の記録には時刻が入っていない（実測 2026-10-02: assistant 行の項目は
+        //   message/parent_tool_use_id/session_id/type/uuid だけ）。時刻つきの流れを出すには
+        //   拾った側で時刻を刻んで残すしかない。ここには秘密を隠して上限で切った物だけを書く。
+        const eventsLog = createWriteStream(eventsLogPath(commandId, attempt), { flags: 'a' });
+        return { stdoutLog, stderrLog, eventsLog };
     }
     catch (err) {
         log(`WARN 実行ログのディレクトリを作れません: ${err instanceof Error ? err.message : String(err)}`);
@@ -427,6 +605,7 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
     delete env.ANTHROPIC_API_KEY;
     env.CONDUCTOR_SITE = cfg.site;
     env.CONDUCTOR_MACHINE = cfg.machine;
+    env.CONDUCTOR_WORK_DIR = cfg.workDir;
     // ★テスト用: CONDUCTOR_CLAUDE_CONFIG_DIR を設定すると、claude の設定フォルダを差し替える。
     //   本物のログインを壊さずに認証エラーを再現できる（空のフォルダを指す → not logged in）。
     //   本番では設定しない（claude は既定の ~/.claude を使う）。
@@ -473,12 +652,15 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
         stopped: false,
         timedOut: false,
         eventBuffer: [],
+        eventsSent: 0,
+        lastActivityAt: Date.now(),
         lastFlushAt: Date.now(),
         lastStopCheckAt: Date.now(),
         stderrBuf: '',
         authErrorDetected: false,
         stdoutLog: logs?.stdoutLog ?? null,
         stderrLog: logs?.stderrLog ?? null,
+        eventsLog: logs?.eventsLog ?? null,
         durationMs: 0,
     };
     // spawn の 'error' イベント（ENOENT 等は非同期で届く。同期例外と両方捕まえる）
@@ -509,15 +691,23 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
         const rl = createInterface({ input: proc.stdout });
         rl.on('line', (line) => {
             job.stdoutLog?.write(line + '\n');
+            // ★記録が1行出たこと自体が「手が動いている」印。管制の「作業中」判定に使う。
+            job.lastActivityAt = Date.now();
             try {
                 const parsed = JSON.parse(line);
                 // ★stream-json から認証エラーを検出（stderr に出ない実物に対応）
                 if (!job.authErrorDetected && detectStreamAuthError(parsed)) {
                     job.authErrorDetected = true;
                 }
-                const event = streamEventToCommandEvent(parsed, attempt);
-                if (event)
+                for (const event of streamEventsFromLine(parsed, attempt)) {
+                    // ★1便あたりの件数に上限を持つ（生の記録の全量は PC の外へ送らない）。
+                    if (job.eventsSent >= EVENT_MAX_PER_JOB)
+                        break;
+                    job.eventsSent += 1;
                     job.eventBuffer.push(event);
+                    // 時刻つきで手元にも残す（`kc 現場名` の通常表示がこれを読む）。
+                    job.eventsLog?.write(JSON.stringify(event) + '\n');
+                }
             }
             catch {
                 // JSON でないか壊れている行 — 無視
@@ -543,6 +733,7 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
         job.durationMs = Date.now() - job.startedAt;
         closeLog(job.stdoutLog);
         closeLog(job.stderrLog);
+        closeLog(job.eventsLog);
     });
     return job;
 }
@@ -626,7 +817,20 @@ async function checkRunningJob(cfg, state) {
     // ── 完了したプロセスの後始末 ──
     if (job.completed) {
         await flushEvents(cfg, job);
+        // ★消す前に本文を取る（`kc 現場名` が「直前の仕事」を出すために残す）。
+        const savedBody = loadActiveJob(cfg.site)?.body ?? '';
         clearActiveJob(cfg.site);
+        const noteLastJob = (outcome, detail) => {
+            saveLastJob(cfg.site, {
+                commandId: job.commandId,
+                body: savedBody,
+                outcome,
+                startedAt: job.startedAt,
+                finishedAt: Date.now(),
+                attempt: job.attempt,
+                ...(detail !== undefined ? { detail } : {}),
+            });
+        };
         if (job.timedOut) {
             // 上限時間で強制停止した → 管制へ理由つきで failed を記録する
             const elapsed = Math.round((Date.now() - job.startedAt) / 1000);
@@ -639,6 +843,7 @@ async function checkRunningJob(cfg, state) {
                 }]);
             await patchStatus(cfg, job.commandId, 'failed', reason.slice(0, EVENT_TEXT_MAX));
             rs.abandoned.add(job.commandId);
+            noteLastJob('timeout', reason);
             state.job = null;
             rs.lastHeartbeatAt = null;
             log(`WARN site=${cfg.site} id=${job.commandId} ${reason}`);
@@ -652,6 +857,7 @@ async function checkRunningJob(cfg, state) {
                     at: new Date().toISOString(),
                     attempt: job.attempt,
                 }]);
+            noteLastJob('stopped', '管制から止めました');
             state.job = null;
             rs.lastHeartbeatAt = null;
             log(`site=${cfg.site} id=${job.commandId} stop_requested で停止`);
@@ -672,6 +878,7 @@ async function checkRunningJob(cfg, state) {
             // ★中央へ failed を返す（次の便が止まらないように）
             await patchStatus(cfg, job.commandId, 'failed', authMsg);
             rs.abandoned.add(job.commandId);
+            noteLastJob('auth_error', authMsg);
             state.job = null;
             rs.lastHeartbeatAt = null;
             log(`WARN site=${cfg.site} id=${job.commandId} 認証エラー → 再試行しない`);
@@ -688,6 +895,7 @@ async function checkRunningJob(cfg, state) {
                 await patchStatus(cfg, job.commandId, 'done');
                 log(`site=${cfg.site} id=${job.commandId} 完了（exit=0, 報告なし）`);
             }
+            noteLastJob('done', ok ? '報告まで出しました' : '報告は出せませんでした');
             state.job = null;
             rs.lastHeartbeatAt = null;
             return;
@@ -713,6 +921,7 @@ async function checkRunningJob(cfg, state) {
                     attempt: job.attempt,
                 }]);
             rs.abandoned.add(job.commandId);
+            noteLastJob('failed', failReason);
         }
         else {
             // ★ pendingRetry に詰めて、次の tick で実際に spawn する（fetchCommand は sent を返さない）
@@ -746,11 +955,20 @@ async function checkRunningJob(cfg, state) {
         await stopJob(job);
         return;
     }
-    // 生存ハートビート
+    // ── 生存ハートビート ──
+    // ★「実プロセスが動いている間だけ」送る（えふさん確定 2026-10-02）。
+    //   job.completed は exit イベントで立つが、exit が届く前に OS 上のプロセスが
+    //   消えていることがある。だから OS に直接聞いて、動いていなければ送らない。
+    //   送らなければ中央の lastSeenAt が止まり、管制は「作業中」と出せなくなる。
+    const alive = isProcessAlive(job.process.pid);
     const throttleOk = rs.lastHeartbeatAt === null || now - rs.lastHeartbeatAt >= RELAY_HEARTBEAT_INTERVAL_MS;
-    if (throttleOk) {
+    if (alive && throttleOk) {
         rs.lastHeartbeatAt = now;
-        await sendHeartbeat(cfg, job.commandId, true);
+        await sendHeartbeat(cfg, job.commandId, true, {
+            startedAt: new Date(job.startedAt).toISOString(),
+            lastActivityAt: new Date(job.lastActivityAt).toISOString(),
+            ...(job.process.pid !== undefined ? { pid: job.process.pid } : {}),
+        });
     }
     // イベントバッファのフラッシュ
     if (now - job.lastFlushAt >= HEADLESS_EVENT_FLUSH_MS && job.eventBuffer.length > 0) {
@@ -831,6 +1049,7 @@ export async function restoreHeadlessOrphans(cfg, state) {
             return;
         }
         log(`site=${cfg.site} id=${saved.commandId} 手元の記録から孤児を検出（中継再起動後の拾い直し）`);
+        const postedAt = saved.postedAt;
         const pick = { id: saved.commandId, body: saved.body, site: cfg.site, sentAt: saved.startedAt };
         const attempt = saved.attempt + 1;
         state.attempts.set(pick.id, attempt);
@@ -851,7 +1070,7 @@ export async function restoreHeadlessOrphans(cfg, state) {
             return;
         }
         state.job = job;
-        saveActiveJob(cfg.site, { commandId: pick.id, body: pick.body, sessionId, attempt, startedAt: Date.now(), site: cfg.site, machine: cfg.machine, workDir: cfg.workDir, gitOrigin: resolveGitOrigin(cfg.workDir) ?? undefined });
+        saveActiveJob(cfg.site, { commandId: pick.id, body: pick.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 });
         markDelivered(state.relay, pick.id);
         state.relay.lastHeartbeatAt = null;
         noteReadiness(state.relay, 'delivered', pick.id);
@@ -915,7 +1134,7 @@ export async function restoreHeadlessOrphans(cfg, state) {
         return;
     }
     state.job = job;
-    saveActiveJob(cfg.site, { commandId: pick.id, body: pick.body, sessionId, attempt, startedAt: Date.now(), site: cfg.site, machine: cfg.machine, workDir: cfg.workDir, gitOrigin: resolveGitOrigin(cfg.workDir) ?? undefined });
+    saveActiveJob(cfg.site, { commandId: pick.id, body: pick.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: pick.sentAt });
     markDelivered(state.relay, pick.id);
     state.relay.lastHeartbeatAt = null;
     noteReadiness(state.relay, 'delivered', pick.id);
@@ -1009,7 +1228,7 @@ export async function headlessTick(cfg, state, hooks) {
                 return;
             }
             state.job = job;
-            saveActiveJob(cfg.site, { commandId: retry.cmd.id, body: retry.cmd.body, sessionId, attempt: retry.attempt, startedAt: Date.now(), site: cfg.site, machine: cfg.machine, workDir: cfg.workDir, gitOrigin: resolveGitOrigin(cfg.workDir) ?? undefined });
+            saveActiveJob(cfg.site, { commandId: retry.cmd.id, body: retry.cmd.body, sessionId, attempt: retry.attempt, startedAt: Date.now(), site: cfg.site, machine: cfg.machine, workDir: cfg.workDir, gitOrigin: resolveGitOrigin(cfg.workDir) ?? undefined, pid: job.process.pid });
             rs.lastHeartbeatAt = null;
             noteReadiness(rs, 'delivered', retry.cmd.id);
             await sendCommandEvents(cfg, retry.cmd.id, [{
@@ -1066,7 +1285,7 @@ export async function headlessTick(cfg, state, hooks) {
             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 });
+        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);
         rs.lastHeartbeatAt = null;
         noteReadiness(rs, 'delivered', cmd.id);

package/dist/relay.js

@@ -204,6 +204,17 @@ export const BUSY_GLYPHS = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '
 export function kindOf(cfg) {
     return cfg.agentKind ?? 'claude';
 }
+/** 中央が返した日時らしい値を ms に直す。読めないときは undefined。 */
+export function parseSentAt(raw) {
+    if (typeof raw === 'number' && Number.isFinite(raw) && raw > 0)
+        return raw;
+    if (typeof raw === 'string' && raw.trim().length > 0) {
+        const t = Date.parse(raw);
+        if (Number.isFinite(t) && t > 0)
+            return t;
+    }
+    return undefined;
+}
 /**
  * 確定判断の件数と字数の上限（★中央 ai-kana の DISPATCH_CONTEXT_LIMITS と同じ値にすること）。
  * 中央が守っているが、配り役でも同じ上限で守る（受け取った物が多すぎても本文を太らせない）。
@@ -2375,6 +2386,10 @@ export async function fetchCommand(cfg) {
             return null;
         }
         const cmd = { id: String(first.id), body: first.body };
+        // ★投函の時刻は中央が返したときだけ受け取る（無ければ付けない＝画面で断定しない）。
+        const sentAt = parseSentAt(first.sentAt) ?? parseSentAt(first.createdAt);
+        if (sentAt !== undefined)
+            cmd.sentAt = sentAt;
         // ★親の便・確定判断は、中央が返した物だけを形を確かめて受け取る（違う形は捨てる）。
         if (typeof first.parentCommandId === 'string' && first.parentCommandId.trim()) {
             cmd.parentCommandId = first.parentCommandId.trim();
@@ -2669,7 +2684,7 @@ export function decideHeartbeat(alive, throttleOk) {
  *   （＝/seen の perm 系）。画面から質問を読む処理ごと撤去したため、送るのは body 無しの生存通知だけ。
  *   確認そのものは PermissionRequest フックが別の口（hook-requests）でデータとして届ける。
  */
-export async function sendHeartbeat(cfg, id, busy = false) {
+export async function sendHeartbeat(cfg, id, busy = false, liveness) {
     try {
         // ★busy が【真偽値の true】のときだけ body を載せる。それ以外は今までと1バイトも変えない
         //   （body 無しの PATCH）。中央も "true" や 1 のような真偽値でない値は無視する仕様。
@@ -2677,7 +2692,7 @@ export async function sendHeartbeat(cfg, id, busy = false) {
             ? {
                 method: 'PATCH',
                 headers: { ...authHeaders(cfg), 'Content-Type': 'application/json' },
-                body: JSON.stringify({ busy: true }),
+                body: JSON.stringify({ busy: true, ...(liveness ?? {}) }),
             }
             : { method: 'PATCH', headers: authHeaders(cfg) };
         const res = await fetch(`${cfg.url}/api/conductor/commands/${encodeURIComponent(id)}/seen`, {