@tyhld/conductor 0.12.82 → 0.12.84

package/dist/cli.js

@@ -488,12 +488,15 @@ function printUsage() {
         '  conductor ear                                                     この機に1本の「耳」（合図の受け取り役）',
         '  conductor build-runner                                            この機に1本の「司令塔」（試作の段取り役）',
         '  conductor setup <現場名> [フォルダ] [--profile <default|proto>]     采配くんをこのPCに設置する（初回の1回だけ）',
-        '  conductor view <現場名> [--detail]                                 その現場の今を見るだけの画面（kc の実体）',
+        '  conductor view <現場名> [--once] [--detail]                        その現場の今を見るだけの画面（kc の実体）',
         '',
         '見るだけの画面（conductor view ＝ kc 現場名）:',
         '  いま職人が何をしているかを、やさしい日本語で見るだけの画面です。',
+        '  ★既定は「開いたまま流れ続ける」形です。職人の動きが出るたびに下へ流れます。',
+        '    閉じるときは Ctrl+C（★抜けても職人・見守り役には何も起きません）。',
         '  ★職人（Claude Code）・tmux・relay を起動しません。入力も受け付けません（抜けるだけ）。',
-        '  --detail を付けると、職人の生の記録（秘密は隠したもの）も続けて出します。',
+        '  --once   これまでどおり「いまの様子を1回だけ」出して終わります。',
+        '  --detail 職人の生の記録（秘密は隠したもの）も続けて出します。',
         '',
         '設置の型（--profile。既定は default＝今までどおり）:',
         '  default  ふつうの現場。従来と同じ設定を置きます。',
@@ -573,7 +576,8 @@ async function main() {
             break;
         case 'view':
             // ★見るだけの画面。職人も tmux も relay も起動せず、入力も受け付けない。
-            process.exit(runViewCommand(process.argv.slice(3)));
+            //   既定は「開いたまま流れ続ける」ので、Ctrl+C まで戻らない（--once は1回で戻る）。
+            process.exit(await runViewCommand(process.argv.slice(3)));
             break;
         case 'version':
         case '-v':

package/dist/view-stream.js

@@ -0,0 +1,782 @@
+/**
+ * @tyhld/conductor — `kc 現場名` を「開いたまま流れ続ける画面」にする（便 a56e49bf）。
+ *
+ * 【なぜ要るか（えふさんの言葉 2026-10-02）】
+ *   「いつ前みたいに見れるようになる？」
+ *   画面あり方式（tmux）の頃は、職人の画面を開いておけば、考えていること・
+ *   打っているコマンド・その結果がそのまま流れて見えた。画面なし方式にしてから、
+ *   `kc 現場名` は【開いた瞬間の様子を1回出して終わる】ので、開いたまま眺めることが
+ *   できなくなっていた。＝この画面を「開いたまま流れ続ける」形に戻す。
+ *
+ * 【えふさん確定（2026-10-02・判断7）】
+ *   開いたまま自動で流れ続け、職人の言葉をもっと細かく出すようにする。
+ *   見るだけの画面という決まりは変えません。
+ *
+ * 【どこから読むか（★ここが設計の肝）】
+ *   流れの出どころは【この PC の中にある生の記録】（runs/便ID/attempt-N.jsonl）だけ。
+ *   ・管制へ送る進捗（attempt-N.events.jsonl）は、外へ出す分を絞った控えなので粗い。
+ *     ★そちらを細かくすると「PC の外へ出す量」が増える。だから外へ送る物は1バイトも
+ *       増やさず、手元で読める生の記録を人の言葉に直して画面にだけ出す。
+ *   ・生の記録の1行には時刻（timestamp）が入っている（実測 2026-10-02・この現場の便）。
+ *     だから手元だけで時刻つきの流れが作れる。
+ *
+ * 【この画面の約束（1つも緩めない）】
+ *   ① 読むだけ。職人・作業部屋（tmux）・見守り役を起動しない。管制へ通信しない。
+ *   ② 職人へ何も送らない（入力を渡さない・止めない・再開しない）。
+ *   ③ 秘密は出す前に必ず隠す（maskSecrets）。1行の長さに上限を持つ。
+ *   ④ 生の記録はこの PC の外へ出さない（画面に出すだけ）。
+ *   ⑤ 分からないことを「ありません」と断定しない。理由と次の1手を日本語で出す。
+ */
+import { closeSync, existsSync, openSync, readSync, statSync } from 'node:fs';
+import os from 'node:os';
+import { extractProgressLine, loadActiveJob, loadLastJob, maskSecrets, } from './headless.js';
+import { DETAIL_LINE_CHARS_MAX, LAST_OUTCOME_LABEL, STATUS_LABEL, STATUS_NOTE, collectSiteView, friendlyDuration, friendlyTime, hhmm, jobTitleFromBody, quietActivityNote, rawLogPath, } from './view.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// 定数（★線引きはここ1か所）
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 新しい記録を見に行く間隔(ms)。
+ * 【なぜ1秒か】人が「流れている」と感じるのは1秒くらいまで。これより短くすると
+ *   ファイルを覗く回数だけが増えて画面は変わらない。これより長いと、打ったコマンドの
+ *   反応が遅れて「止まったのでは」と見える。
+ */
+export const FOLLOW_POLL_MS = 1_000;
+/**
+ * 開いたときに「これまでの分」を何行まで振り返って出すか。
+ * 【なぜ15行か】画面を開いた人が「いま何の途中か」を読み取れる最小限。
+ *   多くすると、開いた瞬間に昔の行で画面が埋まって、いまの動きが見えなくなる。
+ */
+export const FOLLOW_BACKLOG_LINES = 15;
+/** 振り返りのために読む生の記録の末尾の大きさ(バイト)。★全部は読まない。 */
+export const FOLLOW_BACKLOG_BYTES = 512 * 1024;
+/**
+ * 画面に出す1行の長さの上限(文字)。
+ * 【なぜ160字か】生の記録の1行は数千文字ある（試験の出力・ファイルの中身）。
+ *   そのまま出すと1件で画面が埋まって流れが読めない。端末の2行ぶんで切る。
+ */
+export const FOLLOW_LINE_CHARS_MAX = 160;
+/** 記録1行から画面へ出す行数の上限(件)。1つの行に大量に詰まっていても溢れさせない。 */
+export const FOLLOW_LINES_PER_RECORD_MAX = 4;
+/** 画面の区切り線（通常表示と同じ形）。 */
+const RULE = '────────────────────';
+// ─────────────────────────────────────────────────────────────────────────────
+// 文字の整え
+// ─────────────────────────────────────────────────────────────────────────────
+/** 上限で切る（切ったら「…」を付ける）。 */
+export function clip(text, max = FOLLOW_LINE_CHARS_MAX) {
+    const chars = [...text];
+    return chars.length > max ? `${chars.slice(0, max).join('')}…` : text;
+}
+/** 長い文の「要点」＝最初の意味のある1行。残りの行数も返す。 */
+export function gist(text) {
+    const lines = (text ?? '').split('\n').map((l) => l.trim()).filter((l) => l.length > 0);
+    if (lines.length === 0)
+        return { head: '', moreLines: 0 };
+    return { head: lines[0], moreLines: lines.length - 1 };
+}
+/** ホームの下は `~/` で出す（画面が横に長くならないように）。 */
+export function shortPath(p) {
+    const home = os.homedir();
+    return p.startsWith(home) ? `~${p.slice(home.length)}` : p;
+}
+/** 記録の中の「文字か、文字の配列か、text ブロックの配列」を1本の文字列にする。 */
+function flatten(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 '';
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 道具1件を「これからやること」の日本語にする
+// ─────────────────────────────────────────────────────────────────────────────
+/** 外の道具（MCP）の名前 `mcp__どこ__なに` の「なに」だけを取る。 */
+function mcpToolName(name) {
+    const m = /^mcp__[^_]+(?:_[^_]+)*__(.+)$/.exec(name);
+    return m ? m[1] : null;
+}
+/**
+ * 道具1件を人が読める日本語にする（1件で1〜2行）。
+ *
+ * ★英語の内部用語をそのまま出さない（えふさん確定：非エンジニア・60代でも読める日本語）。
+ * ★「実行したコマンド」は、えふさんが見たいと言った物なので出す（★手元の画面だけ）。
+ */
+export function toolLinesJa(name, input) {
+    const str = (key) => {
+        const v = input?.[key];
+        return typeof v === 'string' ? v.trim() : '';
+    };
+    const desc = str('description');
+    const file = str('file_path') || str('notebook_path') || str('path');
+    const out = [];
+    switch (name) {
+        case 'Bash':
+        case 'BashOutput': {
+            out.push(`・${desc.length > 0 ? desc : 'コマンドを実行します'}`);
+            const cmd = str('command');
+            if (cmd.length > 0)
+                out.push(`  $ ${gist(cmd).head}`);
+            return out;
+        }
+        case 'Read':
+            return [`・ファイルを読みます：${shortPath(file)}`];
+        case 'Write':
+            return [`・ファイルを書きます：${shortPath(file)}`];
+        case 'Edit':
+        case 'NotebookEdit':
+            return [`・ファイルを直します：${shortPath(file)}`];
+        case 'Glob':
+        case 'Grep': {
+            const pat = str('pattern');
+            const where = str('path');
+            return [`・探します：${pat}${where.length > 0 ? `（${shortPath(where)}）` : ''}`];
+        }
+        case 'Agent':
+        case 'Task':
+            return [`・下請けの職人に頼みます：${desc.length > 0 ? desc : str('subagent_type')}`];
+        case 'Skill':
+            return [`・手順書を開きます：${str('skill')}`];
+        case 'TodoWrite':
+            return ['・やることの一覧を整え直しています'];
+        case 'WebFetch':
+            return [`・外のページを読みます：${str('url')}`];
+        case 'WebSearch':
+            return [`・調べます：${str('query')}`];
+        case 'ToolSearch':
+            return ['・使える道具を探しています'];
+        default:
+            break;
+    }
+    const mcp = mcpToolName(name);
+    if (mcp !== null) {
+        return [`・外の仕組みを使います：${mcp}${desc.length > 0 ? `（${desc}）` : ''}`];
+    }
+    if (desc.length > 0)
+        return [`・${desc}`];
+    if (file.length > 0)
+        return [`・${name}：${shortPath(file)}`];
+    return [`・${name} を使います`];
+}
+/**
+ * 道具の結果1件を「結果の要点」の日本語にする。
+ *
+ * ★どの道具の結果かが分かるときは、英語の出力をそのまま出さずに日本語でまとめる
+ *   （実測：ファイルを直した結果は "The file ... has been updated successfully" と
+ *    英語で返るので、そのまま出すとお客さまには読めない）。
+ * ★コマンドの出力（Bash）は、そのプログラム自身の答えなので要点をそのまま出す
+ *   （画面あり方式のときに見えていた物＝えふさんが見たいと言った物）。
+ */
+export function resultLineJa(toolName, content) {
+    const { head, moreLines } = gist(content);
+    const lineCount = head.length === 0 ? 0 : moreLines + 1;
+    const asIs = () => `  → ${head}${moreLines > 0 ? `（ほか${moreLines}行）` : ''}`;
+    switch (toolName) {
+        case 'Read':
+            return `  → 読みました（${lineCount}行）`;
+        case 'Write':
+        case 'Edit':
+        case 'NotebookEdit':
+            return '  → 書き込みました';
+        case 'Glob':
+        case 'Grep':
+            return `  → ${lineCount}件見つかりました`;
+        case 'Agent':
+        case 'Task':
+            return '  → 下請けの職人から返事が来ました';
+        case 'Skill':
+            return '  → 手順書を読み込みました';
+        case 'TodoWrite':
+            return '  → やることの一覧を整えました';
+        case 'WebFetch':
+        case 'WebSearch':
+            return `  → 受け取りました（${lineCount}行）`;
+        default:
+            return asIs();
+    }
+}
+/** 道具の呼び出しと結果を結びつける覚え（★古い分は捨てる）。 */
+export const TOOL_NAME_MEMO_MAX = 500;
+function rememberToolName(memo, id, name) {
+    if (memo === undefined || id.length === 0)
+        return;
+    memo.set(id, name);
+    if (memo.size > TOOL_NAME_MEMO_MAX) {
+        const oldest = memo.keys().next();
+        if (!oldest.done)
+            memo.delete(oldest.value);
+    }
+}
+/**
+ * 「止まった理由」として出す値打ちのある差し込み文の形。
+ * ★手順書の読み込みなどの差し込みは出さない（量が多く、読む人の役に立たない）。
+ */
+export const INTERRUPT_RE = /interrupt|cancel|API Error|rate limit|timed out|割り込み|中断|止めました|やめました/i;
+/** 人の確認の種類を日本語にする。 */
+function askLabel(hookEvent) {
+    if (hookEvent === 'PermissionRequest')
+        return '許可の確認';
+    if (hookEvent === 'Notification')
+        return '知らせ';
+    return hookEvent;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 生の記録1行 → 画面の行（★ここが「細かく出す」本体）
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 生の記録（stream-json）の1行を、人が読める日本語の行にする。
+ *
+ * 【出す物（えふさん確定の「もっと細かく」）】
+ *   ・職人の言葉（考え・これからやること）
+ *   ・実行したコマンド
+ *   ・読んだ／書いたファイル
+ *   ・結果の要点
+ *   ・質問や止まった理由
+ * 【出さない物】量が多いだけで読めない物（考えた字数の報告・道具一覧の更新など）。
+ *
+ * ★秘密は隠してから切る（切ってから隠すと、隠す形が壊れて漏れうる）。
+ */
+export function humanLinesFromRecord(parsed, toolNames) {
+    const at = (() => {
+        const t = parsed.timestamp;
+        if (typeof t !== 'string')
+            return null;
+        const ms = Date.parse(t);
+        return Number.isFinite(ms) ? ms : null;
+    })();
+    const type = String(parsed.type ?? '');
+    const subtype = typeof parsed.subtype === 'string' ? parsed.subtype : '';
+    const out = [];
+    const push = (kind, raw) => {
+        if (out.length >= FOLLOW_LINES_PER_RECORD_MAX)
+            return;
+        // ★行の頭の空白は残す（コマンドと結果を1段下げて出すため）。後ろだけ落とす。
+        const text = clip(maskSecrets(raw).trimEnd());
+        if (text.length === 0)
+            return;
+        out.push({ at, kind, text });
+    };
+    const content = (() => {
+        const msg = parsed.message;
+        if (typeof msg !== 'object' || msg === null)
+            return null;
+        const c = msg.content;
+        return Array.isArray(c) ? c : null;
+    })();
+    if (type === 'assistant' && content !== null) {
+        for (const block of content) {
+            if (block?.type === 'thinking') {
+                const { head } = gist(String(block.thinking ?? block.text ?? ''));
+                if (head.length > 0)
+                    push('think', `考えています：${head}`);
+            }
+            else if (block?.type === 'text') {
+                const text = String(block.text ?? '');
+                const marked = extractProgressLine(text);
+                if (marked !== null) {
+                    push('progress', `▶ ${marked}`);
+                }
+                else {
+                    const { head, moreLines } = gist(text);
+                    if (head.length > 0) {
+                        push('say', `職人：${head}${moreLines > 0 ? `（ほか${moreLines}行）` : ''}`);
+                    }
+                }
+            }
+            else if (block?.type === 'tool_use') {
+                const input = typeof block.input === 'object' && block.input !== null
+                    ? block.input
+                    : undefined;
+                const name = String(block.name ?? '不明な道具');
+                // 結果の行を日本語でまとめるために、どの道具の呼び出しだったかを覚えておく。
+                rememberToolName(toolNames, String(block.id ?? ''), name);
+                for (const line of toolLinesJa(name, input)) {
+                    push(line.startsWith('  $ ') ? 'cmd' : 'tool', line);
+                }
+            }
+            // ほかの種類（画像・使い途の無い印）は出さない。
+        }
+        return out;
+    }
+    if (type === 'user' && content !== null) {
+        for (const block of content) {
+            if (block?.type === 'tool_result') {
+                const body = flatten(block.content);
+                if (block.is_error === true) {
+                    const { head } = gist(body);
+                    push('error', `⚠ うまくいきませんでした：${head.length > 0 ? head : '理由は記録にありません'}`);
+                }
+                else if (gist(body).head.length > 0) {
+                    const name = toolNames?.get(String(block.tool_use_id ?? ''));
+                    push('result', resultLineJa(name, body));
+                }
+            }
+            else if (block?.type === 'text' && parsed.isSynthetic === true) {
+                // 仕組みが差し込む文。★ふつうは手順書の読み込みなので出さない（量が多く、読めない）。
+                //   止まった理由（割り込み・通信の失敗）だけを拾う。
+                const { head } = gist(String(block.text ?? ''));
+                if (head.length > 0 && INTERRUPT_RE.test(head))
+                    push('info', `※ ${head}`);
+            }
+        }
+        return out;
+    }
+    if (type === 'result') {
+        if (parsed.is_error === true || subtype === 'error_during_execution') {
+            const text = String(parsed.result ?? '') || flatten(parsed.errors) || `失敗しました（${subtype || 'result'}）`;
+            push('end', `⚠ 失敗で終わりました：${gist(text).head}`);
+        }
+        else {
+            push('end', '作業が終わりました');
+        }
+        return out;
+    }
+    if (type === 'system') {
+        if (subtype === 'init') {
+            push('start', '職人が動き始めました');
+        }
+        else if (subtype === 'hook_started') {
+            const ev = String(parsed.hook_event ?? '');
+            if (ev === 'PermissionRequest' || ev === 'Notification') {
+                push('ask', `🔵 人の確認を待っています（${askLabel(ev)}）`);
+            }
+        }
+        else if (subtype === 'hook_response') {
+            const ev = String(parsed.hook_event ?? '');
+            if (ev === 'PermissionRequest' || ev === 'Notification') {
+                push('info', '※ 確認の返事が返りました（作業を続けます）');
+            }
+        }
+        return out;
+    }
+    if (type === 'rate_limit_event') {
+        // ★ふつうの知らせ（status='allowed'）は出さない。出すと「混んでいる」という嘘になる。
+        const info = parsed.rate_limit_info;
+        const status = typeof info === 'object' && info !== null ? String(info.status ?? '') : '';
+        if (status === 'rejected') {
+            push('info', '※ 使える量の上限に達しました（時間をおくと再開できます）');
+        }
+        else if (status.length > 0 && status !== 'allowed') {
+            push('info', '※ 使える量の上限に近づいています');
+        }
+        return out;
+    }
+    return out;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 便の題名（「何を良くする仕事か」の冒頭）
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 便の本文から「何を良くする仕事か」の冒頭を取る。
+ *
+ * ★管制は短い題名を返していない（実測 2026-10-02）。本文の先頭は配達の前置き
+ *   （「devlog の MCP はつながっています…」）なので、そのまま出すとお客さまには読めない。
+ *   本文の中に【何を良くする仕事か】の節が在れば、そこの1行目を使う。
+ */
+export function jobHeadline(body, max = 70) {
+    const text = (body ?? '').replace(/\r/g, '');
+    const m = /【\s*何を良くする仕事か\s*】([\s\S]*)/.exec(text);
+    if (m) {
+        const line = m[1]
+            .split('\n')
+            .map((l) => l.trim())
+            .find((l) => l.length > 0 && !l.startsWith('【'));
+        if (line !== undefined)
+            return clip(line, max);
+    }
+    return jobTitleFromBody(text, max);
+}
+/**
+ * 「開いたまま流れ続ける画面」。
+ *
+ * ★1周（poll）ごとに、便の切れ目と新しい記録だけを出す。
+ *   同じ記録を2回出さないために、読んだ場所（バイト）を覚えておく。
+ */
+export class FollowSession {
+    deps;
+    cur = null;
+    /** 直前に出した行（同じ文が続いたときに1行にまとめる）。 */
+    prevText = null;
+    /** 直前に出した行の時刻（時刻の無い記録に使う）。 */
+    lastAt = null;
+    waitingNoted = false;
+    oldRelayNoted = false;
+    unreadableNoted = false;
+    troubleNoted = false;
+    /** 道具の呼び出し（id）→ 道具の名前。結果の行を日本語でまとめるために覚えておく。 */
+    toolNames = new Map();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    now() {
+        return this.deps.now?.() ?? Date.now();
+    }
+    out(line) {
+        this.deps.out(line);
+    }
+    active() {
+        return (this.deps.loadActive ?? loadActiveJob)(this.deps.site);
+    }
+    last() {
+        return (this.deps.loadLast ?? loadLastJob)(this.deps.site);
+    }
+    rawPath(commandId, attempt) {
+        return (this.deps.rawPath ?? rawLogPath)(commandId, attempt);
+    }
+    /**
+     * 何かでつまずいても、英語の難しい文のまま落ちないようにする。
+     * ★黙って固まらない・理由と次の1手を日本語で出す（えふさん確定の決まり）。
+     */
+    safely(what, fn) {
+        try {
+            fn();
+        }
+        catch (err) {
+            if (this.troubleNoted)
+                return;
+            this.troubleNoted = true;
+            const why = err instanceof Error ? err.message : String(err);
+            this.out(`※${what}でつまずきました（${clip(maskSecrets(why), 80)}）。`);
+            this.out('　次の1手：Ctrl+C で閉じて、もう一度開いてください。何度も出るならサポートへこの画面をお送りください。');
+        }
+    }
+    /** 開いたときの1回：いまの状態 → これまでの流れ → 以後は poll で続く。 */
+    open() {
+        this.safely('画面の用意', () => {
+            this.out(this.header());
+            const active = this.active();
+            if (active !== null) {
+                this.beginFollow(active, { announce: false, backlog: true });
+            }
+            else {
+                this.noteWaiting();
+            }
+        });
+    }
+    /** 1周ぶん。便の切れ目と、増えた記録だけを出す。 */
+    poll() {
+        this.safely('様子の読み取り', () => {
+            this.pollOnce();
+        });
+    }
+    pollOnce() {
+        const active = this.active();
+        if (active === null) {
+            if (this.cur !== null) {
+                this.readNew(); // 残っている記録を出し切る
+                this.printJobEnd(this.cur);
+                this.cur = null;
+            }
+            this.noteWaiting();
+            return;
+        }
+        if (this.cur === null) {
+            this.beginFollow(active, { announce: true, backlog: false });
+        }
+        else if (this.cur.commandId !== active.commandId || this.cur.attempt !== active.attempt) {
+            this.readNew(); // 前の便の残りを出し切る
+            this.printJobEnd(this.cur);
+            this.cur = null;
+            this.beginFollow(active, { announce: true, backlog: false });
+        }
+        this.readNew();
+    }
+    /** いまの状態の見出し（通常表示の上半分と同じ言い方）。 */
+    header() {
+        const nowMs = this.now();
+        if (this.deps.header !== undefined)
+            return this.deps.header(this.deps.site, nowMs);
+        const v = collectSiteView(this.deps.site, nowMs);
+        const unknown = '—（確かめられません）';
+        const body = v.active?.body ?? v.last?.body ?? '';
+        const headline = jobHeadline(body);
+        const lines = [];
+        lines.push(`${v.site} ${STATUS_LABEL[v.status]}  ${STATUS_NOTE[v.status]}`);
+        lines.push(`仕事：${headline.length > 0 ? headline : unknown}`);
+        if (v.postedAt !== null)
+            lines.push(`投函：${friendlyTime(v.postedAt, nowMs)}`);
+        lines.push(`開始：${v.startedAt !== null ? friendlyTime(v.startedAt, nowMs) : '—（まだ起動していません）'}`);
+        if (v.startedAt !== null) {
+            const until = v.status === 'working' ? nowMs : (v.lastActivityAt ?? v.last?.finishedAt ?? nowMs);
+            lines.push(`実作業：${friendlyDuration(until - v.startedAt)}`);
+        }
+        const sinceActivityMs = v.lastActivityAt === null ? null : nowMs - v.lastActivityAt;
+        if (v.lastActivityAt !== null) {
+            lines.push(`最後に動いた：${friendlyTime(v.lastActivityAt, nowMs)}（${friendlyDuration(sinceActivityMs ?? 0)}前）`);
+        }
+        if (v.status === 'working') {
+            const note = quietActivityNote(sinceActivityMs);
+            if (note !== null)
+                lines.push(`※${note}`);
+        }
+        lines.push('');
+        lines.push('※見るだけの画面です（職人へは何も送りません／職人も作業部屋も見守り役も起動しません）');
+        lines.push('※開いたままにしておくと、下へ流れ続けます。閉じるときは Ctrl+C を押してください');
+        lines.push(RULE);
+        return lines.join('\n');
+    }
+    /** この便を追い始める。 */
+    beginFollow(active, opts) {
+        if (opts.announce) {
+            this.out(RULE);
+            this.out(`── 新しい便が始まりました（${friendlyTime(active.startedAt, this.now())}）`);
+            const headline = jobHeadline(active.body);
+            this.out(`仕事：${headline.length > 0 ? headline : '—（確かめられません）'}`);
+            this.out(RULE);
+        }
+        this.waitingNoted = false;
+        this.prevText = null;
+        // ★最初の行に時刻が無いとき（職人の起動の知らせ）は、便の開始時刻を使う。
+        this.lastAt = Number.isFinite(active.startedAt) ? active.startedAt : null;
+        this.toolNames = new Map();
+        this.cur = {
+            commandId: active.commandId,
+            attempt: active.attempt,
+            offset: 0,
+            partial: Buffer.alloc(0),
+            missingNoted: false,
+        };
+        // ★見守り役が古い版だと、職人の番号も細かい記録も残らない。黙って固まらずに理由を出す。
+        if (active.pid === undefined && !this.oldRelayNoted) {
+            this.oldRelayNoted = true;
+            this.out('※このPCの見守り役は古い版のようです（職人の番号が記録に入っていません）。');
+            this.out('　次の1手：新しい版を配ってから、現場ごとに見守り役を入れ直してください（人の窓の作業です）。');
+        }
+        if (opts.backlog)
+            this.readBacklog();
+    }
+    /** 開いたときの「これまでの分」を、末尾だけ振り返って出す。 */
+    readBacklog() {
+        const cur = this.cur;
+        if (cur === null)
+            return;
+        const p = this.rawPath(cur.commandId, cur.attempt);
+        const chunk = readTail(p, FOLLOW_BACKLOG_BYTES);
+        if (chunk === null)
+            return;
+        // 途中から読んだときは、先頭の切れた行を捨てる。
+        const text = chunk.startedMidFile
+            ? chunk.text.slice(chunk.text.indexOf('\n') + 1)
+            : chunk.text;
+        const lines = [];
+        for (const raw of text.split('\n')) {
+            for (const l of this.linesFromRawText(raw))
+                lines.push(l);
+        }
+        const max = this.deps.backlogLines ?? FOLLOW_BACKLOG_LINES;
+        const shown = lines.slice(-max);
+        if (lines.length > shown.length) {
+            this.out(`（これより前の ${lines.length - shown.length} 行は省きました）`);
+        }
+        for (const l of shown)
+            this.print(l);
+        if (shown.length === 0)
+            this.out('（まだ職人の動きが記録されていません。出たらここに流れます）');
+        cur.offset = chunk.size;
+        cur.partial = Buffer.alloc(0);
+    }
+    /** 増えた分だけを読んで出す（★同じ記録を2回読まないために場所を覚えている）。 */
+    readNew() {
+        const cur = this.cur;
+        if (cur === null)
+            return;
+        const p = this.rawPath(cur.commandId, cur.attempt);
+        let fd = null;
+        try {
+            if (!existsSync(p)) {
+                if (!cur.missingNoted) {
+                    cur.missingNoted = true;
+                    this.out('※職人の記録のファイルがまだ見つかりません。');
+                    this.out('　次の1手：見守り役が新しい版かを確かめてください（古い版では細かい記録が残りません）。');
+                }
+                return;
+            }
+            const size = statSync(p).size;
+            if (size < cur.offset) {
+                // 記録が作り直された（attempt のやり直しなど）。先頭から読み直す。
+                this.out('※記録が作り直されました。ここから続けて出します。');
+                cur.offset = 0;
+                cur.partial = Buffer.alloc(0);
+            }
+            if (size === cur.offset)
+                return;
+            fd = openSync(p, 'r');
+            const len = size - cur.offset;
+            const buf = Buffer.alloc(len);
+            const got = readSync(fd, buf, 0, len, cur.offset);
+            cur.offset += got;
+            const all = Buffer.concat([cur.partial, buf.subarray(0, got)]);
+            const lastBreak = all.lastIndexOf(0x0a); // '\n'
+            if (lastBreak < 0) {
+                cur.partial = all;
+                return;
+            }
+            cur.partial = all.subarray(lastBreak + 1);
+            const text = all.subarray(0, lastBreak).toString('utf8');
+            for (const raw of text.split('\n')) {
+                for (const l of this.linesFromRawText(raw))
+                    this.print(l);
+            }
+        }
+        catch (err) {
+            if (!this.unreadableNoted) {
+                this.unreadableNoted = true;
+                const why = err instanceof Error ? err.message : String(err);
+                this.out(`※職人の記録を読めませんでした（${clip(maskSecrets(why), 80)}）。`);
+                this.out('　次の1手：少し待ってからもう一度開いてください。何度も出るならサポートへこの画面をお送りください。');
+            }
+        }
+        finally {
+            if (fd !== null) {
+                try {
+                    closeSync(fd);
+                }
+                catch {
+                    // 閉じられないときは何もしない（読むだけなので害はない）。
+                }
+            }
+        }
+    }
+    /** 生の記録の1行を、画面に出す行（＋--detail の生の行）にする。 */
+    linesFromRawText(raw) {
+        if (raw.trim().length === 0)
+            return [];
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            return []; // 壊れている行・書き込み途中の行は飛ばす
+        }
+        const lines = humanLinesFromRecord(parsed, this.toolNames);
+        if (this.deps.detail === true && lines.length > 0) {
+            lines.push({
+                at: lines[0].at,
+                kind: 'info',
+                text: `  ｜${maskSecrets(raw).slice(0, DETAIL_LINE_CHARS_MAX)}`,
+            });
+        }
+        return lines;
+    }
+    /**
+     * 1行を画面に出す（時刻つき・同じ文が続いたら出さない）。
+     *
+     * ★記録に時刻が無い行（職人の起動の知らせ・終わりの知らせ）は、
+     *   直前の行の時刻を使う。今の時刻を打つと、振り返りの行が
+     *   「昔の行なのに今の時刻」になって並びが狂う（実機 2026-10-02 で確認）。
+     */
+    print(line) {
+        if (line.text === this.prevText)
+            return;
+        this.prevText = line.text;
+        if (line.at !== null)
+            this.lastAt = line.at;
+        this.out(`${hhmm(line.at ?? this.lastAt ?? this.now())} ${line.text}`);
+    }
+    /** 便の終わりを出す（結末＝完了／失敗と理由）。 */
+    printJobEnd(cur) {
+        const last = this.last();
+        this.out(RULE);
+        if (last !== null && last.commandId === cur.commandId) {
+            this.out(`── 便が終わりました（${friendlyTime(last.finishedAt, this.now())}）`);
+            this.out(`結末：${LAST_OUTCOME_LABEL[last.outcome] ?? last.outcome}`);
+            if (last.detail !== undefined && last.detail.length > 0) {
+                this.out(`理由：${clip(maskSecrets(last.detail), 200)}`);
+            }
+            this.out(`かかった時間：${friendlyDuration(last.finishedAt - last.startedAt)}`);
+        }
+        else {
+            this.out('── 便が終わりました（結末がまだ記録されていません）');
+            this.out('※少し待つと結末が記録されます。もう一度開き直すと読めます。');
+        }
+        this.out(RULE);
+    }
+    /** 便が無いときの知らせ（★1回だけ出して、そのまま待つ）。 */
+    noteWaiting() {
+        if (this.waitingNoted)
+            return;
+        this.waitingNoted = true;
+        this.out('⏳ 待機中（いまは便がありません。次の便を待っています）');
+        this.out('※このまま開いておけば、次の便が始まったときに自動で流れ始めます');
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 入口（view.ts が呼ぶ）
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 開いたまま流れ続ける画面を動かす。Ctrl+C（SIGINT）で抜ける。
+ *
+ * ★抜けても職人・見守り役には何も起きない（読むだけなので、やめるのも読むのをやめるだけ）。
+ */
+export async function runFollowCommand(site, detail) {
+    const session = new FollowSession({
+        site,
+        detail,
+        out: (line) => {
+            console.log(line);
+        },
+    });
+    session.open();
+    let stop = false;
+    const onStop = () => {
+        stop = true;
+    };
+    process.on('SIGINT', onStop);
+    process.on('SIGTERM', onStop);
+    try {
+        while (!stop) {
+            await new Promise((resolve) => {
+                setTimeout(resolve, FOLLOW_POLL_MS);
+            });
+            if (stop)
+                break;
+            session.poll();
+        }
+    }
+    finally {
+        process.off('SIGINT', onStop);
+        process.off('SIGTERM', onStop);
+    }
+    console.log('');
+    console.log('画面を閉じました（職人はそのまま動いています）');
+    return 0;
+}
+/** ファイルの末尾だけを読む（★全部は読まない）。読めなければ null。 */
+function readTail(p, maxBytes) {
+    let fd = null;
+    try {
+        if (!existsSync(p))
+            return null;
+        const size = statSync(p).size;
+        if (size === 0)
+            return { text: '', size, startedMidFile: false };
+        const from = size > maxBytes ? size - maxBytes : 0;
+        const len = size - from;
+        fd = openSync(p, 'r');
+        const buf = Buffer.alloc(len);
+        const got = readSync(fd, buf, 0, len, from);
+        return { text: buf.subarray(0, got).toString('utf8'), size, startedMidFile: from > 0 };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        if (fd !== null) {
+            try {
+                closeSync(fd);
+            }
+            catch {
+                // 読むだけなので、閉じられなくても害はない。
+            }
+        }
+    }
+}

package/dist/view.js

@@ -8,6 +8,8 @@
  *   ＝「見えない」だけでなく「触ると危ない」状態だった。
  *
  * 【この画面の約束（えふさん確定 2026-10-02）】
+ *   ⓪ 既定は「開いたまま流れ続ける」（判断7・便 a56e49bf）。流れ続ける部分は
+ *      src/view-stream.ts に置く。このファイルは「いまの様子を1回出す」（--once）形を持つ。
  *   ① 通常＝人間向けの日本語／詳細＝Claude Code の生ログ の2段構成。
  *      以前の画面をそのまま流すのではなく、非エンジニアが読んで分かる形にする。
  *   ② 「🟠 作業中」と出してよいのは、実プロセスが動いている ＋ 最近の作業記録がある
@@ -472,27 +474,40 @@ export function readRawLogLines(v) {
 // 入口（cli.ts が呼ぶ）
 // ─────────────────────────────────────────────────────────────────────────────
 /**
- * `conductor view <現場名> [--detail]` の本体。
- * ★何も起動しない・通信しない・入力を受け付けない。画面に出して終わる。
+ * `conductor view <現場名> [--once] [--detail]` の本体。
+ * ★何も起動しない・通信しない・入力を受け付けない。
+ *
+ * 【既定は「開いたまま流れ続ける」（えふさん確定 2026-10-02・判断7）】
+ *   画面あり方式の頃のように、開いておけば職人の動きが下へ流れ続ける。
+ *   Ctrl+C で抜ける（★抜けても職人・見守り役には何も起きない）。
+ * 【--once】これまでどおり「いまの様子を1回出して終わる」（古い呼び方を壊さない）。
+ * 【--detail】生の記録（秘密は隠したもの）も続けて出す。意味は変えない。
  */
-export function runViewCommand(argv) {
+export async function runViewCommand(argv) {
     const detail = argv.includes('--detail');
+    const once = argv.includes('--once');
     const site = argv.find((a) => !a.startsWith('-'));
     if (site === undefined || site.length === 0) {
-        console.error('使い方: conductor view <現場名> [--detail]');
+        console.error('使い方: conductor view <現場名> [--once] [--detail]');
         return 2;
     }
-    // ★現場のフォルダが無い＝この PC の現場ではない。何も作らずに知らせる。
+    // ★現場のフォルダが無い＝この PC の現場ではない。何も作らずに、次の1手を添えて知らせる。
     const projectDir = path.join(os.homedir(), 'projects', site);
     if (!existsSync(projectDir)) {
         console.error(`そんな現場はありません: ${site}`);
+        console.error('次の1手：このPCの現場の名前は ls ~/projects で確かめられます（大文字小文字も合わせてください）。');
         return 1;
     }
-    const v = collectSiteView(site);
-    console.log(renderNormalView(v));
-    if (detail) {
-        console.log('');
-        console.log(renderDetailView(v, readRawLogLines(v)));
+    if (once) {
+        const v = collectSiteView(site);
+        console.log(renderNormalView(v));
+        if (detail) {
+            console.log('');
+            console.log(renderDetailView(v, readRawLogLines(v)));
+        }
+        return 0;
     }
-    return 0;
+    // ★流れ続ける画面は別のファイルに置く（--once の道は1バイトも変えない）。
+    const { runFollowCommand } = await import('./view-stream.js');
+    return runFollowCommand(site, detail);
 }

package/package.json

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