claude-code
fef35ed03a
- hooks/lib/release_chain.py：問 Gitea 的判準一份三處用（匿名讀，D20） - scripts/release-ship：前置①比「要建的那個 tag 的樹」裡的 plugin.json，不比工作樹／最新 tag （總管 09-07 在 v0.23.0 被擋的情境現在放行）；note 從 Gitea compare 生，從 plugin 快取跑也行； 覆核改跑 release-check <那個 tag> - scripts/release-check [vX.Y.Z]：指定版本；v0.19／0.20／0.21 依裁決標「不補」不再黃字；補法印正本絕對路徑 - hooks/lib/beacon_report.py ④：最新 tag 沒 release／main 定版沒打 tag ⇒ 一行缺站＋補法；都在安靜； 只快取「都在」6 小時 - 測試：test-release-ship 14、test-release-check 14、信標 26→33；docs：TESTING A37/A38、盤點表、README 60 支腳本、 白名單加 release-ship／release-check 形狀、mistakes 一條 - 沒改 plugin.json 版本號（待總管定版） Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0178ef1fGw3XeZtpN7LaZrm4
234 lines
14 KiB
Bash
Executable File
234 lines
14 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"
|
||
cp "$REAL_HOOKS/lib/release_chain.py" "$d/hooks/lib/release_chain.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 <plugin root> <列...> → 寫一份 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 <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__"
|
||
|
||
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 "── ④打了 tag 卻沒 release（inkstone/ISEP#67 → 6574）──────────────────"
|
||
# 🔴 這一組守的是 09-07 那件：v0.23.0／v0.24.0 tag 都推了、Releases 頁停在 v0.22.0，
|
||
# 交棒給 leo 的測試位置打開是一頁空 tag。開場要說「缺哪一站＋怎麼補」，都在時安靜。
|
||
P4=$(mkplugin 0.24.0); printf '#!/usr/bin/env python3\n' > "$P4/scripts/release-ship"
|
||
FX4="$TMP/chain-gap.json"
|
||
printf '{"tags":["v0.24.0","v0.23.0"],"releases":["v0.23.0"]}\n' > "$FX4"
|
||
out=$(ISEP_BEACON_CHAIN_FIXTURE="$FX4" run "$P4" "$J")
|
||
check "㉗ 最新 tag v0.24.0 沒有 release → 一行說缺哪一站＋怎麼補（正本絕對路徑）" "$out" \
|
||
"v0.24.0 送到一半" "缺 release（Gitea）" "python3 $P4/scripts/release-ship v0.24.0" "inkstone/ISEP#67"
|
||
check "㉘ 信標那一行仍在、JSON 合法" "$out" "🟢 ISEP v0.24.0 已載入" "!__BADJSON__"
|
||
|
||
FX4b="$TMP/chain-ok.json"
|
||
printf '{"tags":["v0.24.0","v0.23.0"],"releases":["v0.24.0","v0.23.0"]}\n' > "$FX4b"
|
||
out=$(ISEP_BEACON_CHAIN_FIXTURE="$FX4b" run "$P4" "$J")
|
||
check "㉙ tag 與 release 都在 → 一個字都不說（天天念會被學會忽略）" "$out" "!送到一半" "!缺 release"
|
||
|
||
out=$(run "$P4" "$J")
|
||
check "㉚ 問不到收貨端（沒網路、沒 fixture）→ 閉嘴，不猜" "$out" "!送到一半" "🟢 ISEP v0.24.0 已載入"
|
||
|
||
out=$(ISEP_FAKE_MAIN_VERSION=0.25.0 ISEP_BEACON_CHAIN_FIXTURE="$FX4b" run "$P4" "$J")
|
||
check "㉛ main 定版到 0.25.0、Gitea 最新 tag 還是 v0.24.0 → 說缺 tag 站＋push tag 的補法" "$out" \
|
||
"v0.25.0 送到一半" "缺 tag（Gitea）" "git push origin v0.25.0"
|
||
|
||
P4o=$(mkplugin 0.21.0) # 載入的這一份還沒有 scripts/release-ship（舊版）
|
||
out=$(ISEP_BEACON_CHAIN_FIXTURE="$FX4" run "$P4o" "$J")
|
||
check "㉜ 載入的這一份還沒有 release-ship → 補法先教 plugin update，不印一條不存在的路徑" "$out" \
|
||
"v0.24.0 送到一半" "claude plugin update isep@inkstone" "!python3 $P4o/scripts/release-ship"
|
||
|
||
# 只快取「都在」：缺件那次不留快取，補完的下一個 session 立刻安靜；都在那次留快取
|
||
rm -f "$TMP"/.isep-chain-ok-*
|
||
out=$(ISEP_BEACON_CHAIN_FIXTURE="$FX4" run "$P4" "$J")
|
||
[ ! -e "$TMP/.isep-chain-ok-v0.24.0" ] && r1=1 || r1=0
|
||
out=$(ISEP_BEACON_CHAIN_FIXTURE="$FX4b" run "$P4" "$J")
|
||
[ -e "$TMP/.isep-chain-ok-v0.24.0" ] && r2=1 || r2=0
|
||
N=$((N+1)); if [ "$r1$r2" = "11" ]; then printf ' ✅ ㉝ 缺件不快取、都在才快取（補完下一個 session 就安靜）\n'; PASS=$((PASS+1))
|
||
else printf ' ❌ ㉝ 快取方向錯了（缺件留了快取=%s／都在沒留=%s）\n' "$((1-r1))" "$((1-r2))"; FAIL=$((FAIL+1)); fi
|
||
|
||
echo
|
||
printf '通過 %s 條，失敗 %s 條（共 %s 條）\n' "$PASS" "$FAIL" "$N"
|
||
[ "$FAIL" = 0 ] || exit 1
|