@tyhld/conductor 0.12.87 → 0.12.89

package/README.md

@@ -83,6 +83,8 @@ node dist/cli.js start            # もしくは scripts/conductor-start.sh（
 > APPLY=1 bash "$(npm root -g)/@tyhld/conductor/scripts/autoupdate-install.sh"  # 入れる
 > ~/.tyhld/bin/tyhld-selfcheck --now                                             # 自己診断を1回
 > ```
+> ★更新の窓で打つ行（ノートPC → メインPC → 社員PC・Ubuntu と PowerShell・再起動後の確かめ・止まったときの読み方）は1枚にまとめてあります: [`docs/自社PC-更新の窓-手順書.md`](docs/自社PC-更新の窓-手順書.md)。仕組みと決まりは [ADR-027](docs/adr/ADR-027-staged-autoupdate-own-pcs.md)。
+>
 > 鍵（`~/.tyhld/bin/autoupdate/enabled`）・更新係と自己診断のタイマー・Claude Code 自身の自動更新を止める設定（`DISABLE_AUTOUPDATER=1`）を置きます。Claude Code が公式推奨の1方式（`curl -fsSL https://claude.ai/install.sh | bash`）だけになっていなければ、人が打つ行を出して止まります。お客さまの導入台本（`sales-template/install.sh`・`setup.sh`）には入っていません。
 
 ---

package/dist/autoupdate.js

@@ -26,6 +26,8 @@
  *     指名（~/.tyhld/bin/autoupdate/claude-pin）を書く。戻すときも指名で戻す。最低版より古い版へは戻さない。
  *   ・候補の版（conductor＝公開 npm の latest／Claude Code＝公式の安定版）を見つけたら、自己診断に
  *     載せて管制へ届ける。★先行機かどうかはこの機では決めない（機体名をコードに書かない・管制が決める）。
+ *     管制が目標の版の口で role:"follower" を返した機は、候補を探さない・候補の自己診断を流さない
+ *     （欄が無い・読めないときは今までどおり＝全PCが流す・便 9a81e458）。
  *
  * 【控え】~/.tyhld/bin/autoupdate/state.json（★職人が書けない場所。途中で電源が切れても続きから動く）。
  */
@@ -56,6 +58,8 @@ export const HELD_RECHECK_MS = 60 * 60 * 1000;
 /** 候補を届けられなかったとき、もう一度届けに行くまでの間隔。 */
 export const CANDIDATE_RETRY_MS = 24 * 60 * 60 * 1000;
 const SEMVER = /^\d+\.\d+\.\d+$/;
+/** 管制が返す役の語（★読むだけ。どの機が先行機かは管制が決める）。 */
+const TARGET_ROLES = ['leader', 'follower'];
 // ─────────────────────────────────────────────────────────────────────────────
 // 置き場
 // ─────────────────────────────────────────────────────────────────────────────
@@ -175,6 +179,7 @@ export async function fetchTarget(d, conductorVersion) {
                 reason: typeof b.reason === 'string' ? b.reason : null,
                 checkAgainMin: min,
                 ready: b.ready === true,
+                role: TARGET_ROLES.includes(b.role) ? b.role : null,
             },
             detail: `HTTP ${res.status}`,
         };
