#!/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" # inkstone/ISEP#122:會自動載入的東西(skill/command/agent)也要造得出來 mkdir -p "$d/skills/demo" "$d/commands" "$d/agents" "$d/docs" printf 'PLUGIN 版的 skill\n' > "$d/skills/demo/SKILL.md" printf 'PLUGIN 版的 command\n' > "$d/commands/demo.md" printf 'PLUGIN 版的 agent\n' > "$d/agents/demo.md" printf '%s\n' "$d" } # mkown <列...> → 寫一份 docs/file-ownership.tsv(欄位用真正的 TAB) mkown() { d="$1"; shift; mkdir -p "$d/docs" { printf '# 測試用\n'; for row in "$@"; do printf '%s\n' "$row"; done; } \ | sed 's/|/\t/g' > "$d/docs/file-ownership.tsv" } # run → 印出 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__" P2=$(mkplugin 1.0.0) # ⑫⑬ 會刪掉 $P 的 report,這一組要自己一份 echo "── ②b 會自動載入的東西也有分身(inkstone/ISEP#122)──────────────" # 🔴 這一組守的是 ship-check 那件:plugin 帶著舊描述,而舊描述在「我要發部落格文章」 # 的情境根本不會被觸發 ⇒ 那個 session 永遠載不到出貨流程,而且不會有任何症狀。 JS="$TMP/proj-skill"; mkdir -p "$JS/.claude/skills/demo" printf '專案版的 skill(比較舊)\n' > "$JS/.claude/skills/demo/SKILL.md" out=$(run "$P2" "$JS") check "⑮ 專案有同名 skill 而內容不同 → 要點名" "$out" \ "會自動載入的東西兩邊各有一份" "skills/demo/SKILL.md" ".claude/skills/demo/SKILL.md" check "⑯ 歸屬表沒登記 → 誠實說未定,不要替人猜方向" "$out" "歸屬未定" JS2="$TMP/proj-skill-same"; mkdir -p "$JS2/.claude/skills/demo" cp "$P2/skills/demo/SKILL.md" "$JS2/.claude/skills/demo/SKILL.md" out=$(run "$P2" "$JS2") check "⑰ 內容一模一樣 → 不吵(誤攔比漏擋嚴重)" "$out" "!會自動載入的東西兩邊各有一份" JC="$TMP/proj-cmd"; mkdir -p "$JC/.claude/commands" printf '專案版的 command(比較舊)\n' > "$JC/.claude/commands/demo.md" out=$(run "$P2" "$JC") check "⑱ command 也要掃(sdd-check 那件)" "$out" "commands/demo.md" ".claude/commands/demo.md" JA="$TMP/proj-agent"; mkdir -p "$JA/.claude/agents" printf '專案版的 agent(比較舊)\n' > "$JA/.claude/agents/demo.md" out=$(run "$P2" "$JA") check "⑲ agent 也要掃" "$out" "agents/demo.md" ".claude/agents/demo.md" JCL="$TMP/proj-cloud"; mkdir -p "$JCL/InkStoneCo/.claude/skills/demo" printf '專案版的 skill(比較舊)\n' > "$JCL/InkStoneCo/.claude/skills/demo/SKILL.md" out=$(run "$P2" "$JCL") check "⑳ 雲端排法:真身在 \$TOP/InkStoneCo/ 底下也要抓到" "$out" \ "InkStoneCo/.claude/skills/demo/SKILL.md" echo "── 歸屬表要講得出「往哪個方向修」──────────────────────────────" PO=$(mkplugin 1.0.1) mkown "$PO" "skills/demo/SKILL.md|inkstone/InkStoneCo|.claude/skills/demo/SKILL.md|abc1234|-" out=$(run "$PO" "$JS") check "㉑ 真相源=InkStoneCo → 說「內容改在那裡」並給得出路徑" "$out" \ "真相源=inkstone/InkStoneCo:.claude/skills/demo/SKILL.md" "內容改在那裡" "!歸屬未定" mkown "$PO" "skills/demo/SKILL.md|inkstone/ISEP|-|-|-" out=$(run "$PO" "$JS") check "㉒ 真相源=ISEP → 說「專案那份是舊複本」" "$out" \ "真相源=ISEP 這一份" "舊複本" "!歸屬未定" echo "── ②c 沒有專案那一份也要驗得出來(雲端唯一作數的檢查)────────────" # 雲端的 project dir 是薄殼,沒有 InkStoneCo 可以比 ⇒ 只剩「檔案 vs 表上的 sha256」 SHA=$(shasum -a 256 "$PO/skills/demo/SKILL.md" | cut -d" " -f1) mkown "$PO" "skills/demo/SKILL.md|inkstone/InkStoneCo|.claude/skills/demo/SKILL.md|abc1234|$SHA" out=$(run "$PO" "$J") check "㉓ sha256 對得上(而且專案那份不存在)→ 一個字都不說" "$out" \ "🟢 ISEP v1.0.1 已載入" "!跟歸屬表對不上" "!會自動載入的東西兩邊各有一份" printf '被就地改過\n' >> "$PO/skills/demo/SKILL.md" out=$(run "$PO" "$J") check "㉔ 檔案被就地改過 → 就算沒有專案那份,也要抓得到" "$out" \ "跟歸屬表對不上" "skills/demo/SKILL.md" "abc1234" mkown "$PO" "skills/demo/SKILL.md|inkstone/InkStoneCo|.claude/skills/demo/SKILL.md|abc1234|-" out=$(run "$PO" "$J") check "㉕ 表上 sha 欄是 \`-\` → 這一格閉嘴(還沒登記不是錯)" "$out" "!跟歸屬表對不上" echo "── 加了這兩格也不准讓信標消失 ────────────────────────────────" out=$(run "$P2" "$JS") check "㉖ ②b 有報告時,那行綠色信標仍在且 JSON 合法" "$out" \ "🟢 ISEP v1.0.0 已載入" "!__BADJSON__" echo printf '通過 %s 條,失敗 %s 條(共 %s 條)\n' "$PASS" "$FAIL" "$N" [ "$FAIL" = 0 ] || exit 1