claude-code
adb7009b67
信標原本只證明「有一份 plugin 載入了」，不證明「載入的是哪一份」—— 2026-08-27 雲端載的是 0.3.9、main 是 0.9.0，中間差 7 個 release，而它照樣是綠的。 那個看不見的落差的實際後果：0.3.9 裡還活著兩支 v0.9.0 已整支刪掉的 hook， 於是 .claude/pending-verification/ 被清掉之後又長回來。 三格（都只報告、不擋、拿不到答案就閉嘴）： · 版本落差：匿名讀 ISEP main 的 plugin.json（D20 判準下屬於「讀」），快取 6 小時、 逾時 6 秒。落後就講清楚差幾版與怎麼修，並指向 inkstone/ISEP#67。 · 舊複本遮蔽正門：plugin 的 scripts/* 在專案樹（含雲端的 $TOP/InkStoneCo/）裡 有同名但**內容不同**的複本就點名。實例＝InkStoneCo/scripts/ticket 的取 token 邏輯還停在「只認名叫 gitea 的 remote」，而雲端的 Gitea 叫 origin ⇒ 一律死在「拿不到 gitea token」⇒ 人被逼去繞過正門直接打 API， 而那正是 ticket-api-bypass-guard.sh 在防的事。 · 退役機制的殘骸：.claude/ 底下的目錄，若 plugin 的 hooks/scripts 一個字都沒提到 ⇒ 產生它的東西已經不在這一份裡了。判準是「plugin 現在還認不認得它」， **不是關鍵字黑名單**（leo 2026-08-17 已證明那條路 8 次誤攔、0 次正確攔截）。 訊息改由 hooks/lib/beacon_report.py 序列化：三段報告含引號與換行， 用 shell 內插拼 JSON 一個引號就會讓整行信標消失——而那正是「零閘狀態」的長相。 fail-open：python 掛掉、檔案不見、網路不通，一律退回原本那一行乾淨的信標。 測試 hooks/tests/isep-presence-beacon.test.sh：14/14（全離線）。 第 ⑪ 條守的是寫這支時真的犯過的 bug（內層迴圈變數跟外層的 d 撞名， 第二個殘骸之後全部被靜靜跳過）——把那個 bug 放回去，該條立刻轉紅。
118 lines
6.6 KiB
Bash
Executable File
118 lines
6.6 KiB
Bash
Executable File
#!/usr/bin/env bash
|
||
# isep-presence-beacon.sh 的迴歸測試（inkstone/ISEP#90 ②③）
|
||
#
|
||
# 信標的價值全在鑑別力，所以這支要同時證明兩件相反的事：
|
||
# ① 該報的三件真的報得出來（版本落差／舊複本遮蔽正門／退役機制的殘骸）
|
||
# ② **不管加多少報告，那行綠色信標永遠在**——它消失＝leo 會判定這個 session 零閘。
|
||
# 所以連 python 掛掉、網路不通、訊息裡有引號，都要還有一行合法 JSON。
|
||
#
|
||
# 🔴 全程離線（ISEP_BEACON_SKIP_NET=1，版本用 ISEP_FAKE_MAIN_VERSION 造），
|
||
# 造假的 plugin root 與 project dir 都在 TMP 底下，不碰真 repo。
|
||
set -u
|
||
HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/isep-presence-beacon.sh}"
|
||
REAL_HOOKS="$(cd "$(dirname "$HOOK")" && pwd)"
|
||
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
|
||
export ISEP_BEACON_SKIP_NET=1 ISEP_BEACON_CACHE_DIR="$TMP"
|
||
|
||
PASS=0; FAIL=0; N=0
|
||
|
||
# mkplugin <版本> → 造一份假的 plugin root（只放信標真的會讀的東西）
|
||
mkplugin() {
|
||
d="$TMP/plugin-$1"; mkdir -p "$d/.claude-plugin" "$d/hooks/lib" "$d/scripts"
|
||
printf '{"name":"isep","version":"%s"}\n' "$1" > "$d/.claude-plugin/plugin.json"
|
||
printf '{"hooks":{"Stop":[{"hooks":[{"command":"hooks/a.sh"},{"command":"hooks/b.sh"}]}]}}\n' \
|
||
> "$d/hooks/hooks.json"
|
||
cp "$HOOK" "$d/hooks/$(basename "$HOOK")"
|
||
cp "$REAL_HOOKS/lib/beacon_report.py" "$d/hooks/lib/beacon_report.py"
|
||
printf '#!/bin/sh\necho real\n' > "$d/scripts/ticket"
|
||
printf '%s\n' "$d"
|
||
}
|
||
|
||
# run <plugin root> <project dir> → 印出 systemMessage（JSON 壞掉就印 __BADJSON__）
|
||
run() {
|
||
CLAUDE_PLUGIN_ROOT="$1" CLAUDE_PROJECT_DIR="$2" bash "$1/hooks/$(basename "$HOOK")" 2>/dev/null \
|
||
| python3 -c 'import json,sys
|
||
try: print(json.load(sys.stdin)["systemMessage"])
|
||
except Exception: print("__BADJSON__")'
|
||
}
|
||
|
||
check() { # check <說明> <輸出> <該出現|!不該出現>...
|
||
desc="$1"; out="$2"; shift 2; N=$((N+1)); ok=1; why=""
|
||
for w in "$@"; do
|
||
case "$w" in
|
||
"!"*) if printf '%s' "$out" | grep -qF -- "${w#!}"; then ok=0; why="不該出現卻出現了：${w#!}"; fi ;;
|
||
*) if ! printf '%s' "$out" | grep -qF -- "$w"; then ok=0; why="少了：$w"; fi ;;
|
||
esac
|
||
done
|
||
if [ "$ok" = 1 ]; then printf ' ✅ %s\n' "$desc"; PASS=$((PASS+1))
|
||
else printf ' ❌ %s —— %s\n' "$desc" "$why"; printf '%s\n' "$out" | sed 's/^/ /'; FAIL=$((FAIL+1)); fi
|
||
}
|
||
|
||
echo "── 基本盤：那行綠色信標永遠在 ────────────────────────────────"
|
||
P=$(mkplugin 0.9.0); J="$TMP/proj-clean"; mkdir -p "$J"
|
||
out=$(run "$P" "$J")
|
||
check "① 乾淨環境：只有一行信標，版本與閘數都在" "$out" \
|
||
"🟢 ISEP v0.9.0 已載入" "2 支閘" "!🔴" "!🟡" "!__BADJSON__"
|
||
|
||
echo "── ①版本落差 ────────────────────────────────────────────────"
|
||
out=$(ISEP_FAKE_MAIN_VERSION=0.9.0 run "$P" "$J")
|
||
check "② 載入版＝main 版 → 不吵" "$out" "🟢 ISEP v0.9.0" "!落後"
|
||
P39=$(mkplugin 0.3.9)
|
||
out=$(ISEP_FAKE_MAIN_VERSION=0.9.0 run "$P39" "$J")
|
||
check "③ 載入 0.3.9、main 0.9.0 → 要說它落後（雲端那個現場）" "$out" \
|
||
"🟢 ISEP v0.3.9 已載入" "落後 ISEP main" "0.9.0" "inkstone/ISEP#67"
|
||
out=$(ISEP_FAKE_MAIN_VERSION=0.1.0 run "$P" "$J")
|
||
check "④ 載入版比 main 新 → 說「沒發版」，不說「落後」" "$out" "比 ISEP main 新" "!落後 ISEP main"
|
||
|
||
echo "── ②舊複本遮蔽正門 ──────────────────────────────────────────"
|
||
J2="$TMP/proj-shadow"; mkdir -p "$J2/scripts"
|
||
printf '#!/bin/sh\necho OLD\n' > "$J2/scripts/ticket"
|
||
out=$(run "$P" "$J2")
|
||
check "⑤ 專案裡有內容不同的同名腳本 → 要點名（ticket 那件）" "$out" \
|
||
"舊複本" "scripts/ticket"
|
||
J3="$TMP/proj-same"; mkdir -p "$J3/scripts"; cp "$P/scripts/ticket" "$J3/scripts/ticket"
|
||
out=$(run "$P" "$J3")
|
||
check "⑥ 複本內容一模一樣（同步過的）→ 不吵" "$out" "!舊複本"
|
||
J4="$TMP/proj-body"; mkdir -p "$J4/InkStoneCo/scripts"
|
||
printf '#!/bin/sh\necho OLD\n' > "$J4/InkStoneCo/scripts/ticket"
|
||
out=$(run "$P" "$J4")
|
||
check "⑦ 雲端排法：複本在 \$TOP/InkStoneCo/ 底下也要抓到" "$out" \
|
||
"舊複本" "InkStoneCo/scripts/ticket"
|
||
|
||
echo "── ③退役機制的殘骸 ──────────────────────────────────────────"
|
||
J5="$TMP/proj-orphan"; mkdir -p "$J5/.claude/pending-verification" "$J5/.claude/hooks"
|
||
out=$(run "$P" "$J5")
|
||
check "⑧ plugin 的 hooks/scripts 完全沒提到的目錄 → 報殘骸" "$out" \
|
||
"已退役機制的產物" ".claude/pending-verification"
|
||
check "⑨ Claude Code 自己的目錄（hooks）不算殘骸" "$out" "!.claude/hooks"
|
||
# 現行機制的產物不該被報：讓 plugin 的某支 hook 提到它
|
||
mkdir -p "$J5/.claude/pending-main-push"
|
||
printf '#!/bin/sh\n# 寫到 pending-main-push/\n' > "$P/hooks/x.sh"
|
||
out=$(run "$P" "$J5")
|
||
check "⑩ hooks 裡有東西提到它 → 那是現行機制的產物，不報" "$out" "!pending-main-push"
|
||
# 🔴 這條守的是第一版真的犯過的 bug：內層迴圈的變數名跟外層的 `d` 撞，
|
||
# 第二個名字之後全部被靜靜跳過 ⇒ 真的存在的殘骸一聲不吭地消失。
|
||
mkdir -p "$J5/.claude/verified-claims"
|
||
out=$(run "$P" "$J5")
|
||
check "⑪ 同一個 .claude 底下有多個殘骸 → 每一個都要報（變數撞名的迴歸）" "$out" \
|
||
".claude/pending-verification" ".claude/verified-claims"
|
||
|
||
echo "── 最重要：加了報告也不准讓信標消失 ──────────────────────────"
|
||
# python 掛掉（把 report 換成一定會爆的內容）→ 仍要有一行合法 JSON 的信標
|
||
PB=$(mkplugin 0.9.0); printf 'raise SystemExit(3)\n' > "$PB/hooks/lib/beacon_report.py"
|
||
out=$(run "$PB" "$J")
|
||
check "⑫ 組訊息的 python 整支掛掉 → 退回乾淨的那一行，不是沉默" "$out" \
|
||
"🟢 ISEP v0.9.0 已載入" "!__BADJSON__"
|
||
rm -f "$PB/hooks/lib/beacon_report.py"
|
||
out=$(run "$PB" "$J")
|
||
check "⑬ 連 report 檔都不見 → 一樣要有信標" "$out" "🟢 ISEP v0.9.0 已載入" "!__BADJSON__"
|
||
# 訊息裡有引號/換行時 JSON 仍要合法（舊版是 printf 手拼的，這正是它會壞的地方）
|
||
J6="$TMP/proj-quote"; mkdir -p "$J6/scripts"
|
||
printf '#!/bin/sh\necho "OLD"\n' > "$J6/scripts/ticket"
|
||
out=$(run "$P" "$J6")
|
||
check "⑭ 報告內容含引號 → JSON 仍然合法" "$out" "🟢 ISEP" "!__BADJSON__"
|
||
|
||
echo
|
||
printf '通過 %s 條，失敗 %s 條（共 %s 條）\n' "$PASS" "$FAIL" "$N"
|
||
[ "$FAIL" = 0 ] || exit 1
|