@tyhld/conductor 0.12.53 → 0.12.55

package/dist/cli.js

@@ -13,7 +13,9 @@ import { execFileSync, spawnSync } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import os from 'node:os';
+import path from 'node:path';
 import { RELAY_FETCH_TIMEOUT_MS, createRelayState, deliveryReport, parseAgentKind, reconnectDelayMs, relayTick, tmuxHasSession, pendingReportIds, sendPendingReportFiles, sweepProcessedReports, } from './relay.js';
+import { createHeadlessState, headlessNextDelayMs, headlessTick, parseRunnerMode, } from './headless.js';
 import { createRelayRunner } from './relay-runner.js';
 import { installProcessGuards } from './process-guard.js';
 import { registerNudgeTarget, unregisterNudgeTarget, watchNudges, } from './nudge.js';
@@ -144,6 +146,9 @@ function loadConfig(args) {
         }
         promptIntervalSec = parsed;
     }
+    // ★配達方式（えふさん確定）。既定 'tmux'。'headless' で画面なし方式に切り替わる。
+    //   秘密ではないので ~/.conductor.env には入れない（systemd の drop-in か直接の export）。
+    const runnerMode = parseRunnerMode(process.env.CONDUCTOR_RUNNER_MODE);
     return {
         url: url.replace(/\/+$/, ''),
         token,
@@ -157,6 +162,7 @@ function loadConfig(args) {
         promptIntervalSec,
         agentKind,
         freshContext,
+        runnerMode,
     };
 }
 /** 1回分の報告を送る。送信結果（HTTPステータス）をログ表示する。 */
@@ -167,7 +173,8 @@ async function sendReport(cfg) {
         branch: detectBranch(),
         status: cfg.status,
         lastAction: cfg.lastAction,
-        artisanReady: tmuxHasSession(cfg.site),
+        // headless 方式では tmux セッションは使わない。ジョブ実行中または空きで待機中なら ready。
+        artisanReady: cfg.runnerMode === 'headless' ? cfg.relayEnabled : tmuxHasSession(cfg.site),
     };
     // ★relay が動いている機だけ、2段目（いま配れるか）を足す。
     //   未配達でないときは秒数と指示idを載せない＝管制で「遅れ」を数えない。
