@tyhld/conductor 0.12.72 → 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)}`);
@@ -474,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 等は非同期で届く。同期例外と両方捕まえる）
@@ -510,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 でないか壊れている行 — 無視
@@ -544,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;
 }
@@ -627,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);
@@ -640,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}`);
@@ -653,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 で停止`);
@@ -673,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} 認証エラー → 再試行しない`);
@@ -689,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;
@@ -714,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 を返さない）
@@ -747,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) {
@@ -832,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);
@@ -852,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);
@@ -916,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);
@@ -1010,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, [{
@@ -1067,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`, {

package/dist/view.js

@@ -0,0 +1,455 @@
+/**
+ * @tyhld/conductor — `kc 現場名` の「見るだけの画面」（便 fbaba4b1）。
+ *
+ * 【なぜ要るか】画面なし方式（headless）にしたことで、職人が「いま何をしているか」が
+ *   お客さまから見えなくなった。以前の `kc` は tmux と Claude Code を新しく起動するので、
+ *   画面なし方式の現場で打つと【仕事を受け取っていない空の職人】が開き、その裏では
+ *   別の職人が同じフォルダで作業している（実測 2026-10-02 メインPC）。
+ *   ＝「見えない」だけでなく「触ると危ない」状態だった。
+ *
+ * 【この画面の約束（えふさん確定 2026-10-02）】
+ *   ① 通常＝人間向けの日本語／詳細＝Claude Code の生ログ の2段構成。
+ *      以前の画面をそのまま流すのではなく、非エンジニアが読んで分かる形にする。
+ *   ② 「🟠 作業中」と出してよいのは、実プロセスが動いている ＋ 最近の作業記録がある
+ *      場合だけ。それ以外は 6 つの状態に明確に分ける（＝「便を出した＝作業開始」にしない）。
+ *   ③ 投函・開始・実作業は別々に持つ。
+ *
+ * 【何をしないか】Claude Code・tmux・中継を起動しない。管制へ通信しない。
+ *   入力も受け付けない（抜ける操作だけ）。★この画面は手元の記録を読むだけ。
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { RUNS_DIR, eventsLogPath, isProcessAlive, loadActiveJob, loadLastJob, maskSecrets, } from './headless.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// 定数
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 「最近の作業記録がある」と見なす上限(ms)。これを超えて記録が出ていなければ
+ * 実プロセスが動いていても「作業中」とは出さない（えふさん確定②）。
+ * ★長い1操作（試験の実行など）で記録が止まることがあるので、短くし過ぎない。
+ */
+export const STALE_ACTIVITY_MS = 5 * 60_000;
+/** 通常表示に出す「流れ」の行数の上限。 */
+export const FLOW_LINES_MAX = 20;
+/** 詳細表示に出す生ログの行数の上限。 */
+export const DETAIL_LINES_MAX = 200;
+/** 詳細表示の1行の長さの上限(文字)。生ログの1行は数千文字になるので切る。 */
+export const DETAIL_LINE_CHARS_MAX = 600;
+/** 画面に出す見出し（★文言はえふさん確定のまま）。 */
+export const STATUS_LABEL = {
+    working: '🟠 作業中',
+    queued: '⏳ 順番待ち',
+    pc_down: '💤 PC停止中',
+    unconfirmed: '🟡 未確認',
+    awaiting_user: '🔵 操作・確認待ち',
+    done: '✅ 完了',
+};
+/** その状態が何を意味するかの一言（非エンジニアが読む）。 */
+export const STATUS_NOTE = {
+    working: '職人が動いています',
+    queued: 'まだ職人を起動していません',
+    pc_down: 'このPCの見守り役が動いていません',
+    unconfirmed: '職人は止まった／終了しました（確認前です）',
+    awaiting_user: 'えふさんの手番です',
+    done: '終わりました',
+};
+/**
+ * 6つの状態のどれかを決める純粋関数（★「作業中」の条件を厳密にする所）。
+ *
+ * ★順番に意味がある。
+ *   1. 見守り役が止まっていれば、何も管制へ届かない＝💤。
+ *   2. えふさんの手番は、動いているかどうかより先に出す（人を待たせないため）。
+ *   3. 実行中の仕事があるときは、実プロセスと最近の記録の【両方】がそろって初めて 🟠。
+ *      そろわなければ 🟡（勝手に「作業中」と出さない）。
+ *   4. 実行中の仕事が無ければ、直前の結果が在れば ✅、無ければ ⏳。
+ */
+export function decideSiteStatus(input) {
+    if (input.relayRunning === false)
+        return 'pc_down';
+    if (input.awaitingUser)
+        return 'awaiting_user';
+    if (input.hasActiveJob) {
+        if (!input.processAlive)
+            return 'unconfirmed';
+        if (input.sinceActivityMs === null)
+            return 'unconfirmed';
+        if (input.sinceActivityMs > STALE_ACTIVITY_MS)
+            return 'unconfirmed';
+        return 'working';
+    }
+    if (input.hasLastJob)
+        return 'done';
+    return 'queued';
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 書式
+// ─────────────────────────────────────────────────────────────────────────────
+/** 時刻を「09:08」の形で出す。 */
+export function hhmm(ms) {
+    const d = new Date(ms);
+    return `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`;
+}
+/**
+ * 日時を「今日09:08」「昨日20:47」「9/28 11:02」の形で出す（非エンジニア向け）。
+ * ★基準の時刻を渡せるようにして、試験が時計に依存しないようにする。
+ */
+export function friendlyTime(ms, nowMs = Date.now()) {
+    const d = new Date(ms);
+    const startOfDay = (t) => {
+        const x = new Date(t);
+        x.setHours(0, 0, 0, 0);
+        return x.getTime();
+    };
+    const days = Math.round((startOfDay(nowMs) - startOfDay(ms)) / 86_400_000);
+    if (days === 0)
+        return `今日${hhmm(ms)}`;
+    if (days === 1)
+        return `昨日${hhmm(ms)}`;
+    return `${d.getMonth() + 1}/${d.getDate()} ${hhmm(ms)}`;
+}
+/** 経過時間を「26分」「2時間14分」の形で出す。 */
+export function friendlyDuration(durationMs) {
+    const total = Math.max(0, Math.floor(durationMs / 60_000));
+    if (total < 60)
+        return `${total}分`;
+    const h = Math.floor(total / 60);
+    const m = total % 60;
+    return m === 0 ? `${h}時間` : `${h}時間${m}分`;
+}
+/**
+ * 便の本文から「仕事」の1行を作る。
+ *
+ * ★中央は題名を返していない（実測 2026-10-02: /commands が返すのは id と body）。
+ *   だから本文の冒頭を使う。囲みの印（[CC1返事案/…] など）と投函の前置きは落とす。
+ * ★題名が取れないときは空文字を返す（呼び出し側が「—」と出す＝断定しない）。
+ */
+export function jobTitleFromBody(body, max = 60) {
+    let head = (body ?? '').trim();
+    if (head.length === 0)
+        return '';
+    head = head.replace(/^\[[^\]]*\]\s*/, ''); // [CC1返事案/white] の囲みを落とす
+    head = head.replace(/^投函:.*?\/\s*現場:\s*\S+\s*/, ''); // 投函・現場の前置きを落とす
+    head = head.split('\n').map((l) => l.trim()).find((l) => l.length > 0) ?? '';
+    if (head.length === 0)
+        return '';
+    return [...head].length > max ? `${[...head].slice(0, max).join('')}…` : head;
+}
+/**
+ * 進捗の記録を読み、時刻つきの流れの行にする。
+ *
+ * ★出どころは「職人が書く操作の説明文」と「工程の区切りの1行」だけ（えふさん確定）。
+ *   追加の AI 呼び出しによる要約はしない。
+ * ★同じ文が続いたときは1行にまとめる（同じ説明文の道具を連続で使うと読みにくいため）。
+ */
+export function flowLinesFromEvents(events, max = FLOW_LINES_MAX) {
+    const lines = [];
+    for (const e of events) {
+        if (e.type !== 'progress' && e.type !== 'tool' && e.type !== 'error' && e.type !== 'result')
+            continue;
+        const text = (e.text ?? '').trim();
+        if (text.length === 0)
+            continue;
+        const at = Date.parse(e.at);
+        if (!Number.isFinite(at))
+            continue;
+        const prefix = e.type === 'error' ? '⚠ ' : '';
+        const line = `${prefix}${text}`;
+        if (lines.length > 0 && lines[lines.length - 1].text === line)
+            continue;
+        lines.push({ at, text: line });
+    }
+    return lines.slice(-max);
+}
+/** 進捗の記録のファイルを読む（無ければ空）。 */
+export function readFlowEvents(commandId, attempt) {
+    const p = eventsLogPath(commandId, attempt);
+    if (!existsSync(p))
+        return [];
+    const out = [];
+    for (const line of readFileSync(p, 'utf8').split('\n')) {
+        if (line.trim().length === 0)
+            continue;
+        try {
+            const e = JSON.parse(line);
+            if (typeof e.text === 'string' && typeof e.at === 'string')
+                out.push(e);
+        }
+        catch {
+            // 壊れている行は飛ばす
+        }
+    }
+    return out;
+}
+/** 生の記録ファイルのパス（詳細表示が読む）。 */
+export function rawLogPath(commandId, attempt) {
+    return path.join(RUNS_DIR, commandId, `attempt-${attempt}.jsonl`);
+}
+/** 最後に記録が出た時刻(ms)。記録が無ければ null。 */
+export function lastRecordAt(commandId, attempt) {
+    for (const p of [eventsLogPath(commandId, attempt), rawLogPath(commandId, attempt)]) {
+        try {
+            if (existsSync(p))
+                return statSync(p).mtimeMs;
+        }
+        catch {
+            // 読めないときは次を見る
+        }
+    }
+    return null;
+}
+/**
+ * えふさんの手番（確認待ち）かを生の記録から見る。
+ *
+ * ★フックの行は `system/hook_started` と `system/hook_response` が `hook_id` で対になる
+ *   （実測 2026-10-02）。答えの行が来ていない PermissionRequest / Notification が
+ *   残っていれば、職人はその答えを待って止まっている＝えふさんの手番。
+ */
+export function awaitingUserFromRawLog(rawLines) {
+    const open = new Set();
+    for (const line of rawLines) {
+        if (line.trim().length === 0)
+            continue;
+        let row;
+        try {
+            row = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (row.type !== 'system')
+            continue;
+        const id = typeof row.hook_id === 'string' ? row.hook_id : null;
+        if (id === null)
+            continue;
+        const ev = String(row.hook_event ?? '');
+        if (row.subtype === 'hook_started' && (ev === 'PermissionRequest' || ev === 'Notification')) {
+            open.add(id);
+        }
+        else if (row.subtype === 'hook_response') {
+            open.delete(id);
+        }
+    }
+    return open.size > 0;
+}
+/**
+ * 生の記録から PR の番号を拾う。見つからなければ null。
+ * ★「確かめられたときだけ出す」ための関数。見つからないことを「PR はありません」とは読まない。
+ */
+export function prNumberFromRawLog(rawLines) {
+    let found = null;
+    for (const line of rawLines) {
+        const m = /https:\/\/github\.com\/[^/\s"]+\/[^/\s"]+\/pull\/(\d+)/.exec(line);
+        if (m)
+            found = Number(m[1]);
+    }
+    return found;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 見守り役（中継）が動いているか
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * この現場の中継（conductor@<現場名>）が動いているかを OS に聞く。
+ * 確かめられないときは null を返す（★「止まっています」と断定しない）。
+ *
+ * ★起動も再起動もしない。状態を聞くだけ。
+ */
+export function relayRunningForSite(site) {
+    const probes = [
+        ['systemctl', ['--user', 'is-active', `conductor@${site}.service`]],
+        ['launchctl', ['print', `gui/${process.getuid?.() ?? 0}/com.tyhld.conductor.${site}`]],
+    ];
+    for (const [bin, args] of probes) {
+        try {
+            const out = execFileSync(bin, args, {
+                encoding: 'utf8',
+                timeout: 5_000,
+                stdio: ['ignore', 'pipe', 'ignore'],
+            });
+            return /\bactive\b|state = running/.test(out);
+        }
+        catch (err) {
+            const e = err;
+            // コマンドが無い（ENOENT）→ 次の方法を試す。
+            if (e?.code === 'ENOENT')
+                continue;
+            // コマンドは在って非0で返った＝「動いていない」と答えた。
+            if (typeof e?.status === 'number')
+                return false;
+            continue;
+        }
+    }
+    return null;
+}
+/** 手元の記録だけを読んで SiteView を作る（★通信しない・何も起動しない）。 */
+export function collectSiteView(site, nowMs = Date.now()) {
+    const active = loadActiveJob(site);
+    const last = loadLastJob(site);
+    const rawLines = (() => {
+        if (active === null)
+            return [];
+        const p = rawLogPath(active.commandId, active.attempt);
+        try {
+            if (!existsSync(p))
+                return [];
+            return readFileSync(p, 'utf8').split('\n');
+        }
+        catch {
+            return [];
+        }
+    })();
+    const lastActivityAt = active === null ? null : lastRecordAt(active.commandId, active.attempt);
+    const processAlive = active === null ? false : isProcessAlive(active.pid);
+    const awaitingUser = awaitingUserFromRawLog(rawLines);
+    const relayRunning = relayRunningForSite(site);
+    const status = decideSiteStatus({
+        relayRunning,
+        hasActiveJob: active !== null,
+        processAlive,
+        sinceActivityMs: lastActivityAt === null ? null : nowMs - lastActivityAt,
+        awaitingUser,
+        hasLastJob: last !== null,
+    });
+    const body = active?.body ?? last?.body ?? '';
+    return {
+        site,
+        status,
+        active,
+        last,
+        title: jobTitleFromBody(body),
+        postedAt: active?.postedAt ?? null,
+        startedAt: active?.startedAt ?? last?.startedAt ?? null,
+        lastActivityAt,
+        flow: active === null ? [] : flowLinesFromEvents(readFlowEvents(active.commandId, active.attempt)),
+        prNumber: prNumberFromRawLog(rawLines),
+        relayRunning,
+        nowMs,
+    };
+}
+const RULE = '────────────────────';
+/**
+ * 通常表示（人間向けの日本語）を組み立てる。
+ * ★確かめられないことは「—」と出す。「ありません」と断定しない。
+ */
+export function renderNormalView(v) {
+    const out = [];
+    const unknown = '—（確かめられません）';
+    out.push(`${v.site} ${STATUS_LABEL[v.status]}  ${STATUS_NOTE[v.status]}`);
+    out.push(`仕事：${v.title.length > 0 ? v.title : unknown}`);
+    // ★投函・開始・実作業を別々に出す（えふさん確定③）。
+    out.push(`投函：${v.postedAt !== null ? friendlyTime(v.postedAt, v.nowMs) : '—（管制が持っています）'}`);
+    out.push(`開始：${v.startedAt !== null ? friendlyTime(v.startedAt, v.nowMs) : '—（まだ起動していません）'}`);
+    if (v.startedAt !== null) {
+        const until = v.status === 'working' ? v.nowMs : (v.lastActivityAt ?? v.last?.finishedAt ?? v.nowMs);
+        out.push(`実作業：${friendlyDuration(until - v.startedAt)}`);
+    }
+    else {
+        out.push('実作業：—');
+    }
+    out.push(`最後に動いた：${v.lastActivityAt !== null ? friendlyTime(v.lastActivityAt, v.nowMs) : unknown}`);
+    const current = v.flow.length > 0 ? v.flow[v.flow.length - 1].text : '';
+    out.push(`現在：${current.length > 0 ? current : unknown}`);
+    out.push(RULE);
+    if (v.flow.length > 0) {
+        for (const l of v.flow)
+            out.push(`${hhmm(l.at)} ${l.text}`);
+    }
+    else if (v.active !== null) {
+        out.push('（まだ進捗が出ていません）');
+    }
+    else if (v.last !== null) {
+        // 仕事が動いていないときは、直前の仕事の結果を出す。
+        out.push(`直前の仕事：${jobTitleFromBody(v.last.body) || unknown}`);
+        out.push(`結果：${LAST_OUTCOME_LABEL[v.last.outcome] ?? v.last.outcome}`);
+        if (v.last.detail !== undefined && v.last.detail.length > 0) {
+            out.push(`くわしく：${maskSecrets(v.last.detail)}`);
+        }
+        out.push(`終わった時刻：${friendlyTime(v.last.finishedAt, v.nowMs)}`);
+    }
+    else {
+        out.push('（この現場の記録はまだありません）');
+    }
+    out.push(RULE);
+    // ★PR・CI は確かめられたときだけ出す。
+    out.push(`PR：${v.prNumber !== null ? `#${v.prNumber}` : '—（この画面では確かめていません）'}`);
+    out.push('CI：—（この画面では確かめていません）');
+    if (v.relayRunning === null) {
+        out.push('※このPCの見守り役の状態は確かめられませんでした');
+    }
+    out.push('');
+    out.push('※見るだけの画面です（職人も作業部屋も見守り役も起動しません／入力は送れません）');
+    out.push('※Claude Code の生ログを見たいときは --detail を付けてください');
+    return out.join('\n');
+}
+/** 直前の仕事の終わり方の日本語。 */
+export const LAST_OUTCOME_LABEL = {
+    done: '✅ 終わりました',
+    failed: '⚠ 失敗しました',
+    stopped: '⏹ 管制から止めました',
+    timeout: '⚠ 上限時間で止めました',
+    auth_error: '⚠ ログインが切れていました',
+};
+/**
+ * 詳細表示（Claude Code の生ログ）を組み立てる。
+ * ★秘密を隠してから出す。行数に上限を持つ。
+ */
+export function renderDetailView(v, lines = []) {
+    const out = [];
+    out.push(`${v.site} 詳細（Claude Code の生ログ・末尾 ${DETAIL_LINES_MAX} 行まで）`);
+    out.push(RULE);
+    const tail = lines.filter((l) => l.trim().length > 0).slice(-DETAIL_LINES_MAX);
+    if (tail.length === 0) {
+        out.push('（生ログはまだありません）');
+    }
+    else {
+        for (const l of tail)
+            out.push(maskSecrets(l).slice(0, DETAIL_LINE_CHARS_MAX));
+    }
+    out.push(RULE);
+    out.push('※見るだけの画面です');
+    return out.join('\n');
+}
+/** 詳細表示に出す生ログの行を読む。 */
+export function readRawLogLines(v) {
+    const rec = v.active ?? (v.last !== null ? { commandId: v.last.commandId, attempt: v.last.attempt } : null);
+    if (rec === null)
+        return [];
+    const p = rawLogPath(rec.commandId, rec.attempt);
+    try {
+        if (!existsSync(p))
+            return [];
+        return readFileSync(p, 'utf8').split('\n');
+    }
+    catch {
+        return [];
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 入口（cli.ts が呼ぶ）
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * `conductor view <現場名> [--detail]` の本体。
+ * ★何も起動しない・通信しない・入力を受け付けない。画面に出して終わる。
+ */
+export function runViewCommand(argv) {
+    const detail = argv.includes('--detail');
+    const site = argv.find((a) => !a.startsWith('-'));
+    if (site === undefined || site.length === 0) {
+        console.error('使い方: conductor view <現場名> [--detail]');
+        return 2;
+    }
+    // ★現場のフォルダが無い＝この PC の現場ではない。何も作らずに知らせる。
+    const projectDir = path.join(os.homedir(), 'projects', site);
+    if (!existsSync(projectDir)) {
+        console.error(`そんな現場はありません: ${site}`);
+        return 1;
+    }
+    const v = collectSiteView(site);
+    console.log(renderNormalView(v));
+    if (detail) {
+        console.log('');
+        console.log(renderDetailView(v, readRawLogLines(v)));
+    }
+    return 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tyhld/conductor",
-  "version": "0.12.72",
+  "version": "0.12.73",
   "description": "采配くん管制の見守りアプリ（conductor-agent）。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
   "type": "module",
   "bin": {
@@ -22,6 +22,7 @@
     "scripts/update-guard.sh",
     "scripts/dist-source.sh",
     "scripts/conductor-run.sh",
+    "scripts/kc.sh",
     "scripts/codex",
     "!scripts/codex/__pycache__",
     "skills",

package/sales-template/install.sh

@@ -1041,14 +1041,16 @@ fi
 #   ＝お客さまに tmux の3行を手で打ってもらう限り、同じ事故がいつでも起きる。
 #   だから「kc <現場名>」の1語にまとめ、名前を間違えようがない形にする。
 #
-# 【この中身は手で書いたものではない】
-#   Fshima の ~/.bashrc に入れて、ai-saku と migakia の2現場で実際に動かして
-#   確かめた現物をそのまま移す。★作り直さない・引数を増やさない。
+# 【中身は ~/.bashrc に書かない（便 fbaba4b1）】
+#   kc の実体は配布物の scripts/kc.sh で、設置係が ~/.tyhld/kc.sh へ置く。
+#   ★ここで ~/.bashrc に足すのは「それを呼ぶだけ」の1枚。こうしておくと、次から
+#     kc を直しても ~/.bashrc を書き換えに行かなくて済む（お客さまの手を借りない）。
+#   振る舞い（tmux 方式の3行・画面なし方式では見るだけの画面）は kc.sh が持つ。
 #
 # 【壊さないための決め】
 #   ・~/.bashrc は【追記だけ】。既存の行は1つも書き換えない。
 #   ・既に kc が定義されていれば何もしない（何度打っても二重にならない＝冪等）。
-#   ・同じ名前の部屋が既にあれば【入るだけ】。動いている職人を作り直さない。
+#   ・実体が無い機体では、今までどおり tmux 方式で開く控えを持たせる。
 # ═════════════════════════════════════════════════════════════════════════════
 
 step '⑫ 職人を呼ぶ合言葉（kc）を用意する'
@@ -1072,9 +1074,16 @@ else
 
 # ── 采配くん: 職人を呼ぶ合言葉 ────────────────────────────────────────────────
 # 使い方: kc <現場名>   例) kc my-app
-#   その現場の作業部屋（tmux）を用意し、職人（Claude Code）を開きます。
-#   ★部屋の名前は必ず現場名と同じにします（違うと指示が届きません）。
+#   画面なし方式の現場 … いま職人が何をしているかを「見るだけの画面」で出します。
+#   tmux 方式の現場     … その現場の作業部屋（tmux）を用意し、職人を開きます。
+# ★中身は ~/.tyhld/kc.sh（采配くんの配布物）が持っています。ここは呼ぶだけなので、
+#   采配くんを更新すれば kc も新しくなります。このファイルは書き換えに来ません。
 kc() {
+  if [ -r "$HOME/.tyhld/kc.sh" ]; then
+    bash "$HOME/.tyhld/kc.sh" "$@"
+    return $?
+  fi
+  # 実体がまだ無い機体のための控え（従来どおり tmux 方式で開きます）。
   local s="$1"
   if [ -n "$TMUX" ]; then echo "すでにtmuxの中です。Ctrl+b → d で一度抜けてください"; return 1; fi
   if [ -z "$s" ]; then echo "使い方: kc 現場名（例 kc TYHLD-platform）"; return 1; fi
@@ -1218,9 +1227,12 @@ ${BAR}
   それでも出ないときは、この画面をそのままサポートへお送りください。
 
 ${BAR}
-職人の画面を手で開きたいとき（tmux 方式・補助）
+いま職人が何をしているか見たいとき
 ${BAR}
 
   source ~/.bashrc && kc ${SITE}
 
+  ★見るだけの画面です。職人を起動したり、口を出したりはしません。
+  生の記録まで見たいときは   kc ${SITE} --detail
+
 GUIDE

package/sales-template/setup.sh

@@ -746,6 +746,24 @@ for guard_conf in "${GUARD_CONFIGS[@]}"; do
   fi
 done
 
+# --- 合言葉 kc の実体を固定パスへ配置（便 fbaba4b1） -------------------------
+# ★これまで kc の中身は ~/.bashrc の末尾に書き込まれていた。その形だと kc を直すたびに
+#   全PCの ~/.bashrc を書き換えに行くことになる（お客さまの手で編集する＝事故の種）。
+#   番人と同じ「1台に1箇所」へ置き、~/.bashrc の kc は呼ぶだけにする。
+KC_SRC="$SETUP_DIST_ROOT/scripts/kc.sh"
+KC_DEST="$HOME/.tyhld/kc.sh"
+if [[ -f "$KC_SRC" ]]; then
+  mkdir -p "$HOME/.tyhld"
+  if ! bash -n "$KC_SRC"; then
+    fail "合言葉 kc の実体の構文確認に失敗しました（$KC_SRC）。固定パスは変更していません。"
+  fi
+  cp -f "$KC_SRC" "$KC_DEST"
+  chmod +x "$KC_DEST"
+  echo "[setup] 合言葉 kc の実体を配置: $KC_DEST（この1台の全現場が共有します）"
+else
+  echo "[setup] 合言葉 kc の実体は配布物にありません（古い配布物。~/.bashrc の kc がそのまま使われます）"
+fi
+
 # --- 番人フックを【ホームの ~/.claude/settings.json】へ1本だけ登録 ---
 # ★1台1箇所。ここに書けば、この機の全現場（全 tmux セッション）へ同時に効く。
 #   現場ごとの settings.json には番人フックを書かない＝二重番人・取り残しを構造的に防ぐ（ADR-013）。

package/scripts/kc.sh

@@ -0,0 +1,85 @@
+#!/usr/bin/env bash
+# 采配くん: 合言葉 kc の実体（便 fbaba4b1）
+#
+# 【なぜ配布物の中に置くか】
+#   これまで kc の中身は install.sh が ~/.bashrc の末尾へ書き込んでいた。
+#   ★その形だと、kc を直すたびに全PCの ~/.bashrc を書き換えに行くことになる
+#     （お客さまの手で編集する＝事故の種）。だから中身はここ1か所に置き、
+#     ~/.bashrc の kc は「このファイルを呼ぶだけ」にする。
+#
+# 【2つの方式で振る舞いが違う】
+#   ・画面なし方式（headless）… 職人は便ごとに relay が起動する。
+#     ここで新しい Claude Code を開くと「便を持っていない空の職人」が開き、
+#     裏で働いている本物の職人とは別物になる（実機 2026-10-02 に発生）。
+#     ＝★何も起動せず「見るだけの画面」（conductor view）を出す。
+#   ・tmux 方式（従来）… これまでどおり作業部屋を用意して職人を開く。
+#     ★振る舞いは1文字も変えない。
+#
+# 使い方: kc <現場名> [--detail]
+set -uo pipefail
+
+s="${1:-}"
+shift || true
+
+if [ -z "$s" ]; then
+  echo "使い方: kc 現場名（例 kc TYHLD-platform）"
+  exit 1
+fi
+if [ ! -d "$HOME/projects/$s" ]; then
+  echo "そんな現場はありません: $s"
+  ls "$HOME/projects" 2>/dev/null || true
+  exit 1
+fi
+
+# ── その現場が画面なし方式（headless）かを見る ────────────────────────────────
+# ★ここで relay を起動しない・設定を書き換えない。在るものを読むだけ。
+is_headless() {
+  # ① 人が明示した指定がいちばん強い。
+  case "${CONDUCTOR_RUNNER_MODE:-}" in
+    headless) return 0 ;;
+    tmux) return 1 ;;
+  esac
+  # ② Linux（systemd）… 常駐に実際に渡っている環境変数を読む。
+  if command -v systemctl >/dev/null 2>&1; then
+    if systemctl --user show -p Environment "conductor@$s.service" 2>/dev/null \
+      | grep -qF 'CONDUCTOR_RUNNER_MODE=headless'; then
+      return 0
+    fi
+  fi
+  # ③ 常駐が止まっていて②が読めないときの控え… drop-in のファイルを見る。
+  local d="$HOME/.config/systemd/user/conductor@$s.service.d"
+  if [ -d "$d" ] && grep -rqlF 'CONDUCTOR_RUNNER_MODE=headless' "$d" 2>/dev/null; then
+    return 0
+  fi
+  # ④ Mac（launchd）… plist に書かれた指定を見る。
+  local p="$HOME/Library/LaunchAgents/com.tyhld.conductor.$s.plist"
+  if [ -f "$p" ] && grep -qF 'headless' "$p" 2>/dev/null; then
+    return 0
+  fi
+  return 1
+}
+
+if is_headless; then
+  # ★見るだけの画面。職人・tmux・relay を起動せず、入力も受け付けない。
+  if command -v conductor >/dev/null 2>&1; then
+    exec conductor view "$s" "$@"
+  fi
+  # PATH に無い機体（nvm の置き場が読まれていない等）でも、常駐が使っている入口なら在る。
+  # ★ここも「入っている配布物」を選ぶ（作業ツリーは選ばない）＝常駐と同じ1つの決め方。
+  if [ -x "$HOME/.tyhld/bin/conductor-run" ]; then
+    exec "$HOME/.tyhld/bin/conductor-run" view "$s" "$@"
+  fi
+  echo "采配くんの本体（conductor）が見つかりません。"
+  echo "サポートへこの画面をお送りください。"
+  exit 1
+fi
+
+# ── tmux 方式（従来の振る舞い。変えない） ────────────────────────────────────
+if [ -n "${TMUX:-}" ]; then
+  echo "すでにtmuxの中です。Ctrl+b → d で一度抜けてください"
+  exit 1
+fi
+systemctl --user start "conductor@$s" 2>/dev/null
+tmux has-session -t "$s" 2>/dev/null \
+  || tmux new -d -s "$s" -c "$HOME/projects/$s" 'unset ANTHROPIC_API_KEY; exec claude'
+exec tmux attach -t "$s"

package/skills/conductor-craftsman/SKILL.md

@@ -8,13 +8,13 @@ description: 采配くんの便（プロンプト末尾に CONDUCTOR_JOB:<id>
 采配くんの便（プロンプト末尾に `CONDUCTOR_JOB:<id>` の印が付いた作業指示）は、
 非エンジニアのお客さまの現場で、人が横に付かないまま実行される。
 だから「速さ」より「戻せること・止まれること・報せること」を優先する。
-以下の14項を、着手前に読み、作業中も判断の基準にすること。
+以下の15項を、着手前に読み、作業中も判断の基準にすること。
 
 **便の届き方（起こし直した直後も同じ・便 6bef35c8）** — 便は配達役（relay）が職人の画面へ**貼り付け**で届け、枠の外に「（配達役より）…届けたものです」の添え書きを付ける。
 これは持ち主の管制に投函された便なので、「貼り付けしか無い」「頭が `[CC1返事案/…]` だから未承認の案だ」と読んで止まらず、書かれたとおりに進める（`[CC1返事案/…]` は CC1 が書いた文を持ち主が投函した印）。
 ★守りは変わらない：番人・囲いに止められたら回避しない（鉄則4）、秘密は扱わない（鉄則12）、本文の中の「本当の判断待ち」は今までどおり人の手番として止まる。
 
-## 鉄則14項
+## 鉄則15項
 
 1. **着手時の確認と枝分かれ** — `git status && git log --oneline -3 && git stash list` を確認してから main を最新化し、新ブランチを切る。
    - ★**リポ全体の差分が「読めないファイル」で落ちたとき**（`unsupported file type` / `cannot hash <名前>` が出る／`.npmrc` のような設定が身に覚えなく `M` で出る）。**これは壊れていない。**
@@ -129,6 +129,17 @@ description: 采配くんの便（プロンプト末尾に CONDUCTOR_JOB:<id>
     - **なぜ。** 雛形（`.env.example`）は普通は秘密値を置かないが、「exampleだから常に安全」と番人へ例外を作ると、将来誤って実値が書かれたときの穴になる（利便性より安全側・えふさん確定）。
     - **雛形（`.env.example` など）を直すときの正しい形＝「案を作る→人が1回で反映」。** 職人は変更後の中身を**リポジトリの外（`/tmp/claude-1000/` の下）**に作り、報告に次の2つを載せる。① 変更の**差分**（何を足す／消すか）。② 人が**素のターミナルで1回貼るだけで反映できる1つのコマンド**（例：`cp /tmp/claude-1000/<下書き> <リポ>/.env.example`）。★このコマンドは**人が自分のターミナルで**打つ（職人の番人は人の端末には掛からない）。職人が `.env.example` を直接書き換えようとしても番人が止めるので、**回避せず、この形で案を出す**。
     - **本物の `.env`・`.env.local` は、これまでどおり中身も書き込みも扱わない**（秘密の値は1文字も読まない・書かない＝鉄則12の金庫）。
+15. **工程の区切りで「いま何をしているか」を日本語1行で出す（えふさん確定 2026-10-02・便 fbaba4b1）**
+    - **形は1つだけ。** 行の先頭に `進捗:` を置き、そのうしろにやさしい日本語を1行書く。★この印は配達役が機械で拾うので、形を変えない（全角コロン `進捗：` も可）。
+      ```
+      進捗: 既存の画面構成を確認しました
+      進捗: 変更するファイルを特定しました
+      進捗: 試験を実行しています
+      ```
+    - **いつ出すか。** 工程の区切り（調べ終わった／直す場所が決まった／実装を始めた／試験を流した／PR を出した など）で**1行ずつ**。1つの工程で何度も出さない。細かい手順の実況はしない（うるさくなる）。
+    - **なぜ。** お客さま（非エンジニア）は `kc 現場名` の画面でこの1行を見る。これが無いと、画面に出るのは道具の名前だけで「いま何をしているか」が分からない。実機 2026-10-02 に「職人が動いているのに何も見えない」が起きたのが発端。
+    - **書き方。** 専門用語（rebase / squash / lint / CI 等）を避け、**何が進んだか**を書く。秘密の値・鍵・`.env` の中身は1文字も書かない（鉄則12）。
+    - **道具の一言説明（description）も同じ画面に出る。** だから下の「作業中の確認の一言説明」は、確認カードだけでなく**この画面の材料**でもある。英語で書かない・「何をするか」が一目で分かる日本語にする。
 
 ## 番人に止められる常連（こう書くと止まる → 代わりにこう書く）