一條線一份自己的工作目錄，同時跑的線有上限（inkstone/ISEP#109 → comment 5391）
兩支新閘，兩個方向的測試都有：
line-needs-own-worktree.sh（PreToolUse: Bash，35 條測試）— 治本那半
一條線想在共用的工作目錄裡切分支就擋，叫它開自己的 worktree。
判準是 git 自己回答的兩個問題（會不會動 HEAD／是不是主工作目錄），
不靠任何人登記。擋下來時順手 prune 掉指向空氣的登記。
實測：products/arcrun-rag 清掉 4 筆、ISEP 清掉 13 筆，
還在的 worktree 與分支一根寒毛都沒動。
parallel-lines-cap-guard.sh（PreToolUse: Agent|Task，33 條測試）— 治標那半
同時在跑的線超過上限（預設 3）就派不出下一條，訊息列出現在有哪幾條。
條數是從 harness 自己寫的 subagents/*.meta.json ＋ 主 transcript 的完工通知
數出來的，不是計數器 —— 沒有任何東西要人去減，所以不會永久卡死。
三個機械前提是實測的，不是推測的：
· SubagentStop 在實測 session 裡一次都沒觸發（不能拿它當減法）
· PostToolUse:Agent 在送出後 5 秒就觸發（不是收工）
· subagent 不是獨立行程（ps 只有一個 claude-code 行程）
· Agent 的原生 isolation:"worktree" 只做頂層 repo，
而 products/ matrix/ 是 gitignore 掉的子 repo，worktree 裡根本沒有它們
⇒ 原生那條路解不了這張票的問題
盤點數字在自己的樹上重數：62 支 / 85 條（main 上的 60/82 沒算到這兩支）。
🔴 版本沒動 = 沒有人吃得到。這條分支沒有定版，
plugin.json 仍是 0.16.1（版本一致性檢查要求它等於最新 tag）。
合併時要跟著一個新版本號，不然這兩支閘到不了任何人手上。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@@ -68,6 +68,10 @@
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/dispatch-format-guard.sh"
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/line-needs-own-worktree.sh"
|
||||
}
|
||||
]
|
||||
},
|
||||
@@ -176,6 +180,10 @@
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/search-is-not-proof-guard.sh"
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/parallel-lines-cap-guard.sh"
|
||||
}
|
||||
]
|
||||
},
|
||||
@@ -227,6 +235,10 @@
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/search-is-not-proof-guard.sh"
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/parallel-lines-cap-guard.sh"
|
||||
}
|
||||
]
|
||||
},
|
||||
|
||||
Executable
+167
@@ -0,0 +1,167 @@
|
||||
#!/usr/bin/env bash
|
||||
# 管什麼: 一條派工線要在「共用的工作目錄」裡切分支時擋下來，叫它去開一份自己的 worktree。
|
||||
# 為什麼: 2026-08-29 inkstone/ISEP#109 comment 5391——每個 repo 只有一份工作目錄，所有線共用。#163 切到自己的分支、交回時沒切回來，總管後來在同一個目錄跑 ship.mjs，讀到的是別人留下的 HEAD。票號說得出「這是哪個任務」，沒有任何東西說得出「這個目錄現在是誰留下的狀態」。
|
||||
# 誤觸時怎麼關: `WORKTREE_OK=1 git checkout …`（留痕，跟 NOT_MY_BRANCH_OK 同形狀）。
|
||||
#
|
||||
# line-needs-own-worktree.sh — 共用工作目錄裡不准切分支（PreToolUse: Bash）
|
||||
#
|
||||
# ── 判準：git 自己回答的兩個問題，不看任何措辭 ────────────────────────
|
||||
# ① 這條命令會不會**移動 HEAD**？（checkout / switch，含 -b / -c）
|
||||
# —— 動作有限且可枚舉。`git checkout -- <檔>`／`git restore` 是還原檔案，不動 HEAD，放行。
|
||||
# ② 它要動的那個目錄，是不是那個 repo 的**主工作目錄**（＝大家共用的那一份）？
|
||||
# git rev-parse --git-dir == git rev-parse --git-common-dir ⇒ 主工作目錄（共用）
|
||||
# 兩者不同 ⇒ 這已經是一份 worktree（自己的）
|
||||
# —— 這是 git 自己算出來的事實，**不需要任何人去登記**。
|
||||
#
|
||||
# ①②都成立、而且送出命令的是一條線（`CLAUDE_CODE_CHILD_SESSION=1`）⇒ 擋。
|
||||
#
|
||||
# ── 為什麼是「線」而不是所有人（這不是總管例外）──────────────────────
|
||||
# 共用工作目錄**就是總管那一份**——他在自己的目錄裡切分支不會偷走別人的狀態。
|
||||
# 會出事的是**線把總管的目錄留在自己的分支上**（08-29 實錄就是這個形狀）。
|
||||
# ⇒ 規則不是「誰比較大」，是「**誰的目錄**」。線要動工，就去開一份自己的。
|
||||
#
|
||||
# ── 為什麼不靠 `.claude/branch-holds.md`（驗收條件 6 的原話：不靠人記得）─────
|
||||
# `not-my-branch-guard.sh` 守的是「**別 commit 到別人登記過的分支**」——
|
||||
# ① 只認 `git commit`、② 只看頂層 repo、③ **要有人先手動登記**。
|
||||
# 而 08-29 出事的是子 repo（`products/arcrun-rag`、`matrix/arcrun`）、動作是 `checkout`、
|
||||
# 而且沒有人登記過。**兩支守的不是同一件事，這支不動那支。**
|
||||
#
|
||||
# ── worktree 開在哪：開在 repo 的旁邊，不要開在 /tmp（2026-08-29 實測）──────
|
||||
# $ git -C products/arcrun-rag worktree list
|
||||
# /private/tmp/.../scratchpad/wt-180 … prunable ← 目錄被系統清掉了
|
||||
# /private/tmp/.../scratchpad/wt164 … prunable ← 同上
|
||||
# /private/tmp/wt167src … prunable
|
||||
# products/arcrun-rag-wt88 … 完好
|
||||
# products/arcrun-rag-wt104ingest … 完好
|
||||
# ISEP 同一天有 **12 筆 prunable**，全部在 /private/tmp 底下。
|
||||
# ⇒ 開在 `/tmp` 的會被系統清掉，而**登記簿還留著** ⇒ 登記簿說謊。
|
||||
# 開在 repo 旁邊的那幾份，一份都沒掉。
|
||||
#
|
||||
# ── 順手把說謊的登記清掉（驗收條件 7：prune 是收工動作，不是偶爾整理）───────
|
||||
# 擋下來的同時對那個 repo 跑一次 `git worktree prune`，並把清掉幾筆講出來。
|
||||
# prune **只刪「目錄已經不存在」的登記**，不碰任何還在的 worktree、不碰任何檔案。
|
||||
#
|
||||
# ── 誠實邊界 ────────────────────────────────────────────────────
|
||||
# 1. 它只擋 `checkout`／`switch`。**已經切過去之後**的 commit／build 這支看不到
|
||||
# （那是別的閘的地盤）。它守的是「別把共用目錄帶離原位」這一個動作。
|
||||
# 2. 它不知道那個 repo 現在有沒有別條線在動——**不知道就一律隔離**，
|
||||
# 因為「現在剛好沒人」是會變的，而分支留在那裡是不會自己回去的。
|
||||
# 3. `git worktree add` 之後那份 worktree 裡的 checkout 全部放行（判準 ②）。
|
||||
set -eu
|
||||
|
||||
[ "${WORKTREE_OK:-}" = "1" ] && exit 0
|
||||
[ "${CLAUDE_CODE_CHILD_SESSION:-}" = "1" ] || exit 0 # 總管在自己的目錄裡，不管
|
||||
|
||||
PAYLOAD=$(cat 2>/dev/null || echo '{}')
|
||||
|
||||
TARGET=$(printf '%s' "$PAYLOAD" | python3 -c '
|
||||
import json, re, shlex, sys
|
||||
|
||||
try:
|
||||
d = json.load(sys.stdin)
|
||||
except Exception:
|
||||
raise SystemExit
|
||||
|
||||
ti = d.get("tool_input") or {}
|
||||
cmd = (ti.get("command") or "") if isinstance(ti, dict) else ""
|
||||
if not cmd:
|
||||
raise SystemExit
|
||||
|
||||
cwd = d.get("cwd") or ""
|
||||
|
||||
# 逐段拆（; && || 換行），只看每一段的第一個 git
|
||||
for seg in re.split(r"(?:&&|\|\||;|\n)", cmd):
|
||||
seg = seg.strip()
|
||||
if not seg:
|
||||
continue
|
||||
try:
|
||||
tok = shlex.split(seg)
|
||||
except ValueError:
|
||||
continue
|
||||
# 允許前面掛 env（VAR=值 git …）
|
||||
while tok and re.match(r"^[A-Za-z_][A-Za-z0-9_]*=", tok[0]):
|
||||
tok.pop(0)
|
||||
if not tok or tok[0] != "git":
|
||||
continue
|
||||
tok = tok[1:]
|
||||
|
||||
# git -C <dir> …
|
||||
where = cwd
|
||||
while tok and tok[0].startswith("-"):
|
||||
if tok[0] == "-C" and len(tok) > 1:
|
||||
where = tok[1]; tok = tok[2:]; continue
|
||||
if tok[0].startswith("--git-dir"):
|
||||
raise SystemExit # 自己指 git-dir 的花式用法，不猜
|
||||
tok.pop(0)
|
||||
if not tok:
|
||||
continue
|
||||
|
||||
sub = tok[0]
|
||||
if sub not in ("checkout", "switch"):
|
||||
continue
|
||||
|
||||
rest = tok[1:]
|
||||
# 還原檔案的形狀，不動 HEAD ⇒ 放行
|
||||
if "--" in rest:
|
||||
continue
|
||||
if any(a in ("-p", "--patch", "--") for a in rest):
|
||||
continue
|
||||
# 沒有任何目標（`git checkout` 自己會報錯）⇒ 沒事
|
||||
if not [a for a in rest if not a.startswith("-")] and \
|
||||
not any(a in ("-b", "-B", "-c", "-C") for a in rest):
|
||||
continue
|
||||
|
||||
print(where or ".")
|
||||
break
|
||||
' 2>/dev/null) || exit 0
|
||||
|
||||
[ -n "${TARGET:-}" ] || exit 0
|
||||
|
||||
# 那個目錄是不是 repo 的**主工作目錄**（＝共用的那一份）——git 自己回答
|
||||
GD=$(git -C "$TARGET" rev-parse --git-dir 2>/dev/null) || exit 0
|
||||
CD=$(git -C "$TARGET" rev-parse --git-common-dir 2>/dev/null) || exit 0
|
||||
ABS() { (cd "$TARGET" 2>/dev/null && cd "$1" 2>/dev/null && pwd) || printf '%s' "$1"; }
|
||||
[ "$(ABS "$GD")" = "$(ABS "$CD")" ] || exit 0 # 已經在自己的 worktree 裡 ⇒ 放行
|
||||
|
||||
TOP=$(git -C "$TARGET" rev-parse --show-toplevel 2>/dev/null) || exit 0
|
||||
NAME=$(basename "$TOP")
|
||||
PARENT=$(dirname "$TOP")
|
||||
NOW=$(git -C "$TOP" rev-parse --abbrev-ref HEAD 2>/dev/null || echo '?')
|
||||
|
||||
# 驗收條件 7：說謊的登記順手清掉（只刪目錄已經不存在的那些）
|
||||
BEFORE=$(git -C "$TOP" worktree list 2>/dev/null | grep -c 'prunable' || true)
|
||||
git -C "$TOP" worktree prune 2>/dev/null || true
|
||||
PRUNED=""
|
||||
[ "${BEFORE:-0}" -gt 0 ] && PRUNED="
|
||||
🧹 順手清掉 $BEFORE 筆**指向空氣**的 worktree 登記（目錄早就被清掉、登記還留著）。
|
||||
只刪登記，沒有動任何還在的 worktree、沒有動任何檔案。"
|
||||
|
||||
cat >&2 <<EOF
|
||||
🌳 這是**共用的工作目錄**，不要在這裡切分支。
|
||||
|
||||
目錄：$TOP
|
||||
它現在在：$NOW
|
||||
$PRUNED
|
||||
【為什麼（inkstone/ISEP#109，2026-08-29 實錄）】
|
||||
每個 repo 只有**一份**工作目錄，所有線共用。那天 arcrun-rag#163 切到自己的分支、
|
||||
交回時沒切回來；總管後來在同一個目錄跑 ship.mjs，**讀到的是別人留下的 HEAD**。
|
||||
🔴 票號說得出「這是哪個任務」，**沒有任何東西說得出「這個目錄現在是誰留下的狀態」**。
|
||||
（那次沒出錯貨——是文案契約閘擋下來的。閘有效，但那是最後一道。）
|
||||
|
||||
【現在怎麼做】開一份自己的，然後在裡面做事：
|
||||
|
||||
git -C $TOP worktree add $PARENT/$NAME-wt-<票號> -b <你的分支>
|
||||
cd $PARENT/$NAME-wt-<票號>
|
||||
|
||||
🔴 **不要開在 /tmp 底下。** 同一天實測：$NAME 的登記簿裡指向 /private/tmp 的
|
||||
那幾筆全部 prunable（目錄被系統清掉、登記還在），而開在 repo 旁邊的一份都沒掉。
|
||||
|
||||
收工時：
|
||||
git -C $TOP worktree remove $PARENT/$NAME-wt-<票號>
|
||||
git -C $TOP worktree prune
|
||||
|
||||
【真的要在共用目錄裡切（接手、緊急止血）】
|
||||
WORKTREE_OK=1 git -C $TOP checkout <分支>
|
||||
留痕在指令歷史上，而且**切完要切回去**——$NOW 是你進來時的樣子。
|
||||
EOF
|
||||
exit 2
|
||||
Executable
+283
@@ -0,0 +1,283 @@
|
||||
#!/usr/bin/env bash
|
||||
# 管什麼: 同時在跑的派工線已經到上限時，再派下一條就擋下來，並列出現在有哪幾條在跑。
|
||||
# 為什麼: 2026-08-29 總管同時開七條線，8 GB 的 Mac 被吃爆重開機；同一天還派錯線一次、量錯東西六次、停掉正確的工作一次。leo：「跑 2-3 條應該是極限了」。在這之前這條規則只活在總管的回覆文字裡。
|
||||
# 誤觸時怎麼關: `touch /tmp/.parallel-ok-<session_id>` 後重送（用掉就消失，會留在指令歷史上）。上限本身用 `ISEP_MAX_PARALLEL_LINES` 調。
|
||||
#
|
||||
# parallel-lines-cap-guard.sh — 同時跑的線有上限（PreToolUse: Agent / Task）
|
||||
#
|
||||
# ── 判準：數 harness 自己寫下來的檔案，不數我自己記的數字 ──────────────
|
||||
# 這支一個字都不看派工單的內容。它只回答一個機械問題：
|
||||
#
|
||||
# **現在有幾條線還在跑？**
|
||||
#
|
||||
# 一條線算「還在跑」，要三個條件同時成立：
|
||||
# ① `<projects>/<sid>/subagents/agent-<id>.meta.json` 存在
|
||||
# —— harness 在啟動那條線的當下寫的，不是我寫的
|
||||
# ② 主 transcript 裡**還沒有**它的完工通知 `<task-id><id></task-id>`
|
||||
# ③ 它自己的 `agent-<id>.jsonl` 在 IDLE 秒內還在被寫（預設 900 秒）
|
||||
#
|
||||
# ①②③ 都是別人寫的事實，這支只是去讀。**沒有任何一個計數器要我去減。**
|
||||
#
|
||||
# ── 為什麼不用計數器（PreToolUse ＋1 / SubagentStop −1）────────────────
|
||||
# 減不掉就永遠卡死。而這張票的驗收條件第 2 條寫死：
|
||||
# 「前一條收工後，下一條派得出去——不能變成永久卡死」。
|
||||
# 🔴 更關鍵的是**那個減法根本不會發生**（2026-08-29 實測，非推測）：
|
||||
#
|
||||
# $ grep -oh '"hookEvent":[ ]*"[^"]*"' <本 session 的 transcript> | sort | uniq -c
|
||||
# 4545 "hookEvent":"PreToolUse"
|
||||
# 530 "hookEvent":"Stop"
|
||||
# 22 "hookEvent":"PostToolUse"
|
||||
# 20 "hookEvent":"SessionStart"
|
||||
# ⇒ **`SubagentStop` 在這個 session 一次都沒出現過。**
|
||||
# （hooks.json 目前有 7 條掛在 SubagentStop 上——那是另一張票的事，本票不動它們。）
|
||||
#
|
||||
# ── 為什麼不數行程 ────────────────────────────────────────────────
|
||||
# 票上引的是「claude 12 支 923 MB」。2026-08-29 20:31 在同一台機器實測：
|
||||
#
|
||||
# $ ps -Ao pid,ppid,rss,comm | grep -i claude
|
||||
# ...一堆 /Applications/Claude.app/... 的 Electron helper...
|
||||
# 2196 2195 389584 .../claude-code/2.1.246/claude.app/Contents/MacOS/claude
|
||||
#
|
||||
# ⇒ **Claude Code 只有一個行程（pid 2196）**，那 12 支是 Claude Desktop 的 helper。
|
||||
# subagent 不是獨立行程，**數行程數不到線**。（在別的 surface 可能不同——但這台是這樣。）
|
||||
#
|
||||
# ── 為什麼不掛在 PostToolUse(Agent) 上做「收工」的判斷 ─────────────────
|
||||
# 實測：PostToolUse:Agent 是在**送出後約 5 秒**觸發，那條線還在跑。
|
||||
# 12:26:46 PreToolUse:Agent toolu_01SPDbSPvzXCXHgMehcy3UKq
|
||||
# 12:26:51 tool_result "Async agent launched successfully... agentId: a6019a…"
|
||||
# 12:26:51 PostToolUse:Agent （同一秒）
|
||||
# ⇒ agent 這時候才剛開始跑。真正的完工通知是 66 分鐘後才進 transcript 的
|
||||
# `<task-notification>`（另一條線實測：10:35:59 送出 → 11:40:13 通知）。
|
||||
#
|
||||
# ── 誤攔的方向被刻意壓在「漏擋」那一邊 ────────────────────────────────
|
||||
# `.claude/branch-holds.md` 檔頭：**永遠在響的警報，等於訓練人忽略這個警報。**
|
||||
# 所以：
|
||||
# • 條件 ③ 的 IDLE 窗是**上限保險**——就算完工通知的格式哪天變了、②整個失效，
|
||||
# 一條線最多也只會被多算 15 分鐘，**不可能永久卡死**。
|
||||
# • 讀不到 payload／算不出來 ⇒ **放行**，但**出聲**（把「這次沒把關」講給模型聽），
|
||||
# 不是靜默放行。房規要的是「內部錯誤不准變成**靜默**放行」，
|
||||
# 而在這支身上「算不出來就擋」會變成整台機器派不了工——那是比漏擋貴得多的失敗。
|
||||
#
|
||||
# ── 誠實邊界（不補，補了就變成猜）────────────────────────────────────
|
||||
# 1. **只認得這個 surface 的檔案佈局**（`~/.claude/projects/<slug>/<sid>/subagents/`）。
|
||||
# 雲端 CC 的佈局沒實測過 ⇒ 那裡找不到目錄時這支等於不存在（會出聲說它數不出來）。
|
||||
# 2. **同步 agent**（不背景跑的）靠「tool_result 不是 launch ack」判收工；
|
||||
# 這條路在本機沒有實跡可對（這個 session 的 81 次派工全是背景），只有測試涵蓋。
|
||||
# 3. 它管的是**條數**，不是記憶體。真正吃掉 8 GB 的是什麼，這支不知道也不猜。
|
||||
set -uo pipefail
|
||||
|
||||
INPUT=$(cat)
|
||||
|
||||
CAP="${ISEP_MAX_PARALLEL_LINES:-3}"
|
||||
IDLE="${ISEP_PARALLEL_IDLE_SEC:-900}"
|
||||
|
||||
export ISEP_CAP="$CAP" ISEP_IDLE="$IDLE"
|
||||
|
||||
OUT=$(printf '%s' "$INPUT" | python3 -c '
|
||||
import json, os, re, sys, time
|
||||
|
||||
def bail(msg=""):
|
||||
# 算不出來 ⇒ 放行，但把原因印出來（下面的 shell 會轉成 additionalContext）
|
||||
if msg:
|
||||
print("NOTE\t" + msg)
|
||||
raise SystemExit
|
||||
|
||||
try:
|
||||
d = json.load(sys.stdin)
|
||||
except Exception:
|
||||
bail("並行閘讀不到 hook payload，這一次沒有把關。")
|
||||
|
||||
tool = d.get("tool_name") or ""
|
||||
if tool not in ("Agent", "Task"):
|
||||
raise SystemExit # 不是派工，這支沒有立場說話
|
||||
|
||||
sid = d.get("session_id") or ""
|
||||
tp = d.get("transcript_path") or ""
|
||||
if not sid or not tp:
|
||||
bail("並行閘拿不到 session_id / transcript_path，這一次沒有把關。")
|
||||
|
||||
# ── 找 subagents 目錄 ────────────────────────────────────────────
|
||||
# 主 session 的 transcript： <projects>/<sid>.jsonl
|
||||
# 子 agent 的 transcript： <projects>/<sid>/subagents/agent-<id>.jsonl
|
||||
# 兩種都要能回推到 <projects>。
|
||||
base = os.path.dirname(tp)
|
||||
if os.path.basename(base) == "subagents":
|
||||
base = os.path.dirname(os.path.dirname(base))
|
||||
|
||||
subdir = os.path.join(base, sid, "subagents")
|
||||
main = os.path.join(base, sid + ".jsonl")
|
||||
|
||||
if not os.path.isdir(subdir):
|
||||
raise SystemExit # 一條線都還沒派過 ⇒ 沒得數，也沒什麼好說的
|
||||
|
||||
cap = int(os.environ.get("ISEP_CAP", "3"))
|
||||
idle = int(os.environ.get("ISEP_IDLE", "900"))
|
||||
now = time.time()
|
||||
|
||||
# ── ① harness 寫下來的那些線 ＋ ③ 還在動的那些 ─────────────────────
|
||||
cand = {}
|
||||
try:
|
||||
names = os.listdir(subdir)
|
||||
except OSError:
|
||||
bail("並行閘讀不到 subagents 目錄，這一次沒有把關。")
|
||||
|
||||
for fn in names:
|
||||
if not (fn.startswith("agent-") and fn.endswith(".meta.json")):
|
||||
continue
|
||||
aid = fn[len("agent-"):-len(".meta.json")]
|
||||
jl = os.path.join(subdir, "agent-%s.jsonl" % aid)
|
||||
try:
|
||||
quiet = now - os.path.getmtime(jl)
|
||||
except OSError:
|
||||
continue # 連 transcript 都沒有 ⇒ 不是活的線
|
||||
if quiet > idle:
|
||||
continue # ③ 安靜太久 ⇒ 收工了或死了，一律不算
|
||||
try:
|
||||
meta = json.load(open(os.path.join(subdir, fn), encoding="utf-8"))
|
||||
except Exception:
|
||||
meta = {}
|
||||
try:
|
||||
started = now - os.path.getmtime(os.path.join(subdir, fn))
|
||||
except OSError:
|
||||
started = 0
|
||||
cand[aid] = {
|
||||
"name": meta.get("name") or meta.get("description") or "(沒取名字)",
|
||||
"type": meta.get("agentType") or "?",
|
||||
"desc": meta.get("description") or "",
|
||||
"tuid": meta.get("toolUseId") or "",
|
||||
"quiet": int(quiet),
|
||||
"age": int(started),
|
||||
}
|
||||
|
||||
if not cand:
|
||||
raise SystemExit
|
||||
|
||||
# ── ② 主 transcript 裡的完工通知 ─────────────────────────────────
|
||||
# 實跡：{"type":"queue-operation","operation":"enqueue", ... "<task-notification>
|
||||
# <task-id>a76283ec07f38ed24</task-id><tool-use-id>toolu_…</tool-use-id>"}
|
||||
done = set()
|
||||
byuid = {v["tuid"]: a for a, v in cand.items() if v["tuid"]}
|
||||
acked = {}
|
||||
|
||||
if os.path.isfile(main):
|
||||
marks = {a: "<task-id>%s</task-id>" % a for a in cand}
|
||||
try:
|
||||
with open(main, encoding="utf-8", errors="replace") as f:
|
||||
for line in f:
|
||||
for a, mk in marks.items():
|
||||
if a in done:
|
||||
continue
|
||||
if mk in line:
|
||||
done.add(a)
|
||||
if not byuid or "tool_result" not in line:
|
||||
continue
|
||||
if not any(u in line for u in byuid):
|
||||
continue
|
||||
try:
|
||||
e = json.loads(line)
|
||||
except Exception:
|
||||
continue
|
||||
msg = e.get("message")
|
||||
if not isinstance(msg, dict):
|
||||
continue
|
||||
for b in (msg.get("content") or []):
|
||||
if not isinstance(b, dict) or b.get("type") != "tool_result":
|
||||
continue
|
||||
a = byuid.get(b.get("tool_use_id"))
|
||||
if not a:
|
||||
continue
|
||||
txt = json.dumps(b.get("content"), ensure_ascii=False)
|
||||
# launch ack ＝ 這條線才剛開始；別的內容 ＝ 同步 agent 已經交件
|
||||
acked[a] = ("Async agent launched successfully" in txt)
|
||||
except OSError:
|
||||
pass
|
||||
# 主 transcript 讀不到 ⇒ 只靠 ③ 的 IDLE 窗，仍然不會卡死（誠實邊界 1）
|
||||
|
||||
running = [a for a in cand if a not in done and acked.get(a, True)]
|
||||
if len(running) < cap:
|
||||
raise SystemExit
|
||||
|
||||
running.sort(key=lambda a: -cand[a]["age"])
|
||||
|
||||
def human(s):
|
||||
if s < 90:
|
||||
return "%d 秒" % s
|
||||
if s < 5400:
|
||||
return "%d 分" % (s // 60)
|
||||
return "%.1f 小時" % (s / 3600.0)
|
||||
|
||||
rows = []
|
||||
for i, a in enumerate(running, 1):
|
||||
c = cand[a]
|
||||
# 🔴 只印名字/類型/時間，**不印 agentId**——那是 harness 明文說不要往外貼的內部值
|
||||
rows.append(" %d. %s（%s）｜已跑 %s｜最後一個動作 %s前"
|
||||
% (i, c["name"], c["type"], human(c["age"]), human(c["quiet"])))
|
||||
|
||||
print("BLOCK\t%d\t%d" % (len(running), cap))
|
||||
print("\n".join(rows))
|
||||
' 2>/dev/null) || {
|
||||
cat >&2 <<'EOM'
|
||||
⚠️ 並行閘（parallel-lines-cap-guard）自己出錯了，這一次**沒有把關**。
|
||||
放行是刻意的（算不出來就擋 ＝ 整台機器派不了工），但它不該安靜地過去。
|
||||
請把這一行連同當時的動作記到 inkstone/ISEP#109。
|
||||
EOM
|
||||
exit 0
|
||||
}
|
||||
|
||||
[ -n "${OUT:-}" ] || exit 0
|
||||
|
||||
KIND=$(printf '%s' "$OUT" | head -1 | cut -f1)
|
||||
|
||||
if [ "$KIND" = "NOTE" ]; then
|
||||
MSG=$(printf '%s' "$OUT" | head -1 | cut -f2-)
|
||||
printf '⚠️ %s\n 放行是刻意的，但它不該安靜地過去（inkstone/ISEP#109）。\n' "$MSG" >&2
|
||||
exit 0
|
||||
fi
|
||||
|
||||
N=$(printf '%s' "$OUT" | head -1 | cut -f2)
|
||||
CAPN=$(printf '%s' "$OUT" | head -1 | cut -f3)
|
||||
ROWS=$(printf '%s' "$OUT" | tail -n +2)
|
||||
|
||||
# ── 逃生門：用掉就消失，留在指令歷史上 ────────────────────────────────
|
||||
ESC="/tmp/.parallel-ok-${CLAUDE_SESSION_ID:-}"
|
||||
if [ -z "${CLAUDE_SESSION_ID:-}" ]; then
|
||||
ESC=$(printf '%s' "$INPUT" | python3 -c '
|
||||
import sys, json
|
||||
try: print("/tmp/.parallel-ok-" + (json.load(sys.stdin).get("session_id") or "nosid"))
|
||||
except Exception: print("/tmp/.parallel-ok-nosid")
|
||||
' 2>/dev/null || echo /tmp/.parallel-ok-nosid)
|
||||
fi
|
||||
if [ -f "$ESC" ]; then
|
||||
rm -f "$ESC"
|
||||
printf '🔓 並行閘：現在有 %s 條線在跑（上限 %s），逃生門已用掉，這一次放行。\n' "$N" "$CAPN" >&2
|
||||
exit 0
|
||||
fi
|
||||
|
||||
cat >&2 <<EOF
|
||||
🚦 同時跑的線已經到上限：**現在有 $N 條在跑，上限 $CAPN**。
|
||||
|
||||
現在在跑的是這幾條：
|
||||
$ROWS
|
||||
|
||||
【上限從哪來】leo 2026-08-29 原話：「因為剛剛造成 Mac 重啓，它很少這樣⋯⋯
|
||||
**跑 2-3 條應該是極限了**」——取他自己講的上限 3，所以第 4 條才擋。
|
||||
這台機器：Mac14,2 / M2 / 記憶體 8 GB / Swap 已用 914 MB。
|
||||
|
||||
【它花掉過什麼（2026-08-29，這張閘的來由）】
|
||||
同時開七條線（arcrun-rag#163／#164／Arcrun#176／#180／#185／#187／InkStoneCo#104）
|
||||
⇒ leo 的 Mac **重新開機**。而且同一天：派錯線 1 次、量錯東西 6 次、
|
||||
停掉正確的工作 1 次（MISTAKE 134）。
|
||||
⇒ **平行度超過盯得住的範圍時，錯誤率跟著上去。這條閘同時在省機器與省判斷力。**
|
||||
|
||||
【出路，挑一條】
|
||||
① **等**——上面某一條收工，這條就派得出去（收工通知一進 transcript 就解鎖，不用等 15 分鐘）。
|
||||
同一個回合可以先做別的不需要開新線的事。
|
||||
② **這條更急** ⇒ 用 SendMessage 把某一條停下來／收掉，再派。
|
||||
③ **真的非同時不可** ⇒ 在終端機跑
|
||||
touch $ESC
|
||||
然後重送。用掉就消失，會留在指令歷史上。
|
||||
④ 上限本身要調 ⇒ ISEP_MAX_PARALLEL_LINES=<n>（安靜窗 ISEP_PARALLEL_IDLE_SEC，預設 900 秒）。
|
||||
|
||||
🔴 這道閘擋的是總管自己，**沒有總管例外**。
|
||||
EOF
|
||||
exit 2
|
||||
Executable
+145
@@ -0,0 +1,145 @@
|
||||
#!/usr/bin/env bash
|
||||
# line-needs-own-worktree.sh 的迴歸測試（inkstone/ISEP#109 → comment 5391）。
|
||||
#
|
||||
# **離線、不打網路、不花錢、每次結果一樣**——判準只有兩個，兩個都是 git 自己回答的：
|
||||
# ①這條命令會不會移動 HEAD ②那個目錄是不是主工作目錄。所以不需要語意判官。
|
||||
#
|
||||
# 每個案例都自己開一顆真的 git repo（外加一份真的 linked worktree）。
|
||||
#
|
||||
# 三群，兩個方向都要有證據：
|
||||
# A 群「不該擋」——總管、唯讀動作、還原檔案、已經在自己的 worktree 裡、逃生門、
|
||||
# worktree add 本身（**這群紅了比漏擋嚴重**：擋掉它等於線動不了工）
|
||||
# B 群「該擋」 ——線在共用目錄裡 checkout／switch／-b，含 -C 與複合命令
|
||||
# C 群「訊息與副作用」——講得出目錄與指令、不要開在 /tmp、逃生門、
|
||||
# 以及**真的把說謊的登記清掉**（驗收條件 7）
|
||||
#
|
||||
# 用法：hooks/tests/line-needs-own-worktree.test.sh [hook 路徑]
|
||||
|
||||
set -u
|
||||
HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
HOOK="${1:-$(cd "$HERE/.." && pwd)/line-needs-own-worktree.sh}"
|
||||
|
||||
PASS=0; FAIL=0; N=0
|
||||
ROOT=$(mktemp -d "${TMPDIR:-/tmp}/isep-wt.XXXXXX")
|
||||
clean() { rm -rf "$ROOT"; }
|
||||
trap clean EXIT
|
||||
|
||||
# 🔴 macOS 的 $TMPDIR 是 /var/folders/… 而 git 回的是解析過的 /private/var/…
|
||||
# 測試比對前先把路徑解析掉，不然會拿「同一個目錄的兩種寫法」互比而假紅。
|
||||
ROOT=$(cd "$ROOT" && pwd -P)
|
||||
REPO="$ROOT/shared-repo"
|
||||
mkdir -p "$REPO"
|
||||
git -C "$REPO" init -q -b main
|
||||
git -C "$REPO" config user.email t@t; git -C "$REPO" config user.name t
|
||||
echo hi > "$REPO/a.txt"; git -C "$REPO" add -A; git -C "$REPO" commit -qm init
|
||||
git -C "$REPO" worktree add -q "$ROOT/own-wt" -b mine
|
||||
OWN="$ROOT/own-wt"
|
||||
PLAIN="$ROOT/not-a-repo"; mkdir -p "$PLAIN"
|
||||
|
||||
# payload <command> [cwd]
|
||||
payload() {
|
||||
python3 - "$1" "${2:-$REPO}" <<'PY'
|
||||
import json, sys
|
||||
print(json.dumps({"session_id": "S-WT", "hook_event_name": "PreToolUse", "cwd": sys.argv[2],
|
||||
"tool_name": "Bash", "tool_input": {"command": sys.argv[1]}},
|
||||
ensure_ascii=False))
|
||||
PY
|
||||
}
|
||||
|
||||
# t <期望 exit> <說明> <command> [cwd] [env 前綴]
|
||||
t() {
|
||||
local want="$1" desc="$2" cmd="$3" cwd="${4:-$REPO}" envs="${5:-CLAUDE_CODE_CHILD_SESSION=1}"
|
||||
N=$((N+1))
|
||||
local err rc
|
||||
err=$(printf '%s' "$(payload "$cmd" "$cwd")" | env $envs bash "$HOOK" 2>&1 >/dev/null); rc=$?
|
||||
LAST_ERR="$err"
|
||||
if [ "$rc" -eq "$want" ]; then
|
||||
printf ' ✅ %s\n' "$desc"; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ %s —— 期望 exit=%s，實得 exit=%s\n' "$desc" "$want" "$rc"
|
||||
printf '%s\n' "$err" | sed -n '1,8p' | sed 's/^/ /'
|
||||
FAIL=$((FAIL+1))
|
||||
fi
|
||||
}
|
||||
has() { N=$((N+1)); if printf '%s' "$LAST_ERR" | grep -qF -- "$1"; then printf ' ✅ %s\n' "$2"; PASS=$((PASS+1)); else printf ' ❌ %s —— 找不到「%s」\n' "$2" "$1"; FAIL=$((FAIL+1)); fi; }
|
||||
hasnt() { N=$((N+1)); if printf '%s' "$LAST_ERR" | grep -qF -- "$1"; then printf ' ❌ %s —— 出現了「%s」\n' "$2" "$1"; FAIL=$((FAIL+1)); else printf ' ✅ %s\n' "$2"; PASS=$((PASS+1)); fi; }
|
||||
|
||||
echo
|
||||
echo "── A 群：不該擋（誤攔比漏擋嚴重——擋錯了線就動不了工）──"
|
||||
|
||||
t 0 "① 總管（不是線）在共用目錄切分支 ⇒ 不管（那是他自己的目錄）" \
|
||||
"git checkout -b feat/x" "$REPO" "CLAUDE_CODE_CHILD_SESSION="
|
||||
t 0 "② git status ⇒ 唯讀，不管" "git status"
|
||||
t 0 "③ git log --oneline ⇒ 唯讀，不管" "git log --oneline -5"
|
||||
t 0 "④ git branch -a ⇒ 唯讀，不管" "git branch -a"
|
||||
t 0 "⑤ git checkout -- a.txt（還原檔案，不動 HEAD）⇒ 放行" "git checkout -- a.txt"
|
||||
t 0 "⑥ git checkout HEAD -- a.txt ⇒ 放行" "git checkout HEAD -- a.txt"
|
||||
t 0 "⑦ git restore a.txt ⇒ 放行（根本不是 checkout）" "git restore a.txt"
|
||||
t 0 "⑧ git checkout -p ⇒ 互動式挑 hunk，不動 HEAD，放行" "git checkout -p"
|
||||
t 0 "⑨ **已經在自己的 worktree 裡**切分支 ⇒ 放行（這是我們要它做的事）" \
|
||||
"git checkout -b feat/inside" "$OWN"
|
||||
t 0 "⑩ git worktree add ⇒ 放行（那是解法本身，不是病）" \
|
||||
"git worktree add $ROOT/wt2 -b feat/y"
|
||||
t 0 "⑪ 逃生門 WORKTREE_OK=1 ⇒ 放行" \
|
||||
"git checkout -b feat/z" "$REPO" "CLAUDE_CODE_CHILD_SESSION=1 WORKTREE_OK=1"
|
||||
t 0 "⑫ 不是 git 命令 ⇒ 不管" "npm test"
|
||||
t 0 "⑬ 目錄根本不是 git repo ⇒ 不管" "git checkout -b feat/x" "$PLAIN"
|
||||
t 0 "⑭ 命令裡有 checkout 這個字但不是 git 的（不看措辭，看動作）" \
|
||||
"echo '別忘了 git checkout 回 main'"
|
||||
t 0 "⑮ payload 壞掉 ⇒ 放行（不擋在不確定上）" ""
|
||||
|
||||
N=$((N+1))
|
||||
brc=$(printf 'not json' | CLAUDE_CODE_CHILD_SESSION=1 bash "$HOOK" >/dev/null 2>&1; echo $?)
|
||||
if [ "$brc" -eq 0 ]; then printf ' ✅ ⑯ 完全不是 JSON 的 payload ⇒ 放行\n'; PASS=$((PASS+1));
|
||||
else printf ' ❌ ⑯ payload 壞掉卻擋下來了（exit=%s）\n' "$brc"; FAIL=$((FAIL+1)); fi
|
||||
|
||||
echo
|
||||
echo "── B 群：該擋 ──"
|
||||
|
||||
t 2 "⑰ 線在共用目錄 git checkout -b ⇒ 擋" "git checkout -b feat/new"
|
||||
t 2 "⑱ 線在共用目錄 git switch -c ⇒ 擋" "git switch -c feat/new2"
|
||||
t 2 "⑲ 線在共用目錄 git checkout main ⇒ 擋（切回去也是切）" "git checkout main"
|
||||
t 2 "⑳ git -C <共用目錄> checkout（人在別的地方）⇒ 擋" "git -C $REPO checkout -b feat/c" "$PLAIN"
|
||||
t 2 "㉑ 複合命令 cd … && git checkout ⇒ 擋（一段一段拆）" "cd $REPO && git checkout -b feat/d"
|
||||
t 2 "㉒ 前面掛 env 的 git checkout ⇒ 擋" "FOO=1 git checkout -b feat/e"
|
||||
t 2 "㉓ git switch main ⇒ 擋" "git switch main"
|
||||
|
||||
echo
|
||||
echo "── C 群：訊息與副作用 ──"
|
||||
|
||||
t 2 "㉔ 擋下來（下面幾條檢查這一次的訊息）" "git checkout -b feat/msg"
|
||||
has "$REPO" "㉕ 說得出是哪個目錄"
|
||||
has "worktree add" "㉖ 給得出開自己 worktree 的指令"
|
||||
has "不要開在 /tmp" "㉗ 講得出不要開在 /tmp（08-29 實測：那些全 prunable）"
|
||||
has "WORKTREE_OK=1" "㉘ 講得出逃生門"
|
||||
has "worktree prune" "㉙ 講得出收工要怎麼收"
|
||||
hasnt '$(' "㉚ 訊息沒有被 shell 展開"
|
||||
|
||||
# 驗收條件 7：說謊的登記真的被清掉
|
||||
git -C "$REPO" worktree add -q "$ROOT/ghost" -b ghosted
|
||||
rm -rf "$ROOT/ghost"
|
||||
N=$((N+1))
|
||||
if git -C "$REPO" worktree list 2>/dev/null | grep -q prunable; then
|
||||
printf ' ✅ ㉛ 造出一筆「指向空氣」的登記（目錄砍掉、登記還在）\n'; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ ㉛ 造不出 prunable 的登記，下一條測不到東西\n'; FAIL=$((FAIL+1))
|
||||
fi
|
||||
t 2 "㉜ 這時候擋下來" "git checkout -b feat/prune"
|
||||
has "指向空氣" "㉝ 訊息說得出清掉了幾筆說謊的登記"
|
||||
N=$((N+1))
|
||||
if git -C "$REPO" worktree list 2>/dev/null | grep -q prunable; then
|
||||
printf ' ❌ ㉞ prune 沒有真的執行——登記簿還在說謊\n'; FAIL=$((FAIL+1))
|
||||
else
|
||||
printf ' ✅ ㉞ 說謊的登記真的被清掉了（prune 是收工動作，不是偶爾整理）\n'; PASS=$((PASS+1))
|
||||
fi
|
||||
N=$((N+1))
|
||||
if [ -d "$OWN" ] && git -C "$REPO" worktree list | grep -q "own-wt"; then
|
||||
printf ' ✅ ㉟ 而且還在的那份 worktree 一根寒毛都沒動\n'; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ ㉟ prune 把還在的 worktree 也弄掉了——那是災難\n'; FAIL=$((FAIL+1))
|
||||
fi
|
||||
|
||||
clean
|
||||
echo
|
||||
echo "══ $PASS/$N 通過${FAIL:+，$FAIL 個失敗} ══"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
Executable
+255
@@ -0,0 +1,255 @@
|
||||
#!/usr/bin/env bash
|
||||
# parallel-lines-cap-guard.sh 的迴歸測試（inkstone/ISEP#109）。
|
||||
#
|
||||
# **離線、不打網路、不花錢、每次結果一樣**——這支閘只讀檔案的存在與 mtime，
|
||||
# 沒有語意判官，所以不需要像 ask-user-question-guard 那樣另開一支 live 測試量準度。
|
||||
#
|
||||
# 每個案例都自己搭一份假的 harness 佈局（跟真的同形狀）：
|
||||
# <root>/<sid>.jsonl 主 transcript
|
||||
# <root>/<sid>/subagents/agent-<id>.meta.json harness 啟動那條線時寫的
|
||||
# <root>/<sid>/subagents/agent-<id>.jsonl 那條線自己的 transcript
|
||||
#
|
||||
# 三群，兩個方向都要有證據：
|
||||
# A 群「不該擋」——沒到上限、已收工、當掉的線、逃生門、不是派工的工具、
|
||||
# 主 transcript 讀不到（**這群紅了比漏擋嚴重**：誤攔會讓整台機器派不了工）
|
||||
# B 群「該擋」 ——到上限、超過上限、上限可調、巢狀也算
|
||||
# C 群「訊息本身」——列得出現在有哪幾條在跑、不外洩 agentId、沒有被 shell 展開
|
||||
#
|
||||
# 用法：hooks/tests/parallel-lines-cap-guard.test.sh [hook 路徑]
|
||||
|
||||
set -u
|
||||
HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
HOOK="${1:-$(cd "$HERE/.." && pwd)/parallel-lines-cap-guard.sh}"
|
||||
|
||||
PASS=0; FAIL=0; N=0
|
||||
ROOT=$(mktemp -d "${TMPDIR:-/tmp}/isep-parcap.XXXXXX")
|
||||
SID="S-PARCAP-TEST"
|
||||
ESC="/tmp/.parallel-ok-$SID"
|
||||
clean() { rm -rf "$ROOT"; rm -f "$ESC"; }
|
||||
trap clean EXIT
|
||||
|
||||
# reset —— 每個案例從空的佈局開始
|
||||
reset() {
|
||||
rm -rf "$ROOT/$SID" "$ROOT/$SID.jsonl"
|
||||
mkdir -p "$ROOT/$SID/subagents"
|
||||
: > "$ROOT/$SID.jsonl"
|
||||
}
|
||||
|
||||
# line <id> <名字> <型別> <安靜幾秒> [tool_use_id]
|
||||
# 造一條「在跑的線」：meta 在、jsonl 在、jsonl 的 mtime 是 <安靜幾秒> 前
|
||||
line() {
|
||||
local id="$1" name="$2" typ="$3" quiet="$4" tuid="${5:-toolu_$1}"
|
||||
local d="$ROOT/$SID/subagents"
|
||||
printf '{"agentType":"%s","description":"%s 的說明","name":"%s","toolUseId":"%s","spawnDepth":1}\n' \
|
||||
"$typ" "$name" "$name" "$tuid" > "$d/agent-$id.meta.json"
|
||||
printf '{"agentId":"%s"}\n' "$id" > "$d/agent-$id.jsonl"
|
||||
python3 - "$d/agent-$id.jsonl" "$quiet" <<'PY'
|
||||
import os, sys, time
|
||||
p, q = sys.argv[1], int(sys.argv[2])
|
||||
t = time.time() - q
|
||||
os.utime(p, (t, t))
|
||||
PY
|
||||
}
|
||||
|
||||
# finished <id> —— 在主 transcript 補一則完工通知（實跡格式）
|
||||
finished() {
|
||||
printf '{"type":"queue-operation","operation":"enqueue","sessionId":"%s","content":"<task-notification>\\n<task-id>%s</task-id>\\n<tool-use-id>toolu_%s</tool-use-id>\\n"}\n' \
|
||||
"$SID" "$1" "$1" >> "$ROOT/$SID.jsonl"
|
||||
}
|
||||
|
||||
# launch_ack <tool_use_id> —— 背景 agent 剛啟動時的 tool_result（實跡文字）
|
||||
launch_ack() {
|
||||
python3 - "$1" <<'PY' >> "$ROOT_ENV/$SID_ENV.jsonl"
|
||||
import json, sys
|
||||
tuid = sys.argv[1]
|
||||
print(json.dumps({"type": "user", "message": {"role": "user", "content": [
|
||||
{"type": "tool_result", "tool_use_id": tuid,
|
||||
"content": [{"type": "text", "text": "Async agent launched successfully. agentId: xyz"}]}]}},
|
||||
ensure_ascii=False))
|
||||
PY
|
||||
}
|
||||
|
||||
# sync_result <tool_use_id> —— 同步 agent 交件了：tool_result 是真的結果，不是 launch ack
|
||||
sync_result() {
|
||||
python3 - "$1" <<'PY' >> "$ROOT_ENV/$SID_ENV.jsonl"
|
||||
import json, sys
|
||||
tuid = sys.argv[1]
|
||||
print(json.dumps({"type": "user", "message": {"role": "user", "content": [
|
||||
{"type": "tool_result", "tool_use_id": tuid,
|
||||
"content": [{"type": "text", "text": "做完了，結論如下……"}]}]}},
|
||||
ensure_ascii=False))
|
||||
PY
|
||||
}
|
||||
export ROOT_ENV="$ROOT" SID_ENV="$SID"
|
||||
|
||||
# payload [tool_name] [transcript_path]
|
||||
payload() {
|
||||
python3 - "${1:-Agent}" "${2:-$ROOT/$SID.jsonl}" "$SID" <<'PY'
|
||||
import json, sys
|
||||
print(json.dumps({"session_id": sys.argv[3], "hook_event_name": "PreToolUse",
|
||||
"transcript_path": sys.argv[2], "tool_name": sys.argv[1],
|
||||
"tool_input": {"prompt": "【工單】inkstone/ISEP#109"}},
|
||||
ensure_ascii=False))
|
||||
PY
|
||||
}
|
||||
|
||||
# t <期望 exit> <說明> [tool_name] [transcript_path] [env 前綴]
|
||||
t() {
|
||||
local want="$1" desc="$2" tool="${3:-Agent}" tpath="${4:-$ROOT/$SID.jsonl}" envs="${5:-}"
|
||||
N=$((N+1))
|
||||
local err rc
|
||||
err=$(printf '%s' "$(payload "$tool" "$tpath")" | env $envs bash "$HOOK" 2>&1 >/dev/null); rc=$?
|
||||
LAST_ERR="$err"
|
||||
if [ "$rc" -eq "$want" ]; then
|
||||
printf ' ✅ %s\n' "$desc"; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ %s —— 期望 exit=%s，實得 exit=%s\n' "$desc" "$want" "$rc"
|
||||
printf '%s\n' "$err" | sed -n '1,8p' | sed 's/^/ /'
|
||||
FAIL=$((FAIL+1))
|
||||
fi
|
||||
}
|
||||
|
||||
# has <該出現的字串> <說明>
|
||||
has() {
|
||||
N=$((N+1))
|
||||
if printf '%s' "$LAST_ERR" | grep -qF -- "$1"; then
|
||||
printf ' ✅ %s\n' "$2"; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ %s —— 訊息裡找不到「%s」\n' "$2" "$1"; FAIL=$((FAIL+1))
|
||||
fi
|
||||
}
|
||||
|
||||
# hasnt <不該出現的字串> <說明>
|
||||
hasnt() {
|
||||
N=$((N+1))
|
||||
if printf '%s' "$LAST_ERR" | grep -qF -- "$1"; then
|
||||
printf ' ❌ %s —— 訊息裡出現了「%s」\n' "$2" "$1"; FAIL=$((FAIL+1))
|
||||
else
|
||||
printf ' ✅ %s\n' "$2"; PASS=$((PASS+1))
|
||||
fi
|
||||
}
|
||||
|
||||
echo
|
||||
echo "── A 群：不該擋（誤攔比漏擋嚴重——擋錯了整台機器派不了工）──"
|
||||
|
||||
reset
|
||||
t 0 "① 一條線都沒派過（連 subagents 目錄都空）⇒ 放行"
|
||||
|
||||
reset; line a1 收檔那條 rag-collector 5
|
||||
t 0 "② 只有 1 條在跑（上限 3）⇒ 放行"
|
||||
|
||||
reset; line a1 一號 rag-collector 5; line a2 二號 arcrun-engineer 5
|
||||
t 0 "③ 2 條在跑（上限 3）⇒ 放行"
|
||||
|
||||
reset
|
||||
for i in 1 2 3 4 5; do line "b$i" "第$i號" rag-collector 5; finished "b$i"; done
|
||||
t 0 "④ 5 條都收到完工通知 ⇒ 放行（前一條收工後，下一條派得出去）"
|
||||
|
||||
reset
|
||||
for i in 1 2 3 4 5; do line "c$i" "第$i號" rag-collector 3600; done
|
||||
t 0 "⑤ 5 條的 transcript 都安靜超過 15 分（收工了或當掉）⇒ 放行，不會永久卡死"
|
||||
|
||||
reset; line d1 一號 rag-collector 5; line d2 二號 rag-collector 5; line d3 三號 rag-collector 5
|
||||
t 0 "⑥ 到上限，但動作不是派工（Bash）⇒ 這支不管" Bash
|
||||
|
||||
reset; line e1 一號 rag-collector 5; line e2 二號 rag-collector 5; line e3 三號 rag-collector 5
|
||||
touch "$ESC"
|
||||
t 0 "⑦ 到上限但逃生門在 ⇒ 放行"
|
||||
N=$((N+1))
|
||||
if [ -f "$ESC" ]; then
|
||||
printf ' ❌ ⑧ 逃生門用完沒被消耗——那會變成永久豁免\n'; FAIL=$((FAIL+1))
|
||||
else
|
||||
printf ' ✅ ⑧ 逃生門用掉就消失（不是永久豁免）\n'; PASS=$((PASS+1))
|
||||
fi
|
||||
|
||||
reset; line f1 一號 rag-collector 5; line f2 二號 rag-collector 5; line f3 三號 rag-collector 5
|
||||
finished f2
|
||||
t 0 "⑨ 3 條裡有 1 條收工了 ⇒ 剩 2 條，放行"
|
||||
|
||||
reset; line g1 一號 rag-collector 5 toolu_G1; line g2 二號 rag-collector 5 toolu_G2; line g3 三號 rag-collector 5 toolu_G3
|
||||
sync_result toolu_G2
|
||||
t 0 "⑩ 同步 agent 的 tool_result 不是 launch ack ⇒ 算它交件了，放行"
|
||||
|
||||
reset; line h1 一號 rag-collector 5; line h2 二號 rag-collector 5
|
||||
rm -f "$ROOT/$SID.jsonl"
|
||||
t 0 "⑪ 主 transcript 讀不到，只靠安靜窗 ⇒ 2 條不到上限，放行"
|
||||
|
||||
reset; line i1 一號 rag-collector 5; line i2 二號 rag-collector 5; line i3 三號 rag-collector 5
|
||||
t 0 "⑫ transcript_path 指到不存在的佈局 ⇒ 數不出來就放行（不擋在不確定上）" \
|
||||
Agent "$ROOT/nowhere/NOPE.jsonl"
|
||||
|
||||
N=$((N+1))
|
||||
brc=$(printf 'this is not json' | bash "$HOOK" >/dev/null 2>&1; echo $?)
|
||||
if [ "$brc" -eq 0 ]; then
|
||||
printf ' ✅ ⑬ payload 壞掉 ⇒ 放行（fail-open 是刻意的）\n'; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ ⑬ payload 壞掉卻擋下來了（exit=%s）——那會卡死整台機器\n' "$brc"; FAIL=$((FAIL+1))
|
||||
fi
|
||||
N=$((N+1))
|
||||
bmsg=$(printf 'this is not json' | bash "$HOOK" 2>&1 >/dev/null)
|
||||
if printf '%s' "$bmsg" | grep -q "沒有把關"; then
|
||||
printf ' ✅ ⑭ 而且它會出聲說「這一次沒有把關」（不是靜默放行）\n'; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ ⑭ 出錯時靜默放行了——房規禁止靜默\n'; FAIL=$((FAIL+1))
|
||||
fi
|
||||
|
||||
echo
|
||||
echo "── B 群：該擋 ──"
|
||||
|
||||
reset; line j1 一號 rag-collector 5; line j2 二號 arcrun-engineer 5; line j3 三號 isep-guard 5
|
||||
t 2 "⑮ 剛好 3 條在跑（上限 3）⇒ 擋第 4 條"
|
||||
|
||||
reset
|
||||
for i in 1 2 3 4 5 6 7; do line "k$i" "第$i號" rag-collector 5; done
|
||||
t 2 "⑯ 7 條在跑（就是 08-29 那天的形狀）⇒ 擋"
|
||||
|
||||
reset; line l1 一號 rag-collector 5
|
||||
t 2 "⑰ 上限調成 1，1 條在跑 ⇒ 擋（上限可調）" Agent "$ROOT/$SID.jsonl" "ISEP_MAX_PARALLEL_LINES=1"
|
||||
|
||||
reset; line m1 一號 rag-collector 5; line m2 二號 rag-collector 5; line m3 三號 rag-collector 5
|
||||
t 2 "⑱ Task 這條路也管得到（不是只認 Agent）" Task
|
||||
|
||||
reset; line n1 一號 rag-collector 5 toolu_N1; line n2 二號 rag-collector 5 toolu_N2; line n3 三號 rag-collector 5 toolu_N3
|
||||
launch_ack toolu_N1; launch_ack toolu_N2; launch_ack toolu_N3
|
||||
t 2 "⑲ 三條都只有 launch ack（還在跑）⇒ 擋"
|
||||
|
||||
reset
|
||||
for i in 1 2 3; do line "o$i" "第$i號" rag-collector 5; done
|
||||
python3 - "$ROOT/$SID/subagents/agent-o2.meta.json" <<'PY'
|
||||
import json, sys
|
||||
p = sys.argv[1]; d = json.load(open(p)); d["spawnDepth"] = 2
|
||||
json.dump(d, open(p, "w"), ensure_ascii=False)
|
||||
PY
|
||||
t 2 "⑳ 巢狀派出去的線（spawnDepth 2）一樣算進去——它一樣吃記憶體"
|
||||
|
||||
reset; line p1 一號 rag-collector 5; line p2 二號 rag-collector 5; line p3 三號 rag-collector 5
|
||||
touch "$ESC"
|
||||
printf '%s' "$(payload)" | bash "$HOOK" >/dev/null 2>&1
|
||||
t 2 "㉑ 逃生門用過一次之後，第二次照樣擋"
|
||||
|
||||
reset; line q1 一號 rag-collector 890; line q2 二號 rag-collector 890; line q3 三號 rag-collector 890
|
||||
t 2 "㉒ 安靜 890 秒（還在 900 秒窗內）⇒ 仍算在跑，擋"
|
||||
|
||||
echo
|
||||
echo "── C 群：訊息本身 ──"
|
||||
|
||||
reset
|
||||
line r1 install-twice-163 rag-collector 5
|
||||
line r2 dup-machine-icon-185 arcrun-engineer 5
|
||||
line r3 parallel-cap-109 isep-guard 5
|
||||
t 2 "㉓ 到上限 ⇒ 擋（下面幾條檢查這一次的訊息）"
|
||||
has "現在有 3 條在跑" "㉔ 說得出現在有幾條在跑"
|
||||
has "install-twice-163" "㉕ 列得出第一條的名字"
|
||||
has "dup-machine-icon-185" "㉖ 列得出第二條的名字"
|
||||
has "parallel-cap-109" "㉗ 列得出第三條的名字"
|
||||
has "跑 2-3 條應該是極限了" "㉘ 說得出上限從哪來（leo 原話）"
|
||||
has "touch /tmp/.parallel-ok-" "㉙ 講得出逃生門怎麼開"
|
||||
has "ISEP_MAX_PARALLEL_LINES" "㉚ 講得出上限怎麼調"
|
||||
has "沒有總管例外" "㉛ 講明它擋的是總管自己"
|
||||
hasnt "agentId" "㉜ 不外洩 harness 說不要往外貼的內部 id"
|
||||
hasnt '$(' '㉝ 訊息沒有被 shell 展開（錢字號括號不該留在輸出裡）'
|
||||
|
||||
clean
|
||||
echo
|
||||
echo "══ $PASS/$N 通過${FAIL:+，$FAIL 個失敗} ══"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
Reference in New Issue
Block a user