@@ -490,7 +495,9 @@ export async function runUpdater(d) {
     if (!comp || !want) {
         removeDrain(d, s);
         s.busySince = null;
-        await reportCandidates(d, s, installed, claudeNow?.version ?? null);
+        // ★後続の機は候補を探さない・候補の自己診断を流さない（役は管制が決める・欄が無ければ今までどおり）。
+        if (target.role !== 'follower')
+            await reportCandidates(d, s, installed, claudeNow?.version ?? null);
         return done(d, s, 'none', `目標の版と同じです（conductor ${installed ?? '不明'}・Claude Code ${claudeNow?.version ?? '不明'}）`);
     }
     // ⑤ 全現場が空きか。

package/dist/headless.js

@@ -557,6 +557,36 @@ export function jobEndKindOf(j) {
 export function shouldAbortForBodyHandoff(j) {
     return j.bodyHandoff === 'failed' && !j.stopped && !j.timedOut;
 }
+/**
+ * 便の終わりの関門が残した「途中で終わった」理由の控え（便 7aa63a97）。
+ *
+ * ★番人側（`scripts/hooks/finish_gate.py`）が、同じ理由で止める回数の上限に達したときだけ
+ *   1行だけ書く。中継はそれを【読んで消すだけ】で、判定はしない（判定は関門が持つ）。
+ *   これが要るのは「管制には『途中で終わった』と分かる形で届く」ため。新しい状態は作らず、
+ *   既にある「終了の事実」の `jobEndDetail` に相乗りする（管制の口を変えない）。
+ *   控えが無い便＝関門が止めずに済んだ便なので、今までどおり null。
+ */
+export function takeFinishGateResidue(commandId, env = process.env) {
+    const xdg = (env.XDG_STATE_HOME ?? '').trim();
+    const root = xdg || path.join(env.HOME ?? os.homedir(), '.local', 'state');
+    const safe = String(commandId ?? '').replace(/[^A-Za-z0-9_-]/g, '').slice(0, 128);
+    if (!safe)
+        return null;
+    const file = path.join(root, 'conductor', 'finish-gate', `${safe}.residue`);
+    let text;
+    try {
+        text = readFileSync(file, 'utf8').trim();
+    }
+    catch {
+        return null;
+    }
+    // ★読んだら消す（次の周で二重に届けない）。消せなくても届けることを優先する。
+    try {
+        unlinkSync(file);
+    }
+    catch { /* 消せなくても害は無い（同じ便の控えは1つだけ） */ }
+    return text.length > 0 ? text.slice(0, 500) : null;
+}
 /**
  * いま画面なし方式が追っている便の指示ID（★回収の道から除く物・便 6ebba0d0 の b）。
  *
@@ -1263,7 +1293,11 @@ async function checkRunningJob(cfg, state) {
                 //   つかめていないときは false を送る（1-3 の「つかめていない」と同じ形）。
                 processEndObserved: job.finishedAt !== null,
                 startedAt: new Date(job.startedAt).toISOString(),
-                detail: job.bodyHandoffError ?? `attempt ${job.attempt}/${HEADLESS_MAX_ATTEMPTS}`,
+                // ★終わりの関門が「途中で終わった」と残していれば、その理由を先に載せる（便 7aa63a97）。
+                //   本文を渡せなかった理由がいちばん強い（職人は何も受け取っていない）ので、それが先。
+                detail: job.bodyHandoffError
+                    ?? takeFinishGateResidue(job.commandId)
+                    ?? `attempt ${job.attempt}/${HEADLESS_MAX_ATTEMPTS}`,
             }, { logLine: log });
         }
         if (job.timedOut) {

package/package.json

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

package/sales-template/setup.sh

@@ -859,6 +859,7 @@ GUARD_FILES=(
   policy.py                   # cc2_guard / permission_request_hook が使う判定本体
   summary_ja.py               # permission_request_hook / stop_hook が使う日本語の文言
   hook_datalink.py            # 各フックが使う管制との連絡線
+  finish_gate.py              # stop_hook が使う「便の終わりの関門」の判定（便 7aa63a97）
 )
 GUARD_ENTRYPOINTS=(cc2_guard.py permission_request_hook.py stop_hook.py notification_hook.py)
 GUARD_CONFIGS=(safe_verbs.json network_allow.json)  # 任意・あれば同居させる

package/scripts/hooks/finish_gate.py

@@ -0,0 +1,398 @@
+#!/usr/bin/env python3
+"""finish_gate.py — 便の終わりの関門（職人が「まだ残っているのに終わる」のを仕組みで止める）。
+
+【なぜ要るか（実地・2026-10-02〜03 に3回）】
+  どの便の本文にも「待ちを背景に残したまま手番を閉じない。待ち終わってから、報告を書いて終える」と
+  書いてあったのに、同じ終わり方が3回起きた。★指示の文では止まらない。
+
+  ・915694ac（このPC・conductor）… 最後の発言は「CI を真似た試験はまだ実行中です。終わり次第、
+    結果を確かめます。」で `stop_reason: end_turn`。その直後に背景の仕事 `b32iul78k` が
+    `status: killed` になった（実行の記録で確認）。報告は「報告（作成中）この見出しは最終版で
+    差し替える」の下書きだけ。PR #252 は開いたまま。管制では「終わりました」になった。
+  ・47bdfe00（このPC・ai-kana）… 最後の発言は「Auto-merge is still armed … Waiting.」で end_turn。
+    直後に背景の仕事 `be6b727fc`（合流されるまで待つ）が killed。報告本文は1文字も無い。
+  ・dc1c9ed2（ノートPC・ai-kana）… 同じ形（このPCに記録が無いので実物では確かめていない）。
+
+  ★原因は1つ。画面なし方式（`claude -p`）では【手番の終わり＝処理の終わり】。
+    「背景の待ちが終わったら続ける」つもりで手番を閉じると、その瞬間に背景の待ちは殺され、
+    職人は二度と起きない。対話の画面と違って、誰も起こしてくれない。
+
+【どう止めるか】Stop フック（ADR-024 の報告の関門）を土台に広げる。職人が手番を閉じようとした
+  ときに【実物】を見て、残っていれば `{"decision":"block","reason":…}` を返して続けさせる。
+  ★職人の言葉・報告の文意は読まない。見るのは次の3つだけ。
+    (1) この便で作った PR が開いたまま・合流の予約中のまま … `gh pr list` の実物
+    (2) 報告が無い・下書きのまま                          … 報告ファイルの形（囲み・本文・下書きの印）
+    (3) 背景に回した待ちが残っている                      … 会話の記録の `backgroundTaskId` と
+                                                           `<task-notification>` の差
+
+【止め続けない】同じ理由で止めるのは `CAP_PER_KIND` 回まで（合計 `CAP_TOTAL` 回まで）。
+  上限に達したら止めず、理由を控え（residue）に残して終わらせる。中継がその控えを
+  「終了の事実」の `jobEndDetail` に載せるので、管制には「途中で終わった」と分かる形で届く。
+  ★本体にも歯止めがある（連続 8 回で打ち切り・`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`）。
+    上限はその内側に収める（3 × 2 系統 = 最大 6 < 8）。
+
+【止めない便】
+  ・便の印（CONDUCTOR_JOB）が無い … そもそも便ではない（対話の作業・自己診断）
+  ・画面なし方式でない           … 対話の画面では「手番の終わり」は人への受け渡しなので止めない
+  ・人が答えるべき問いかけで終わった … 人の判断が先（ADR-024 §3 の取りこぼしを作らない）
+  ・便の本文に「合流は人が行う」と書いてある … (1) を見ない（ADR-007）
+  ・PR を作っていない便・読むだけの便 … (1) は当たらない（開いた PR が無いので何も起きない）
+"""
+import json
+import os
+import re
+import subprocess
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 回数の上限（★止め続けて便が終わらなくなる形にしない）
+# ─────────────────────────────────────────────────────────────────────────────
+#: 同じ理由で止める回数の上限。
+CAP_PER_KIND = 3
+#: 全部の理由を合わせた上限。★本体の連続上限（既定 8）より小さくする。
+CAP_TOTAL = 6
+
+#: 残りの種類（控えの数え方の見出し）。
+GATE_KINDS = ('report', 'pr', 'background')
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 置き場
+# ─────────────────────────────────────────────────────────────────────────────
+def _home(env):
+    return (env.get('HOME') or os.path.expanduser('~')).rstrip('/')
+
+
+def _state_root(env):
+    """`~/.local/state`（`XDG_STATE_HOME` があればそちら）。★中継の reportStoreDirs と同じ決め方。"""
+    xdg = (env.get('XDG_STATE_HOME') or '').strip()
+    return xdg if xdg else os.path.join(_home(env), '.local', 'state')
+
+
+def gate_dir(env=None):
+    """関門の控えの置き場。"""
+    env = os.environ if env is None else env
+    return os.path.join(_state_root(env), 'conductor', 'finish-gate')
+
+
+def _safe_id(command_id):
+    return re.sub(r'[^A-Za-z0-9_-]', '', str(command_id or ''))[:128] or 'unknown'
+
+
+def counts_path(command_id, env=None):
+    """その便で「どの理由で何回止めたか」の控え。"""
+    return os.path.join(gate_dir(env), f'{_safe_id(command_id)}.json')
+
+
+def residue_path(command_id, env=None):
+    """上限に達して終わらせたときの理由の控え（中継が終了の事実へ載せる）。"""
+    return os.path.join(gate_dir(env), f'{_safe_id(command_id)}.residue')
+
+
+def report_dirs(env=None):
+    """報告の置き場（★中継の reportStoreDirs と同じ順序・同じ決め方）。"""
+    env = os.environ if env is None else env
+    explicit = (env.get('CONDUCTOR_REPORT_DIR') or '').strip()
+    if explicit:
+        return [explicit]
+    uid = os.getuid() if hasattr(os, 'getuid') else 0
+    return [
+        os.path.join(_state_root(env), 'conductor', 'reports'),
+        os.path.join('/tmp', f'claude-{uid}', 'conductor-report'),
+        os.path.join('/tmp', f'conductor-report-{uid}'),
+    ]
+
+
+def report_files(command_id, env=None):
+    """その便の報告ファイルの候補（未処理 → 処理済みの順）。"""
+    name = f'{_safe_id(command_id)}.md'
+    dirs = report_dirs(env)
+    return [os.path.join(d, name) for d in dirs] + [os.path.join(d, 'processed', name) for d in dirs]
+
+
+def read_report_text(command_id, env=None):
+    """その便の報告の本文（無ければ None）。"""
+    for f in report_files(command_id, env):
+        try:
+            with open(f, encoding='utf-8', errors='replace') as fh:
+                text = fh.read().strip()
+        except Exception:  # noqa: BLE001
+            continue
+        if text:
+            return text
+    return None
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# (2) 報告が無い・下書きのまま
+# ─────────────────────────────────────────────────────────────────────────────
+#: 囲み（front matter）に要る欄。鉄則「便の終え方」②のとおり。
+REQUIRED_KEYS = ('instruction_id', 'site', 'outcome', 'created_at', 'evidence')
+#: `outcome` に書ける値。
+VALID_OUTCOMES = ('pushed', 'no_change', 'blocked')
+#: 「最終版で差し替える前」の印。★決まった字面の一覧だけを見る（文意は読まない）。
+DRAFT_MARKERS = ('作成中', '下書き', '差し替える', 'あとで書く', '（未記入）', '(未記入)', 'TODO', 'TBD')
+
+
+def report_residue(text):
+    """報告が「無い・下書きのまま」なら理由、出来上がっていれば None。★純粋関数。"""
+    if text is None or not text.strip():
+        return '報告ファイルが無い（または空）'
+    lines = text.strip().splitlines()
+    if lines[0].strip() != '---':
+        return '報告の1行目に囲み（---）が無い'
+    try:
+        end = next(i for i in range(1, len(lines)) if lines[i].strip() == '---')
+    except StopIteration:
+        return '報告の囲みが閉じていない（2つめの --- が無い）'
+    head = lines[1:end]
+    body = '\n'.join(lines[end + 1:]).strip()
+    keys = {}
+    for ln in head:
+        m = re.match(r'^([A-Za-z_][A-Za-z0-9_]*)\s*:\s*(.*)$', ln)
+        if m:
+            keys[m.group(1)] = m.group(2).strip()
+    missing = [k for k in REQUIRED_KEYS if k not in keys]
+    if missing:
+        return f'報告の囲みに足りない欄がある（{"・".join(missing)}）'
+    if keys['outcome'] not in VALID_OUTCOMES:
+        return f'報告の outcome が pushed / no_change / blocked のどれでもない（{keys["outcome"] or "空"}）'
+    # evidence は「- 」で始まる行が1つ以上要る。
+    if not any(ln.strip().startswith('- ') for ln in head):
+        return '報告の evidence が1件も無い'
+    if not body:
+        return '報告の本文が空（囲みだけ）'
+    hit = next((m for m in DRAFT_MARKERS if m in body), None)
+    if hit is not None:
+        return f'報告が下書きのまま（本文に「{hit}」が残っている）'
+    return None
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# (3) 背景に回した待ちが残っている
+# ─────────────────────────────────────────────────────────────────────────────
+#: 背景に回した仕事が始まった印（道具の戻りに入る・実測 2026-10-03）。
+_BG_START_RE = re.compile(r'"backgroundTaskId"\s*:\s*"([A-Za-z0-9_-]+)"')
+#: 背景の仕事から知らせが届いた印。★`<task-notification>` の塊の中の `<task-id>` だけを拾う
+#:  （道具の説明文に出てくる `<task-notification>` の字面を取り違えない）。
+_BG_NOTIFY_RE = re.compile(r'<task-notification>(.*?)</task-notification>', re.S)
+_BG_TASK_ID_RE = re.compile(r'<task-id>([A-Za-z0-9_-]+)</task-id>')
+
+
+def outstanding_background_tasks(transcript_path):
+    """知らせがまだ届いていない背景の仕事の番号（順番は出てきた順）。読めなければ空。"""
+    if not transcript_path or not os.path.isfile(transcript_path):
+        return []
+    started, settled = [], set()
+    try:
+        with open(transcript_path, encoding='utf-8', errors='replace') as f:
+            for line in f:
+                for m in _BG_START_RE.finditer(line):
+                    if m.group(1) not in started:
+                        started.append(m.group(1))
+                if '<task-notification>' not in line:
+                    continue
+                for blk in _BG_NOTIFY_RE.findall(line.replace('\\n', '\n')):
+                    settled.update(_BG_TASK_ID_RE.findall(blk))
+    except Exception:  # noqa: BLE001
+        return []
+    return [t for t in started if t not in settled]
+
+
+def background_residue(task_ids):
+    """★純粋関数。残っていれば理由、無ければ None。"""
+    if not task_ids:
+        return None
+    return ('背景に回した待ちが ' + str(len(task_ids)) + ' 件残っている（'
+            + '・'.join(task_ids[:5]) + '）')
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# (1) PR が開いたまま・合流の予約中のまま
+# ─────────────────────────────────────────────────────────────────────────────
+#: 便の本文に書かれた「合流は人が行う」（ADR-007）。★これが在れば (1) を見ない。
+#: 「〜する」の言い回し（する・します・行う・行います・やる・やります …）。
+_DO = r'(?:行(?:う|います|います。)|やり(?:ます)?|やる|し(?:ます)?|する)'
+_HUMAN_MERGE_RE = re.compile(
+    r'(?:マージ|合流)は(?:人間|人|えふさん|持ち主)が' + _DO
+    + r'|(?:人間|人|えふさん|持ち主)が(?:マージ|合流)(?:を)?' + _DO
+    + r'|(?:マージ|合流)しない',
+)
+
+
+def human_merge_requested(job_body):
+    """便の本文が「合流は人が行う／合流しない」と言っているか。★純粋関数。"""
+    return bool(_HUMAN_MERGE_RE.search(job_body or ''))
+
+
+def open_pr_residue(prs):
+    """`gh pr list` の結果から理由を作る。★純粋関数（通信はしない）。
+
+    prs は [{'number':…, 'url':…, 'state':'OPEN', 'autoMergeRequest':{…}|None}, …]。
+    """
+    if not isinstance(prs, list):
+        return None
+    out = []
+    for pr in prs:
+        if not isinstance(pr, dict):
+            continue
+        if str(pr.get('state') or 'OPEN').upper() != 'OPEN':
+            continue
+        num = pr.get('number')
+        if pr.get('autoMergeRequest'):
+            out.append(f'#{num}（合流の予約中）')
+        else:
+            out.append(f'#{num}（開いたまま）')
+    if not out:
+        return None
+    return 'この便で作った PR が合流していない: ' + '・'.join(out)
+
+
+def current_branch(work_dir):
+    """いまの作業ブランチ名（読めない・main のときは None）。"""
+    try:
+        r = subprocess.run(
+            ['git', '-C', work_dir, 'rev-parse', '--abbrev-ref', 'HEAD'],
+            capture_output=True, text=True, timeout=15, check=False,
+        )
+    except Exception:  # noqa: BLE001
+        return None
+    b = (r.stdout or '').strip()
+    if r.returncode != 0 or not b or b in ('HEAD', 'main', 'master'):
+        return None
+    return b
+
+
+def read_open_prs(work_dir, branch):
+    """その枝の開いた PR を聞く。聞けなければ None（＝分からない＝止めない側へ倒す）。"""
+    if not branch:
+        return None
+    try:
+        r = subprocess.run(
+            ['gh', 'pr', 'list', '--head', branch, '--state', 'open',
+             '--json', 'number,url,state,autoMergeRequest'],
+            cwd=work_dir, capture_output=True, text=True, timeout=30, check=False,
+        )
+    except Exception:  # noqa: BLE001
+        return None
+    if r.returncode != 0:
+        return None
+    try:
+        got = json.loads(r.stdout or '[]')
+    except Exception:  # noqa: BLE001
+        return None
+    return got if isinstance(got, list) else None
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 回数の数え方
+# ─────────────────────────────────────────────────────────────────────────────
+def load_counts(command_id, env=None):
+    try:
+        with open(counts_path(command_id, env), encoding='utf-8') as f:
+            got = json.load(f)
+    except Exception:  # noqa: BLE001
+        return {}
+    return {k: int(v) for k, v in got.items() if k in GATE_KINDS and isinstance(v, (int, float))} \
+        if isinstance(got, dict) else {}
+
+
+def save_counts(command_id, counts, env=None):
+    p = counts_path(command_id, env)
+    try:
+        os.makedirs(os.path.dirname(p), mode=0o700, exist_ok=True)
+        with open(p, 'w', encoding='utf-8') as f:
+            json.dump(counts, f)
+    except Exception:  # noqa: BLE001
+        pass
+
+
+def save_residue(command_id, text, env=None):
+    """上限に達して終わらせた理由を残す（中継が終了の事実へ載せる）。"""
+    p = residue_path(command_id, env)
+    try:
+        os.makedirs(os.path.dirname(p), mode=0o700, exist_ok=True)
+        with open(p, 'w', encoding='utf-8') as f:
+            f.write(text.strip()[:500])
+    except Exception:  # noqa: BLE001
+        return False
+    return True
+
+
+def cap_per_kind(env=None):
+    env = os.environ if env is None else env
+    try:
+        n = int((env.get('CONDUCTOR_FINISH_GATE_CAP') or '').strip())
+    except Exception:  # noqa: BLE001
+        return CAP_PER_KIND
+    return n if n >= 0 else CAP_PER_KIND
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 判定（★純粋関数。ここに通信もファイル読みも入れない）
+# ─────────────────────────────────────────────────────────────────────────────
+def decide(residues, counts, cap=CAP_PER_KIND, cap_total=CAP_TOTAL):
+    """残り（{種類: 理由}）と今までの回数から、止めるかどうかを決める。
+
+    返り: {'block': bool, 'kinds': [種類], 'reasons': [理由], 'counts': 次の回数, 'last': bool}
+      block=True  … 続けさせる（reason を職人へ返す）
+      block=False … 終わらせる（kinds が空でなければ「途中で終わった」＝控えを残す）
+      last=True   … これが最後の差し戻し（次は止めない）
+    """
+    counts = {k: int(counts.get(k, 0)) for k in GATE_KINDS}
+    live = [k for k in GATE_KINDS if residues.get(k)]
+    if not live:
+        return {'block': False, 'kinds': [], 'reasons': [], 'counts': counts, 'last': False}
+    total = sum(counts.values())
+    allowed = [k for k in live if counts[k] < cap] if total < cap_total else []
+    if not allowed:
+        # 上限に達した。止めずに、理由を付けて終わらせる。
+        return {'block': False, 'kinds': live, 'reasons': [residues[k] for k in live],
+                'counts': counts, 'last': False}
+    nxt = dict(counts)
+    for k in allowed:
+        nxt[k] += 1
+    last = sum(nxt.values()) >= cap_total or all(nxt[k] >= cap for k in allowed)
+    return {'block': True, 'kinds': allowed, 'reasons': [residues[k] for k in allowed],
+            'counts': nxt, 'last': last}
+
+
+#: 残りの種類ごとの「次にやること」。★職人へ返す文（Conductor が報告の中身を作ることはしない）。
+NEXT_STEPS = {
+    'background': (
+        '背景に回した待ちを、いまこの手番の中で終わらせてください。'
+        '★画面なし方式（claude -p）では【手番の終わり＝処理の終わり】です。'
+        '手番を閉じると背景の待ちは殺され、職人は二度と起きません（実地 915694ac・47bdfe00）。'
+        '待つなら Monitor か until ループで、この手番の中で待ち切ってください。'
+    ),
+    'pr': (
+        '鉄則7のとおり、保護の確認 → CI → 合流 → 合流後の確かめ（4段）を終わらせてください。'
+        '合流を予約しただけでは終わりではありません。`gh pr view <番号> --json state` が '
+        'MERGED になり、合流でできたコミットが合流先に入っていることを実物で確かめてから報告します。'
+        '★`--admin` など保護を迂回する旗は使いません。合流できない理由が分かったら、'
+        'その理由を報告に書いて終えてください（それなら止めません）。'
+    ),
+    'report': (
+        '報告を最終版まで書き上げてください（置き場は配達役の1行が指すファイル1か所）。'
+        '1行目から6欄の囲み（instruction_id・site・outcome・created_at・evidence）を置き、'
+        'その下に本文を書きます。★「作成中」「差し替える」などの下書きの印を1つも残さないでください。'
+    ),
+}
+
+
+def build_reason(result):
+    """職人へ返す文（何が残っているか＋次にやること）。"""
+    head = '【便の終わりの関門】まだ終わっていません。この手番を閉じないでください。'
+    lines = [head, '', '■ 残っているもの（実物で確かめた事実）']
+    lines += [f'  ・{r}' for r in result['reasons']]
+    lines += ['', '■ 次にやること']
+    lines += [f'  ・{NEXT_STEPS[k]}' for k in result['kinds']]
+    if result.get('last'):
+        lines += ['', '★これが最後の差し戻しです。次に手番を閉じると便は終わります。'
+                      'どうしても終わらせられないときは、報告の outcome を blocked にして、'
+                      '「どこまで進んだか・何が残っているか・なぜ進められないか」を書いて終えてください。']
+    return '\n'.join(lines)
+
+
+def build_residue_text(result):
+    """上限に達して終わらせたときに控えへ残す1行（管制へ「途中で終わった」として届く）。"""
+    return '途中で終わった（便の終わりの関門の上限）: ' + ' / '.join(result['reasons'])

package/scripts/hooks/policy.py

@@ -2343,6 +2343,14 @@ def _real_segments(command: str):
 GUARD_PLACES = (
     ('site-file', '.claude/settings'),
     ('home-tree', '.claude/skills'),
+    # ★~/.tyhld は【まるごと】守る（便 7aa63a97）。
+    #   【実地の穴（便 b7bd5e43 の発見・2026-10-03 に再現）】Write・Edit は前から ~/.tyhld の
+    #   どこでも止めていた（下の「前からの広い守り」）。ところが Bash は hooks と bin の下しか
+    #   止めず、~/.tyhld の直下（kc の実体・ブラウザの道具・控え）は職人の touch・rm・リダイレクト・
+    #   cp・mv・sed -i から書けた（実測で allow）。＝道具によって結果が違う穴。
+    #   ★hooks・bin の2行は【消さない】。一覧は OR で照らすので、残しておけば
+    #   「前から止まっていた物が通る」ことが構造的に起きない（守りを強める方向だけ）。
+    ('home-tree', '.tyhld'),
     ('home-tree', '.tyhld/hooks'),
     ('home-tree', '.tyhld/bin'),
     ('home-tree', '.config/systemd'),
@@ -3297,7 +3305,9 @@ def _expand_vars(text: str, env) -> str:
 #   ★報告の文の中に場所の名前が出てくるだけ（空白を含む文字列）は場所と読まない。
 _CODE_GUARD_JOIN_RE = re.compile(
     r'''['"]\.claude['"]\s*[,/+]\s*['"](settings[\w.]*\.json|skills)['"/]'''
-    r'''|['"]\.tyhld['"]\s*[,/+]\s*['"](hooks|bin)['"/]'''
+    # ★`'.tyhld'` に【何を】つないでも場所と読む（便 7aa63a97）。前は hooks|bin だけだったので、
+    #   Path.home() / '.tyhld' / 'kc.sh' のような組み立てが素通りしていた。広げる方向だけ。
+    r'''|['"]\.tyhld['"]\s*[,/+]\s*['"]'''
     r'''|['"]\.[\w-]+['"]\s*[,/+]\s*['"](hooks\.json|config\.toml)['"]'''
     r'''|['"]\.config['"]\s*[,/+]\s*['"]systemd['"/]''')
 _CODE_PATH_LITERAL_RE = re.compile(r'''['"`]>{0,2}([^'"`\s*?\[\]]{1,300})['"`]''')

package/scripts/hooks/stop_hook.py

@@ -3,10 +3,17 @@
 
 【いつ走るか】職人が応答を返し終えた瞬間（＝入力待ちに入る瞬間）。
 
-【何をするか】
-  紐づく指示（ConductorCommand）が【まだ終わっていない】、かつ最後の発言が【人の判断を
-  求める問いかけ】のときだけ、その発言を kind='message' として管制へ送る。
-  管制側ではフックが待っている間だけカードが出る。
+【何をするか】★2つの役目を持つ。順番は「① 終わりの関門 → ② 確認カード」ではなく
+  「① 人の問いかけなら確認カード → ② そうでなければ終わりの関門」。人の判断が先。
+
+  ① 確認カード（前からの役目）… 紐づく指示（ConductorCommand）が【まだ終わっていない】、
+     かつ最後の発言が【人の判断を求める問いかけ】のときだけ、その発言を kind='message' として
+     管制へ送る。管制側ではフックが待っている間だけカードが出る。
+
+  ② ★便の終わりの関門（便 7aa63a97 で足した）… 人への問いかけではない手番の終わりでは、
+     【実物】を見て「まだ残っている」なら `{"decision":"block","reason":…}` を返して続けさせる。
+     見るのは PR・報告ファイル・背景に回した待ちの3つだけで、職人の言葉は読まない。
+     判定と回数の上限は finish_gate.py にある（そこの説明文に実地の3件と理由を書いた）。
 
 【★カードを出す条件は2つ（両方満たしたときだけ出す）】
   (1) 紐づく指示がまだ終わっていないこと
@@ -40,6 +47,7 @@ import sys
 
 sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
 
+import finish_gate  # noqa: E402
 import hook_datalink  # noqa: E402
 import summary_ja  # noqa: E402
 
@@ -223,6 +231,86 @@ def build_payload(data, command_id):
     }
 
 
+# ─────────────────────────────────────────────────────────────────────────────
+# ★便の終わりの関門（finish_gate.py の判定へ、実物を集めて渡すだけの層）
+# ─────────────────────────────────────────────────────────────────────────────
+def load_job_body(site, env=None):
+    """中継が残した「いま走っている便」の本文（無ければ空）。★便の本文だけを読む。"""
+    env = os.environ if env is None else env
+    if not site:
+        return ''
+    xdg = (env.get('XDG_STATE_HOME') or '').strip()
+    root = xdg if xdg else os.path.join((env.get('HOME') or os.path.expanduser('~')), '.local', 'state')
+    for name in (f'active-job-{site}.json', f'last-job-{site}.json'):
+        try:
+            with open(os.path.join(root, 'conductor', name), encoding='utf-8') as f:
+                got = json.load(f)
+        except Exception:  # noqa: BLE001
+            continue
+        if isinstance(got, dict) and isinstance(got.get('body'), str):
+            return got['body']
+    return ''
+
+
+def gate_enabled(env=None):
+    """関門を効かせる機体か。★画面なし方式のときだけ（対話の画面は1文字も変えない）。
+
+    対話の画面では「手番の終わり」は人への受け渡しなので、止めると人と話せなくなる。
+    印が無い機体では何もしない（fail open＝いまと同じ動き・退行しない）。
+    """
+    env = os.environ if env is None else env
+    return (env.get('CONDUCTOR_RUNNER_MODE') or '').strip().lower() == 'headless'
+
+
+def collect_residues(data, command_id, env=None):
+    """残っている物を【実物】で集める（{種類: 理由}）。読めないものは「無い」側へ倒す。"""
+    env = os.environ if env is None else env
+    site = (env.get('CONDUCTOR_SITE') or '').strip()
+    work_dir = (env.get('CONDUCTOR_WORK_DIR') or '').strip() or (data.get('cwd') or '')
+    residues = {}
+
+    # (2) 報告 … 置き場の実物を見る。
+    residues['report'] = finish_gate.report_residue(
+        finish_gate.read_report_text(command_id, env))
+
+    # (3) 背景に回した待ち … 会話の記録の実物を見る。
+    residues['background'] = finish_gate.background_residue(
+        finish_gate.outstanding_background_tasks(data.get('transcript_path')))
+
+    # (1) PR … 便の本文が「合流は人が行う／合流しない」と言っていれば見ない（ADR-007）。
+    if not finish_gate.human_merge_requested(load_job_body(site, env)) and work_dir:
+        residues['pr'] = finish_gate.open_pr_residue(
+            finish_gate.read_open_prs(work_dir, finish_gate.current_branch(work_dir)))
+    return {k: v for k, v in residues.items() if v}
+
+
+def finish_gate_block(data, env=None):
+    """関門の判定。続けさせるなら職人へ返す文、終わらせるなら None。
+
+    ★止めるのは「実物が残っていて、かつ回数の上限に達していない」ときだけ。
+      上限に達したら止めず、理由を控えに残す（管制へ「途中で終わった」として届く）。
+    """
+    env = os.environ if env is None else env
+    if not gate_enabled(env):
+        return None
+    command_id = find_command_id(data.get('transcript_path'))
+    if not command_id:
+        return None  # 便ではない（対話の作業・自己診断）→ 止めない
+    residues = collect_residues(data, command_id, env)
+    result = finish_gate.decide(
+        residues,
+        finish_gate.load_counts(command_id, env),
+        cap=finish_gate.cap_per_kind(env),
+    )
+    if result['block']:
+        finish_gate.save_counts(command_id, result['counts'], env)
+        return finish_gate.build_reason(result)
+    if result['kinds']:
+        # 上限に達した＝これ以上止めない。理由だけ残して終わらせる。
+        finish_gate.save_residue(command_id, finish_gate.build_residue_text(result), env)
+    return None
+
+
 def run(data, cfg=None, datalink=hook_datalink):
     """返り値: 送った確認のID / None（送らなかった）。"""
     message = data.get('last_assistant_message')
@@ -264,11 +352,33 @@ def main() -> int:
         data = json.loads(raw) if raw.strip() else {}
     except Exception:  # noqa: BLE001
         return 0
+
+    # ① 人が答えるべき問いかけで終わった手番は、前からの確認カードの経路だけを通す。
+    #    ★関門で止めると人の答えが流れる（ADR-024 §3 の取りこぼしを作らない）。
+    message = data.get('last_assistant_message')
+    asks_human = isinstance(message, str) and needs_human_answer(message)
+    if asks_human:
+        try:
+            run(data)
+        except Exception:  # noqa: BLE001
+            pass
+        return 0
+
+    # ② 便の終わりの関門。残っていれば続けさせる。
+    #    ★ここで何が起きても便を壊さない（例外は握って、いまと同じ「何もしない」へ倒す）。
+    try:
+        reason = finish_gate_block(data)
+    except Exception:  # noqa: BLE001
+        reason = None
+    if reason:
+        print(json.dumps({'decision': 'block', 'reason': reason}, ensure_ascii=False))
+        return 0
+
     try:
         run(data)
     except Exception:  # noqa: BLE001
         pass
-    return 0  # ★Stop フックは会話を止めない（何があっても exit 0・出力なし）
+    return 0  # ★止めないときは今までどおり（exit 0・出力なし）
 
 
 if __name__ == '__main__':

package/scripts/hooks/test_finish_gate.py

@@ -0,0 +1,310 @@
+#!/usr/bin/env python3
+"""便の終わりの関門の検査（便 7aa63a97）。
+
+  実行: python3 scripts/hooks/test_finish_gate.py
+  1件でも期待と違えば exit 1。
+
+【直したこと】職人が「合流・公開・本番の確かめ・報告」の前に手番を閉じるのを、仕組みで止める。
+  実地 2026-10-02〜03 に3回起きた（915694ac・47bdfe00・dc1c9ed2）。どの便の本文にも
+  「待ちを背景に残したまま手番を閉じない」と書いてあった＝★指示の文では止まらない。
+
+【ここで固定すること】
+  (A) 報告の判定 … 無い・空・囲みが無い・欄が足りない・outcome が変・evidence 0件・
+      本文が空・下書きの印が残っている → 残り。最終版 → 残り無し
+  (B) 背景の待ちの数え方 … 始まった印（backgroundTaskId）と知らせ（task-notification）の差。
+      ★実地 915694ac・47bdfe00 と同じ形の記録で確かめる
+  (C) PR の判定 … 開いたまま／合流の予約中 → 残り。空・合流済み → 残り無し。
+      便の本文が「合流は人が行う」なら見ない
+  (D) 回数の上限 … 同じ理由で止めるのは上限まで。上限に達したら止めずに終わらせる
+  (E) 返す文 … 「何が残っているか」と「次にやること」が入る
+  (F) ★止めない便 … 便の印が無い／画面なし方式でない／人への問いかけで終わった
+  (G) ★実地の3件の再現 … 当時の実物を置くと、関門がそれぞれ止める
+
+★空振り確認（隔離した worktree の中だけ）:
+  ・finish_gate.decide の上限の判定（`counts[k] < cap`）を外す → (D) が落ちる
+  ・report_residue の下書きの印の判定を外す → (A) が落ちる
+  ・stop_hook.main から関門の呼び出しを外す → (G) の「止める」が落ちる
+"""
+import json
+import os
+import sys
+import tempfile
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+import finish_gate  # noqa: E402
+import stop_hook  # noqa: E402
+
+failures = []
+
+
+def check(label, got, want):
+    ok = got == want
+    if not ok:
+        failures.append(f'{label}: got={got!r} want={want!r}')
+    print(f'{"OK " if ok else "NG "} {label:66} {str(got)[:46]}')
+
+
+def truthy(label, got):
+    ok = bool(got)
+    if not ok:
+        failures.append(f'{label}: got={got!r} want=真')
+    print(f'{"OK " if ok else "NG "} {label:66} {str(got)[:46]}')
+
+
+SANDBOX = tempfile.mkdtemp(prefix='finish-gate-test-')
+ENV = {'HOME': SANDBOX, 'XDG_STATE_HOME': os.path.join(SANDBOX, 'state'),
+       'CONDUCTOR_RUNNER_MODE': 'headless', 'CONDUCTOR_SITE': 'demo'}
+JOB = '7aa63a97-57e7-4c42-8b95-f3da87d88829'
+
+
+def report_text(outcome='pushed', body='やりました。', header=True, evidence=True):
+    head = ['---', f'instruction_id: {JOB}', 'site: demo', f'outcome: {outcome}',
+            'created_at: 2026-10-03T09:00:00+09:00', 'evidence:']
+    if evidence:
+        head.append('  - PR https://github.com/tyhld/conductor/pull/999')
+    head.append('---')
+    return ('\n'.join(head) + '\n\n' + body) if header else body
+
+
+def put_report(text, command_id=JOB):
+    d = os.path.join(ENV['XDG_STATE_HOME'], 'conductor', 'reports')
+    os.makedirs(d, exist_ok=True)
+    with open(os.path.join(d, f'{command_id}.md'), 'w', encoding='utf-8') as f:
+        f.write(text)
+
+
+def drop_report(command_id=JOB):
+    for f in finish_gate.report_files(command_id, ENV):
+        if os.path.isfile(f):
+            os.remove(f)
+
+
+def put_job_body(body, site='demo'):
+    d = os.path.join(ENV['XDG_STATE_HOME'], 'conductor')
+    os.makedirs(d, exist_ok=True)
+    with open(os.path.join(d, f'active-job-{site}.json'), 'w', encoding='utf-8') as f:
+        json.dump({'commandId': JOB, 'body': body, 'site': site}, f)
+
+
+def transcript(lines, name='t.jsonl'):
+    p = os.path.join(SANDBOX, name)
+    with open(p, 'w', encoding='utf-8') as f:
+        f.write('\n'.join(lines) + '\n')
+    return p
+
+
+def clear_counts(command_id=JOB):
+    for p in (finish_gate.counts_path(command_id, ENV), finish_gate.residue_path(command_id, ENV)):
+        if os.path.isfile(p):
+            os.remove(p)
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('=== (A) 報告の判定（★実物の形だけを見る） ===')
+# ─────────────────────────────────────────────────────────────────────────────
+check('無い → 残り', bool(finish_gate.report_residue(None)), True)
+check('空 → 残り', bool(finish_gate.report_residue('   \n ')), True)
+check('囲みが無い → 残り', bool(finish_gate.report_residue('やりました。')), True)
+check('囲みが閉じていない → 残り',
+      bool(finish_gate.report_residue('---\ninstruction_id: x\n\n本文')), True)
+check('欄が足りない → 残り',
+      bool(finish_gate.report_residue('---\ninstruction_id: x\nsite: demo\n---\n\n本文')), True)
+check('outcome が変 → 残り', bool(finish_gate.report_residue(report_text(outcome='やった'))), True)
+check('outcome が空 → 残り', bool(finish_gate.report_residue(report_text(outcome=''))), True)
+check('evidence 0件 → 残り', bool(finish_gate.report_residue(report_text(evidence=False))), True)
+check('本文が空 → 残り', bool(finish_gate.report_residue(report_text(body=''))), True)
+check('★最終版 → 残り無し', finish_gate.report_residue(report_text()), None)
+check('no_change も通る', finish_gate.report_residue(report_text(outcome='no_change')), None)
+check('blocked も通る', finish_gate.report_residue(report_text(outcome='blocked')), None)
+
+print('--- ★下書きの印（実地 915694ac の本文そのまま） ---')
+REAL_DRAFT = '# 便 915694ac 報告（作成中）\n\nこの見出しは最終版で差し替える。'
+truthy('実地の下書き → 残り', finish_gate.report_residue(report_text(body=REAL_DRAFT)))
+for m in ('作成中', '下書き', '差し替える', 'あとで書く', '（未記入）', 'TODO', 'TBD'):
+    truthy(f'下書きの印「{m}」→ 残り', finish_gate.report_residue(report_text(body=f'あ{m}い')))
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (B) 背景の待ちの数え方（★実地と同じ形の記録） ===')
+# ─────────────────────────────────────────────────────────────────────────────
+START = '{"toolUseResult":{"stdout":"","backgroundTaskId":"%s"}}'
+NOTIFY = ('{"message":{"content":[{"type":"text","text":"<task-notification>\\n'
+          '<task-id>%s</task-id>\\n<status>%s</status>\\n</task-notification>"}]}}')
+
+check('何も無い → 残り0', finish_gate.outstanding_background_tasks(transcript(['{}'])), [])
+check('始まって知らせが来た → 残り0',
+      finish_gate.outstanding_background_tasks(
+          transcript([START % 'b1', NOTIFY % ('b1', 'completed')], 'a.jsonl')), [])
+check('★始まったのに知らせが無い → 残る（915694ac の形）',
+      finish_gate.outstanding_background_tasks(
+          transcript([START % 'b4s4rn5ee', NOTIFY % ('b4s4rn5ee', 'completed'),
+                      START % 'b32iul78k'], 'b.jsonl')), ['b32iul78k'])
+check('★複数残る（47bdfe00 の形）',
+      finish_gate.outstanding_background_tasks(
+          transcript([START % 'b445wfjet', START % 'be6b727fc', START % 'buu5zuhgd',
+                      NOTIFY % ('buu5zuhgd', 'completed')], 'c.jsonl')),
+      ['b445wfjet', 'be6b727fc'])
+check('知らせが killed でも「知らせは来た」＝残らない',
+      finish_gate.outstanding_background_tasks(
+          transcript([START % 'b1', NOTIFY % ('b1', 'killed')], 'd.jsonl')), [])
+check('★道具の説明文の中の字面は知らせと読まない',
+      finish_gate.outstanding_background_tasks(
+          transcript([START % 'b1',
+                      '{"text":"<task-notification> arrives when the workflow completes"}'],
+                     'e.jsonl')), ['b1'])
+check('記録が無い → 残り0（読めないものは無い側へ倒す）',
+      finish_gate.outstanding_background_tasks('/nope/nothing.jsonl'), [])
+check('残りが在れば理由になる', bool(finish_gate.background_residue(['b1'])), True)
+check('残りが無ければ理由にならない', finish_gate.background_residue([]), None)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (C) PR の判定 ===')
+# ─────────────────────────────────────────────────────────────────────────────
+check('開いた PR 無し → 残り無し', finish_gate.open_pr_residue([]), None)
+check('聞けなかった（None）→ 残り無し（分からないものは止めない側）',
+      finish_gate.open_pr_residue(None), None)
+truthy('★開いたまま → 残り（915694ac の PR #252 の形）',
+       finish_gate.open_pr_residue([{'number': 252, 'state': 'OPEN', 'autoMergeRequest': None}]))
+r = finish_gate.open_pr_residue([{'number': 397, 'state': 'OPEN',
+                                  'autoMergeRequest': {'enabledAt': 'x'}}])
+truthy('★合流の予約中のまま → 残り（47bdfe00 の形）', r)
+check('予約中だと分かる文になっている', '予約' in (r or ''), True)
+check('合流済み（MERGED）→ 残り無し',
+      finish_gate.open_pr_residue([{'number': 1, 'state': 'MERGED', 'autoMergeRequest': None}]), None)
+
+print('--- 便の本文に「合流は人が行う」と書いてある便は見ない（ADR-007） ---')
+for b in ['この便のマージは人間が行う', '合流は人が行う', 'マージは人間が行います',
+          '★この便では合流しない', '人がマージする']:
+    check(f'「{b}」', finish_gate.human_merge_requested(b), True)
+for b in ['合流まで進めてください', '鉄則7のとおり合流する', '']:
+    check(f'ふつうの便「{b[:20]}」', finish_gate.human_merge_requested(b), False)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (D) 回数の上限（★止め続けて便が終わらなくなる形にしない） ===')
+# ─────────────────────────────────────────────────────────────────────────────
+R1 = {'report': '報告が無い'}
+d = finish_gate.decide(R1, {}, cap=3)
+check('1回目は止める', d['block'], True)
+check('回数が1になる', d['counts']['report'], 1)
+d = finish_gate.decide(R1, {'report': 2}, cap=3)
+check('3回目は止める', d['block'], True)
+check('3回目は「最後の差し戻し」と分かる', d['last'], True)
+d = finish_gate.decide(R1, {'report': 3}, cap=3)
+check('★上限に達したら止めない（便が終わる）', d['block'], False)
+check('★ただし「途中で終わった」と分かる（種類が残る）', d['kinds'], ['report'])
+truthy('控えの文に理由が入る', '途中で終わった' in finish_gate.build_residue_text(d))
+
+check('残りが無ければ止めない', finish_gate.decide({}, {}, cap=3)['block'], False)
+check('残りが無ければ種類も空', finish_gate.decide({}, {'report': 1}, cap=3)['kinds'], [])
+
+d = finish_gate.decide({'report': 'a', 'pr': 'b', 'background': 'c'}, {}, cap=3)
+check('3つ同時でも1回で止める', d['block'], True)
+check('3つぶん数える', sorted(d['kinds']), ['background', 'pr', 'report'])
+d = finish_gate.decide({'report': 'a', 'pr': 'b'}, {'report': 2, 'pr': 2, 'background': 2}, cap=3)
+check('★合計の上限（本体の連続上限 8 の内側）で止めなくなる', d['block'], False)
+check('cap=0 なら1回も止めない', finish_gate.decide(R1, {}, cap=0)['block'], False)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (E) 職人へ返す文 ===')
+# ─────────────────────────────────────────────────────────────────────────────
+d = finish_gate.decide({'report': '報告が下書きのまま', 'pr': 'PR #252 が開いたまま',
+                        'background': '背景に回した待ちが 1 件残っている'}, {}, cap=3)
+msg = finish_gate.build_reason(d)
+truthy('何が残っているかが入る', '残っているもの' in msg)
+truthy('次にやることが入る', '次にやること' in msg)
+truthy('残りの理由がそのまま入る', 'PR #252 が開いたまま' in msg)
+truthy('★手番を閉じないでと書いてある', '閉じない' in msg)
+truthy('★画面なし方式では手番の終わり＝処理の終わりと書いてある', '手番の終わり' in msg)
+truthy('鉄則7の4段を指している', '合流後' in msg or '鉄則7' in msg)
+last = finish_gate.build_reason(finish_gate.decide(R1, {'report': 2}, cap=3))
+truthy('最後の差し戻しだと伝える', '最後の差し戻し' in last)
+truthy('終わらせ方（blocked）を示す', 'blocked' in last)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (F) ★止めない便 ===')
+# ─────────────────────────────────────────────────────────────────────────────
+check('画面なし方式の印が在る → 効く', stop_hook.gate_enabled(ENV), True)
+for mode in ('tmux', '', 'TMUX'):
+    e = dict(ENV, CONDUCTOR_RUNNER_MODE=mode)
+    check(f'画面の方式（{mode or "印なし"}）→ 効かない', stop_hook.gate_enabled(e), False)
+check('印そのものが無い → 効かない', stop_hook.gate_enabled({}), False)
+
+clear_counts()
+drop_report()
+check('★便の印が無い記録 → 止めない（便ではない）',
+      stop_hook.finish_gate_block(
+          {'transcript_path': transcript(['{"text":"ふつうの作業"}'], 'nojob.jsonl')}, ENV), None)
+check('★人が答えるべき問いかけは関門より先（確認カードの経路へ）',
+      stop_hook.needs_human_answer('どちらにしますか？'), True)
+check('進捗の報告は問いかけではない',
+      stop_hook.needs_human_answer('CI の完走を待っています。'), False)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (G) ★実地の3件の再現（実物を置いて、関門が止めるか） ===')
+# ─────────────────────────────────────────────────────────────────────────────
+JOB_LINE = f'{{"text":"CONDUCTOR_JOB:{JOB}"}}'
+put_job_body('鉄則7のとおり合流まで進めてください')
+
+# 915694ac … 報告が下書きのまま ＋ 背景の待ちが残っている
+clear_counts()
+put_report(report_text(body=REAL_DRAFT))
+t = transcript([JOB_LINE, START % 'b32iul78k'], 'g1.jsonl')
+msg = stop_hook.finish_gate_block({'transcript_path': t, 'cwd': SANDBOX}, ENV)
+truthy('★915694ac の形 → 止める', msg)
+truthy('  下書きだと言う', '下書き' in (msg or ''))
+truthy('  背景の待ちが残っていると言う', '背景' in (msg or ''))
+
+# 47bdfe00 … 報告本文が1文字も無い
+clear_counts()
+put_report(report_text(body=''))
+t = transcript([JOB_LINE, START % 'be6b727fc'], 'g2.jsonl')
+msg = stop_hook.finish_gate_block({'transcript_path': t, 'cwd': SANDBOX}, ENV)
+truthy('★47bdfe00 の形 → 止める', msg)
+
+# dc1c9ed2 … 報告が1つも無い
+clear_counts()
+drop_report()
+t = transcript([JOB_LINE], 'g3.jsonl')
+msg = stop_hook.finish_gate_block({'transcript_path': t, 'cwd': SANDBOX}, ENV)
+truthy('★dc1c9ed2 の形（報告が無い）→ 止める', msg)
+
+print('--- ★きちんと終わった便は止めない ---')
+clear_counts()
+put_report(report_text())
+t = transcript([JOB_LINE, START % 'b1', NOTIFY % ('b1', 'completed')], 'g4.jsonl')
+check('最終版の報告＋待ち無し → 止めない',
+      stop_hook.finish_gate_block({'transcript_path': t, 'cwd': SANDBOX}, ENV), None)
+
+print('--- ★上限に達したら終わらせ、理由の控えを残す ---')
+clear_counts()
+drop_report()
+t = transcript([JOB_LINE], 'g5.jsonl')
+stops = 0
+for _ in range(8):
+    if stop_hook.finish_gate_block({'transcript_path': t, 'cwd': SANDBOX}, ENV):
+        stops += 1
+    else:
+        break
+check('止めた回数は上限まで', stops, finish_gate.CAP_PER_KIND)
+check('その後は止めない',
+      stop_hook.finish_gate_block({'transcript_path': t, 'cwd': SANDBOX}, ENV), None)
+rp = finish_gate.residue_path(JOB, ENV)
+truthy('理由の控えが残る', os.path.isfile(rp))
+with open(rp, encoding='utf-8') as f:
+    truthy('控えに「途中で終わった」と入っている', '途中で終わった' in f.read())
+
+print('--- ★便の本文が「合流は人が行う」なら PR を見ない ---')
+clear_counts()
+put_report(report_text())
+put_job_body('★この便のマージは人間が行う')
+t = transcript([JOB_LINE, START % 'b1', NOTIFY % ('b1', 'completed')], 'g6.jsonl')
+check('合流を人に任せた便は止めない',
+      stop_hook.finish_gate_block({'transcript_path': t, 'cwd': SANDBOX}, ENV), None)
+
+print('\n' + '=' * 72)
+if failures:
+    print(f'NG {len(failures)} 件')
+    for f in failures:
+        print('  ' + f)
+    sys.exit(1)
+print('すべて期待どおり')

package/scripts/hooks/test_guard_tyhld_whole_tree.py

@@ -0,0 +1,165 @@
+#!/usr/bin/env python3
+"""番人の守る場所を ~/.tyhld まるごとに広げたことの検査（便 7aa63a97・発見は便 b7bd5e43）。
+
+  実行: python3 scripts/hooks/test_guard_tyhld_whole_tree.py
+  1件でも期待と違えば exit 1。
+
+【直した穴（2026-10-03 に実物で再現）】
+  Write・Edit は前から ~/.tyhld のどこでも止めていた。ところが Bash は hooks と bin の下しか
+  止めず、~/.tyhld の直下（kc の実体・ブラウザの道具・控え・notify の置き場）は職人の
+  touch・rm・リダイレクト・cp・mv・sed -i から書けた。
+  実測（直す前）: `touch ~/.tyhld/kc.sh` → allow / `touch ~/.tyhld/hooks/x` → deny
+  ＝道具によって結果が違う穴。
+
+【ここで固定すること】
+  (A) ★~/.tyhld の【どこへ】【どの書き方で】書こうとしても止まる（直下もぜんぶ）
+  (B) 前から止まっていた hooks・bin の下は1件も通らない（守りを弱めない）
+  (C) 読むのは今までどおり通る（cat・grep・ls・jq・cp で外へ写す）
+  (D) 使い捨ての作業場（/tmp の下）に作った同じ名前は止めない
+  (E) Write・Edit も今までどおり止まる（道具をまたいで結果が同じ）
+  (F) ★守る場所の一覧に ~/.tyhld が入っている（hooks・bin の2行も残っている＝OR で広がる）
+
+★空振り確認：policy.GUARD_PLACES から ('home-tree', '.tyhld') を外すと (A) の直下の件が落ちる。
+"""
+import os
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+import policy  # noqa: E402
+
+failures = []
+
+
+def check(label, got, want):
+    ok = got == want
+    if not ok:
+        failures.append(f'{label}: got={got!r} want={want!r}')
+    print(f'{"OK " if ok else "NG "} {label:72} {str(got)[:40]}')
+
+
+def bash(cmd):
+    return policy.decide_bash(cmd)['decision']
+
+
+HOME = os.path.expanduser('~')
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('=== (F) 守る場所の一覧 ===')
+# ─────────────────────────────────────────────────────────────────────────────
+_home_trees = tuple(p for k, p in policy.GUARD_PLACES if k == 'home-tree')
+check('一覧に .tyhld まるごとが入っている', '.tyhld' in _home_trees, True)
+check('★hooks の行は消していない（弱めない）', '.tyhld/hooks' in _home_trees, True)
+check('★bin の行は消していない（弱めない）', '.tyhld/bin' in _home_trees, True)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (A) ~/.tyhld の直下への書き込みは、どの書き方でも止まる ===')
+# ─────────────────────────────────────────────────────────────────────────────
+#: 直下の実在の物（kc の実体・ブラウザの道具・控え・notify の置き場）。
+DIRECT = [
+    'touch ~/.tyhld/kc.sh',
+    'touch $HOME/.tyhld/kc.sh',
+    'touch ${HOME}/.tyhld/kc.sh',
+    f'touch {HOME}/.tyhld/kc.sh',
+    'rm -f ~/.tyhld/kc.sh',
+    'rm -rf ~/.tyhld',
+    'echo x > ~/.tyhld/kc.sh',
+    'echo x >> ~/.tyhld/kc.sh',
+    'printf x > $HOME/.tyhld/kc.sh',
+    'tee ~/.tyhld/kc.sh',
+    'cp /tmp/claude-1000/a ~/.tyhld/kc.sh',
+    'cp -r /tmp/claude-1000/d ~/.tyhld/',
+    'mv /tmp/claude-1000/a ~/.tyhld/kc.sh',
+    'mv ~/.tyhld /tmp/claude-1000/moved',
+    'sed -i s/a/b/ ~/.tyhld/kc.sh',
+    'chmod 777 ~/.tyhld/kc.sh',
+    'ln -s /tmp/claude-1000/a ~/.tyhld/kc.sh',
+    'install -m 755 /tmp/claude-1000/a ~/.tyhld/kc.sh',
+    'truncate -s 0 ~/.tyhld/kc.sh',
+    'tar -xzf /tmp/claude-1000/a.tgz -C ~/.tyhld',
+    'unzip /tmp/claude-1000/a.zip -d ~/.tyhld',
+    'curl -o ~/.tyhld/kc.sh https://example.invalid/x',
+    'wget -O ~/.tyhld/kc.sh https://example.invalid/x',
+    'touch ~/.tyhld/pw-venv/x',
+    'touch ~/.tyhld/pw-browsers/x',
+    'touch ~/.tyhld/skill-backups/x',
+    'touch ~/.tyhld/codex-notify/x',
+    'touch ~/.tyhld/hookset/x',
+    'bash -c "touch ~/.tyhld/kc.sh"',
+    'env X=1 touch ~/.tyhld/kc.sh',
+    'nohup touch ~/.tyhld/kc.sh',
+    '( touch ~/.tyhld/kc.sh )',
+    'echo ok; touch ~/.tyhld/kc.sh',
+    'D=~/.tyhld; touch $D/kc.sh',
+    'xargs touch ~/.tyhld/kc.sh',
+    'find ~/.tyhld -type f -exec rm -f {} +',
+    'python3 -c "import pathlib; (pathlib.Path.home() / \'.tyhld\' / \'kc.sh\').write_text(\'x\')"',
+    # ★この機体の本物のホームで書く（CI の機体では HOME が違うので、字面を焼き付けない）。
+    f'python3 -c "open(\'{HOME}/.tyhld/kc.sh\', \'w\').write(\'x\')"',
+    'node -e "require(\'fs\').writeFileSync(process.env.HOME + \'/.tyhld/kc.sh\', \'x\')"',
+]
+for c in DIRECT:
+    check(c, bash(c), policy.DENY)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (B) 前から止まっていた hooks・bin の下は1件も通らない ===')
+# ─────────────────────────────────────────────────────────────────────────────
+OLD = [
+    'touch ~/.tyhld/hooks/x',
+    'touch ~/.tyhld/bin/x',
+    'echo x > ~/.tyhld/hooks/cc2_guard.py',
+    'cp /tmp/claude-1000/a ~/.tyhld/bin/conductor-run',
+    'rm -rf ~/.tyhld/hooks',
+    'rm -f ~/.tyhld/bin/autoupdate/drain',
+    'touch ~/.tyhld/bin/autoupdate/enabled',
+    'sed -i s/a/b/ ~/.tyhld/hooks/policy.py',
+]
+for c in OLD:
+    check(c, bash(c), policy.DENY)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (C) 読むのは今までどおり通る ===')
+# ─────────────────────────────────────────────────────────────────────────────
+READS = [
+    'cat ~/.tyhld/kc.sh',
+    'ls -la ~/.tyhld',
+    'ls ~/.tyhld/bin',
+    'grep -n conductor ~/.tyhld/kc.sh',
+    'head -5 ~/.tyhld/bin/conductor-run',
+    'diff ~/.tyhld/kc.sh scripts/kc.sh',
+    'cp ~/.tyhld/kc.sh /tmp/claude-1000/copy.sh',
+    'wc -l ~/.tyhld/kc.sh',
+]
+for c in READS:
+    check(c, bash(c), policy.ALLOW)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (D) 使い捨ての作業場の同じ名前は止めない ===')
+# ─────────────────────────────────────────────────────────────────────────────
+for c in [
+    'touch /tmp/claude-1000/.tyhld/x',
+    'echo x > /tmp/claude-1000/sagyou/.tyhld/kc.sh',
+]:
+    check(c, bash(c), policy.ALLOW)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (E) Write・Edit も今までどおり止まる（道具をまたいで同じ結果） ===')
+# ─────────────────────────────────────────────────────────────────────────────
+for p in [
+    f'{HOME}/.tyhld/kc.sh',
+    f'{HOME}/.tyhld/hooks/policy.py',
+    f'{HOME}/.tyhld/bin/conductor-run',
+    f'{HOME}/.tyhld/codex-notify/x',
+]:
+    check(f'decide_write {p}', policy.decide_write(p)['decision'], policy.DENY)
+    for tool in ('Write', 'Edit', 'MultiEdit', 'NotebookEdit'):
+        d = policy.decide_event({'tool_name': tool, 'tool_input': {'file_path': p}})
+        check(f'{tool} {p}', d['decision'], policy.DENY)
+
+print('\n' + '=' * 72)
+if failures:
+    print(f'NG {len(failures)} 件')
+    for f in failures:
+        print('  ' + f)
+    sys.exit(1)
+print('すべて期待どおり')

package/scripts/update-guard.sh

@@ -436,6 +436,7 @@ INSTALL_FILES=(
   policy.py                   # cc2_guard / permission_request_hook が使う判定本体
   summary_ja.py               # permission_request_hook / stop_hook が使う日本語の文言
   hook_datalink.py            # 各フックが使う管制との連絡線
+  finish_gate.py              # stop_hook が使う「便の終わりの関門」の判定（便 7aa63a97）
 )
 INSTALL_CONFIGS=(safe_verbs.json network_allow.json)
 ENTRYPOINTS=(cc2_guard.py permission_request_hook.py stop_hook.py notification_hook.py)

package/skills/conductor-craftsman/SKILL.md

@@ -169,6 +169,12 @@ description: 采配くんの便（プロンプト末尾に CONDUCTOR_JOB:<id>
 
 便の最後には、配達役が付けた1行「【便の終え方】…報告の置き場: ～／最終行: DONE:<現場> とだけ出力／完了の知らせ: conductor_complete を commandId="<指示ID>" で1回だけ」と、管理用ジョブ印 `CONDUCTOR_JOB:<指示ID>` がある。作業がすべて終わったら、この節のとおりに次の順で終える（便 a5306df2：以前は便ごとに付いていた全文を、ここへ寄せた）。
 
+⓪ **★報告を書く前に、「反映された」を実物で確かめる**（えふさん確定 2026-10-02 夜・便 7aa63a97）。**報告到着 ≠ 完了／職人終了 ≠ 受入完了。** 職人への指示は反映（合流・公開・本番反映）まで終わらせる。次の3つを、**自分の言葉ではなく実物の出力で**確かめてから①へ進む。
+   - **(a) 合流したか** … 鉄則7-★の確かめ方（`gh pr view <番号> --json state,baseRefName,mergeCommit` が `MERGED` ＋ `git merge-base --is-ancestor <合流コミット> origin/<合流先>`）。★**合流を予約しただけ（`--auto`）は「終わり」ではない。** 予約は GitHub が後から合流するので、**予約したまま手番を閉じると便が死ぬ**（実地 47bdfe00）。鉄則7-★の4段の塊を使えば ④ が最後まで待つ。
+   - **(b) 公開版／本番が新しくなったか** … 配布物を変えた便なら `npm view <パッケージ> version` が上げた版になっていること。画面を変えた便なら配備先の版。★**変えていない便は「変えていない」と確かめる**（確かめを省くのではない）。
+   - **(c) 背景に回した待ちが残っていないか** … ★**待ちを背景に残したまま手番を閉じない。** 画面なし方式（`claude -p`）では**手番の終わり＝処理の終わり**で、背景の待ちはその瞬間に殺され、職人は二度と起きない（実地 915694ac：「まだ実行中です。終わり次第、結果を確かめます。」で手番を閉じ、報告は下書きのまま便が死んだ）。待つなら `Monitor` か `until <条件>; do sleep 2; done` で、**この手番の中で待ち切る**。
+   - ★(a)(b)(c) のどれかが終わらせられないときは、**終わったふりをしない**。報告の `outcome` を `blocked` にして、どこまで進んだか・何が残っているか・なぜ進められないかを書いて終える（それが正しい終わり方）。
+   - ★ここを飛ばすと、**便の終わりの関門**（Stop フックの `finish_gate.py`）が実物を見て手番を閉じさせない（PR が開いたまま・報告が下書きのまま・背景の待ちが残っている のどれかなら差し戻す）。同じ理由で止まるのは回数の上限つきなので、**止められたら回避せず、残りを終わらせる**。
 ① **報告をファイルに書く。** 置き場は配達役の1行が指すファイル**だけ**（正本は `~/.local/state/conductor/reports/<指示ID>.md`）。★便の本文に別の置き場（`/tmp` など）が書かれていても、**配達役の1行の置き場を正とする**（置き場は1か所）。フォルダが無ければ作る。長さの制限は無い。画面に出す必要は無い。中身は変更ファイル・要点・チェック結果を簡潔に。
 ② **ファイルの先頭（1行目から）に、次の囲みを付ける**（管制が機械で読む口）。
    ```
@@ -182,6 +188,7 @@ description: 采配くんの便（プロンプト末尾に CONDUCTOR_JOB:<id>
    ---
    ```
    この囲みの下に、いつもどおりの報告本文を書く（本文が空だと未完成と見なされる）。
+   - ★**置いた瞬間から「報告が届いた」と数えられる。下書きを置かない。** 実地 915694ac では「報告（作成中）この見出しは最終版で差し替える」だけの下書きを置いたまま便が死に、管制では「終わりました・✅」になった（合流も公開もしていなかった）。**途中の控えを正本の置き場に置かない**（途中で書き留めたいものは `/tmp/claude-1000/` に置く＝鉄則13）。関門も「作成中」「差し替える」「下書き」「あとで書く」「TODO」「TBD」が本文に残っていれば下書きとして差し戻す。
 ③ **その後の最終行に、配達役の1行にある `DONE:<現場>` とだけ出力する**（完了の合図）。
 ④ **ai-kana の MCP ツール `conductor_complete` を、配達役の1行にある commandId で1回だけ呼ぶ**（relay に依存しない確実な完了通知）。report 引数に上の報告本文を添えてもよい。
    - **nextWork（次の独立作業候補）は必ず書く。** 無ければ「なし」と、なぜ無いかの理由を書く。