修好一次性戳記恆擋:InkStoneCo 專案版 hooks 與 plugin 雙掛載

inkstone/ISEP#122:leo 三次要部署被 prod-write-guard.sh 恆擋,蓋了戳記
也放不了行。根因不在 prod-write-guard.sh 本身,而在
InkStoneCo/.claude/settings.json 還登記著一份 2026-08-20 立 ISEP plugin
之前的舊 hook,跟 plugin 自己的 hooks.json 同時掛在同一個事件上——每個
PreToolUse 都跑了兩次,一次性戳記被第一份消耗掉,第二份永遠看到空戳記。

實查(在這台機器的樹上實數):InkStoneCo 專案版登記著 38 支 hook,
34 支跟 plugin 完全同名同用途(純殘骸)、3 支是已退役機制
(claim-verify-police.sh/subagent-claim-worksheet.sh/sdd-guard.sh,
ISEP#60/#91 早已裁定退役但專案版沒跟著退)、1 支(kv-write-guard.sh)
是專案版有、plugin 當時沒有的真閘。

這次:
- kv-write-guard.sh 原樣搬進本 repo(B 組,PreToolUse Write|Edit|MultiEdit),
  補齊那個真的缺口,附 8 條迴歸測試
- 新增 duplicate-hook-registration-guard.sh(E 組,SessionStart):
  往後任何專案的 settings.json 又跟 plugin 長出同名登記,開場就點名,
  不必再靠「戳記莫名其妙失效」才發現,附 8 條迴歸測試
- 兩支新閘:61→63 支、84→86 條註冊(在自己的樹上實數,不是加減推)

InkStoneCo 那邊的清理(37 支殘骸從 settings.json 與 .claude/hooks/ 移除,
kv-write-guard.sh 保留至本次升版並 /plugin update 之後)另外commit,
不在本 repo 範圍內。

驗證:重演過修好前的雙掛載(蓋一次戳記→專案版先吃掉→plugin 版恆擋,
EXIT=2),也驗過修好後單次執行放行(EXIT=0)與不蓋戳記仍被擋(EXIT=2)。

待總管定版。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-09-02 00:24:32 +08:00
parent 35cc56dfc5
commit ee085c1854
7 changed files with 434 additions and 2 deletions
+68
View File
@@ -0,0 +1,68 @@
#!/usr/bin/env bash
# duplicate-hook-registration-guard.sh — SessionStart:這個專案自己的 .claude/settings.json
# 是不是還在登記一支跟 ISEP plugin 同名的舊 hookinkstone/ISEP#122
#
# 為什麼存在(2026-09-01 實撞):
# 總管三次要部署 uncle6.me,三次被 prod-write-guard.sh 擋。leo 問「你沒有權限?」
# ——不是沒權限,是 InkStoneCo/.claude/settings.json 裡還留著 ISEP 立 plugin 之前
# 的舊登記,跟 plugin 自己的 hooks.json 同時掛在同一個事件上,於是每個 PreToolUse
# 都跑了**兩次**:一次由專案版、一次由 plugin。多數閘只是白跑一次沒感覺,
# 但**帶「蓋一次戳記只放行一次」語意的閘會被第一份吃光**——第二份永遠看到空的戳記,
# 於是恆擋。查證見 ISEP#122:37 支專案版登記裡,34 支跟 plugin 完全同名同用途、
# 3 支是已經退役的機制(`claim-verify-police.sh``subagent-claim-worksheet.sh`
# `sdd-guard.sh`),全部清掉;剩下 1 支(`kv-write-guard.sh`)是專案版有、plugin
# 當時沒有的真閘,已原樣搬進本 repo(同一輪 commit)。
#
# 🔑 這支 hook 的用途不是清除,是**讓「又長出重複掛載」這件事有人立刻知道**。
# 上一次它能存活 13 天沒被發現,就是因為除了「戳記莫名其妙失效」以外沒有任何
# 訊號會指出來——一支天天在跑的閘,跟一支不存在的閘,行為長得一模一樣。
#
# 三條設計約束(跟 skill-deploy-drift-guard.sh 同一個形狀):
# 1. 沒事不出聲——乾淨時完全靜音。
# 2. 從不擋人——SessionStart 一律 exit 0,這是通知,不是閘。
# 3. 判準是「登記在不在」,不是關鍵字——比對的是 hooks.jsonsettings.json
# 裡實際出現的檔名,不是靠猜或列黑名單(isep-hand 紅線:不准用關鍵字黑名單)。
set -uo pipefail
ROOT="${CLAUDE_PLUGIN_ROOT:-}"
[ -n "$ROOT" ] || exit 0
[ -f "$ROOT/hooks/hooks.json" ] || exit 0
PROJ="${CLAUDE_PROJECT_DIR:-}"
[ -n "$PROJ" ] || exit 0
SETTINGS="$PROJ/.claude/settings.json"
[ -f "$SETTINGS" ] || exit 0
# ISEP plugin 自己「真的註冊了」的 hook 檔名(不是目錄列表——目錄裡可能有沒掛的樣板)
PLUGIN_NAMES="$(grep -oE 'hooks/[a-zA-Z0-9._-]+\.sh' "$ROOT/hooks/hooks.json" 2>/dev/null \
| sed 's|.*/||' | sort -u)"
[ -n "$PLUGIN_NAMES" ] || exit 0
# 這個專案自己的 settings.json 裡,指向 .claude/hooks/ 底下的登記
PROJECT_NAMES="$(grep -oE '\.claude/hooks/[a-zA-Z0-9_.-]+\.sh' "$SETTINGS" 2>/dev/null \
| sed 's|.*/||' | sort -u)"
[ -n "$PROJECT_NAMES" ] || exit 0
DUPES="$(comm -12 <(printf '%s\n' "$PLUGIN_NAMES") <(printf '%s\n' "$PROJECT_NAMES") 2>/dev/null || true)"
[ -n "$DUPES" ] || exit 0
N=$(printf '%s\n' "$DUPES" | grep -c .)
LIST="$(printf '%s\n' "$DUPES" | sed 's/^/ • /')"
cat <<EOF
🔁 重複掛載警報:\`$SETTINGS\` 還登記著 ${N} 支跟 ISEP plugin 同名的舊 hook。
$LIST
⇒ 每個對應的動作都會**跑兩次**——一次由這份專案版複本、一次由 plugin。
多數閘只是白跑一次;**帶「蓋一次戳記只放行一次」語意的閘會被第一份吃光**,
第二份永遠看到空戳記,於是恆擋——這正是 inkstone/ISEP#122 那次的形狀。
出路(二選一,不是「留著沒關係」):
① 這幾支 plugin 已經覆蓋 → 從 \`$SETTINGS\` 的 hooks 區段刪掉這幾條登記。
② 專案版身上還有 plugin 沒有的邏輯 → 先把那段邏輯併進 ISEP(開票、比照
kv-write-guard.sh 那次的搬法),plugin 升版裝上之後再刪專案版登記。
**不要讓兩份同時掛著**——那正是這支閘存在的理由。
EOF
exit 0