@tyhld/conductor 0.3.0 → 0.7.0

package/scripts/hooks/settings.sample.json

@@ -0,0 +1,142 @@
+{
+  "_comment": [
+    "番人（段2）を登録するための見本。★このファイルは読むだけの見本で、これ自体は効きません。",
+    "人間が ~/.claude/settings.json の hooks をこの内容へ置き換えてください（AIは書き換えません）。",
+    "パスは実機に合わせて直してください（下は conductor をチェックアウトした場所の例）。",
+    "",
+    "★パスの書き方: 特定の機体の実パス（/home/ユーザー名/... ）は書きません。$HOME を使います。",
+    "  フックのコマンドはシェル経由で実行されるため $HOME はそのまま展開されます。",
+    "  conductor を $HOME/projects/conductor 以外へ置いた場合は、その場所に合わせて直してください。",
+    "  （配布 scripts/update-guard.sh はファイル名（末尾のbasename）だけを見て固定パス",
+    "   $HOME/.tyhld/hooks/ へ置き換えるので、ここのディレクトリ部分は配布結果に影響しません。）",
+    "",
+    "★1本化: 旧 ~/.tyhld/hooks/cc2_guard.py への参照は【消して】、リポジトリ内の",
+    "  scripts/hooks/cc2_guard.py だけを正にします（判定の正が2つある状態を解消する）。",
+    "",
+    "★matcher: 番人は Bash 以外も見るので、PreToolUse は全ツール（matcher 省略）にします。",
+    "  旧設定は Bash|WebFetch|... と列挙していたため、新しいツールが増えると素通りしていました。",
+    "",
+    "★permissions: 関門は番人自身が持つようになったので、settings 側の ask 13件は不要です。",
+    "  また settings.local.json に溜まった allow 200行も、既定が allow になったので不要です。",
+    "  （消すかどうかは人間の判断。残っていても deny → ask → allow の順で評価されるため、",
+    "   番人の deny と ask は allow より先に効きます＝関門と危険は破られません。）"
+  ],
+  "hooks": {
+    "PreToolUse": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 $HOME/projects/conductor/scripts/hooks/cc2_guard.py"
+          }
+        ]
+      }
+    ],
+    "PermissionRequest": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "timeout": 600,
+            "command": "python3 $HOME/projects/conductor/scripts/hooks/permission_request_hook.py"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "timeout": 600,
+            "command": "python3 $HOME/projects/conductor/scripts/hooks/stop_hook.py"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "timeout": 600,
+            "command": "python3 $HOME/projects/conductor/scripts/hooks/notification_hook.py"
+          }
+        ]
+      }
+    ]
+  },
+  "_comment_notification": [
+    "★Notification は「端末でしか押せない問い」を管制へ出すための入口（ADR-016）。",
+    "実機 2026-09-02 14:12: サンドボックスの通信許可（Host: results-receiver.actions.",
+    "githubusercontent.com）が端末にだけ出て職人が止まり、管制には1件も出なかった。",
+    "この問いは PermissionRequest を鳴らさないが、Claude Code 2.1.246 以降は",
+    "Notification フックを鳴らす（本体同梱の変更履歴に修正の記載あり・実機は 2.1.258）。",
+    "ところが Notification はホームにも現場にも【1つも登録されていなかった】＝鳴っても誰も聞いていない。",
+    "ここに登録することで、管制に『端末で押してください』のカードが出るようになる。"
+  ],
+  "_comment_sandbox": [
+    "★外への通信は【全部通す】。職人は聞かれずに自走して完了まで行く（えふさん決定 2026-09-03＝甲）。",
+    "",
+    "【なぜ全部通すのか】",
+    "  『Network request outside of sandbox / 1.Yes 2.Yes,don't ask again 3.No』の問いは、",
+    "  ★管制の3ボタンでは押せない。Claude Code 2.1.258 本体の作りで、この問いは PermissionRequest",
+    "  フックに繋がっておらず（実測 2026-09-03・便 622e5497）、答えられるのは端末のダイアログか",
+    "  Anthropic 公式のリモート操作だけ。＝人の目が無いと職人が止まったままになる。",
+    "  止めても止めなくても最後は人が PR の結果を見て直すので、途中で止める意味が無い。",
+    "",
+    "【全部通す書き方（★実物で確定・2026-09-03 実測）】",
+    "  allowedDomains に \"*\" を1つ入れる。本体のホスト照合は zN(host, pattern) で",
+    "    pattern === \"*\" なら無条件に一致 → 『Allowed by config rule』",
+    "  となり、確認そのものが起きない（実測: allowedDomains=[] だと curl が 403 で塞がれ、",
+    "  [\"*\"] だと 200。対話画面でも通信ダイアログは0回、permission_prompt の通知も出ない）。",
+    "",
+    "【★これで緩むのは『電話をかける』だけ。『金庫を持ち出す』は1ミリも緩まない】",
+    "  ・秘密の持ち出し（curl -d @.env / cp .env / tar ~/.ssh / base64 .env など）を止めるのは",
+    "    番人 cc2_guard.py + policy.py の『対象と作用』判定で、通信の設定とは【別の仕組み】。",
+    "    番人はコマンドの文字列だけを見ており、allowedDomains を1文字も参照していない",
+    "    （test/network-always-allow.test.ts が両者の独立を機械で固定している）。",
+    "  ・本番DB・secret・設定ファイル・.env・hooks・.tyhld・.ssh への書き込み禁止（deny）もそのまま。",
+    "  ・deniedDomains は allowedDomains より【先に】判定される（本体の順序: Denied → Allowed →",
+    "    一致なし）。だから \"*\" を入れても sales-template の本番DB直結の禁止は効いたまま（実測で確認）。",
+    "",
+    "★キー名は公式ドキュメント準拠: sandbox.network.allowedDomains（allow ではない）。",
+    "★配布: 実機の ~/.claude/settings.json はこの見本では書き換えない。scripts/update-guard.sh が",
+    "  ①-e3 でホームへ \"*\" を配り（1台1か所）、④で sandbox を持つ現場にも追記する（追加のみ）。"
+  ],
+  "_comment_domain_groups": [
+    "★下の _domain_groups は【消さない】。通信が全開になった今でも『職人が実際にどこへ出るのか』",
+    "  の記録であり、将来もし全開をやめて絞り直すときの出発点になるため（ADR-016 の資産）。",
+    "★通信が全開なので、この組に足しても足さなくても職人は止まらない。足すのは記録のためだけ。",
+    "★同じ理由で notification_hook.py も残す。全開なら permission_prompt は出なくなるが、",
+    "  『端末でしか押せない他の問い』（idle_prompt など）は今も出るので、入口は要る。",
+    "★measured = この機体で実際に接続が観測できたもの。documented = GitHub が公式に挙げている端点。"
+  ],
+  "_domain_groups": {
+    "npm": [
+      "npm.pkg.github.com",
+      "registry.npmjs.org"
+    ],
+    "github": [
+      "github.com",
+      "api.github.com",
+      "codeload.github.com",
+      "objects.githubusercontent.com"
+    ],
+    "github-actions": [
+      "results-receiver.actions.githubusercontent.com",
+      "pipelines.actions.githubusercontent.com"
+    ],
+    "playwright": [
+      "cdn.playwright.dev",
+      "playwright.download.prss.microsoft.com"
+    ]
+  },
+  "sandbox": {
+    "network": {
+      "allowedDomains": [
+        "*"
+      ]
+    }
+  }
+}

package/scripts/hooks/stop_hook.py

@@ -0,0 +1,275 @@
+#!/usr/bin/env python3
+"""stop_hook.py — Stop フック（段2・職人が人へ返して手が止まった時に管制へ知らせる）。
+
+【いつ走るか】職人が応答を返し終えた瞬間（＝入力待ちに入る瞬間）。
+
+【何をするか】
+  紐づく指示（ConductorCommand）が【まだ終わっていない】、かつ最後の発言が【人の判断を
+  求める問いかけ】のときだけ、その発言を kind='message' として管制へ送る。
+  管制側ではフックが待っている間だけカードが出る。
+
+【★カードを出す条件は2つ（両方満たしたときだけ出す）】
+  (1) 紐づく指示がまだ終わっていないこと
+      ・待ち時間では判定しない（60秒待つ等は「遅い返事」と区別できない）。
+      ・指示が done/failed/cancelled/dismissed/timeout なら、それは「終わった」であって
+        「待っている」ではない＝送らない。
+      ・指示IDが分からない／管制に聞けない場合は【送らない】（安全側。カードを増やさない）。
+  (2) 最後の発言が【人の判断を求める問いかけ】であること（★ADR-008）
+      ・以前はここを見ていなかったため、「CIの完走を待っています。」のような【ただの進捗報告】
+        でも「担当者から質問があります」のカードが出て、職人が人を待って止まっていた（実機
+        2026-08-30）。進捗報告に人の判断は要らない。
+      ・見分け方は needs_human_answer()。迷う文は【出さない側】へ倒す（止まって人を待つより、
+        報告して進む方が実害が小さい。本当に必要なら職人はもう一度聞ける）。
+
+【★ここは「危ない操作の確認」ではない】
+  実行前の3関門（main直変更／本番確認／DB実行）・秘密の持ち出し・SQL は PreToolUse
+  （cc2_guard.py → policy.py）と PermissionRequest（permission_request_hook.py）が止める。
+  このフックは【ツールを実行しない】場面のお知らせだけを扱うので、ここを絞っても関門は
+  1つも弱まらない。
+
+【指示IDの見つけ方】
+  職人へ渡る指示文の末尾に管理用ジョブ印 `CONDUCTOR_JOB:<uuid>` が入っている。
+  Stop フックの入力に含まれる transcript_path（会話の記録）から、最後に出てきたものを拾う。
+
+【接続先が未設定の環境】何もせず終了する（このフックを入れても壊れない）。
+"""
+import json
+import os
+import re
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+import hook_datalink  # noqa: E402
+import summary_ja  # noqa: E402
+
+JOB_RE = re.compile(r'CONDUCTOR_JOB:([0-9a-fA-F-]{36})')
+
+# 指示が「もう終わっている」状態（relay の isTerminalCommandStatus ＋ 中央の追加終端に合わせる）。
+TERMINAL_STATUSES = frozenset({
+    'done', 'failed', 'cancelled', 'canceled', 'abandoned', 'dismissed', 'timeout',
+})
+
+# ★このフックが1件の確認を待つ上限（秒）。返事が来なければ「返事なし」として先へ進む。
+#   共有の上限 hook_datalink.MAX_WAIT_SEC（600秒）から【30秒差し引く】。
+#   理由: Claude Code 側のフック実行タイムアウトも 600 秒（settings.json の timeout）なので、
+#   同じ 600 秒まで待つと、時間切れの瞬間にフックが外から打ち切られ、finally の abandon()
+#   （カードを閉じる後始末）が走らないことがある＝管制に【残骸カード】が残る（ADR-009 と同じ病気）。
+#   後始末を確実に走らせるため、待つのを先に切り上げる。
+#   ★共有の MAX_WAIT_SEC は変えない（ツール実行の許可を待つ permission_request_hook に影響が出る）。
+STOP_WAIT_SEC = max(60, hook_datalink.MAX_WAIT_SEC - 30)
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 「本当に人の判断が要る問いかけか」の見分け（★出す側ではなく出さない側へ倒す）
+# ─────────────────────────────────────────────────────────────────────────────
+# 判定の邪魔になる部分。コード・引用・URL の中の「?」で問いかけと誤らないため先に落とす。
+_FENCE_RE = re.compile(r'```.*?```', re.S)      # 対になったコード塊
+_FENCE_OPEN_RE = re.compile(r'```.*\Z', re.S)   # 閉じ忘れたコード塊（末尾まで）
+_INLINE_CODE_RE = re.compile(r'`[^`\n]*`')
+_QUOTE_LINE_RE = re.compile(r'^[ \t]*>[^\n]*', re.M)
+_URL_RE = re.compile(r'https?://\S+')
+
+# 文の区切り。★半角ピリオドは入れない（stop_hook.py や 1.5 で文が切れてしまう）。
+_TERMINATORS = '。．！!？?\n\r'
+
+# 文末の飾り（かっこ・引用符・強調記号）。ここまで剥がしてから文末の言い回しを見る。
+_CLOSERS = '」』）)】〕》〉”"\'’`＊*＿_〜～…・、,　 \t'
+
+# 文末に来たら【問いかけ】とみなす言い回し。日本語は語順ではなく文末で問いかけが決まる。
+#   例: 〜しますか / 〜でしょうか / 〜ませんか / 〜でしたか / どちらにしますか
+#   ★「〜します」「〜しています」「〜しました」「〜を待っています」「〜が完了しました」
+#     「〜を設定しました」は当たらない＝完了・状況の報告はここで問いかけにならない。
+_ASK_TAIL_RE = re.compile(
+    r'(?:ます|ました|ません|ませんでした|ましょう|です|でした|でしょう|だろう|んだろう|のだろう)'
+    r'か(?:ね|な|しら)?$'
+    r'|いかがでしょう$',
+)
+
+# 「？」で終わる文のうち、【人に判断を求めている】と読める合図。★ADR-011。
+#   ここに当たらない「？」は、調べものの自問・表のセル・記事タイトル・引用のことが多い。
+#   実機の記録7,581件を走査した結果、誤発火37件の大半がその形だった（ADR-011 に内訳）。
+_ASK_WORD_JA_RE = re.compile(
+    r'どちら|どっち|どれ|いずれ'          # 選択を求める
+    r'|よろし|構いま|許可|承認'            # 許可を求める
+    r'|どうしま|どうすれ|いかが'            # 判断を仰ぐ
+    r'|ご指示|お願いしま|教えてくださ|決めてくださ|選んでくださ',
+)
+# 英語は【人称を伴う許可・依頼】の形だけを問いかけとみなす。
+#   「do subcontractor photos reach …?」のような三人称の調べもの（自問）は人への問いかけではない。
+_ASK_WORD_EN_RE = re.compile(
+    r'\b(?:should i|shall i|may i|do you want|would you like|do you prefer'
+    r'|let me know|please confirm|ok(?:ay)? to|can i (?:proceed|continue|go ahead))\b',
+    re.I,
+)
+
+# 表の行（Markdown のセル）。セルに置いた「？」マークで問いかけと誤らないため丸ごと外す。
+_TABLE_ROW_RE = re.compile(r'^[ \t]*\|')
+
+# 実質「？」だけ・記号だけの断片は問いかけにしない（「「？」で始まる…」のような引用の欠片）。
+_MIN_QUESTION_CHARS = 4
+
+
+def _strip_noise(text):
+    """コード塊・引用行・URL を落とす（この中の「?」は職人の問いかけではない）。"""
+    t = _FENCE_RE.sub(' ', text)
+    t = _FENCE_OPEN_RE.sub(' ', t)
+    t = _INLINE_CODE_RE.sub(' ', t)
+    t = _QUOTE_LINE_RE.sub(' ', t)
+    return _URL_RE.sub(' ', t)
+
+
+def _sentences(text):
+    """文に切り分ける（区切り文字は各文の末尾に残す）。"""
+    buf = []
+    for ch in text:
+        buf.append(ch)
+        if ch in _TERMINATORS:
+            s = ''.join(buf).strip()
+            if s:
+                yield s
+            buf = []
+    tail = ''.join(buf).strip()
+    if tail:
+        yield tail
+
+
+def _is_asking(sentence):
+    """1文が【人の判断を求める問いかけ】か。★ADR-011 で「疑わしきは出さない」へ寄せた。
+
+    出すのは次のどちらかだけ:
+      (1) 日本語の問いかけの語尾（〜しますか / 〜でしょうか / 〜ましょうか / 〜でしたか …）
+      (2) 「？」で終わり、かつ【人に判断を求める合図】がある（どちら／よろしい／許可／
+          Should I … のような人称を伴う依頼）
+
+    出さないのは:
+      ・表の行（セルに置いた「？」マーク）
+      ・「？」だけの断片（引用の欠片・記号）
+      ・「？」で終わるが人に向いていない文（調べものの自問・記事タイトル・引用の写し）
+      ・完了・状況の報告（「〜しました」「〜を待っています」「〜が完了しました」
+        「〜を設定しました」）… (1)(2) のどちらにも当たらないので構造的に出ない
+    """
+    s = sentence.strip()
+    if _TABLE_ROW_RE.match(s):      # 表の行はセルの寄せ集め＝文ではない
+        return False
+    s = s.rstrip(_CLOSERS)
+    if not s:
+        return False
+    ends_with_mark = s[-1] in '?？'
+    core = s.rstrip(_TERMINATORS + _CLOSERS + '.')
+    if len(core) < _MIN_QUESTION_CHARS:
+        return False                # 「？」だけ／記号だけの断片
+    if _ASK_TAIL_RE.search(core):
+        return True                 # (1) 問いかけの語尾
+    if not ends_with_mark:
+        return False
+    # (2) 「？」で終わる文は、人に判断を求めていると読めるときだけ出す。
+    return bool(_ASK_WORD_JA_RE.search(core) or _ASK_WORD_EN_RE.search(core))
+
+
+def needs_human_answer(message):
+    """職人の最後の発言に、人が答えるべき問いかけが含まれるか。
+
+    ★迷ったら False（＝カードを出さない）。進捗・状況の報告で職人を止めないことを優先する。
+    """
+    if not isinstance(message, str) or not message.strip():
+        return False
+    return any(_is_asking(s) for s in _sentences(_strip_noise(message)))
+
+
+def find_command_id(transcript_path):
+    """会話の記録から、最後に出てきた管理用ジョブ印の ID を拾う。見つからなければ None。"""
+    if not transcript_path or not os.path.isfile(transcript_path):
+        return None
+    found = None
+    try:
+        with open(transcript_path, encoding='utf-8', errors='replace') as f:
+            for line in f:
+                for m in JOB_RE.finditer(line):
+                    found = m.group(1)
+    except Exception:  # noqa: BLE001
+        return None
+    return found
+
+
+def command_is_open(cfg, command_id, datalink=hook_datalink):
+    """指示がまだ終わっていないか。分からなければ False（＝送らない・安全側）。"""
+    if not command_id:
+        return False
+    res = datalink._request(cfg, 'GET', f'/api/conductor/commands/{command_id}')
+    if not isinstance(res, dict):
+        return False
+    status = res.get('status')
+    if not isinstance(status, str) or not status.strip():
+        return False
+    return status.strip().lower() not in TERMINAL_STATUSES
+
+
+def build_payload(data, command_id):
+    cwd = data.get('cwd') or ''
+    site = os.environ.get('CONDUCTOR_SITE') or (cwd.rstrip('/').rsplit('/', 1)[-1] if cwd else '')
+    machine = os.environ.get('CONDUCTOR_MACHINE') or os.uname().nodename
+    message = data.get('last_assistant_message') or ''
+    return {
+        'site': site or 'unknown',
+        'machine': machine,
+        # ★sessionId は絶対に空で送らない（空だと管制が 400 で弾く）。
+        'sessionId': hook_datalink.stable_session_id(data.get('session_id'), machine, site),
+        'kind': 'message',
+        'question': message,
+        'summary': summary_ja.summarize_question(message),
+        'commandId': command_id,
+        'waitMs': STOP_WAIT_SEC * 1000,
+    }
+
+
+def run(data, cfg=None, datalink=hook_datalink):
+    """返り値: 送った確認のID / None（送らなかった）。"""
+    message = data.get('last_assistant_message')
+    if not isinstance(message, str) or not message.strip():
+        return None
+    if not needs_human_answer(message):
+        return None  # ただの進捗・状況の報告 → 人の判断は要らない＝カードを作らない
+    cfg = cfg if cfg is not None else datalink.load_config()
+    if cfg is None:
+        return None
+
+    command_id = find_command_id(data.get('transcript_path'))
+    if not command_is_open(cfg, command_id, datalink=datalink):
+        return None  # 終わっている／分からない → カードを作らない
+
+    reg = datalink.register(cfg, build_payload(data, command_id))
+    if not reg or not reg.get('id'):
+        return None
+    request_id = reg['id']
+
+    # 人が答えるまで（または時間切れまで）待つ。★ここで待つ間だけ管制にカードが出る。
+    #   Stop フックは答えを「実行の可否」には使わない（実行するツールが無い）。
+    #   待つこと自体が「担当者はまだ返事を待っている」を管制へ伝え続ける役割を持つ。
+    # ★待っている間だけ「この止まりは管制が受け持っている」印を置く（ADR-016）。
+    #   Claude Code の Notification（「入力待ちです」）で同じ止まりが2枚出るのを防ぐ。
+    datalink.mark_handoff(data.get('session_id') or '')
+    try:
+        # ★上限つき（STOP_WAIT_SEC）。返事が来なければ時間切れで先へ進む＝職人を無限に止めない。
+        datalink.wait_for_decision(cfg, request_id, max_wait_sec=STOP_WAIT_SEC)
+    finally:
+        datalink.abandon(cfg, request_id)   # 去るときは必ず閉じる（残骸カードを作らない）
+        datalink.clear_handoff(data.get('session_id') or '')
+    return request_id
+
+
+def main() -> int:
+    try:
+        raw = sys.stdin.read()
+        data = json.loads(raw) if raw.strip() else {}
+    except Exception:  # noqa: BLE001
+        return 0
+    try:
+        run(data)
+    except Exception:  # noqa: BLE001
+        pass
+    return 0  # ★Stop フックは会話を止めない（何があっても exit 0・出力なし）
+
+
+if __name__ == '__main__':
+    sys.exit(main())

package/scripts/hooks/summary_ja.py

@@ -0,0 +1,155 @@
+#!/usr/bin/env python3
+"""summary_ja.py — 確認カードに出す【日本語1行】の組み立て。
+
+【なぜ要るか】
+  確認カードは非エンジニアのお客さまがそのまま読んで判断する。英文や生コマンドを貼ると
+  「何を許可するのか」が分からないまま押すことになる。ここで必ず日本語の1行に写す。
+  生の内容（コマンド全文・ツール入力）はカードの「くわしく」に残す（消さない）。
+
+【方針】
+  ・どんな入力でも必ず日本語が返る（ここで詰まってカードが出ない、を作らない）。
+  ・関門（マージ／本番確認／DB実行）は、何の関門かが一目で分かる文言にする。
+  ・推測で断定しない。分からないものは「〜してよいですか」の中立形にする。
+"""
+import os
+import re
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+import policy  # noqa: E402  … 関門に当たったセグメントを特定するため
+
+# 動詞ごとの言い換え（先頭一致で見る）。★増やすときはここだけ触る。
+_PHRASES = [
+    (r'^gh\s+pr\s+merge\b', '変更を本番の元（main）に取り込んでよいですか'),
+    (r'^gh\s+pr\s+create\b', '変更の提案（プルリクエスト）を作ってよいですか'),
+    (r'^gh\s+pr\s+(view|checks|list|status|diff)\b', '変更の提案の状態を見てよいですか'),
+    (r'^gh\s+run\b', '自動テストの実行結果を見てよいですか'),
+    (r'^git\s+push\b', '作業内容をGitHubへ送ってよいですか'),
+    (r'^git\s+commit\b', '作業内容を記録（コミット）してよいですか'),
+    (r'^git\s+merge\b', '別の作業内容を取り込んでよいですか'),
+    (r'^git\s+(status|log|diff|show|branch)\b', '作業の状態を確認してよいですか'),
+    (r'^vercel\b.*--prod', '本番サイトへ公開してよいですか'),
+    (r'^vercel\s+(promote|alias|rollback)\b', '本番サイトの向き先を切り替えてよいですか'),
+    (r'^(npm|pnpm|yarn)\s+publish\b', '部品を公開（配布）してよいですか'),
+    (r'^(npm|pnpm|yarn)\s+(install|ci|add)\b', '必要な部品を取り寄せてよいですか'),
+    (r'^(npm|pnpm|yarn)\s+run\s+build\b', 'プログラムを組み立て（ビルド）してよいですか'),
+    (r'^(npm|pnpm|yarn)\s+(test|run\s+test)\b', 'テストを実行してよいですか'),
+    (r'^npx\s+tsc\b', 'プログラムの型チェックを実行してよいですか'),
+    (r'^psql\b|^mysql\b', 'データベースへ直接つないでよいですか'),
+    (r'prisma\s+(migrate|db)\b', 'データベースの構造を変更してよいですか'),
+    (r'supabase\s+db\s+(push|reset)|supabase\s+migration\s+up',
+     'データベースの構造を変更してよいですか'),
+    (r'^supabase\s+functions\s+deploy\b', '本番の処理を差し替えてよいですか'),
+    (r'^rm\b', 'ファイルを削除してよいですか'),
+    (r'^(cat|head|tail|less)\b', 'ファイルの中身を見てよいですか'),
+    (r'^(ls|find|grep|rg)\b', 'ファイルを探して見てよいですか'),
+    (r'^(journalctl|systemctl)\b', '動作の記録（ログ）を確認してよいですか'),
+    (r'^(docker|make|go|cargo)\b', 'プログラムを組み立て・実行してよいですか'),
+]
+
+# 関門ごとの見出し（policy.py の gate 種別に対応）。
+_GATE_HEADLINE = {
+    'merge': '【お客さまの確認：本番の元を直接変更】',
+    'release': '【お客さまの確認：本番へ反映】',
+    'db': '【お客さまの確認：データベースの変更】',
+}
+
+
+def _gating_segment(command: str, gate) -> str:
+    """関門に当たったセグメントの本文を返す（無ければ空）。
+
+    ★複合コマンド（`cd /x && gh pr merge 1`）で先頭語（cd）に引きずられないため、
+      見出しは【関門に当たったセグメント】から作る。judgment は policy に一致させる。
+    """
+    try:
+        for seg in policy.split_segments(command or ''):
+            r = policy.decide_bash(seg)
+            if r.get('decision') == policy.GATE and r.get('gate') == gate:
+                return seg
+    except Exception:  # noqa: BLE001  文言づくりで詰まってカードを止めない
+        return ''
+    return ''
+
+
+def _pushes_to_protected(segment: str) -> bool:
+    """`git push` の宛先が本番ブランチか（policy とまったく同じ見方をする）。
+
+    ★関門1の中身が「PRのマージ」から「main への直接 push」へ変わったため、カードの文言も
+      それに合わせる。字面の正規表現で当てると `feat/main-fix` のような枝名まで拾ってしまうので、
+      policy の判定材料（PROTECTED_BRANCHES と参照名の取り出し方）をそのまま使う。
+    """
+    try:
+        toks = policy.tokens_of(segment)
+        if policy.verb_of(toks) != 'git' or len(toks) < 2 or toks[1] != 'push':
+            return False
+        return any(t.split(':')[-1].strip() in policy.PROTECTED_BRANCHES
+                   for t in toks[2:] if not t.startswith('-'))
+    except Exception:  # noqa: BLE001  文言づくりで詰まってカードを止めない
+        return False
+
+
+def _verb_of(segment: str) -> str:
+    """セグメントの実行動詞（ラッパ・変数代入を飛ばす）。policy と同じ見方をする。"""
+    try:
+        return policy.verb_of(policy.tokens_of(segment))
+    except Exception:  # noqa: BLE001
+        return segment.split(' ', 1)[0].split('/')[-1] if segment else ''
+
+
+def summarize_bash(command: str, gate=None) -> str:
+    """Bash コマンドを日本語1行にする。"""
+    c = ' '.join((command or '').split())
+    # 関門のときは、当たったセグメントを見出しの素材にする（先頭語ではなく）。
+    target = c
+    if gate:
+        seg = _gating_segment(command, gate)
+        if seg:
+            target = ' '.join(seg.split())
+    # 本番ブランチへの直接 push（関門1）だけは、字面より先に専用の文言を当てる。
+    body = '本番の元（main）を直接書き換えてよいですか' if _pushes_to_protected(target) else None
+    if body is None:
+        for pat, phrase in _PHRASES:
+            if re.search(pat, target):
+                body = phrase
+                break
+    if body is None:
+        # 未知のコマンドは動詞だけ拾って中立形にする（英文をそのまま貼らない）。
+        verb = _verb_of(target) or (target.split(' ', 1)[0].split('/')[-1] if target else '')
+        body = f'パソコンの中で作業（{verb}）を実行してよいですか' if verb \
+            else 'パソコンの中で作業を実行してよいですか'
+    head = _GATE_HEADLINE.get(gate or '', '')
+    return f'{head}{body}'
+
+
+def summarize_tool(tool_name: str, tool_input, gate=None) -> str:
+    """Bash 以外のツールを日本語1行にする。"""
+    if tool_name == 'Bash':
+        cmd = (tool_input or {}).get('command', '') if isinstance(tool_input, dict) else ''
+        return summarize_bash(cmd, gate)
+    head = _GATE_HEADLINE.get(gate or '', '')
+    if tool_name in ('Write', 'Edit', 'MultiEdit', 'NotebookEdit'):
+        path = (tool_input or {}).get('file_path', '') if isinstance(tool_input, dict) else ''
+        name = path.rsplit('/', 1)[-1] if path else ''
+        return f'{head}ファイル（{name}）を書き換えてよいですか' if name \
+            else f'{head}ファイルを書き換えてよいですか'
+    if tool_name == 'WebFetch':
+        return f'{head}インターネットのページを読んでよいですか'
+    if tool_name == 'WebSearch':
+        return f'{head}インターネットで調べてよいですか'
+    if isinstance(tool_name, str) and tool_name.startswith('mcp__'):
+        return f'{head}外部の道具を使ってよいですか'
+    return f'{head}この操作を行ってよいですか'
+
+
+def summarize_question(text: str) -> str:
+    """職人が人へ投げた自由文を、カードの1行見出しにする。
+
+    ★中身の翻訳はしない（勝手な意訳で意味が変わるのを避ける）。
+      「担当者から質問があります」＋原文の先頭だけを添え、全文は詳細欄に残す。
+    """
+    t = ' '.join((text or '').split())
+    if not t:
+        return '担当者が返事を待っています。'
+    head = t[:60] + ('…' if len(t) > 60 else '')
+    return f'担当者から質問があります：{head}'