@tyhld/conductor 0.12.109 → 0.12.110

package/dist/relay.js

@@ -1705,7 +1705,16 @@ export function pickCodexNoticeFor(site, job, env = process.env) {
     for (const n of all) {
         const v = judgeCodexNotice(n, job);
         if (v.accept) {
-            notice = n; // 2件以上あれば新しい方を使う（古い順に見ている）
+            // ★その便の物が2件以上あれば【新しい方】を使う（古い順に見ている）。
+            //   同じターンで notify と Stop の両方が書くと、この形になる（便 ab910bc6）。
+            //   使わなかった方も【理由つきで控えへ】残す（＝黙って落とさない。完了は1回・本文は1つ）。
+            if (notice !== null) {
+                skipped.push({
+                    notice,
+                    why: '同じ便の知らせが複数届いた（notify と Stop の両方など）ので、新しい方を本文に使った',
+                });
+            }
+            notice = n;
         }
         else {
             skipped.push({ notice: n, why: v.why });

package/package.json

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

package/scripts/codex/codex-notify.py

@@ -59,14 +59,35 @@
     ④ それも分からなければ作業フォルダの名前（今までどおり）。
   ★どれでも決められない知らせは【捨てない】。理由つきで控え（UNRESOLVED_FILE）へ残す。
 
-【★呼ばれた事を1行だけ残す（2026-10-06・便 36236d41）】
+【★この受け口は「2つの道」の共通の部品でもある（2026-10-06・便 ab910bc6）】
+  Codex には終わりの知らせの登録が【2つ独立して】在る（ADR-022 の実測）。
+    ・notify（`~/.codex/config.toml` の `notify`）… この受け口を引数1個で呼ぶ
+    ・Stop  （`~/.codex/hooks.json` の `Stop`）  … `stop_hook.py` を標準入力で呼ぶ。
+      ★渡ってくる物に `last_assistant_message`（notify と同じ「最後の返事」）が入る。
+  登録先が別のファイルなので、片方が黙っても、もう片方で本文を拾える（実物: codex-probe の
+  Codex は 10/5 15:01 から notify を出していない＝報告の本文が管制に載らない）。
+  そこで `stop_hook.py` が、この受け口と【同じ1行】を【同じ受け皿】へ書けるようにした。
+  ★決まりを2か所に書かない: 現場の決め方（resolve_site）・内部のターンの見分け（is_internal_turn）・
+    1行の形（notice_line）・控えへの回し方（keep_unresolved）・呼ばれた記録（record_call）は、
+    どちらの道も【この1つのファイルの同じ関数】を通る（入口は handle_turn の1つだけ）。
+  ★`stop_hook.py` はこのファイルを【同じフォルダから読み込む】。配り方を変えなくてよい:
+    update-guard.sh ① が stop_hook.py を、その中の ①-e2（install-codex-hooks.sh）が
+    この受け口を、どちらも同じ固定パス（$GUARD_HOME）へ置くため（1時間ごとの同期でも走る）。
+  ★読み込めない機体では、Stop の道は【何もしない】（＝番人の今までの動きだけが残る）。
+
+【★呼ばれた事を1行だけ残す（2026-10-06・便 36236d41／便 ab910bc6 で2つ足した）】
   調査 f567f8d8 で分かったいちばん痛い所は、「受け口が呼ばれたが黙って終わった」と
   「受け口が一度も呼ばれていない」を、実物で分けられないことだった（受け口は自分の動いた
   記録を1行も残していなかった）。だから Codex が知らせを出していないのか、受け口が
   捨てているのかを、人が確かめる材料が無かった。
   そこで、呼ばれるたびに受け皿の置き場の中の1つのファイル（CALLS_FILE）へ1行だけ足す。
-    ・時刻／type／どう扱ったか（CALL_HOW_*）／現場名／便の印が在ったか／本文の字数
-  ★本文・指示文・作業フォルダより下の中身は【1文字も書かない】（字数と有無だけ）。
+    ・時刻／type／どう扱ったか（CALL_HOW_*）／現場名／便の印の頭8文字／本文の字数／
+      ★どの道から来たか（route＝notify／stop・便 ab910bc6）
+  ★便の印は【頭8文字だけ】を書く（便 ab910bc6。それまでは有無だけだった）。
+    ＝`grep <便IDの頭8文字> ~/.tyhld/codex-notify/_calls.log` の1回で、
+      「Codex が受け口を呼んだか」「Stop フックを呼んだか」が両方分かる。
+    印は秘密ではない（配り役の記録にも管制の画面にも毎回出ている値）。印が無ければ空。
+  ★本文・指示文・作業フォルダより下の中身は【1文字も書かない】（字数と頭8文字だけ）。
   ★名前は `_calls.log`＝配り役は受け皿（`<現場>.jsonl`）として読まないし、
     読まれない受け皿の始末（relay.ts の sweepStrayCodexNotices）の対象にもならない。
   ★行数に上限（CALLS_MAX_LINES）を付け、古い物から落とす。
@@ -119,6 +140,16 @@ CALLS_FILE = '_calls.log'
 # 記録に残す行数の上限（古い物から落とす）。
 CALLS_MAX_LINES = 500
 
+# 便の印を記録に書くときの長さ（★頭だけ・全部は書かない）。
+#   8文字＝管制の画面・配り役の記録・報告のファイル名で人が使っている長さと同じ。
+JOB_STAMP_HEAD = 8
+
+# どの道から来たか（★この2通りだけ）。
+#   notify … Codex の `notify`（config.toml）がこの受け口を直接呼んだ
+#   stop   … Codex の `Stop`（hooks.json）が stop_hook.py を呼び、そこから来た
+ROUTE_NOTIFY = 'notify'
+ROUTE_STOP = 'stop'
+
 # どう扱ったか（★この5通りだけ）。
 CALL_HOW_TRAY = 'tray'                      # 受け皿へ書いた
 CALL_HOW_INTERNAL = 'internal-turn'         # Codex 内部のターンなので捨てた
@@ -304,8 +335,20 @@ def decide(payload, env=None):
     return True, site, report, how
 
 
-def notice_line(payload, site, report):
-    """受け皿へ書く1行。"""
+def job_stamp_head(job_id):
+    """便の印の頭8文字（★記録に書く用）。印が無ければ ''。"""
+    return str(job_id or '')[:JOB_STAMP_HEAD]
+
+
+def notice_line(payload, site, report, job_id=None, route=ROUTE_NOTIFY):
+    """受け皿へ書く1行。
+
+    ★`route` は「どの道から来たか」。配り役は知らない欄を落として読むので
+      （relay.ts の takeCodexNotices は site / report / threadId / turnId / jobId / at だけを見る）、
+      この欄が在っても今までどおり読まれる・控えへも回らない（試験で固定）。
+    ★`job_id` を渡せば、その値を便の印として書く（Stop の道は指示本文を持っていないので、
+      会話の記録から拾った印を渡す）。渡さなければ今までどおり指示本文から読む。
+    """
     return json.dumps(
         {
             'site': site,
@@ -313,14 +356,16 @@ def notice_line(payload, site, report):
             'threadId': payload.get('thread-id'),
             'turnId': payload.get('turn-id'),
             # ★どの便のターンの知らせかを配り役が確かめられるようにする（便 99fc49c0）。
-            'jobId': job_id_of(payload),
+            'jobId': job_id if job_id else job_id_of(payload),
             'at': datetime.datetime.now(datetime.timezone.utc).isoformat(),
+            # ★どの道から来たか（便 ab910bc6）。配り役の判定には使わない（人が追う用）。
+            'route': route,
         },
         ensure_ascii=False,
     )
 
 
-def keep_unresolved(payload, report, why, env=None):
+def keep_unresolved(payload, report, why, env=None, job_id=None, route=ROUTE_NOTIFY):
     """現場を決められなかった知らせを、理由つきで控えへ残す（★捨てない）。
 
     返り: 書けた控えのパス／''。古い行から落として UNRESOLVED_MAX_LINES 行までに収める。
@@ -335,10 +380,11 @@ def keep_unresolved(payload, report, why, env=None):
             'why': why,
             'site': None,
             'cwd': payload.get('cwd'),
-            'jobId': job_id_of(payload),
+            'jobId': job_id if job_id else job_id_of(payload),
             'threadId': payload.get('thread-id'),
             'turnId': payload.get('turn-id'),
             'report': report,
+            'route': route,
         },
         ensure_ascii=False,
     )
@@ -356,20 +402,23 @@ def keep_unresolved(payload, report, why, env=None):
         return ''
 
 
-def call_line(how, why, payload=None, site='', report=''):
+def call_line(how, why, payload=None, site='', report='', job_id=None, route=ROUTE_NOTIFY):
     """「呼ばれた事」の1行（★本文・指示文・作業フォルダは1文字も入れない）。"""
     raw_type = ''
     if isinstance(payload, dict):
         raw_type = TYPE_OK.sub('', str(payload.get('type') or ''))[:40]
+    stamp = job_id if job_id else (job_id_of(payload) if isinstance(payload, dict) else None)
     return json.dumps(
         {
             'at': datetime.datetime.now(datetime.timezone.utc).isoformat(),
             'type': raw_type,
+            # ★どの道から来たか（notify／stop・便 ab910bc6）。
+            'route': route,
             'how': how,
             'why': why,
             'site': site or None,
-            # ★印そのものは書かない（有無だけ）。
-            'jobStamp': job_id_of(payload) is not None if isinstance(payload, dict) else False,
+            # ★印は頭8文字だけ（便 ab910bc6。それまでは有無だけだった）。無ければ ''。
+            'jobStamp': job_stamp_head(stamp),
             # ★本文は書かない（字数だけ）。
             'reportChars': len(report or ''),
         },
@@ -377,7 +426,8 @@ def call_line(how, why, payload=None, site='', report=''):
     )
 
 
-def record_call(how, why, payload=None, site='', report='', env=None):
+def record_call(how, why, payload=None, site='', report='', env=None, job_id=None,
+                route=ROUTE_NOTIFY):
     """呼ばれた事を記録に1行足す。返り: 書けたファイル／''。
 
     ★ここで何が起きても例外を外に出さない・終了コードを変えない（Codex を止めない）。
@@ -388,7 +438,7 @@ def record_call(how, why, payload=None, site='', report='', env=None):
         if not target_dir:
             return ''
         file = os.path.join(target_dir, CALLS_FILE)
-        line = call_line(how, why, payload, site, report)
+        line = call_line(how, why, payload, site, report, job_id=job_id, route=route)
         os.makedirs(target_dir, exist_ok=True)
         kept = []
         if os.path.exists(file):
@@ -402,49 +452,109 @@ def record_call(how, why, payload=None, site='', report='', env=None):
         return ''
 
 
-def main(argv):
-    raw = ' '.join(argv[1:]).strip()
-    if not raw:
-        record_call(CALL_HOW_BAD_ARGS, 'no-args')
-        return 0
-    try:
-        payload = json.loads(raw)
-    except Exception:  # noqa: BLE001
-        record_call(CALL_HOW_BAD_ARGS, 'not-json')
-        return 0  # 読めない通知は黙って捨てる（Codex を止めない）
-    keep, site, report, reason = decide(payload)
+def handle_turn(payload, route=ROUTE_NOTIFY, job_id=None, env=None):
+    """知らせ1件を、受け皿／控え／記録へ振り分ける（★notify と Stop の共通の入口）。
+
+    返り: (どう扱ったか CALL_HOW_*, 理由, 現場名)。★例外を外に出さない所は record_call だけで、
+    ここは呼ぶ側（main／stop_hook）が今までどおり握る（どちらも職人を止めない）。
+
+    ★`route` と `job_id` 以外は、notify の道と1行も違わない処理を通る（決まりを2か所に書かない）。
+    """
+    keep, site, report, reason = decide(payload, env)
     if not keep:
         # ★現場を決められなかった知らせだけは、捨てずに控えへ残す（便 684ac785）。
         if reason.startswith('unresolved-site:'):
-            wrote = keep_unresolved(payload, report, reason[len('unresolved-site:'):])
-            record_call(
-                CALL_HOW_UNRESOLVED if wrote else CALL_HOW_WRITE_FAILED,
-                reason if wrote else 'unresolved-unwritable',
-                payload,
-                report=report,
+            wrote = keep_unresolved(
+                payload, report, reason[len('unresolved-site:'):], env,
+                job_id=job_id, route=route,
             )
-            return 0
-        record_call(
-            CALL_HOW_INTERNAL if reason == 'internal-turn' else CALL_HOW_BAD_ARGS,
-            reason,
-            payload,
-            report=report,
-        )
-        return 0
-    target_dir = notify_dir()
+            how = CALL_HOW_UNRESOLVED if wrote else CALL_HOW_WRITE_FAILED
+            why = reason if wrote else 'unresolved-unwritable'
+            record_call(how, why, payload, report=report, env=env, job_id=job_id, route=route)
+            return how, why, ''
+        how = CALL_HOW_INTERNAL if reason == 'internal-turn' else CALL_HOW_BAD_ARGS
+        record_call(how, reason, payload, report=report, env=env, job_id=job_id, route=route)
+        return how, reason, ''
+    target_dir = notify_dir(env)
     if not target_dir:
-        record_call(CALL_HOW_WRITE_FAILED, 'no-notify-dir', payload, site, report)
-        return 0
+        record_call(CALL_HOW_WRITE_FAILED, 'no-notify-dir', payload, site, report,
+                    env=env, job_id=job_id, route=route)
+        return CALL_HOW_WRITE_FAILED, 'no-notify-dir', site
     try:
         os.makedirs(target_dir, exist_ok=True)
         with open(os.path.join(target_dir, f'{site}.jsonl'), 'a', encoding='utf-8') as f:
-            f.write(notice_line(payload, site, report) + '\n')
+            f.write(notice_line(payload, site, report, job_id=job_id, route=route) + '\n')
     except Exception:  # noqa: BLE001
         # ★知らせの本体を書けなかった事も記録に残す（「呼ばれていない」と区別できるようにする）。
-        record_call(CALL_HOW_WRITE_FAILED, 'tray-write-error', payload, site, report)
-        return 0
+        record_call(CALL_HOW_WRITE_FAILED, 'tray-write-error', payload, site, report,
+                    env=env, job_id=job_id, route=route)
+        return CALL_HOW_WRITE_FAILED, 'tray-write-error', site
     # ★記録は本体を書いた【後】に足す（記録が書けなくても本体は残る）。
-    record_call(CALL_HOW_TRAY, reason, payload, site, report)
+    record_call(CALL_HOW_TRAY, reason, payload, site, report,
+                env=env, job_id=job_id, route=route)
+    return CALL_HOW_TRAY, reason, site
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# ★第2の道（Codex の `Stop` フック）— 便 ab910bc6
+#   stop_hook.py はこの2つだけを使う（判断も1行の形も、上の notify の道と同じ関数を通る）。
+# ─────────────────────────────────────────────────────────────────────────────
+
+# Codex の `Stop` だけが渡してくる項目（ADR-022 の実測表）。
+#   Claude Code の `Stop` に入るのは last_assistant_message / transcript_path / session_id /
+#   cwd / stop_hook_active / permission_mode の6つで、turn_id は【入らない】（ADR-024 の実測）。
+#   ＝この項目が在ることは「Codex から呼ばれた」の印になる。
+CODEX_STOP_ONLY_KEY = 'turn_id'
+
+
+def called_by_codex(data, env=None):
+    """この `Stop` は Codex から呼ばれたか。★Claude のときは必ず False（1バイトも変えない）。
+
+    上から順に見る。
+      ① 職人の種類の印（CONDUCTOR_AGENT_KIND）が codex … Codex
+      ② 印が在って codex 以外（claude など）  … ★Codex ではない（絶対に書かない）
+      ③ 印が無い機体 … Codex だけが渡す項目（turn_id）が在れば Codex
+    """
+    env = os.environ if env is None else env
+    kind = (env.get('CONDUCTOR_AGENT_KIND') or '').strip().lower()
+    if kind == 'codex':
+        return True
+    if kind:
+        return False
+    if not isinstance(data, dict):
+        return False
+    return str(data.get(CODEX_STOP_ONLY_KEY) or '').strip() != ''
+
+
+def stop_payload(data):
+    """`Stop` フックに渡る形（下線の項目名）を、notify と同じ形（ハイフンの項目名）へ移す。
+
+    ★中身は1つも作らない（在る物を移すだけ）。指示本文（input-messages）は `Stop` には
+      入らないので入れない＝現場は登録簿か git の頂上で決まり（resolve_site の ②③④）、
+      便の印は呼ぶ側が会話の記録から拾って渡す（job_id）。
+    """
+    data = data if isinstance(data, dict) else {}
+    last = data.get('last_assistant_message')
+    return {
+        'type': 'agent-turn-complete',
+        'cwd': data.get('cwd'),
+        'last-assistant-message': last if isinstance(last, str) else '',
+        'thread-id': data.get('session_id'),
+        'turn-id': data.get('turn_id'),
+    }
+
+
+def main(argv):
+    raw = ' '.join(argv[1:]).strip()
+    if not raw:
+        record_call(CALL_HOW_BAD_ARGS, 'no-args')
+        return 0
+    try:
+        payload = json.loads(raw)
+    except Exception:  # noqa: BLE001
+        record_call(CALL_HOW_BAD_ARGS, 'not-json')
+        return 0  # 読めない通知は黙って捨てる（Codex を止めない）
+    handle_turn(payload, route=ROUTE_NOTIFY)
     return 0
 
 

package/scripts/hooks/stop_hook.py

@@ -15,6 +15,21 @@
      見るのは PR・報告ファイル・背景に回した待ちの3つだけで、職人の言葉は読まない。
      判定と回数の上限は finish_gate.py にある（そこの説明文に実地の3件と理由を書いた）。
 
+  ③ ★報告の「第2の道」（便 ab910bc6 で足した・★Codex から呼ばれた時だけ）…
+     Codex の終わりの知らせには【2つ独立した登録】が在る（ADR-022 の実測）。
+       ・notify（`~/.codex/config.toml`）… 受け口 codex-notify.py を呼ぶ
+       ・Stop  （`~/.codex/hooks.json`） … このフックを呼ぶ。渡ってくる物に
+         `last_assistant_message`（notify と同じ「最後の返事」）が入る
+     実物: codex-probe の Codex は 10/5 15:01 から notify を出していない＝報告の本文が
+     管制に載らない（便 36236d41 の調べ）。登録先が別ファイルなので、片方が黙っても
+     もう片方で本文を拾える。そこで、このフックから【受け口と同じ1行】を【同じ受け皿】へ書く。
+     ★決まりを2か所に書かない: 現場の決め方・内部のターンの見分け・1行の形・控えへの回し方・
+       呼ばれた記録は、すべて受け口（codex-notify.py）の関数をそのまま呼ぶ。
+     ★Claude の現場では1バイトも変わらない（called_by_codex が False＝何もしない）。
+     ★①②の仕事（確認カード・終わりの関門）は、順番も結果も終了コードも変えない。
+       受け皿へ書けなくても、今までどおり①②を終える（例外は握って捨てる）。
+     ★関門が差し戻す手番では書かない（手番がまだ終わっていないので、完了の材料にしない）。
+
 【★カードを出す条件は2つ（両方満たしたときだけ出す）】
   (1) 紐づく指示がまだ終わっていないこと
       ・待ち時間では判定しない（60秒待つ等は「遅い返事」と区別できない）。
@@ -40,6 +55,7 @@
 
 【接続先が未設定の環境】何もせず終了する（このフックを入れても壊れない）。
 """
+import importlib.util
 import json
 import os
 import re
@@ -353,6 +369,79 @@ def run(data, cfg=None, datalink=hook_datalink):
     return request_id
 
 
+# ─────────────────────────────────────────────────────────────────────────────
+# ★報告の「第2の道」（Codex から呼ばれた時だけ・便 ab910bc6）
+#
+# 受け口（scripts/codex/codex-notify.py）を【そのまま読み込んで】使う。新しい部品を作らない。
+#   ・決まりが1か所に留まる（現場の決め方・内部のターンの見分け・1行の形・控え・記録）
+#   ・★配り方を1行も変えなくてよい … update-guard.sh ① がこのフックを、その中の ①-e2
+#     （install-codex-hooks.sh）が受け口を、どちらも同じ固定パス（$GUARD_HOME）へ置く。
+#     ＝稼働機では2つが同じフォルダに並ぶので、ここから名前で読める（1時間ごとの同期で届く）。
+#   ・リポジトリの中では隣（../codex/）に在るので、そちらも見る（試験と手元の確認用）。
+#   ・★読めない機体では【何もしない】（番人の今までの動きだけが残る＝退行しない）。
+# ─────────────────────────────────────────────────────────────────────────────
+CODEX_NOTIFY_BASENAME = 'codex-notify.py'
+
+
+def codex_notify_paths(env=None):
+    """受け口を探す場所（上から順）。
+
+    ★名指し（CONDUCTOR_CODEX_NOTIFY_PY）が在れば【それだけ】を見る（試験・特別な置き方）。
+      名指しが外れているのに別の場所へ回ると、どの受け口を使ったか分からなくなる。
+    """
+    env = os.environ if env is None else env
+    here = os.path.dirname(os.path.abspath(__file__))
+    explicit = (env.get('CONDUCTOR_CODEX_NOTIFY_PY') or '').strip()
+    if explicit:
+        return [explicit]
+    return [
+        os.path.join(here, CODEX_NOTIFY_BASENAME),                  # 稼働機（$GUARD_HOME に並ぶ）
+        os.path.join(here, os.pardir, 'codex', CODEX_NOTIFY_BASENAME),  # リポジトリの中
+    ]
+
+
+def load_codex_notify(env=None):
+    """受け口を読み込む。読めなければ None（★第2の道は黙って何もしない）。"""
+    for path in codex_notify_paths(env):
+        if not os.path.isfile(path):
+            continue
+        try:
+            spec = importlib.util.spec_from_file_location('conductor_codex_notify', path)
+            if spec is None or spec.loader is None:
+                continue
+            mod = importlib.util.module_from_spec(spec)
+            spec.loader.exec_module(mod)
+        except Exception:  # noqa: BLE001
+            continue
+        if hasattr(mod, 'handle_turn') and hasattr(mod, 'called_by_codex'):
+            return mod
+    return None
+
+
+def write_codex_turn_notice(data, env=None):
+    """Codex から呼ばれた手番の終わりを、受け口と同じ1行で受け皿へ書く。
+
+    返り: (どう扱ったか, 理由, 現場名)／None（Codex ではない・受け口が読めない・失敗した）。
+    ★ここで何が起きても例外を外に出さない・このフックの他の仕事と終了コードを変えない。
+    """
+    env = os.environ if env is None else env
+    try:
+        if not isinstance(data, dict):
+            return None
+        notify = load_codex_notify(env)
+        if notify is None or not notify.called_by_codex(data, env):
+            return None
+        return notify.handle_turn(
+            notify.stop_payload(data),
+            route=notify.ROUTE_STOP,
+            # ★便の印は、このフックが前から持っている拾い方（会話の記録の最後の印）で渡す。
+            job_id=find_command_id(data.get('transcript_path')),
+            env=env,
+        )
+    except Exception:  # noqa: BLE001
+        return None
+
+
 def main() -> int:
     try:
         raw = sys.stdin.read()
@@ -365,6 +454,9 @@ def main() -> int:
     message = data.get('last_assistant_message')
     asks_human = isinstance(message, str) and needs_human_answer(message)
     if asks_human:
+        # ③ ★Codex から呼ばれた時だけ、受け口と同じ1行を受け皿へ書く（notify と同じ間合い）。
+        #    ★失敗しても下の確認カードは今までどおり出す（返り値を見ない）。
+        write_codex_turn_notice(data)
         try:
             run(data)
         except Exception:  # noqa: BLE001
@@ -378,9 +470,12 @@ def main() -> int:
     except Exception:  # noqa: BLE001
         reason = None
     if reason:
+        # ★差し戻す手番では受け皿へ書かない（手番はまだ終わっていない＝完了の材料にしない）。
         print(json.dumps({'decision': 'block', 'reason': reason}, ensure_ascii=False))
         return 0
 
+    # ③ ★Codex から呼ばれた時だけ、受け口と同じ1行を受け皿へ書く。
+    write_codex_turn_notice(data)
     try:
         run(data)
     except Exception:  # noqa: BLE001

package/scripts/hooks/test_stop_codex_route.py

@@ -0,0 +1,331 @@
+#!/usr/bin/env python3
+"""報告の「第2の道」（Codex の `Stop` フック）の検査（便 ab910bc6）。
+
+  実行: python3 scripts/hooks/test_stop_codex_route.py
+  1件でも期待と違えば exit 1。
+
+【何を良くしたか】Codex の終わりの知らせには【2つ独立した登録】が在る（ADR-022 の実測）。
+  ・notify（`~/.codex/config.toml`）… 受け口 codex-notify.py を呼ぶ
+  ・Stop  （`~/.codex/hooks.json`） … stop_hook.py を呼ぶ。渡ってくる物に
+    `last_assistant_message`（notify と同じ「最後の返事」）が入る
+  実物（便 36236d41 の調べ）: codex-probe の Codex は 2026-10-05 15:01 から notify を
+  出していない＝報告の本文が管制に載らない。登録先が別ファイルなので、片方が黙っても
+  もう片方で本文を拾える。そこで Stop から【受け口と同じ1行】を【同じ受け皿】へ書く。
+
+【ここで固定すること】
+  (A) 道の見分け … 実測の Codex の Stop は書く／★実測の Claude の Stop は1行も書かない
+  (B) Codex からの Stop … 受け皿に受け口と同じ形の1行（便の印・現場・本文・道）が入る。
+      欄の集合が notify の1行と【同じ】である（決まりを2か所に書いていない証拠）
+  (C) 内部のターンでは書かない／現場を決められない時は控えへ
+  (D) ★受け皿へ書けなくても、いまの仕事（確認カード・終わりの関門）の結果と終了コードが変わらない
+  (E) 呼ばれた記録 … 道（stop）と便の印の頭8文字が入る／印が無ければ空／本文は入らない
+  (F) ★関門が差し戻す手番では書かない（手番はまだ終わっていない）
+  (G) ★受け口が読めない機体では何もしない（番人の今までの動きだけが残る）
+
+★空振り確認（使い捨ての複製の中だけ）:
+  ・stop_hook.main から write_codex_turn_notice の呼び出しを外す → (B)(E) が落ちる
+  ・called_by_codex を常に True にする → (A) の「Claude では書かない」が落ちる
+  ・main の差し戻しの前に書くように動かす → (F) が落ちる
+
+★本物の受け皿（~/.tyhld/codex-notify）・本物のホームには触らない（使い捨ての置き場だけ）。
+"""
+import json
+import os
+import subprocess
+import sys
+import tempfile
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+sys.path.insert(0, HERE)
+
+import stop_hook  # noqa: E402
+
+STOP_HOOK = os.path.join(HERE, 'stop_hook.py')
+NOTIFY_PY = os.path.join(HERE, os.pardir, 'codex', 'codex-notify.py')
+
+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]}')
+
+
+def first(rows):
+    """先頭の1行（★無ければ空の物。空振り確認で落ちるときも転ばず最後まで数える）。"""
+    return rows[0] if rows else {}
+
+
+JOB = 'ab910bc6-1eb6-469b-8f3c-83742edcc1e5'  # ★配達された便ID（1文字も変えない）
+SITE = 'codex-probe-test-ab910bc6'
+
+
+class Box:
+    """使い捨ての置き場（ホーム・受け皿・現場のフォルダ・会話の記録）。"""
+
+    def __init__(self, with_stamp=True, site=SITE):
+        self.root = tempfile.mkdtemp(prefix='stop-codex-route-')
+        self.home = os.path.join(self.root, 'home')
+        self.tray = os.path.join(self.root, 'tray')
+        self.work = os.path.join(self.home, 'projects', site)
+        for d in (self.home, self.tray, self.work, os.path.join(self.work, '.git')):
+            os.makedirs(d, exist_ok=True)
+        self.transcript = os.path.join(self.root, 'transcript.jsonl')
+        lines = ['{"text": "ごあいさつ"}']
+        if with_stamp:
+            lines.append(json.dumps({'text': f'お願いします\n\nCONDUCTOR_JOB:{JOB}'}))
+        with open(self.transcript, 'w', encoding='utf-8') as f:
+            f.write('\n'.join(lines) + '\n')
+
+    def env(self, extra=None):
+        env = {
+            'HOME': self.home,
+            'PATH': os.environ.get('PATH', '/usr/bin:/bin'),
+            'CONDUCTOR_CODEX_NOTIFY_DIR': self.tray,
+        }
+        env.update(extra or {})
+        return env
+
+    def tray_lines(self, site=SITE):
+        return self._read(os.path.join(self.tray, f'{site}.jsonl'))
+
+    def unresolved(self):
+        return self._read(os.path.join(self.tray, '_unresolved.skipped.jsonl'))
+
+    def calls(self):
+        return self._read(os.path.join(self.tray, '_calls.log'))
+
+    def calls_raw(self):
+        p = os.path.join(self.tray, '_calls.log')
+        if not os.path.isfile(p):
+            return ''
+        with open(p, encoding='utf-8') as f:
+            return f.read()
+
+    @staticmethod
+    def _read(path):
+        if not os.path.isfile(path):
+            return []
+        with open(path, encoding='utf-8') as f:
+            return [json.loads(l) for l in f.read().split('\n') if l.strip()]
+
+
+def codex_stop(box, message='出来ました。報告は置きました。', cwd=None):
+    """Codex の `Stop` に渡る形（★ADR-022 の実測の項目名そのまま）。"""
+    return {
+        'cwd': box.work if cwd is None else cwd,
+        'hook_event_name': 'Stop',
+        'last_assistant_message': message,
+        'model': 'gpt-5-codex',
+        'permission_mode': 'on-request',
+        'session_id': 'se-abc',
+        'stop_hook_active': False,
+        'transcript_path': box.transcript,
+        'turn_id': 'tu-123',
+    }
+
+
+def claude_stop(box, message='出来ました。報告は置きました。'):
+    """Claude Code の `Stop` に渡る形（★ADR-024 §1 の実測の6項目だけ・turn_id は入らない）。"""
+    return {
+        'cwd': box.work,
+        'last_assistant_message': message,
+        'transcript_path': box.transcript,
+        'session_id': 'se-abc',
+        'stop_hook_active': False,
+        'permission_mode': 'default',
+    }
+
+
+def run_hook(box, data, extra_env=None):
+    """フックを【実物と同じ呼び方】で1回走らせる。返り: (終了コード, 画面へ出た物)。"""
+    res = subprocess.run(
+        [sys.executable, STOP_HOOK],
+        input=json.dumps(data),
+        capture_output=True,
+        text=True,
+        env=box.env(extra_env),
+        check=False,
+    )
+    return res.returncode, res.stdout
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('=== (A) 道の見分け（★Claude のときは必ず書かない） ===')
+# ─────────────────────────────────────────────────────────────────────────────
+box = Box()
+check('実測の Codex の Stop → Codex と見分ける',
+      stop_hook.write_codex_turn_notice(codex_stop(box), box.env()) is not None, True)
+check('   受け皿に1行入った', len(box.tray_lines()), 1)
+
+box_c = Box()
+check('★実測の Claude の Stop → 何もしない',
+      stop_hook.write_codex_turn_notice(claude_stop(box_c), box_c.env()), None)
+check('★Claude は受け皿に1行も書かない', box_c.tray_lines(), [])
+check('★Claude は呼ばれた記録にも書かない', box_c.calls(), [])
+
+box_k = Box()
+no_turn = {k: v for k, v in codex_stop(box_k).items() if k != 'turn_id'}
+check('職人の種類の印が codex なら、項目が無くても書く',
+      stop_hook.write_codex_turn_notice(
+          no_turn, box_k.env({'CONDUCTOR_AGENT_KIND': 'codex'}))[0], 'tray')
+
+box_k2 = Box()
+check('★職人の種類の印が claude なら、項目が在っても書かない',
+      stop_hook.write_codex_turn_notice(
+          codex_stop(box_k2), box_k2.env({'CONDUCTOR_AGENT_KIND': 'claude'})), None)
+check('★その時は受け皿も空', box_k2.tray_lines(), [])
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('=== (B) 受け皿の1行は、受け口が書く物と同じ形 ===')
+# ─────────────────────────────────────────────────────────────────────────────
+box = Box()
+code, out = run_hook(box, codex_stop(box))
+check('終了コードは 0', code, 0)
+check('画面へ何も出さない', out, '')
+lines = box.tray_lines()
+check('受け皿に1行だけ', len(lines), 1)
+got = first(lines)
+check('現場名（登録簿も配達文も無いので git の頂上で決まる）', got.get('site'), SITE)
+check('本文（最後の返事）がそのまま入る', got.get('report'), '出来ました。報告は置きました。')
+check('便の印は全部（配り役が便と突き合わせる値）', got.get('jobId'), JOB)
+check('★どの道から来たか', got.get('route'), 'stop')
+check('ターンの印', got.get('turnId'), 'tu-123')
+truthy('書いた時刻が入る', isinstance(got.get('at'), str) and got['at'])
+
+# ★欄の集合が notify の1行と同じ＝1行の形を2か所に書いていない。
+notify_payload = {
+    'type': 'agent-turn-complete',
+    'thread-id': 'th-1',
+    'turn-id': 'tu-1',
+    'cwd': box.work,
+    'input-messages': [f'やってください\n\nCONDUCTOR_JOB:{JOB}\n最終行: DONE:{SITE} とだけ出力'],
+    'last-assistant-message': 'できました。',
+}
+box_n = Box()
+subprocess.run([sys.executable, NOTIFY_PY, json.dumps(notify_payload)],
+               env=box_n.env(), check=True, capture_output=True)
+check('★欄の集合が notify の1行と同じ',
+      sorted(first(box_n.tray_lines()).keys()), sorted(got.keys()))
+check('notify の道の印は notify', first(box_n.tray_lines()).get('route'), 'notify')
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('=== (C) 内部のターンでは書かない／現場を決められない時は控えへ ===')
+# ─────────────────────────────────────────────────────────────────────────────
+box = Box()
+run_hook(box, codex_stop(box, message='{"summary":"まとめ","next_action":null}'))
+check('内部のターンは受け皿へ入れない', box.tray_lines(), [])
+check('記録には1行残る（捨てた事が分かる）', [l['how'] for l in box.calls()], ['internal-turn'])
+
+box = Box()
+# 配達文の DONE: も登録簿も git の頂上も無く、作業フォルダの名前も現場名に使えない。
+run_hook(box, codex_stop(box, cwd=''))
+check('現場を決められない知らせは控えへ（捨てない）', len(box.unresolved()), 1)
+check('控えの1行にも道が入る', first(box.unresolved()).get('route'), 'stop')
+check('控えの1行に便の印が入る', first(box.unresolved()).get('jobId'), JOB)
+check('記録は unresolved-site', [l['how'] for l in box.calls()], ['unresolved-site'])
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('=== (D) ★受け皿へ書けなくても、いまの仕事と終了コードは変わらない ===')
+# ─────────────────────────────────────────────────────────────────────────────
+box = Box()
+os.makedirs(os.path.join(box.tray, f'{SITE}.jsonl'))   # 受け皿の名前でフォルダ＝書けない
+code, out = run_hook(box, codex_stop(box))
+check('終了コードは 0（Codex を止めない）', code, 0)
+check('画面へ何も出さない', out, '')
+check('書けなかった事は記録に残る', [l['how'] for l in box.calls()], ['write-failed'])
+
+box = Box()
+ask = codex_stop(box, message='どちらにしますか？')
+check('問いかけの手番は、前からの確認カードの経路だけを通る（止めない・出力なし）',
+      run_hook(box, ask), (0, ''))
+check('★問いかけの手番でも受け皿には書く（notify と同じ間合い）', len(box.tray_lines()), 1)
+
+# ★受け皿が丸ごと書けなくても、関門の判定（いまの仕事）は1つも変わらない。
+box = Box()
+state = os.path.join(box.root, 'state')
+gate_env = box.env({'XDG_STATE_HOME': state, 'CONDUCTOR_RUNNER_MODE': 'headless',
+                    'CONDUCTOR_SITE': SITE, 'CONDUCTOR_WORK_DIR': box.work,
+                    'CONDUCTOR_CODEX_NOTIFY_DIR': os.path.join(box.tray, 'ない', '置き場')})
+before = stop_hook.finish_gate_block(codex_stop(box), gate_env)
+truthy('報告が無い手番は、受け皿が書けなくても今までどおり差し戻す', before)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('=== (E) 呼ばれた記録（道・便の印の頭8文字・本文は入らない） ===')
+# ─────────────────────────────────────────────────────────────────────────────
+box = Box()
+secretish = 'ここに本文が入ってはいけない-ABCDEF'
+run_hook(box, codex_stop(box, message=secretish))
+rec = first(box.calls())
+check('道が入る', rec.get('route'), 'stop')
+check('★便の印は頭8文字だけ', rec.get('jobStamp'), JOB[:8])
+check('現場名が入る', rec.get('site'), SITE)
+check('本文は字数だけ', rec.get('reportChars'), len(secretish))
+check('★本文は1文字も入らない', secretish in box.calls_raw(), False)
+check('★会話の記録の置き場も入らない', box.transcript in box.calls_raw(), False)
+
+box = Box(with_stamp=False)
+run_hook(box, codex_stop(box))
+check('★便の印が無ければ空', first(box.calls()).get('jobStamp'), '')
+check('印が無くても受け皿には入る（配り役が時刻で判断する）', len(box.tray_lines()), 1)
+check('受け皿の便の印は空（作り話をしない）', first(box.tray_lines()).get('jobId'), None)
+
+box = Box()
+os.makedirs(os.path.join(box.tray, '_calls.log'))      # 記録の名前でフォルダ＝記録だけ書けない
+code, _ = run_hook(box, codex_stop(box))
+check('記録が書けなくても終了コードは 0', code, 0)
+check('★記録が書けなくても知らせの本体は書かれる', len(box.tray_lines()), 1)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('=== (F) ★関門が差し戻す手番では書かない ===')
+# ─────────────────────────────────────────────────────────────────────────────
+box = Box()
+state = os.path.join(box.root, 'state')
+code, out = run_hook(box, codex_stop(box), {
+    'XDG_STATE_HOME': state,
+    'CONDUCTOR_RUNNER_MODE': 'headless',
+    'CONDUCTOR_SITE': SITE,
+    'CONDUCTOR_WORK_DIR': box.work,
+})
+truthy('報告が無いので差し戻す', out.strip().startswith('{'))
+check('差し戻しの形は変わらない', json.loads(out)['decision'], 'block')
+check('終了コードは 0', code, 0)
+check('★差し戻した手番では受け皿へ書かない', box.tray_lines(), [])
+check('★呼ばれた記録にも足さない', box.calls(), [])
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('=== (G) ★受け口が読めない機体では何もしない ===')
+# ─────────────────────────────────────────────────────────────────────────────
+box = Box()
+missing = os.path.join(box.root, 'ない', 'codex-notify.py')
+check('読めなければ何もしない',
+      stop_hook.write_codex_turn_notice(
+          codex_stop(box), box.env({'CONDUCTOR_CODEX_NOTIFY_PY': missing})) is None,
+      True)
+check('★受け皿も空のまま', box.tray_lines(), [])
+check('名指しが在れば、それだけを見る',
+      stop_hook.codex_notify_paths(box.env({'CONDUCTOR_CODEX_NOTIFY_PY': missing})), [missing])
+check('名指しが無ければ、稼働機の場所とリポジトリの隣の2つ',
+      len(stop_hook.codex_notify_paths({})), 2)
+truthy('★稼働機の場所（番人と同じフォルダ）を見ている',
+       os.path.join(HERE, 'codex-notify.py') in stop_hook.codex_notify_paths({}))
+truthy('★リポジトリの隣（scripts/codex/）も見ている',
+       any(os.path.normpath(p) == os.path.normpath(NOTIFY_PY)
+           for p in stop_hook.codex_notify_paths({})))
+
+print('\n' + '=' * 72)
+if failures:
+    print(f'NG {len(failures)} 件')
+    for f in failures:
+        print('  ' + f)
+    sys.exit(1)
+print('すべて期待どおり')