@tyhld/conductor 0.12.6 → 0.12.8

package/scripts/update-guard.sh

@@ -0,0 +1,1014 @@
+#!/usr/bin/env bash
+#
+# update-guard.sh — 稼働中の現場の「番人(cc2_guard.py)」と権限ルールを最新へ揃える。
+#
+# 【なぜ要るか】
+#   setup.sh は新規設置用で、既に動いている現場では
+#     - settings.json … 上書き確認が既定 N（顧客の設定を壊さないための保護）
+#     - hooks セクション … 既に在ればスキップ
+#   のため、番人を新しくしても稼働機には届かない。ここを埋めるのがこのスクリプト。
+#
+# 【やること】（すべて冪等：何度実行しても同じ結果。バージョン判定は不要）
+#   (a) 1台1箇所の固定パス $GUARD_HOME に、正本の番人「一式」と設定ファイルを上書き設置
+#         ＝入口3つ（PreToolUse=cc2_guard / PermissionRequest / Stop）と、その依存を全部置く。
+#           従来は cc2_guard.py 単体しか置かず、カードを出す係(PermissionRequest)・終わりを
+#           知らせる係(Stop)の入口が固定パスに無かった＝全現場でそれらが動けなかった（今回の根治）。
+#   (a-2) 番人の【登録はホームの ~/.claude/settings.json 1か所だけ】にする（★ADR-013）
+#         ・ホームに見本のイベント（PreToolUse / PermissionRequest / Stop）を確実に登録する。
+#           登録が無ければ見本どおり足し、古い場所を指していれば固定パスへ向け直す（①-e）。
+#         ・各現場に残っている同じ登録は【外す】（③）。ホームと現場の両方に登録されていると
+#           Claude Code は両方を走らせるので、本物の質問で確認カードが2枚出る（ADR-011 の残穴）。
+#         ★外す順序は「ホームを確立してから現場を外す」。ホームに確立できなかったイベントは
+#           現場からも外さない（＝守りが一瞬でも消えない・フェイルクローズ）。
+#   (b) 各現場の .claude/settings.json を「丸ごと上書きせず」部分マージで更新
+#         ・hooks は【外すだけ】。番人はホームに1本化したので現場には登録しない。外すのは
+#           固定パス($GUARD_HOME)の番人を指す登録だけで、顧客が足した独自フックは残す。
+#         ・permissions.deny に不足している禁止ルールだけを追記（既存は消さない）
+#         ・permissions.allow は【全削除】する。番人の既定が allow なので不要で、allow が
+#           1行でも残ると評価順(deny→ask→allow)で関門より先に素通りさせる穴になるため。
+#           ★deny は一切触らない・消さない・変えない。
+#   (b-2) ホームへ「外への通信の全許可（allowedDomains: "*"）」を1か所だけ配る（①-e3・甲）
+#         ＝この問いは管制の3ボタンでは押せないので、聞かれる前に通す。持ち出しの番人は無関係
+#           （番人は allowedDomains を参照しない）＝1ミリも緩まない。
+#         ・sandbox セクションが既に在る現場だけ、sandbox.allowUnsandboxedCommands を false へ
+#           ＝職人が Bash の dangerouslyDisableSandbox 引数でサンドボックスの外へ出る素通りを塞ぐ。
+#           sandbox が無い現場には新設しない（サンドボックス自体を有効化する事故を避ける）。
+#       ★ 番人以外の hooks／ask／その他のキーには一切触れない＝顧客が足した設定は残る。
+#       ★ deny は常に allow より先に効く（Claude Code 仕様）＝床（.env/.ssh/鍵/.tyhld/hooks や
+#         Supabase 書込3種の禁止）は allow 全削除後も当然そのまま優先される。
+#
+# 【使い方】
+#   bash scripts/update-guard.sh                 # 予定を表示するだけ（既定・書き込みなし）
+#   APPLY=1 bash scripts/update-guard.sh         # 実際に適用する
+#   APPLY=1 bash scripts/update-guard.sh ~/projects/a ~/projects/b   # 現場を明示指定
+#
+# 【安全】
+#   - 既定は DRY RUN（APPLY=1 のときだけ書き込む）
+#   - settings.json を書き換える前に必ずバックアップを取る（変更が要るときだけ）
+#   - JSON として壊れているファイルは触らずスキップして報告する
+#   - 削除するのは permissions.allow（意図的な全削除）と、現場に残った番人の登録だけ。
+#     deny は追記のみ・非改変、顧客が足した hooks・他キーは非改変
+#
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# ★配り元（GUARD_SRC_DIR / SETTINGS_SRC / SAMPLE_SETTINGS / 鉄則）は、この下の「①-src」で決める。
+#   ここ（自分の置き場）を配り元にしない＝作業ツリーから全現場へ配らない（便 4061dd71）。
+# ★1台に1箇所だけ置く場所。現場が増えても番人は増えない＝更新はここ1箇所で済む。
+GUARD_HOME="$HOME/.tyhld/hooks"
+
+APPLY="${APPLY:-0}"
+
+# ★同期モード（SYNC_ONLY=1）— 番人の【コードと配線だけ】を正本へ揃えて終わる（ADR-012）。
+#   【なぜ要るか】直しをリポジトリへ入れても、人が APPLY=1 でこのスクリプトを流すまで機体には
+#     1文字も届かない。実地で2度続けて届いていなかった:
+#       ・2026-09-02 03:37（PR #568 の報告）… ADR-008 の判定が入った番人が配られていなかった
+#       ・2026-09-02 11:04（PR #573 の報告）… ADR-011 の直し（03:56 マージ済み）も届いていなかった
+#     どちらもホームの ~/.claude/settings.json が古い写し($HOME/.tyhld/hookset)を指したままで、
+#     その写しには判定そのものが無い＝どんな報告でも確認カードを出していた。
+#   【直し方】人が忘れても届くように、この同期モードを systemd --user タイマーで1時間ごとに
+#     回す（①-f で設置）。権限(allow/ask/deny)・掃除・鉄則スキルには触れないので、無人で
+#     回しても settings.json の中身を作り変えない＝「番人のコードだけ新しく保つ」に徹する。
+#   ★同期モードが触る「配線」は2つ:（1）ホームへの登録を確立する（①-e）
+#     （2）現場に残った同じ登録を外す（③）。どちらも hooks だけで、権限には触れない。
+#     ＝すでに配ってしまった現場の二重登録も、人が何もしなくても1時間以内にそろう（ADR-013）。
+SYNC_ONLY="${SYNC_ONLY:-0}"
+
+info() { echo "[update-guard] $*"; }
+warn() { echo "[update-guard] 注意: $*" >&2; }
+fail() { echo "[update-guard] エラー: $*" >&2; exit 1; }
+
+# ─── ①-src 配り元を決める（★公開済みの正規版だけ・便 4061dd71） ──────────────
+# 【なぜ要るか（実測 2026-09-16・開発履歴 6b405ae6）】
+#   1時間ごとの自動同期の本体が /home/fshim/projects/conductor/scripts/update-guard.sh
+#   ＝★職人の【作業ツリー】を指していた。職人が番人を直しかけのブランチに居るあいだに同期が走ると、
+#   作りかけの番人がその機の【全現場】へ配られる。当日は main で変更なしだったため無事だったが、
+#   無事だったのは偶然である。
+#
+# 【えふさん確定（2026-09-16）】
+#   「① 番人の1時間自動同期 承認 29612ff1後に実施。ただし『公開済みの正規版』を唯一の配布元にする。
+#     作業treeから全現場へ配らない」
+#
+# 【どう直したか】★「作業ツリーからは配らないと言って止まる」ではなく【配り元を差し替える】を採った。
+#   えふさんの手は今までどおり APPLY=1 bash scripts/update-guard.sh のままでよく、
+#   打った台本の置き場に関わらず、★配られる中身は必ずこの機に入っている公開済みの正規版になる。
+#   「止まる」を採ると、今までどおり打ったのに何も起きない形になり、手順を覚え直すことになる。
+#
+# 【正規版でないときは黙って進まない】
+#   入っていない／版が読めない／公開 npm に聞けない／版が公開 npm の今の版と違う のどれでも、
+#   ★1バイトも配らずに終わる。失敗は控えに残し、便 29612ff1 で作った知らせ方（確認カード）に載せる。
+. "$SCRIPT_DIR/dist-source.sh"
+
+DIST_STATE="$GUARD_HOME/dist-source.state"   # 最後に【確かめられた】配り元
+DIST_LAST="$GUARD_HOME/dist-source.last"     # 直近の【試み】の結果
+DIST_NOTIFY="$SCRIPT_DIR/hooks/skill_sync_notify.py"
+
+# 直近の試みを1行残す。★確かめられたときだけ .state も更新する（成功と偽らない）。
+#   ★確認のみ（APPLY!=1）のときは1バイトも書かない。「見ただけ」で控えが動くと、
+#     控えが「実際に配った記録」でなくなり、外から見て何が起きたのか分からなくなる。
+dist_record() {
+  [[ "$APPLY" == "1" ]] || return 0
+  local status="$1" reason="$2" line
+  line="$(date '+%Y-%m-%dT%H:%M:%S%z') status=${status} reason=${reason} what=dist-source version=${DIST_VERSION:-unknown} published=${DIST_PUBLISHED:-unknown} root=${DIST_ROOT:-none}"
+  mkdir -p "$GUARD_HOME" 2>/dev/null || true
+  printf '%s\n' "$line" > "$DIST_LAST" 2>/dev/null || true
+  if [[ "$status" == "ok" ]]; then
+    printf '%s\n' "$line" > "$DIST_STATE" 2>/dev/null || true
+  fi
+}
+
+# 配り損ねを管制へ知らせる（★便 29612ff1 と同じ口・届かなくても止まらない）。
+#   ★確認のみのときは知らせない（見ただけでお客さまの画面にカードを出さない）。
+dist_notify_failure() {
+  [[ "$APPLY" == "1" ]] || return 0
+  [[ -f "$DIST_NOTIFY" ]] || return 0
+  python3 "$DIST_NOTIFY" "$DIST_LAST" >/dev/null 2>&1 || true
+}
+
+info "①-src 配り元の確認（公開済みの正規版だけを配ります）"
+if ! dist_source_resolve; then
+  warn "配り元を確かめられません（${DIST_REASON}）。★1バイトも配りません。"
+  case "$DIST_REASON" in
+    not-installed) warn "  この機に @tyhld/conductor が入っていません。" ;;
+    no-version)    warn "  入っている配布物の版が読めません。" ;;
+    unverifiable)  warn "  公開 npm のいまの版に問い合わせられません（回線・取得先）。" ;;
+    version-drift) warn "  入っている版 ${DIST_VERSION} が、公開 npm のいまの版 ${DIST_PUBLISHED} と違います。" ;;
+  esac
+  warn "  人の手番: npm install -g @tyhld/conductor --@tyhld:registry=https://registry.npmjs.org"
+  dist_record failed "$DIST_REASON"
+  dist_notify_failure
+  exit 0
+fi
+if ! dist_source_complete "$DIST_ROOT"; then
+  warn "配り元の中身が欠けています: $DIST_ROOT（★1バイトも配りません）"
+  DIST_REASON='incomplete'
+  dist_record failed incomplete
+  dist_notify_failure
+  exit 0
+fi
+info "   配り元: $DIST_ROOT（版 $DIST_VERSION ＝公開 npm のいまの版）"
+if [[ "$DIST_ROOT" != "$REPO_ROOT" ]]; then
+  info "   ★この台本の置き場（$REPO_ROOT）からは配りません。"
+fi
+dist_record ok verified
+
+# 配る中身は、すべて上で確かめた配り元から取る。
+GUARD_SRC_DIR="$DIST_ROOT/scripts/hooks"          # 番人の正本
+SETTINGS_SRC="$DIST_ROOT/sales-template/settings.json"   # 権限ルールの正本（deny の供給元）
+SAMPLE_SETTINGS="$GUARD_SRC_DIR/settings.sample.json"    # 取り寄せ先の宣言の正本（ADR-004）
+
+[[ -f "$GUARD_SRC_DIR/cc2_guard.py" ]] || fail "番人の正本が見つかりません: $GUARD_SRC_DIR/cc2_guard.py"
+[[ -f "$SETTINGS_SRC" ]] || fail "権限ルールの正本が見つかりません: $SETTINGS_SRC"
+
+if [[ "$APPLY" != "1" ]]; then
+  info "モード: 確認のみ（書き込みません）。実行するには APPLY=1 を付けてください。"
+else
+  info "モード: 適用"
+fi
+
+# ─── 同期モードの安全条件（★無人で回るので、ここだけは厳しくする） ─────────────
+# 作業中の壊れた番人を全現場へ配ると、3関門が同時に止まる／素通りする（ADR-002 の分離の要）。
+# ★2026-09-16（便 4061dd71）に、ここの守り方を【git の状態を見る】から【配り元そのものを
+#   公開済みの正規版に限る】へ移した（①-src）。
+#   ・旧＝「この作業ツリーに未コミットの変更が無ければ、この作業ツリーから配ってよい」。
+#     これは「コミットさえすれば作りかけでも全現場へ配ってよい」という意味でもあり、
+#     ★そもそも作業ツリーを配り元にしている点は直っていなかった（開発履歴 6b405ae6）。
+#   ・新＝配り元は「この機に入っている配布物で、版が公開 npm のいまの版と一致するもの」だけ。
+#     作業ツリーの中身は、コミット済みかどうかに関わらず1バイトも配られない。
+#     ＝git の作業場所でない機（お客さまの機）でも同じ判定で通る。
+if [[ "$SYNC_ONLY" == "1" ]]; then
+  info "モード: 同期のみ（番人のコードと配線だけ・権限や掃除には触れません）"
+fi
+
+# ─── ① 番人一式を固定パスへ設置（上書き＝常に最新） ───────────────────────────
+# ★見本(settings.sample.json)が呼ぶ入口3つ（PreToolUse=cc2_guard / PermissionRequest /
+#   Stop）と、そこから import で辿られる依存を【全部】固定パス $GUARD_HOME に置く。1つでも
+#   欠けると差し替えた現場の番人が読めず止まる（勤務用コピーの考え方＝ADR-002）。
+#   ★従来は cc2_guard.py 単体しか置かず、PermissionRequest / Stop の入口が固定パスに無かった
+#     ＝カードを出す係・終わりを知らせる係が全現場で動けなかった。ここで一式に広げて根治する。
+INSTALL_FILES=(
+  cc2_guard.py                # PreToolUse … 危険を止める／関門を人へ渡す
+  permission_request_hook.py  # PermissionRequest … 確認を管制へ送り答えを待つ
+  stop_hook.py                # Stop … 手が止まったことを管制へ知らせる
+  notification_hook.py        # Notification … 端末でしか押せない問いを管制へ知らせる（ADR-016）
+  policy.py                   # cc2_guard / permission_request_hook が使う判定本体
+  summary_ja.py               # permission_request_hook / stop_hook が使う日本語の文言
+  hook_datalink.py            # 各フックが使う管制との連絡線
+)
+INSTALL_CONFIGS=(safe_verbs.json network_allow.json)
+ENTRYPOINTS=(cc2_guard.py permission_request_hook.py stop_hook.py notification_hook.py)
+
+# ①-0 見本と「配る中身」がズレていないか機械照合する（今回と同じ欠落事故の再発防止＝根治）。
+#   ・見本が参照する入口スクリプトが、正本(scripts/hooks/)に在るか
+#   ・その入口が INSTALL_FILES（＝$GUARD_HOME に置かれる一式）に入っているか
+#   1つでも外れていれば「配っても現場で動かない／欠落配布」になるので、ここで止める。
+#   ★見本が無い環境（npm 配布物など settings.sample.json が同梱されない）は rc=7 で
+#     「hooks 配布はスキップ・権限整理だけ進む」を意味し、止めない（壊さない）。
+info "①-0 見本と配布内容の照合（ドリフト検査）"
+drift_out="$(INSTALL_FILES="${INSTALL_FILES[*]}" python3 - "$SAMPLE_SETTINGS" "$GUARD_SRC_DIR" <<'PYEOF'
+import json, os, sys
+
+sample_path, src_dir = sys.argv[1], sys.argv[2]
+install = set(os.environ.get("INSTALL_FILES", "").split())
+
+try:
+    sample = json.load(open(sample_path, encoding="utf-8"))
+except FileNotFoundError:
+    print("SKIP 見本が無い環境（npm 配布物など）。hooks 配布はスキップし、権限整理だけ進みます。")
+    sys.exit(7)
+except Exception as e:
+    print("FAIL 見本が JSON として読めません: %s" % e)
+    sys.exit(1)
+
+hooks = sample.get("hooks", {})
+if not isinstance(hooks, dict) or not hooks:
+    print("FAIL 見本に hooks がありません（配る対象が決められない）")
+    sys.exit(1)
+
+refs = set()
+for ev, groups in hooks.items():
+    for g in (groups or []):
+        for h in g.get("hooks", []):
+            cmd = h.get("command", "")
+            if cmd:
+                refs.add(os.path.basename(cmd.split()[-1]))
+
+missing_src = sorted(b for b in refs if not os.path.isfile(os.path.join(src_dir, b)))
+not_installed = sorted(b for b in refs if b not in install)
+if missing_src:
+    print("FAIL 見本が参照するスクリプトが正本にありません: %s" % ", ".join(missing_src))
+    sys.exit(1)
+if not_installed:
+    print("FAIL 見本が参照するスクリプトが設置一覧(INSTALL_FILES)にありません: %s" % ", ".join(not_installed))
+    print("     → ①で GUARD_HOME に置かれないため、配っても現場で動きません。INSTALL_FILES に足してください。")
+    sys.exit(1)
+print("OK 見本の %d イベント（%s）を配布。参照スクリプト %d 件はすべて設置対象です。"
+      % (len(hooks), ", ".join(hooks.keys()), len(refs)))
+PYEOF
+)" && drift_rc=0 || drift_rc=$?
+echo "$drift_out" | sed 's/^/[update-guard]    /'
+if [[ "${drift_rc:-1}" == "1" ]]; then
+  fail "見本と配布内容がズレています（上記）。見本または INSTALL_FILES を直してから再実行してください。"
+fi
+# rc=0: 見本どおり登録する／ rc=7: 見本が無いので hooks は触らない（権限整理は進む）。
+#   ★rc=7 のときは①-eも見本を読めず HOME_WIRED_EVENTS が空になる＝③は何も外さない。
+#     ＝見本が読めない環境では、現場に既にある登録をそのまま残す（守りを後退させない）。
+
+info "① 番人一式を設置: $GUARD_HOME"
+if [[ "$APPLY" == "1" ]]; then
+  # 置く前に構文を確認する。壊れた Python を固定パスへ置くと全現場が同時に止まるため。
+  if ! python3 -m py_compile "${INSTALL_FILES[@]/#/$GUARD_SRC_DIR/}"; then
+    fail "番人一式の構文確認に失敗しました。固定パスは変更していません。"
+  fi
+  mkdir -p "$GUARD_HOME"
+  for f in "${INSTALL_FILES[@]}"; do
+    cp -f "$GUARD_SRC_DIR/$f" "$GUARD_HOME/$f"
+  done
+  for e in "${ENTRYPOINTS[@]}"; do
+    chmod +x "$GUARD_HOME/$e"
+  done
+  for conf in "${INSTALL_CONFIGS[@]}"; do
+    if [[ -f "$GUARD_SRC_DIR/$conf" ]]; then
+      # 番人は「自分と同じフォルダ」の設定を読むので、必ず一緒に置く。
+      cp -f "$GUARD_SRC_DIR/$conf" "$GUARD_HOME/$conf"
+      info "   設定も設置: $GUARD_HOME/$conf"
+    fi
+  done
+  info "   完了（入口 ${#ENTRYPOINTS[@]} 件・一式 ${#INSTALL_FILES[@]} 件を設置）"
+else
+  info "   （予定）入口 ${#ENTRYPOINTS[@]} 件を含む一式 ${#INSTALL_FILES[@]} 件を上書き設置"
+fi
+
+# ─── ①-d 職人の鉄則スキルを最新へ揃える（機体1回・★同期モードでも行う） ─────────
+# 【なぜ要るか】setup.sh ⑤ は新規設置のときだけ ~/.claude/skills/ へ鉄則を置く。
+#   稼働中の機体では、リポジトリの正本を直しても職人が読むのは古い写しのままだった。
+#   ＝鉄則を直しても現場の職人の動きは変わらない（2026-09-01、鉄則8のPlaywright作法を
+#     直した便で判明。ADR-010）。ここで setup.sh ⑤ と同じ配置を「更新側」にも用意する。
+# ★番人と同じく「1台に1箇所」（$HOME/.claude/skills）。現場ごとの写しは作らない。
+#
+# 【★2026-09-16 に同期モードへ入れた理由（えふさん確定・便 29612ff1）】
+#   1時間ごとの自動同期は SYNC_ONLY=1 で走り、ここを飛ばしていた。そのため
+#   「番人のコードは1時間で届くのに、鉄則だけは人が APPLY=1 を打つまで届かない」状態が
+#   毎時再生産されていた（便 4a5bbb9f で実測。鉄則7を直したのに現場の職人は古い文のまま）。
+#   鉄則は安全境界ではなく作業規律だが、★古いまま気づけないことが事故の元なので自動で配る。
+#
+# 【★配り損ねたら黙って進まない】
+#   正本が無い・中身が空・書けない のどれでも、
+#     ① 最後の成功の控え（.state）は【書き換えない】＝成功と偽らない
+#     ② 直近の試みの結果（.last）に失敗として残す
+#     ③ 管制へ知らせる（skill_sync_notify.py）
+#   ＝「古い鉄則のまま動いている」ことが、機体の外から分かる。
+CRAFTSMAN_SKILL_SRC="$DIST_ROOT/skills/conductor-craftsman/SKILL.md"
+CRAFTSMAN_SKILL_DST="$HOME/.claude/skills/conductor-craftsman/SKILL.md"
+# ★控えは番人の置き場に置く（職人は $HOME/.tyhld へ書けない＝あとから書き換えられない）。
+CRAFTSMAN_STATE="$GUARD_HOME/craftsman-skill.state"   # 最後に【成功した】配布
+CRAFTSMAN_LAST="$GUARD_HOME/craftsman-skill.last"     # 直近の【試み】の結果
+CRAFTSMAN_NOTIFY="$SCRIPT_DIR/hooks/skill_sync_notify.py"
+
+# 版＝この正本が入っている配布物の版（package.json）。無ければ unknown。
+craftsman_skill_version() {
+  local pj="$DIST_ROOT/package.json"
+  [[ -f "$pj" ]] || { printf 'unknown'; return; }
+  python3 -c 'import json,sys
+try:
+    print(json.load(open(sys.argv[1], encoding="utf-8")).get("version") or "unknown")
+except Exception:
+    print("unknown")' "$pj" 2>/dev/null || printf 'unknown'
+}
+
+# 中身の見分け（先頭12文字）。★版が同じでも中身が違えば分かる。
+craftsman_skill_sha() {
+  [[ -f "$1" ]] || { printf 'none'; return; }
+  sha256sum "$1" 2>/dev/null | cut -c1-12 || printf 'none'
+}
+
+# 直近の試みの結果を1行残す。★成功のときだけ .state も更新する。
+craftsman_record() {
+  local status="$1" reason="$2" ver="$3" sha="$4"
+  local line
+  line="$(date '+%Y-%m-%dT%H:%M:%S%z') status=${status} reason=${reason} version=${ver} sha=${sha} src=${CRAFTSMAN_SKILL_SRC} dst=${CRAFTSMAN_SKILL_DST}"
+  mkdir -p "$GUARD_HOME" 2>/dev/null || true
+  printf '%s\n' "$line" > "$CRAFTSMAN_LAST" 2>/dev/null || true
+  if [[ "$status" == "ok" ]]; then
+    printf '%s\n' "$line" > "$CRAFTSMAN_STATE" 2>/dev/null || true
+  fi
+}
+
+# 配り損ねを管制へ知らせる（★届かなくても同期は止めない）。
+craftsman_notify_failure() {
+  [[ -f "$CRAFTSMAN_NOTIFY" ]] || return 0
+  python3 "$CRAFTSMAN_NOTIFY" "$CRAFTSMAN_LAST" >/dev/null 2>&1 || true
+}
+
+info "①-d 職人の鉄則スキル: $CRAFTSMAN_SKILL_DST"
+CRAFTSMAN_VER="$(craftsman_skill_version)"
+CRAFTSMAN_SHA="$(craftsman_skill_sha "$CRAFTSMAN_SKILL_SRC")"
+if [[ ! -f "$CRAFTSMAN_SKILL_SRC" ]]; then
+  warn "鉄則の正本が見つかりません: $CRAFTSMAN_SKILL_SRC（★古い鉄則のまま動きます）"
+  craftsman_record failed src-missing "$CRAFTSMAN_VER" none
+  craftsman_notify_failure
+elif [[ ! -s "$CRAFTSMAN_SKILL_SRC" ]]; then
+  warn "鉄則の正本が空です: $CRAFTSMAN_SKILL_SRC（★古い鉄則のまま動きます）"
+  craftsman_record failed src-empty "$CRAFTSMAN_VER" none
+  craftsman_notify_failure
+elif cmp -s "$CRAFTSMAN_SKILL_SRC" "$CRAFTSMAN_SKILL_DST" 2>/dev/null; then
+  info "   最新です（版 ${CRAFTSMAN_VER} / 中身 ${CRAFTSMAN_SHA}）"
+  craftsman_record ok already-current "$CRAFTSMAN_VER" "$CRAFTSMAN_SHA"
+elif [[ "$APPLY" == "1" ]]; then
+  if mkdir -p "$(dirname "$CRAFTSMAN_SKILL_DST")" 2>/dev/null \
+     && cp -f "$CRAFTSMAN_SKILL_SRC" "$CRAFTSMAN_SKILL_DST" 2>/dev/null \
+     && cmp -s "$CRAFTSMAN_SKILL_SRC" "$CRAFTSMAN_SKILL_DST" 2>/dev/null; then
+    info "   更新しました（版 ${CRAFTSMAN_VER} / 中身 ${CRAFTSMAN_SHA}・この1台の全現場が共有します）"
+    craftsman_record ok applied "$CRAFTSMAN_VER" "$CRAFTSMAN_SHA"
+  else
+    warn "鉄則を配れませんでした: $CRAFTSMAN_SKILL_DST（★古い鉄則のまま動きます）"
+    craftsman_record failed write-failed "$CRAFTSMAN_VER" "$CRAFTSMAN_SHA"
+    craftsman_notify_failure
+  fi
+else
+  info "   （予定）正本の内容へ揃えます（版 ${CRAFTSMAN_VER} / 中身 ${CRAFTSMAN_SHA}）"
+fi
+
+# ★同期モードは ①-b・①-c・①-d2 を飛ばす（掃除・タイマー・pnpm 点検は「番人のコード」ではない）。
+#   ★鉄則スキル（①-d）は上で【同期モードでも】行う（便 29612ff1）。
+#   飛ばす分は、人が APPLY=1 で通常どおり流したときに従来どおり行われる。
+if [[ "$SYNC_ONLY" == "1" ]]; then
+  info "①-b・①-c・①-d2 は省略（同期モード）"
+else
+
+# ─── ①-b paste-cache の掃除（機体1回・現場ループの外） ──────────────────────────
+# 画面貼り付け由来の一時ファイルが ~/.claude/paste-cache に平文で溜まる（秘密を含み得る）。
+# 古い分だけ消す。今日ぶん（未送信・参照中かもしれない分）は mtime で残す＝全消しはしない。
+# ★触るのは ~/.claude/paste-cache だけ。件数のみ報告し、中身・ファイル名は出さない。
+PASTE_CACHE_DIR="$HOME/.claude/paste-cache"
+PASTE_CACHE_KEEP_DAYS="${PASTE_CACHE_KEEP_DAYS:-1}"
+info "①-b paste-cache 掃除: $PASTE_CACHE_DIR（$PASTE_CACHE_KEEP_DAYS 日より古い分）"
+if [[ -d "$PASTE_CACHE_DIR" ]]; then
+  # 件数のみ数える（-mindepth/-maxdepth 1 でこのフォルダ直下のファイルに限定）。
+  pc_count="$(find "$PASTE_CACHE_DIR" -mindepth 1 -maxdepth 1 -type f -mtime +"$PASTE_CACHE_KEEP_DAYS" 2>/dev/null | wc -l)"
+  if [[ "$APPLY" == "1" ]]; then
+    find "$PASTE_CACHE_DIR" -mindepth 1 -maxdepth 1 -type f -mtime +"$PASTE_CACHE_KEEP_DAYS" -delete 2>/dev/null || true
+    info "   $pc_count 件を削除しました"
+  else
+    info "   （予定）$pc_count 件を削除します（今は消しません）"
+  fi
+else
+  info "   paste-cache は未作成のためスキップ"
+fi
+
+# ─── ①-c 毎日自動掃除タイマーを設置（顧客機は手動で回さないため必須） ──────────
+# 恒久策の本体。setup.sh（新規機）と同じ installer を APPLY 時に呼ぶ（冪等）。
+PRUNE_INSTALL="$DIST_ROOT/sales-template/systemd/paste-cache-prune-install.sh"
+info "①-c 毎日自動掃除タイマー: tyhld-paste-cache-prune.timer"
+if [[ "$APPLY" == "1" ]]; then
+  if [[ -f "$PRUNE_INSTALL" ]]; then
+    bash "$PRUNE_INSTALL" || warn "自動掃除タイマーの設置に失敗しました（掃除自体は上の①-bで実施済み）"
+  else
+    warn "installer が見つかりません: $PRUNE_INSTALL（タイマー設置をスキップ）"
+  fi
+else
+  info "   （予定）systemd --user タイマーを enable --now します"
+fi
+
+# ─── ①-d2 pnpm の版そろえ（corepack）を確かめる（機体1回・現場ループの外・ADR-015） ────
+# 【なぜ要るか】実機 2026-09-02: TYHLD-platform で pnpm を使うと
+#     [ERR_PNPM_UNSUPPORTED_ENGINE] Expected version: >=10.0.0 <11.0.0 ／ Got: 11.0.9
+#   で弾かれ、毎回 `npx --yes pnpm@10 …` と打っていた（毎回ダウンロード＝遅い・打ち間違う）。
+#   仕組みとしては corepack が package.json の packageManager を読んで正しい版を使うので、
+#   ★corepack のシムさえ在れば「pnpm と打つだけ」で正しい版になる（実測: 現場の中では 10.33.4）。
+#   逆に【シムが無い機体】では pnpm 自体が無い／別物になり、同じ事故が起きる。そこを点検する。
+# 【やること】
+#   ・corepack の pnpm シムが在るか点検し、無ければ APPLY のときだけ `corepack enable` で作る
+#   ・pnpm を使うのに packageManager の指定が無い現場を【一覧で報告するだけ】（勝手に足さない。
+#     どの版が正かは、そのリポジトリの持ち主が決めることなので AI は書き換えない）
+# ★ここは作業道具の話であって安全境界ではないので、失敗しても中断しない（警告して進む）。
+info "①-d2 pnpm の版そろえ（corepack）"
+if ! command -v corepack >/dev/null 2>&1; then
+  warn "corepack が見つかりません（Node に同梱。Node を入れ直すと直ります）"
+elif command -v pnpm >/dev/null 2>&1; then
+  info "   pnpm は使えます（$(command -v pnpm)）"
+elif [[ "$APPLY" == "1" ]]; then
+  if corepack enable >/dev/null 2>&1; then
+    info "   corepack enable を実行しました（これで pnpm と打つだけで正しい版になります）"
+  else
+    warn "corepack enable に失敗しました（人の手番: corepack enable。sudo が要る機体もあります）"
+  fi
+else
+  info "   （予定）corepack enable を実行します"
+fi
+# pnpm を使うのに版の指定が無い現場を挙げる（読むだけ・書き換えない）。
+PNPM_NO_PIN="$(python3 - "$HOME/projects" <<'PYEOF'
+import json, os, sys
+
+root = sys.argv[1]
+out = []
+if os.path.isdir(root):
+    for name in sorted(os.listdir(root)):
+        proj = os.path.join(root, name)
+        pkg = os.path.join(proj, "package.json")
+        if not os.path.isfile(pkg):
+            continue
+        uses_pnpm = any(os.path.exists(os.path.join(proj, f))
+                        for f in ("pnpm-lock.yaml", "pnpm-workspace.yaml"))
+        if not uses_pnpm:
+            continue
+        try:
+            with open(pkg, encoding="utf-8") as f:
+                if not (json.load(f).get("packageManager") or "").strip():
+                    out.append(name)
+        except Exception:  # noqa: BLE001
+            continue
+print(" ".join(out))
+PYEOF
+)"
+if [[ -n "$PNPM_NO_PIN" ]]; then
+  warn "pnpm を使うのに packageManager の指定が無い現場: $PNPM_NO_PIN"
+  info "   → その現場では既定の新しい pnpm が動きます。持ち主が package.json へ"
+  info "      \"packageManager\": \"pnpm@<いま使っている版>\" を足してください（ここでは書き換えません）"
+else
+  info "   pnpm を使う現場はすべて版が指定されています"
+fi
+
+fi  # ← ①-b〜①-d2 ここまで（同期モードでは丸ごと省略）
+
+# ─── ①-e ホームの設定が「古い番人」を指していないか直す（機体1回・現場ループの外） ────
+# 【なぜ要るか（★今回の根本原因・ADR-011）】
+#   番人は現場ごとの .claude/settings.json だけでなく、ホームの ~/.claude/settings.json にも
+#   登録できる。Claude Code は【両方】のフックを走らせる。ところがこのスクリプトは②で
+#   ~/projects 配下の現場しか見ていなかったため、ホーム側が別の場所（実機では
+#   $HOME/.tyhld/hookset/）を指したまま置き去りになっていた。
+#   その写しは 2026-08-23 のもので、確認カードを出すかどうかの判定（ADR-008）が【入っていない】。
+#   ＝正しい判定を入れた新しい番人と、判定の無い古い番人が同居し、古い方がカードを出していた。
+#   実機 2026-09-02 03:37「PR #568 を作成し…CI の完了を待っています。」というただの報告で
+#   「担当者から質問があります」のカードが出た事故は、これが原因（ADR-011 に調査の記録）。
+#
+# 【やること（★ADR-013 で拡張）】ホームを番人の【唯一の登録場所】として確立する。
+#   ・見本のイベントの登録が無ければ、見本どおり足す（登録場所が1か所になるので、ここが
+#     欠けると守りが丸ごと消える。従来は「あるものを向け直す」だけで、足りない分は放置だった）
+#   ・登録があれば、コマンドのパスだけ固定パス $GUARD_HOME へ向け直す
+#   ★permissions（allow/ask/deny）にも、他のイベントにも、他のキーにも一切触れない
+#     （現場向けの④とは別扱い＝ホームの設定は全現場に効くので最小限にする）。
+# ★これで「古い写しが動き続ける」を構造的に断つ。写し自体は消さない（人が確認してから消せる）。
+# ★ここで確立できたイベントだけを、③で現場から外す（フェイルクローズ＝守りを一瞬も空けない）。
+HOME_SETTINGS="$HOME/.claude/settings.json"
+HOME_WIRED_FILE="$(mktemp)"
+trap 'rm -f "$HOME_WIRED_FILE"' EXIT
+info "①-e ホームの番人の配線（★ここだけが登録場所）: $HOME_SETTINGS"
+if [[ ! -f "$HOME_SETTINGS" ]]; then
+  warn "ホームの設定がありません: $HOME_SETTINGS（現場の登録は外しません＝守りを空けない）"
+else
+  APPLY="$APPLY" GUARD_HOME="$GUARD_HOME" HOME_WIRED_FILE="$HOME_WIRED_FILE" \
+  python3 - "$HOME_SETTINGS" "$SAMPLE_SETTINGS" <<'PYEOF'
+import json, os, shutil, sys, time
+
+dst_path, sample_path = sys.argv[1], sys.argv[2]
+apply_mode = os.environ.get("APPLY") == "1"
+guard_home = os.environ["GUARD_HOME"]
+wired_file = os.environ.get("HOME_WIRED_FILE", "")
+
+def load(p):
+    with open(p, encoding="utf-8") as f:
+        return json.load(f)
+
+try:
+    dst = load(dst_path)
+except Exception as e:
+    print(f"[update-guard] 注意: JSON として読めないので触りません: {dst_path} ({e})", file=sys.stderr)
+    sys.exit(0)
+
+# 登録するイベントは見本が正（④と同じ考え方）。見本が無い環境では何もしない。
+try:
+    sample_hooks = load(sample_path).get("hooks") or {}
+except Exception:
+    sample_hooks = {}
+if not sample_hooks:
+    print("[update-guard]    見本が読めないため配線の点検はスキップします")
+    sys.exit(0)
+
+def wired_ok():
+    """ここまでで確立できたイベント名を③へ渡す（★これが無い＝現場から外さない）。"""
+    if wired_file:
+        with open(wired_file, "w", encoding="utf-8") as f:
+            f.write(" ".join(sorted(sample_hooks)))
+
+def to_fixed_path(cmd):
+    # "python3 /どこか/xxx.py" → "python3 <GUARD_HOME>/xxx.py"
+    parts = cmd.split()
+    parts[-1] = os.path.join(guard_home, os.path.basename(parts[-1]))
+    return " ".join(parts)
+
+hooks = dst.get("hooks")
+if not isinstance(hooks, dict):
+    hooks = {}
+
+changed = []
+for ev in sorted(sample_hooks):
+    groups = hooks.get(ev)
+    has_cmd = isinstance(groups, list) and any(
+        isinstance(h, dict) and isinstance(h.get("command"), str) and h["command"].strip()
+        for g in groups if isinstance(g, dict) for h in (g.get("hooks") or []))
+    if not has_cmd:
+        # ★登録が無い／空。ホームが唯一の登録場所なので、ここで見本どおり足す。
+        new_groups = []
+        for g in (sample_hooks[ev] or []):
+            ng = dict(g)
+            ng["hooks"] = [
+                {**h, "command": to_fixed_path(h["command"])}
+                if isinstance(h, dict) and isinstance(h.get("command"), str) and h["command"].strip() else h
+                for h in (g.get("hooks") or [])
+            ]
+            new_groups.append(ng)
+        hooks[ev] = new_groups
+        changed.append(f"{ev}: 登録が無いので見本どおり追加（→ {guard_home}）")
+        continue
+    for group in groups:
+        for h in (group.get("hooks") or []):
+            cmd = h.get("command")
+            if not isinstance(cmd, str) or not cmd.strip():
+                continue
+            parts = cmd.split()
+            old = parts[-1]
+            new = os.path.join(guard_home, os.path.basename(old))
+            if old == new:
+                continue
+            parts[-1] = new
+            h["command"] = " ".join(parts)
+            changed.append(f"{ev}: {os.path.dirname(old) or '(相対)'} → {guard_home}")
+dst["hooks"] = hooks
+
+if not changed:
+    print("[update-guard]    最新です（見本の全イベントが固定パスを指しています）")
+    wired_ok()
+    sys.exit(0)
+
+print("[update-guard]    ★ホームの配線を直します（ここが番人の唯一の登録場所）")
+for c in changed:
+    print(f"[update-guard]      - {c}")
+if not apply_mode:
+    wired_ok()  # 予定として③に渡す（この実行では何も書かない）
+    sys.exit(0)
+
+backup = f"{dst_path}.bak.{time.strftime('%Y%m%d-%H%M%S')}"
+shutil.copy2(dst_path, backup)
+tmp = dst_path + ".tmp"
+with open(tmp, "w", encoding="utf-8") as f:
+    json.dump(dst, f, indent=2, ensure_ascii=False)
+    f.write("\n")
+os.replace(tmp, dst_path)
+print(f"[update-guard]      直しました（バックアップ: {backup}）")
+wired_ok()  # ★書き込みが成功したときだけ確立とみなす
+PYEOF
+fi
+HOME_WIRED_EVENTS="$(cat "$HOME_WIRED_FILE" 2>/dev/null || true)"
+if [[ -z "$HOME_WIRED_EVENTS" ]]; then
+  warn "ホームに番人を確立できませんでした。現場の登録は外しません（守りを空けない）"
+fi
+
+# ─── ①-e2 Codex の職人にも番人を登録する（★ADR-022） ────────────────────────
+# 【なぜ要るか】Codex を職人にした現場では、登録先が Claude と別（~/.codex/hooks.json）。
+#   ここを配らないと「番人の効かない職人」が動く。ADR-021 で種類を足した時点の残穴。
+# 【安全の要（実測 2026-09-02・codex 0.152.1）】
+#   ・PreToolUse は Claude とまったく同じ形の JSON で deny を返せる（実機で遮断を確認）
+#   ・PermissionRequest / Stop も同じ項目名で呼ばれる
+#   ・★Notification は存在しない＝ADR-016 の「端末でしか押せない問い」は Codex では出せない
+# ★Claude 側（①-e）には一切触れない。Codex を使っていない機体では何もしない。
+info "①-e2 Codex の職人への番人登録"
+CODEX_HOOK_INSTALL="$SCRIPT_DIR/hooks/install-codex-hooks.sh"
+if [[ -f "$CODEX_HOOK_INSTALL" ]]; then
+  APPLY="$APPLY" GUARD_HOME="$GUARD_HOME" bash "$CODEX_HOOK_INSTALL" \
+    || warn "Codex への番人登録に失敗しました（Claude 側の設置は完了しています）"
+else
+  warn "Codex 用の登録スクリプトが見つかりません: $CODEX_HOOK_INSTALL（スキップ）"
+fi
+
+# ─── ①-e3 外への通信の全許可をホームへ配る（★えふさん決定 2026-09-03＝甲） ──────
+# 【なぜホームなのか】サンドボックスの許可ホスト一覧は「ホーム・現場・フラグ」の全設定源を
+#   合算して作られる（実測 2026-09-03: ホームにだけ "*" を置いた状態で、sandbox セクションを
+#   持たない現場から通信できた）。④の現場向け追記は「sandbox セクションが既に在る現場」しか
+#   対象にしないので、conductor のように sandbox を持たない現場には届かない。
+#   ★ホーム1か所に置けば、現場が増えても全部に効く（番人の登録と同じ「1台1箇所」の形）。
+#
+# 【なぜ全部通すのか】通信許可の問い（Network request outside of sandbox）は★管制の3ボタンでは
+#   押せない。Claude Code 2.1.258 本体でこの問いは PermissionRequest フックに繋がっておらず、
+#   答えられるのは端末のダイアログか Anthropic 公式のリモート操作だけ（実測 2026-09-03・便
+#   622e5497）。＝人の目が無い現場では職人が止まったままになる。止めても止めなくても最後は人が
+#   PR の結果を見て直すので、途中で止める意味が無い（えふさん決定）。
+#
+# 【★緩むのは「電話をかける」だけ】秘密の持ち出しを止めるのは番人(cc2_guard.py + policy.py)の
+#   「対象と作用」判定で、通信の設定とは別の仕組み。番人は allowedDomains を1文字も参照して
+#   いない（test/network-always-allow.test.ts が独立を機械で固定）。deny の一覧も一切触らない。
+#   deniedDomains は allowedDomains より先に判定されるので、本番DB直結の禁止も効いたまま。
+#
+# ★触るのは sandbox.network.allowedDomains ただ1つ。hooks・permissions・他のキーには触れない。
+# ★追加のみ（既存の宣言は消さない）・冪等（2回流しても差分は出ない）。
+# ★同期モード（無人・1時間ごと）では行わない。許可の範囲を広げる変更は、人が見ているときだけ
+#   にする（同期モードの約束＝番人のコードと配線だけを揃え、設定の中身は作り変えない）。
+info "①-e3 外への通信の全許可をホームへ配る: $HOME_SETTINGS"
+if [[ "$SYNC_ONLY" == "1" ]]; then
+  info "   省略（同期モード。人が APPLY=1 で流したときだけ配ります）"
+elif [[ ! -f "$HOME_SETTINGS" ]]; then
+  warn "ホームの設定がありません: $HOME_SETTINGS（通信の全許可は配れません）"
+else
+  APPLY="$APPLY" python3 - "$HOME_SETTINGS" "$SAMPLE_SETTINGS" <<'PYEOF'
+import json, os, shutil, sys, time
+
+dst_path, sample_path = sys.argv[1], sys.argv[2]
+apply_mode = os.environ.get("APPLY") == "1"
+
+def load(p):
+    with open(p, encoding="utf-8") as f:
+        return json.load(f)
+
+try:
+    dst = load(dst_path)
+except Exception as e:
+    print(f"[update-guard] 注意: JSON として読めないので触りません: {dst_path} ({e})", file=sys.stderr)
+    sys.exit(0)
+
+# 配る中身は見本(settings.sample.json)が正。見本が読めない環境では何もしない（壊さない）。
+try:
+    want = load(sample_path).get("sandbox", {}).get("network", {}).get("allowedDomains", [])
+except Exception:
+    want = []
+want = [x for x in want if isinstance(x, str)]
+if not want:
+    print("[update-guard]    見本が読めない／宣言が空のためスキップします")
+    sys.exit(0)
+
+net = dst.setdefault("sandbox", {}).setdefault("network", {})
+cur = net.get("allowedDomains")
+if not isinstance(cur, list):
+    cur = []
+missing = [x for x in want if x not in cur]
+if not missing:
+    print("[update-guard]    最新です（変更なし）")
+    sys.exit(0)
+
+net["allowedDomains"] = cur + missing
+print(f"[update-guard]    ★通信の宣言を {len(missing)} 件追記します: {', '.join(missing)}")
+if "*" in missing:
+    print("[update-guard]      （\"*\" ＝外への通信は全部通す。秘密の持ち出しは番人が別に止めます）")
+if not apply_mode:
+    sys.exit(0)
+
+backup = f"{dst_path}.bak.{time.strftime('%Y%m%d-%H%M%S')}"
+shutil.copy2(dst_path, backup)
+tmp = dst_path + ".tmp"
+with open(tmp, "w", encoding="utf-8") as f:
+    json.dump(dst, f, indent=2, ensure_ascii=False)
+    f.write("\n")
+os.replace(tmp, dst_path)
+print(f"[update-guard]      追記しました（バックアップ: {backup}）")
+PYEOF
+fi
+
+# ─── ①-f 「直したのに届かない」を無くす自動同期タイマー（★ADR-012 の本体） ──────
+# 【なぜ要るか】ここまでの ① と ①-e は、人がこのスクリプトを流したときにしか動かない。
+#   実地では2度続けて流されず、直した番人が機体に1文字も届かないまま何時間も誤ったカードが
+#   出続けた（2026-09-02 03:37 と 11:04）。人が忘れる前提で設計し直す。
+# 【何をするか】SYNC_ONLY=1 APPLY=1 でこのスクリプトを1時間ごとに回す systemd --user
+#   タイマーを設置する。番人のコードと配線だけが自動で最新になる（権限も掃除も触らない）。
+# ★①-c（paste-cache の掃除タイマー）と同じ流儀。APPLY のときだけ設置する。
+GUARD_SYNC_INSTALL="$DIST_ROOT/systemd/guard-sync-install.sh"
+info "①-f 番人の自動同期タイマー: tyhld-guard-sync.timer"
+if [[ "$APPLY" == "1" ]]; then
+  if [[ -f "$GUARD_SYNC_INSTALL" ]]; then
+    bash "$GUARD_SYNC_INSTALL" || warn "自動同期タイマーの設置に失敗しました（手で流せば従来どおり最新になります）"
+  else
+    warn "installer が見つかりません: $GUARD_SYNC_INSTALL（タイマー設置をスキップ）"
+  fi
+else
+  info "   （予定）1時間ごとに番人のコードと配線だけを揃えるタイマーを enable --now します"
+fi
+
+# ─── ② 対象の現場を決める ───────────────────────────────────────────────────
+# ★同期モードでもここまで来る。現場の二重登録を外す（③）のは「番人の配線」であって
+#   権限ルールではないため（ADR-013）。権限の整理は④＝同期モードでは行わない。
+targets=()
+if [[ $# -gt 0 ]]; then
+  targets=("$@")
+else
+  # 引数が無ければ ~/projects/*/.claude/settings.json を持つ現場を自動で探す。
+  while IFS= read -r s; do
+    targets+=("$(cd "$(dirname "$(dirname "$s")")" && pwd)")
+  done < <(find "$HOME/projects" -maxdepth 3 -path '*/.claude/settings.json' -type f 2>/dev/null | sort)
+fi
+
+if [[ ${#targets[@]} -eq 0 ]]; then
+  info "② 対象の現場が見つかりませんでした（settings.json を持つ現場なし）。番人の設置だけ行いました。"
+  exit 0
+fi
+info "② 対象の現場: ${#targets[@]} 件"
+
+# ─── ③ 現場に残った番人の登録を外す（★ADR-013・hooks だけ・同期モードでも行う） ────
+# 【なぜ要るか】番人はホームと現場の【両方】に登録でき、Claude Code は両方を走らせる。
+#   これまでは片方（ホーム）が古い写しを指して壊れていたため結果的にカードは1枚だったが、
+#   ADR-012 で両方が直った今は、本物の質問で同じカードが2枚出る（ADR-011 の残穴）。
+# 【決定】登録はホーム1か所だけにする。新しい現場が増えても自動で効き、「片方だけ古い」
+#   事故も起きない。現場ごとに番人を変える運用予定は無い（えふさん決定 2026-09-02）。
+# 【安全】外すのは①-eでホームに確立できたイベントだけ。確立できていなければ1つも外さない。
+#   また外すのは番人の入口スクリプトを呼ぶ登録だけで、顧客が足した独自フックは残す。
+# ★触るのは hooks だけ。permissions（deny/ask/allow）には一切触れない＝守りは1ミリも動かない。
+info "③ 現場の二重登録を外す（登録はホーム1か所だけにする）"
+if [[ -z "$HOME_WIRED_EVENTS" ]]; then
+  info "   見送りました（ホームに番人を確立できていないため・上の①-e を参照）"
+else
+  info "   対象イベント: $HOME_WIRED_EVENTS"
+  for proj in "${targets[@]}"; do
+    dst="$proj/.claude/settings.json"
+    [[ -f "$dst" ]] || continue
+    APPLY="$APPLY" HOME_WIRED_EVENTS="$HOME_WIRED_EVENTS" \
+    ENTRYPOINTS="${ENTRYPOINTS[*]}" python3 - "$dst" <<'PYEOF'
+import json, os, shutil, sys, time
+
+dst_path = sys.argv[1]
+apply_mode = os.environ.get("APPLY") == "1"
+events = os.environ.get("HOME_WIRED_EVENTS", "").split()
+entrypoints = set(os.environ.get("ENTRYPOINTS", "").split())
+
+try:
+    with open(dst_path, encoding="utf-8") as f:
+        dst = json.load(f)
+except Exception as e:
+    print(f"[update-guard] 注意: JSON として読めないので触りません: {dst_path} ({e})", file=sys.stderr)
+    sys.exit(0)
+
+hooks = dst.get("hooks")
+if not isinstance(hooks, dict) or not hooks:
+    sys.exit(0)
+
+def is_ours(entry):
+    """番人の入口スクリプト(cc2_guard/permission_request_hook/stop_hook)を呼ぶ登録か。
+    ★場所は問わない。古い写し（$HOME/.tyhld/hookset など）を指す登録も同じ二重登録なので
+      まとめて外す。顧客が足した独自フックは名前が違うので残る。"""
+    if not isinstance(entry, dict):
+        return False
+    cmd = entry.get("command")
+    if not isinstance(cmd, str) or not cmd.strip():
+        return False
+    return os.path.basename(cmd.split()[-1]) in entrypoints
+
+removed = []
+for ev in events:
+    groups = hooks.get(ev)
+    if not isinstance(groups, list):
+        continue
+    kept_groups = []
+    for g in groups:
+        if not isinstance(g, dict):
+            kept_groups.append(g)
+            continue
+        entries = g.get("hooks") or []
+        keep = [h for h in entries if not is_ours(h)]
+        if len(keep) != len(entries):
+            removed.append(ev)
+        if keep:
+            ng = dict(g)
+            ng["hooks"] = keep
+            kept_groups.append(ng)
+        elif not entries:
+            kept_groups.append(g)
+    if kept_groups:
+        hooks[ev] = kept_groups
+    else:
+        del hooks[ev]
+
+if not removed:
+    sys.exit(0)
+if hooks:
+    dst["hooks"] = hooks
+else:
+    dst.pop("hooks", None)  # 空の hooks は残さない
+
+print(f"[update-guard]   二重登録あり: {dst_path}")
+print(f"[update-guard]     - 外す: {', '.join(sorted(set(removed)))}（ホーム側だけを残す）")
+if not apply_mode:
+    sys.exit(0)
+
+backup = f"{dst_path}.bak.{time.strftime('%Y%m%d-%H%M%S')}"
+shutil.copy2(dst_path, backup)
+tmp = dst_path + ".tmp"
+with open(tmp, "w", encoding="utf-8") as f:
+    json.dump(dst, f, indent=2, ensure_ascii=False)
+    f.write("\n")
+os.replace(tmp, dst_path)
+print(f"[update-guard]     外しました（バックアップ: {backup}）")
+PYEOF
+  done
+fi
+
+# ★同期モードはここで終わり（この先は権限ルールの整理＝人が見ている時だけ行う）。
+if [[ "$SYNC_ONLY" == "1" ]]; then
+  echo
+  info "同期のみ完了しました（番人のコードと配線を正本へ揃えました）。"
+  exit 0
+fi
+
+# ─── ④ 各現場の権限ルールを部分マージで更新 ─────────────────────────────────
+for proj in "${targets[@]}"; do
+  dst="$proj/.claude/settings.json"
+  if [[ ! -f "$dst" ]]; then
+    warn "  スキップ（settings.json なし）: $proj"
+    continue
+  fi
+  APPLY="$APPLY" \
+  python3 - "$dst" "$SETTINGS_SRC" "$SAMPLE_SETTINGS" <<'PYEOF'
+import json, os, shutil, sys, time
+
+dst_path, src_path, sample_path = sys.argv[1], sys.argv[2], sys.argv[3]
+apply_mode = os.environ.get("APPLY") == "1"
+
+def load(p):
+    with open(p, encoding="utf-8") as f:
+        return json.load(f)
+
+try:
+    dst = load(dst_path)
+except Exception as e:
+    print(f"[update-guard] 注意: JSON として読めないので触りません: {dst_path} ({e})", file=sys.stderr)
+    sys.exit(0)
+src = load(src_path)
+
+# 見本(settings.sample.json)を1回だけ読む。無い環境（npm 配布物など）では None にして壊さない。
+_sample = None
+try:
+    _sample = load(sample_path)
+except Exception:
+    _sample = None
+
+# 信頼できる部品取り寄せ先（settings.sample.json が正の一覧）。
+sample_trusted_domains = []
+if isinstance(_sample, dict):
+    _sd = _sample.get("sandbox", {}).get("network", {}).get("allowedDomains", [])
+    if isinstance(_sd, list):
+        sample_trusted_domains = [x for x in _sd if isinstance(x, str)]
+
+changes = []
+
+# --- (1) hooks には触れない（★ADR-013） ---
+# 番人の登録はホーム1か所だけ（①-e）。現場に残っていた登録は③で外すので、ここでは
+# hooks を一切読み書きしない。顧客が足した独自フックもそのまま残る。
+
+# --- (2) permissions.deny の不足分を追記（追加のみ・削除しない） ---
+perms = dst.setdefault("permissions", {})
+cur = perms.get("deny")
+if not isinstance(cur, list):
+    cur = []
+want = src.get("permissions", {}).get("deny", [])
+missing = [r for r in want if r not in cur]
+if missing:
+    perms["deny"] = cur + missing
+    changes.append(f"禁止ルールを {len(missing)} 件追記")
+
+# --- (2b) permissions.allow を「全削除」する（★deny は一切触らない） ---
+# 【なぜ消すのか】番人(cc2_guard)の既定が allow（危険と関門だけを deny/ask に載せ、それ以外は
+#   委譲＝素通り）になったので、settings 側に allow を持つ必要がもう無い。むしろ allow が
+#   1行でも残っていると、Claude Code の評価順（deny → ask → allow）で、その行に当たった操作は
+#   番人の判定より先に allow で確定してしまい、関門（管制のカード）に載る前に素通りする。
+#   ＝allow は「関門を素通りさせる穴」になっている。だから現場から allow を丸ごと外す。
+# ★deny は絶対に触らない・消さない・変えない（.env/.ssh/鍵/.tyhld/settings.json/hooks や
+#   Supabase の書込3種などの禁止は allow 削除後も当然そのまま効き続ける）。
+# ★冪等: allow キーが無ければ何もしない（2回流しても差分は出ない）。
+if "allow" in perms:
+    n = len(perms["allow"]) if isinstance(perms.get("allow"), list) else "?"
+    del perms["allow"]
+    changes.append(f"permissions.allow を全削除（{n} 件・関門素通りの原因を除去。deny は非改変）")
+
+# --- (3) サンドボックスのネット許可の不足分を追記 ---
+# 職人が通信するたびに Claude Code のサンドボックスが「Network request outside of sandbox」を
+# 聞いてくる。これは番人(cc2_guard)の判定とは別の OS レベルのゲートなので、番人では消えない。
+# ★2026-09-03（甲）以降、見本の宣言は "*"（外への通信は全部通す）。この問いは管制の3ボタンでは
+#   押せず、人の目が無いと職人が止まったままになるため（実測・便 622e5497）。
+#   ★本命の配布先はホーム（①-e3）。ここは sandbox セクションを持つ現場への念のための追記。
+#   ★deniedDomains（本番DB直結の禁止など）は allowedDomains より先に判定されるので、"*" を
+#     入れても効いたまま。ここでは deniedDomains に一切触れない。
+#   (3-a) 自社インフラ（ty-hld.com / *.workers.dev）… sales-template から
+#   (3-b) 見本の宣言（現在は "*"）              … settings.sample.json から（宣言の正・ADR-004）
+# ★どちらも「追加のみ・既存は消さない・重複を作らない」＝permissions.deny 追記と同じ作法。
+#
+# ★sandbox セクションが無い現場には作らない。
+#   setup.sh は Supabase 不使用の現場で sandbox セクションごと削除する作りなので、
+#   無い＝意図的に外している可能性がある。そこへ新設するとサンドボックス自体を
+#   有効化してしまい、挙動を大きく変える事故になる。無い場合は触らず報告に留める。
+dst_sandbox = dst.get("sandbox")
+if isinstance(dst_sandbox, dict):
+    net = dst_sandbox.setdefault("network", {})
+    cur_domains = net.get("allowedDomains")
+    if not isinstance(cur_domains, list):
+        cur_domains = []
+    # (3-a) 自社インフラだけを配る。顧客固有の値（<SUPABASE_PROJECT_ID> や各自の supabase ホスト）は配らない。
+    src_domains = src.get("sandbox", {}).get("network", {}).get("allowedDomains", [])
+    ours = [x for x in src_domains
+            if x.endswith("ty-hld.com") or x.endswith(".workers.dev")]
+    missing_infra = [x for x in ours if x not in cur_domains]
+    # (3-b) 信頼できる部品取り寄せ先（settings.sample.json の一覧）。★ここに無い接続先は勝手に足さない。
+    missing_trusted = [x for x in sample_trusted_domains
+                       if x not in cur_domains and x not in missing_infra]
+    to_add = missing_infra + missing_trusted
+    if to_add:
+        net["allowedDomains"] = cur_domains + to_add
+        if missing_infra:
+            changes.append(f"自社インフラへの接続許可を {len(missing_infra)} 件追記")
+        if missing_trusted:
+            changes.append(f"部品取り寄せ先（npm/GitHub）への接続許可を {len(missing_trusted)} 件追記")
+elif dst_sandbox is None:
+    print(f"[update-guard]     ※ sandbox 設定が無いため接続許可は追記しません（この現場は対象外）")
+
+# --- (3b) サンドボックスの素通り穴を塞ぐ（allowUnsandboxedCommands: false） ---
+# 【穴】Bash ツールには dangerouslyDisableSandbox という引数があり、職人がこれを付けると
+#   コマンドがサンドボックスの外（ネット遮断も書込制限も無し）で走る。Claude Code は本来
+#   「サンドボックスの外で走らせてよいか」を確認へ格上げするが、settings の allow ルールで
+#   許可済みのコマンド（例 Bash(npm install:*) / Bash(git push:*)）は格上げが抑止されるため、
+#   確認カードも出ないまま素通りする（調査 1e4546eb / eea74fdc。実測 466 件）。
+# 【栓】sandbox.allowUnsandboxedCommands を false にすると、本体は
+#   dangerouslyDisableSandbox 引数を完全に無視し、必ずサンドボックス内で実行する
+#   （Claude Code の設定スキーマ記述より。既定は true）。
+#
+# ★sandbox セクションが「既に在る現場」だけを対象にする。無い現場に新設しないのは (3) と
+#   同じ理由（サンドボックス自体を有効化して挙動を大きく変える事故を起こさない）。
+# ★触るのはこのキー1つだけ。enabled / failIfUnavailable / autoAllowBashIfSandboxed /
+#   allowedDomains / deniedDomains は一切変えない。
+# ★true → false の是正は、このスクリプトで唯一の「値の変更」（他は追記のみ）なので、
+#   何を変えたかを必ずログに出す。
+if isinstance(dst_sandbox, dict):
+    cur_unsandboxed = dst_sandbox.get("allowUnsandboxedCommands")
+    if cur_unsandboxed is None:
+        dst_sandbox["allowUnsandboxedCommands"] = False
+        changes.append("sandbox.allowUnsandboxedCommands: false を追記（サンドボックス外実行の素通りを塞ぐ）")
+    elif cur_unsandboxed is not False:
+        dst_sandbox["allowUnsandboxedCommands"] = False
+        changes.append(f"sandbox.allowUnsandboxedCommands: {json.dumps(cur_unsandboxed)}→false 是正（サンドボックス外実行の素通りを塞ぐ）")
+    # 既に false なら何もしない＝2回流しても差分は出ない（冪等）。
+
+# --- 反映 ---
+if not changes:
+    print(f"[update-guard]   最新です（変更なし）: {dst_path}")
+    sys.exit(0)
+
+print(f"[update-guard]   要更新: {dst_path}")
+for c in changes:
+    print(f"[update-guard]     - {c}")
+
+if not apply_mode:
+    sys.exit(0)
+
+# ★書き換える前に必ずバックアップ（変更が要るときだけ作る＝バックアップが溜まらない）
+backup = f"{dst_path}.bak.{time.strftime('%Y%m%d-%H%M%S')}"
+shutil.copy2(dst_path, backup)
+tmp = dst_path + ".tmp"
+with open(tmp, "w", encoding="utf-8") as f:
+    json.dump(dst, f, indent=2, ensure_ascii=False)
+    f.write("\n")
+os.replace(tmp, dst_path)  # 置換は原子的＝途中で壊れた settings.json を残さない
+print(f"[update-guard]     更新しました（バックアップ: {backup}）")
+PYEOF
+done
+
+echo
+if [[ "$APPLY" == "1" ]]; then
+  info "完了しました。職人(Claude Code)を再起動すると新しい設定で動きます。"
+else
+  info "確認のみで終了しました。適用するには APPLY=1 を付けて再実行してください。"
+fi