@@ -266,39 +273,60 @@ async function start(args) {
     //     ポーリングの間隔はこれまでどおり（15秒/承認待ち3秒）。耳が死んでいる間の保険として残す。
     let relayRunner = null;
     let nudgeWatcher = null;
+    // ★headless 方式の状態参照（sendReport のアダプタ用）。tmux のときは null のまま。
+    let headlessStateRef = null;
     if (cfg.relayEnabled) {
-        console.log(`[relay] 有効: site=${cfg.site} interval=${cfg.relayIntervalSec}s ` +
-            `（承認待ちの間だけ ${cfg.promptIntervalSec}s に短縮）` +
-            `（tmuxセッション "${cfg.site}" がアイドルのときだけ送信します）`);
-        const relayState = createRelayState();
-        // 生存報告に「いま配れるか」を載せるための参照（便 600d2a6a）。
-        relayStateForReport = relayState;
-        relayRunner = createRelayRunner({
-            tick: () => relayTick(cfg, relayState, {
-                // ★管制へつながらない状態から戻った瞬間に1回だけ呼ばれる。
-                //   既にある口（現場の生存報告）を1回叩き、管制の一覧の札をすぐ正しく戻す。
-                onCentralReconnect: () => {
-                    console.log('[relay] 管制へ現場の生存報告を1回送り直します（再接続の直後）');
-                    void sendReport(cfg);
+        if (cfg.runnerMode === 'headless') {
+            // ── headless 方式（画面なし・便ごとに claude -p を起動する） ──
+            const workDir = path.resolve(os.homedir(), 'projects', cfg.site);
+            console.log(`[headless] 有効: site=${cfg.site} mode=headless workDir=${workDir} ` +
+                `interval=${cfg.relayIntervalSec}s`);
+            const hState = createHeadlessState();
+            headlessStateRef = hState;
+            // 生存報告に「いま配れるか」を載せるため、内包する RelayState を参照する。
+            relayStateForReport = hState.relay;
+            const hCfg = { ...cfg, workDir };
+            relayRunner = createRelayRunner({
+                tick: () => headlessTick(hCfg, hState, {
+                    onCentralReconnect: () => {
+                        console.log('[headless] 管制へ現場の生存報告を1回送り直します（再接続の直後）');
+                        void sendReport(cfg);
+                    },
+                }),
+                nextDelayMs: () => headlessNextDelayMs(hState, cfg.relayIntervalSec),
+                onError: (err) => {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.log(`[headless] site=${cfg.site} tick で例外: ${msg}（次回に再試行）`);
                 },
-            }),
-            // ★管制へつながらない間だけ、再試行の間隔（5秒→10→20→40→60秒・上限後は60秒のまま永久に）。
-            //   つながっていれば従来どおり: 承認プロンプト待ちの間だけ短い間隔、それ以外は通常間隔
-            //   （★間隔は耳を付けても変えない＝線が切れている間はこのポーリングがそのまま肩代わりする保険）。
-            nextDelayMs: () => relayState.central.failures > 0
-                ? reconnectDelayMs(relayState.central.failures)
-                : (relayState.promptPending ? cfg.promptIntervalSec : cfg.relayIntervalSec) * 1000,
-            onError: (err) => {
-                // ループは絶対に止めない（1回の失敗で relay が死ぬと配達も承認も止まる）。
-                const msg = err instanceof Error ? err.message : String(err);
-                console.log(`[relay] site=${cfg.site} tick で例外: ${msg}（次回に再試行）`);
-            },
-        });
+            });
+        }
+        else {
+            // ── tmux 方式（従来どおり） ──
+            console.log(`[relay] 有効: site=${cfg.site} mode=tmux interval=${cfg.relayIntervalSec}s ` +
+                `（承認待ちの間だけ ${cfg.promptIntervalSec}s に短縮）` +
+                `（tmuxセッション "${cfg.site}" がアイドルのときだけ送信します）`);
+            const relayState = createRelayState();
+            // 生存報告に「いま配れるか」を載せるための参照（便 600d2a6a）。
+            relayStateForReport = relayState;
+            relayRunner = createRelayRunner({
+                tick: () => relayTick(cfg, relayState, {
+                    onCentralReconnect: () => {
+                        console.log('[relay] 管制へ現場の生存報告を1回送り直します（再接続の直後）');
+                        void sendReport(cfg);
+                    },
+                }),
+                nextDelayMs: () => relayState.central.failures > 0
+                    ? reconnectDelayMs(relayState.central.failures)
+                    : (relayState.promptPending ? cfg.promptIntervalSec : cfg.relayIntervalSec) * 1000,
+                onError: (err) => {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.log(`[relay] site=${cfg.site} tick で例外: ${msg}（次回に再試行）`);
+                },
+            });
+        }
         void relayRunner.run(); // 起動直後に1回。以後は自分で次を積む。
         // ADR-066 便2c: 耳の常駐(conductor ear / この機に1本)からの呼び鈴を受ける。
-        //   ・自分の合図ファイル（空ファイル）を用意する＝「この現場のrelayが動いている」の名簿登録も兼ねる。
-        //   ・呼び鈴が鳴ったらポーリング1周を前倒しするだけ。合図に中身は無く、指示は従来どおり取得APIから取る。
-        //   ・呼び鈴が来なくても・耳が落ちていても、上のポーリングがそのまま動く（耳は加速装置であって依存先ではない）。
+        //   ★headless でも同じ呼び鈴を受ける（指示取得を前倒しする仕組みは方式を問わない）。
         const registered = registerNudgeTarget(cfg.site);
         if (registered !== null) {
             console.log(`[relay] 合図の受け口: ${registered}（耳からの「今すぐ1周」を受けます）`);
@@ -457,6 +485,9 @@ function printUsage() {
         '  CONDUCTOR_RELAY_INTERVAL_SEC  relayポーリング間隔・秒（既定: 15）',
         '  CONDUCTOR_RELAY_PROMPT_INTERVAL_SEC  承認待ちの間だけ使う短い間隔・秒（既定: 3）',
         '',
+        '配達方式の切替（★PCごとに設定。relay を再起動すると切り替わる）:',
+        '  CONDUCTOR_RUNNER_MODE        tmux（既定）か headless。headless は便ごとに claude -p を起動する画面なし方式',
+        '',
         '管制につながらないとき（★relayは止まりません。待って再試行し、戻ったら自動で通常へ）:',
         '  RELAY_FETCH_TIMEOUT_MS    管制への問い合わせ1回の上限・ミリ秒（既定: 20000）',
         '  RELAY_RECONNECT_BASE_MS   再試行の最初の待ち・ミリ秒（既定: 5000。以後 倍々に伸ばす）',

package/dist/headless.js

@@ -0,0 +1,570 @@
+/**
+ * @tyhld/conductor — headless runner（画面なし方式）。
+ *
+ * tmux の代わりに、便ごとに `claude -p` を子プロセスで起動する。
+ *
+ * 【同時1指示】走る子プロセスは常に1つだけ。tmux 方式と同じ「1現場同時1指示」の不変条件を守る。
+ * 【入れ子防止】CLAUDECODE=1 は子プロセスの環境から外す（Claude Code が入れ子起動をブロックするため）。
+ * 【鍵の保護】ANTHROPIC_API_KEY も外す（今の tmux 起動と同じ。子プロセスは自分の鍵を使う）。
+ * 【秘密のマスク】進捗イベントを管制へ送る前に、鍵・トークン・パスワードをマスクする。
+ *
+ * 【なぜ切り出すか】headless 方式は tmux 方式とは配達・完了検出・状態管理が根本的に違う。
+ *   tmux: 「常駐する職人の画面へ貼り付ける → 画面の DONE 行を監視する」
+ *   headless: 「便ごとにプロセスを起動する → プロセスの終了を検出する」
+ *   同じ relayTick に分岐を詰め込むと壊れやすいので、独立したモジュールにする。
+ *   共通の管制との通信（fetchControl, fetchCommand, patchStatus 等）は relay.ts から使う。
+ */
+import { spawn } from 'node:child_process';
+import { createInterface } from 'node:readline';
+import { RELAY_DELIVER_MAX, RELAY_FETCH_TIMEOUT_MS, RELAY_HEARTBEAT_INTERVAL_MS, RELAY_PENDING_TIMEOUT_MS, RELAY_RESTORE_ORPHANS_ENABLED, buildAnchor, buildSendText, canDeliver, completeWithReport, createRelayState, deliveryReport, fetchCommand, fetchCommandStatus, fetchControl, fetchOrphans, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteReadiness, patchStatus, reconnectDelayMs, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
+const log = (msg) => {
+    console.log(`[headless] ${msg}`);
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// 定数
+// ─────────────────────────────────────────────────────────────────────────────
+/** 子プロセスへ SIGTERM を送ってから SIGKILL までの猶予(ms)。 */
+export const HEADLESS_KILL_GRACE_MS = 10_000;
+/** 1つの便を自動再開する最大試行回数（これを超えたら failed にして諦める）。 */
+export const HEADLESS_MAX_ATTEMPTS = 3;
+/** 進捗イベントのバッチ送信間隔(ms)。この間隔でバッファを管制へ流す。 */
+export const HEADLESS_EVENT_FLUSH_MS = 2_000;
+/** 実行中に stop_requested を確かめる間隔(ms)。 */
+export const HEADLESS_STOP_CHECK_MS = 15_000;
+/** イベントの text フィールドの上限(文字)。 */
+export const EVENT_TEXT_MAX = 500;
+/** resume 時に職人へ渡す続行指示。 */
+const RESUME_PROMPT = '前回の作業の続きを行ってください。中断された箇所から再開してください。';
+// ─────────────────────────────────────────────────────────────────────────────
+// 秘密のマスク
+// ─────────────────────────────────────────────────────────────────────────────
+/** 秘密の値を検出するパターン。マッチした部分を *** に置換してからイベントを送る。 */
+const SECRET_PATTERNS = [
+    /(?:CONDUCTOR_TOKEN|ANTHROPIC_API_KEY|API_KEY|SECRET_KEY|PASSWORD|DATABASE_URL|SUPABASE_SERVICE_ROLE_KEY)\s*[=:]\s*\S+/gi,
+    /Bearer\s+[A-Za-z0-9._~+/=-]{10,}/g,
+    /sk-ant-[A-Za-z0-9-]{20,}/g,
+    /sk-[A-Za-z0-9]{20,}/g,
+];
+export function maskSecrets(text) {
+    let masked = text;
+    for (const re of SECRET_PATTERNS) {
+        // 毎回 lastIndex をリセット（gフラグ付き RegExp の再利用に必要）。
+        re.lastIndex = 0;
+        masked = masked.replace(re, (m) => {
+            const sepIdx = m.search(/[=:]\s*/);
+            if (sepIdx >= 0) {
+                const afterSep = m.indexOf(m[sepIdx]) + 1;
+                return m.slice(0, afterSep) + '***';
+            }
+            if (/^Bearer\s/i.test(m))
+                return 'Bearer ***';
+            return '***';
+        });
+    }
+    return masked;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// ヘルパー
+// ─────────────────────────────────────────────────────────────────────────────
+/** commandId からセッション ID を作る（resume で再利用する決定的な値）。 */
+export function sessionIdForCommand(commandId) {
+    return `conductor-${commandId}`;
+}
+/** stream-json の1行を CommandEvent に変換する。無関係な行は null。 */
+export function streamEventToCommandEvent(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)
+            return null;
+        return { type: 'progress', text: maskSecrets(text), at: now, attempt };
+    }
+    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 === 'result') {
+        if (subtype === 'error') {
+            const errText = String(parsed.error ?? '').slice(0, EVENT_TEXT_MAX);
+            return { type: 'error', text: maskSecrets(errText), at: now, attempt };
+        }
+        const resultText = String(parsed.result ?? '').slice(0, EVENT_TEXT_MAX);
+        return { type: 'result', text: maskSecrets(resultText), at: now, attempt };
+    }
+    return null;
+}
+/** 子プロセスの stderr から認証エラーを検出する。 */
+export function isAuthError(job) {
+    const s = job.stderrBuf.toLowerCase();
+    return (s.includes('401') ||
+        s.includes('unauthorized') ||
+        s.includes('authentication failed') ||
+        s.includes('invalid api key') ||
+        s.includes('invalid_api_key'));
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 子プロセスの起動と停止
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * claude -p を子プロセスとして起動する。
+ *
+ * 【環境変数】
+ *   CLAUDECODE を外す … 入れ子防止の解除。これが残っていると claude -p が起動しない。
+ *   ANTHROPIC_API_KEY を外す … 今の tmux 起動と同じ。子プロセスは自分の鍵で認証する。
+ *   CONDUCTOR_SITE, CONDUCTOR_MACHINE を渡す … フック（hooks）が管制と話すために使う。
+ *
+ * 【stdin】
+ *   初回: 指示本文（buildSendText で組み立てた1つのメッセージ）を書いて閉じる。
+ *   resume: 続行指示を書いて閉じる。
+ *
+ * 【stdout】stream-json 形式。行ごとに JSON を出す。readline で1行ずつ読む。
+ * 【stderr】蓄積して認証エラーの検出に使う。
+ */
+export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
+    const env = { ...process.env };
+    delete env.CLAUDECODE;
+    delete env.ANTHROPIC_API_KEY;
+    env.CONDUCTOR_SITE = cfg.site;
+    env.CONDUCTOR_MACHINE = cfg.machine;
+    const args = [
+        '-p',
+        '--output-format', 'stream-json',
+        '--permission-mode', cfg.permissionMode ?? 'acceptEdits',
+        '--session-id', sessionId,
+    ];
+    if (isResume)
+        args.push('--resume');
+    const proc = spawn('claude', args, {
+        cwd: cfg.workDir,
+        env,
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    const job = {
+        commandId: cmd.id,
+        process: proc,
+        sessionId,
+        startedAt: Date.now(),
+        attempt,
+        completed: false,
+        exitCode: null,
+        exitSignal: null,
+        stopped: false,
+        eventBuffer: [],
+        lastFlushAt: Date.now(),
+        lastStopCheckAt: Date.now(),
+        stderrBuf: '',
+    };
+    // stdin: 指示本文を書いて閉じる
+    if (proc.stdin) {
+        if (isResume) {
+            proc.stdin.write(RESUME_PROMPT);
+        }
+        else {
+            const anchor = buildAnchor(cmd.id);
+            const text = buildSendText(cmd.body, cfg.site, anchor, kindOf(cfg));
+            proc.stdin.write(text);
+        }
+        proc.stdin.end();
+    }
+    // stdout: stream-json を行ごとに読み、CommandEvent に変換してバッファへ
+    if (proc.stdout) {
+        const rl = createInterface({ input: proc.stdout });
+        rl.on('line', (line) => {
+            try {
+                const parsed = JSON.parse(line);
+                const event = streamEventToCommandEvent(parsed, attempt);
+                if (event)
+                    job.eventBuffer.push(event);
+            }
+            catch {
+                // JSON でないか壊れている行 — 無視
+            }
+        });
+    }
+    // stderr: 蓄積（認証エラー検出用。上限5000字で先頭を切り落とす）
+    if (proc.stderr) {
+        proc.stderr.on('data', (chunk) => {
+            job.stderrBuf += chunk.toString('utf8');
+            if (job.stderrBuf.length > 5000) {
+                job.stderrBuf = job.stderrBuf.slice(-3000);
+            }
+        });
+    }
+    // 終了検出
+    proc.on('exit', (code, signal) => {
+        job.completed = true;
+        job.exitCode = code;
+        job.exitSignal = signal?.toString() ?? null;
+    });
+    return job;
+}
+/**
+ * 子プロセスを停止する。SIGTERM → 猶予 → SIGKILL。
+ * プロセスが既に終わっていれば何もしない。
+ */
+export async function stopJob(job) {
+    if (job.completed)
+        return;
+    const proc = job.process;
+    proc.kill('SIGTERM');
+    // 猶予の間に終了するのを待つ
+    const died = await Promise.race([
+        new Promise((resolve) => {
+            proc.once('exit', () => resolve(true));
+        }),
+        new Promise((resolve) => {
+            setTimeout(() => resolve(false), HEADLESS_KILL_GRACE_MS);
+        }),
+    ]);
+    if (!died && !job.completed) {
+        proc.kill('SIGKILL');
+        // SIGKILL は必ず効くので短く待つ
+        await new Promise((resolve) => {
+            const t = setTimeout(resolve, 1000);
+            proc.once('exit', () => {
+                clearTimeout(t);
+                resolve();
+            });
+        });
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// イベント送信
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 管制の events API へイベントを送る。
+ * POST /api/conductor/commands/{commandId}/events
+ */
+export async function sendCommandEvents(cfg, commandId, events) {
+    if (events.length === 0)
+        return true;
+    try {
+        const res = await fetch(`${cfg.url}/api/conductor/commands/${commandId}/events`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${cfg.token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ events }),
+            signal: AbortSignal.timeout(RELAY_FETCH_TIMEOUT_MS),
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/** バッファに溜まったイベントを管制へ送り、バッファを空にする。 */
+export async function flushEvents(cfg, job) {
+    if (job.eventBuffer.length === 0)
+        return;
+    const events = job.eventBuffer.splice(0);
+    job.lastFlushAt = Date.now();
+    // 送信失敗は握り潰す（最善努力。進捗が欠けても作業は止まらない）。
+    await sendCommandEvents(cfg, job.commandId, events);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 実行中ジョブの監視
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 実行中のジョブを1tick分チェックする。
+ * 完了・停止・タイムアウト・生存通知・イベントフラッシュを処理する。
+ */
+async function checkRunningJob(cfg, state) {
+    const job = state.job;
+    if (job === null)
+        return;
+    const rs = state.relay;
+    // ── 完了したプロセスの後始末 ──
+    if (job.completed) {
+        await flushEvents(cfg, job);
+        if (job.stopped) {
+            // stop_requested で止めた
+            await sendCommandEvents(cfg, job.commandId, [{
+                    type: 'stopped',
+                    text: `stop_requested により停止 (exit=${job.exitCode}, signal=${job.exitSignal})`,
+                    at: new Date().toISOString(),
+                    attempt: job.attempt,
+                }]);
+            state.job = null;
+            rs.lastHeartbeatAt = null;
+            log(`site=${cfg.site} id=${job.commandId} stop_requested で停止`);
+            return;
+        }
+        if (isAuthError(job)) {
+            // 認証エラー → 再試行しない
+            await sendCommandEvents(cfg, job.commandId, [{
+                    type: 'auth_error',
+                    text: maskSecrets(`認証エラー (exit=${job.exitCode}): ${job.stderrBuf.slice(0, 300)}`).slice(0, EVENT_TEXT_MAX),
+                    at: new Date().toISOString(),
+                    attempt: job.attempt,
+                }]);
+            // ★patchStatus は 'failed' を受け付けないので、放棄だけして中央の stalled/timeout に委ねる。
+            rs.abandoned.add(job.commandId);
+            state.job = null;
+            rs.lastHeartbeatAt = null;
+            log(`WARN site=${cfg.site} id=${job.commandId} 認証エラー → 再試行しない`);
+            return;
+        }
+        if (job.exitCode === 0) {
+            // 正常終了 → 完了を中央へ報告
+            const ok = await completeWithReport(cfg, job.commandId, log);
+            if (ok) {
+                log(`site=${cfg.site} id=${job.commandId} 完了（exit=0, attempt ${job.attempt}）`);
+            }
+            else {
+                // 報告を書けなかった場合でも status=done だけは書く
+                await patchStatus(cfg, job.commandId, 'done');
+                log(`site=${cfg.site} id=${job.commandId} 完了（exit=0, 報告なし）`);
+            }
+            state.job = null;
+            rs.lastHeartbeatAt = null;
+            return;
+        }
+        // 異常終了 → 次の tick で自動再開を試みる
+        await sendCommandEvents(cfg, job.commandId, [{
+                type: 'error',
+                text: maskSecrets(`異常終了 (exit=${job.exitCode}, signal=${job.exitSignal}): ${job.stderrBuf.slice(0, 300)}`).slice(0, EVENT_TEXT_MAX),
+                at: new Date().toISOString(),
+                attempt: job.attempt,
+            }]);
+        const nextAttempt = (state.attempts.get(job.commandId) ?? job.attempt) + 1;
+        if (nextAttempt > HEADLESS_MAX_ATTEMPTS) {
+            log(`WARN site=${cfg.site} id=${job.commandId} 試行回数上限(${HEADLESS_MAX_ATTEMPTS}) → 放棄`);
+            rs.abandoned.add(job.commandId);
+        }
+        else {
+            log(`WARN site=${cfg.site} id=${job.commandId} 異常終了(exit=${job.exitCode}) → ` +
+                `次の tick で再開を試みます (attempt ${nextAttempt}/${HEADLESS_MAX_ATTEMPTS})`);
+        }
+        state.job = null;
+        rs.lastHeartbeatAt = null;
+        return;
+    }
+    // ── 実行中のプロセスの監視 ──
+    const now = Date.now();
+    // stop_requested の確認（間隔を置いて中央へ問い合わせる）
+    if (now - job.lastStopCheckAt >= HEADLESS_STOP_CHECK_MS) {
+        job.lastStopCheckAt = now;
+        const status = await fetchCommandStatus(cfg, job.commandId);
+        if (status === 'stop_requested' || isTerminalCommandStatus(status)) {
+            log(`site=${cfg.site} id=${job.commandId} ${status} → SIGTERM`);
+            job.stopped = true;
+            await stopJob(job);
+            return;
+        }
+    }
+    // タイムアウト
+    if (now - job.startedAt > RELAY_PENDING_TIMEOUT_MS) {
+        log(`WARN site=${cfg.site} id=${job.commandId} タイムアウト(${Math.round((now - job.startedAt) / 1000)}s) → SIGTERM`);
+        job.stopped = true;
+        await stopJob(job);
+        return;
+    }
+    // 生存ハートビート
+    const throttleOk = rs.lastHeartbeatAt === null || now - rs.lastHeartbeatAt >= RELAY_HEARTBEAT_INTERVAL_MS;
+    if (throttleOk) {
+        rs.lastHeartbeatAt = now;
+        await sendHeartbeat(cfg, job.commandId, true);
+    }
+    // イベントバッファのフラッシュ
+    if (now - job.lastFlushAt >= HEADLESS_EVENT_FLUSH_MS && job.eventBuffer.length > 0) {
+        await flushEvents(cfg, job);
+    }
+    // 可観測性
+    noteReadiness(rs, 'busy', job.commandId);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// PC 再起動後の孤児復元
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * sent孤児を1件取得し、--resume で再開する（起動時1回）。
+ *
+ * PC 再起動後、「やっています(sent)」のまま残った便を中央から見つけ、
+ * 決定的なセッション ID（conductor-{commandId}）で resume する。
+ * Claude Code はセッションを ~/.claude/ に保存するので、同じセッション ID で
+ * 再開すれば前回の途中から続けられる。
+ *
+ * ★tmux 方式の restoreOrphans と同じ呼び出し経路（fetchOrphans → selectOrphanToRestore）
+ *   を使う。headless では復元 = 即座に子プロセスを起動する（tmux のように pending に積んで待つ
+ *   のではなく、直接 resume する）。
+ */
+export async function restoreHeadlessOrphans(cfg, state) {
+    if (!RELAY_RESTORE_ORPHANS_ENABLED)
+        return;
+    if (state.job !== null)
+        return; // 既にジョブ実行中
+    const orphans = await fetchOrphans(cfg);
+    const pick = selectOrphanToRestore(orphans, null);
+    if (pick === null)
+        return;
+    const sessionId = sessionIdForCommand(pick.id);
+    const attempt = (state.attempts.get(pick.id) ?? 0) + 1;
+    state.attempts.set(pick.id, attempt);
+    if (attempt > HEADLESS_MAX_ATTEMPTS) {
+        state.relay.abandoned.add(pick.id);
+        log(`WARN site=${cfg.site} id=${pick.id} 孤児復元: 試行回数上限 → 放棄`);
+        return;
+    }
+    // ★孤児は resume で再開する（元の指示本文ではなく続行プロンプトを渡す）。
+    const cmd = { id: pick.id, body: pick.body };
+    const job = spawnClaudeProcess(cfg, cmd, sessionId, attempt, true);
+    state.job = job;
+    markDelivered(state.relay, pick.id);
+    state.relay.lastHeartbeatAt = null;
+    noteReadiness(state.relay, 'delivered', pick.id);
+    await sendCommandEvents(cfg, pick.id, [{
+            type: 'resumed',
+            text: `孤児復元: attempt ${attempt}/${HEADLESS_MAX_ATTEMPTS} (PC再起動後の自動再開)`,
+            at: new Date().toISOString(),
+            attempt,
+        }]);
+    log(`site=${cfg.site} id=${pick.id} ` +
+        `孤児を復元して再開しました (session=${sessionId}, attempt ${attempt}/${HEADLESS_MAX_ATTEMPTS})`);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// headless tick（relayTick の headless 版）
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * headless 方式の1tick。relayTick の代わりに createRelayRunner へ渡す。
+ *
+ * 【共通の管制通信】fetchControl, fetchCommand, patchStatus は relay.ts のものをそのまま使う。
+ * 【違い】配達は tmux ではなく子プロセスの起動。完了検出はプロセスの終了。
+ */
+export async function headlessTick(cfg, state, hooks) {
+    const rs = state.relay;
+    if (rs.running)
+        return;
+    rs.running = true;
+    rs.promptPending = false;
+    try {
+        // ── 起動時1回の孤児復元（PC再起動後の拾い直し） ──
+        // cli.ts を触らず「起動時1回」を実現するため、最初の tick でだけ復元する。
+        // 失敗しても再試行しない（フラグを先に立てる＝起動を妨げない／多重実行防止）。
+        if (!state.restored) {
+            state.restored = true;
+            await restoreHeadlessOrphans(cfg, state);
+        }
+        // ── 実行中のジョブの監視 ──
+        if (state.job !== null) {
+            await checkRunningJob(cfg, state);
+            return; // ジョブ実行中は新規取得しない
+        }
+        // ── 管制との線を確かめる ──
+        const ctl = await fetchControl(cfg);
+        if (!ctl.ok) {
+            log(noteCentralDown(rs, ctl.detail, Date.now()));
+            return;
+        }
+        const reconnected = noteCentralUp(rs, Date.now());
+        if (reconnected !== null) {
+            log(reconnected);
+            rs.lastHeartbeatAt = null;
+            hooks?.onCentralReconnect?.();
+        }
+        // ── 停止フラグ確認 ──
+        const haltedBySite = ctl.relayEnabled === false;
+        if (ctl.relayHalted || haltedBySite) {
+            if (rs.lastHalted !== true) {
+                log(haltedBySite
+                    ? `この現場(${cfg.site})の relay送信トグルがOFF(停止)のため送信しません`
+                    : 'relay停止中(緊急停止スイッチON)のため送信しません');
+            }
+            rs.lastHalted = true;
+            noteReadiness(rs, 'halted', null);
+            return;
+        }
+        if (rs.lastHalted === true) {
+            log('停止が解除されました。relayを再開します');
+        }
+        rs.lastHalted = false;
+        // ── 新規指示の取得 ──
+        const cmd = await fetchCommand(cfg);
+        if (!cmd) {
+            noteReadiness(rs, 'no-command', null);
+            return;
+        }
+        // ── 放棄ガード ──
+        if (rs.abandoned.has(cmd.id))
+            return;
+        // ── 配達回数上限 ──
+        if (!canDeliver(rs, cmd.id)) {
+            rs.abandoned.add(cmd.id);
+            log(`WARN site=${cfg.site} id=${cmd.id} 配達回数上限(${RELAY_DELIVER_MAX}) → 以後配達しない`);
+            return;
+        }
+        // ── 試行回数 ──
+        const attempt = (state.attempts.get(cmd.id) ?? 0) + 1;
+        state.attempts.set(cmd.id, attempt);
+        if (attempt > HEADLESS_MAX_ATTEMPTS) {
+            rs.abandoned.add(cmd.id);
+            log(`WARN site=${cfg.site} id=${cmd.id} 試行回数上限(${HEADLESS_MAX_ATTEMPTS}) → 放棄`);
+            return;
+        }
+        // ── claude -p を起動 ──
+        const sessionId = sessionIdForCommand(cmd.id);
+        const isResume = attempt > 1;
+        const job = spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume);
+        state.job = job;
+        markDelivered(rs, cmd.id);
+        rs.lastHeartbeatAt = null;
+        noteReadiness(rs, 'delivered', cmd.id);
+        // ★管制へ配達の印を書く
+        await patchStatus(cfg, cmd.id, 'sent');
+        if (isResume) {
+            await sendCommandEvents(cfg, cmd.id, [{
+                    type: 'resumed',
+                    text: `attempt ${attempt}/${HEADLESS_MAX_ATTEMPTS} (自動再開)`,
+                    at: new Date().toISOString(),
+                    attempt,
+                }]);
+        }
+        log(`site=${cfg.site} id=${cmd.id} ` +
+            `${isResume ? '再開' : '起動'}しました (session=${sessionId}, attempt ${attempt}/${HEADLESS_MAX_ATTEMPTS})`);
+    }
+    finally {
+        rs.running = false;
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 状態の生成とアダプタ
+// ─────────────────────────────────────────────────────────────────────────────
+/** headless 用の初期状態を作る。内包する RelayState は createRelayState() で作る。 */
+export function createHeadlessState() {
+    return {
+        relay: createRelayState(),
+        job: null,
+        attempts: new Map(),
+        restored: false,
+    };
+}
+/**
+ * headless 方式の配達状況を生存報告用に返す（cli.ts の sendReport が使う）。
+ * RelayState の deliveryReport をそのまま返す。
+ */
+export function headlessDeliveryReport(state) {
+    return deliveryReport(state.relay);
+}
+/** headless 方式の次の tick までの待ち(ms)。cli.ts の適応スケジューラが使う。 */
+export function headlessNextDelayMs(state, intervalSec) {
+    const rs = state.relay;
+    // 管制へつながらない間は再試行の間隔（指数バックオフ）
+    if (rs.central.failures > 0) {
+        return reconnectDelayMs(rs.central.failures);
+    }
+    // ジョブ実行中はイベントフラッシュ間隔で早く回す
+    if (state.job !== null) {
+        return Math.min(intervalSec * 1000, HEADLESS_EVENT_FLUSH_MS);
+    }
+    // 通常間隔
+    return intervalSec * 1000;
+}
+/** 環境変数から runner mode を読む。未設定・不明な値は 'tmux'（既定・後退させない）。 */
+export function parseRunnerMode(raw) {
+    const v = (raw ?? '').trim().toLowerCase();
+    if (v === 'headless')
+        return 'headless';
+    return 'tmux';
+}

package/dist/relay.js

@@ -1094,8 +1094,8 @@ export function fullCompletionGuide(site, commandId) {
         `---\n` +
         `この囲みの下に、いつもどおりの報告本文を書いてください（本文が空だと未完成と見なされます）。\n` +
         `その後の最終行に必ず ${marker} とだけ出力してください。\n\n` +
-        // ★案D（relay非依存の確実な完了通知）: 完了したら必ず devlog MCP の conductor_complete を呼ぶ。
-        `そして完了したら必ず、devlog の MCP ツール conductor_complete を commandId="${commandId}" で1回だけ呼んでください` +
+        // ★案D（relay非依存の確実な完了通知）: 完了したら必ず ai-kana MCP の conductor_complete を呼ぶ。
+        `そして完了したら必ず、ai-kana の MCP ツール conductor_complete を commandId="${commandId}" で1回だけ呼んでください` +
         `（relayに依存しない確実な完了通知です。report 引数に上記の報告本文を添えても構いません）。\n\n` +
         // ★成果引数の案内（devlog-tracker PR #100）: conductor_complete に任意の成果を添えられる。
         //   すべて任意・分からなければ省略可＝渡さなくても従来どおり完了する。既存の完了検出

package/package.json

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

package/sales-template/install.sh

@@ -613,9 +613,13 @@ else
 
   doing "Node ${NODE_MAJOR_WANTED} を入れます"
   nvm install "$NODE_MAJOR_WANTED" || die "Node ${NODE_MAJOR_WANTED} を入れられませんでした"
+  # ★nvm alias default が lts/* のように解決できない値だと、nvm use default が
+  #   終了コード3で黙って落ちる（実測 2026-09-28 FshimaNP）。入れたばかりの版を
+  #   名指しで使ったうえで、既定もその版に上書きする。
+  nvm use "$NODE_MAJOR_WANTED" >/dev/null \
+    || die "Node ${NODE_MAJOR_WANTED} に切り替えられませんでした。nvm use ${NODE_MAJOR_WANTED} を手動でお試しください。"
   nvm alias default "$NODE_MAJOR_WANTED" >/dev/null \
     || die 'Node の既定の版を決められませんでした'
-  nvm use default >/dev/null || die 'Node に切り替えられませんでした'
   say "  用意できました: $(node --version)"
   record "Node: 入れた（$(node --version)）"
 fi
@@ -896,12 +900,84 @@ CONSOLE_URL=''
 CONSOLE_TOKEN=''
 
 if [[ -f "$ENV_FILE" ]]; then
-  skip '接続情報はあります'
   # 権限が緩んでいたら締める（常駐側も起動時に直すが、ここでも揃えておく）。
   if [[ "$DRY_RUN" != "1" ]]; then
     chmod 600 "$ENV_FILE" 2>/dev/null || true
   fi
-  record '接続情報: 済み'
+  # ★合言葉が管制に通るかを確かめる（実測 2026-09-28: 古い合言葉が 401 なのに
+  #   「接続情報はある」で飛ばされ、あとで「指示が届かない」だけが起きた）。
+  #   通らなければ入れ直しを聞く。確かめられないとき（ネット不調）は従来どおりスキップ。
+  _ENV_URL=''; _ENV_TOKEN=''
+  if [[ "$DRY_RUN" != "1" ]]; then
+    while IFS='=' read -r k v; do
+      case "$k" in
+        CONDUCTOR_URL)   _ENV_URL="$v" ;;
+        CONDUCTOR_TOKEN) _ENV_TOKEN="$v" ;;
+      esac
+    done < "$ENV_FILE"
+  fi
+  if [[ -n "$_ENV_URL" && -n "$_ENV_TOKEN" ]]; then
+    _check="$(CONDUCTOR_URL="$_ENV_URL" CONDUCTOR_TOKEN="$_ENV_TOKEN" python3 <<'PYEOF' 2>/dev/null || echo unreachable
+import os, urllib.error, urllib.request
+PING_ID = '00000000-0000-4000-8000-000000000000'
+class _NoRedirect(urllib.request.HTTPRedirectHandler):
+    def redirect_request(self, *a, **k):
+        return None
+url = (os.environ.get('CONDUCTOR_URL') or '').rstrip('/')
+token = os.environ.get('CONDUCTOR_TOKEN') or ''
+req = urllib.request.Request(
+    f'{url}/api/conductor/hook-requests/{PING_ID}',
+    method='GET', headers={'Authorization': f'Bearer {token}'})
+try:
+    with urllib.request.build_opener(_NoRedirect).open(req, timeout=10) as res:
+        code = getattr(res, 'status', 0) or 0
+    print('ok' if 200 <= code < 300 else 'bad-url')
+except urllib.error.HTTPError as e:
+    if e.code == 404 or 200 <= e.code < 300:
+        print('ok')
+    elif e.code in (401, 403):
+        print('bad-token')
+    elif 300 <= e.code < 400:
+        print('bad-url')
+    else:
+        print('unreachable')
+except Exception:
+    print('unreachable')
+PYEOF
+)"
+    unset _ENV_TOKEN
+    case "$_check" in
+      ok)
+        skip '接続情報はあります（管制への接続も確認しました）'
+        record '接続情報: 済み（接続確認OK）'
+        ;;
+      bad-token)
+        say ''
+        say '  ★いまの合言葉では管制に拒否されました（401）。'
+        say '    合言葉が変わった可能性があります。入れ直しますか？'
+        reenter=''
+        ask_tty reenter '  入れ直す (y/N)' ''
+        if [[ "$(lower "$reenter")" == "y" ]]; then
+          rm -f "$ENV_FILE"
+          say '  古い接続情報を消しました。もう一度この1行を打ってください。'
+          say '  （続きから進みます）'
+          exit 1
+        else
+          note '★入れ直さずに進みます。指示が届かないときは rm ~/.conductor.env のあと、もう一度この1行を打ってください'
+          skip '接続情報はあります（★合言葉が古い可能性があります）'
+          record '接続情報: 済み（★合言葉が古い可能性あり）'
+        fi
+        ;;
+      *)
+        # ★ネット不調は止めない。従来どおりスキップ。
+        skip '接続情報はあります'
+        record '接続情報: 済み'
+        ;;
+    esac
+  else
+    skip '接続情報はあります'
+    record '接続情報: 済み'
+  fi
   note '★入れ直したいときは rm ~/.conductor.env のあと、もう一度この1行を打ってください'
 elif [[ "$DRY_RUN" == "1" ]]; then
   plan '管制のアドレスと合言葉をお聞きして、接続情報を作ります'
@@ -1040,6 +1116,35 @@ else
   record '設置: 実行した'
 fi
 
+# ═════════════════════════════════════════════════════════════════════════════
+# ⑬½ 画面なし方式（headless）を既定にする
+#
+# ★新しいPCは画面なし方式で設置する（えふさん確定）。既存のPCは切り替えない
+#   （プログラムの既定は tmux のまま）。ここは install.sh（新規設置の入口）だけが
+#   通るので、既存PCには影響しない。
+# ★systemd の drop-in で環境変数を渡す。ユニット本体は変えない。
+# ═════════════════════════════════════════════════════════════════════════════
+
+UNIT_DIR_INST="$HOME/.config/systemd/user"
+HEADLESS_DROPIN_DIR="$UNIT_DIR_INST/conductor@${SITE}.service.d"
+HEADLESS_DROPIN="$HEADLESS_DROPIN_DIR/headless.conf"
+
+if [[ "$DRY_RUN" == "1" ]]; then
+  plan '画面なし方式（headless）を設定します'
+else
+  mkdir -p "$HEADLESS_DROPIN_DIR"
+  cat > "$HEADLESS_DROPIN" <<'DROPIN'
+# install.sh が設定: 画面なし方式（headless）で動かす。
+# ★tmux に切り替えたいときはこのファイルを消して systemctl --user daemon-reload。
+[Service]
+Environment=CONDUCTOR_RUNNER_MODE=headless
+DROPIN
+  systemctl --user daemon-reload 2>/dev/null || true
+  systemctl --user restart "conductor@${SITE}.service" 2>/dev/null || true
+  say "  画面なし方式を設定しました（drop-in: ${HEADLESS_DROPIN}）"
+  record '方式: 画面なし（headless）'
+fi
+
 # ═════════════════════════════════════════════════════════════════════════════
 # ⑭ 締め（★自己点検の○×は、すぐ上に設置係が出しています）
 # ═════════════════════════════════════════════════════════════════════════════
@@ -1073,16 +1178,11 @@ ${BAR}
   ✗ が残っているときは、その行に書いてある直し方をお試しください。
 
 ${BAR}
-次にやること — 職人（Claude Code）を動かす
+これで準備は終わりです
 ${BAR}
 
-  下の2行を、そのままコピーして貼ってください。
-
-    source ~/.bashrc
-    kc ${SITE}
-
-  （1行目は、いま用意した合言葉をこの画面に読み込みます。
-    2行目で職人が開きます。★次からは「kc ${SITE}」の1行だけで開けます）
+  管制から便を出すと自動で動きます。
+  職人の画面を手で開く必要はありません。
 
 ${BAR}
 いちばん確実な「動いています」の確かめ方
@@ -1091,7 +1191,13 @@ ${BAR}
   管制の画面（采配くん）をブラウザで開いてください。
   そこに「${SITE}」が出ていれば、つながって動いています。
 
-  出てこないときは、職人の画面を開いたまま1〜2分待って、開き直してください。
+  出てこないときは1〜2分待って、開き直してください。
   それでも出ないときは、この画面をそのままサポートへお送りください。
 
+${BAR}
+職人の画面を手で開きたいとき（tmux 方式・補助）
+${BAR}
+
+  source ~/.bashrc && kc ${SITE}
+
 GUIDE

package/sales-template/setup.sh

@@ -108,6 +108,31 @@ MIN_CONDUCTOR_VERSION="0.12.3"
 fail() { echo; echo "[setup] エラー: $1" >&2; exit 1; }
 warn() { echo "[setup] warn: $1" >&2; }
 
+# 入力元。curl | bash では /dev/tty から読む。テスト等で端末が無い場合は標準入力に落ちる。
+# install.sh の CONDUCTOR_INSTALL_TTY と同じ差し替え口を使う。
+_SETUP_TTY="${CONDUCTOR_INSTALL_TTY:-/dev/tty}"
+# ★/dev/tty は「端末が無いプロセス」でもファイルとしては在る（-r が真を返す）。
+#   実際に開けるかで判定する。開けなければ標準入力に落ちる。
+_SETUP_TTY_OK=0
+if exec 8<"$_SETUP_TTY" 2>/dev/null; then
+  exec 8<&-
+  _SETUP_TTY_OK=1
+fi
+
+# setup_read — /dev/tty があれば使い、無ければ標準入力から読む。
+# 使い方: setup_read [-s] <変数名> <プロンプト>
+setup_read() {
+  local silent='' var prompt
+  if [[ "${1:-}" == "-s" ]]; then silent='-s'; shift; fi
+  var="$1"; prompt="$2"
+  # shellcheck disable=SC2229  # $silent は動的な旗、$var は動的な変数名。意図どおり。
+  if [[ "$_SETUP_TTY_OK" == "1" ]]; then
+    IFS= read -r $silent -p "$prompt" "$var" <"$_SETUP_TTY" || printf -v "$var" ''
+  else
+    IFS= read -r $silent -p "$prompt" "$var" || printf -v "$var" ''
+  fi
+}
+
 # version_lt <a> <b> — a が b より古いか。
 # ★`sort -V` に頼らない（Mac の sort には無い版がある＝ADR-019 で Mac も対象）。
 #   数字3つ（major.minor.patch）だけを見る。読めない字は 0 とみなす（安全側＝古い扱い）。
@@ -512,12 +537,12 @@ else
   echo "[setup] ★この2つは弊社からお渡しした値です。手元の案内をご覧ください。"
   echo
 
-  read -r -p "  ① 管制のアドレス（CONDUCTOR_URL・例: https://…）: " input_url
+  setup_read input_url "  ① 管制のアドレス（CONDUCTOR_URL・例: https://…）: "
   [[ -z "$input_url" ]] && fail "管制のアドレスが空です。"
 
   # ★合言葉は画面に出さない（-s）。画面共有・録画に残さないため。
   #   何も出ないと固まったと思われるので、受け取ったことを必ず1行返す。
-  read -r -s -p "  ② 合言葉（CONDUCTOR_TOKEN・入力しても画面には出ません）: " input_secret
+  setup_read -s input_secret "  ② 合言葉（CONDUCTOR_TOKEN・入力しても画面には出ません）: "
   echo
   [[ -z "$input_secret" ]] && fail "合言葉が空です。"
   echo "[setup]   受け取りました（${#input_secret} 文字）。画面には表示していません。"
@@ -821,7 +846,8 @@ fi
 if [[ -f "$SETTINGS_SRC" ]]; then
   if [[ -f "$SETTINGS_DST" ]]; then
     echo "[setup] $SETTINGS_DST は既に存在します。上書きしますか？"
-    read -r -p "  上書き (y/N): " overwrite
+    setup_read overwrite "  上書き (y/N): "
+    # shellcheck disable=SC2154  # overwrite は setup_read で間接代入される
     if [[ "$(lower "$overwrite")" != "y" ]]; then
       echo "[setup] 現場の settings.json をスキップしました。"
     else
@@ -843,9 +869,10 @@ if [[ -f "$SETTINGS_SRC" ]]; then
   # Supabase 設定
   if [[ -f "$SETTINGS_DST" ]] && grep -q '<SUPABASE_PROJECT_ID>' "$SETTINGS_DST"; then
     echo
-    read -r -p "[setup] Supabase を使いますか？ (y/N): " use_supabase
+    setup_read use_supabase "[setup] Supabase を使いますか？ (y/N): "
+    # shellcheck disable=SC2154  # use_supabase は setup_read で間接代入される
     if [[ "$(lower "$use_supabase")" == "y" ]]; then
-      read -r -p "  Supabase Project Reference ID: " supabase_id
+      setup_read supabase_id "  Supabase Project Reference ID: "
       if [[ -n "$supabase_id" ]]; then
         sed_replace "s|<SUPABASE_PROJECT_ID>|${supabase_id}|g" "$SETTINGS_DST"
         echo "[setup] <SUPABASE_PROJECT_ID> → $supabase_id に置換"
@@ -885,7 +912,8 @@ if [[ "$PROFILE" == "proto" ]]; then
   write_env_example=1
   if [[ -f "$ENV_EXAMPLE_DST" ]]; then
     echo "[setup] $ENV_EXAMPLE_DST は既に存在します。上書きしますか？"
-    read -r -p "  上書き (y/N): " overwrite_env
+    setup_read overwrite_env "  上書き (y/N): "
+    # shellcheck disable=SC2154  # overwrite_env は setup_read で間接代入される
     [[ "$(lower "$overwrite_env")" == "y" ]] || write_env_example=0
   fi
   if [[ "$write_env_example" == "1" ]]; then

package/skills/conductor-craftsman/SKILL.md

@@ -156,7 +156,7 @@ description: 采配くんの便（プロンプト末尾に CONDUCTOR_JOB:<id>
    ```
    この囲みの下に、いつもどおりの報告本文を書く（本文が空だと未完成と見なされる）。
 ③ **その後の最終行に、配達役の1行にある `DONE:<現場>` とだけ出力する**（完了の合図）。
-④ **devlog の MCP ツール `conductor_complete` を、配達役の1行にある commandId で1回だけ呼ぶ**（relay に依存しない確実な完了通知）。report 引数に上の報告本文を添えてもよい。
+④ **ai-kana の MCP ツール `conductor_complete` を、配達役の1行にある commandId で1回だけ呼ぶ**（relay に依存しない確実な完了通知）。report 引数に上の報告本文を添えてもよい。
    - **nextWork（次の独立作業候補）は必ず書く。** 無ければ「なし」と、なぜ無いかの理由を書く。
    - 可能なら次も一緒に渡す（すべて任意・分かる範囲でよく、渡さなくても完了する）：`branch=`作った作業ブランチ名（`git rev-parse --abbrev-ref HEAD`）、`baseBranch=`分岐元（通常 main）、`headSha=`最後のコミット（短縮可）、`pushed=`push したか（true/false）、`filesChanged=`変更したファイル数、`prTitle=`お客さま（非エンジニア）がそのまま読む題名（rebase/squash/lint 等の専門用語を避け、やさしい日本語で）、`prNumber=`既に PR がある場合のみ、`outcome=`pushed（変更して push した）／no_change（変更不要だった）／blocked（衝突・要判断・許可待ち等で完了できなかった）のどれか。
    - **blocked のときも必ず conductor_complete を呼び、report に理由を書く。**