@tyhld/conductor 0.12.54 → 0.12.56

package/dist/cli.js

@@ -165,6 +165,8 @@ function loadConfig(args) {
         runnerMode,
     };
 }
+/** 報告ファイルの拒否回数を追跡する（常駐の生存期間にわたって保持する）。 */
+const reportRejectCounts = new Map();
 /** 1回分の報告を送る。送信結果（HTTPステータス）をログ表示する。 */
 async function sendReport(cfg) {
     const body = {
@@ -223,7 +225,7 @@ async function sendReport(cfg) {
     //   ★配達役がいま追っている便の報告は送らない（完了の道が完了と一緒に渡すため）。
     if (pending.ids.length > 0) {
         const tracking = relayStateForReport?.pending?.id;
-        await sendPendingReportFiles(cfg, { exclude: tracking ? [tracking] : [] });
+        await sendPendingReportFiles(cfg, { exclude: tracking ? [tracking] : [], rejectCounts: reportRejectCounts });
     }
 }
 /** `conductor start`: 起動直後に1回 + 以後 intervalSec ごとに報告し続ける。 */

package/dist/headless.js

@@ -16,6 +16,9 @@
  */
 import { spawn } from 'node:child_process';
 import { createInterface } from 'node:readline';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
 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}`);
@@ -36,6 +39,67 @@ export const EVENT_TEXT_MAX = 500;
 /** resume 時に職人へ渡す続行指示。 */
 const RESUME_PROMPT = '前回の作業の続きを行ってください。中断された箇所から再開してください。';
 // ─────────────────────────────────────────────────────────────────────────────
+// claude の実行ファイルの探索
+//
+// systemd のユーザー常駐はシェルの PATH を継承しない。nvm の下に入った claude は
+// PATH に居ないため spawn('claude') が ENOENT で失敗する（実測 2026-10-01）。
+// conductor-run が node を探すのと同じ考え方で、既知の場所を順に探す。
+// ─────────────────────────────────────────────────────────────────────────────
+/** claude の実行ファイルの既知の候補を返す（新しい node の版から順）。 */
+function claudeBinCandidates() {
+    const h = os.homedir();
+    const candidates = [];
+    // nvm の各 node 版の bin（新しい版から）
+    const nvmDir = path.join(h, '.nvm', 'versions', 'node');
+    try {
+        const { readdirSync } = require('node:fs');
+        const versions = readdirSync(nvmDir)
+            .filter((v) => v.startsWith('v'))
+            .sort((a, b) => {
+            // v24.21.0 → [24, 21, 0] で降順
+            const pa = a.slice(1).split('.').map(Number);
+            const pb = b.slice(1).split('.').map(Number);
+            for (let i = 0; i < 3; i++) {
+                if ((pa[i] ?? 0) !== (pb[i] ?? 0))
+                    return (pb[i] ?? 0) - (pa[i] ?? 0);
+            }
+            return 0;
+        });
+        for (const v of versions) {
+            candidates.push(path.join(nvmDir, v, 'bin', 'claude'));
+        }
+    }
+    catch {
+        // nvm が無い場合
+    }
+    // その他の既知の場所
+    candidates.push(path.join(h, '.local', 'bin', 'claude'), path.join(h, '.claude', 'local', 'claude'), '/usr/local/bin/claude', '/usr/bin/claude');
+    return candidates;
+}
+/**
+ * claude の実行ファイルのフルパスを返す。見つからなければ null。
+ *
+ * 探す順:
+ *   1. 環境変数 CONDUCTOR_CLAUDE_BIN（テスト用の差し替え口）
+ *   2. nvm の各 node 版の bin/claude（新しい版から）
+ *   3. ~/.local/bin/claude
+ *   4. ~/.claude/local/claude
+ *   5. /usr/local/bin/claude, /usr/bin/claude
+ */
+export function resolveClaudeBin() {
+    const override = process.env.CONDUCTOR_CLAUDE_BIN;
+    if (override) {
+        if (existsSync(override))
+            return override;
+        return null;
+    }
+    for (const candidate of claudeBinCandidates()) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+// ─────────────────────────────────────────────────────────────────────────────
 // 秘密のマスク
 // ─────────────────────────────────────────────────────────────────────────────
 /** 秘密の値を検出するパターン。マッチした部分を *** に置換してからイベントを送る。 */
@@ -66,9 +130,11 @@ export function maskSecrets(text) {
 // ─────────────────────────────────────────────────────────────────────────────
 // ヘルパー
 // ─────────────────────────────────────────────────────────────────────────────
-/** commandId からセッション ID を作る（resume で再利用する決定的な値）。 */
+/** commandId からセッション ID を作る（resume で再利用する決定的な値）。
+ * ★commandId はそれ自体が UUID なので、そのまま使う（プレフィックスを付けない）。
+ */
 export function sessionIdForCommand(commandId) {
-    return `conductor-${commandId}`;
+    return commandId;
 }
 /** stream-json の1行を CommandEvent に変換する。無関係な行は null。 */
 export function streamEventToCommandEvent(parsed, attempt) {
@@ -121,8 +187,16 @@ export function isAuthError(job) {
  *
  * 【stdout】stream-json 形式。行ごとに JSON を出す。readline で1行ずつ読む。
  * 【stderr】蓄積して認証エラーの検出に使う。
+ *
+ * 【起動失敗】claude が見つからない（ENOENT）・実行権限がない（EACCES）などで
+ *   spawn が失敗した場合、null を返す。呼び出し側はエラーイベントを管制へ送る。
  */
 export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
+    const claudeBin = resolveClaudeBin();
+    if (claudeBin === null) {
+        log(`ERROR claude が見つかりません。探した場所: nvm の各版の bin, ~/.local/bin, ~/.claude/local, /usr/local/bin, /usr/bin`);
+        return null;
+    }
     const env = { ...process.env };
     delete env.CLAUDECODE;
     delete env.ANTHROPIC_API_KEY;
@@ -136,11 +210,18 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
     ];
     if (isResume)
         args.push('--resume');
-    const proc = spawn('claude', args, {
-        cwd: cfg.workDir,
-        env,
-        stdio: ['pipe', 'pipe', 'pipe'],
-    });
+    let proc;
+    try {
+        proc = spawn(claudeBin, args, {
+            cwd: cfg.workDir,
+            env,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+    catch (err) {
+        log(`ERROR claude の起動に失敗しました (${claudeBin}): ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
     const job = {
         commandId: cmd.id,
         process: proc,
@@ -156,8 +237,19 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
         lastStopCheckAt: Date.now(),
         stderrBuf: '',
     };
+    // spawn の 'error' イベント（ENOENT 等は非同期で届く。同期例外と両方捕まえる）
+    proc.on('error', (err) => {
+        if (!job.completed) {
+            job.completed = true;
+            job.exitCode = -1;
+            job.exitSignal = null;
+            job.stderrBuf += `\nspawn error: ${err.message}`;
+        }
+    });
     // stdin: 指示本文を書いて閉じる
     if (proc.stdin) {
+        // stdin の write エラーは spawn 失敗時に起きうる（握り潰す）
+        proc.stdin.on('error', () => { });
         if (isResume) {
             proc.stdin.write(RESUME_PROMPT);
         }
@@ -411,6 +503,17 @@ export async function restoreHeadlessOrphans(cfg, state) {
     // ★孤児は resume で再開する（元の指示本文ではなく続行プロンプトを渡す）。
     const cmd = { id: pick.id, body: pick.body };
     const job = spawnClaudeProcess(cfg, cmd, sessionId, attempt, true);
+    if (job === null) {
+        await sendCommandEvents(cfg, pick.id, [{
+                type: 'error',
+                text: 'claude が見つかりません（孤児復元を中止）',
+                at: new Date().toISOString(),
+                attempt,
+            }]);
+        state.relay.abandoned.add(pick.id);
+        log(`ERROR site=${cfg.site} id=${pick.id} 孤児復元: claude が見つからない → 放棄`);
+        return;
+    }
     state.job = job;
     markDelivered(state.relay, pick.id);
     state.relay.lastHeartbeatAt = null;
@@ -507,6 +610,18 @@ export async function headlessTick(cfg, state, hooks) {
         const sessionId = sessionIdForCommand(cmd.id);
         const isResume = attempt > 1;
         const job = spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume);
+        if (job === null) {
+            // ★起動失敗を管制へ知らせる（「起動しました」とは言わない）
+            await sendCommandEvents(cfg, cmd.id, [{
+                    type: 'error',
+                    text: 'claude が見つかりません（起動できませんでした）',
+                    at: new Date().toISOString(),
+                    attempt,
+                }]);
+            rs.abandoned.add(cmd.id);
+            log(`ERROR site=${cfg.site} id=${cmd.id} claude が見つからない → 放棄`);
+            return;
+        }
         state.job = job;
         markDelivered(rs, cmd.id);
         rs.lastHeartbeatAt = null;

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 に任意の成果を添えられる。
         //   すべて任意・分からなければ省略可＝渡さなくても従来どおり完了する。既存の完了検出
@@ -1225,6 +1225,10 @@ export const RELAY_DELIVERY_NOTE = '（配達役より）上の貼り付けは
 //   実体はこのファイルの下（★relay.ts は試験から直に読まれるので、部品を別ファイルに分けない）。
 /** 処理済みの控えを置く下位フォルダの名前。 */
 export const PROCESSED_DIR = 'processed';
+/** 中央が恒久的に拒否した報告を退ける下位フォルダの名前。 */
+export const REJECTED_DIR = 'rejected';
+/** 同じ報告を拒否されたまま送り直す上限回数。これを超えたら rejected/ へ移す。 */
+export const REPORT_REJECT_MAX = 3;
 /** 処理済みの控えを残す期間（既定30日）。★未処理はこの期間では消さない。 */
 export const REPORT_KEEP_PROCESSED_MS = 30 * 24 * 60 * 60 * 1000;
 /**
@@ -1348,6 +1352,27 @@ export function markReportProcessed(commandId, env, now = Date.now()) {
     }
     return moved;
 }
+/**
+ * 中央が恒久的に拒否した報告を【rejected/】へ退ける（★消さない・毎周の送り直しを止めるだけ）。
+ * 返り: 退けられたら true。
+ */
+export function markReportRejected(commandId, env) {
+    let moved = false;
+    for (const file of pendingCandidates(commandId, env)) {
+        if (!existsSync(file))
+            continue;
+        const dest = path.join(path.dirname(file), REJECTED_DIR, path.basename(file));
+        try {
+            mkdirSync(path.dirname(dest), { recursive: true, mode: 0o700 });
+            renameSync(file, dest);
+            moved = true;
+        }
+        catch {
+            // 移せなかったら触らない
+        }
+    }
+    return moved;
+}
 /**
  * まだ管制へ渡していない報告の指示ID（古い順）。★生存報告に載せて管制へ知らせるための一覧。
  *   - `processed/` の中は数えない（もう渡した物）。
@@ -1428,13 +1453,14 @@ export function isInstructionMissingReport(raw) {
 }
 /**
  * 未処理の報告ファイルの全文を中央へ送り、受け取られた物だけ処理済みにする。
- * 返り: 送った件数・処理済みにした件数・未処理のまま残した件数。
+ * 返り: 送った件数・処理済みにした件数・未処理のまま残した件数・拒否で退けた件数。
  */
 export async function sendPendingReportFiles(cfg, opts = {}) {
     const env = opts.env;
     const doFetch = opts.fetchImpl ?? fetch;
     const logLine = opts.logLine ?? log;
     const exclude = new Set(opts.exclude ?? []);
+    const rejectCounts = opts.rejectCounts ?? new Map();
     const items = [];
     for (const id of pendingReportIds(env, REPORT_FILES_MAX_PER_ROUND).ids) {
         for (const file of pendingCandidates(id, env)) {
@@ -1452,6 +1478,7 @@ export async function sendPendingReportFiles(cfg, opts = {}) {
     let sent = 0;
     let processed = 0;
     let kept = 0;
+    let rejected = 0;
     for (let i = 0; i < items.length; i += REPORT_FILES_BATCH) {
         const chunk = items.slice(i, i + REPORT_FILES_BATCH);
         let results = null;
@@ -1484,20 +1511,40 @@ export async function sendPendingReportFiles(cfg, opts = {}) {
             const r = results?.[k];
             if (r && r.ok === true && markReportProcessed(chunk[k].id, env)) {
                 processed++;
+                rejectCounts.delete(chunk[k].id);
             }
             else {
-                kept++;
-                if (r) {
+                if (r && r.ok === false) {
+                    // ★中央が拒否した（不完全な便ID 等）。連続拒否回数を数え、上限を超えたら rejected/ へ退ける。
+                    const count = (rejectCounts.get(chunk[k].id) ?? 0) + 1;
+                    rejectCounts.set(chunk[k].id, count);
                     const why = String(r.reason ?? r.error ?? '理由なし').slice(0, 200);
-                    logLine(`site=${cfg.site} id=${chunk[k].id} の報告ファイルは受け取られませんでした（未処理のまま残す）: ${why}`);
+                    if (count >= REPORT_REJECT_MAX) {
+                        if (markReportRejected(chunk[k].id, env)) {
+                            rejected++;
+                            rejectCounts.delete(chunk[k].id);
+                            logLine(`site=${cfg.site} id=${chunk[k].id} の報告ファイルは ${count} 回拒否されたため退けました: ${why}`);
+                        }
+                        else {
+                            kept++;
+                            logLine(`site=${cfg.site} id=${chunk[k].id} の報告ファイルは受け取られませんでした（未処理のまま残す）: ${why}`);
+                        }
+                    }
+                    else {
+                        kept++;
+                        logLine(`site=${cfg.site} id=${chunk[k].id} の報告ファイルは受け取られませんでした（${count}/${REPORT_REJECT_MAX}回目・未処理のまま残す）: ${why}`);
+                    }
+                }
+                else {
+                    kept++;
                 }
             }
         }
     }
     if (items.length > 0) {
-        logLine(`site=${cfg.site} 報告ファイル: 送った ${sent} 件・処理済み ${processed} 件・未処理のまま ${kept} 件`);
+        logLine(`site=${cfg.site} 報告ファイル: 送った ${sent} 件・処理済み ${processed} 件・未処理のまま ${kept} 件${rejected > 0 ? `・退けた ${rejected} 件` : ''}`);
     }
-    return { sent, processed, kept };
+    return { sent, processed, kept, rejected };
 }
 /**
  * 古い控えを片付ける。★消すのは `processed/` の中だけ（未処理は何日たっても消さない）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tyhld/conductor",
-  "version": "0.12.54",
+  "version": "0.12.56",
   "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 に理由を書く。**