@tyhld/conductor 0.12.71 → 0.12.73

package/dist/view.js

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

package/package.json

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

package/sales-template/install.sh

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

package/sales-template/setup.sh

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

package/scripts/hooks/policy.py

@@ -2066,8 +2066,13 @@ def _prod_db_change_result(reason):
 _SAFE_ABS_TOP = frozenset({'tmp'})
 
 
-def rm_path_risk(path: str) -> str:
-    """rm の対象パスの危険度: 'dangerous' / 'safe' / 'unknown'。"""
+def rm_path_risk(path: str, work_dir: str = None) -> str:
+    """rm の対象パスの危険度: 'dangerous' / 'safe' / 'unknown'。
+
+    work_dir が渡されたとき、絶対パスが work_dir の中を指すなら 'safe'（相対パスと同じ扱い）。
+    ただし work_dir 自体・.git を含むパス・.. やシンボリックリンクで外に出るパスは 'dangerous'。
+    work_dir が None のとき（非 conductor 環境）は従来どおり。
+    """
     p = path.strip().strip('"').strip("'")
     if p == '':
         return 'unknown'
@@ -2086,14 +2091,34 @@ def rm_path_risk(path: str) -> str:
         comps = [c for c in p.split('/') if c]
         if not comps:
             return 'dangerous'
+        # ★workDir 内の絶対パスは相対パスと同じ扱い（便 24c9b6b6）。
+        #   workDir 自体・.git・.. やシンボリックリンクで外に出るパスは引き続き dangerous。
+        #   workDir を知れないときは従来どおり止める（Fail Closed）。
+        #   ★秘密（.env 等）と設定（.claude 等）は別の検査（_secret_danger / _guard_write_scan）が
+        #     引き続き止めるので、ここでは .git だけを追加で守る。
+        if work_dir:
+            try:
+                resolved = os.path.realpath(p)
+                work_resolved = os.path.realpath(work_dir)
+                if resolved == work_resolved:
+                    pass  # workDir 自体 → fall through to 'dangerous'
+                elif resolved.startswith(work_resolved + os.sep):
+                    rel_comps = resolved[len(work_resolved) + 1:].split(os.sep)
+                    if '.git' not in rel_comps:
+                        return 'safe'
+                    # .git を含む → fall through to 'dangerous'
+            except (OSError, ValueError):
+                pass  # 解決できない → fall through（Fail Closed）
         if comps[0] in _SAFE_ABS_TOP and len(comps) >= 2:
             return 'safe'
         return 'dangerous'
     return 'safe'
 
 
-def _rm_danger(command: str):
+def _rm_danger(command: str, work_dir: str = None):
     """再帰的 rm の対象パスを全部見て、危険なものがあれば理由を返す。"""
+    if work_dir is None:
+        work_dir = os.environ.get('CONDUCTOR_WORK_DIR') or None
     for m in re.finditer(r'\brm\b', command):
         seg = _SPLIT_RE.split(command[m.end():], maxsplit=1)[0]
         toks = seg.split()
@@ -2101,7 +2126,7 @@ def _rm_danger(command: str):
         recursive = any(('r' in f.lstrip('-').lower()) or f in ('--recursive',) for f in flags)
         paths = [t for t in toks if not t.startswith('-')]
         for p in paths:
-            risk = rm_path_risk(p)
+            risk = rm_path_risk(p, work_dir=work_dir)
             if risk == 'dangerous':
                 return f'rm on dangerous path ({p})'
             if risk == 'unknown' and recursive: