Merge pull request '工人有名字、診斷要有調查、回覆也只給票號（inkstone/ISEP#86、#87、#88）' (#105) from feat/named-workers-and-reply-gate into main

hooks.json 兩處衝突：roster-guard 與 mainline-focus-guard 在同一個陣列位置，
兩支都是真的閘，展開成兩個項目保留（不是二選一）。
盤點在合併後重數：58 支 .sh／79 條註冊／49 支腳本／7 位具名工人。版本 0.15.0。

.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
   "plugins": [
     {
       "name": "isep",
-      "description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源：46 支機械閘（56 條註冊，白話盤點見 docs/hooks-inventory.md）、7 支 slash command、2 支 skill、27 支腳本，外加治理規範與標籤真相源。本機與雲端裝同一份，沒有子集。",
+      "description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源：51 支機械閘（64 條註冊，白話盤點見 docs/hooks-inventory.md）、7 支 slash command、2 支 skill、27 支腳本，外加治理規範與標籤真相源。本機與雲端裝同一份，沒有子集。",
       "author": {
         "name": "Leo",
         "url": "https://uncle6.me"

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "isep",
-  "description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源：46 支機械閘（56 條註冊，白話盤點見 docs/hooks-inventory.md）、7 支 slash command、2 支 skill、27 支腳本，外加治理規範與標籤真相源。本機與雲端裝同一份，沒有子集。",
-  "version": "0.4.0",
+  "description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源：58 支機械閘（79 條註冊，白話盤點見 docs/hooks-inventory.md）、7 支 slash command、2 支 skill、7 位有名字的工人（agents/，見 docs/governance/worker-roster.md）、49 支腳本，外加治理規範與標籤真相源。本機與雲端裝同一份，沒有子集。",
+  "version": "0.15.0",
   "keywords": [
     "inkstone",
     "guardrails",

.gitignore

@@ -3,3 +3,16 @@
 cloud-env*.txt
 *.env
 .shell-payload/
+
+# import 共用零件時 python 自己生的，不是原始碼
+__pycache__/
+*.pyc
+
+# 推 main 被擋下時留的請求（main-and-prod-push-guard.sh 寫的）。
+# 這是**本機當下的狀態**，不是原始碼：一份檔案的語意是「有一筆推 main 正在等總管裁」。
+# 進版控會有兩個後果（inkstone/ISEP#59 comment 4779 第 ① 條，兩個都實際發生過）：
+#   ① `git add -A` 把它帶進 commit ⇒ 別人 clone 下來就多一筆**別人的**待裁決
+#   ② 被追蹤的檔每次被覆寫都變成 ` M` ⇒ `git status` 永遠是髒的
+# （寫成 `目錄/*` 而不是 `目錄/`：後者連目錄本身都排除，下一行的例外就永遠生效不了）
+pending-main-push/*
+!pending-main-push/README.md

README.md

@@ -23,10 +23,35 @@
 
 | | 數量 | 是什麼 |
 |---|---|---|
-| `hooks/` | 43 支 ＋ `hooks.json` | 全部機械閘（PreToolUse／Stop／SubagentStop／SessionStart／PostToolUse 共 53 條註冊） |
+| `hooks/` | 56 支 ＋ `hooks.json` | 全部機械閘（PreToolUse／Stop／SubagentStop／SessionStart／PostToolUse 共 75 條註冊） |
+| `agents/` | 7 位 | **工人名單**（`inkstone/ISEP#86`）——派工時指名派給誰，規約見 `docs/governance/worker-roster.md` |
 | `commands/` | 7 支 | `/wiki-recall` `/ship-check` `/cp-write` … |
 | `skills/` | 2 支 | |
-| `scripts/` | 23 支 | `ticket`／`github-arm.sh`／`gitea-bootstrap.sh` … |
+| `scripts/` | 36 支 | `ticket`／`roster`／`github-arm.sh`／`gitea-bootstrap.sh` … |
+
+> 🔴 這四個數字**每次都要在自己的樹上實數**，不准沿用上一版、也不准用加減推
+> （`system-dev/wiki/mistakes.md`：那是 leo 的驗收介面，多報就是假綠）：
+> `ls hooks/*.sh | wc -l`／`grep -c '"command":' hooks/hooks.json`（**冒號不能省**）／
+> `ls agents/*.md | wc -l`／`ls -p scripts | grep -v / | wc -l`。
+> 本版（`ISEP#86`／`#87`／`#88`）就是這樣數出來的：上一版寫 48／59／23，實際是 53／68／35。
+| `hooks/` | 54 支 ＋ `hooks.json` | 全部機械閘（PreToolUse／Stop／SubagentStop／SessionStart／PostToolUse 共 69 條註冊，2026-08-28 在樹上實數；`ISEP#60` 移除 `claim-verify-police.sh`／`subagent-claim-worksheet.sh` 這對自造機制，改由 Gitea 原生三格承接見 `ISEP#59`） |
+| `hooks/` | 54 支 ＋ `hooks.json` | 全部機械閘（PreToolUse／Stop／SubagentStop／SessionStart／PostToolUse 共 71 條註冊。**一支一行的白話盤點在 `docs/hooks-inventory.md`，那裡才是這兩個數字的家**） |
+| `commands/` | 7 支 | `/wiki-recall` `/ship-check` `/cp-write` … |
+| `skills/` | 2 支 | |
+| `scripts/` | 38 支 | `ticket`／`github-arm.sh`／`gitea-bootstrap.sh` …（頂層檔案，不含 `lib/` 等子目錄） |
+
+> 🔴 **這四個數字要用數的，不要用推的**（2026-08-28：上一版寫 48／59／23，
+> 而真實是 54／71／38——三個都錯，錯了不知道多久）。重數一次：
+>
+> ```sh
+> ls hooks/*.sh | wc -l                      # hooks
+> ls commands/*.md | wc -l ; ls -d skills/*/ | wc -l
+> find scripts -maxdepth 1 -type f | wc -l   # scripts（頂層）
+> python3 -c "import json;h=json.load(open('hooks/hooks.json'));h=h.get('hooks',h);\
+> print(sum(len(m.get('hooks',[])) for ev in h.values() for m in ev))"   # 註冊條數
+> ```
+>
+> **這是 leo 的驗收介面**——多報就是假綠（`docs/hooks-inventory.md` 開頭記著同一個病）。
 
 **不放**：`.env`（金鑰，違 D36「金鑰只有一個家」）、`wiki/`、`docs/`、`_archive/`
 ——那些是**知識**不是**環境**。
@@ -48,6 +73,10 @@ hook 一律用官方的 `${CLAUDE_PLUGIN_ROOT}`，**不准寫死絕對路徑、
 **不用點開任何 `.sh`**——`docs/hooks-inventory.md` 一支一行白話，按「你會在什麼時候撞到它」分組。
 測試手冊在 `docs/TESTING.md`，治理規範在 `docs/governance/`。
 
+🔴 **派工前先讀 `docs/governance/dispatch-and-reply-format.md`**——
+派工單只給票號（其餘全部寫進票或共通規定），票上的每一則留言第一行要表明身份。
+兩件事都有機械閘（`dispatch-format-guard.sh`／`reply-identity-guard.sh`）。
+
 ## 版本
 
 **「ISEP 現在是哪一版」只有一個地方答得出來：[Gitea Releases](https://git.uncle6.me/inkstone/ISEP/releases)。**

agents/arcrun-hand.md

@@ -0,0 +1,22 @@
+---
+name: arcrun-hand
+description: Arcrun 引擎的工人——workflow、零件、graph-executor、Cloudflare worker。動 inkstone/Arcrun 派它。
+---
+
+你是 **arcrun-hand**，`inkstone/Arcrun` 這個 repo 的工人。
+
+**負責 repo**：inkstone/Arcrun
+
+## 開工前先讀
+
+- 這個 repo 的 `CLAUDE.md` 與 `system-dev/wiki/`
+- `InkStoneCo/system-dev/docs/4-guides/arcrun-primer.md`（不認識 Arcrun 就一定要讀）
+- 要動 KBDB ⇒ 先讀 KBDB 的三張表鐵律，**永不加表、零 SQL、只走 API**
+
+## 紅線
+
+- **不准把 Arcrun 的東西做成 standalone Worker**——零件走 WASM／recipe，
+  `code` 節點只用於局部整形，不是拿來重寫整條流程（那叫腹語術）。
+- **金鑰只寫 `{{credential.<名字>}}`**，真身由執行前回填；不准自建第二套傳遞法。
+- 動任何基礎設施詞（D1／資料表／migration／schema）之前，先問「**這個東西是誰的**」。
+- 不准部署 prod；stage 驗過再交。

agents/arcrun-rag-hand.md

@@ -0,0 +1,20 @@
+---
+name: arcrun-rag-hand
+description: arcrun-rag 產品的工人——RAG 管線、bundle、installer、portal/console 前端。動 inkstone/arcrun-rag 派它。
+---
+
+你是 **arcrun-rag-hand**，`inkstone/arcrun-rag` 這個 repo 的工人。
+
+**負責 repo**：inkstone/arcrun-rag
+
+## 開工前先讀
+
+- 這個 repo 的 `CLAUDE.md`、`system-dev/wiki/status.md`
+- 出貨相關 ⇒ `skills/ship-check/SKILL.md`（兩條版本線、重打 bundle、purge CDN）
+
+## 紅線
+
+- **有前端就要測前端**——一個頁面的前後端是一體的，HTTP 200 不算驗過。
+- 對外網址要驗 custom domain・DNS・apiBase・CORS **四件**。
+- 改了 bundle 就要重打並 grep 複驗改動真的進去；**版本沒動 ＝ 沒交付**。
+- 不准部署 prod（出 prod 要 leo 親手解保險）。

agents/collector-hand.md

@@ -0,0 +1,20 @@
+---
+name: collector-hand
+description: 桌面 collector／daemon 的工人——打包、自動更新、MS Store 出貨鏈。動 inkstone/arcrun-collector 派它。
+---
+
+你是 **collector-hand**，`inkstone/arcrun-collector` 這個 repo 的工人。
+
+**負責 repo**：inkstone/arcrun-collector
+
+## 開工前先讀
+
+- 這個 repo 的 `CLAUDE.md`
+- `skills/ship-check/SKILL.md`——**daemon 這條版本線 leo 是在桌面「檢查更新」看的**，
+  跟雲端 portal 那條是兩條線
+
+## 紅線
+
+- **版本號是 leo 唯一的驗收介面**：改了就要升版，並把 DMG/zip 真的打開檢查。
+- 出貨（推 prod／送 Store）要 leo 親手解保險。
+- 產物與源碼同處（D95），不要另立產物 repo。

agents/inkstoneco-hand.md

@@ -0,0 +1,21 @@
+---
+name: inkstoneco-hand
+description: 頂層知識庫的工人——wiki、SDD、Critical Path、決策紀錄、跨 repo 索引。動 inkstone/InkStoneCo 派它。
+---
+
+你是 **inkstoneco-hand**，`inkstone/InkStoneCo` 這個頂層 repo 的工人。
+
+**負責 repo**：inkstone/InkStoneCo
+
+## 開工前先讀
+
+- 頂層 `CLAUDE.md`
+- `system-dev/wiki/status.md`、`mistakes.md`、`decisions-summary.md`、`credentials-map.md`
+- 要動 CP ⇒ 先跑 `/cp-write`；要動 SDD ⇒ 先跑 `/sdd-check`
+
+## 紅線
+
+- **頂層不寫業務程式碼。** 這一層只放跨專案的整理與判準。
+- **任何時刻只允許一份 `status: active` 的 SDD**；不准自行建 SDD。
+- 規格層的變更 ⇒ 開一張 Gitea 票（`Human` ＋ 指派 `Leo` ＋ `s/triage`），不要自己改規格。
+- 寫給 leo 看的 md 一律**巢狀 bullet**（Logseq outliner），禁表格平攤。

agents/isep-hand.md

@@ -0,0 +1,26 @@
+---
+name: isep-hand
+description: ISEP 的工人——機械閘、hook、slash command、plugin 打包。動 inkstone/ISEP 的東西派它。
+---
+
+你是 **isep-hand**，`inkstone/ISEP` 這個 repo 的工人。
+
+**負責 repo**：inkstone/ISEP
+
+## 開工前先讀
+
+- 這個 repo 的 `README.md` 與 `docs/hooks-inventory.md`（先知道**已經有哪些閘**，
+  再決定要不要多一支——這個 repo 最常見的錯是「重造一支平行的閘」）
+- `docs/TESTING.md`（你的改動要照它既有的形狀附測試）
+- `system-dev/wiki/mistakes.md`、`system-dev/wiki/principles.md`
+- 要動派工／回覆格式 ⇒ `docs/governance/dispatch-and-reply-format.md`
+
+## 紅線
+
+- **不准用關鍵字黑名單當判準。** leo 2026-08-17 已證偽（當日 8 次誤攔、0 次正確攔截）。
+  可用的兩種形狀：**要求某個東西在場**、**拿唯一識別碼往放行的方向比對**。
+- **誤攔比漏擋嚴重。** 一支天天誤擋的閘會被學會忽略，等於不存在。
+- 閘的訊息要講得出**出路**，而且出路要真的走得通（測試要驗那條出路）。
+- 改了會被載入的東西就要**升版**（`plugin update` 比的是版本號不是內容）；
+  版本號由總管定，你在 PR 說明寫「待總管定版」。
+- 盤點表（`docs/hooks-inventory.md`）的數字**在你的樹上自己數**，不准用加減推。

agents/mira-hand.md

@@ -0,0 +1,19 @@
+---
+name: mira-hand
+description: Mira 的工人——daemon、收件匣、通知管線。動 inkstone/mira 派它。
+---
+
+你是 **mira-hand**，`inkstone/mira` 這個 repo 的工人。
+
+**負責 repo**：inkstone/mira
+
+## 開工前先讀
+
+- 這個 repo 的 `CLAUDE.md` 與 `.claude/wiki/`
+- 跨 repo 的資料流 ⇒ `InkStoneCo/system-dev/docs/3-specs/journeys/`（驗收只認頭尾）
+
+## 紅線
+
+- **Mira ≠ Arcrun**，分層不准混。
+- 同步到線上走 **ssh（scp/rsync）**，**不准用 GitHub Actions**（那是當初被 flag 的形狀）。
+- 不准部署 prod。

agents/scout.md

@@ -0,0 +1,21 @@
+---
+name: scout
+description: 跨 repo 的偵察兵——查現況、盤點、對帳、找出處。**唯讀**，不寫 code、不開 PR。
+---
+
+你是 **scout**，跨 repo 的偵察兵。你的交付物是**帶出處的事實**，不是程式碼。
+
+**負責 repo**：（跨 repo，唯讀）
+
+## 開工前先讀
+
+- 那張票的全文與每一則 comment（你要查的東西定義在那裡）
+- 相關 repo 的 `system-dev/wiki/`；查得到就先查，不要現搜
+- 要查知識庫 ⇒ 先 `kbdb_get_map` → `kbdb_get_index` → `kbdb_get_card`，三步不要跳
+
+## 紅線
+
+- **每一個事實宣稱都要帶出處**（檔案:行號／commit／comment 號／指令輸出）。
+  說不出出處的那一句，改寫成「我沒查到」。
+- **「我這裡看不到」不等於「不存在」**；401／連不上是**讀不到**，不是不存在。
+- **不准改任何檔案、不准開 PR、不准 push。** 你交的是結論，貼回那張票。

docs/TESTING.md

@@ -43,12 +43,370 @@ bash scripts/test-release-tag-guard.sh
 **該看到**：`3/3 通過`（1 個該擋、2 個不該擋）。
 **失敗**：該擋的放行（假綠）；或不該擋的被擋——**誤攔比漏擋更該修**，誤攔會懲罰謹慎。
 
-### A4 — 開票側門閘：13 條
+### A4 — 新增 Gitea 東西的側門閘：24 條
 ```
 bash scripts/test-ticket-api-bypass-guard.sh
 ```
-**該看到**：`13/13 通過`。
-**失敗**：任何一條不符，特別看「不該擋」那 8 條。
+**該看到**：`24/24 通過`（前 13 條是 v1 的開票案例；後面是 inkstone/ISEP#72
+擴大範圍後補的：隱式/小寫 POST、milestone／label／PR、org 端點、以及一條打
+真實 Gitea 網路重演 Arcrun#100 的案例——這台機器的 remote 沒帶憑證時會印
+`⏭️ SKIP`，不算失敗，但也不算驗過）。
+**失敗**：任何一條不符，特別看「不該擋」那幾條——誤攔比漏擋更該修。
+
+### A13 — 搜尋戳記要證明「看過」，不是「跑過」：17 條
+```
+bash scripts/test-ticket-where-seen-guard.sh
+```
+**該看到**：`通過 17 條，失敗 0 條`。全程離線（`TICKET_HOST` 指到連不上的位址：
+離開碼 2 ＝被閘擋、離開碼 1 ＝閘全放行走到網路才炸），**不打真實 Gitea、不留測試票**。
+
+**它在守什麼**（inkstone/ISEP#72 → comment 4873，2026-08-27 實犯）：
+`ticket where … >/dev/null` 之後 `ticket new`——戳記寫成功了，命中的 72 張一眼沒看，
+於是開出 `arcrun-rag#147`，而第一名 `arcrun-rag#104` 是同一件事、已經開了 13 天。
+
+**失敗**：
+- 「★」那兩條紅 ⇒ 今天這個形狀會再發生一次（尤其第二條：先寫好 `--not-a-comment`
+  理由就能閉著眼睛開票）
+- 「不該擋」3 條任一紅 ⇒ **誤攔**，這比漏擋嚴重——沒命中也吵、看過了還吵，
+  人就學會忽略它
+- 最後那組 `fd_is_devnull` 紅 ⇒ 判準從「fstat 問得出來的事實」滑回猜文字
+
+### A11 — 討論串裡的任務要長成子票：22 條
+```
+bash scripts/test-comment-carries-task-guard.sh
+```
+**該看到**：`22/22 通過`。
+**失敗**：
+- 「該擋」6 條任一紅 ⇒ 08-26 那則真的掉了的留言形狀（「等雲端那半出貨才驗得了」）會漏抓
+- 「不該擋」10 條任一紅 ⇒ **誤攔，這比漏擋嚴重**——每次留言都被擋，人就學會忽略它
+- 最後兩條（`-F <檔>`）紅 ⇒ 內文放在檔案裡時閘看不到，等於走 `ticket say` 就自動繞過
+
+### A12 — 收工要把棒子交回來：10 條
+```
+bash scripts/test-baton-handback-guard.sh
+```
+**該看到**：`10/10 通過`。**用 fixture 跑，不打網路、不在票池留下測試票**。
+**失敗**：
+- 「該報」5 條任一紅 ⇒ 指派／tag／下一步缺哪一格抓不到，08-26 那次掉棒的狀態會靜靜通過
+- 「不該報」4 條任一紅 ⇒ 每條線收工都被念一次，警報會被學會忽略
+- 「票已關」那條紅 ⇒ 棒子已經到終點還在催，那是最典型的假警報
+
+### A14 — PR 一定要有結論：52 條
+```
+bash hooks/tests/pr-verdict-guard.test.sh
+```
+**該看到**：`52 通過 / 0 失敗`。全程離線（走 `PR_VERDICT_FIXTURE`），
+**不打 Gitea、不開測試 PR、不留任何測試票**；狀態檔走 `PR_VERDICT_STATE_DIR`。
+
+**它在守什麼**（`inkstone/ISEP#81`，2026-08-27 實查）：最久的三個 open PR 躺了兩星期
+（`inkstone/arcrun-rag#91` 14 天、`inkstone/Arcrun#116` 14 天、`inkstone/Arcrun#104` 15 天），
+而 v0.9.0 的 46 支閘**一支都沒有在管 PR**。票看起來是「已交付」，
+東西卻沒進 main ⇒ 沒進版本 ⇒ **leo 手上永遠不會出現它**。
+
+**失敗**：
+- B 群（⑨⑩⑪，票上那三個真跡）任一紅 ⇒ 今天這個形狀會再發生一次
+- C 群 ⑭⑰ 紅 ⇒ 驗收條件 1／3 沒過：「放著不管」抓不到，或「merge 了分支還在」放行
+- **A 群任何一條紅 ⇒ 誤攔，這比漏擋嚴重**。②③特別重要：
+  指派給人／掛 Human 之後還在點名，就是 ISEP v0.6.0 divergence §B4 記過的那個坑
+  （「`s/review` 佇列非空即 block」⇒ 佇列本來就不會空 ⇒ **總管永遠停不下來**）
+- E 群 ㉙ 紅 ⇒ 閘訊息裡承諾的出路（「把它指派給那個人，本閘立刻不再點名它」）是假的
+- D 群 ㉓ 紅 ⇒ 判準從「識別碼比對」滑成「只要提到票號就放行」，閘會被任何一句話關掉
+
+> 📌 **真跡不只在 fixture 裡跑過**：同一支閘打真實 Gitea 也驗過，
+> 一次點名 7 個沒有結論的 PR，含票上那三個（15／14／14 天）。
+> 指令：`printf '{"session_id":"x","transcript_path":"/nonexistent"}' | bash hooks/pr-verdict-guard.sh`
+> ——**唯讀，不改動任何 PR**。
+
+### A15 — 給結論的那支工具自己說得出要打哪幾通 API
+```
+python3 scripts/pr-verdict list
+python3 scripts/pr-verdict merge inkstone/ISEP#71 --dry-run
+```
+**該看到**：`list` 印出 open PR 與「有沒有人被指派」；`merge --dry-run` 印出
+`[dry-run] POST …/pulls/71/merge` 與 `[dry-run] DELETE …/branches/<分支>`，**一通都不真的送出**。
+**失敗**：`--dry-run` 底下出現真實的寫入結果 ⇒ 這支工具沒辦法在按下去之前被檢查。
+### A14 — 每一則回覆都自己說出拖了多久：20 條
+```
+bash hooks/tests/countdown-guard.test.sh
+```
+**該看到**：`通過 20 條，失敗 0 條`。**全程離線**：時鐘用 `ISEP_COUNTDOWN_NOW` 定住、
+狀態走 `ISEP_COUNTDOWN_STATE_DIR`，不打網路、不碰 `$HOME`。
+
+**它在守什麼**（`inkstone/ISEP#63`，leo 2026-08-27）：
+「前面說過每個回覆要戴上已經花了總時長，**這為什麼沒出現？**」
+「這應該寫在 ISEP，隨時看自己拖了多久」——重點在後面那句：
+**不是要總管記得戴，是要它長在機器上。** 總管當時答「現在開始戴」，
+而那正是這條規則第一次失效的方式。
+
+**判準**：一個新開的 session，什麼都沒被交代，回覆裡照樣有時長。
+
+**失敗**：
+- A 群（注入）任何一條紅 ⇒ 那一行算錯了。**④ 特別看**：期望「已過 2 小時 13 分」，
+  實得就要是同一個字串——這格就是票上驗收第 2 條「數字對得上真實經過的時間」
+- ⑤ 紅 ⇒ 連續幾則不是遞增（歸零或亂跳），票上驗收第 3 條
+- ⑦ 紅 ⇒ 過了收工線卻悄悄換算成明天。**超時消失 ＝ 這個東西的意義沒了**
+- ⑨ 紅 ⇒ 沒有 milestone 快取時編了一個日期出來（寧可少一段，不准編）
+- B 群（該擋）紅 ⇒ 「注入了但模型沒照做」這個主要失效模式沒有被接住
+- **C 群（不該擋）任何一條紅 ⇒ 誤攔，這比漏擋嚴重**——每一回合都被念一次，
+  人就學會忽略它，那它就等於不存在（本 repo 心法第 2 條）
+
+🔴 **跑測試前先確認 `CLAUDE_CODE_CHILD_SESSION` 沒有殘留**：本閘刻意放行子 session
+（subagent 的回覆不是給 leo 看的），所以在一條 subagent 裡跑，B 群會**全綠而且是假綠**。
+測試檔自己會把它清掉——2026-08-28 第一次跑就撞到這個，才補上去的。
+
+### A16 — 現在的主線是哪一個：24 條
+```
+bash hooks/tests/mainline-focus-guard.test.sh
+```
+**該看到**：`通過 24 條，失敗 0 條`。**全程離線**：狀態走 `ISEP_COUNTDOWN_STATE_DIR`、
+時鐘走 `ISEP_COUNTDOWN_NOW`、「那張票掛在哪」走 `ISEP_MAINLINE_FIXTURE`，
+並把 `TICKET_HOST` 指到一個連不上的位址——**任何一條真的走到網路，會在那裡當場失敗，
+不會靜靜地變成假綠**。
+
+**它在守什麼**（`inkstone/ISEP#82`，leo 2026-08-27）：
+「**14 個里程碑同時亮著卻不知道該看哪個**」。當天實查 14 個 open milestone，
+其中「Mira 現代化」這個名字同時活在 5 個 repo，5 個已經逾期
+⇒ SOP 說的「只做**該** milestone 的事」**沒有指涉對象，等於不存在**。
+
+**判準**：問「現在的主線是哪一個」，`scripts/mainline` 回一個答案，而且只有一個。
+
+**失敗**：
+- A 群任一條紅 ⇒ 答案不唯一，或標了新的舊的還在——那就回到 14 個一起亮的狀態
+- ⑧ 紅 ⇒ **目標宣告沒有自己出現**（票上驗收第 2 條），leo 又要自己去翻
+- ⑨ 紅 ⇒ 主線的名字沒掛在被查核的 ⏱ 那一行上 ⇒ 它到不了 leo 眼前
+  （本票刻意不另立第二道會擋人的閘，就是靠這一格成立）
+- ⑩ 紅 ⇒ 用「期限最近的那個」蓋過了被指定的主線。**猜的不准蓋過指定的**
+- ⑬⑭ 紅 ⇒ 派了不在主線上的票沒被問一次，或問了卻沒給補收／跳線兩條路
+- ⑯ 紅 ⇒ **鬼打牆**：同一張票被擋第二次。至多擋一次是硬要求
+- **⑲–㉔（不該擋）任一條紅 ⇒ 誤攔，這比漏擋嚴重**。特別是 ⑲（沒有主線就一律放行，
+  票上驗收第 4 條）與 ㉒（問不到那張票掛在哪 ⇒ 放行）——
+  **「讀不到」不等於「不屬於」，把這兩件事講成同一句是最貴的錯**
+
+📌 這一條線的另一半是**指令**，不是閘：`scripts/mainline`（`show`／`list`／`set`／
+`clear`／`refresh`／`adopt`／`has`）。要打網路的那幾個（list／set／adopt）不在測試裡跑，
+因為它們**只有真的 Gitea 才驗得了**——驗法見 A17。
+
+### A17 — 主線那支指令真的問得到 Gitea（要網路）
+```
+python3 scripts/mainline list
+```
+**該看到**：一份 open milestone 清單，**跨多個 repo**（`ISEP` / `Arcrun` / `arcrun-rag` / `mira`…），
+每一行左邊是可以直接貼給 `set` 的 `owner/repo#<milestone id>`。
+**失敗**：
+- `一個 open milestone 都沒讀到` ⇒ 這台機器拿不到 Gitea。**那是讀不到，不是沒有**
+  ——不要因此標一個猜的主線
+- 只有單一 repo ⇒ 沒有跨 repo，等於沒看到全局
+
+### A15 — 發通知不等於部署：37 條
+```
+bash hooks/tests/prod-write-guard.test.sh hooks/prod-write-guard.sh
+```
+**該看到**：`通過 37 ／ 失敗 0`（原本 29 條，`inkstone/ISEP#63` 補 8 條）。
+**失敗**：
+- 「卡點一」6 條任一紅 ⇒ 要嘛 leo 收不到 Telegram（`notify_leo` 被當成部署擋掉），
+  要嘛白名單放太寬——**「別的 named webhook」「部署端點」兩條若變綠，等於這道閘被拆了**
+- 「卡點二」2 條任一紅 ⇒ 「談論它」又被當成「執行它」（同款第八次），
+  或是剝了內文之後連真的部署都放行了
+
+### A16 — 一次交貨 ＝ 一份清單（跨 repo 版本組合）：21 條
+```
+bash scripts/test-release-manifest.sh
+```
+**該看到**：`通過 21 條，失敗 0 條`。全程離線（`RELEASE_MANIFEST_FIXTURE`），
+**不打 Gitea、不建任何真的 release**；清單寫在 `mktemp` 的目錄，不碰 repo 裡的 `releases/`。
+
+**它在守什麼**（`inkstone/ISEP#84`）：一次交貨常常同時動到好幾個 repo，
+而「這一版 ＝ 哪幾個 repo 的哪幾版」**沒有任何地方記著** ⇒ 退版只退了其中一個，
+剩下的還停在新版 ⇒ **變成一組從來沒測過的組合**。
+
+**失敗**：
+- ⑨⑩ 紅 ⇒ 驗收 1 沒過：**版本號寫上去就算數**，沒有真的去 Gitea 抓過
+  （「寫上去」跟「存在」是兩件事，而清單的用處完全建立在後者）
+- ⑱ 紅 ⇒ 驗收 3 沒過：**只退其中一個 repo 沒有被擋下來**，那正是票上那個病
+- ⑯⑰⑲ 任一紅 ⇒ 驗收 2 沒過：退版沒有吐出整份清單的每一格
+  （包含「已經在目標版本、不必動」那幾格——列出來才證明沒有一格被漏掉）
+- ⑫ 紅 ⇒ 凍結過的清單還能再加東西，「凍結」兩個字就沒有意義了
+- ⑳㉑ 紅 ⇒ 驗收 4 沒過：leo 打開 `INDEX.md` 看不出「我現在手上是哪一版」
+
+### A17 — 每次結案都留下估多久／花多久／差多少：23 條
+```
+bash scripts/test-milestone-account.sh
+```
+**該看到**：`通過 23 條，失敗 0 條`。全程離線（`MILESTONE_ACCOUNT_FIXTURE` ＝一份假的
+Gitea 回應表），時鐘用 `MILESTONE_ACCOUNT_NOW` 定住，帳本寫在 `mktemp` 目錄，
+**不打 Gitea、不關任何真的 milestone**。
+
+**它在守什麼**（`inkstone/ISEP#85`，leo 2026-08-27 說那天「**拖時間**」）：
+拖了多久、比預計多拖多少、為什麼拖——**沒有任何數字**。偵測器早就有了
+（`mainline-idle-guard.sh`／`factory-idle-guard.sh`），**但沒有人把它算成帳**。
+
+**失敗**：
+- ①②③④ 任一紅 ⇒ 驗收 1 沒過：三個數字不是自己算出來的
+- ⑤⑥ 紅 ⇒ 驗收 2 沒過：差超過 ±25% 卻能不挑代號就結案
+- ⑧ 紅 ⇒ 代號不再是封閉集合。**能統計的前提是分類有限**，這一格垮了統計就垮了
+- ⑨ 紅 ⇒ **挑一個時間軸撐不住的代號也能過**，等於「採信我自己說的」，
+  而票上寫死證據一律從 Gitea 的時間軸取
+- ⑦ 紅 ⇒ **誤攔**：只差 -6% 也逼人挑代號。這比漏擋嚴重——每次結案都被念，
+  人就學會繞過去
+- ⑭⑮⑯⑰ 任一紅 ⇒ 驗收 3 沒過：累積之後看不出哪一種原因最常發生
+- ⑱⑲ 紅 ⇒ 驗收 4 沒過：拿已經逾期的里程碑進去算不出數字
+
+### A18 — 結案要記帳的那道閘：22 條
+```
+bash hooks/tests/milestone-account-guard.test.sh
+```
+**該看到**：`通過 22 條，失敗 0 條`。離線（帳本走 `MILESTONE_ACCOUNT_LEDGER`），
+純結構判斷、沒有語意判官，所以每次結果都一樣。
+
+**失敗**：
+- **A 群任何一條紅 ⇒ 誤攔，這比漏擋嚴重。** ⑥⑦⑧⑪ 特別重要：
+  `echo` 一段指令、`cat` 這支閘自己、commit 訊息裡提到、把指令寫進文件的 heredoc 內文
+  ——**四種都只是「談論它」，不是「執行它」**。這四格是本 repo 撞過很多次的同一個病
+  （`strip_heredoc.py` 的檔頭記著兩次真跡）
+- ⑨⑩ 紅 ⇒ 走正門 `scripts/milestone-account close` 反而被自己的閘擋下，
+  那道閘就等於封死了唯一的出路
+- ⑭⑮⑯⑰⑱ 任一紅 ⇒ 漏擋：換個寫法（`python urllib`、前面串一個無害指令、
+  `--request` 長寫法、換一個 repo）就繞過去了
+- ⑲ 紅 ⇒ 訊息沒有點名目標，人看完不知道要對哪一個里程碑動手
+- ⑳㉑ 紅 ⇒ 「記過帳就放行」這個出路是假的，或者一記帳就把所有里程碑全開了
+### A16 — 「總管可以放行」那道門真的打得開：17 條
+```
+bash hooks/tests/gate-ok.test.sh
+```
+**該看到**：`通過 17 條，失敗 0 條`。
+
+**它在守什麼**（inkstone/ISEP#90 ④，2026-08-28 實查）：三支閘
+（`prod-write-guard`／`main-and-prod-push-guard`／`stage-before-prod-guard`）
+都是「擋下來、但**總管看過就能放行**」的設計，而**既有測試只驗了擋得住，
+一條都沒驗過放得開**。於是這個 bug 活了很久：`stat -f %m` 在 GNU coreutils 上
+是「檔案系統資訊」，它一邊回非零一邊吐一整段文字 ⇒ 秒數被污染 ⇒
+**在 Linux（＝每一個雲端 session）上戳記永遠不被接受** ⇒ 那三支閘在雲端等於純擋，
+而閘不會告訴你門是壞的。
+
+**失敗**：
+- ②⑤（門打得開）紅 ⇒ 逃生口又焊死了，那三支閘在雲端變回純擋
+- ⑥⑦⑧（門沒變寬）任一紅 ⇒ **更嚴重**：綁 repo／有效期／空戳記那三條性質是
+  08-11、08-12 兩次真的被穿透之後才補上的，不准為了「好放行」而鬆掉
+- ⑫ 紅 ⇒ `gate-ok` 在解不出 repo 時留下了一枚註定打不開的空戳記，
+  那會讓人以為門開了（而空戳記本身就是 08-12 那把萬用鑰匙的形狀）
+- ⑰ 紅 ⇒ 判準又變回「行為取決於 cwd 裡有沒有一個叫 `%m` 的檔」。
+  這條是這個 bug 的最後一層：**GNU 的 `-f` 是布林旗標，`%m` 被當成另一個檔名運算元**
+  ⇒ 有那個檔就 `exit 0`、`||` 連跑都不跑。所以修法不能只是「把順序反過來」，
+  **每一步都要驗它是不是純數字**
+
+⚠️ 這支會真的寫 `/tmp` 的戳記檔（那是閘寫死的路徑）。**不要在「已經蓋好戳記正要推東西」
+的當下跑它**——它會把那枚戳記洗掉。
+
+### A17 — 未推警察不會對雲端的工作分支亂叫：10 條
+```
+bash hooks/tests/unpushed-police.test.sh
+```
+**該看到**：`通過 10 條，失敗 0 條`。全離線（用本機 bare repo 當「遠端」）。
+
+**它在守什麼**（inkstone/ISEP#90 ①）：雲端 session 開出來的工作分支天生沒有 upstream，
+內容卻等於遠端 main ⇒ 舊判準「沒 upstream＝從沒推過」讓**每個雲端 session、每次收工
+都被攔一次**（08-27 一個 session 五次全是誤報）。
+
+**失敗**：
+- A 群（①—⑥，不該報）任一紅 ⇒ **誤攔**，比漏擋嚴重：永遠在響的警報＝訓練人忽略它，
+  下一條真的失蹤的分支會混在雜訊裡
+- B 群（⑦—⑩，該報）任一紅 ⇒ 為了不吵而改成放行了，那是把閘關掉不是修好
+- 特別看 ④：問不到遠端（離線）**不准當成「你沒推」**
+
+### A18 — 信標會講出雲端會壞掉的那三件事：14 條
+```
+bash hooks/tests/isep-presence-beacon.test.sh
+```
+**該看到**：`通過 14 條，失敗 0 條`。全離線。
+
+**它在守什麼**（inkstone/ISEP#90 ②③）：信標原本只證明「有一份 plugin 載入了」，
+不證明「載入的是哪一份」——08-27 雲端載 0.3.9、main 0.9.0，差 7 個 release，
+而它照樣是綠的。
+
+**失敗**：
+- ⑫⑬⑭（信標永遠在）任一紅 ⇒ **最嚴重**：那一行消失＝leo 會判定這個 session 零閘
+- ③ 紅 ⇒ 版本落差報不出來，`ISEP#67` 那個病又變回看不見
+- ⑤⑦ 紅 ⇒ 舊複本遮蔽正門抓不到（`InkStoneCo/scripts/ticket` 那件）
+- ⑥ 紅 ⇒ **誤攔**：同步過的複本被念，人就學會忽略它
+- ⑪ 紅 ⇒ 內層迴圈變數撞名的回歸（同一個 `.claude` 下第二個殘骸會被靜靜跳過）
+### A19 — 下游做完時頂層跟著關：49 條
+```
+bash scripts/test-ticket-handoff-writeback.sh
+```
+**該看到**：`通過 49 條，失敗 0 條`。**全程離線**——`TICKET_HOST` 指到連不上的位址，
+會打 API 的兩段（`_writeback`／`cmd_subtask`）把 `api()` 換成錄音機跑，
+**不打真實 Gitea、不開票、不關票、不留任何測試票**。
+
+**它在守什麼**（`inkstone/ISEP#92`）：
+「開在頂層的票，下游做完了卻沒人回來關⋯⋯頂層票會永遠掛著，**而 leo 是看頂層的**。」
+
+四格對應票上的四條驗收條件：
+- ①②③ 純函式（`is_loose`／`writeback_plan`／`journey_label`）——**判準本身**，
+  不必開真票就驗得動
+- ④⑤ `subtask`／`handoff` 的參數閘：該擋的擋、齊全的放得過
+- ⑦ **完工回寫的接線**（驗收第 2 條）：關掉一張下游票之後，它到底對頂層票做了什麼
+- ⑧ **雙向連結的接線**（驗收第 1 條）：兩張票互相看得到對方，不是靠人記得補
+
+**失敗**：
+- ①「open ＋ 從來沒有下游 → 不撈」紅 ⇒ **誤攔**：`ticket loose` 會把每一張普通票
+  都列出來，那張表就變成雜訊，人學會忽略它（本 repo 心法第 2 條）
+- ②「還有別的下游沒關 → 只記一筆」紅 ⇒ 母票會在下游還沒做完時被指派回總管，
+  假綠
+- ⑦「沒有去關母票」變綠 ⇒ 回寫從「處理」滑成「自動關掉」。
+  **默默關掉跟默默留著是同一個病的兩面**——關票要有交付物、要有人看過
+- ⑦「留言第一行有身份欄」紅 ⇒ 機器貼的留言看起來像某個人寫的，
+  下一個讀票的人會去找那個人（`reply-identity-guard` 管的是同一件事）
+- ⑧「母子兩端都被貼」剩 1 ⇒ journey 只貼了一端，**聚類時撈得到一半**，
+  比完全沒貼更危險
+- ⑤ 任何一條紅 ⇒ 誤攔，合規的交辦被擋掉等於這條路不能走
+
+🔴 **這支測不到的那一格（要 leo 或總管接手）**：`labels.yaml` 的 `j/` 段
+**刻意是空的**——旅程怎麼切、叫什麼名字是方向題，不由工具代決。
+在有人往那裡加第一條旅程之前，`--journey` 只會擋、不會貼。
+機制驗過了，**資料還沒有**。
+
+### A20 — 舊票每天有固定管道被撈出來：47 條
+```
+bash scripts/test-debt-worklist.sh
+```
+**該看到**：`通過 47 條，失敗 0 條`。**全程離線**：資料走 `ISEP_DEBT_FIXTURE`、
+時鐘走 `ISEP_DEBT_NOW`、狀態走 `ISEP_DEBT_STATE_DIR`、主線走 `ISEP_COUNTDOWN_STATE_DIR`
+——**不打 Gitea、不留測試票、不碰 `$HOME`**。
+
+**它在守什麼**（`inkstone/ISEP#83`，leo 2026-08-27）：
+「現在每天都在追新的，所以**要用 Routine 去消化舊的**，可以有多個條件」。
+全 org 229 張 open 票，每天在動的只有掛在 open milestone 上的那 56 張；
+其餘的不是不重要，是**沒有任何機制會去拿它們**。
+
+🔴 **兩條線各用各的判準，不是二選一**（leo 當場訂正總管的誤解）：
+掛 milestone ＝緊急線，用「距離目標的遠近」排；沒掛的＝還債線，用多條件排
+（事故／擋人／承諾／票齡／估工）——後者就是 `scripts/debt-worklist`。
+
+**失敗**：
+- 「驗收 1」那組紅 ⇒ 清單沒有附「我查了哪些 repo」的證明。
+  **沒有證明的清單分不出「今天真的沒有」與「查詢壞了」**，而後者會靜靜地零產出
+- 「驗收 2」紅 ⇒ 空清單默默結束。這是這支工具最貴的失效方式：
+  它看起來跑完了，於是沒有人再去看那 180 張
+- 「驗收 3」紅 ⇒ 領走的票明天又冒出來，這份清單就會變成每天一樣的一坨，人就不看了
+- 「成包」兩條紅 ⇒ 互相指著／母子票被拆開領，做到一半才發現卡在另一張
+- **「單向引用不成包」紅 ⇒ 這是誤攔的那一面**：第一版用單向引用成包，
+  結果 190 張裡 121 張黏成一包（大家都會順手引用 hub 票）＝**一包沒有人領得動**
+- 「接上主線」那組紅 ⇒ 還債線又自己養了一套「哪個是 active」的判斷。
+  唯一答案在 `hooks/lib/mainline.py`（`inkstone/ISEP#82`），**兩份必然漂移**。
+  特別看「沒標主線」那兩條：**沒有答案時要退回保守**（掛 open milestone 的一律不領），
+  不准猜一條出來
+- 最後一組（SessionStart）紅 ⇒ 要嘛沒有人會被提醒去撈，
+  要嘛那一段偷偷去打網路——**開 session 自動撈就是輪詢**，紅線擋著
+
+**手動驗真實資料**（會打 Gitea，唯讀 GET）：
+```
+python3 scripts/debt-worklist list --top 5
+```
+**該看到**：15 個 repo 逐一列出 issue／PR 數，講得出**現在的主線是哪一條**
+（或誠實說沒標），扣除數字講得出來（掛 open milestone 的幾張、等 leo 的幾張、已領走的幾張），
+前幾名旁邊看得到「為什麼排這裡」的分項。
+**失敗**：前幾名一眼看不出為什麼在那裡 ⇒ 那些權重就是錯的，去改 `score()`，
+**不要改成「總管覺得」**——這份清單的價值就在於它不靠記憶。
 
 ### A5 — 開票前的搜尋是跨 repo 的
 ```
@@ -84,6 +442,83 @@ bash hooks/tests/ask-user-question-guard.live.test.sh
 - 📌 這支會隨模型版本漂移，**是量尺不是一次性驗收**。改完判準要連跑三次都全綠才算數
   （2026-08-26 實測：第一版判準連兩次都在同一題漏擋，收緊 ③④ 定義後三次全綠）
 
+### A11 — 派工單只剩票號（含**回覆那條路**）：擋得住，也放得過，而且會注入共通規定
+```
+bash hooks/tests/dispatch-format-guard.test.sh
+```
+**該看到**：`52/52 通過`（`inkstone/ISEP#88` 之前是 33 條；本頁一度寫 19，那是更早的數字，
+**沒有人回頭改** —— 同一個病，只是換一欄）。**離線、不打網路、不花錢**——這支閘是純結構判斷，沒有語意判官，
+所以它不需要像 A10 那樣另開一支 live 測試量準度，**每次結果都一樣**。
+**失敗**：
+- A 群任何一條紅 ⇒ **誤攔**。合規的派工只有一行票號，擋掉它等於整台機器派不了工
+- ⑦ 紅 ⇒ **共通規定沒有被注入**。這是「派工單只剩票號」能成立的前提：
+  交件方式、不准 push main、org 是 `inkstone` 這些不必有人記得寫，機器每次都補。
+  它壞了不會有人立刻發現——派工照樣送出去，只是收工方**不知道要貼回原票**
+- ⑨ 紅 ⇒ 真跡放行了。那份測資是**真的發生過的那一次派工**（見 `hooks/tests/fixtures/README.md`）
+- ⑰ 紅 ⇒ 訊息被 shell 展開了（同 A9 ⑩b 那個病：閘照擋，但它教人怎麼解的那兩行變成空白）
+- **D 群⑲⑳㉑㉒ 紅 ⇒ `inkstone/ISEP#88` 的驗收條件沒過**：回覆一個正在跑的 subagent
+  時夾帶指令沒被擋（⑲）、或擋了卻沒把那段內容原文印出來（㉑，出路是「貼上票」，
+  找不到原文就得回頭自己翻）
+- **E 群㉔–㉙ 任一紅 ⇒ 有一條通往 subagent 的路又漏了**。那六條是雲端 session／trigger／
+  `claude -p`——`ticket-api-bypass-guard.sh` 檔頭記過這一族的通病：「認動作的方式漏了一條路」
+- **F 群㉚–㉟ 任一紅 ⇒ 誤攔**。㉚特別重要：subagent 往上回報（`to: "main"`）是**交件**，
+  擋它等於擋掉交件本身；㉟反過來，子 session 自己往下派工時規矩要照樣管它，不然是逃逸艙口
+
+### A16 — 工人有名字：指名派工、沒有這個人、注入它的檔案：24 條
+```
+bash hooks/tests/roster-guard.test.sh
+```
+**該看到**：`24 通過 / 0 失敗`。**離線、不打網路、不花錢**——純結構判斷（名字在不在名單裡），
+沒有語意判官，每次結果一樣。
+
+**它在守什麼**（`inkstone/ISEP#86`）：「身為派工的人，我要工人有名字，
+我才知道票上這件事到底是誰做的。」開票當日實查：`/root/.claude/agents/` 不存在，
+派工派給的是**沒有名字的臨時工**——票上只看得到「有個 agent 做了」。
+
+**失敗**：
+- ①②③ 紅 ⇒ 驗收 1 沒過：`scripts/roster` 列不出名單、或列了卻看不出各自管什麼
+- ④⑤ 任一紅 ⇒ **誤攔**，名單上的人被擋掉 ＝ 整台機器派不了工。這比漏擋嚴重
+- ⑥⑦⑧ 紅 ⇒ 驗收 4 沒過：派一個不存在的名字時講不出「沒有這個人」
+- ⑨ 紅 ⇒ 擋了卻沒印名單，人不知道有誰可以派（閘的訊息要講得出出路）
+- ⑬ 紅 ⇒ 名單讀不到時**沒有 fail-open**。一份讀不到的名單不該讓整台機器停擺
+- ⑯⑰ 紅 ⇒ 注入壞了。那是「你是誰／先讀什麼／你的紅線」唯一的送達方式——
+  它壞了不會有人立刻發現，派工照樣送出去，只是工人不知道自己是誰
+- ⑱ 紅 ⇒ 驗收 3 沒過：票上的【身份】欄吃不下工人名字（或把原本三個角色弄壞了）
+
+### A17 — 未經調查不寫診斷：26 條
+```
+bash hooks/tests/diagnosis-evidence-guard.test.sh
+```
+**該看到**：`26 通過 / 0 失敗`。**全程離線**：不打 Gitea、不開任何測試票，
+戳記走 `ISEP_STAMP_DIR`（不碰 `/tmp` 的正式戳記）。
+
+**它在守什麼**（`inkstone/ISEP#87`）：「先派人查 → 拿到查的結果 → 才可以寫診斷。」
+未經調查的診斷寫在票上會長得像事實，**工人會照著它去驗證，而不是去查**。
+
+**失敗**：
+- ①–⑦ 任一紅 ⇒ 驗收 1 沒過。⑥⑦特別看：那是**側門**（直接打 Gitea API），
+  只封正門等於沒封
+- ② 紅 ⇒ 驗收 3 沒過：訊息說不出「你還沒派人查這件事」，變成籠統的「格式不對」
+- ⑧⑨ 紅 ⇒ 驗收 2 沒過（派過人查卻還在擋），或戳記從「按票分」滑成「按 session 分」
+  ——後者等於派過一次就永久解鎖
+- **⑩–⑫ 任一紅 ⇒ 驗收 4 沒過，這是誤攔**：轉述別人查到的東西（有出處）被擋，
+  那會逼人把真的有出處的話也吞回去
+- ⑬ 紅 ⇒ 判準從結構滑回措辭。那一條**故意用一段連「根因／因為／應該是」都沒有的內容**，
+  它一旦放行，代表閘開始靠關鍵字判斷了（leo 2026-08-17 已證偽那條路）
+- ⑭–⑲ 任一紅 ⇒ 誤攔（短回覆、唯讀、搜尋、關票被擋）
+- ㉑ 紅 ⇒ 鬼打牆：同一張票擋不只一次，人會學會忽略它
+- ㉓㉔ 紅 ⇒ payload 壞掉時擋住了。這支是 PreToolUse，fail-closed 會讓人做不了事
+
+### A12 — 票上的每一則留言都認得出是誰寫的（兩道門）
+```
+bash hooks/tests/reply-identity.test.sh
+```
+**該看到**：`11/11 通過`。離線，正門的案例全部在打 API 之前就結束，不會真的送出留言。
+**失敗**：
+- ③ 紅 ⇒ 誤攔了「GET 撈留言」。那是最常做的動作，擋它比漏擋更糟
+- ①⑧ 紅 ⇒ 有一道門沒守住。**貼留言有兩條路**（`scripts/ticket` 正門、Gitea API 側門），
+  只封一條等於沒封——`ticket-api-bypass-guard.sh` 是**刻意放行**對既有票留言的
+
 ### A6 — 標籤對齊且冪等
 ```
 bash scripts/gitea-labels-sync.sh
@@ -217,11 +652,30 @@ B2（信標那行）／B3（setup 輸出）／B4（閘的訊息）三個畫面
 | A1 manifest 合法 | 總管 | ✅ |
 | A2 版本三處一致 | 總管 | ✅ |
 | A3 打 tag 閘 | 總管 | ✅ 3/3 |
-| A4 開票側門閘 | 總管 | ✅ 13/13 |
+| **A4 新增 Gitea 東西側門閘** | 總管 | ✅ 24/24（2026-08-27，inkstone/ISEP#72） |
+| **A13 戳記證明看過不是跑過** | 總管 | ✅ 17/17（2026-08-27，inkstone/ISEP#72→4873） |
+| **A14 PR 一定要有結論** | 總管 | ✅ 52/52（2026-08-28，inkstone/ISEP#81）＋真實 Gitea 唯讀重演 |
+| **A15 pr-verdict --dry-run** | 總管 | ✅（2026-08-28） |
+| **A14 回覆自己說出拖了多久** | 總管 | ✅ 20/20（2026-08-28，inkstone/ISEP#63） |
+| **A15 發通知不等於部署** | 總管 | ✅ 37/37（2026-08-28，inkstone/ISEP#63） |
+| **A16 跨 repo 版本清單** | 總管 | ✅ 21/21（2026-08-28，inkstone/ISEP#84） |
+| **A17 估多久／花多久／差多少** | 總管 | ✅ 23/23（2026-08-28，inkstone/ISEP#85） |
+| **A18 結案要記帳的閘** | 總管 | ✅ 22/22（2026-08-28，inkstone/ISEP#85） |
 | A5 搜尋跨 repo | 總管 | ✅ |
 | A6 標籤對齊＋冪等 | 總管 | ✅ 14 repo，第二次 0/0 |
 | **A9 人閘警察管路** | 總管 | ✅ 14/14（2026-08-26） |
 | **A10 人閘警察準度** | 總管 | ✅ 9/9，連跑三次（2026-08-26），A 群誤攔 0 |
+| **A11 派工單只剩票號＋回覆那條路（ISEP#88）** | 總管 | ✅ 52/52（2026-08-28） |
+| **A12 留言身份欄（兩道門）** | 總管 | ✅ 11/11（2026-08-28 複跑） |
+| **A16 工人有名字（ISEP#86）** | 總管 | ✅ 24/24（2026-08-28） |
+| **A17 未經調查不寫診斷（ISEP#87）** | 總管 | ✅ 26/26（2026-08-28） |
+| **A11 派工單只剩票號** | 總管 | ✅ 19/19（2026-08-27） |
+| **A12 留言身份欄（兩道門）** | 總管 | ✅ 11/11（2026-08-27） |
+| **A16 放行的門真的打得開** | 總管 | ✅ 17/17（2026-08-28，inkstone/ISEP#90） |
+| **A17 未推警察不誤攔雲端分支** | 總管 | ✅ 10/10（2026-08-28，inkstone/ISEP#90） |
+| **A18 信標會報雲端接線缺陷** | 總管 | ✅ 14/14（2026-08-28，inkstone/ISEP#90） |
+| **A19 下游做完頂層跟著關** | 總管 | ✅ 49/49（2026-08-28，inkstone/ISEP#92） |
+| **A20 舊票有固定管道被撈** | 總管 | ✅ 47/47（2026-08-28，inkstone/ISEP#83）＋真實 229 張唯讀實跑 |
 | A7 plugin 裝得起來 | 總管 | ✅ |
 | **A8 新 session 閘會觸發** | 總管 | 見本版 release note |
 | **B1–B5 雲端** | **leo** | 還沒跑（機器碰不到 Cloud environment） |

docs/governance/cloud-wiring.md

@@ -0,0 +1,195 @@
+# 雲端 session 的閘為什麼跟地端不一樣（inkstone/ISEP#90）
+
+> leo 的目標一句話：**讓雲端 session 跟地端拿到同一組閘、同一組能用的工具。**
+
+雲端不是「地端少幾支閘」，是**同一批閘在雲端的行為不一樣**。四個實例，
+每一個都穩定重現，而且每一個都**不會自己喊痛**——這才是它們活這麼久的原因。
+
+---
+
+## 四個缺陷，兩種病
+
+| | 缺陷 | 病 |
+|---|---|---|
+| ① | 未推警察每個雲端 session 都誤攔 | 判準在雲端**不成立** |
+| ② | `scripts/ticket` 在雲端拿不到 token | 跑到的是**另一份**（舊複本） |
+| ③ | 已刪除的機制在雲端重生 | 載到的是**另一版**（0.3.9 vs 0.9.0） |
+| ④ | 總管的「我確認過了」出口打不開 | 判準在雲端**不成立**（平台差異） |
+
+①④ 是同一種病：**閘的判準寫的是地端才成立的假設**。
+②③ 是同一種病：**同一個東西有兩份，而雲端跑到的是舊的那份**。
+
+---
+
+## ① 未推警察：判準是「有沒有 upstream」，而雲端的分支天生沒有
+
+雲端 session 開出來的工作分支沒有 upstream，**內容卻等於遠端 main**：
+
+```
+薄殼 HEAD        = 081c547d90dc2d80692485af083ca1f71f2094f2
+GitHub 遠端 main = 081c547d90dc2d80692485af083ca1f71f2094f2   ← 同一顆
+```
+
+⇒ 每個雲端 session、每次收工都被攔一次（2026-08-27 一個 session 五次全是誤報）。
+
+**修法**：判準改成「**遠端有沒有這顆 commit**」（`git ls-remote`）。
+本機的 remote-tracking ref 只答得準「有」——08-28 實測那份 `origin/main` 落後遠端 4 天
+——所以答「沒有」的時候才打網路。三態：有／沒有／**問不到**；問不到一律不報。
+
+**順手補的**：`$CLAUDE_PROJECT_DIR` 在雲端是**薄殼根**，真身在 `$TOP/InkStoneCo/`。
+舊的掃描清單四個路徑在雲端一個都不存在 ⇒ **真身有東西沒推，這支閘一輩子不會知道。**
+同一支閘在雲端既亂叫、又看不到該看的地方。
+
+---
+
+## ② `scripts/ticket`：跑到的是舊複本，不是 plugin 那一份
+
+- ISEP 的 `scripts/ticket` **早在 2026-08-20 就修好了**（掃所有 remote ＋ 環境變數 fallback）
+- 但雲端 cwd 是真身，那裡有一份 `InkStoneCo/scripts/ticket` 的**舊複本**，
+  取 token 邏輯還停在「只認名叫 `gitea` 的 remote」，而 `bootstrap.sh` 把 Gitea 設成 `origin`
+- ⇒ 雲端一律死在「拿不到 gitea token」
+
+🔴 **後果比「一支腳本壞了」嚴重**：`scripts/ticket` 是開票/留言的**正門**，
+它一壞，人就繞過去直接打 Gitea API——**而那正是 `ticket-api-bypass-guard.sh` 在防的事**。
+**一道閘把人逼去走它自己禁止的那條路，那道閘就是在製造違規。**
+
+**ISEP 這半的修法**：信標在 session 開頭就點名「專案裡有 ISEP 腳本的舊複本，
+而且**內容不同**」。判準不是檔名一樣，是**檔名一樣而內容不同**——同步過的複本不吵。
+**真身那半（把那份複本同步或刪掉）不在 ISEP，要在 `inkstone/InkStoneCo` 修。**
+
+---
+
+## ③ 已刪除的機制在雲端重生
+
+```
+ISEP main .claude-plugin/plugin.json  →  0.9.0
+雲端實際載入                            →  0.3.9      ← 差 7 個 release
+```
+
+0.3.9 裡還活著兩支在 v0.9.0 已整支刪除的 hook ⇒ `.claude/pending-verification/`
+被清掉之後又長回來。**一個看不見的版本落差，會讓已經刪掉的機制在別人的工作區裡復活。**
+
+**傳輸那半是 `inkstone/ISEP#67`**（新版到不到得了手上），本票不重複那件。
+**ISEP 這半能做的是讓它不再看不見**：信標匿名讀 ISEP main 的 `plugin.json`
+（D20 判準下屬於「讀」，不需開閘），落後就講清楚差幾版、怎麼重拍快照；
+同時掃 `.claude/` 底下**這一份 plugin 的 hooks/scripts 一個字都沒提到**的目錄，
+點名它們是殘骸。判準是「plugin 現在還認不認得它」，**不是關鍵字黑名單**
+（leo 2026-08-17 已證明那條路 8 次誤攔、0 次正確攔截）。
+
+---
+
+## ④ 「總管可以放行」的門，在雲端是焊死的
+
+三支閘（`prod-write-guard`／`main-and-prod-push-guard`／`stage-before-prod-guard`）
+都是「擋下來、但**總管看過就能放行**」。它們判斷戳記新不新都用同一行：
+
+```sh
+MT=$(stat -f %m "$STAMP" 2>/dev/null || stat -c %Y "$STAMP" 2>/dev/null || echo 0)
+```
+
+macOS（BSD stat）上 `-f %m` 就是 mtime，對的。
+**GNU coreutils 的 `-f` 是「顯示檔案系統資訊」**，而且它**一邊回非零、一邊往 stdout
+吐一整段區塊**：
+
+```
+$ stat -f %m /tmp/.probe
+stat: cannot read file system information for '%m': No such file or directory   ← stderr
+  File: "/tmp/.probe"                                                            ← stdout
+    ID: 0        Namelen: 255     Type: ext2/ext3
+```
+
+⇒ `2>/dev/null` 吃掉錯誤訊息、`||` 把正確的秒數接在那堆垃圾**後面**
+⇒ `case "$NOW$MT" in *[!0-9]*) return 1` 必然命中
+⇒ **在 Linux（＝每一個雲端 session）上，那三支閘的戳記永遠不會被接受。**
+
+### 再往下一層：`-f` 根本不吃格式參數，所以連離開碼都不可靠
+
+總管 2026-08-28 自己驗這一格時量到 `exit=0`，而我量到 `exit=1`。
+**兩個都是真的**，而分歧本身就是這個 bug 最後一塊拼圖：
+
+**GNU 的 `-f` 是 `--file-system`，它是布林旗標、不接格式字串**
+⇒ `%m` 不是格式，它被當成**另一個檔名運算元** ⇒ 離開碼取決於
+「當前目錄裡有沒有一個叫 `%m` 的檔」：
+
+```
+$ cd /tmp/statprobe && touch .mt
+
+# A. 沒有名為 %m 的檔（一般情況）
+$ stat -f %m .mt ; echo "exit=$?"
+stat: cannot read file system information for '%m': No such file or directory
+  File: ".mt"  …                                    ← 檔案系統資訊照樣印到 stdout
+exit=1        ← `||` **會**跑 ⇒ 正確的秒數接在那堆垃圾後面
+
+# B. 剛好有一個叫 %m 的檔
+$ touch '%m' && stat -f %m .mt ; echo "exit=$?"
+exit=0        ← `||` **不會**跑 ⇒ 整包連一個數字都沒有
+```
+
+（實測環境：`stat (GNU coreutils) 9.4`）
+
+**兩種情況下閘的結果一模一樣**——`MT` 都不是純數字，
+`case "$NOW$MT" in *[!0-9]*) return 1` 都必然命中，戳記都作廢：
+
+```
+情況 A：非數字 ⇒ return 1 ⇒ 戳記作廢
+情況 B：非數字 ⇒ return 1 ⇒ 戳記作廢
+```
+
+🔴 **這一層才是真正該記住的教訓**：舊寫法的 `||` fallback 之所以救不了，
+**不是因為它沒跑，而是因為「跑不跑」根本不由這支腳本決定**
+——它由「當前目錄裡有沒有一個叫 `%m` 的檔」決定。
+一個**行為取決於 cwd 裡有沒有某個檔名**的判斷式，不管跑不跑都是壞的。
+
+⇒ 所以 `lib/mtime.sh` 的修法不是「把順序反過來」而已，是
+**每一步都驗它是不是純數字**：這個 bug 的成因正是「命令失敗了卻還是印了東西」，
+**只看離開碼會再被騙一次**。
+
+📌 這一格的實害（總管 2026-08-28 原話）：「我今天為了發一則通知，
+用了兩種方式蓋 `prod-write-ok` 都無效，一度以為是權限問題。」
+⇒ **閘不會告訴你門是壞的**，所以人會往錯的方向查（權限、classifier、設定），
+而根因在閘自己身上。
+
+🔴 **後果**：那三支閘在雲端**等於純擋**。總管照著閘自己印的指示做，
+做幾次都打不開，**而閘不會告訴他門是壞的**。
+
+**為什麼活這麼久**：既有的三支測試（29／16／10 條）**只驗了「擋得住」，
+一條都沒驗過「放得開」**。⇒ 這正是「閘的另外一半從來沒被測過」的代價。
+
+**修法**：`hooks/lib/mtime.sh` —— 先 `-c %Y`（GNU）再 `-f %m`（BSD），
+**每一步都驗它是不是純數字**（這個 bug 的成因正是「命令失敗了卻還是印了東西」，
+只看離開碼會再被騙一次）。
+
+### 附帶：逃生口收斂成一個入口 `scripts/gate-ok`
+
+原本每支閘的門長得都不一樣，而且藏在被擋下的那則訊息裡：
+
+```
+touch /tmp/.prod-write-ok
+git rev-parse --show-toplevel > /tmp/.main-push-ok
+touch /tmp/.solo-ok-<session_id>
+…
+```
+
+兩個後果：**記不住**（抄錯一個字門就打不開），以及**沒有穩定形狀可以事先放行**
+——`.claude/settings.json` 的 allow 只能逐條完全比對（現場真的寫著
+`Bash(touch /tmp/.prod-write-ok)` 這種一行），多一個 `&&`、換一個 session id
+就落在規則之外，然後由權限層自己判斷。
+
+⇒ `bash "$CLAUDE_PLUGIN_ROOT/scripts/gate-ok" <閘名> [參數]`：**一個名字、一種形狀**，
+一條前綴規則涵蓋全部，以後新增閘不必再動一次設定。
+
+🔴 **它沒有弱化任何一道閘**：蓋的是同一個檔、同一種語意——單次用完即丟、綁 repo、
+綁 session、有效期全部沒動。換掉的只有「怎麼蓋」。
+`hooks/tests/gate-ok.test.sh` 的 ⑥⑦⑧ 三條就是在守這件事（那三條性質是 08-11、08-12
+兩次真的被穿透之後才補上的）。
+
+---
+
+## 還沒關掉的那兩格（不屬於 ISEP）
+
+| 缺口 | 住在哪 |
+|---|---|
+| 雲端載到的版本追上 ISEP main | `inkstone/ISEP#67` |
+| `InkStoneCo/scripts/ticket` 這份舊複本 | `inkstone/InkStoneCo`（真身） |
+
+ISEP 這一側能做的是**讓它們不再是看不見的**：兩件現在都會在 session 開頭被信標點名。

docs/governance/dispatch-and-reply-format.md

@@ -0,0 +1,193 @@
+# 派工單與交件回覆的格式（共通規定）
+
+> leo 2026-08-27（`inkstone/ISEP#30` comment 4322 / 4325 / 4327）：
+> 「你用一個 **output parser** 把你給 subagent 的指令規範，**分作幾點，每一點規定格式**，
+>   **照這種散文寫法根本無法迭代**」／「**警察也不能抓**」／
+> 「**交件方式不需要寫，定義在原則裡，每張票都要做這件事⋯⋯每次都一樣提取出來變成共通規定**」／
+> 「（那些 session 事實）**這些為什麼不寫到票裡？**」／「**subagent 回覆時要表明身份**」
+
+**本檔就是那份「共通規定」。** 它不是給人讀完記住的——
+`hooks/dispatch-format-guard.sh` 會把 §2 自動注入每一次派工，
+所以收工方**沒讀派工單也會拿到**。
+
+---
+
+## 1. 派工單 ＝ 票號。就這樣
+
+```
+【工單】inkstone/ISEP#30 → comment 4322
+```
+
+要帶兩張票就兩行 `【工單】`。**沒有第二個欄位。**
+
+### 為什麼
+
+派工單裡想寫的東西只有兩種，**兩種都不該留在派工單**：
+
+| 種類 | 舉例 | 該住哪 |
+|---|---|---|
+| **每次都一樣** | 交件方式、不要 push main、org 是 `inkstone`、先讀該 repo 的 CLAUDE.md | **本檔 §2**（機器自動注入） |
+| **這次才知道** | `main` 現在是哪顆、今天撞過什麼、另一條線正在動同一個 repo | **寫進那張票** |
+
+**判準一句話：「這句話換一張票還成立嗎？」**
+還成立 ⇒ 共通規定。只有這次成立 ⇒ 寫進這張票。**兩種都不進派工單。**
+
+🔴 **「票上還沒有」不是把它寫進 prompt 的理由——它是「去把它寫上票」的指令。**
+寫進 prompt 的後果：那個 agent 被停掉或換人接手，那段事實就隨 prompt 消失。
+2026-08-27 實害：總管停掉重派 3 次，前兩次的任務與 session 事實**全部蒸發**。
+
+### 機械閘
+
+`hooks/dispatch-format-guard.sh`（PreToolUse `Task`／`Agent`）——
+`【工單】` 以外還有實質內容就擋，並指出那些內容該搬去哪一格。
+判準是**「這一行是不是【工單】欄位」**（在不在），不是「它寫了什麼」。
+
+---
+
+## 1.5 派給誰：從名單裡挑一個**有名字的工人**（inkstone/ISEP#86）
+
+派工單只有票號，那「這是誰的活」寫在哪？——**不寫在派工單裡，寫在 `subagent_type`。**
+
+```
+Task(subagent_type="isep-hand", prompt="【工單】inkstone/ISEP#86")
+                   ▲ 名單上的名字        ▲ 派工單仍然只有這一行
+```
+
+| | |
+|---|---|
+| 名單在哪 | `agents/`，一個檔案一位工人（規約：`docs/governance/worker-roster.md`） |
+| 怎麼看 | `python3 scripts/roster list`／`show <名字>`／`which <owner/repo>` |
+| 機械閘 | `hooks/roster-guard.sh`——沒指名或名單上沒有這個名字就擋，並印出整份名單 |
+
+**為什麼「你是誰」不能收進 §2 的共通規定**：共通規定是「每次都一樣」的東西，
+而「你是誰、你該讀哪些、你的紅線」**每個工人都不一樣**。所以它有自己的家（名單），
+由 `roster-guard.sh` 在派工當下注入——同樣不必有人記得寫。
+
+---
+
+## 1.6 回覆也是派工：**同一套規矩，同一支閘**（inkstone/ISEP#88）
+
+派工單被壓成只剩票號之後，**回覆一個正在跑的 subagent 這條路沒有被管到**——
+那支閘掛在 `PreToolUse(Task|Agent)`，而回覆走的是別的工具，根本不經過那個攔截點。
+
+實況（2026-08-27）：第一次派工乾乾淨淨只有票號，中途回覆時又把一長串修改要求丟過去。
+**那些話票上一個字都沒有**，那條線被停掉或換人接手就消失。
+
+⇒ **不另造一支平行的閘**：同一支 `dispatch-format-guard.sh`、同一個判斷函式，
+只是把所有通往 subagent 的路一次列全（表在 `hooks/lib/dispatch_parse.py` 的 `tool_channel()`）：
+
+| 路 | 裝話的欄位 |
+|---|---|
+| `Task`／`Agent` | `prompt` |
+| `SendMessage` | `message` |
+| 雲端 `create_session` | `prompt` |
+| 雲端 `send_message` | `text`／`message` |
+| 雲端 `create_trigger`／`update_trigger` | `prompt` |
+| 雲端 `fire_trigger` | `text` |
+| 雲端 `send_later` | `message` |
+| Bash `claude -p <prompt>` | 指令裡那段 prompt |
+
+🔴 **新增一條路要加在那張表裡，不要再開一支閘。**
+「認動作的方式漏了一條路」是這一族的通病——`ticket-api-bypass-guard.sh` 的檔頭
+記過同一課（第一版只認大寫裸字 `POST`，`requests.post()` 與隱式 POST 全部漏掉）。
+
+**刻意不管的方向**：subagent 往上回報（`SendMessage to: "main"`）＝**交件不是派工**。
+擋它等於擋掉交件本身。
+
+---
+
+## 2. 共通規定（每一次派工由機器自動注入給收工方）
+
+<!-- INJECT:BEGIN 這段之間的內容會被 dispatch-format-guard.sh 原文注入，改這裡＝改所有派工 -->
+### 你收到的派工單只有一個票號。任務全文在票上。
+
+1. **第一個動作是去讀那張票**（含每一則 comment）。派工單不會再給你別的東西——
+   這是刻意的：票活得比任何一個 agent 久。
+2. **票上的脈絡不夠 ⇒ 回票上問**，不要憑猜測動手，也不要回頭問派工的人要細節。
+3. **交件＝貼回那張票**（`scripts/ticket say <owner/repo#N> -F <檔>`），
+   不是只在對話裡回報。回覆第一行必須是身份欄，見下。
+4. **回覆第一行一律是**：
+   `【身份】<你的名字>／<owner/repo>／<你的分支>`
+   名字用機器注入給你的那個（`isep-hand`、`scout`…）；沒有名字時才退回
+   `總管`／`subagent`／`leo` 三選一。**票上要看得出是哪個工人做的**，
+   而三條線並行時「subagent」這個字回答不了「是誰」。
+5. **不准 push 到 `main`／`master`**，也不准部署 prod。做在自己的分支上，交回分支名。
+6. **Gitea 的 org 是 `inkstone`**（不是 `Leo`）；`gh` 打不到 Gitea；
+   標籤是 `s/*` 不是 `status/*`。
+7. **先讀你要動的那個 repo 的 `CLAUDE.md` 與 `system-dev/wiki/`**，照它的慣例走，
+   不要照你自己習慣的做法。
+8. **交出去之前，你要知道它能不能用**——貼實測輸出，不是「我測過了」。
+   有一格沒驗 ⇒ 那是 report 不是 deliver，講清楚哪一格。
+9. **改了會被載入的東西（plugin／worker／bundle）就要升版**，
+   否則產物按版本號分資料夾，你的改動到不了任何人手上。
+<!-- INJECT:END -->
+
+> 🔴 **這一段是「每次都一樣」的唯一真相源。**
+> 想在派工單裡加一句叮嚀之前，先問：它換一張票還成立嗎？
+> 成立就加在這裡（改一次，全機生效），不要加在那一次的 prompt 裡。
+
+---
+
+## 3. 交件回覆 ＝ 第一行表明身份
+
+```
+【身份】subagent／inkstone/ISEP／feat/ticket-carries-the-task
+```
+
+- 角色是**允許清單**：`總管`／`subagent`／`leo`，**再加上 `agents/` 名單上的每一個工人名字**
+  （`isep-hand`／`arcrun-hand`／`scout`…，inkstone/ISEP#86）。清單以外的名字一律擋。
+- 第二格是你動的 repo，第三格是分支（沒有就寫 `-`）
+
+🔴 **有名字就用名字。** 三條線並行時三則「【身份】subagent／…」長得一模一樣，
+等於沒有身份——這正是 ISEP#86 要解的那件事。
+
+### 為什麼
+
+2026-08-27 實害：多條線並行時票上的留言看不出身份，
+**總管寫的診斷被當成 subagent 的結論，而其中一則是錯的**。
+
+🔴 **這條管所有人，不是只管 subagent。** 總管寫在票上的東西同樣要標
+`【身份】總管／…`——leo 要分得出哪一則是誰寫的。
+
+### 機械閘（兩道，因為這個動作有兩條路）
+
+| 路 | 閘 |
+|---|---|
+| 正門 `scripts/ticket say` / `decide` | 腳本內建檢查，貼上去之前就擋 |
+| 側門 直接打 Gitea API 貼 comment | `hooks/reply-identity-guard.sh`（PreToolUse `Bash`） |
+
+> 只封正門的閘等於沒封——`ticket-api-bypass-guard.sh` 的檔頭已經記過這一課：
+> 「規範有、閘也有，但閘長在『工具』上，而那個動作有兩條路，只封了一條。」
+
+---
+
+## 4. 這份規範自己怎麼被驗
+
+```
+bash hooks/tests/dispatch-format-guard.test.sh       派工單閘＋**回覆那條路**：該擋的與不該擋的
+bash hooks/tests/reply-identity.test.sh              身份欄：正門與側門兩道
+bash hooks/tests/roster-guard.test.sh                工人名單：指名、沒有這個人、注入
+bash hooks/tests/diagnosis-evidence-guard.test.sh    未經調查不寫診斷
+```
+
+測資裡放的是**真的發生過的那幾份違規派工單**，不是想像出來的例子。
+
+---
+
+## 5. 寫上票之前：**未經調查不寫診斷**（inkstone/ISEP#87）
+
+順序只有一個方向：**先派人查 → 拿到查的結果 → 才可以寫診斷。**
+
+> 「診斷寫完了，工人就不知道自己要做什麼——它會照著我的結論去驗證，而不是去查。
+>   而我不是那個 repo 的專家，它才是。」
+
+機械閘 `hooks/diagnosis-evidence-guard.sh` 看三個**結構**訊號（一個關鍵字都沒有）：
+
+1. 這個 session 有沒有**派人查過那張票**（`investigate-first-stamp.sh` 的戳記）
+2. 這段話裡有沒有**走得過去的出處**（檔案:行號／commit／comment 號／票號／網址／實測輸出）
+3. 這段話**有沒有份量**（一句「收到」不可能是診斷）
+
+①有 ⇒ 放行。①無＋②有 ⇒ 放行（**轉述有出處不能被誤擋**）。三者皆缺 ⇒ 擋一次。
+
+🔴 **「根因」「因為」「應該是」這類詞一律不准當判準**——leo 2026-08-17 已證偽文字層封路：
+當日 8 次誤攔、0 次正確攔截，而且**紅線寫得越細，命中關鍵字的機率越高 ⇒ 那些閘在懲罰謹慎**。

docs/governance/sdd-gitea-governance.md

@@ -274,9 +274,9 @@ s/triage ──驗傷通過──▶ s/backlog ──排進 milestone──▶ s
 | E9 | 留言變成推理長文 | hook：超長**不 reject**，要求移去 wiki 再留指標 | ❌ 待建（放寬版，見 §8.3） |
 | E10 | 就地修改治理檔案 | 安裝目錄唯讀 ＋ hook，導向 ISEP 開 issue | ❌ 待建 |
 | E11 | 本機雲端版本漂移 | SessionStart hook 比對版本，不一致 fail-fast | ◐ 現有 `skill-deploy-drift-guard.sh` 管的是 skill 不是 plugin 版本 |
-| E12 | 宣稱交付但沒有 release | 版本三處一致閘：`plugin.json` ＝ tag ＝ release 存在；且 milestone open issues ＞ 0 不准打 tag | ◐ 現有 `delivery-police.sh`／`claim-verify-police.sh` 部分覆蓋 |
+| E12 | 宣稱交付但沒有 release | 版本三處一致閘：`plugin.json` ＝ tag ＝ release 存在；且 milestone open issues ＞ 0 不准打 tag | ◐ 現有 `delivery-police.sh` 部分覆蓋（`claim-verify-police.sh` 已於 `ISEP#60` 移除，見下方腳註） |
 | E13 | 審核被遺忘 | Stop hook：**我自己開的** `s/review` 存在且**這回合完全沒碰它** → 擋一次 | ◐ 現有 `empty-handed-stop-guard.sh` 判準不同，兩者要合併不要疊加 |
-| E14 | Subagent 空口宣稱完成 | SubagentStop hook | ✅ **已有** `subagent-claim-worksheet.sh` ＋ `empty-handed-stop-guard.sh` |
+| E14 | Subagent 空口宣稱完成 | SubagentStop hook | ◐ 原本 `subagent-claim-worksheet.sh` ＋ `empty-handed-stop-guard.sh`；前者已於 `ISEP#60`（2026-08-27）移除，見下方腳註 |
 | E15 | 代理硬做只有人能做的事 | 代理端無對應 tool 或 token；唯一出口是開 `human/exec` 票 | ◐ 部分（credential 機制已擋一部分，D36） |
 | E16 | 標籤漂移 | 走 Gitea labels API 依 `labels.yaml` 校正：缺的補、改的還原、多的**只告警不刪** | ❌ 待建（`ISEP#4`） |
 
@@ -312,6 +312,21 @@ leo 2026-08-17 實測：文字層的閘那天 **8 次誤攔、0 次正確攔截*
 **紅線寫得越細，命中關鍵字的機率越高 ⇒ 那些閘在懲罰謹慎。**
 所以 E9 擋的是「長內容放錯地方」這個**動作**，處置是**導引**（移去 wiki 留指標），不是 reject。
 
+### 8.4 E12／E14：自造的「待驗單」機制已移除，改由 §16 原生三格承接（`ISEP#60`）
+
+`subagent-claim-worksheet.sh`（SubagentStop 產待驗單）與 `claim-verify-police.sh`
+（Stop 攔收工，待驗單還在就擋）這一對於 2026-08-27 整組移除。
+
+- **為什麼不是修它**：症狀是同一份待驗單重生三次、同內容兩個檔名；
+  但真正的問題是 D58——**待驗單是一張 markdown，沒有狀態、沒有持有人、沒有人會回頭看**，
+  必然退化成雜訊。Gitea 的 issue 三格本來就是為這件事做的。
+- **它守的東西現在由誰守**：見 §16（`ISEP#59`／PR #58）——子票相依回答「這件事存在嗎／做完了嗎」、
+  `s/*` tag 回答「它卡在哪一段」、指派回答「現在誰該動」。三格合起來覆蓋原本 E14
+  想擋的「subagent 空口宣稱」與 E12 想擋的「宣稱交付但沒人跟進」。
+- **現況誠實標記**：PR #58（§16 的落地）**尚未 merge**，所以 E12／E14 這一格目前是
+  「舊機制已拆、新機制已提案但未生效」的過渡態，不是「已有替代品在跑」。
+  #58 merge 前，這兩條暫時回到 ❌ 待建的實質狀態，即使表格欄位寫的是 ◐。
+
 ---
 
 ## 9. 本規範的迭代
@@ -702,3 +717,150 @@ Gitea 的 milestone 只管得到同一個 repo，所以六個群在 `inkstone/IS
 **機械閘**＝`hooks/milestone-due-guard.sh`（PreToolUse `Bash`）：
 建 milestone 沒有 `due_on`、或 `due_on` 帶 `9999` → 擋。
 四向實測：無 due_on 擋／9999 擋／真期限放行／只是讀 milestone 放行。
+
+---
+
+## 16. 棒子不會掉：三個 Gitea 原生欄位，全部都要（leo 2026-08-27 立）
+
+> leo 原話：「**不對，子票相依是 gitea 原有機制，改 tag 和指定也是，這些全部都要**」
+> 「可以在討論串延伸子票，它完成了子票就完工，不然這筆任務就是沒完工⋯⋯**票沒完工可以察覺嗎？**」
+> 「**每個任務結束必須要指派回總管**，要說明下一步怎麼做，直到最後交出正確 deliverable 並且驗證」
+
+### 16.0 這一節在解什麼（可重現的掉棒時序）
+
+```
+08-26 13:00  一條線交回 arcrun-rag#136 comment 4267：
+             「Phase 1 的驗收在雲端那半出貨之前驗不了」
+             ← 一根帶著明確解除條件的接力棒，但它只是一段文字
+08-26 18-23  總管把雲端那半併進 main、出 1.4.56、推 prod
+             ← 解除條件在這裡被滿足了，沒有任何東西知道
+08-27 11:xx  leo 問「這個 14 小時前的，你派了還是沒派？」
+             ← 14 小時後才發現棒子在地上
+```
+
+當時那張票：**沒有子票、tag 沒動、沒有指派給任何人**——三格全缺。
+🔴 **根因不是誰忘了，是那件事沒有落在任何一個「撈一次就看得到」的欄位上。**
+
+### 16.1 三個維度正交，缺一個就會掉
+
+| 欄位 | 它回答的問題 | 缺了它會怎樣 |
+|---|---|---|
+| **子票 ＋ 相依** | **這件事存在嗎？做完了嗎？** | 任務藏在討論串，撈 open 票看不到它 |
+| **tag（`s/*`）** | **它現在卡在哪一段？** | 撈得到票，但每次都要重讀整串才知道在等什麼 |
+| **指派（assignee）** | **現在誰該動？** | 知道有事、知道卡在哪，但**沒人認領** |
+
+三個都是 Gitea 原生欄位，**都不必自造**（D58：充分利用 gitea 的機制）。
+
+### 16.2 子票相依是**硬的**，不是提醒（2026-08-27 實測，Gitea 1.26.4）
+
+```
+POST /repos/inkstone/ISEP/issues/56/dependencies  {"owner","repo","index":57}   → 201
+GET  /repos/inkstone/ISEP/issues/56/dependencies                                 → [(57,'open')]
+PATCH /repos/inkstone/ISEP/issues/56  {"state":"closed"}   ← 子票還開著
+   → HTTP 412
+     {"message":"cannot close this issue or pull request because it still has open dependencies"}
+關掉 #57  →  再 PATCH #56 state=closed  →  201，母票 state=closed
+```
+
+⇒ **子票沒關，母票關不掉。這是平台保證，不是自律。**
+畫面上也看得到：母票側欄出現 `Depends on → #57 …（inkstone/ISEP）`。
+
+**跨 repo 也成立**（實測 `ISEP#56` 依賴 `arcrun-rag#136` → 201）
+⇒ 這正是跨 repo 的載體：milestone 只管得到同一個 repo，**相依管得到全部**。
+
+📌 探針票留在 `inkstone/ISEP#56`／`#57`（已關，掛 `type/chore`，票上有實測全文）。
+   **順帶一個規範缺口**：`close/*` 七類（§5）**沒有一類適合「實測探針」**，
+   而 Gitea 的 issue `DELETE` 回 403（只有管理員能刪，已實測）
+   ⇒ 探針票刪不掉也歸不了類。要嘛補一類 `close/probe`，要嘛規定實測一律開在
+   拋棄式 repo。**這一格本節不裁，留給 §5 的維護者。**
+
+- **R16.2.1** 順序／阻擋關係一律用相依（同 R2.5），**禁止只寫文字**。
+- **R16.2.2** 相依掛不上去 ＝ 那張子票對母票是隱形的 ⇒ **視為整個動作失敗**，要當場報錯。
+
+### 16.3 粒度：**傾向多開票，不是少開票**
+
+> leo 2026-08-27（當場更正總管寫反的那條）：
+> 「**小任務做完就關閉，不會讓池子爆掉，每個事情沒有歷史記錄才是大問題**」
+
+```
+這件事需要被記得嗎？（做過什麼、為什麼、量到什麼）
+  需要   →  開票。做完就關。
+  不需要 →  才不開
+```
+
+🔴 **不要用「會不會太多」當判準。** 池子爆掉的前提是「開了不關」——
+那由 **做完就關** 解決，不該由 **不開票** 解決。
+
+三條線不衝突，順序是：
+1. **要不要有票**（本節）——傾向要。判準：這件事需要被記得嗎。
+2. **要不要拆成獨立票**（既有規約）——判準：「票的刀口不是大小，是**狀態**：
+   它會不會需要跟隔壁那條不同的狀態？」
+3. **會不會變成池子**——由「做完就關」解決，不由前兩題解決。
+
+📌 leo 2026-08-16「我不要把所有的票都放在一個 issues，不然就難 track 歷史記錄」
+與本節同一個目的：**可追蹤的歷史**。全塞一張 ⇒ 糊成一團；藏在討論串／prompt ⇒ 根本沒有歷史。
+
+### 16.4 tag 與相依的關係：**流程狀態 vs 結構關係，兩個軸**
+
+- `s/*` 是**這張票走到哪一格**（§3.0 的七態，exclusive）。
+- 相依是**這張票和別張票的結構關係**。
+- 兩者不衝突，也不能互相取代：
+  - 一張票可以 `s/doing` 而且有未關的相依（它自己有事在做，只是還關不掉）
+  - 一張票可以 `s/pending` 而且沒有相依（它卡的是票池外面的東西，例如等 leo 開閘）
+- **R16.4.1** 卡在**別張票**上 ⇒ 掛相依 **並** 轉 `s/pending`。
+  只掛相依不改 tag ＝ 看板上它看起來還在動；只改 tag 不掛相依 ＝ 母票關得掉。
+- **R16.4.2** `Human` 仍是正交 overlay（§6.1），與本節三格互不取代。
+
+### 16.5 指派：棒子的持有人，**是欄位不是文字**
+
+可指派的身份只有兩個（2026-08-27 實查）：`Leo`、`claude-code`。
+**總管就是 `claude-code`**（所有票都是這個 token 寫的），不必新增任何身份。
+
+- **R16.5.1（收工）** 任何一條線收工 ＝ **指派回 `claude-code` ＋ 改 tag ＋ 寫下一步**，
+  三件事是**同一個動作**（`scripts/ticket handback`）。
+- **R16.5.2（要 leo 做）** 指派 `Leo` ＋ 掛 `Human`（§6.1、既有交棒規約）。
+- **R16.5.3（終點）** 棒子有終點——leo 的原話是「**直到最後交出正確 deliverable 並且驗證**」。
+  驗完 ⇒ 關票、清指派 ⇒ 它從所有人的待辦裡消失。
+  **不要讓票變成永遠在傳的燙手山芋。**
+- **R16.5.4（撈一次）** 「哪幾根棒子在誰手上」用 `scripts/ticket mine` 撈，
+  掛在**本來就會做的動作**上（session 開場、收工對帳）。🔴 **禁止排程輪詢**（D20）。
+
+### 16.6 既有的幾十張票怎麼辦：**只從今天起適用，不回頭補**
+
+- **R16.6.1** 不做全面回填。理由：回頭讀幾十張票的每一則 comment 是 O(票數×留言數)，
+  那正是本節說「人與 AI 都不會做」的那個動作——**用一個不會被執行的規定去補一個漏洞，等於沒補。**
+- **R16.6.2** 改成**碰到才補**：任何人（或閘）下一次動到某張票時，
+  順手把它討論串裡還活著的待辦長成子票。**動到才補，成本落在本來就要付的那次。**
+- **R16.6.3** 例外：`hub` 票（§1）**要補齊**——它們本來就宣稱自己是聚合容器，
+  而 §3.2「子票全關才能關 hub」在沒有相依的情況下是**靠自律**的。
+  掛上相依之後，那條規則變成平台保證。
+  ✅ **2026-08-27 實查：六張 hub 全部已經掛好了**，且數量與各自內文列的來源票一致——
+  `ISEP#30` 6／`#31` 7／`#32` 11／`#33` 5／`#34` 8／`#35` 7（跨 `InkStoneCo`／`Arcrun`／
+  `arcrun-rag`／`system-dev-template` 四個 repo）。**這一格不用補，本條是為了讓它不再退化。**
+
+### 16.7 工具與機械閘
+
+```
+scripts/ticket subtask <母票> --title <User Story> -F <檔> [--label] [--assign X --next "<一句>"]
+      討論串裡的一件事 → 子票 ＋ 回鏈 Parent: ＋ Gitea 原生相依（三格一次到位）
+      🔴 `--assign` 一定要配 `--next`：有人被指到票上，他撈到它的第一件事就是問
+         「所以我要做什麼」——那句話開票當下就要寫，不是等他重讀整串
+scripts/ticket handback <票> --to <claude-code|Leo> --next "<一句話>" [--label] [--evidence]
+      收工 ＝ 指派 ＋ 改 tag ＋ 寫下一步，一個動作三件事
+scripts/ticket mine [--user <誰>]
+      撈一次：棒子在誰手上、每根的下一步、每根還有幾張未關的相依
+```
+
+| 閘 | 掛在哪 | 抓什麼 | 測試 |
+|---|---|---|---|
+| `hooks/comment-carries-task-guard.sh` | PreToolUse `Bash` | 留言裡帶「等 X 才…／驗不了／還沒…」這種**未完成的未來式**，卻沒開子票 → 擋一次 | `scripts/test-comment-carries-task-guard.sh`（22 條） |
+| `hooks/baton-handback-guard.sh` | PostToolUse `Agent\|Task` | 一條線收工，票上**指派／tag／下一步**缺哪一格 → 當場說出來（提醒，不擋） | `scripts/test-baton-handback-guard.sh`（10 條） |
+
+🔴 **兩支閘的誤攔設計**：`comment-carries-task-guard` 同一 session 只擋一次，
+關鍵詞刻意取窄，並留 `no-subtask: <理由>` 逃生口（留痕）。
+理由寫在 `.claude/branch-holds.md` 檔頭那句：
+**永遠在響的警報，等於訓練人忽略這個警報。**
+
+🔴 **hook 裡比對中文一律用 `python3` 的 `re`，不要用 `grep` 的字元類**
+（2026-08-27 實撞：`等[^。]{0,20}出貨` 在真實 hook 呼叫路徑下對
+「等雲端那半出貨」不匹配，閘靜默失效；換成 python3 後測試由 19/20 變 20/20）。

docs/governance/worker-roster.md

@@ -0,0 +1,41 @@
+# `agents/` — 工人名單（inkstone/ISEP#86）
+
+> leo 派工時派給的不能是「一個 agent」，要派給**有名字的人**。
+> 「票上看不出來這件事是誰做的」是這張票的來由。
+
+**一個檔案 ＝ 一個工人。** 每個檔案只回答四件事：
+
+| 段 | 問題 | 為什麼一定要有 |
+|---|---|---|
+| `**負責 repo**` | 它管哪一個 repo | 派工時挑人的唯一判準；也是【身份】欄第二格 |
+| `## 開工前先讀` | 它要先讀什麼 | 這是**每個工人各自不同**的部分——共通規定補不了 |
+| `## 紅線` | 它不准做什麼 | 全機共通的紅線在共通規定裡；這裡只寫這個 repo 特有的 |
+| frontmatter `description` | 一句話它是誰 | `scripts/roster list` 印的就是這一行 |
+
+## 為什麼是這個形狀，不是自己造一套
+
+`agents/` 是 Claude Code plugin **原生**的 subagent 目錄，檔名（frontmatter 的 `name`）
+就是 `Task` 工具的 `subagent_type`。⇒ 「指名派給誰」不必發明新欄位、不必改派工單格式
+（派工單仍然只有 `【工單】` 一行，`dispatch-format-guard.sh` 的行為一個字都沒變）。
+
+## 怎麼用
+
+```
+python3 scripts/roster list            # 名單：有哪幾個工人、各自管什麼
+python3 scripts/roster show isep-hand  # 一個工人的全文（它開工前會讀到的東西）
+python3 scripts/roster names           # 只印名字，給腳本用
+```
+
+派工時把名字放進 `Task` 的 `subagent_type`；名字不在名單上，
+`hooks/roster-guard.sh` 會擋下來並說「**沒有這個人**」，同時把名單印出來。
+
+## 加一個工人
+
+在這個目錄新增一個 `.md`（照既有檔案的四段），然後：
+
+```
+python3 scripts/roster list                       # 新的名字要出現
+bash hooks/tests/roster-guard.test.sh             # 全綠
+```
+
+**不必改任何 hook**——名單是資料，閘讀的是這個目錄。

docs/hooks-inventory.md

@@ -1,4 +1,5 @@
-# 46 支閘，白話盤點表
+# 56 支閘，白話盤點表
+# 54 支閘，白話盤點表
 
 > 回應 `inkstone/InkStoneCo#40`：「如果加入了，我應該可以白話文看到 hooks 的內容？」
 > 這份表就是那個「白話文」——不用點開任何 `.sh` 檔，一行看懂一支閘在管什麼。
@@ -7,15 +8,72 @@
 
 ## 一句話結論
 
-`hooks/` 底下有 **46 個 `.sh` 檔**，`hooks.json` 實際掛上 **56 條註冊**（同一支閘常被多種情境同時掛上）；
+`hooks/` 底下有 **58 個 `.sh` 檔**，`hooks.json` 實際掛上 **79 條註冊**（同一支閘常被多種情境同時掛上）；
+`hooks/` 底下有 **58 個 `.sh` 檔**，`hooks.json` 實際掛上 **79 條註冊**（同一支閘常被多種情境同時掛上）；
+`hooks/` 底下有 **58 個 `.sh` 檔**，`hooks.json` 實際掛上 **79 條註冊**（同一支閘常被多種情境同時掛上）；
 其中 **3 支檔案存在但沒被掛上**（2 支是待人填的空範本、1 支是刻意留著沒開的止血帶，見下面「未生效」表）。
 下面按「你會在什麼時候撞到它」分組，一支一行。
 
 > 🔴 **這兩個數字上一版是錯的（2026-08-26 實際數過才發現）**：本頁原本寫「43 個檔、53 條註冊」，
 > 而當時真實是 **45 個檔、55 條註冊**——中間有兩支閘進來時沒有回頭改這裡。
 > 現在的寫法是實際數出來的：
-> `ls hooks/*.sh | wc -l` ＝ 46；`hooks.json` 展開後的 command 條目 ＝ 56。
+> `ls hooks/*.sh | wc -l` ＝ 56；`grep -c '"command":' hooks/hooks.json` ＝ 75。
+> ⚠️ **冒號不能省**：`grep -c '"command"'`（沒冒號）會連 `"type": "command"` 一起數到，回 **120**。
+> 本頁 2026-08-27 之前寫的是沒冒號那版——**照著它跑會拿到一個跟本頁不符的數字**。
 > **一份會偷偷過期的盤點表，跟沒有盤點表差不多**——見本頁最後「怎麼跟實況對帳」那段。
+>
+> 📌 **`0.6.0`（`inkstone/ISEP#59`，2026-08-27）這兩個數字是併完之後當場數出來的**：
+> `ISEP#60` 移除了 `claim-verify-police.sh`／`subagent-claim-worksheet.sh` 這對自造機制（−2 支、−16 條），
+> `ISEP#58` 補進 `comment-carries-task-guard.sh`／`baton-handback-guard.sh`（＋2 支、＋8 條），
+> 加上 `ISEP#72` 的 `reply-identity-guard.sh` 已在 main 上。
+> 一加一減之後檔數不變、註冊條數落在 59——**這正是「不能靠加減推算、只能實數」的例子**：
+> 上一版寫 58，就是把兩批改動的加減兜出來、沒有真的數過。
+>
+> 📌 **`0.10.0`（`inkstone/ISEP#63`，2026-08-28）＋1 支、＋3 條**：
+> `countdown-guard.sh` 一支同時掛在 `UserPromptSubmit`（注入倒數）與 `Stop`（查核有沒有戴），
+> 加上 SessionStart 多掛一條 `scripts/countdown-milestone-refresh.sh`（更新期限快取，不是閘）。
+> **兩個事件是同一件事的兩半**：只注入 ＝ 又一個會被忽略的提醒；只查核 ＝ 罰它做一件拿不到資料的事。
+> 這兩個數字是併之前當場數出來的，不是從上一版加減推出來的。
+
+> 📌 **`inkstone/ISEP#82`（2026-08-28）＋1 支、＋3 條**：`mainline-focus-guard.sh`
+> 同時掛在 `Agent` 與 `Task`（派工的兩個入口都要守，只守一個等於沒守），
+> 加上 SessionStart 多掛一條 `scripts/mainline refresh`（更新主線的進度／期限，不是閘）。
+> **53→54 支、68→71 條，兩個數字是加完之後當場數出來的**（指令見本頁最後一段）。
+> ⚠️ 同時修掉一行重複：上一版「一句話結論」那一句被貼了兩遍
+> （53／68 那組數字本身是對的，只是印了兩次）。
+
+> 🔴 **`0.6.1`（2026-08-27）補回表格漏掉的兩列**：`isep-presence-beacon.sh`（E 組）、
+> `milestone-due-guard.sh`（A 組）。**標頭寫 48 支的同時，下面的表格只列得出 46 支**
+> ——數字是對的，人話少了兩行。發現的方法與防它再犯的指令，見下面「落差偵測」第二組 `comm`。
+>
+> 📌 **`0.7.0`（`inkstone/ISEP#30`，2026-08-27）進來一支**：`mainline-idle-guard.sh`（F 組，Stop）。
+> 48→**49** 支、59→**60** 條，兩個數字都是加完之後當場數出來的（指令同上）。
+>
+> 📌 **`inkstone/ISEP#86`／`#87`／`#88`（2026-08-28）進來三支、＋7 條**：
+> `roster-guard.sh`（D 組，`Task`＋`Agent` 各一條）、
+> `diagnosis-evidence-guard.sh`（A 組，Bash）、
+> `investigate-first-stamp.sh`（H 組，`Agent|Task` 與 `SendMessage` 各一條），
+> 外加 `dispatch-format-guard.sh` 多掛兩處——Bash（接 `claude -p` 這條路）與
+> **新的「回覆 subagent」matcher**（`SendMessage` 與雲端 session／trigger 那幾支）。
+> 53→**56** 支、68→**75** 條，兩個數字都是**在這棵樹上當場數出來的**
+> （`ls hooks/*.sh | wc -l`／`grep -c '"command":' hooks/hooks.json`），
+> 不是拿上一版加減推的。順手改掉兩個過期的數字：`README.md` 的「48 支／59 條註冊／23 支腳本」
+> ——實數是 53／68／35（那是**併之前** main 上的實況），本版之後是 56／75／36。
+> **同一個病，只是換一個檔案。**
+
+> 📌 **`0.10.0`（`inkstone/ISEP#81`，2026-08-28）進來一支**：`pr-verdict-guard.sh`（F 組，Stop）。
+> 51→**52** 支、64→**65** 條，兩個數字都是加完之後當場數出來的（指令同上）。
+> 順手改掉一個過期的數字：描述欄長期寫「27 支腳本」，實數是 **34**
+> （`ls -p scripts | grep -v / | wc -l`）——**同一個病，只是換一欄。**
+
+> 📌 **`inkstone/ISEP#85`（2026-08-28）進來一支**：`milestone-account-guard.sh`（A 組，PreToolUse／Bash）。
+> 53→**54** 支、68→**69** 條，兩個數字都是加完之後**在自己的樹上當場數出來的**
+> （指令同上），**不是拿上一版加一**——`system-dev/wiki/mistakes.md` 記著這條：
+> 那個數字是 leo 的驗收介面，多報就是假綠。
+> 順手修掉一個真的漂移：上一版「一句話結論」那一句**被貼了兩次**（同一行連續出現兩遍），
+> 而標頭寫 52、內文寫 53——**同一頁裡三個數字互相矛盾**，正是本頁自己警告過的那種病。
+> 另外描述欄的「38 支腳本」是把 `kbdb-live-exam/`／`lib/`／`patches/` 三個**目錄**也數進去了；
+> 用本頁寫死的那道指令（只數檔案）實數是 **39**。
 
 ---
 
@@ -43,8 +101,13 @@
 | `not-my-branch-guard.sh` | AI 想 commit 到「別的 subagent 正在施工中」的分支（登記在 `branch-holds.md`）就擋下，避免兩個 AI 互踩同一條分支。 | 🛑 擋 |
 | `leo21c-write-guard.sh` | AI 想寫東西到你私人帳號 `leo21c` 就擋下——這個帳號只准你自己用，AI 的實驗一律走別的測試帳號。 | 🛑 擋 |
 | `release-tag-guard.sh` | AI 想打版本 tag，但 `plugin.json` 裡寫的版本號跟 tag 對不上就擋下——避免「這裡說 0.2.0、那裡說 0.1.0」各說各話。 | 🛑 擋 |
-| `ticket-api-bypass-guard.sh` | AI 想繞過 `scripts/ticket` 工具、直接打 API 開新 Gitea 票（會漏掉「開票前先搜過」這道檢查）就擋下。 | 🛑 擋 |
-
+| `ticket-api-bypass-guard.sh` | AI 想繞過 `scripts/ticket` 工具、直接打 API 新增 Gitea 東西（開新票／milestone／label／PR，會漏掉「新增前先搜過」這道檢查）就擋下——不管是隱式 POST（urllib 傳 data= 沒寫 method）還是小寫 `requests.post(...)`。 | 🛑 擋 |
+| `milestone-due-guard.sh` | AI 想開一個新的里程碑（milestone）卻沒填期限就擋下，**填 `9999-01-01` 一樣擋**——那是「沒有期限」穿了一件期限的衣服，盤點時每一格看起來都有值，其實一格都沒有。只管「建里程碑」這個動作，查詢／改別的欄位都放行。 | 🛑 擋 |
+| `milestone-account-guard.sh` | AI 想直接打 API 把某個里程碑改成「已關閉」，卻**還沒留下「估多久／花多久／差多少／為什麼差」**就擋下。跟上一列是同一條線的兩端：那支管**開**里程碑要有真的期限，這支管**關**的時候要留下帳。走正門 `scripts/milestone-account close` 就會自己算（數字取自 Gitea 的 `created_at`／`due_on`／`closed_at`，不用手填），差超過 ±25% 才要你從**七個固定代號**裡挑一個，而且那個代號要有 Gitea 時間軸撐得住——**不採信自述**。純讀取／建里程碑／改期限／只是談論它／走正門，全部放行；真要手動關就在指令裡加 `milestone-account-ok`（留痕）。 | 🛑 擋 |
+| `reply-identity-guard.sh` | 直接打 Gitea API 貼留言到票上時，內文第一行沒有 `【身份】`（`總管`／`subagent`／`leo`）就擋下——票上多條線並行時，看不出哪一則是誰寫的。純讀取、走 `scripts/ticket` 正門、指令裡加 `reply-identity-ok` 都放行。 | 🛑 擋 |
+| `comment-carries-task-guard.sh` | AI 要在票裡留一則「等某某上線才驗得了」這種**還沒做完的事**，卻沒有把它開成一張子票時，擋一次。留言沒人會回頭讀，票的 open／closed 撈一次就看得到。 | 🛑 擋（同一輪只擋一次） |
+| `search-is-not-proof-guard.sh` | AI 用知識庫的**搜尋**找到一筆東西，然後把那筆東西的原始編號直接貼進票裡或派工單裡，當成「某個功能壞了」的證據——而它從沒用正規的檢索路徑去查過那筆——擋一次。你關心的是：不會再有人拿錯的方法量出一個錯的結論，然後退回一張其實已經做完的票。 | 🛑 擋（同一輪只擋一次） |
+| `diagnosis-evidence-guard.sh` | 你想把一段有份量的東西寫上票，而這個 session **沒派人去查過那張票**、那段話裡也**沒有任何走得過去的出處**（檔案:行號／commit／comment 號／票號／網址／貼出來的實測輸出）就擋一次——未經調查的診斷寫在票上會長得像事實，工人會照著它去驗證而不是去查。派過人查、或把出處帶上，都放行；一句短回覆不管。 | 🛑 擋 |
 ## B. AI 想寫檔案／改程式碼的當下（PreToolUse / Write·Edit·MultiEdit）
 
 | 閘名 | 對你意味著什麼 | 動作 |
@@ -76,6 +139,10 @@
 | `micromanage-guard.sh` | 派工單寫得太細（指名檔案函式、編號步驟、要求每做一項回報一次…）就擋下——subagent 該被當成有能力的同事，不是照抄劇本的工具。 | 🛑 擋 |
 | `irreversible-dispatch-guard.sh` | 派工單裡出現「刪分支」「drop table」「rm -rf」這類不可逆動作，卻沒寫「先停下來等回覆才執行」就擋下。 | 🛑 擋 |
 | `no-ticket-no-dispatch.sh` | 派工單裡沒有寫工單號（`【工單】owner/repo#N`），或那張票已經關閉／根本不存在，就擋下——沒有票號的工作沒有人追得到進度。 | 🛑 擋 |
+| `dispatch-format-guard.sh` | **派工單 ＝ 票號，就這樣。** 票號以外還寫了別的東西（背景、驗收條件、紅線、交件方式、「這個 session 才知道的事」）就擋下，並告訴你那些內容該搬去哪：每次都一樣的 → 共通規定；這次才知道的 → **寫進那張票**。反過來，合規的派工它會**自動把共通規定注入**給收工方（交件方式、不准 push main、org 是 `inkstone`…），所以你不寫也不會漏。判準是「這一行是不是【工單】欄位」——**在不在**，不是寫了什麼，所以講得再謹慎也不會被多罰。純禮貌收尾（「謝謝」）不算違規；`（→ comment M）` 不論全形或半形括號都認得（ISEP#65 修過一次：CLAUDE.md 自己規定的合格寫法曾經被這支閘自己擋下）。**`ISEP#88` 起同一支閘也掛在「回覆 subagent」那條路上**（`SendMessage`、雲端 session／trigger、以及 Bash 的 `claude -p`）——回覆也是派工，同一套規矩；擋下來時會把那段內容**原文印出來**方便直接貼上票。subagent 往上回報（`to: "main"`）不管，那是交件不是派工。 | 🛑 擋（＋注入） |
+| `roster-guard.sh` | 派工要**指名派給誰**：`Task` 的 `subagent_type` 得是 `agents/` 名單上的名字（`isep-hand`／`arcrun-hand`／`scout`…），沒指名或指了不存在的名字就擋下，並把整份名單印出來。指對了它會**自動把那位工人的檔案原文注入**給它——你是誰、負責哪個 repo、開工前先讀什麼、你的紅線是什麼（這些每個工人都不一樣，共通規定補不了）。名單是資料：加一個工人＝在 `agents/` 加一個 `.md`，不必改任何 hook。 | 🛑 擋（＋注入） |
+| `mainline-focus-guard.sh` | 派出去的票**不在「現在的主線」上**，就擋一次，並問你是「補收」（它本來就該掛在主線上）還是「跳線」（真的插件事）。背景：2026-08-27 實查有 **14 個 milestone 同時開著**，其中「Mira 現代化」同名活在 5 個 repo ⇒ SOP 說的「只做該 milestone 的事」在現場**沒有指涉對象**，等於不存在。現在主線是一個查得到的事實（`scripts/mainline`，答案唯一），這支就是那個事實的用處。🔴 **沒有標主線 ⇒ 一律放行**；多張票只要有一張在主線上就放行；查不到那張票掛在哪也放行（**讀不到 ≠ 不屬於**）；**同一張票只擋一次**，重送就過。跳線會留一筆紀錄——不留痕的話，跳線與專注在機器上長得一模一樣。 | 🛑 擋（同一張票至多一次） |
+| `dispatch-format-guard.sh` | **派工單 ＝ 票號，就這樣。** 票號以外還寫了別的東西（背景、驗收條件、紅線、交件方式、「這個 session 才知道的事」）就擋下，並告訴你那些內容該搬去哪：每次都一樣的 → 共通規定；這次才知道的 → **寫進那張票**。反過來，合規的派工它會**自動把共通規定注入**給收工方（交件方式、不准 push main、org 是 `inkstone`…），所以你不寫也不會漏。判準是「這一行是不是【工單】欄位」——**在不在**，不是寫了什麼，所以講得再謹慎也不會被多罰。純禮貌收尾（「謝謝」）不算違規；`（→ comment M）` 不論全形或半形括號都認得（ISEP#65 修過一次：CLAUDE.md 自己規定的合格寫法曾經被這支閘自己擋下）。 | 🛑 擋（＋注入） |
 
 ## D2. AI 想開口問你問題的當下（PreToolUse / AskUserQuestion）
 
@@ -93,7 +160,9 @@
 
 | 閘名 | 對你意味著什麼 | 動作 |
 |---|---|---|
+| `isep-presence-beacon.sh` | 對話一開始印一行 `🟢 ISEP vX.Y.Z 已載入（N 支閘｜來源：…）`。**這行不是裝飾，是唯一能證明「這個 session 真的有閘」的東西**——它自己就住在 plugin 裡，看得到它就表示 plugin 載入了；某個 session 從頭到尾沒有這行，那個 session 是零閘狀態，先修 plugin 再做事。同一台機器可能同時有兩份 ISEP（marketplace 裝的、repo 裡 vendor 的），所以那行會講出這次是哪一份在說話。 | 📝 記錄（context 注入） |
 | `session-start-recall.sh` | 對話一開始就自動把「全局現況」（Gitea 各 repo 的票、KBDB 的藏書地圖）推到 AI 眼前，不必等它自己想到要查。 | 📝 記錄（context 注入） |
+| `scripts/mainline refresh` | （不是閘，是腳本）對話一開始把**現在的主線**那條 milestone 的進度與期限更新一次，好讓每回合眼前那一行講的是今天的數字。拿不到 Gitea 就原封不動——**寧可資料舊，不要把主線弄丟**。跑一次就結束，不輪詢。 | 📝 記錄 |
 | `skill-deploy-drift-guard.sh` | 如果「全機真正在用的 skill」跟「repo 裡版控的正本」內容對不上，就在開場講出來——避免用著一份沒人知道已經跟正本分家的舊拷貝。 | 📝 記錄 |
 
 ## F. AI 想結束這一輪、要收工的時候（Stop）
@@ -103,21 +172,26 @@
 | `empty-handed-stop-guard.sh` | 這一輪 AI**一個動作都沒做**卻想停下來（等你回覆），就擋下並告訴它「你的命令就是完整授權，不用再等第二次確認」。 | 🛑 擋（至多攔一次） |
 | `worklist-guard.sh` | AI 自己列過的待辦清單裡還有沒做完的步驟，卻想收工寫報告，就擋下，逼它做完剩下的步驟。 | 🛑 擋 |
 | `factory-idle-guard.sh` | AI 該去派工卻沒派（工頭停工），就擋下要它交出「已經派工的憑證」，不是隨口說一句「我會催」就算數。**過閘有四條路：現在就派工／把票號寫進那句話／寫一行 `⏸ 等：<在等什麼>`／這一輪收尾在動作上。** 2026-08-23（inkstone/ISEP#30）修好「引用被當成主張」——貼原始碼、引用它自己的訊息、否認自己有下一步，都不再被咬。 | 🛑 擋 |
+| `mainline-idle-guard.sh` | AI **連續 4 個回合一直在查、一直在讀，卻什麼都沒交出去**（沒派工、沒改檔、沒寫回票）就擋一次。補的是上面兩支中間那一格：「沒動作」空手警察管、「說了下一步卻沒派」稼動率警察管，**而「有動作、但就是不說下一步」以前兩支都放行**。這支**一個字都不讀**，只看有沒有派工／產出／工作區變動。響過一次門檻就加倍（4→8→16），不會變成一直在響的警報。 | 🛑 擋（響過就退讓） |
+| `pr-verdict-guard.sh` | 收工時清點「還有哪些 PR 沒有結論」——open、**沒有人被指派**、也沒有「要求修改」review 的 PR，就擋一次並**點名是哪幾個**（含開了幾天與網址）；已經 merge 但**分支還留著**的也一起點名（票上寫死「併完當場刪掉那條 branch」）。背景：2026-08-27 實查，最久的三個 open PR 躺了兩星期，而當時 46 支閘沒有一支在管 PR——票看起來「已交付」，東西卻沒進 main、沒進版本，**leo 手上永遠不會出現它**。🔴 **擋的是遺忘，不是等待**：指派給誰（或掛 Human）就立刻不再點名它；響過門檻就加倍（1→4→8→16，每個 PR 各自算）。搭配 `scripts/pr-verdict`（merge／reject／changes 各一個動作）。 | 🛑 擋（響過就退讓） |
+| `countdown-guard.sh` | **每一則回覆都自己說出「這件事已經花了多久／距今天收工線還剩多久」**，而且不必有人記得。一支閘掛兩個事件：你送出訊息時它先把算好的那一行放到 AI 眼前（`UserPromptSubmit`），AI 想收工時它再看這一回合的回覆裡到底有沒有那一行，沒有就擋一次要它補（`Stop`）。**只做前半 ＝ 又一個會被忽略的提醒**，所以兩半綁在一起。已過時間從**這段對話的第一則訊息**算起（＝一個 release 的起點）；收工線是台北 16:00，過線後四小時內顯示「已超過」，不會把超時悄悄換算掉。子 session、純工具回合、已經提醒過一次的，全部放行。**同一個注入點還帶第二行 `🎯 現在的主線是哪一個`**（`inkstone/ISEP#82`）——那一行沒有另外立閘，因為主線的名字本來就掛在被查核的 ⏱ 那一行上。 | 🛑 擋（至多攔一次） |
 | `browser-verify-guard.sh` | 這一輪 AI 宣稱「前端驗過了」，卻沒有真的用瀏覽器工具載入過，就擋下——`curl` 抓到 HTML 不算驗過。 | 🛑 擋 |
 | `self-drive-police.sh` | AI 想停下來問你「早就決定過的事」（用固定句型判斷，例如「要不要 X」「下一步做什麼」「這交給你」）就擋下，反問它查過 wiki／查過派工表了沒。 | 🛑 擋 |
 | `self-drive-judge.sh` | 跟上面同一件事，但改用小模型（haiku）判斷「換句話說」的請示句——防止 AI 只是把「要不要」改寫成「不確定是否符合期待」就閃過上一支閘。 | 🛑 擋 |
 | `delivery-police.sh` | AI 宣稱「這件事做完了」，卻看不到任何實測證據（畫面截圖、指令輸出、HTTP 狀態碼…）就擋下。 | 🛑 擋 |
 | `wiki-first-police.sh` | AI 做完事卻沒有把結論寫回 wiki 就想收工，就擋下——下次（或別的 AI）查 wiki 會查不到這次做過什麼。 | 🛑 擋 |
 | `unpushed-police.sh` | AI 改好的東西還留在本機、沒有真的推送出去給別人用，卻想收工，就擋下——「改對了但沒送到」跟沒改是一樣的。 | 🛑 擋 |
-| `claim-verify-police.sh` | Subagent 交回來的「我做完了」宣稱還沒被驗證過（對應的待驗檔案還在），你這邊卻想收工，就擋下。 | 🛑 擋 |
+
+> 🔴 **`claim-verify-police.sh` 已於 `inkstone/ISEP#60` 移除**（連同下面原本的 G 組 `subagent-claim-worksheet.sh`）。
+> 這一對是自造的「待驗單」機制（一張沒有狀態、沒有持有人的 markdown），違反 D58：
+> 不要硬做平台不支援的機制。它守的情境現在改由 Gitea 原生三格承接
+> （子票相依／`s/*` tag／指派——見 `inkstone/ISEP#59` 與 PR #58）。
 
 ## G. Subagent 把工作交回來的時候（SubagentStop）
 
-| 閘名 | 對你意味著什麼 | 動作 |
-|---|---|---|
-| `subagent-claim-worksheet.sh` | Subagent 一交回工作，就自動把它宣稱做了什麼寫成一張「待驗清單」檔案——之後總管收工前，`claim-verify-police.sh` 會檢查這張清單有沒有被處理掉。 | 📝 記錄 |
-
-> 這個時機還掛了 `worklist-guard.sh`／`self-drive-police.sh`／`self-drive-judge.sh`／`delivery-police.sh`／`wiki-first-police.sh`／`unpushed-police.sh`，行為跟上面 F 組完全一樣，只是對象換成「subagent 交回來的這一輪」。詳見「重複掛載」一節。
+`inkstone/ISEP#60` 之後，這個時機**沒有專屬掛載的閘**了（原本唯一的一支 `subagent-claim-worksheet.sh` 已移除）。
+仍會掛到這個時機的是 `worklist-guard.sh`／`self-drive-police.sh`／`self-drive-judge.sh`／`delivery-police.sh`／`wiki-first-police.sh`／`unpushed-police.sh`，
+行為跟上面 F 組完全一樣，只是對象換成「subagent 交回來的這一輪」。詳見「重複掛載」一節。
 
 ## H. 動作做完之後，純粹記一筆（PostToolUse，全部不擋）
 
@@ -126,7 +200,9 @@
 | `kbdb-asked-stamp.sh` | AI 真的查過 KBDB 之後，留一個時間戳——給前面 `history-first-guard.sh` 判斷「這輪有沒有先查過」用。 | 📝 記錄 |
 | `subagent-first-stamp.sh` | AI 真的派過工之後，留一個時間戳——給 `subagent-first-guard.sh` 判斷用。 | 📝 記錄 |
 | `issue-status-autoflip.sh` | AI 一派工出去，就自動把對應的 Gitea 票改成「進行中（s/doing）」，不必等人手動改標籤。 | 📝 記錄（自動改票） |
-
+| `baton-handback-guard.sh` | 一條派工線做完了，就去看它那張票有沒有**指派給人／標籤有沒有說它卡在哪／有沒有寫下一步**，缺哪一格就當場說出來。你關心的是：不會再有票做完了卻沒人接手，躺在那裡沒人發現。 | 📝 記錄（提醒，不擋） |
+| `kbdb-evidence-stamp.sh` | AI 每次去知識庫拿資料，就記一筆「這是**搜尋**搜到的，還是**走正規檢索路徑**拿到的」。你關心的是：它等一下要拿這筆資料下結論時，有東西可以對照它走的是哪條路。 | 📝 記錄 |
+| `investigate-first-stamp.sh` | 你真的**派人去查某張票**之後，按「session ＋ 票號」留一個時間戳——給 `diagnosis-evidence-guard.sh` 判斷「這件事有沒有人查過」用。按票分而不是按 session 分：早上派人查了 A 票，不該等於解鎖了 B 票的診斷。 | 📝 記錄 |
 ## I. 你會撞到但跟「派工／收工」無關的一支（Edit·MultiEdit）
 
 | 閘名 | 對你意味著什麼 | 動作 |
@@ -159,12 +235,74 @@ pre-write-guard.sh
 pre-write-guard.template.sh
 shadow-table-guard.sh
 
-# hooks.json 註冊了、但檔案不存在 → 空（目前沒有這種「指向空氣」的閘）
+# hooks.json 註冊了、但檔案不存在 → 應該是空的
 $ comm -13 /tmp/fs_hooks.txt /tmp/registered_hooks.txt
+countdown-milestone-refresh.sh    ← 假警報：它在 scripts/ 不在 hooks/
+```
+
+🔴 **上面那一筆是假警報，不是「指向空氣」的閘**：`inkstone/ISEP#63` 之後，
+SessionStart 上掛的東西不全是 `hooks/*.sh`——`scripts/countdown-milestone-refresh.sh`
+是腳本不是閘。這組指令只比檔名、不看目錄，所以它會出現在這裡。
+（`inkstone/ISEP#82` 又多掛一條 `scripts/mainline refresh`，那一條沒有 `.sh`
+副檔名，所以不會落進這個名單。）**照著跑會看到它，這裡先講清楚，
+免得下一個人以為是自己弄壞的。**
+
+🔴 **上面那兩行驗不出「表格漏列」**——它們比的是 `hooks.json`，不是這張表。
+「有閘、但這頁沒有它那一行人話」要另外一組指令才看得見，就是下面這組
+（2026-08-27 就是靠它抓到本頁漏了 `isep-presence-beacon.sh`／`milestone-due-guard.sh` 兩列）：
+
+```
+$ ls hooks/*.sh | xargs -n1 basename | sort > /tmp/inv_fs.txt
+$ grep -oE '^\| `[a-zA-Z0-9_.-]+\.sh`' docs/hooks-inventory.md \
+    | grep -oE '[a-zA-Z0-9_.-]+\.sh' | sort -u > /tmp/inv_table.txt
+
+# 有這支閘、但這頁沒有它那一列 → 要補人話
+$ comm -23 /tmp/inv_fs.txt /tmp/inv_table.txt
+（無輸出）
+
+# 這頁列了、但檔案已經不在了 → 要刪那一列
+$ comm -13 /tmp/inv_fs.txt /tmp/inv_table.txt
 （無輸出）
 ```
 
-**這次順便抓到的另一個落差**：`.claude-plugin/plugin.json` 的說明文字寫「42 支機械閘（52 條註冊）」，
+🔴 **`^\| \`` 這個錨點不能拿掉**——它的意思是「**這一行的第一欄就是這支閘**」，
+也就是「表格真的列了它」。把錨點拿掉、改成抓全頁所有反引號裡的 `*.sh`，
+反向那半會吐出 **3 個假警報**（2026-08-27 實跑）：
+
+```
+claim-verify-police.sh        ← 出現在「已於 ISEP#60 移除」那段**移除紀錄**裡
+subagent-claim-worksheet.sh   ← 同上
+github-arm.sh                 ← 它在 `scripts/`，不在 `hooks/`；是 github-contact-guard
+                                 那一列裡告訴你「怎麼解鎖」的逃生口
+```
+
+**三個都不是幽靈，三個都不該刪**：刪掉前兩個等於刪掉「G 組為什麼是空的」這段歷史，
+刪掉第三個等於讓那一列不再告訴你怎麼過閘。
+⇒ **0 次正確攔截、3 次誤攔**——照這個訊號去改，會把好東西改壞。
+
+那「頁面上出現了一個根本不存在的檔名」怎麼辦？**那要另外一格量，而且判準不是文字是事實**：
+
+```
+# C. 頁面提到的每個 *.sh，現在存在，或者 git 歷史裡存在過
+$ for n in $(grep -oE '`[a-zA-Z0-9._-]+\.sh`' docs/hooks-inventory.md | tr -d '`' | sort -u); do
+    [ -f "hooks/$n" ] || [ -f "scripts/$n" ] && continue
+    [ -n "$(git log --all --oneline --diff-filter=AD -- "hooks/$n" "scripts/$n")" ] && continue
+    echo "$n"
+  done
+（無輸出）
+```
+
+**「現在沒有、但曾經有」＝歷史，合法；「從來沒有過」＝打錯字或憑空捏造，才是幽靈。**
+這一格問的是 git，不是問這頁的用字，所以它不會因為誰換個寫法就失效。
+
+📌 **三格都要跑，而且它們量的是不同東西**：
+A1 缺人話、A2 表格有幽靈、C 全頁有幽靈。
+**標頭的 48／59 對不代表這頁沒漏**——補進 2 支真的、同時留著 2 支假的，數字照樣湊得到 48。
+**數量相等不等於集合相等**，所以驗的一律是集合（`comm`），不是 `wc -l`。
+
+**這次順便抓到的另一個落差**（🕐 **這一段是 2026-08-20 的快照，裡面每個數字都是那天的，不是現況**——
+留著是因為它是「兩份文件的數字不會自己跟上」這個病的第一個案例；現況數字看本頁標頭）：
+`.claude-plugin/plugin.json` 的說明文字寫「58 支機械閘（52 條註冊）」，
 `README.md` 也寫「42 支 ＋ `hooks.json`」「共 52 條註冊」——但實測是 **43 支檔案、53 條註冊**。
 差 1 支、差 1 條，猜測是今天（2026-08-20）新增的 `leo21c-write-guard.sh`／`release-tag-guard.sh`／
 `ticket-api-bypass-guard.sh` 這批（檔頭日期都是今天）加了之後，兩份文件的數字沒有跟著更新。
@@ -183,6 +321,7 @@ $ comm -13 /tmp/fs_hooks.txt /tmp/registered_hooks.txt
 | `arcrun-intent-guard.sh` | 2 次 | 一次守「所有寫檔案」，一次專門加強守「呼叫 Arcrun 部署/驗證工具」這個更精準的情境 |
 | `micromanage-guard.sh` / `irreversible-dispatch-guard.sh` / `no-ticket-no-dispatch.sh` | 各 2 次 | 各自同時掛在 `Task` 與 `Agent` 兩個矩比對名稱上——這兩個名稱應該是同一種派工動作的新舊叫法，兩個都掛保證不漏接 |
 | `worklist-guard.sh` / `self-drive-police.sh` / `self-drive-judge.sh` / `delivery-police.sh` / `wiki-first-police.sh` / `unpushed-police.sh` | 各 2 次 | 一次守「總管自己想收工」（Stop），一次守「subagent 交回工作」（SubagentStop）——同一套判準用在兩種角色身上 |
+| `search-is-not-proof-guard.sh` | 3 次 | 拿搜尋結果當證據的那個動作，可能是「貼進票裡」（Bash），也可能是「寫進派工單發包出去」（`Task`／`Agent` 兩個名稱各掛一次），三種都要接住 |
 
 ❓ **這裡有一件我看不出來是刻意還是遺留、需要人判斷**：`micromanage-guard.sh`／`irreversible-dispatch-guard.sh`／`no-ticket-no-dispatch.sh`
 三支都**同時**掛在 `Task` 跟 `Agent` 這兩個矩比對名稱上。如果這兩個名稱在目前版本的 Claude Code 裡指的是「同一種派工工具呼叫」，
@@ -219,12 +358,16 @@ $ comm -13 /tmp/fs_hooks.txt /tmp/registered_hooks.txt
 - **`micromanage-guard.sh`／`irreversible-dispatch-guard.sh`／`no-ticket-no-dispatch.sh` 的雙重矩比對（`Task` + `Agent`）是刻意保險還是舊名稱沒清掉**——見上面「重複掛載」段落，我沒有把握單靠讀檔案判斷，需要看實際觸發紀錄或問總管。
 - **`stage-before-prod-guard.sh` 跟 `main-and-prod-push-guard.sh` 的分工邊界**：`main-and-prod-push-guard.sh` 的檔頭明講自己是在「補 `stage-before-prod-guard.sh` 的破口」（那支只認 3 個關鍵字，抓不到 `wrangler deploy`），但兩支都還掛著、都還在管「prod 出貨」這件事。這是「新的補洞、舊的continua」還是「舊的該退休了」，這份盤點表不下判斷，留給你在下一步的分類會議裡定奪。
 
-除了以上兩點，其餘 41 支的行為都能從檔頭與源碼直接讀出，沒有「猜」的部分。
+除了以上兩點，其餘各支的行為都能從檔頭與源碼直接讀出，沒有「猜」的部分。
+
+> 📌 這句話原本寫「其餘 **41** 支」——那是 43 支閘那一版（`v0.2.1`）數的，之後沒有人重跑過。
+> 2026-08-27 把數字拿掉而不是改成 46：**改成 46 等於宣稱我逐支重讀過源碼，而我沒有。**
+> 要恢復一個數字，就重跑一次上面「抽驗」那件事，然後把當天的日期寫上去。
 
 ---
 
 ## 這份表怎麼跟實況對帳（半年後怎麼發現漂移）
 
-1. **有沒有新閘沒被收進這張表**：跑本文「落差偵測」段落的兩行 `comm` 指令，比對 `hooks/*.sh` 的檔名清單跟這張表列出的閘名清單（不是跟 `hooks.json`，那個只驗證有沒有註冊，驗不了有沒有寫進這張人話表）。
+1. **有沒有新閘沒被收進這張表**：跑本文「落差偵測」段落**第二組**（`inv_fs` vs `inv_table` 的兩行 `comm`）**加第三格 C**，比對 `hooks/*.sh` 的檔名清單跟這張表列出的閘名清單。**不是第一組**——第一組比的是 `hooks.json`，只驗證有沒有註冊，驗不了有沒有寫進這張人話表。2026-08-27 漏掉的那兩列，第一組是綠的、第二組才紅。**抓表格列的那組 `grep` 一定要帶 `^\| \`` 錨點**，理由與拿掉之後會冒出的 3 個假警報，就寫在那一段裡。
 2. **有沒有閘的行為跟這裡寫的不一樣了**：抽幾支重新讀一次源碼，跟這裡的「一句話」對一遍——就是本文「抽驗 5 支」做的事，可以照同樣方法定期重做。
 3. **`.claude-plugin/plugin.json` 與 `README.md` 的數字**：這兩處各自寫了一次「幾支、幾條註冊」，前面已經抓到一次對不上（42/52 vs 實際 43/53）。這兩個數字沒有機制保證跟著 `hooks/` 目錄自動更新，是本表發現的第一個具體漂移案例。

hooks/baton-handback-guard.sh

@@ -0,0 +1,136 @@
+#!/usr/bin/env bash
+# 管什麼: 一條派工線收工時，檢查它的工單票有沒有把棒子交回來——指派（誰該動）＋ tag（卡在哪）＋ 下一步（做什麼）三格。
+# 為什麼: 2026-08-26 那次交回寫在 comment 裡，票沒指派、tag 沒動 ⇒ 沒有任何欄位在說「這張票在等你」，棒子躺了 14 小時。撈一次看得到的只有欄位，不是留言。
+# 誤觸時怎麼關: 這條線不對應任何票 → 派工單本來就不該少了【工單】那行（no-ticket-no-dispatch.sh 管那個）；真要放行在指令裡留 `baton-ok: <理由>`（本閘只提醒不阻擋，不會擋住任何動作）。
+#
+# baton-handback-guard.sh — 收工＝把棒子交回去（PostToolUse: Agent|Task）
+#
+# ── leo 2026-08-27 的原話（本閘的規格）────────────────────────────────
+#   「它把事情做完後如果要檢查後續，就要把任務指定給你並改 tag，
+#     你收到指定用 tag 查就知道要去做，所以**每個任務結束必須要指派回總管**，
+#     要說明下一步怎麼做，**直到最後交出正確 deliverable 並且驗證**」
+#
+# ── 三格各自回答一個問題（leo：「這些全部都要」）─────────────────────
+#   指派 assignee   現在誰該動？        缺了它 → 大家都以為是別人的事
+#   tag  s/*        它卡在哪一段？      缺了它 → 撈得到票，但要重讀整串
+#   下一步（留言）  收下的人要做什麼？  缺了它 → 撿起棒子的人得自己重建脈絡
+#
+# ── 為什麼掛在 PostToolUse(Agent) 而不是 SubagentStop ──────────────
+#   工單票號寫在**派工單**裡（`【工單】owner/repo#N`），而派工單就是 Agent 的 tool_input。
+#   SubagentStop 拿到的 transcript 是主對話，票號要繞一圈才找得回來
+#   （見 subagent-claim-worksheet.sh 檔頭那段實撞紀錄）。
+#   同一個位置 issue-status-autoflip.sh 已經在用，形狀是驗過的。
+#
+# ── 只提醒，不阻擋 ────────────────────────────────────────────────
+#   工作已經做完了，擋在這裡沒有任何東西可以被挽救；能做的是**讓總管在當下就看到缺哪一格**。
+#   同 unpushed-police.sh 的定位：exit 2 讓訊息進到模型眼前，不是 blocker。
+set -uo pipefail
+
+INPUT=$(cat)
+
+SPEC=$(printf '%s' "$INPUT" | python3 -c '
+import sys, json, re
+try:
+    d = json.load(sys.stdin)
+except Exception:
+    raise SystemExit
+p = (d.get("tool_input") or {}).get("prompt") or ""
+for line in p.splitlines():
+    if "【工單】" not in line:
+        continue
+    m = re.search(r"([A-Za-z0-9_.-]+)/([A-Za-z0-9_.-]+)#(\d+)", line)
+    if m:
+        print(f"{m.group(1)} {m.group(2)} {m.group(3)}")
+        break
+' 2>/dev/null || true)
+
+[ -n "${SPEC:-}" ] || exit 0
+# shellcheck disable=SC2086
+set -- $SPEC
+OWNER="$1"; REPO="$2"; NUM="$3"
+
+# ── 測試縫（唯一目的：讓判斷邏輯測得起來，不必每跑一次測試就在票池留一張票）──
+#   BATON_GUARD_FIXTURE=<目錄> ⇒ 讀 issue.json / comments.json，不打網路。
+#   正式執行時這個變數不存在，一行都不會走到。
+if [ -n "${BATON_GUARD_FIXTURE:-}" ]; then
+  J=$(cat "$BATON_GUARD_FIXTURE/issue.json")
+  C=$(cat "$BATON_GUARD_FIXTURE/comments.json")
+else
+# token：掃已知的 checkout 找第一個帶憑證、指向本站的 remote（同 scripts/ticket 的做法）
+ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+URL=""
+for d in "$ROOT" "$ROOT/products/$REPO" "$ROOT/matrix/$REPO" "$ROOT/polaris/$REPO"; do
+  [ -e "$d/.git" ] || continue
+  U=$(git -C "$d" remote -v 2>/dev/null | grep -m1 'git\.uncle6\.me' | grep '@' | awk '{print $2}') || true
+  [ -n "${U:-}" ] && { URL="$U"; break; }
+done
+[ -n "$URL" ] || exit 0
+TOKEN=$(printf '%s' "$URL" | sed -E 's|.*//[^:]+:([^@]+)@.*|\1|')
+[ "$TOKEN" != "$URL" ] || exit 0
+
+J=$(curl -s --max-time 12 -H "Authorization: token $TOKEN" \
+      "https://git.uncle6.me/api/v1/repos/$OWNER/$REPO/issues/$NUM" 2>/dev/null) || exit 0
+C=$(curl -s --max-time 12 -H "Authorization: token $TOKEN" \
+      "https://git.uncle6.me/api/v1/repos/$OWNER/$REPO/issues/$NUM/comments?limit=100" 2>/dev/null) || C='[]'
+fi
+
+REPORT=$(python3 - "$J" "$C" <<'PY' 2>/dev/null
+import json, sys
+try:
+    it = json.loads(sys.argv[1]); cs = json.loads(sys.argv[2])
+except Exception:
+    raise SystemExit
+if it.get("state") == "closed":
+    raise SystemExit                      # 已經關了 ＝ 棒子到終點了，沒有下一手
+miss = []
+if not (it.get("assignees") or []):
+    miss.append("指派：沒有人被指到這張票 ⇒ 撈 assignee 撈不到它，等於棒子躺在地上")
+labs = [l["name"] for l in (it.get("labels") or [])]
+st = [n for n in labs if n.startswith("s/")]
+if not st:
+    miss.append("tag：沒有任何 s/* ⇒ 看不出它卡在哪一段")
+elif st == ["s/doing"]:
+    miss.append("tag：還停在 s/doing，但這條線已經收工了 ⇒ 它到底做完沒有？"
+                "（等總管複驗＝s/review／已上 stage＝s/stage／等別的東西＝s/pending）")
+if not any("🏃" in (c.get("body") or "") for c in cs):
+    miss.append("下一步：票上沒有交棒留言 ⇒ 收下棒子的人得自己重讀整串才知道要做什麼")
+if not miss:
+    raise SystemExit
+print("\n".join("  ❌ " + m for m in miss))
+print("__ASSIGNEES__" + ",".join(a["login"] for a in (it.get("assignees") or [])))
+print("__LABELS__" + ",".join(labs))
+PY
+) || exit 0
+
+[ -n "${REPORT:-}" ] || exit 0
+
+BODY=$(printf '%s' "$REPORT" | grep -v '^__')
+NOW_A=$(printf '%s' "$REPORT" | sed -n 's/^__ASSIGNEES__//p')
+NOW_L=$(printf '%s' "$REPORT" | sed -n 's/^__LABELS__//p')
+
+cat >&2 <<EOF
+🏃 交棒警察：$OWNER/$REPO#$NUM 這條線收工了，但**棒子沒有交回來**。
+
+現在票上：指派＝[${NOW_A:-（空）}]　標籤＝[${NOW_L:-（空）}]
+
+$BODY
+
+【leo 2026-08-27】「**每個任務結束必須要指派回總管**，要說明下一步怎麼做，
+  直到最後交出正確 deliverable 並且驗證」
+
+🔴 **關鍵在「指派」是欄位，不是文字。** 撈一次就看得到，不必讀 comment——
+   leo 自己就是用 Gitea 原生的「指派給您的」在看。
+
+【一個動作把三格補齊】
+  scripts/ticket handback $OWNER/$REPO#$NUM \\
+      --to claude-code \\
+      --next "<收下的人第一件事要做什麼，一句話>" \\
+      --label <s/review｜s/stage｜s/pending｜s/todo> \\
+      --evidence "<實測輸出或 PR 連結>"
+
+  要 leo 親手做的 → --to Leo（會自動加 Human 標籤）
+  已經真的做完且驗過了 → scripts/ticket close $OWNER/$REPO#$NUM --deliverable <URL>
+
+【撈一次看棒子在誰手上】 scripts/ticket mine
+EOF
+exit 2

hooks/claim-verify-police.sh

@@ -1,82 +0,0 @@
-#!/usr/bin/env bash
-# claim-verify-police.sh — 待驗工作單還在，就不准收工（Stop；leo 2026-08-18 立）
-#
-# 這支是 subagent-claim-worksheet.sh 的另一半。
-# 那支在 SubagentStop 時把 subagent 的宣稱寫成一張檔案；這支在我要停下時檢查：
-#
-#     **那張檔還在不在？**
-#
-# ── 為什麼判準是「檔案存不存在」 ────────────────────────────────────
-# leo 2026-08-17：「你在**文字層**封路⋯⋯自然語言的變體是無限的，blacklist 永遠追不完。
-#                   封路哲學之所以有效，是因為它封的是**動作**——動作有限且可枚舉。」
-# ⇒ 「我驗過了」這句話可以有無限種寫法，但**檔案只能被動作刪掉**。
-#   所以這支不讀我的措辭，只看磁碟。
-#
-# ── 怎麼過這道閘（都是動作，都留痕）─────────────────────────────────
-#   ① 真的驗了 → 把證據寫進回覆／票，然後刪掉那個檔
-#   ② 有幾條不需要驗 → 在檔裡寫下理由，再刪掉（理由留在 git 或票上）
-#   ③ 是人閘 → 走三件機械動作（Human ＋ 指派 ＋ 它自己的票），再刪掉
-#
-# 🔴 **不准為了過閘而直接 rm 掉卻什麼都沒做。** 那等於自己拆掉自己的閘——
-#    而這正是 leo 2026-08-10 說的「規則早就存在，但沒有任何機制驗證有沒有照做」。
-#
-# ── 迴圈安全 ────────────────────────────────────────────────────
-# stop_hook_active 為真 ⇒ 已經擋過一次，放行。至多提醒一次，不卡死。
-#
-# ── 留痕 ────────────────────────────────────────────────────────
-INPUT=$(cat)
-DIR="$CLAUDE_PROJECT_DIR/.claude/pending-verification"
-LOG="$CLAUDE_PROJECT_DIR/.claude/hooks/claim-verify-police.log"
-
-ACTIVE=$(printf '%s' "$INPUT" | python3 -c '
-import json,sys
-try: print("1" if json.load(sys.stdin).get("stop_hook_active") else "0")
-except Exception: print("0")
-' 2>/dev/null)
-
-if [ "$ACTIVE" = "1" ]; then
-  printf '%s\tSKIP:already-nudged\n' "$(date +%FT%T)" >> "$LOG" 2>/dev/null
-  exit 0
-fi
-
-# 只算「今天以內」的單子——放太久的（跨 session 殘留）不該無限期卡住新工作，
-# 但仍會被列出來提醒。
-FILES=$(ls -1 "$DIR"/claims-*.md 2>/dev/null)
-if [ -z "$FILES" ]; then
-  printf '%s\tSKIP:no-pending\n' "$(date +%FT%T)" >> "$LOG" 2>/dev/null
-  exit 0
-fi
-
-N=$(printf '%s\n' "$FILES" | grep -c . )
-printf '%s\tBLOCK:%s-pending\n' "$(date +%FT%T)" "$N" >> "$LOG" 2>/dev/null
-
-{
-  echo "🔍 查證警察：有 $N 張**待驗工作單**還沒處理掉，不准收工。"
-  echo
-  echo "【leo 2026-08-18 的規格】"
-  echo "  「subagent 做完事⋯⋯**它說可以，你去驗證；它說不行，你想辦法，不行再報告**，"
-  echo "   這解決一半的未查證。你常常直接把 subagent 說的不經查證就回報，"
-  echo "   **它視野小，它說的你有更多資訊去檢驗。**」"
-  echo
-  echo "━━ 還沒處理的單子 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-  printf '%s\n' "$FILES" | while read -r f; do
-    [ -n "$f" ] || continue
-    OKN=$(grep -c '^- \[ \]' "$f" 2>/dev/null)
-    echo "  · ${f#"$CLAUDE_PROJECT_DIR"/}　（$OKN 條待處理）"
-  done
-  echo
-  echo "━━ 怎麼過這道閘（三選一，都是動作）━━━━━━━━━━━━━━━━━━"
-  echo "  ① **它說可以** → 你自己跑一次（測試／curl／瀏覽器／git），把證據貼出來，再刪掉那個檔"
-  echo "  ② **它說不行** → 先換路徑、查憑證地圖；要說「被擋」就得**自己撞一次並貼拒絕原文**"
-  echo "  ③ **真的是人閘** → 三件機械動作：\`Human\` 標籤 ＋ 指派給 Leo ＋ **一張它自己的票**"
-  echo "     （leo 08-18：「要進入人閘，標示 human 叫我去開，**不是默默塞進錯的地方**」）"
-  echo
-  echo "🔴 **不准只是 rm 掉了事。** 那是自己拆掉自己的閘——"
-  echo "   正是 leo 08-10 講的「規則早就存在，但沒有任何機制驗證有沒有照做」。"
-  echo
-  echo "📌 為什麼有這道閘：2026-08-18 總管連續三次把**沒驗過的判斷**當成情報交出去，"
-  echo "   其中第二次還是為了「更正」第一次而發明的新猜測。"
-  echo "   leo：「你給我不正確的資訊⋯⋯subagent 說不通你沒有驗。」"
-} >&2
-
-exit 2

hooks/comment-carries-task-guard.sh

@@ -0,0 +1,132 @@
+#!/usr/bin/env bash
+# 管什麼: 往 Gitea 票裡貼「留言裡藏著一件還沒做完的事」（等 X／驗不了／還沒…）卻沒有把它長成子票時，擋一次。
+# 為什麼: 2026-08-26 arcrun-rag#136 comment 4267 就是這樣掉的——「等雲端那半出貨才驗得了」只活在討論串，收端後來真的上線了，卻沒有任何東西讓人回頭把它撿起來，躺了 14 小時。
+# 誤觸時怎麼關: 這則留言真的不含待辦 → 指令裡加 `no-subtask: <一句理由>` 放行（留痕）；同一 session 只擋一次。
+#
+# comment-carries-task-guard.sh — 討論串裡的任務要長成看得見的子票（PreToolUse: Bash）
+#
+# ── leo 2026-08-27 的原話（本閘的規格）────────────────────────────────
+#   「可以在討論串延伸子票，它完成了子票就完工，不然這筆任務就是沒完工，
+#     如果你沒辦法察覺，那不要把任務加在討論串，而是每個任務長出子票做為這張票的相依，
+#     **票沒完工可以察覺嗎？**」
+#
+# ── 為什麼子票比「讓等待會響」更根本 ─────────────────────────────────
+#   任務寫在討論串 → 要有人回頭讀 comment 才知道它存在 → 沒人回頭讀 → 掉
+#   任務長成子票   → open/closed 是**狀態**            → 撈一次就看得到 → 掉不了
+#   ⇒ 不是「讓它會響」，是**讓它本來就在視線裡**。
+#
+#   而且相依是硬的：實測（2026-08-27，Gitea 1.26.4）子票還開著時關母票 →
+#   HTTP 412 `cannot close this issue or pull request because it still has open dependencies`。
+#
+# ── 粒度：傾向多開票，不是少開票（leo 2026-08-27 當場更正總管）────────
+#   「**小任務做完就關閉，不會讓池子爆掉，每個事情沒有歷史記錄才是大問題**」
+#   ⇒ 判準是「這件事需要被記得嗎」，不是「會不會太多」。
+#     池子爆掉的前提是「開了不關」，那由「做完就關」解決，不該由「不開票」解決。
+#
+# ── 誠實邊界 ──────────────────────────────────────────────────────
+#   PreToolUse 只看得到指令文字，這是這一層的天花板（同 InkStoneCo#36）。
+#   所以關鍵詞刻意取**窄**的一組「未完成的未來式」，寧可漏抓也不要天天誤擋——
+#   `.claude/branch-holds.md` 檔頭那句：**永遠在響的警報，等於訓練人忽略這個警報。**
+#   漏抓的那些，由 baton-handback-guard.sh（收工那一刻）補第二層。
+#
+#   已知極限（誠實標記）：這支**認不出「我已經開好子票了」**——它只看得到指令文字。
+#   所以交件報告裡引用自己剛開的子票時仍會被擋一次；那一次用 `no-subtask:` 過，
+#   或就當它是一次確認。刻意不去打 API 查「這張票有沒有相依」：那會讓每一個
+#   命中關鍵詞的 Bash 呼叫都多一次網路往返，代價落在錯的地方。
+set -uo pipefail
+
+INPUT=$(cat)
+CMD=$(printf '%s' "$INPUT" | python3 -c "
+import sys,json
+try: print(json.load(sys.stdin).get('tool_input',{}).get('command',''))
+except Exception: print('')
+" 2>/dev/null)
+SID=$(printf '%s' "$INPUT" | python3 -c "
+import sys,json
+try: print(json.load(sys.stdin).get('session_id','') or 'nosid')
+except Exception: print('nosid')
+" 2>/dev/null || echo nosid)
+[ -n "$CMD" ] || exit 0
+
+# 逃生口（留痕，會留在指令歷史上）
+case "$CMD" in *no-subtask:*) exit 0 ;; esac
+
+# 這些動詞本來就是在處理「棒子」，不該被自己擋
+case "$CMD" in
+  *"ticket subtask"*|*"ticket handback"*|*"ticket mine"*|*"ticket close"*|*"ticket where"*) exit 0 ;;
+esac
+
+# ① 這是不是在對「既有票」貼留言？（開新票走 ticket new／ticket-api-bypass-guard）
+IS_COMMENT=no
+case "$CMD" in *"ticket say"*) IS_COMMENT=yes ;; esac
+if printf '%s' "$CMD" | grep -qE 'issues/[0-9]+/comments' && printf '%s' "$CMD" | grep -qw 'POST'; then
+  IS_COMMENT=yes
+fi
+[ "$IS_COMMENT" = "yes" ] || exit 0
+
+# ② 把「要貼的內文」拿到手：-F <檔> 就讀那個檔，否則就看指令文字本身
+BODY="$CMD"
+FARG=$(printf '%s' "$CMD" | sed -nE 's/.*[[:space:]](-F|--file)[[:space:]]+([^[:space:]]+).*/\2/p' | head -1)
+if [ -n "${FARG:-}" ] && [ -f "$FARG" ]; then
+  BODY=$(cat "$FARG" 2>/dev/null || printf '%s' "$CMD")
+fi
+
+# 已經帶著交棒標記的留言 ＝ 走的是 handback 那條路，不重複擋。
+# 🔴 只認**第一行**，不認「內文任何地方出現過」——這是 dogfood 當場抓到的漏（2026-08-27）：
+#    交件報告裡**引用了一段 `ticket mine` 的輸出**（那段有 🏃），
+#    整則報告就被豁免掉了，而它裡面真的有「等雲端那半出貨」這種待辦。
+#    ⇒ 這正是 `inkstone/InkStoneCo#23` 那個病的同款：**複述關鍵字被當成本人**。
+#    `ticket handback` 寫的交棒留言，🏃 一定在第一行；引用別人的輸出則不會。
+case "$(printf '%s' "$BODY" | head -1)" in "🏃"*) exit 0 ;; esac
+
+# ③ 「未完成的未來式」——刻意取窄。這一組全部來自 08-26 那則真的掉了的留言的形狀。
+#
+# 🔴 比對用 python3 不用 grep——這是**實測逼出來的**，不是偏好（2026-08-27 本閘第一版）：
+#    第一版寫 `等[^。]{0,20}(出貨|…)`，跑真的 hook 呼叫路徑時對
+#    「這件事等雲端那半出貨才驗得了」**不匹配**，閘靜默失效（測試 19/20，那一條紅）。
+#    同一條 pattern 在別的 shell 手打卻會過 ⇒ **它的行為依賴 locale／grep 實作**，
+#    而 hook 的執行環境不由我們決定（本機 `LC_CTYPE=C`，雲端又是另一套）。
+#    unpushed-police.sh 檔頭記過同一族的坑：C locale 下處理全形標點會咬掉位元組。
+#    ⇒ 規約：**hook 裡凡是要比對中文，一律交給 python3 的 re**（它一定是字元語意），
+#      不要賭 grep 在那台機器上是字元模式還是位元組模式。
+HIT=$(BODY="$BODY" python3 -c '
+import os, re, sys
+PAT = ("等.{0,20}?(出貨|上線|部署|發佈|合併|修好|回覆|做完|接上)"
+       "|驗不了|測不了|還沒(驗|測|做|上線|部署|接|補)|之前(驗不|無法|不能)"
+       "|要等|尚未完成|待辦|\\[blocker\\]|TODO|FIXME")
+ms = [m.group(0) for m in re.finditer(PAT, os.environ.get("BODY", ""))]
+print(" ".join(ms[:3]))
+' 2>/dev/null)
+[ -n "${HIT:-}" ] || exit 0
+
+WARNED="/tmp/.comment-task-guard-warned-$SID"
+[ -f "$WARNED" ] && exit 0     # 同一 session 只擋一次，不鬼打牆
+date +%s > "$WARNED"
+
+cat >&2 <<EOF
+🎫 這則留言裡藏著一件**還沒做完的事**，而它現在只是文字。
+
+命中的詞：$HIT
+
+【leo 2026-08-27】「**每個任務長出子票做為這張票的相依⋯⋯票沒完工可以察覺嗎？**」
+
+【它掉過一次，時序如下】
+  08-26 13:00  arcrun-rag#136 comment 4267：「等雲端那半出貨才驗得了」  ← 只是一段文字
+  08-26 18-23  總管真的出貨了                                          ← 條件滿足，沒人知道
+  08-27 11:xx  leo 問「這 14 小時前的，你派了還是沒派？」               ← 才被撿起來
+
+【怎麼做】把它長成子票，Gitea 原生相依會**硬擋**母票關閉（實測 412）：
+
+  scripts/ticket subtask <母票 owner/repo#N> \\
+      --title "身為<誰>，我要<什麼>，我才<為什麼>" \\
+      -F <內文檔> --label s/todo --assign <誰做>
+
+  ⇒ 子票沒關，母票關不掉。**不是提醒，是平台保證。**
+
+【粒度】leo 2026-08-27：「**小任務做完就關閉，不會讓池子爆掉，
+  每個事情沒有歷史記錄才是大問題**」⇒ 判準是「這件事需要被記得嗎」，
+  傾向**多開票**。不要用「會不會太多」當理由不開。
+
+【真的不是待辦】在指令裡加 \`no-subtask: <一句理由>\` 重送（留痕）。
+EOF
+exit 2

hooks/countdown-guard.sh

@@ -0,0 +1,207 @@
+#!/usr/bin/env bash
+# countdown-guard.sh — 每一則回覆都自己說出「已經花了多久／還剩多久」
+#                      （inkstone/ISEP#63，leo 2026-08-27＋08-28 兩次下令）
+#
+# ── 為什麼是一支閘，不是一句叮嚀 ──────────────────────────────────────
+# leo 2026-08-27：「前面說過每個回覆要戴上已經花了總時長，**這為什麼沒出現？**」
+#                 「這應該寫在 ISEP，隨時看自己拖了多久」
+# 總管當時答「我沒做，現在開始戴」——**而那正是這條規則第一次失效的方式**：
+# 靠記性的規則，下一個 session 就沒有了（history-first／KBDB-first／stage-first
+# 全是同一個形狀）。⇒ 判準：**一個新開的 session，什麼都沒被交代，回覆裡照樣有時長。**
+#
+# ── 兩段，缺一不可（票上點名的失效模式就在這裡）───────────────────────
+# 票上寫得很清楚：「**注入了但模型沒照做**是這類機制的主要失效模式」。
+# 所以這支同時掛兩個事件，是**同一件事的兩半**：
+#
+#   ① UserPromptSubmit ── 注入：把算好的那一行送到眼前（模型不必自己算、也算不準）
+#   ② Stop            ── 查核：這一回合的回覆裡到底有沒有那一行；沒有就擋一次
+#
+# ── 注入點的第二行：🎯 現在的主線是哪一個（inkstone/ISEP#82）────────────
+# 同一個注入點，兩行，來源不同：⏱ 算時間，🎯 讀 `hooks/lib/mainline.py` 裡被標定的主線。
+# 🔴 **Stop 那一半只查 ⏱，沒有跟著擴大成兩個標記**，兩個理由：
+#   ① ⏱ 那一行本身**已經帶著主線的名字**（`countdown.py` 的第三段），
+#     所以主線是跟著一道**已經驗過的閘**到 leo 眼前的，不是靠新增一道會擋人的閘。
+#   ② 一個回合最多該被擋一次。多要求一個標記 ＝ 多一種被擋的方式，
+#     而本 repo 心法第 2 條寫死了：永遠在響的警報等於訓練人忽略警報。
+# 主線這條線真正會擋人的地方在派工那一端（`hooks/mainline-focus-guard.sh`），
+# 那裡擋的是「派了一張不在主線上的票」——**一個動作**，不是一段文字。
+#
+# 只有 ① ＝ 又一個會被忽略的提醒（本 repo 心法第 2 條明令不要做這種東西）。
+# 只有 ② ＝ 罰它做一件它拿不到資料的事。兩段合起來才是一條走得通的路。
+#
+# ── 🔴 這不是關鍵字黑名單（leo 2026-08-17 的診斷）────────────────────
+# 「自然語言的變體是無限的，blacklist 永遠追不完……封路哲學之所以有效，
+#   是因為它封的是**動作**——動作有限且可枚舉，文字不是。」
+# 當日實測：文字層的閘 **8 次誤攔、0 次正確攔截**，且方向穩定。
+#
+# 本支查的**不是「有沒有講某些不該講的話」，而是「那個被要求的輸出元素在不在」**：
+#   一個由機器產生、只有一個字元的標記（`⏱`），值是機器算的，模型抄過去。
+#   ⇒ 沒有「換個講法就閃過」的空間（換講法照樣要帶標記），
+#     也沒有「講到某個詞就被咬」的誤攔（多寫什麼都不會觸發）。
+#   ⇒ 這是 whitelist-of-one：**要求一個東西在場**，不是**猜哪些東西不該在場**。
+#
+# ── 誤攔的出口都先關掉（誤攔比漏擋更該修）────────────────────────────
+#   · 子 session（subagent）不查——它的回覆不是給 leo 看的
+#   · 這一回合沒有任何文字輸出（純工具回合）不查——沒有東西可以戴
+#   · `stop_hook_active` 為真＝已經提醒過一次 ⇒ 放行，**至多擋一次，不會卡死**
+#   · 讀不到 transcript／內部出錯 ⇒ 放行（這支是節拍器，不是安全閘，
+#     它壞掉不該讓整個 session 停下來）
+set -uo pipefail
+
+INPUT="$(cat)"
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB="$HERE/lib/countdown.py"
+[ -f "$LIB" ] || exit 0
+
+EVENT=$(printf '%s' "$INPUT" | python3 -c '
+import sys, json
+try: print(json.load(sys.stdin).get("hook_event_name", "") or "")
+except Exception: print("")
+' 2>/dev/null || printf '')
+
+# ══ ① 注入模式（UserPromptSubmit）═════════════════════════════════════
+if [ "$EVENT" = "UserPromptSubmit" ]; then
+  printf '%s' "$INPUT" | ISEP_COUNTDOWN_LIB="$LIB" python3 -c '
+import json, os, sys, importlib.util
+
+spec = importlib.util.spec_from_file_location("countdown", os.environ["ISEP_COUNTDOWN_LIB"])
+cd = importlib.util.module_from_spec(spec); spec.loader.exec_module(cd)
+
+try: d = json.load(sys.stdin)
+except Exception: d = {}
+try:
+    stamp = cd.line(d.get("session_id") or "", d.get("transcript_path") or "")
+except Exception:
+    raise SystemExit(0)          # 算不出來就不出聲，不要讓它變成噪音
+
+# 第二行：現在的主線是哪一個（inkstone/ISEP#82）。
+# 同一個注入點的兩行，來源不同：⏱ 算時間，🎯 讀被標定的主線。
+# 算不出來也一定回一句話（「現在沒有主線」），所以這裡不需要 fallback；
+# 真的整支壞掉（import 失敗）才留白——一行注入不該讓整個 session 停下來。
+try:
+    ml = cd._mainline().line()
+except Exception:
+    ml = ""
+
+ctx = (
+    stamp + "\n"
+    + (ml + "\n" if ml else "")
+    + "\n"
+    "🔴 第一行是 ISEP 的倒數（inkstone/ISEP#63）。**把它原樣放在你這則回覆的最前面**，"
+    "數字不要自己重算、也不要改寫措辭——它是機器算的，你算的會漂。\n"
+    "leo 整天上課、一天只看兩眼：沒有這行，他就不知道『這件事還來得及嗎』。\n"
+    "收工前這一回合若沒有戴上它，Stop 那一半會擋一次要你補。\n\n"
+    "🎯 第二行是**現在的主線**（inkstone/ISEP#82）——leo：「14 個里程碑同時亮著"
+    "卻不知道該看哪個」。它是你這回合的判準：**手上這件事在不在那條線上**。\n"
+    "不在，就當場說清楚是『補收』（它本來就該在主線上）還是『跳線』（真的插件事），"
+    "不要默默做完。主線的名字已經在第一行的倒數裡，戴上倒數＝主線也一起到了 leo 眼前。"
+)
+print(json.dumps({
+    "hookSpecificOutput": {
+        "hookEventName": "UserPromptSubmit",
+        "additionalContext": ctx,
+    }
+}, ensure_ascii=False))
+' 2>/dev/null || true
+  exit 0
+fi
+
+# ══ ② 查核模式（Stop）═════════════════════════════════════════════════
+# 子 session 不查：subagent 的回覆是交給總管的，不是給 leo 看的那一則。
+[ "${CLAUDE_CODE_CHILD_SESSION:-}" = "1" ] && exit 0
+
+LOG="${CLAUDE_PROJECT_DIR:-$PWD}/.claude/hooks/countdown-guard.log"
+
+VERDICT=$(printf '%s' "$INPUT" | ISEP_COUNTDOWN_LIB="$LIB" python3 -c '
+import json, os, sys, importlib.util
+
+spec = importlib.util.spec_from_file_location("countdown", os.environ["ISEP_COUNTDOWN_LIB"])
+cd = importlib.util.module_from_spec(spec); spec.loader.exec_module(cd)
+
+try: d = json.load(sys.stdin)
+except Exception:
+    print("SKIP:bad-json"); raise SystemExit
+
+if d.get("stop_hook_active"):
+    print("SKIP:already-nudged"); raise SystemExit   # 至多擋一次
+
+tp = d.get("transcript_path") or ""
+if not tp or not os.path.exists(tp):
+    print("SKIP:no-transcript"); raise SystemExit
+
+rows = []
+try:
+    with open(tp) as f:
+        for ln in f:
+            ln = ln.strip()
+            if ln:
+                try: rows.append(json.loads(ln))
+                except Exception: pass
+except Exception:
+    print("SKIP:unreadable"); raise SystemExit
+
+# 這一回合＝最後一則「真的來自使用者」的訊息之後（工具結果不算使用者說話）
+start = 0
+for i, r in enumerate(rows):
+    if r.get("type") == "user":
+        c = (r.get("message") or {}).get("content")
+        blocks = c if isinstance(c, list) else [{"type": "text"}]
+        if not any(isinstance(b, dict) and b.get("type") == "tool_result" for b in blocks):
+            start = i
+turn = rows[start:]
+
+texts = []
+for r in turn:
+    if r.get("type") != "assistant":
+        continue
+    c = (r.get("message") or {}).get("content")
+    if isinstance(c, str):
+        texts.append(c); continue
+    if not isinstance(c, list):
+        continue
+    for b in c:
+        if isinstance(b, dict) and b.get("type") == "text":
+            texts.append(b.get("text") or "")
+
+body = "\n".join(t for t in texts if t and t.strip())
+if not body:
+    print("SKIP:no-text"); raise SystemExit    # 純工具回合，沒有東西可以戴
+
+if cd.MARKER in body:
+    print("OK"); raise SystemExit
+
+try:
+    stamp = cd.line(d.get("session_id") or "", tp)
+except Exception:
+    print("SKIP:no-stamp"); raise SystemExit
+print("MISSING:" + stamp)
+' 2>/dev/null || echo "SKIP:crash")
+
+STAMP_LINE="${VERDICT#MISSING:}"
+NOW=$(date "+%Y-%m-%d %H:%M:%S" 2>/dev/null || echo "?")
+mkdir -p "$(dirname "$LOG")" 2>/dev/null || true
+
+case "$VERDICT" in
+  MISSING:*)
+    printf '| %s | ⛔ 擋下 | 回覆沒有倒數 |\n' "$NOW" >> "$LOG" 2>/dev/null || true
+    {
+      printf '⏱ 倒數警察：**這則回覆沒有戴上倒數**（inkstone/ISEP#63）\n\n'
+      printf 'leo 2026-08-27：「前面說過每個回覆要戴上已經花了總時長，**這為什麼沒出現？**」\n'
+      printf '        08-28：「先完成倒數計時器，**每一次回覆都發倒數**」\n\n'
+      printf '把這一行原樣放在回覆最前面，再送一次（數字已經幫你算好，不要自己重算）：\n\n'
+      printf '    %s\n\n' "$STAMP_LINE"
+      printf '為什麼非戴不可：leo 整天上課、一天只看兩眼。沒有這行，他看不出\n'
+      printf '「這件事花了不該花的時間」——而那正是他要這個東西的全部理由。\n\n'
+      printf '本閘**至多擋一次**（stop_hook_active 之後放行），不會卡死。\n'
+    } >&2
+    exit 2
+    ;;
+  OK)
+    printf '| %s | ✅ 放行 | 有倒數 |\n' "$NOW" >> "$LOG" 2>/dev/null || true
+    exit 0
+    ;;
+  *)
+    printf '| %s | ⚪ 略過 | %s |\n' "$NOW" "$VERDICT" >> "$LOG" 2>/dev/null || true
+    exit 0
+    ;;
+esac

hooks/diagnosis-evidence-guard.sh

@@ -0,0 +1,190 @@
+#!/usr/bin/env bash
+# 管什麼: 要把一段有份量的東西寫上票，而這個 session **沒派人查過那張票**、
+#        那段話裡也**沒有任何走得過去的出處** → 擋一次。
+# 為什麼: 未經調查的診斷寫在票上就長得像事實，工人會照著它去驗證而不是去查——
+#        等於用權威把那個 repo 真正的專家的判斷力關掉。
+# 誤觸時怎麼關: 把出處補上（檔案:行號／commit／comment 號／票號／網址／貼實測輸出），
+#        或指令裡加 `evidence-ok`（留痕）。同一 session 同一張票只擋一次。
+#
+# diagnosis-evidence-guard.sh — 未經調查不寫診斷（PreToolUse: Bash；inkstone/ISEP#87）
+#
+# ━━ 來由（leo，inkstone/ISEP#87）━━━━━━━━━━━━━━━━━━━━━━━━━━━
+#   「身為派人去查的人，我要自己在拿到調查結果前寫不出診斷，
+#     我才不會用猜的結論把工人的判斷力關掉。」
+#   「**票裡寫未經調查的診斷**」是 2026-08-27 當天列出的錯之一。
+#
+#   ⇒ 順序倒過來：**先派人查 → 拿到查的結果 → 才可以寫診斷。**
+#     我的診斷只能建立在別人查回來的東西上面，不能建立在我的印象上面。
+#
+# ━━ 這支跟既有那兩支的分界（三支不重疊）━━━━━━━━━━━━━━━━━━━━━
+#   `subagent-first-guard.sh`  鐵律 2 的**前半**：要改 code 卻一次工都沒派過
+#   `micromanage-guard.sh`     替對方決定**做法**（給指令照跑、指名檔案函式…）
+#   **本支**                    替對方決定**答案**（把還沒查證的結論寫進票）
+#   前兩支都不會在「寫東西上票」這個動作上開口，所以不會兩支同時開罵。
+#
+# ━━ 🔴 判準：三個結構訊號，一個關鍵字都沒有 ━━━━━━━━━━━━━━━━━━━
+#   票上寫死：「『根因』『因為』『應該是』這類詞**一律不准當判準**」
+#   （leo 2026-08-17 已證偽文字層封路：當日 8 次誤攔、0 次正確攔截，
+#     而且**紅線寫得越細，命中關鍵字的機率越高 ⇒ 那些閘在懲罰謹慎**）。
+#
+#   三個訊號，全部是結構：
+#     ① **這個 session 有沒有派人查過那張票**
+#        —— `investigate-first-stamp.sh` 的戳記（在不在，不是寫什麼）
+#     ② **這段話裡有沒有走得過去的出處**
+#        —— 檔案:行號／commit／comment 號／票號／網址／檔案路徑／貼出來的實測輸出。
+#           方向是**放行**（認出來就放行），與黑名單相反：
+#           比對錯了只會**少擋一次**，不會多罰一次（同 pr-verdict-guard ③）。
+#     ③ **這段話有沒有份量**（扣掉身份欄與空白後的字數，門檻 60 字，
+#        `ISEP_DIAGNOSIS_FLOOR` 可調）
+#        —— 一句「收到，我來看」（6 字）不可能是診斷。長度是結構，不是措辭。
+#        門檻怎麼定的：拿一段真的診斷（「根因是 KV 額度爆掉⋯⋯」）實量 **73 字**，
+#        拿最短的合理回覆實量 **6 字**——60 落在兩者之間，靠短的那邊。
+#        **不是猜的，是量過的**（第一版寫 120，那段真的診斷就漏抓了）。
+#
+#   三個訊號的組合：①有 ⇒ 放行（查過了）。①無 ＋ ②有 ⇒ 放行（轉述有出處，
+#   票上驗收條件 4 指明不能誤擋）。①無 ＋ ②無 ＋ ③夠長 ⇒ 擋一次。
+#
+# ━━ 誠實邊界（做不到的事就寫出來）━━━━━━━━━━━━━━━━━━━━━━━━
+#   · PreToolUse 只看得到指令文字與 `-F` 指到的檔（同 comment-carries-task-guard）。
+#   · 本閘**認不出「這段話是不是診斷」**——沒有任何機器認得出來，
+#     而想認出來的那條路（句型比對）已經被證偽。它認的是
+#     「**一段有份量、卻沒有任何出處、也沒人去查過**」的東西。
+#     漏抓的情況：診斷寫得很短、或診斷裡剛好夾著一個無關的網址。
+#     這是刻意的取捨——**誤攔比漏擋嚴重**，一支天天誤擋的閘會被學會忽略。
+#
+# 逃生口：指令裡加 `evidence-ok`（會留在指令歷史上）。同 session 同票只擋一次。
+#
+# 測試：hooks/tests/diagnosis-evidence-guard.test.sh（離線、不打網路、不留測試票）
+set -uo pipefail
+
+INPUT=$(cat)
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
+
+VERDICT=$(printf '%s' "$INPUT" | DEG_LIB="$HERE/lib" python3 -c '
+import json, os, re, sys
+sys.path.insert(0, os.environ.get("DEG_LIB", ""))
+try:
+    import evidence
+except Exception:
+    print("SKIP:no-lib"); raise SystemExit
+
+try:
+    d = json.load(sys.stdin)
+except Exception:
+    print("SKIP:bad-payload"); raise SystemExit
+
+cmd = (d.get("tool_input") or {}).get("command") or ""
+if not cmd:
+    print("SKIP:no-cmd"); raise SystemExit
+if "evidence-ok" in cmd:                       # 逃生口（留痕）
+    print("SKIP:escape"); raise SystemExit
+
+sid = re.sub(r"[^A-Za-z0-9_.-]", "_", str(d.get("session_id") or "nosid"))[:64]
+
+# ── ① 這是不是「把東西寫上票」的動作 ────────────────────────────────
+#   兩條路都要認（`ticket-api-bypass-guard.sh` 檔頭記過那一課：
+#   「認動作的方式漏了一條路」是這一族的通病）。
+target = None          # (owner, repo, num) 或 ("", repo_or_?, "new")
+m = re.search(r"scripts/ticket\s+(\w+)", cmd) or re.search(r"\bticket\s+(say|new|decide|subtask)\b", cmd)
+verb = m.group(1) if m else ""
+if verb in ("say", "decide", "subtask"):
+    r = re.search(r"([A-Za-z0-9_.-]+)/([A-Za-z0-9_.-]+)#(\d+)", cmd)
+    target = (r.group(1), r.group(2), r.group(3)) if r else ("", "", "?")
+elif verb == "new":
+    r = re.search(r"ticket\s+new\s+([\w.-]+)", cmd)
+    target = ("inkstone", r.group(1) if r else "?", "new")
+else:
+    is_post = re.search(r"\bPOST\b", cmd) or re.search(r"requests\.post|urlopen|\.post\(", cmd)
+    c = re.search(r"/repos/([\w.-]+)/([\w.-]+)/issues/(\d+)/comments", cmd)
+    n = re.search(r"/repos/([\w.-]+)/([\w.-]+)/issues\b", cmd)
+    if is_post and c:
+        target = (c.group(1), c.group(2), c.group(3))
+    elif is_post and n:
+        target = (n.group(1), n.group(2), "new")
+
+if not target:
+    print("SKIP:not-a-ticket-write"); raise SystemExit
+
+owner, repo, num = target
+
+# ── ② 這個 session 派過人去查那張票了嗎（戳記在不在）──────────────────
+stamp_dir = os.environ.get("ISEP_STAMP_DIR", "/tmp")
+if num not in ("new", "?"):
+    if os.path.exists(os.path.join(stamp_dir, ".investigated-%s-%s_%s_%s"
+                                   % (sid, owner, repo, num))):
+        print("SKIP:investigated"); raise SystemExit
+
+body, src = evidence.body_of(cmd)
+
+# ── ③ 有出處嗎（放行方向的比對）──────────────────────────────────
+hits = evidence.sources(body)
+if hits:
+    print("SKIP:has-source:%s" % hits[0][0]); raise SystemExit
+
+# ── ④ 有份量嗎（長度是結構，不是措辭）────────────────────────────
+n_chars = evidence.substance(body)
+try:
+    floor = int(os.environ.get("ISEP_DIAGNOSIS_FLOOR", "60"))
+except Exception:
+    floor = 60
+if n_chars < floor:
+    print("SKIP:too-short:%d" % n_chars); raise SystemExit
+
+print("FIRE::" + json.dumps({"owner": owner, "repo": repo, "num": num,
+                             "chars": n_chars, "src": src, "sid": sid},
+                            ensure_ascii=False))
+' 2>/dev/null) || VERDICT="SKIP:hook-error"
+[ -n "${VERDICT:-}" ] || VERDICT="SKIP:empty"
+
+case "$VERDICT" in
+  FIRE::*) ;;
+  *) exit 0 ;;
+esac
+
+REF=$(printf '%s' "${VERDICT#FIRE::}" | python3 -c '
+import json, sys
+d = json.load(sys.stdin)
+print("%s/%s#%s" % (d["owner"], d["repo"], d["num"]) if d["num"] not in ("new", "?")
+      else ("新的一張票（%s）" % d["repo"]))
+' 2>/dev/null)
+SID=$(printf '%s' "${VERDICT#FIRE::}" | python3 -c 'import json,sys; print(json.load(sys.stdin)["sid"])' 2>/dev/null)
+KEY=$(printf '%s' "$REF" | tr -c 'A-Za-z0-9' '_')
+WARNED="${ISEP_STAMP_DIR:-/tmp}/.diagnosis-guard-warned-$SID$KEY"
+[ -f "$WARNED" ] && exit 0     # 同一 session 同一張票只擋一次，不鬼打牆
+date +%s > "$WARNED" 2>/dev/null || true
+
+DEG_REF="$REF" DEG_SID="$SID" python3 - <<'PY' >&2
+import os
+print("""🔎 這段要寫上 %s 的東西，**沒有人查過，也沒有任何出處**。
+
+【inkstone/ISEP#87】「身為派人去查的人，我要自己在**拿到調查結果前寫不出診斷**，
+  我才不會用猜的結論把工人的判斷力關掉。」
+
+  · 診斷寫完了，**工人就不知道自己要做什麼**——它會照著你的結論去驗證，而不是去查
+  · **你不是那個 repo 的專家，它才是**。你的結論通常是猜的，
+    但因為寫在票上，看起來就像事實
+
+━━ 為什麼是現在擋你（三個結構訊號，一個關鍵字都沒有）━━━━━━━━━━━━
+  ① 這個 session **沒有派人去查這張票**（`investigate-first-stamp` 沒有戳記）
+  ② 這段話裡**找不到任何走得過去的出處**
+  ③ 而它**有份量**（不是一句「收到」）
+
+━━ 兩條出路，選一條 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  A. **先派人去查**（順序倒過來，這是本票要的）
+       派工單就一行：【工單】%s
+       它查完貼回票上，你再寫診斷——那時①就成立了。
+
+  B. **這段本來就是轉述別人查到的，那就把出處帶上**（帶了就不會被擋）
+       檔案:行號　　hooks/lib/evidence.py:42
+       commit　　　 8e28041
+       comment 號　 inkstone/ISEP#87 → comment 4327
+       網址／票號　 https://git.uncle6.me/...
+       實測輸出　　 用 ``` 圍欄把指令與輸出原樣貼上
+
+  🔴 出處不是格式要求，是**讀的人可以自己走過去確認**。
+     「我記得是這樣」與「它就在那一行」的差別，只有這個分得出來。
+
+真的有例外 → 指令裡加 `evidence-ok` 重送（會留在指令歷史上）。
+同一張票本 session 只擋這一次。""" % (os.environ.get("DEG_REF", ""), os.environ.get("DEG_REF", "")))
+PY
+exit 2

hooks/dispatch-format-guard.sh

@@ -0,0 +1,257 @@
+#!/usr/bin/env bash
+# 管什麼: 派工單裡除了【工單】票號以外還有別的內容就擋；合規的派工則自動注入共通規定。
+# 為什麼: 任務寫在 prompt 裡 => 票上看不到、agent 一停就蒸發；散文沒有欄位 => 警察抓不到。
+# 誤觸時怎麼關: 把內容歸位（每次都一樣的→共通規定；這次才知道的→寫進票），或 touch /tmp/.dispatch-ok-<session_id> 放行一次。
+#
+# dispatch-format-guard.sh — PreToolUse（Task｜Agent）：**派工單 ＝ 票號。就這樣。**
+#
+# ━━ 來由（leo 2026-08-27，inkstone/ISEP#30 comment 4322 / 4325 / 4327）━━━━
+#
+#   他貼回總管派給 Arcrun#142 那條線的 prompt，問：
+#     「**這些話票上都沒有，你根本沒照規則做事，你的 hook 讓你這樣搞？**」
+#     「執行的不是你，你去派工，它才知道問題，**你寫診斷意義是什麼？不就是假的？**」
+#
+#   實查：`no-ticket-no-dispatch.sh` 驗的是「派工單裡有沒有一行【工單】owner/repo#N」。
+#   ⇒ 所以可以**把 40 行任務全寫在 prompt 裡、票號補一行**，閘照樣放行。
+#   ⇒ 2026-08-27 一天之內這樣做了 5 次（arcrun-rag#104／Arcrun#142／Arcrun#127／
+#     Arcrun#144／InkStoneCo#55），每一次票上都沒有那份任務。
+#   ⇒ **規則存在，閘只驗了它的殼。**（同款第 N 次：history-first／KBDB-first／
+#     stage-first／AskUserQuestion 裸奔，全是這個形狀。）
+#
+#   4325 追加：「你用一個 **output parser** 把你給 subagent 的指令規範，**分作幾點，
+#   每一點規定格式**，**照這種散文寫法根本無法迭代**」「**警察也不能抓**」。
+#   4327 收斂到最後一步：「**交件方式不需要寫，定義在原則裡**⋯⋯每次都一樣提取出來
+#   變成共通規定」＋（對「這是 session 才知道的事」的回應）「**這些為什麼不寫到票裡？**」
+#
+#   ⇒ 派工單裡想寫的東西只有兩種，兩種都不該留在派工單：
+#       每次都一樣  → 共通規定（本閘自動注入，見下）
+#       這次才知道  → **寫進那張票**
+#     判準：**「這句話換一張票還成立嗎？」**
+#
+# ━━ 為什麼是結構閘，不是關鍵字閘（leo 2026-08-17 的檢驗）━━━━━━━━━━━━
+#   「你在**文字層**封路⋯⋯『回「做」我就啓動』沒有問號，下次它會寫『準備就緒』⋯⋯
+#     **自然語言的變體是無限的，blacklist 永遠追不完。**
+#     封路哲學之所以有效，是因為它封的是**動作**——動作有限且可枚舉，文字不是。」
+#   當日實證：文字層的閘 8 次誤攔、0 次正確攔截，且方向穩定——
+#   **紅線寫得越細，命中關鍵字的機率越高 ⇒ 那些閘在懲罰謹慎。**
+#
+#   本閘怎麼過這個檢驗：
+#     · 判準是**「這一行是不是【工單】欄位」**——在不在，不是寫什麼。
+#       整條路徑（hooks/lib/dispatch_parse.py）**零個「命中某個詞就違規」的比對**。
+#     · ⇒ 措辭再謹慎也不會被多罰；改寫成別的講法也閃不過去。文字層閘的兩個病都沒有。
+#     · 也**不需要語意判官**：這條規則本來就是結構性的，用不著 LLM，
+#       於是它免費、瞬間、每次結果一樣（比 ask-user-question-guard 更硬的一種閘）。
+#
+# ━━ 這支同時做兩件事 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+#   ① **擋**：【工單】以外有實質內容 → exit 2，並指出那些內容該搬去哪一格
+#   ② **注入**：合規的派工 → exit 0 並用 hookSpecificOutput 把共通規定送給收工方
+#      （慣例同 subagent-wiki-guard.sh）。
+#      ⇒ 這是「派工單只剩票號」能成立的前提：交件方式、不准 push main、org 是 inkstone…
+#        **不必有人記得寫**，機器每次都補。
+#        leo 的驗收條件之一就是「收工方**沒讀派工單**也知道要貼回原票」。
+#
+# ━━ 邊界（刻意不管的事）━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+#   · 派工單裡**沒有**【工單】 → 本閘閉嘴，那是 no-ticket-no-dispatch.sh 的地盤。
+#     兩支閘同時開口，收工方會拿到兩份互相打架的教學。
+#   · 票存不存在、關了沒 → 也是那一支在驗，本閘不重複打 Gitea（本閘不連網）。
+#
+# 逃生口（留痕、用完即丟，慣例同 micromanage-guard.sh／ask-user-question-guard.sh）：
+#     touch /tmp/.dispatch-ok-<session_id>
+#   閘是絆一下逼你重想，不是把人關起來。
+#
+# ━━ 攔截點不只一個（inkstone/ISEP#88，2026-08-27 補）━━━━━━━━━━━━━━
+#   第一版只掛 `PreToolUse(Task|Agent)` ⇒ 只涵蓋「**新開**一個 subagent」。
+#   **回覆一個正在跑的 subagent 走的是別的工具，根本不經過那個攔截點。**
+#   實況：第一次派工乾乾淨淨只有票號，中途回覆時又把一長串修改要求丟過去，
+#   **那些話票上一個字都沒有**——那條線被停掉就消失，正是本閘要解的病。
+#
+#   ⇒ 不另造一支平行的閘（票上寫死）：同一支閘、同一個判斷函式，
+#     只是把所有通往 subagent 的路一次列全。那張表在
+#     `hooks/lib/dispatch_parse.py` 的 `tool_channel()`——新增一條路加在那裡。
+#
+#   兩條路只有一個地方不同：
+#     · `dispatch`（Task／Agent）沒有【工單】 ⇒ 放行，那是 no-ticket-no-dispatch 的地盤
+#     · `reply`（SendMessage／雲端 session／`claude -p`…）沒有【工單】 ⇒ **擋**，
+#       因為那支閘沒掛在這些路上，不擋就是整條裸奔
+#   刻意不管的方向：subagent 往上回報（`SendMessage to: "main"`）＝交件不是派工。
+#
+#   擋下來的時候會**把那段內容原文印出來**，方便直接貼上票——
+#   因為這條規則的出路就是「把它寫進票」，而不印出來就得請人回頭自己找。
+#
+# 測試：hooks/tests/dispatch-format-guard.test.sh（離線、不打網路、不花錢）
+set -u
+
+INPUT="$(cat)"
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
+
+FACTS="$(printf '%s' "$INPUT" | python3 "$HERE/lib/dispatch_parse.py" dispatch 2>/dev/null)"
+[ -n "$FACTS" ] || exit 0   # parser 掛了 → fail-open（回到「沒有這支閘」的狀態）
+
+# 🔴 四個欄位一次讀完，不要每個欄位各開一支 python。
+#    這不是效率問題，是**正確性**問題：每一次 `python3 -c` 都是一個新行程，
+#    而每一次都用 `2>/dev/null` 吞掉錯誤 ⇒ 機器忙的時候只要有一次生不出行程，
+#    那個欄位就靜靜變成空字串，閘的行為跟著變——**而且不會有任何痕跡**。
+#    實測（2026-08-28，本 repo 的測試連跑 10 次）：`SESSION` 偶爾拿不到，
+#    於是「明示豁免戳記」那條路 **10 次裡失敗 1 次**，症狀是「豁免了卻還是被擋」。
+#    一次讀完 ⇒ 要嘛四個都拿到、要嘛全空（全空＝fail-open，回到沒有這支閘的狀態）。
+FIELDS="$(printf '%s' "$FACTS" | python3 -c '
+import sys, json
+try:
+    d = json.load(sys.stdin)
+except Exception:
+    d = {}
+print(d.get("status", "skip"))
+print(d.get("session_id", "") or "")
+print(len(d.get("violations", []) or []))
+print(d.get("channel", "dispatch") or "dispatch")
+' 2>/dev/null)"
+
+STATUS=""; SESSION=""; NVIOL=""; CHANNEL=""
+{
+  IFS= read -r STATUS || true
+  IFS= read -r SESSION || true
+  IFS= read -r NVIOL || true
+  IFS= read -r CHANNEL || true
+} <<EOF
+$FIELDS
+EOF
+
+[ "$STATUS" = "ok" ] || exit 0
+[ -n "$NVIOL" ] || NVIOL=0
+[ -n "$CHANNEL" ] || CHANNEL=dispatch
+
+# 子 session（subagent）送出的**回覆**不管——它往上送的是交件不是派工
+# （見上面「刻意不管的方向」）。**只放掉 reply 這條路**：
+# subagent 自己再往下派工（Task）時，派工單的規矩照樣管它。
+if [ "$CHANNEL" = "reply" ] && [ "${CLAUDE_CODE_CHILD_SESSION:-}" = "1" ]; then
+  exit 0
+fi
+
+# ── 明示豁免（留痕用，用掉就消失，不是永久開關）────────────────────────
+if [ "$NVIOL" != "0" ] && [ -n "$SESSION" ] && [ -f "/tmp/.dispatch-ok-$SESSION" ]; then
+  rm -f "/tmp/.dispatch-ok-$SESSION"
+  NVIOL=0
+fi
+
+if [ "$NVIOL" != "0" ]; then
+  # 訊息用 quoted heredoc（裡面有反引號，不能讓 shell 當命令替換執行掉），
+  # 佔位符交給 python 換——sed 對正體中文與特殊字元的跳脫太脆。
+  # （2026-08-26 ask-user-question-guard 真的犯過：訊息裡的反引號被當命令跑，
+  #   閘照擋，但**它教人怎麼解的那兩行變成空白**，等於沒有出路。）
+  MSG="$(cat <<'EOF'
+🚫 __HEADLINE__（leo 2026-08-27，inkstone/ISEP#30 comment 4327）
+
+__VIOLATIONS__
+__CARRY__
+
+━━ 這些內容該去哪：問一句「**這句話換一張票還成立嗎？**」━━━━━━━━━━
+
+  還成立   ⇒ **共通規定**（交件方式、不准 push main、org 是 inkstone、先讀 CLAUDE.md…）
+             改 `docs/governance/dispatch-and-reply-format.md` 的 §2，
+             **本閘每次派工都會自動注入給收工方**，你不必寫、也不會漏。
+
+  只有這次 ⇒ **寫進那張票**（main 是哪顆、今天撞過什麼、另一條線在動什麼）
+             `scripts/ticket say <owner/repo#N> -F <檔>`
+             然後派工單寫 `【工單】<owner/repo#N> → comment <剛拿到的號碼>`
+
+  🔴 **「票上還沒有」不是把它寫進 prompt 的理由——它就是「去把它寫上票」的指令。**
+     leo 2026-08-27：「**這些為什麼不寫到票裡？**」
+     寫進 prompt 的後果：agent 被停掉或換人接手，那段事實隨 prompt 一起蒸發。
+     當天實害：總管停掉重派 3 次，前兩次的任務與 session 事實**全部消失**。
+
+━━ 合格的派工單長這樣（整份，沒有省略）━━━━━━━━━━━━━━━━━━━━━
+
+    【工單】inkstone/ISEP#30 → comment 4322
+
+━━ 為什麼連「一句叮嚀」都不行 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  leo 2026-08-27：「**交件方式不需要寫，定義在原則裡，每張票都要做這件事⋯⋯
+                    每次都一樣提取出來變成共通規定**」
+  你多寫的每一句，都是在造第二份會漂的真相；而收工方讀到的是**你的轉述**，
+  不是票上的原始證據。
+
+真的有例外 → `touch /tmp/.dispatch-ok-__SESSION__` 後重送（用掉就消失，會留在指令歷史上）。
+EOF
+)"
+  VIOL_TEXT="$(printf '%s' "$FACTS" | python3 -c '
+import sys, json
+try:
+    d = json.load(sys.stdin)
+except Exception:
+    d = {}
+lines = []
+for v in d.get("violations", []):
+    lines.append("  ❌ %s：%s" % (v.get("code", ""), v.get("detail", "")))
+for name in d.get("retired_seen", []):
+    lines.append("  ↳ 【%s】這個欄位已經收回了" % name)
+print("\n".join(lines))
+' 2>/dev/null)"
+
+  # 擋下來的時候把那段內容原文印出來——出路是「貼上票」，
+  # 不印出來就得請人回頭自己找（inkstone/ISEP#88 驗收條件 1）。
+  CARRY_TEXT="$(printf '%s' "$FACTS" | python3 -c '
+import sys, json
+try:
+    t = (json.load(sys.stdin).get("extra_text") or "").strip()
+except Exception:
+    t = ""
+if t:
+    print("━━ 這段內容原文在這裡，直接貼上票 ━━━━━━━━━━━━━━━━━━━━━━━━\n")
+    print(t)
+    print()
+' 2>/dev/null)"
+
+  if [ "$CHANNEL" = "reply" ]; then
+    HEADLINE="回覆也是派工：內容寫進票，訊息只給票號"
+  else
+    HEADLINE="派工單 ＝ 票號。就這樣。"
+  fi
+
+  DFG_MSG="$MSG" DFG_VIOL="$VIOL_TEXT" DFG_SESSION="$SESSION" \
+  DFG_HEAD="$HEADLINE" DFG_CARRY="$CARRY_TEXT" python3 -c '
+import os, sys
+sys.stderr.write(
+    os.environ["DFG_MSG"]
+      .replace("__HEADLINE__", os.environ.get("DFG_HEAD", ""))
+      .replace("__VIOLATIONS__", os.environ.get("DFG_VIOL", ""))
+      .replace("__CARRY__", os.environ.get("DFG_CARRY", ""))
+      .replace("__SESSION__", os.environ.get("DFG_SESSION", "") or "<session_id>")
+    + "\n"
+)
+'
+  exit 2
+fi
+
+# 回覆這條路不注入共通規定——收工方早在第一次派工時就拿過了，
+# 每一則回覆再灌一次只是噪音（而噪音會讓人學會忽略整段注入）。
+[ "$CHANNEL" = "reply" ] && exit 0
+
+# ── 合規 → 注入共通規定 ──────────────────────────────────────────────
+#   這是「派工單只剩票號」的另一半：那些每次都一樣的規定不必有人記得寫，機器每次都補。
+#   來源是 docs/governance/dispatch-and-reply-format.md 的 INJECT 區段——
+#   **只有一份**，改那裡等於改所有派工（不會有第二份漂走的副本）。
+DOC="${CLAUDE_PLUGIN_ROOT:-$(cd "$HERE/.." && pwd)}/docs/governance/dispatch-and-reply-format.md"
+[ -f "$DOC" ] || exit 0
+
+DFG_DOC="$DOC" python3 -c '
+import json, os, re, sys
+try:
+    text = open(os.environ["DFG_DOC"], encoding="utf-8", errors="ignore").read()
+except Exception:
+    sys.exit(0)
+m = re.search(r"<!-- INJECT:BEGIN.*?-->\n(.*?)<!-- INJECT:END -->", text, re.S)
+if not m:
+    sys.exit(0)
+body = m.group(1).strip()
+print(json.dumps({
+    "hookSpecificOutput": {
+        "hookEventName": "PreToolUse",
+        "additionalContext":
+            "【自動注入：派工共通規定】\n"
+            "（來源 docs/governance/dispatch-and-reply-format.md §2——"
+            "派工單只給票號是刻意的，這些每次都一樣的東西由機器補，不靠人記得寫）\n\n"
+            + body,
+    }
+}, ensure_ascii=False))
+' 2>/dev/null
+
+exit 0

hooks/hooks.json

@@ -41,9 +41,33 @@
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/hooks/ticket-api-bypass-guard.sh"
           },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/comment-carries-task-guard.sh"
+          },
           {
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/hooks/milestone-due-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/milestone-account-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/reply-identity-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/search-is-not-proof-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/diagnosis-evidence-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/dispatch-format-guard.sh"
           }
         ]
       },
@@ -132,6 +156,22 @@
           {
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/hooks/no-ticket-no-dispatch.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/dispatch-format-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/roster-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/mainline-focus-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/search-is-not-proof-guard.sh"
           }
         ]
       },
@@ -167,6 +207,31 @@
           {
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/hooks/no-ticket-no-dispatch.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/dispatch-format-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/roster-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/mainline-focus-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/search-is-not-proof-guard.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "SendMessage|.*Claude_Code_Remote__(send_message|create_session|create_trigger|update_trigger|fire_trigger|send_later).*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/dispatch-format-guard.sh"
           }
         ]
       },
@@ -195,6 +260,14 @@
           {
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/hooks/isep-presence-beacon.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/countdown-milestone-refresh.sh"
+          },
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/mainline refresh"
           }
         ]
       }
@@ -217,6 +290,14 @@
           {
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/hooks/factory-idle-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/mainline-idle-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/pr-verdict-guard.sh"
           }
         ]
       },
@@ -260,20 +341,12 @@
         "hooks": [
           {
             "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/claim-verify-police.sh"
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/countdown-guard.sh"
           }
         ]
       }
     ],
     "SubagentStop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/subagent-claim-worksheet.sh"
-          }
-        ]
-      },
       {
         "hooks": [
           {
@@ -321,6 +394,15 @@
           }
         ]
       },
+      {
+        "matcher": ".*kbdb_(search|get_record|query|graph_neighbors|get_map).*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/kbdb-evidence-stamp.sh"
+          }
+        ]
+      },
       {
         "matcher": "Agent|Task",
         "hooks": [
@@ -328,12 +410,39 @@
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/hooks/subagent-first-stamp.sh"
           },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/investigate-first-stamp.sh"
+          },
           {
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/hooks/issue-status-autoflip.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/baton-handback-guard.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "SendMessage",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/investigate-first-stamp.sh"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/countdown-guard.sh"
           }
         ]
       }
     ]
   }
-}
+}

hooks/investigate-first-stamp.sh

@@ -0,0 +1,46 @@
+#!/bin/sh
+# investigate-first-stamp.sh — PostToolUse（Agent｜Task｜SendMessage）：
+# 記下「這個 session 真的**派人去查過那張票**了」。
+#
+# 配 diagnosis-evidence-guard.sh 使用（形狀抄自 subagent-first-stamp.sh／kbdb-asked-stamp.sh
+# ——inkstone/ISEP#87 票上就是指定照那個形狀做）。只留時戳，不擋任何東西。
+#
+# 🔴 為什麼按「session ＋ 票號」分開存，不是只按 session：
+#    subagent-first-stamp 回答的是「這一輪有沒有派過工」（一個 session 一個答案）。
+#    本支要回答的是「**這件事**有沒有派人查過」——那是**每張票各自**的問題。
+#    只按 session 存的話，早上派過一次去查 A 票，下午就等於解鎖了 B 票的診斷，
+#    這道閘會在第二次派工之後完全失效。
+set -eu
+
+INPUT=$(cat 2>/dev/null || echo '{}')
+HERE=$(cd "$(dirname "$0")" && pwd)
+
+printf '%s' "$INPUT" | STAMP_LIB="$HERE/lib" python3 -c '
+import json, os, re, sys, time
+sys.path.insert(0, os.environ.get("STAMP_LIB", ""))
+try:
+    import dispatch_parse
+except Exception:
+    raise SystemExit
+try:
+    d = json.load(sys.stdin)
+except Exception:
+    raise SystemExit
+
+sid = re.sub(r"[^A-Za-z0-9_.-]", "_", str(d.get("session_id") or "nosid"))[:64]
+channel, text = dispatch_parse.tool_channel(d)
+if not channel:
+    raise SystemExit
+for ref in dispatch_parse.parse_dispatch(text)["refs"]:
+    # ISEP_STAMP_DIR 只給測試用（不碰 /tmp 的正式戳記）——
+    # 與 diagnosis-evidence-guard.sh 讀的是同一個變數，兩支要一起改。
+    stamp_dir = os.environ.get("ISEP_STAMP_DIR", "/tmp")
+    path = os.path.join(stamp_dir, ".investigated-%s-%s_%s_%s"
+                        % (sid, ref["owner"], ref["repo"], ref["num"]))
+    try:
+        with open(path, "w") as f:
+            f.write(str(int(time.time())))
+    except Exception:
+        pass
+' 2>/dev/null || true
+exit 0

hooks/isep-presence-beacon.sh

@@ -42,12 +42,28 @@ case "$ROOT" in
   *)                 SRC="來源不明" ;;
 esac
 
+# ── 交給 lib/beacon_report.py 組訊息 ─────────────────────────────────
+#
+# 🔴 為什麼改成走 python 而不是繼續用 printf 拼 JSON（inkstone/ISEP#90）：
+#   下面要多報三件事（版本落差／舊複本遮蔽正門／退役機制的殘骸），
+#   而那三段的內容含引號與換行。**用 shell 內插拼 JSON，一個引號就會把整包 JSON 弄壞，
+#   而壞掉的 JSON 讓信標整行消失** —— 那正是本檔要偵測的「零閘狀態」的長相。
+#   ⇒ 訊息本身可以變複雜，但**序列化這件事不准手拼**。
+#
+# 🔴 fail-open：python 掛掉、網路不通、什麼都不准讓這行消失。
+#   信標消失＝leo 會判定這個 session 沒有閘（本檔第 8 行寫的判準），
+#   所以組不出加料版就退回原本那一行乾淨的訊息。
 MSG="🟢 ISEP v${VER} 已載入（${GATES} 支閘｜來源：${SRC}｜${ROOT}）"
-
-printf '%s\n' "{
+FALLBACK="{
   \"systemMessage\": \"${MSG}\",
   \"hookSpecificOutput\": {
     \"hookEventName\": \"SessionStart\",
     \"additionalContext\": \"${MSG}。這行是 ISEP plugin 自己發的——看得到它就表示閘真的生效了。若某個 session 從頭到尾沒有這行，那個 session 是零閘狀態，先修 plugin 再做事，不要用『跑得動』當證據。\"
   }
 }"
+
+OUT="$(python3 "$ROOT/hooks/lib/beacon_report.py" "$VER" "$GATES" "$SRC" 2>/dev/null || true)"
+case "$OUT" in
+  \{*) printf '%s\n' "$OUT" ;;
+  *)   printf '%s\n' "$FALLBACK" ;;
+esac

hooks/kbdb-evidence-stamp.sh

@@ -0,0 +1,143 @@
+#!/usr/bin/env bash
+# 管什麼: 記下「這個 session 看到的每一筆 KBDB 資料，是從哪一條路拿到的」——搜尋出來的，還是走產品檢索路徑拿到的。
+# 為什麼: 2026-08-27 inkstone/Arcrun#167 comment 4865，總管把 kbdb_search 的輸出當成「產品檢索壞了」的證據，退回一張已經做完的票、重派一條線。錯的不是那句話，是那條路。
+# 誤觸時怎麼關: 這支不擋任何東西，只留檔。要停用就從 hooks.json 拿掉它（配套的 search-is-not-proof-guard 會跟著失效，見該檔）。
+#
+# kbdb-evidence-stamp.sh — 證據的出處登記處（PostToolUse: 各 kbdb_* 工具）
+#
+# ── 為什麼是「出處」而不是「措辭」───────────────────────────────────
+#   leo 2026-08-17 證偽過文字層：那天在文字層封路的閘 **8 次誤攔、0 次正確攔截**，
+#   且方向穩定——紅線寫得越細，命中關鍵字的機率越高 ⇒ **那些閘在懲罰謹慎**。
+#   leo 原話：「自然語言的變體是無限的，blacklist 永遠追不完。
+#             封路哲學之所以有效，是因為它封的是**動作**——動作有限且可枚舉。」
+#
+#   ⇒ 所以本閘不看你怎麼說，看你**引用的那筆資料是從哪支工具掉出來的**。
+#     資料值跟動作一樣是有限且可枚舉的：一個 entry id、一個 `kb://` 來源位址，
+#     它要嘛出現在 kbdb_search 的回應裡，要嘛沒有。**這是事實，不是判讀。**
+#
+# ── 兩條路的分別（D81，leo 2026-08-13 親自裁定）────────────────────
+#   `system-dev/docs/2-architecture/decisions/D81-vector-only-for-entity-normalize.md`
+#     Graph（三元組／entities）  → **找到該找的東西**   ← 產品檢索路徑
+#     LLM Wiki（卡片文本）        → **拉到對的內容**     ← 產品檢索路徑
+#     向量／關鍵字搜尋            → **協助 entities normalize**，**輔助，不是檢索主路徑**
+#
+#   🔴 **`kbdb_search` 本身完全合法**，這支不會讓它變難用——
+#     subagent-wiki-guard.sh 還明文要求「查任何東西之前先用它查 wiki」。
+#     leo 的話是「不能拿它當**產品檢索路徑**」，不是「不准呼叫」。
+#     ⇒ 本檔只登記出處，判斷留給 search-is-not-proof-guard.sh，而那支的觸發條件
+#       窄到「你把搜尋結果的原始值貼進票或派工單裡當證據」才會響。
+#
+# ── 平台依據（查證過，不是推測）─────────────────────────────────────
+#   PostToolUse 的 stdin payload 帶得到工具的**輸出**：
+#     `@anthropic-ai/claude-code/sdk.d.ts:54-59`
+#       export type PostToolUseHookInput = BaseHookInput & {
+#           hook_event_name: 'PostToolUse'; tool_name: string;
+#           tool_input: unknown; tool_response: unknown; };
+#   實跑的那顆（Caskroom 2.1.220）內建說明同樣寫著
+#     `"tool_response": { "success": true }  // PostToolUse only`。
+#
+# ── fail-closed：這支失效的時候要出聲，不准靜默 ──────────────────────
+#   `kbdb-asked-stamp.sh` 檔頭記著 leo 2026-08-08 的原話：
+#     「你自己寫了 hook，結果**一次次改都沒產生用途**，問題太大」。
+#   ⇒ 所以 payload 裡**根本沒有 `tool_response` 這個欄位**時（＝平台換了介面），
+#     本檔走 exit 2 把話講到 stderr 上（PostToolUse 的 exit 2 不會擋工具，
+#     只會把訊息交給 Claude 看）。**寧可吵一次，也不要變成一支活著卻沒作用的閘。**
+#     「回應讀得到但裡面沒有指紋」是正常情況（搜尋 0 筆），不出聲。
+set -uo pipefail
+
+INPUT=$(cat)
+
+OUT=$(printf '%s' "$INPUT" | python3 -c '
+import json, os, re, sys
+
+try:
+    d = json.load(sys.stdin)
+except Exception:
+    print("SKIP"); raise SystemExit
+
+tool = d.get("tool_name") or ""
+sid  = d.get("session_id") or "nosid"
+
+# 這一族才登記；別的工具直接走人
+if "kbdb_" not in tool:
+    print("SKIP"); raise SystemExit
+
+# 🔴 D81 的兩條產品檢索路徑 vs 輔助工具。判斷只看工具名，不看內容。
+WALKED = ("kbdb_get_record", "kbdb_graph_neighbors", "kbdb_query", "kbdb_get_map")
+if any(w in tool for w in WALKED):
+    kind = "walked"
+elif "kbdb_search" in tool:
+    kind = "search"
+else:
+    print("SKIP"); raise SystemExit          # 寫入類工具（create_*）不是證據來源
+
+if "tool_response" not in d:                 # ← 平台換介面了，本閘等於死了
+    print("NOFIELD"); raise SystemExit
+
+# 回應可能是 dict、list、字串、或 MCP 的 content blocks——一律壓成字串再找指紋。
+# 這樣就不必猜它今天是哪一種包裝。
+def flatten(x, acc):
+    if isinstance(x, str):
+        acc.append(x)
+    elif isinstance(x, dict):
+        for v in x.values(): flatten(v, acc)
+    elif isinstance(x, (list, tuple)):
+        for v in x: flatten(v, acc)
+    elif x is not None:
+        acc.append(str(x))
+
+parts = []
+flatten(d.get("tool_response"), parts)
+try:
+    parts.append(json.dumps(d.get("tool_response"), ensure_ascii=False))
+except Exception:
+    pass
+blob = "\n".join(parts)
+
+# ── 指紋只取兩類，兩類都是「值」不是「措辭」───────────────────────
+#   ① entry id：`e_<uuid>`。36 字元的 UUID，實質上不會誤撞。
+#   ② 來源位址：`kb://…`。它在 metadata_json 那串裡，而**跳脫前後長得一樣**
+#      （貼進 markdown 會變成 \"…\"，但 kb:// 那段本身不變）⇒ 貼過去也認得出來。
+#   兩類都是可枚舉的資料值，正好對上 leo 8-17「動作有限且可枚舉，文字不是」。
+ids  = set(re.findall(r"\be_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b", blob))
+srcs = set(re.findall(r"kb://[^\"\\\s,}\]]{6,}", blob))
+fps  = sorted(ids | srcs)
+
+path = "/tmp/.kbdb-evidence-%s-%s" % (kind, sid)
+if fps:
+    try:
+        with open(path, "a", encoding="utf-8") as f:
+            for x in fps:
+                f.write(x + "\n")
+        os.chmod(path, 0o600)
+    except Exception:
+        print("WRITEFAIL"); raise SystemExit
+print("OK %s %d" % (kind, len(fps)))
+' 2>/dev/null) || OUT="PYFAIL"
+
+case "${OUT:-}" in
+  NOFIELD)
+    cat >&2 <<'EOF'
+⚠️ kbdb-evidence-stamp 失效了：這次的 PostToolUse payload **沒有 `tool_response` 欄位**。
+
+它靠這個欄位登記「這筆資料是從哪條路拿到的」，欄位不見 ＝
+`search-is-not-proof-guard.sh` 從現在起**永遠不會響**（而且不會有人發現）。
+
+依據（本閘寫的時候查證過）：
+  @anthropic-ai/claude-code/sdk.d.ts:54-59  PostToolUseHookInput 帶 `tool_response`
+
+⇒ 平台介面變了。開一張票去修這兩支，不要當作沒看到——
+   一支活著卻沒作用的閘，比沒有閘更糟：它會讓人以為這一格有人守。
+EOF
+    exit 2 ;;
+  PYFAIL|WRITEFAIL)
+    cat >&2 <<'EOF'
+⚠️ kbdb-evidence-stamp 這次沒登記成功（python3 或 /tmp 寫入失敗）。
+
+後果：這一次的 kbdb 呼叫不會被 `search-is-not-proof-guard.sh` 看見。
+不影響你手上的工作，但**這一格暫時沒人守**——請自己確認一次
+「我等一下要下的結論，走的是不是我實際查過的那條路」。
+EOF
+    exit 2 ;;
+esac
+exit 0

hooks/lib/beacon_report.py

@@ -0,0 +1,167 @@
+# ── 以下三格是 inkstone/ISEP#90 加的「這一份是不是還有效」自檢 ──────────
+# 都**只是報告，不擋任何事**（SessionStart 本來就不該擋），而且每一格拿不到答案就閉嘴。
+import json, os, re, subprocess, sys, time, urllib.request
+
+ROOT = os.environ.get("CLAUDE_PLUGIN_ROOT", "")
+PROJ = os.environ.get("CLAUDE_PROJECT_DIR") or os.getcwd()
+VER = sys.argv[1] if len(sys.argv) > 1 else "未知"
+GATES = sys.argv[2] if len(sys.argv) > 2 else "?"
+SRC = sys.argv[3] if len(sys.argv) > 3 else "來源不明"
+
+MSG = "🟢 ISEP v%s 已載入（%s 支閘｜來源：%s｜%s）" % (VER, GATES, SRC, ROOT)
+notes = []
+
+# ══ ① 這一份跟 ISEP main 是不是同一版 ═══════════════════════════════════
+#
+# 🔴 為什麼要自己查（inkstone/ISEP#90，2026-08-27 實查）：
+#     ISEP main 的 plugin.json  →  0.9.0
+#     雲端實際載入              →  0.3.9      ← 中間差 7 個 release
+#   而信標**照樣是綠的**——它只證明「有一份 plugin 載入了」，不證明「載入的是哪一份」。
+#   後果不是抽象的：0.3.9 裡還活著兩支已經在 v0.9.0 整支刪掉的 hook，
+#   於是 `.claude/pending-verification/` 在雲端**被清掉之後又長回來**。
+#   ⇒ 一個看不見的落差，會讓「已經刪掉的機制」在別人的工作區裡復活。
+#
+# 匿名讀（不帶任何憑證）⇒ D20 判準下屬於「讀」，不需要開閘、不計次。
+# 快取 6 小時、逾時 6 秒、任何失敗一律閉嘴——信標不能因為網路而變吵或變慢。
+def main_version():
+    cache = os.path.join(os.environ.get("ISEP_BEACON_CACHE_DIR", "/tmp"), ".isep-main-version")
+    try:
+        if time.time() - os.path.getmtime(cache) < 6 * 3600:
+            v = open(cache, encoding="utf-8").read().strip()
+            return v or None
+    except Exception:
+        pass
+    url = os.environ.get("ISEP_MAIN_MANIFEST_URL",
+                         "https://git.uncle6.me/inkstone/ISEP/raw/branch/main/.claude-plugin/plugin.json")
+    try:
+        with urllib.request.urlopen(url, timeout=6) as r:
+            v = (json.loads(r.read().decode("utf-8")) or {}).get("version") or ""
+    except Exception:
+        v = ""
+    try:
+        open(cache, "w", encoding="utf-8").write(v)
+    except Exception:
+        pass
+    return v or None
+
+def vtuple(v):
+    return tuple(int(x) for x in re.findall(r"\d+", v)[:3]) or (0,)
+
+MAIN = main_version() if os.environ.get("ISEP_BEACON_SKIP_NET") != "1" else os.environ.get("ISEP_FAKE_MAIN_VERSION")
+if MAIN and VER != "未知" and MAIN != VER:
+    if vtuple(MAIN) > vtuple(VER):
+        notes.append(
+            "🔴 **這一份落後 ISEP main**（載入 %s ／ main %s）——你現在跑的不是最新那組閘，"
+            "而且**已經刪掉的機制可能還活著**（0.3.9 就是這樣讓 .claude/pending-verification/ 復活的）。"
+            "修：本機 `claude plugin update isep@inkstone`；雲端要去動一下 Environment 的 setup script "
+            "內容逼它重拍快照（快取約 7 天）。追蹤票 inkstone/ISEP#67。" % (VER, MAIN))
+    else:
+        notes.append("ℹ️ 這一份比 ISEP main 新（載入 %s ／ main %s）——沒發版的改動只在這台機器上。" % (VER, MAIN))
+
+# ══ ② 專案裡有沒有 ISEP 腳本的舊複本在遮蔽正門 ══════════════════════════
+#
+# 🔴 實例（inkstone/ISEP#90 ②）：`InkStoneCo/scripts/ticket` 是 ISEP `scripts/ticket`
+#   的**舊複本**，它的取 token 邏輯還停在「只認名叫 gitea 的 remote」，
+#   而 bootstrap.sh 在雲端把 Gitea 設成 `origin`
+#   ⇒ 在雲端跑 `scripts/ticket` 一律死在「拿不到 gitea token」
+#   ⇒ 人只好繞過正門直接打 API——而那正是 ticket-api-bypass-guard.sh 在防的事。
+#   **一道閘把人逼去走它自己禁止的那條路，那道閘就是在製造違規。**
+#
+# 判準不是「檔名一樣」，是「檔名一樣**而內容不同**」——同步過的複本不吵。
+def shadow_copies():
+    out = []
+    src = os.path.join(ROOT, "scripts")
+    if not os.path.isdir(src):
+        return out
+    roots = [PROJ, os.path.join(PROJ, "InkStoneCo")]
+    for name in sorted(os.listdir(src)):
+        a = os.path.join(src, name)
+        if not os.path.isfile(a):
+            continue
+        try:
+            ab = open(a, "rb").read()
+        except Exception:
+            continue
+        for base in roots:
+            b = os.path.join(base, "scripts", name)
+            if os.path.realpath(b) == os.path.realpath(a):
+                continue
+            if not os.path.isfile(b):
+                continue
+            try:
+                if open(b, "rb").read() != ab:
+                    out.append(os.path.relpath(b, PROJ))
+            except Exception:
+                pass
+    return out
+
+sh = shadow_copies()
+if sh:
+    notes.append(
+        "🟡 **專案裡有 ISEP 腳本的舊複本**，而它們排在 plugin 前面被叫到：%s。"
+        "兩份必然漂移，漂移的那份會安靜地騙人——`InkStoneCo/scripts/ticket` 就是這樣"
+        "在雲端一律死在「拿不到 gitea token」。要嘛刪掉複本改叫 "
+        "`\"$CLAUDE_PLUGIN_ROOT\"/scripts/<名字>`，要嘛把複本同步回 ISEP。" % "、".join(sh))
+
+# ══ ③ 工作區有沒有「已退役機制」留下的產物 ══════════════════════════════
+#
+# 判準是機械的、而且會自己長大：**plugin 自己的原始碼裡有沒有任何一個字提到這個目錄**。
+#   提到了 ⇒ 它是現行機制的產物，正常。
+#   一個字都沒提到 ⇒ 產生它的東西已經不在這一份 ISEP 裡了 ⇒ 它是殘骸。
+# 刻意**不用關鍵字黑名單**（leo 2026-08-17 已證明那條路 8 次誤攔、0 次正確攔截）：
+# 這裡問的是「plugin 現在還認不認得它」，不是「這個名字看起來像不像壞東西」。
+NATIVE = {"hooks", "commands", "skills", "agents", "plugins", "wiki", "cloud-shell",
+          "projects", "statsig", "shell-snapshots", "todos", "ide", "local", "isep"}
+def orphan_artifacts():
+    out = []
+    for base in [PROJ, os.path.join(PROJ, "InkStoneCo")]:
+        d = os.path.join(base, ".claude")
+        if not os.path.isdir(d):
+            continue
+        for name in sorted(os.listdir(d)):
+            p = os.path.join(d, name)
+            if not os.path.isdir(p) or name in NATIVE or name.startswith("."):
+                continue
+            # 🔴 只搜「會產生東西的那些檔」（hooks／scripts），不搜 docs：
+            #   docs 提到一個名字**不會讓那個目錄長出來**，但會讓這一格閉嘴。
+            # 🔴 也要把本檔排除掉：本檔的註解裡就寫著 `pending-verification` 當例子，
+            #   第一次跑就因此漏報了真正存在的那一個——**自己提到自己＝這格靜音**。
+            try:
+                hit = False
+                for sub in ("hooks", "scripts"):
+                    # 🔴 變數名不要跟外層的 `d`（.claude 那個目錄）撞——撞了會把
+                    #   外層迴圈的基準目錄換掉，第二個名字之後全部被靜靜跳過。
+                    #   第一版就是這樣寫的，實測結果：真的存在的 `verified-claims`
+                    #   一聲不吭地消失了。**假綠不是漏寫檢查，是檢查跑在錯的對象上。**
+                    sd = os.path.join(ROOT, sub)
+                    if not os.path.isdir(sd):
+                        continue
+                    if subprocess.run(["grep", "-rqlF", "--exclude", os.path.basename(__file__),
+                                       "--", name, sd],
+                                      capture_output=True, timeout=20).returncode == 0:
+                        hit = True
+                        break
+            except Exception:
+                hit = True          # 問不出來就當它有效，不亂報
+            if not hit:
+                out.append(os.path.relpath(p, PROJ))
+    return out
+
+orph = orphan_artifacts()
+if orph:
+    notes.append(
+        "🟡 **工作區有已退役機制的產物**：%s。這一份 ISEP 裡沒有任何東西提到它們"
+        "（v0.9.0 已整支刪除產生它的 hook），所以它們是殘骸——"
+        "**它們還在長，就表示這台機器跑的是舊版**（見上面那格）。確認之後刪掉。" % "、".join(orph))
+
+CONTEXT = ("%s。這行是 ISEP plugin 自己發的——看得到它就表示閘真的生效了。"
+           "若某個 session 從頭到尾沒有這行，那個 session 是零閘狀態，"
+           "先修 plugin 再做事，不要用『跑得動』當證據。" % MSG)
+if notes:
+    MSG = MSG + "\n" + "\n".join(notes)
+    CONTEXT = CONTEXT + "\n\n" + "\n".join(notes)
+
+print(json.dumps({"systemMessage": MSG,
+                  "hookSpecificOutput": {"hookEventName": "SessionStart",
+                                         "additionalContext": CONTEXT}},
+                 ensure_ascii=False))

hooks/lib/countdown.py

@@ -0,0 +1,241 @@
+#!/usr/bin/env python3
+"""hooks/lib/countdown.py —— 算「這件事已經花了多久／還剩多久」的那一行。
+
+這是 helper，不是閘（inkstone/ISEP#40 S7：lib/ 底下的東西不算一支手寫的閘）。
+兩個呼叫者共用它，所以時間的算法只有一份：
+  · UserPromptSubmit（`countdown-guard.sh` 注入模式）—— 把這一行送到模型眼前
+  · Stop（同一支的查核模式）—— 擋下來時要把同一行原樣印出來給它抄
+
+── 基準從哪一刻算起（inkstone/ISEP#63 要我自己判斷並說明理由）──────────
+leo 的原話是「**隨時看自己拖了多久**」。「拖」指向的是**任務**，不是 session，
+但「任務」在機器上沒有起點——沒有任何欄位記著「我什麼時候接手這條線」。
+可機械取得、又真的對應到一個交付的起點，只有一個：**這段對話的第一則訊息**。
+
+而那正好就是總管的交貨單位：CLAUDE.md 規則三點七「**一段對話 ＝ 一個 release**」。
+⇒ 已過時間 ＝ 這個 release 已經燒掉多久。**這個數字不需要任何人維護，也不會說謊。**
+
+resume 的 session 取「transcript 第一列的時間」而不是「hook 第一次被叫到的時間」：
+接關不是重新開始，昨天燒掉的兩小時仍然算在這個交付上。兩者都拿得到時取較早的。
+
+── 第二個數字：今天的收工線 ──────────────────────────────────────────
+leo 2026-08-28 07:40：「今天我整天上課……**下午四點左右**希望已經都完成了」。
+⇒ 台北 16:00。過了 16:00 之後**不立刻換算到明天**——那會讓超時消失，
+   而超時正是他要看的東西。過線後四小時內顯示「已超過 X」，
+   台北 20:00 之後才滾到隔天（那時已經是下一個工作日的倒數了）。
+
+── 第三個數字：主線 milestone 的期限（可選）────────────────────────────
+從快取檔讀，**這支從不打網路**：UserPromptSubmit 走在每一則訊息的關鍵路徑上，
+在那裡打網路 ＝ 每一句話都先等一次 HTTP。快取由 SessionStart 那支負責更新
+（`scripts/countdown-milestone-refresh.sh`），拿不到就整段不顯示，不編數字。
+
+🔴 **來源有兩個，優先序寫死（inkstone/ISEP#82）**：
+  ① **被標定的主線**（`hooks/lib/mainline.py`，`scripts/mainline set` 寫的）—— 優先
+  ② 期限最近的那一個（`milestone-due` 快取，`countdown-milestone-refresh.sh` 寫的）
+② 是**猜**出來的（「最近到期的大概就是在做的那個」），而 ISEP#82 的整件事就是
+「那個 active milestone」在 14 個裡沒有指涉對象。⇒ 一旦有人真的標了主線，
+就不准再用猜的那個蓋過它。兩個都沒有 ⇒ 整段不顯示。
+"""
+import json
+import os
+import sys
+from datetime import datetime, timedelta, timezone
+
+TAIPEI = timezone(timedelta(hours=8))
+MARKER = "⏱"
+
+
+def _now() -> datetime:
+    """現在。測試用 ISEP_COUNTDOWN_NOW（epoch 秒）把時鐘定住。"""
+    override = os.environ.get("ISEP_COUNTDOWN_NOW", "").strip()
+    if override:
+        try:
+            return datetime.fromtimestamp(float(override), tz=timezone.utc)
+        except Exception:
+            pass
+    return datetime.now(timezone.utc)
+
+
+def _parse_ts(raw) -> "datetime | None":
+    if not isinstance(raw, str) or not raw.strip():
+        return None
+    s = raw.strip().replace("Z", "+00:00")
+    try:
+        dt = datetime.fromisoformat(s)
+    except Exception:
+        return None
+    return dt if dt.tzinfo else dt.replace(tzinfo=timezone.utc)
+
+
+def transcript_start(path: str) -> "datetime | None":
+    """transcript 第一列帶時間戳的那一列 ＝ 這段對話真正的起點。"""
+    if not path or not os.path.exists(path):
+        return None
+    try:
+        with open(path) as f:
+            for line in f:
+                line = line.strip()
+                if not line:
+                    continue
+                try:
+                    row = json.loads(line)
+                except Exception:
+                    continue
+                dt = _parse_ts(row.get("timestamp"))
+                if dt:
+                    return dt
+    except Exception:
+        return None
+    return None
+
+
+def state_dir() -> str:
+    d = os.environ.get("ISEP_COUNTDOWN_STATE_DIR", "").strip()
+    if not d:
+        d = os.path.join(os.path.expanduser("~"), ".claude", "isep-countdown")
+    try:
+        os.makedirs(d, exist_ok=True)
+    except Exception:
+        pass
+    return d
+
+
+def session_start(session_id: str, transcript_path: str, now: datetime) -> datetime:
+    """起點 ＝ transcript 第一列與「第一次看到這個 session」兩者取較早。
+
+    第一次看到就落一個檔；transcript 沒有時間戳（或讀不到）時它就是唯一的憑據。
+    """
+    cands = []
+    ts = transcript_start(transcript_path)
+    if ts:
+        cands.append(ts)
+
+    sid = "".join(c for c in (session_id or "") if c.isalnum() or c in "-_")[:80]
+    if sid:
+        p = os.path.join(state_dir(), sid + ".start")
+        seen = None
+        try:
+            with open(p) as f:
+                seen = datetime.fromtimestamp(float(f.read().strip()), tz=timezone.utc)
+        except Exception:
+            seen = None
+        if seen is None:
+            seen = min(cands) if cands else now
+            try:
+                with open(p, "w") as f:
+                    f.write("%d" % seen.timestamp())
+            except Exception:
+                pass
+        cands.append(seen)
+
+    return min(cands) if cands else now
+
+
+def deadline(now: datetime) -> datetime:
+    """今天的收工線（台北 HH:MM）。過線後四小時內不滾，讓超時看得見。"""
+    hhmm = os.environ.get("ISEP_COUNTDOWN_DEADLINE", "16:00").strip() or "16:00"
+    try:
+        hh, mm = (int(x) for x in hhmm.split(":", 1))
+    except Exception:
+        hh, mm = 16, 0
+    local = now.astimezone(TAIPEI)
+    d = local.replace(hour=hh, minute=mm, second=0, microsecond=0)
+    if local >= d + timedelta(hours=4):
+        d += timedelta(days=1)
+    return d
+
+
+def _mainline():
+    """借 `hooks/lib/mainline.py` 讀「被標定的主線」。拿不到就當沒有（fail-open）。
+
+    刻意用檔案路徑載入而不是 `import mainline`：本檔自己也是被
+    `spec_from_file_location` 載進去的，`sys.path` 裡沒有 `hooks/lib`。
+    """
+    try:
+        import importlib.util
+        p = os.path.join(os.path.dirname(os.path.abspath(__file__)), "mainline.py")
+        spec = importlib.util.spec_from_file_location("isep_mainline", p)
+        mod = importlib.util.module_from_spec(spec)
+        spec.loader.exec_module(mod)
+        return mod
+    except Exception:
+        return None
+
+
+def milestone() -> "tuple[str, datetime | None] | None":
+    """主線 milestone 的期限。優先讀被標定的主線，其次讀「期限最近」的快取。
+
+    快取檔一行：`YYYY-MM-DD|<名稱>`。兩個都沒有就沒有（回 None，整段不顯示）。
+    期限可能是 None（被標定的主線沒設期限）——那時只說名字，不編一個日期。
+    """
+    raw = os.environ.get("ISEP_MILESTONE_DUE", "").strip()
+    name = os.environ.get("ISEP_MILESTONE_NAME", "").strip()
+    if not raw:
+        mod = _mainline()
+        if mod is not None:
+            try:
+                seg = mod.countdown_segment()
+            except Exception:
+                seg = None
+            if seg:
+                return seg
+    if not raw:
+        p = os.path.join(state_dir(), "milestone-due")
+        try:
+            with open(p) as f:
+                raw = f.read().strip()
+        except Exception:
+            return None
+        if "|" in raw:
+            raw, name = raw.split("|", 1)
+            raw, name = raw.strip(), name.strip()
+    if not raw:
+        return None
+    dt = _parse_ts(raw) or _parse_ts(raw + "T23:59:59+08:00")
+    if not dt:
+        return None
+    return (name or "主線", dt)
+
+
+def human(delta: timedelta) -> str:
+    mins = int(abs(delta).total_seconds()) // 60
+    h, m = divmod(mins, 60)
+    if h and m:
+        return "%d 小時 %d 分" % (h, m)
+    if h:
+        return "%d 小時" % h
+    return "%d 分" % m
+
+
+def line(session_id: str, transcript_path: str) -> str:
+    now = _now()
+    start = session_start(session_id, transcript_path, now)
+    dl = deadline(now)
+
+    parts = ["%s 已過 %s" % (MARKER, human(now - start))]
+    left = dl - now
+    if left.total_seconds() >= 0:
+        parts.append("距收工線（台北 %s）剩 %s" % (dl.strftime("%H:%M"), human(left)))
+    else:
+        parts.append("🔴 已超過收工線（台北 %s）%s" % (dl.strftime("%H:%M"), human(left)))
+
+    ms = milestone()
+    if ms:
+        name, due = ms
+        if due is None:
+            parts.append("主線 %s（沒設期限）" % name)
+        else:
+            gap = due - now
+            if gap.total_seconds() >= 0:
+                parts.append("主線 %s 剩 %s" % (name, human(gap)))
+            else:
+                parts.append("🔴 主線 %s 已逾期 %s" % (name, human(gap)))
+
+    return "｜".join(parts)
+
+
+if __name__ == "__main__":
+    try:
+        payload = json.load(sys.stdin)
+    except Exception:
+        payload = {}
+    print(line(payload.get("session_id") or "", payload.get("transcript_path") or ""))

hooks/lib/dispatch_parse.py

@@ -0,0 +1,419 @@
+#!/usr/bin/env python3
+"""hooks/lib/dispatch_parse.py — 派工單與交件回覆的**結構解析器**（不是閘）。
+
+依 inkstone/ISEP#40 S7 的慣例：`lib/` 裡的東西是共用零件，本身不決定 allow/block，
+判決由呼叫它的閘做（`hooks/dispatch-format-guard.sh`、`hooks/reply-identity-guard.sh`、
+`scripts/ticket`）。
+
+━━ 規則本身（leo 2026-08-27，inkstone/ISEP#30 comment 4322 / 4325 / 4327）━━
+
+    派工單 ＝ 【工單】owner/repo#N。就這樣。
+
+  三則合起來是一條規則：
+    4322  任務要在票上，不是在 prompt 裡 —— 而閘只驗了票號這個殼
+    4325  「你用一個 **output parser** 把你給 subagent 的指令規範，分作幾點，
+           每一點規定格式，**照這種散文寫法根本無法迭代**」「**警察也不能抓**」
+    4327  「**交件方式不需要寫，定義在原則裡**⋯⋯每次都一樣提取出來變成共通規定」
+           「（那些 session 事實）**為什麼不寫到票裡？**」
+
+  ⇒ 派工單裡的東西只有兩種，**兩種都不該留在派工單**：
+
+    每次都一樣  交件方式、不要 push main、org 是 inkstone、先讀該 repo 的 CLAUDE.md
+                => 共通規定（由閘自動注入，見 dispatch-format-guard.sh）
+    這次才知道  main 是哪顆 commit、今天撞過什麼、另一條線正在動什麼
+                => **寫進那張票**（「票上還沒有」是「去把它寫上票」的指令，
+                   不是「把它寫進 prompt」的理由）
+
+  判準一句話：**「這句話換一張票還成立嗎？」**
+    還成立 => 共通規定；只有這次成立 => 寫進這張票。兩種都不進派工單。
+
+  為什麼連「這次才知道的事」也不能留在 prompt（4327 實害）：
+  那個 agent 被停掉／換人接手，那段事實就隨 prompt 消失。
+  2026-08-27 總管停掉重派 3 次，前兩次的任務與 session 事實全部蒸發。
+
+━━ 為什麼這支過得了「封動作不封文字」的檢驗（leo 2026-08-17）━━━━━━━━
+  「你在**文字層**封路⋯⋯**自然語言的變體是無限的，blacklist 永遠追不完。**
+    封路哲學之所以有效，是因為它封的是**動作**——動作有限且可枚舉，文字不是。」
+  當日實證：文字層的閘 8 次誤攔、0 次正確攔截，**紅線寫得越細，命中關鍵字的機率越高
+  ⇒ 那些閘在懲罰謹慎**。
+
+  本檔**沒有「命中某個詞就違規」的比對**。判準是「這一行是不是【工單】欄位」——
+  **在不在**，不是**寫什麼**。用到的正則有三種，全部在認形狀：
+    - `【某某】` 欄位標記本身
+    - `owner/repo#N`（可選外掛全形／半形括號的 `→ comment M`）票號形狀
+    - 唯一例外（ISEP#65）：`_COURTESY_CLOSERS` 是一份**白名單**，只用來認出
+      「這一行是不是零資訊的禮貌收尾」，作用方向與黑名單相反——認出的是
+      「不算違規」，不是「算違規」；且要求整行清乾淨標點後完全相等，不是
+      「包含」，所以不會反過來放走任何真正的內容。
+  措辭多謹慎、有沒有提到「紅線」「部署」「main」，本檔一律不看，仍然不會被
+  「寫得越小心越容易被罰」的病拖下水。
+
+━━ 派工單格式 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+    【工單】inkstone/ISEP#30 → comment 4322
+
+  就這一行。要帶兩張票就兩行【工單】。**沒有第二個欄位。**
+
+━━ 交件回覆格式（任何人 → 票）━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+    【身份】subagent／inkstone/ISEP／feat/ticket-carries-the-task
+
+  第一行就要認得出是誰寫的。角色是三選一的允許清單：`總管`／`subagent`／`leo`。
+  2026-08-27 實害：總管寫的診斷被當成 subagent 的結論，而其中一則是錯的。
+
+━━ 通往 subagent 的路不只一條（inkstone/ISEP#88）━━━━━━━━━━━━━━━━
+
+  第一版的閘只掛在 `PreToolUse(Task|Agent)`——那只涵蓋「**新開**一個 subagent」。
+  **回覆一個正在跑的 subagent 走的是別的工具，根本不經過那個攔截點。**
+  實況（2026-08-27 本 session）：第一次派工乾乾淨淨只有票號，
+  中途回覆時又把一長串修改要求直接丟過去，**那些話票上一個字都沒有**。
+  那條線被停掉或換人接手，它們就消失——正是壓縮派工單原本要解決的問題。
+
+  ⇒ 本檔不再只認一種 payload 形狀。`tool_channel()` 把所有通往 subagent 的路
+    收成一張表（見該函式），一次列全：
+
+      Task / Agent                         新開一個 subagent      → prompt
+      SendMessage                          回覆正在跑的那個      → message
+      *Claude_Code_Remote__create_session  開一個新的雲端 session → prompt
+      *Claude_Code_Remote__send_message    送訊息進某個 session   → text / message
+      *Claude_Code_Remote__create_trigger  排程派工（未來會醒）   → prompt
+      *Claude_Code_Remote__update_trigger  改排程派工的內容       → prompt
+      *Claude_Code_Remote__fire_trigger    當場點燃排程派工       → text
+      *Claude_Code_Remote__send_later      排一則訊息給自己       → message
+      Bash `claude -p <prompt>`            用 CLI 開一個新 session → 指令裡那段 prompt
+
+  🔴 這張表就是 `ticket-api-bypass-guard.sh` 檔頭記過的那一課的同款：
+    「認動作的方式漏了一條路」是這一族的通病（那支第一版只認大寫裸字 `POST`，
+     於是 `requests.post()` 與 urllib 的隱式 POST 全部漏掉）。
+    ⇒ 新增一條路要加在 `tool_channel()`，**不要另造一支平行的閘**。
+
+  兩條路的分界只有一個（其餘判準完全共用，這是刻意的）：
+    · `dispatch`（Task／Agent）沒有【工單】 ⇒ **skip**，那是 no-ticket-no-dispatch 的地盤
+    · `reply`（其餘全部）沒有【工單】     ⇒ **違規**，因為那支閘沒有掛在這些路上，
+      不擋就等於這條路整條裸奔
+
+用法：
+    import dispatch_parse
+    r = dispatch_parse.parse_dispatch(prompt_text)
+    ok, detail = dispatch_parse.parse_identity(comment_body)
+
+  CLI：吃 hook 的 JSON，吐一份事實 JSON
+    printf '%s' "$INPUT" | python3 hooks/lib/dispatch_parse.py dispatch
+"""
+import json
+import re
+import shlex
+import sys
+
+# ── 派工單的字彙表：**只有一個欄位**。這是允許清單，不是黑名單 ──────────────
+DISPATCH_ALLOWED = ("工單",)
+
+# 曾經合法、現已收回的欄位。**不參與判決**（判決是「不是【工單】就是多的」），
+# 只用來讓訊息講得出「你這一欄的內容該搬去哪」。
+RETIRED_FIELDS = {
+    "人格": "共通規定（收工方從票的 repo 就知道自己戴誰的人格）",
+    "交件": "共通規定（每張票都一樣：貼回原票）",
+    "就地": "**寫進那張票**（這正是「票上還沒有」的解法）",
+    "身份": "那是**交件回覆**的欄位，不是派工單的",
+}
+
+IDENTITY_ROLES = ("總管", "subagent", "leo")
+
+_MARKER_RE = re.compile(r"^【([^】]{1,12})】\s*(.*)$")
+_REF_RE = re.compile(r"^([A-Za-z0-9_.-]+)/([A-Za-z0-9_.-]+)#(\d+)\s*$")
+# 🔴 inkstone/ISEP#65：頂層 CLAUDE.md 規定的合格格式帶著全形括號——
+#   「【工單】owner/repo#N（→ comment M）」。舊版正則只吃「→ comment M」本體，
+#   兩側的括號（全形／半形都要吃）沒被算進去，殘留的括號讓 _REF_RE 比不過，
+#   於是**規則自己定義的合格範例會被自己的閘擋下**。這裡把左右括號都收進來，
+#   兩種都設成可選（沒有括號的舊寫法、純 #issuecomment- 連結都還要能過）。
+_COMMENT_RE = re.compile(r"[（(]?\s*(?:#issuecomment-|→\s*comment\s*)(\d+)\s*[）)]?")
+_FENCE_RE = re.compile(r"^\s*(```|~~~)")
+
+# 🔴 inkstone/ISEP#65：票號後面只掛一句純禮貌收尾（例：「謝謝」），不該被當成
+#   「派工單不只有票號」的違規——它不含任何要搬去票上或共通規定的實質內容。
+#   這是**白名單，不是黑名單**：判準仍是結構（整行清乾淨標點後「等於」清單裡的
+#   固定字串，不是「包含」），漏收某個禮貌講法頂多誤鎖一次（代價小，見 ISEP#65
+#   的「優先做成低誤鎖」），但不會反過來放走任何真正的內容——真內容不會剛好
+#   打出一個字不差的空話。全檔仍然沒有「命中某個詞就違規」的比對，這裡是唯一
+#   一處字面比對，且作用方向相反：認出「不是內容」，不是認出「是違規」。
+_COURTESY_CLOSERS = frozenset({
+    "謝謝", "謝謝你", "謝謝您", "謝謝囉", "多謝", "感謝", "感恩", "辛苦了", "收到",
+    "thanks", "thank you", "thx",
+})
+_COURTESY_STRIP_RE = re.compile(r"[\s。！!.,～~，、]+$")
+
+
+def _is_courtesy_closer(line):
+    s = _COURTESY_STRIP_RE.sub("", line.strip())
+    return s.lower() in _COURTESY_CLOSERS
+
+
+def _split_lines(text):
+    """切成 (是否在圍欄內, 原始行)。
+
+    圍欄（``` / ~~~）裡的東西是**資料**不是欄位標記。同一個道理已經在
+    hooks/lib/strip_heredoc.py 落地過（heredoc body 是資料不是指令，
+    inkstone/InkStoneCo#23、#56 的根因就是把資料當指令掃）。
+    這裡的效果是：貼一段指令進派工單，裡面的【】不會被誤認成欄位——
+    但整段圍欄本身仍然算「多出來的內容」，照樣會被擋。
+    """
+    out, in_fence = [], False
+    for line in text.split("\n"):
+        if _FENCE_RE.match(line):
+            out.append((in_fence, line))   # 圍欄那一行歸屬於「切換前」的狀態
+            in_fence = not in_fence
+            continue
+        out.append((in_fence, line))
+    return out
+
+
+def parse_dispatch(prompt):
+    """把派工單拆成「【工單】欄位」與「其餘一切」。**只回事實，不下判決**。
+
+    回傳 dict：
+      has_ticket_marker  有沒有出現過【工單】——沒有就不是本格式的東西
+      refs               解析成功的票號清單 [{'owner','repo','num','comment'}]
+      bad_ticket_lines   有【工單】標記但形狀不對的那幾行
+      extra              多出來的實質內容 [(來源欄位或 None, 原始行)]
+      retired_seen       出現過的、已收回的欄位名（給訊息用）
+    """
+    fields_seen, refs, bad_ticket_lines = [], [], []
+    extra, retired_seen = [], []
+    cur = None
+
+    for in_fence, raw in _split_lines(prompt or ""):
+        if not in_fence:
+            m = _MARKER_RE.match(raw)
+            if m:
+                name, rest = m.group(1), m.group(2)
+                cur = name
+                fields_seen.append(name)
+                if name in RETIRED_FIELDS and name not in retired_seen:
+                    retired_seen.append(name)
+                if name in DISPATCH_ALLOWED:
+                    text = rest.strip()
+                    head = _COMMENT_RE.sub("", text).strip()
+                    rm = _REF_RE.match(head)
+                    if rm:
+                        cm = _COMMENT_RE.search(text)
+                        refs.append({"owner": rm.group(1), "repo": rm.group(2),
+                                     "num": int(rm.group(3)),
+                                     "comment": int(cm.group(1)) if cm else None})
+                    else:
+                        bad_ticket_lines.append(raw.strip())
+                else:
+                    if rest.strip():
+                        extra.append((name, raw))
+                continue
+        if raw.strip():
+            # 【工單】欄位本身只准佔它自己那一行；它下面的續行也是多的。
+            # 白名單豁免只在圍欄外生效——圍欄裡的東西本來就該一律算數（test ⑮），
+            # 這裡不額外放寬，避免有人把真內容包在圍欄裡再貼一句「謝謝」蒙混。
+            if not in_fence and _is_courtesy_closer(raw):
+                continue
+            extra.append((cur, raw))
+
+    return {
+        "has_ticket_marker": "工單" in fields_seen,
+        "refs": refs,
+        "bad_ticket_lines": bad_ticket_lines,
+        "extra": extra,
+        "extra_lines": len(extra),
+        "extra_chars": sum(len(r.strip()) for _, r in extra),
+        "retired_seen": retired_seen,
+        "fields_seen": fields_seen,
+    }
+
+
+def dispatch_violations(parsed):
+    """換算成違規清單。每一條都是**結構**事實，可以單獨迭代。"""
+    v = []
+    for line in parsed["bad_ticket_lines"]:
+        v.append(("票號形狀不對",
+                  "「%s」不是 owner/repo#N（可加 → comment M）；org 是 inkstone 不是 Leo"
+                  % line[:60]))
+    if parsed["extra"]:
+        first = parsed["extra"][0][1].strip()
+        v.append(("派工單不只有票號",
+                  "【工單】以外還有 %d 行／%d 字，第一行是：%s"
+                  % (parsed["extra_lines"], parsed["extra_chars"], first[:50])))
+    return v
+
+
+def identity_roles():
+    """合法的身份角色 ＝ 三個固定角色 ＋ **名單上的工人名字**（inkstone/ISEP#86）。
+
+    leo：「票上的紀錄要看得出是哪個工人做的。」`subagent` 這個字回答不了「是誰」——
+    多條線並行時，三個 subagent 的留言長得一模一樣。
+    名單讀不到就退回三個固定角色（fail-open：名單壞掉不該讓人貼不了留言）。
+    """
+    try:
+        import os
+        sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+        import roster
+        return tuple(IDENTITY_ROLES) + tuple(roster.names())
+    except Exception:
+        return tuple(IDENTITY_ROLES)
+
+
+def parse_identity(body):
+    """交件回覆的【身份】欄。回 (ok, detail)。"""
+    for raw in (body or "").split("\n"):
+        if not raw.strip():
+            continue
+        m = _MARKER_RE.match(raw)
+        if not m or m.group(1) != "身份":
+            return False, "第一行不是【身份】"
+        val = m.group(2).strip()
+        if not val:
+            return False, "【身份】後面是空的"
+        role = re.split(r"[／/]", val)[0].strip()
+        allowed = identity_roles()
+        if role not in allowed:
+            return False, "角色「%s」不在 %s 之內" % (role or "（空）", "／".join(allowed))
+        return True, val
+    return False, "內文是空的"
+
+
+# ── 通往 subagent 的路：一張表，一次列全（inkstone/ISEP#88）────────────────
+#   新增一條路加在這裡。**不要另造一支平行的閘**——票上寫死了：
+#   「要嘛把攔截點加掛上去，要嘛讓兩條路共用同一個判斷函式。」
+#
+#   值是「這個工具的哪幾個欄位裝著要送給 subagent 的話」，依序取第一個有內容的。
+_DISPATCH_TOOLS = {
+    "Task": ("prompt",),
+    "Agent": ("prompt",),
+}
+_REPLY_TOOLS = {
+    "SendMessage": ("message",),
+    "create_session": ("prompt",),
+    "send_message": ("text", "message"),
+    "create_trigger": ("prompt",),
+    "update_trigger": ("prompt",),
+    "fire_trigger": ("text",),
+    "send_later": ("message",),
+}
+# `claude -p <prompt>` ＝ 用 CLI 開一個新 session。判準是**指令名**（結構），
+# 不是指令內容裡有沒有某個詞——所以一段剛好含有「【工單】」字樣的 echo 不會被誤認。
+_CLAUDE_CLI_RE = re.compile(r"(?:^|[;&|]\s*|\s)claude\s")
+_CLI_PRINT_FLAGS = ("-p", "--print")
+# 這些旗標後面跟的是它自己的值，不是 prompt
+_CLI_VALUE_FLAGS = {"--model", "-m", "--append-system-prompt", "--system-prompt",
+                    "--allowedTools", "--permission-mode", "--output-format",
+                    "--input-format", "--session-id", "--resume", "--add-dir",
+                    "--mcp-config", "--settings", "--agents"}
+
+
+def _claude_cli_prompt(command):
+    """從一段 shell 指令裡把 `claude -p <prompt>` 的 prompt 取出來。取不到回 ""。"""
+    if not command or not _CLAUDE_CLI_RE.search(command):
+        return ""
+    try:
+        toks = shlex.split(command)
+    except Exception:
+        return ""
+    for i, t in enumerate(toks):
+        if t.rsplit("/", 1)[-1] != "claude":
+            continue
+        rest = toks[i + 1:]
+        if not any(f in rest for f in _CLI_PRINT_FLAGS):
+            return ""            # 沒有 -p ⇒ 不是一次性的 prompt 執行
+        skip = False
+        for j, tok in enumerate(rest):
+            if skip:
+                skip = False
+                continue
+            if tok in _CLI_VALUE_FLAGS:
+                skip = True
+                continue
+            if tok.startswith("-"):
+                continue
+            return tok           # 第一個位置參數 ＝ prompt
+        return ""
+    return ""
+
+
+def tool_channel(payload):
+    """回 (channel, text)。channel ∈ {"dispatch", "reply", ""}。
+
+    "" ＝ 這個工具呼叫不是在驅動任何 subagent，本閘管不到。
+    """
+    name = payload.get("tool_name") or ""
+    ti = payload.get("tool_input") or {}
+    if not isinstance(ti, dict):
+        return "", ""
+    short = name.rsplit("__", 1)[-1]
+
+    if name == "Bash" or short == "Bash":
+        return ("reply", _claude_cli_prompt(ti.get("command") or ""))
+
+    # 🔴 方向很重要：本規則管的是「**派工的人**送出去的話」。
+    #    subagent 往上回報（`to: "main"`）是**交件**，不是派工——
+    #    擋它等於擋掉交件本身。交件的規矩由 baton-handback-guard／
+    #    reply-identity-guard 管，不在這裡。
+    if (name == "SendMessage" or short == "SendMessage") and \
+            str(ti.get("to") or "").strip().lower() == "main":
+        return "", ""
+
+    for table, channel in ((_DISPATCH_TOOLS, "dispatch"), (_REPLY_TOOLS, "reply")):
+        keys = table.get(name) or table.get(short)
+        if not keys:
+            continue
+        for k in keys:
+            v = ti.get(k)
+            if isinstance(v, str) and v.strip():
+                return channel, v
+        return channel, ""
+    return "", ""
+
+
+# ── CLI ──────────────────────────────────────────────────────────────────
+def _main():
+    mode = sys.argv[1] if len(sys.argv) > 1 else "dispatch"
+    try:
+        payload = json.load(sys.stdin)
+    except Exception:
+        print(json.dumps({"status": "skip", "why": "payload 不是 JSON"}))
+        return
+
+    if mode != "dispatch":
+        print(json.dumps({"status": "skip", "why": "未知模式 %s" % mode}))
+        return
+
+    channel, text = tool_channel(payload)
+    if not channel:
+        print(json.dumps({"status": "skip", "why": "不是通往 subagent 的路"}))
+        return
+    if channel == "reply" and not (text or "").strip():
+        print(json.dumps({"status": "skip", "why": "這條路這次沒有帶任何話"}))
+        return
+
+    parsed = parse_dispatch(text)
+
+    if not parsed["has_ticket_marker"]:
+        if channel == "dispatch":
+            # 連【工單】都沒有 => 那是 no-ticket-no-dispatch.sh 的地盤，本閘閉嘴。
+            # 兩支閘同時對同一件事開口，收工方會拿到兩份互相打架的教學。
+            print(json.dumps({"status": "skip",
+                              "why": "沒有【工單】，交給 no-ticket-no-dispatch"}))
+            return
+        # reply 這條路上**沒有**那支閘（它只掛 Task|Agent）⇒ 不擋就整條裸奔。
+        violations = [{"code": "回覆沒有票號",
+                       "detail": "回覆也是派工：內容寫進票，訊息只給【工單】owner/repo#N"}]
+        extra_text = (text or "").strip()
+    else:
+        violations = [{"code": c, "detail": d} for c, d in dispatch_violations(parsed)]
+        extra_text = "\n".join(r.rstrip() for _, r in parsed["extra"]).strip()
+
+    print(json.dumps({
+        "status": "ok",
+        "channel": channel,
+        "violations": violations,
+        "refs": parsed["refs"],
+        "retired_seen": parsed["retired_seen"],
+        "extra_lines": parsed["extra_lines"],
+        "extra_text": extra_text,
+        "session_id": payload.get("session_id") or "",
+    }, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    _main()

hooks/lib/evidence.py

@@ -0,0 +1,123 @@
+#!/usr/bin/env python3
+"""hooks/lib/evidence.py — 「這段要寫上票的內容，帶不帶得出出處？」（inkstone/ISEP#87）
+
+依 inkstone/ISEP#40 S7 的慣例：`lib/` 裡的東西是共用零件，本身不決定 allow/block，
+判決由呼叫它的閘做（`hooks/diagnosis-evidence-guard.sh`）。
+
+━━ 規則本身（leo，inkstone/ISEP#87）━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  「身為派人去查的人，我要自己在拿到調查結果前寫不出診斷，
+    我才不會用猜的結論把工人的判斷力關掉。」
+
+  票上原文的兩個壞法：
+    · 診斷寫完了，**工人就不知道自己要做什麼**——它會照著我的結論去驗證，而不是去查
+    · **我不是那個 repo 的專家，它才是**。我的結論通常是猜的，
+      但因為寫在票上，看起來就像事實
+
+  ⇒ 順序倒過來：**先派人查 → 拿到查的結果 → 才可以寫診斷。**
+
+━━ 🔴 為什麼判準不能是「找出診斷的句型」━━━━━━━━━━━━━━━━━━━━
+  票上寫死：「『根因』『因為』『應該是』這類詞**一律不准當判準**」。
+  leo 2026-08-17 已證偽文字層封路：當日 **8 次誤攔、0 次正確攔截**，而且方向穩定——
+  **紅線寫得越細，命中關鍵字的機率越高 ⇒ 那些閘在懲罰謹慎。**
+
+  所以本檔**沒有任何「命中某個詞就違規」的比對**。它只做一件事：
+  **認出「出處」在不在**——而且是**往放行的方向**做字面比對
+  （認出來 ⇒ 放行；認不出來 ⇒ 交給閘去看別的結構訊號）。
+  這是 `pr-verdict-guard.sh` ③ 用過的形狀：識別碼有限且唯一，
+  比對錯了只會**少擋一次**，不會多罰一次。
+
+━━ 什麼算「出處」（七種，全部是可以走過去看的東西）━━━━━━━━━━━━━━
+  檔案:行號 ／ commit sha ／ comment 號 ／ 票號 ／ 網址 ／
+  檔案路徑（帶目錄與副檔名）／ 圍欄裡的實測輸出
+
+  共同點：**讀的人可以自己走過去確認**。這正是「轉述別人查到的東西」與
+  「我猜的」之間唯一機械分得出來的差別（票上驗收條件 4：有出處的轉述不能被誤擋）。
+
+用法：
+    import evidence
+    hits = evidence.sources(text)     # [(種類, 命中的字串), ...]
+    body = evidence.body_of(command)  # 從一段 shell 指令裡把「要貼上去的內文」挖出來
+"""
+import os
+import re
+
+# ── 七種出處。**方向是放行**：認出來就代表這段話走得回它的來源 ──────────────
+_SOURCE_PATTERNS = [
+    ("檔案:行號", re.compile(r"[\w./-]+\.\w{1,6}:\d+")),
+    ("commit", re.compile(r"\b[0-9a-f]{7,40}\b")),
+    ("comment 號", re.compile(r"(?:#issuecomment-|comment\s*)\d{2,}", re.I)),
+    ("票號", re.compile(r"[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+#\d+")),
+    ("網址", re.compile(r"https?://\S{4,}")),
+    ("檔案路徑", re.compile(r"(?<![\w/])[\w.-]+/[\w./-]*\w\.\w{1,6}(?![\w])")),
+    ("實測輸出", re.compile(r"^\s*(?:```|~~~)", re.M)),
+]
+
+# 身份欄本身不算出處——它說的是「誰寫的」，不是「這句話哪來的」。
+_IDENTITY_LINE_RE = re.compile(r"^【身份】.*$", re.M)
+
+
+def sources(text):
+    """回 [(種類, 命中的字串)]。空清單 ＝ 這段話裡沒有任何走得過去的出處。"""
+    if not text:
+        return []
+    body = _IDENTITY_LINE_RE.sub("", text)
+    out = []
+    for kind, pat in _SOURCE_PATTERNS:
+        m = pat.search(body)
+        if m:
+            out.append((kind, m.group(0)[:60]))
+    return out
+
+
+def substance(text):
+    """扣掉身份欄與空白之後還剩多少字。
+
+    **長度是結構訊號，不是措辭**：一句「收到，我來看」不可能是診斷；
+    診斷天生是一段有因果的敘述。用它把閘收窄，是為了不要天天誤擋
+    ——`.claude/branch-holds.md` 檔頭那句：**永遠在響的警報，等於訓練人忽略這個警報。**
+    """
+    if not text:
+        return 0
+    body = _IDENTITY_LINE_RE.sub("", text)
+    return len(re.sub(r"\s+", "", body))
+
+
+# ── 從一段 shell 指令裡把「要貼上去的內文」挖出來 ────────────────────────────
+#   做法與 comment-carries-task-guard.sh 相同：有 `-F <檔>` 就讀那個檔，
+#   否則就拿指令文字本身當內文（PreToolUse 只看得到指令，這是這一層的天花板）。
+#   🔴 一定要把「真正要貼上去的那段字」跟指令的鷹架分開。第一版沒分，
+#      結果 `curl … https://git.uncle6.me/api/v1/…/comments -d '{"body":"<沒出處的診斷>"}'`
+#      **永遠放行**——因為指令裡的**那個 URL 自己就被當成出處了**。
+#      同一個病 `ticket-api-bypass-guard.sh` 檔頭也記過：認錯了要看的東西，
+#      閘就在驗一個跟規則無關的欄位。
+_FARG_RE = re.compile(r"(?:^|\s)(?:-F|--file)\s+([^\s'\"]+)")
+_BODY_FLAG_RE = re.compile(r"(?:^|\s)--body[\s=]+(['\"])(.*?)\1", re.S)
+_JSON_BODY_RE = re.compile(r"""['\"]body['\"]\s*:\s*['\"](.*?)['\"]\s*[,}]""", re.S)
+
+
+def body_of(command):
+    """回 (內文, 來源)。來源 ∈ {"file", "--body", "json", "command"}。
+
+    依序試四種：`-F <檔>` → `--body <字串>` → payload 裡的 `body` 欄 → 整段指令。
+    前三種都是「這段字才是要貼上票的東西」，指令的其餘部分（網址、token、旗標）
+    **不算內文**——它們不是誰查來的，把它們算成出處等於這道閘自己拆自己。
+    """
+    if not command:
+        return "", "command"
+    m = _FARG_RE.search(command)
+    if m:
+        path = m.group(1)
+        try:
+            if os.path.isfile(path):
+                with open(path, encoding="utf-8", errors="ignore") as f:
+                    return f.read(), "file"
+        except Exception:
+            pass
+    m = _BODY_FLAG_RE.search(command)
+    if m:
+        return m.group(2), "--body"
+    m = _JSON_BODY_RE.search(command)
+    if m:
+        return m.group(1).replace("\\n", "\n"), "json"
+    return command, "command"

hooks/lib/mainline.py

@@ -0,0 +1,248 @@
+#!/usr/bin/env python3
+"""hooks/lib/mainline.py —— 「現在的主線是哪一個」這件事的**唯一存放處**。
+
+這是 helper，不是閘（inkstone/ISEP#40 S7：`lib/` 底下的東西不算一支手寫的閘）。
+三個呼叫者共用它，所以「主線是誰」的答案只有一份：
+  · `scripts/mainline`            —— 人問「現在的主線是哪一個」
+  · `hooks/lib/countdown.py`      —— 每一則回覆眼前那一行的第二段
+  · `hooks/mainline-focus-guard.sh` —— 派了一張不屬於主線的票就攔一次
+
+── 為什麼要有這個檔（inkstone/ISEP#82）──────────────────────────────
+2026-08-27 實查：`GET /repos/inkstone/*/milestones?state=open` 回 **14 個**，
+其中「Mira 現代化」這個名字同時活在 5 個 repo，還有 5 個已經逾期。
+SOP 說「有 active milestone 時只做該 milestone 的事」——但**「那個」在現場沒有指涉對象**。
+
+leo 的原話是「**14 個里程碑同時亮著卻不知道該看哪個**」。
+⇒ 要解的不是「milestone 太多」（跨 repo 同名是既有做法，v0.6.0 §4／SOP S7-4），
+  要解的是「**這一刻我在做哪一條**」沒有答案。
+
+⇒ 所以這個檔的形狀就是答案的形狀：**一個檔，放得下一條**。
+  沒有清單、沒有優先序、沒有「前三名」——被覆蓋掉的那條就不再是主線。
+  問「現在的主線是哪一個」永遠只會拿到 0 或 1 個答案，不會拿到 14 個。
+
+── 主線是一個「名字」，錨在一個具體的 milestone 上 ──────────────────
+Gitea 的 milestone 不能跨 repo，而同一條線常常同時開在 5 個 repo（票上實查）。
+所以：
+  · **錨**（anchor）＝ `owner/repo#<milestone id>`：期限、進度、目標宣告都讀它
+  · **成員判定**＝ 票所屬 milestone 的**標題**與主線標題相同（不分 repo）
+⇒ 「同名跨 repo」照舊能用，而「現在在做哪一條」仍然只有一個答案。
+
+── 這支從不打網路 ────────────────────────────────────────────────
+它被 `UserPromptSubmit` 用（每一則訊息的關鍵路徑）。在那裡打 HTTP ＝ 每講一句話
+都先等一次網路。網路那一半全部在 `scripts/mainline`（set／refresh／adopt），
+本支只讀寫 state 檔。讀不到 ⇒ 回「沒有主線」，**不編一條出來**。
+"""
+import json
+import os
+from datetime import datetime, timedelta, timezone
+
+TAIPEI = timezone(timedelta(hours=8))
+MARKER = "🎯"
+STATE_NAME = "mainline.json"
+JUMP_LOG = "mainline-jumps.jsonl"
+
+
+def state_dir() -> str:
+    """與倒數共用同一個狀態目錄——兩行字是同一個注入點的兩半，狀態不該分家。"""
+    d = os.environ.get("ISEP_COUNTDOWN_STATE_DIR", "").strip()
+    if not d:
+        d = os.path.join(os.path.expanduser("~"), ".claude", "isep-countdown")
+    try:
+        os.makedirs(d, exist_ok=True)
+    except Exception:
+        pass
+    return d
+
+
+def path() -> str:
+    return os.path.join(state_dir(), STATE_NAME)
+
+
+def load():
+    """讀主線。沒有／壞掉 ⇒ None（＝現在沒有主線），**不是例外**。
+
+    「沒有主線」是一個正常狀態，不是故障：ISEP#82 驗收第 4 條寫死了
+    「沒有任何主線時不能整組壞掉」。所以這支從不 raise。
+    """
+    try:
+        with open(path()) as f:
+            d = json.load(f)
+    except Exception:
+        return None
+    if not isinstance(d, dict) or not d.get("title"):
+        return None
+    return d
+
+
+def save(d) -> bool:
+    try:
+        with open(path(), "w") as f:
+            json.dump(d, f, ensure_ascii=False, indent=2)
+        return True
+    except Exception:
+        return False
+
+
+def clear() -> bool:
+    try:
+        os.remove(path())
+        return True
+    except FileNotFoundError:
+        return True
+    except Exception:
+        return False
+
+
+def parse_ts(raw):
+    if not isinstance(raw, str) or not raw.strip():
+        return None
+    s = raw.strip().replace("Z", "+00:00")
+    try:
+        dt = datetime.fromisoformat(s)
+    except Exception:
+        try:
+            dt = datetime.fromisoformat(s + "T23:59:59+08:00")
+        except Exception:
+            return None
+    return dt if dt.tzinfo else dt.replace(tzinfo=timezone.utc)
+
+
+def due_of(ms):
+    return parse_ts((ms or {}).get("due_on") or "")
+
+
+def norm(s) -> str:
+    """比對標題用。只做「看不見的差異」的正規化——大小寫與空白。
+
+    🔴 刻意不做同義詞、不做模糊比對：主線是**被指定的**，不是被猜出來的。
+    猜錯的方向是「把不屬於主線的票放行」，那正是這張票要擋的事。
+    """
+    return "".join((s or "").split()).lower()
+
+
+def ref_of(ms) -> str:
+    if not ms:
+        return ""
+    return "%s/%s#%s" % (ms.get("owner") or "?", ms.get("repo") or "?", ms.get("id") or "?")
+
+
+def members(ms):
+    return set(ms.get("members") or []) if ms else set()
+
+
+def belongs(ticket_ref, ms, ticket_milestone_title=None):
+    """這張票屬不屬於主線？回 True／False／None。
+
+    None ＝ **不知道**（快取裡沒有這張票，而呼叫端也沒查到它的 milestone）。
+    🔴 「不知道」不等於「不屬於」——這條分界就是誤攔與否的分水嶺。
+    呼叫的閘拿到 None 時該放行（本 repo 心法第 2 條：誤攔比漏擋更該修）。
+    """
+    if not ms:
+        return True                      # 沒有主線 ⇒ 沒有「不屬於主線」這回事
+    ref = (ticket_ref or "").strip()
+    if ref and ref in members(ms):
+        return True
+    if ticket_milestone_title is not None:
+        return norm(ticket_milestone_title) == norm(ms.get("title"))
+    return None
+
+
+def fixture_titles():
+    """測試用：把「去 Gitea 問這張票掛在哪」換成一份現成的答案。
+
+    `ISEP_MAINLINE_FIXTURE` 指向一個 JSON：`{"owner/repo#N": "milestone 標題"}`。
+    設了它，閘就不打網路，直接拿這份當事實。
+
+    🔴 這與 `ISEP_COUNTDOWN_NOW`（把時鐘定住）是同一個性質的東西：
+      **把外界定住，讓閘能離線、可重複地被測**。正式環境不會設它；
+      沒設 ⇒ 這支回 None，判決完全走真實的 Gitea。
+    """
+    p = os.environ.get("ISEP_MAINLINE_FIXTURE", "").strip()
+    if not p:
+        return None
+    try:
+        with open(p) as f:
+            d = json.load(f)
+        return d if isinstance(d, dict) else None
+    except Exception:
+        return None
+
+
+def record_jump(ticket_ref, ms):
+    """把「派了一張不在主線上的票」記一筆。**只留痕，不判罪。**
+
+    跳線本身常常是對的（補收、真的插件事）。留痕是為了讓「這條線今天被岔開幾次」
+    事後數得出來——沒有紀錄的話，跳線與專注在機器上長得一模一樣。
+    """
+    try:
+        with open(os.path.join(state_dir(), JUMP_LOG), "a") as f:
+            f.write(json.dumps({
+                "at": datetime.now(timezone.utc).isoformat(),
+                "ticket": ticket_ref,
+                "mainline": ref_of(ms),
+                "mainline_title": (ms or {}).get("title"),
+            }, ensure_ascii=False) + "\n")
+    except Exception:
+        pass
+
+
+def _human(delta: timedelta) -> str:
+    days = int(abs(delta).total_seconds()) // 86400
+    if days >= 1:
+        return "%d 天" % days
+    hours = int(abs(delta).total_seconds()) // 3600
+    return "%d 小時" % hours
+
+
+def due_phrase(ms, now=None) -> str:
+    """期限那一段。沒設期限就說沒設——不准編一個日期出來。"""
+    dt = due_of(ms)
+    if not dt:
+        return "沒設期限"
+    now = now or datetime.now(timezone.utc)
+    day = dt.astimezone(TAIPEI).strftime("%Y-%m-%d")
+    gap = dt - now
+    if gap.total_seconds() >= 0:
+        return "%s（剩 %s）" % (day, _human(gap))
+    return "%s（🔴 已逾期 %s）" % (day, _human(gap))
+
+
+def progress(ms):
+    o = int((ms or {}).get("open_issues") or 0)
+    c = int((ms or {}).get("closed_issues") or 0)
+    total = o + c
+    pct = int(round(c * 100.0 / total)) if total else 0
+    return c, total, pct
+
+
+def line(now=None) -> str:
+    """注入用的那一行（倒數那一行的第二行）。**沒有主線時也要回一句話。**
+
+    ISEP#82 驗收第 4 條：沒有主線不能整組壞掉，要講得出「現在沒有主線」。
+    ⇒ 這支永遠回一個非空字串，永遠不 raise。
+    """
+    ms = load()
+    if not ms:
+        return ("%s 現在沒有主線——沒有任何 milestone 被標成「現在在做的那一條」。"
+                "要標：`scripts/mainline set <owner/repo#milestone_id>`"
+                "（先看有哪些：`scripts/mainline list`）" % MARKER)
+    c, total, pct = progress(ms)
+    head = "%s 主線：%s「%s」｜%s｜%d／%d 張已關（%d%%）" % (
+        MARKER, ref_of(ms), ms.get("title") or "?", due_phrase(ms, now), c, total, pct)
+    goal = (ms.get("description") or "").strip().splitlines()
+    if goal:
+        head += "\n   目標：" + goal[0].strip()[:120]
+    return head
+
+
+def countdown_segment(now=None):
+    """給 `countdown.py` 用的 (名稱, 期限) ——讓 ⏱ 那一行說得出主線是誰。
+
+    為什麼要塞進 ⏱ 那一行：⏱ 那一行**已經有一支 Stop 閘在查它有沒有被戴上**
+    （inkstone/ISEP#63）。主線的名字掛在那一行上，就跟著那道已經驗過的閘一起
+    到 leo 眼前——不必為了同一件事再立第二道會擋人的閘。
+    """
+    ms = load()
+    if not ms:
+        return None
+    return (ms.get("title") or "主線", due_of(ms))

hooks/lib/mtime.sh

@@ -0,0 +1,57 @@
+# hooks/lib/mtime.sh — 「這個檔幾點被動的」，跨 macOS／Linux 都問得出來。
+# 不是獨立掛的閘（沒進 hooks.json），給那幾支用 /tmp 戳記的閘 `source` 用。
+#
+# ══ 為什麼要有這支（inkstone/ISEP#90 ④，2026-08-28 實查）═══════════════
+#
+# 三支閘（prod-write-guard、main-and-prod-push-guard、stage-before-prod-guard）
+# 的戳記檢查都寫成這一行：
+#
+#     MT=$(stat -f %m "$STAMP" 2>/dev/null || stat -c %Y "$STAMP" 2>/dev/null || echo 0)
+#
+# 在 macOS（BSD stat）上它是對的：`-f %m` 就是 mtime。
+# 在 **Linux（GNU coreutils）上 `-f` 是「顯示檔案系統資訊」**，而且它
+# **一邊回非零、一邊往 stdout 吐一整段檔案系統的區塊**：
+#
+#     $ stat -f %m /tmp/.probe
+#     stat: cannot read file system information for '%m': No such file or directory   ← stderr
+#       File: "/tmp/.probe"                                                            ← stdout
+#         ID: 0        Namelen: 255     Type: ext2/ext3
+#     …
+#
+# ⇒ `2>/dev/null` 把錯誤訊息吃掉、`||` 接著跑 `stat -c %Y` 把正確的秒數**接在那堆垃圾後面**
+# ⇒ `MT` 變成「一段多行文字＋一個數字」
+# ⇒ 閘下一行的 `case "$NOW$MT" in *[!0-9]*) return 1` 一定命中
+# ⇒ **在 Linux 上，那三支閘的戳記永遠不會被接受。**
+#
+# 🔴 這件事的後果不是「少一個便利功能」：
+#   那三支閘都是「擋下來，但**總管看過就可以放行**」的設計。
+#   放行的那道門在雲端（Linux）打不開 ⇒ **它們在雲端等於純擋**，
+#   總管照著閘自己印的指示做，做幾次都打不開，而閘不會告訴他門是壞的。
+#   inkstone/InkStoneCo#99 記的「連續四次蓋不出戳記」就是這個形狀。
+#
+# ── 再往下一層：`-f` 根本不吃格式參數，所以連離開碼都不可靠 ────────────
+#
+# 2026-08-28 兩個人量這一格，一個量到 `exit=0`、一個量到 `exit=1`。**兩個都是真的**，
+# 而分歧本身就是最後一塊拼圖：**GNU 的 `-f` 是 `--file-system`，布林旗標、不接格式字串**
+# ⇒ `%m` 被當成**另一個檔名運算元** ⇒ 離開碼取決於「cwd 裡有沒有一個叫 `%m` 的檔」：
+#
+#     A. 沒有（一般情況）  → exit 1 ⇒ `||` **會**跑 ⇒ 正確的秒數接在垃圾後面
+#     B. 剛好有            → exit 0 ⇒ `||` **不會**跑 ⇒ 整包連一個數字都沒有
+#
+# 兩種情況下閘的結果一樣：`MT` 都不是純數字，戳記都作廢。（實測 GNU coreutils 9.4）
+#
+# 🔴 **這才是該記住的教訓**：舊寫法的 `||` fallback 救不了，
+#   **不是因為它沒跑，而是因為「跑不跑」根本不由這支腳本決定**
+#   ——它由「cwd 裡有沒有某個檔名」決定。
+#   一個**行為取決於 cwd 裡有沒有某個檔**的判斷式，不管跑不跑都是壞的。
+#
+# 🔴 所以修法不是「把順序反過來」而已：改成先 `-c %Y`（GNU）再 `-f %m`（BSD），
+#   而且**每一步都驗它是不是純數字**——因為這個 bug 的成因正是
+#   「命令失敗了卻還是印了東西出來」，只看離開碼會再被騙一次。
+file_mtime() {
+  _fm=$(stat -c %Y "$1" 2>/dev/null || true)
+  case "${_fm:-}" in ''|*[!0-9]*) _fm=$(stat -f %m "$1" 2>/dev/null || true) ;; esac
+  case "${_fm:-}" in ''|*[!0-9]*) _fm=$(python3 -c 'import os,sys; print(int(os.path.getmtime(sys.argv[1])))' "$1" 2>/dev/null || true) ;; esac
+  case "${_fm:-}" in ''|*[!0-9]*) _fm=0 ;; esac
+  printf '%s' "$_fm"
+}

hooks/lib/path-resolve.sh

@@ -16,8 +16,10 @@
 # history-first-guard.sh、main-and-prod-push-guard.sh、no-ticket-no-dispatch.sh、
 # not-my-branch-guard.sh、release-tag-guard.sh、skill-deploy-drift-guard.sh、
 # stage-before-prod-guard.sh、unpushed-police.sh、wiki-first-police.sh。
-# 另有 claim-verify-police.sh、subagent-claim-worksheet.sh、empty-handed-stop-guard.sh、
-# issue-status-autoflip.sh 直接寫 `$CLAUDE_PROJECT_DIR`（無 `:-` fallback）——
+# 另有 empty-handed-stop-guard.sh、issue-status-autoflip.sh 直接寫 `$CLAUDE_PROJECT_DIR`
+# （無 `:-` fallback）——
+# （claim-verify-police.sh／subagent-claim-worksheet.sh 已於 ISEP#60 整組移除，
+#  它們守的東西改由 Gitea 原生三格承接，見 ISEP#59／PR #58）
 # 這批在該變數未設時行為又不一樣，同一個病的另一種長相。
 # 這些全部沒有本檔「先確認到底在不在 repo 裡」的判斷；本檔先在 sdd-guard.sh 落地，
 # 其餘要不要跟進、要不要改用這支共用函式，另案處理，不在本票（#22）範圍內一次改完。

hooks/lib/roster.py

@@ -0,0 +1,111 @@
+#!/usr/bin/env python3
+"""hooks/lib/roster.py — 工人名單的**唯一讀取點**（inkstone/ISEP#86）。
+
+依 inkstone/ISEP#40 S7 的慣例：`lib/` 裡的東西是共用零件，本身不決定 allow/block，
+判決由呼叫它的閘做（`hooks/roster-guard.sh`、`scripts/roster`、
+`hooks/lib/dispatch_parse.py` 的身份欄）。
+
+━━ 規則本身（leo，inkstone/ISEP#86）━━━━━━━━━━━━━━━━━━━━━━━━━
+
+    「身為派工的人，我要工人有名字，我才知道票上這件事到底是誰做的。」
+
+  實查（開票當日）：`/root/.claude/agents/` 不存在、`InkStoneCo/.claude/agents/`
+  只有一支內建的說明用 agent ⇒ **派工派給的是一個沒有名字的臨時工**。
+  後果三件：票上看不出誰做的／每次派工都要重新交代它是誰（而派工單只准寫票號）／
+  同一個 repo 這次派的跟上次派的沒有任何連續性。
+
+━━ 為什麼名單住在 `agents/`，不是自己造一份 YAML ━━━━━━━━━━━━━━━━
+  `agents/` 是 Claude Code plugin **原生**的 subagent 目錄，frontmatter 的 `name`
+  就是 `Task` 工具的 `subagent_type`。⇒ 「指名派給誰」用的是既有欄位，
+  **派工單格式一個字都不用改**（仍然只有一行 `【工單】`）。
+  這也是本 repo 的慣例：不要重造輪子（見 CLAUDE.md 2.6「為什麼是 issue 不是 Notion」）。
+
+━━ 檔案格式（四段，缺一不可）━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+    ---
+    name: isep-hand                 ← 派工時寫進 subagent_type 的那個字
+    description: 一句話它是誰       ← `roster list` 印的就是這一行
+    ---
+    **負責 repo**：inkstone/ISEP    ← 挑人的判準，也是【身份】欄第二格
+    ## 開工前先讀                    ← 每個工人各自不同，共通規定補不了
+    ## 紅線                          ← 只寫這個 repo 特有的
+
+用法：
+    import roster
+    ws = roster.load()                  # [{'name','description','repo','path','body'}]
+    w  = roster.find("isep-hand")       # 找不到回 None
+    roster.names()                      # ['arcrun-hand', ...]
+"""
+import os
+import re
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+# hooks/lib/ → hooks/ → plugin root
+_DEFAULT_ROOT = os.path.abspath(os.path.join(_HERE, "..", ".."))
+
+_NAME_RE = re.compile(r"^name:\s*(.+?)\s*$", re.M)
+_DESC_RE = re.compile(r"^description:\s*(.+?)\s*$", re.M)
+# 「**負責 repo**：inkstone/ISEP」——粗體記號與全形冒號都當可選，
+# 免得改一次排版就讓名單讀不到 repo（那會靜默失效，比擋錯更難發現）。
+_REPO_RE = re.compile(r"\*{0,2}負責\s*repo\*{0,2}\s*[：:]\s*([^\s（(]+)")
+
+
+def roster_dir():
+    """名單目錄。`ISEP_ROSTER_DIR` 只給測試用（不碰真的名單）。"""
+    d = os.environ.get("ISEP_ROSTER_DIR")
+    if d:
+        return d
+    root = os.environ.get("CLAUDE_PLUGIN_ROOT") or _DEFAULT_ROOT
+    return os.path.join(root, "agents")
+
+
+def load(directory=None):
+    """讀出整份名單。讀不到目錄就回空清單（**不丟例外**——
+    呼叫它的閘要能在名單不在場時 fail-open，不能把 session 鎖死）。"""
+    d = directory or roster_dir()
+    out = []
+    try:
+        files = sorted(f for f in os.listdir(d) if f.endswith(".md"))
+    except Exception:
+        return out
+    for fn in files:
+        path = os.path.join(d, fn)
+        try:
+            with open(path, encoding="utf-8", errors="ignore") as f:
+                text = f.read()
+        except Exception:
+            continue
+        head, _, body = text.partition("---\n")[2].partition("\n---")
+        if not head:                      # 沒有 frontmatter ⇒ 不是工人檔
+            continue
+        m = _NAME_RE.search(head)
+        if not m:
+            continue
+        dm = _DESC_RE.search(head)
+        rm = _REPO_RE.search(body)
+        out.append({
+            "name": m.group(1).strip(),
+            "description": (dm.group(1).strip() if dm else ""),
+            "repo": (rm.group(1).strip() if rm else ""),
+            "path": path,
+            "body": body.strip(),
+        })
+    return out
+
+
+def names(directory=None):
+    return [w["name"] for w in load(directory)]
+
+
+def find(name, directory=None):
+    n = (name or "").strip()
+    if not n:
+        return None
+    for w in load(directory):
+        if w["name"] == n:
+            return w
+    return None
+
+
+def one_liner(w):
+    repo = w.get("repo") or "（跨 repo）"
+    return "%-18s %-26s %s" % (w["name"], repo, w.get("description", ""))

hooks/main-and-prod-push-guard.sh

@@ -74,6 +74,18 @@ esac
 #   ⇒ 沒有可靠的身分辨識時，改成**正向確認**：推 main 前要有一枚新鮮的戳記。
 #     subagent 當然造得出那枚戳記——但它得刻意繞過一段明講「不要這樣做」的訊息。
 #     **閘擋的是無心，不是惡意。** 而現在這個版本連無心都擋不了（它誰都擋）。
+# 🔴 戳記的 mtime 一律走 lib/mtime.sh：舊寫法（`stat -f %m || stat -c %Y`）在 Linux 上
+#   **永遠算不出數字**（GNU 的 `-f` 是「檔案系統資訊」，它一邊回非零一邊吐一整段文字，
+#   於是後面接上的秒數被那段垃圾污染）⇒ 這支閘給總管的逃生口在雲端整個焊死，
+#   而閘不會告訴他門是壞的（inkstone/ISEP#90 ④，全文見 hooks/lib/mtime.sh）。
+#   lib 不在時就地補一份同順序的定義——這道門不能因為少一個檔案就再關上一次。
+. "$(dirname "$0")/lib/mtime.sh" 2>/dev/null || file_mtime() {
+  _fm=$(stat -c %Y "$1" 2>/dev/null || true)
+  case "${_fm:-}" in ''|*[!0-9]*) _fm=$(stat -f %m "$1" 2>/dev/null || true) ;; esac
+  case "${_fm:-}" in ''|*[!0-9]*) _fm=0 ;; esac
+  printf '%s' "$_fm"
+}
+
 STAMP="/tmp/.main-push-ok"
 
 # 🔴 2026-08-11 這道閘被自己的戳記穿透了，修法寫在這裡：
@@ -87,7 +99,7 @@ STAMP="/tmp/.main-push-ok"
 stamp_ok() {
   [ -f "$STAMP" ] || return 1
   NOW=$(date +%s 2>/dev/null || echo 0)
-  MT=$(stat -f %m "$STAMP" 2>/dev/null || stat -c %Y "$STAMP" 2>/dev/null || echo 0)
+  MT=$(file_mtime "$STAMP")
   case "$NOW$MT" in *[!0-9]*) return 1 ;; esac
   [ "$NOW" -gt 0 ] && [ "$MT" -gt 0 ] || return 1
   [ $((NOW - MT)) -lt 900 ] || return 1
@@ -261,7 +273,9 @@ leo 原話：
 逐筆看過那些 commit（`git log --oneline gitea/main..<branch>`、`git diff --stat`），
 確定它們該進 main，再：
 
-    git rev-parse --show-toplevel > /tmp/.main-push-ok && <你的 git push 指令>
+    bash "$CLAUDE_PLUGIN_ROOT/scripts/gate-ok" main-push <那個 repo 的路徑>
+    <你的 git push 指令>
+    （等價的手打法：git rev-parse --show-toplevel > /tmp/.main-push-ok）
 
 戳記 **綁這個 repo、只能用一次、15 分鐘失效**——它代表「**這一次、這個 repo，我看過了**」。
 

hooks/mainline-focus-guard.sh

@@ -0,0 +1,176 @@
+#!/usr/bin/env bash
+# mainline-focus-guard.sh — 派了一張不在主線上的票，就當場問清楚（inkstone/ISEP#82）
+#
+# ── 補的是哪一格 ────────────────────────────────────────────────
+# leo 2026-08-27：「**14 個里程碑同時亮著卻不知道該看哪個**」「今天……分心」。
+# SOP 說「有 active milestone 時只做該 milestone 的事」——但現場 14 個 open milestone，
+# 「那個」沒有指涉對象 ⇒ **那條規則在機器上等於不存在**（同款第 N 次：
+# history-first／KBDB-first／stage-first 全是「規則被讀到了，卻沒有機制驗證有沒有照做」）。
+#
+# ISEP#82 把「現在在做哪一條」變成一個查得到的事實（`scripts/mainline`），
+# 本閘是那個事實的**用處**：派工的票號不在主線上，就當場說是補收還是跳線，
+# 不要默默做完——分心不是「做了壞事」，是「岔開了而沒有人注意到」。
+#
+# ── 🔴 這不是關鍵字黑名單（leo 2026-08-17 已證偽那條路）────────────────
+# 「自然語言的變體是無限的，blacklist 永遠追不完……封路哲學之所以有效，
+#   是因為它封的是**動作**——動作有限且可枚舉，文字不是。」
+#   當日實測：文字層的閘 8 次誤攔、0 次正確攔截。
+#
+# 本閘從頭到尾**不讀派工單的任何一個字義**。它只做兩個查表：
+#   ① 派工單的【工單】欄位是哪一張票（`hooks/lib/dispatch_parse.py` 解結構，不判語意）
+#   ② 那張票所屬的 milestone 標題，等不等於被標定的主線標題（字串相等，不是模糊比對）
+# 措辭怎麼寫都不影響判決；改的只有「這張票掛在哪」這個 Gitea 上的事實。
+#
+# ── 誤攔的出口全部先關掉（誤攔比漏擋更該修）──────────────────────────
+#   · **沒有主線 ⇒ 一律放行**（ISEP#82 驗收第 4 條：沒有主線不能整組壞掉）
+#   · 派工單裡沒有票號 ⇒ 放行（那是 no-ticket-no-dispatch.sh 的地盤，
+#     兩支閘同時開口，收工方會拿到兩份打架的教學）
+#   · 多張票只要**有一張**在主線上 ⇒ 放行（那次派工有在推主線）
+#   · 快取裡查不到，就**打一次網路去問那張票**；問不到 ⇒ 放行
+#     （🔴「讀不到」不等於「不屬於」——把這兩件事講成同一句是最貴的錯）
+#   · 子 session 不查：主線是**派工者**手上的判準（CLAUDE.md：「critical path 是
+#     你用來盯 subagent 的判準」），不是收工方要背的東西
+#   · **同一張票只擋一次**：擋完就落一個戳記，重送即放行 ⇒ 不會鬼打牆
+#   · 內部出錯一律放行——這是節拍器不是安全閘，它壞掉不該讓派工停擺
+set -uo pipefail
+
+INPUT="$(cat)"
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# 子 session 不查（見上）
+[ "${CLAUDE_CODE_CHILD_SESSION:-}" = "1" ] && exit 0
+
+VERDICT=$(printf '%s' "$INPUT" | ISEP_HOOKS_DIR="$HERE" python3 -c '
+import importlib.machinery, importlib.util, json, os, sys, urllib.request
+
+HERE = os.environ["ISEP_HOOKS_DIR"]
+
+def load(name, path):
+    ldr = importlib.machinery.SourceFileLoader(name, path)
+    spec = importlib.util.spec_from_file_location(name, path, loader=ldr)
+    mod = importlib.util.module_from_spec(spec)
+    ldr.exec_module(mod)
+    return mod
+
+def bail(why):
+    print("SKIP:" + why); raise SystemExit
+
+try:
+    d = json.load(sys.stdin)
+except Exception:
+    bail("bad-json")
+
+prompt = (d.get("tool_input") or {}).get("prompt") or ""
+if not prompt.strip():
+    bail("no-prompt")
+
+try:
+    dp = load("isep_dispatch_parse", os.path.join(HERE, "lib", "dispatch_parse.py"))
+    ML = load("isep_mainline", os.path.join(HERE, "lib", "mainline.py"))
+except Exception:
+    bail("lib-unavailable")
+
+try:
+    refs = dp.parse_dispatch(prompt).get("refs") or []
+except Exception:
+    bail("parse-failed")
+if not refs:
+    bail("no-ticket")                      # no-ticket-no-dispatch 的地盤
+
+ms = ML.load()
+if not ms:
+    bail("no-mainline")                    # 沒有主線 ⇒ 沒有「不屬於主線」這回事
+
+wanted = ["%s/%s#%d" % (r["owner"], r["repo"], r["num"]) for r in refs]
+
+# ① 離線先問快取：有一張在主線上就放行
+unknown = []
+for ref in wanted:
+    v = ML.belongs(ref, ms)
+    if v is True:
+        print("SKIP:on-mainline"); raise SystemExit
+    if v is None:
+        unknown.append(ref)
+
+# ② 快取查不到的，去問那張票掛在哪。問不到 ⇒ 放行。
+if unknown:
+    fx = ML.fixture_titles()
+    if fx is not None:                     # 測試把外界定住（見 mainline.fixture_titles）
+        learned = [r for r in unknown
+                   if ML.norm(fx.get(r, "")) == ML.norm(ms.get("title"))]
+        if learned:
+            print("SKIP:on-mainline-fixture"); raise SystemExit
+        if not any(r in fx for r in unknown):
+            bail("unreachable")            # fixture 沒收錄 ⇒ 等同問不到
+    else:
+      try:
+          T = load("isep_ticket", os.path.join(HERE, "..", "scripts", "ticket"))
+          tok = T.token()
+          host = T.HOST
+      # 🔴 BaseException 不是筆誤：`scripts/ticket` 拿不到憑證時是 sys.exit（SystemExit），
+      #   那不是 Exception 的子類。只接 Exception 的話，這支會整個死掉而不是放行。
+      except BaseException:
+          bail("no-token")                 # 讀不到 ≠ 不屬於
+      reached = False
+      learned = []
+      for ref in unknown:
+          try:
+              owner, rest = ref.split("/", 1)
+              repo, num = rest.split("#", 1)
+              req = urllib.request.Request(
+                  "%s/api/v1/repos/%s/%s/issues/%s" % (host, owner, repo, num),
+                  headers={"Authorization": "token %s" % tok})
+              it = json.load(urllib.request.urlopen(req, timeout=6))
+              reached = True
+          except Exception:
+              continue
+          title = ((it or {}).get("milestone") or {}).get("title") or ""
+          if ML.norm(title) == ML.norm(ms.get("title")):
+              learned.append(ref)
+      if learned:
+          ms["members"] = sorted(set(ms.get("members") or []) | set(learned))
+          ML.save(ms)
+          print("SKIP:on-mainline-fresh"); raise SystemExit
+      if not reached:
+          bail("unreachable")              # 一張都問不到 ⇒ 放行
+
+# ③ 確定都不在主線上 —— 同一組票只擋一次
+import hashlib
+key = hashlib.sha1(("|".join(sorted(wanted)) + "@" + ML.ref_of(ms)).encode()).hexdigest()[:16]
+stamp = os.path.join(ML.state_dir(), "jump-ok-" + key)
+if os.path.exists(stamp):
+    print("SKIP:already-asked"); raise SystemExit
+try:
+    open(stamp, "w").close()
+except Exception:
+    pass
+ML.record_jump(",".join(wanted), ms)
+print("BLOCK:%s\t%s\t%s" % (",".join(wanted), ML.ref_of(ms), ms.get("title") or "?"))
+' 2>/dev/null || echo "SKIP:crash")
+
+case "$VERDICT" in
+  BLOCK:*)
+    PAYLOAD="${VERDICT#BLOCK:}"
+    TICKETS=$(printf '%s' "$PAYLOAD" | cut -f1)
+    MREF=$(printf '%s' "$PAYLOAD" | cut -f2)
+    MTITLE=$(printf '%s' "$PAYLOAD" | cut -f3)
+    FIRST=$(printf '%s' "$TICKETS" | cut -d, -f1)
+    {
+      printf '🎯 這張票不在主線上（inkstone/ISEP#82）\n\n'
+      printf '  現在的主線：%s「%s」\n' "$MREF" "$MTITLE"
+      printf '  這次要派的：%s\n\n' "$TICKETS"
+      printf '**先說是哪一種，再繼續**——兩種都可能是對的，錯的是默默做完：\n\n'
+      printf '  ① 補收 —— 它本來就該在主線上，只是沒掛上去\n'
+      printf '     `scripts/mainline adopt %s`　然後重送\n\n' "$FIRST"
+      printf '  ② 跳線 —— 真的是插件事（leo 臨時交辦、擋路的地雷…）\n'
+      printf '     直接重送即可（**同一張票只擋一次**），並在回覆講一句為什麼現在要岔開主線\n\n'
+      printf '為什麼要問：leo 2026-08-27「今天……分心」。分心的前提是有一條主線，\n'
+      printf '而分心本身不是做了壞事，是**岔開了而沒有人注意到**。這一問就是那個「注意到」。\n\n'
+      printf '想確認主線是誰：`scripts/mainline`（唯一答案）。\n'
+    } >&2
+    exit 2
+    ;;
+  *)
+    exit 0
+    ;;
+esac

hooks/mainline-idle-guard.sh

@@ -0,0 +1,291 @@
+#!/usr/bin/env bash
+# mainline-idle-guard.sh — 主線閒置警察（inkstone/ISEP#30 → comment 4851）
+#
+# ── 補的是哪一格 ────────────────────────────────────────────────
+# leo 2026-08-27：「**你為什麼會停工什麼都沒派？不是停下來會有 hook 嗎？**」
+#
+#   總管的行為              空手警察          稼動率警察
+#   ─────────────────────────────────────────────────────
+#   沒動作、沒宣告          🛑 擋             —
+#   有動作、有宣告下一步    放行              🛑 擋
+#   **有動作、不宣告**      **放行**          **放行**   ← 這一格
+#
+# 第三列就是當天實際發生的：連續數個回合在查 git、讀票、跑測試、複驗 subagent 的
+# 宣稱——**十幾個 tool call，兩支閘都放行**，而主線一個 subagent 都沒派。
+# **只要不寫「下一步」三個字，兩支閘都抓不到。**
+#
+# ── 為什麼不是再加一組句型 ──────────────────────────────────────
+# 紅線就寫在票上：不准用文字層判準。leo 2026-08-17 已經證偽過那條路
+# （文字層的閘當日 8 次誤攔、0 次正確攔截，而且**紅線寫得越細越容易誤攔**）。
+# 本閘從頭到尾**不讀任何一個字**——它只看「這個回合做了什麼工具呼叫」與
+# 「工作區的狀態有沒有變」。措辭隨它變，這條路物理上不通。
+#
+# ── 判準：偵察 ≠ 產出 ──────────────────────────────────────────
+#   乾回合（dry turn）＝ ① 這回合 ≥3 個 tool call（**有在用力**）
+#                     ＋ ② 沒有任何一種「推進證據」（見下）
+#   連續 4 個乾回合 ⇒ 擋一次。（4 是量出來的，見「門檻怎麼定的」）
+#
+#   🔴 兩個「不算乾回合」的設計，是為了不誤攔：
+#     - **0–2 個 tool call 的回合完全不計數**。回答 leo 一個問題、順手 grep 兩下，
+#       那是對話，不是空轉；而「零動作」已經有空手警察在管。
+#     - **推進證據採極寬認定**（下面任何一種都算）。寧可漏攔，不可誤攔——
+#       永遠在響的警報等於訓練人忽略警報，那比沒有警報更糟。
+#
+#   推進證據（任何一種成立 ⇒ 這回合有推進，計數歸零）：
+#     ① 派工／驅動別人：Agent／Task／SendMessage／spawn_task
+#     ② 產出東西：Write／Edit／MultiEdit／NotebookEdit／Artifact
+#     ③ 寫進外部系統：工具名含 create/push/update/send/reply/publish/deploy/submit…
+#     ④ Bash 白名單：git commit/push/merge/tag、scripts/ticket、wrangler deploy…
+#     ⑤ **工作區狀態變了**：HEAD 動了，或 `git status --porcelain` 的內容變了
+#        ⇒ 這一條是關鍵：用 heredoc／sed／腳本改檔（本環境很常見）不經過 Edit 工具，
+#          光看工具名會漏；看**結果**就不會。
+#
+#   🔴 ③④ 是**只用來放行的白名單**，永遠不用來擋。
+#     白名單漏了一項＝少放行一次（有 ⑤ 兜底），黑名單漏了一項＝誤攔一次。
+#     方向不對稱，所以只准往放行的方向做字面比對。
+#
+# ── 為什麼是「連續」而不是「這一回合」 ──────────────────────────
+# 票上第 3 條驗收：「這回合就是在回答一個不需要派工的問題 ⇒ 放行」。
+# 單一回合沒有推進，本來就可能完全正當（在複驗、在讀票、在回答）。
+# **不正當的是那個狀態持續下去。** 所以量的是連續乾回合數，不是單回合。
+# ⇒ 這同時滿足另一條紅線：不會變成「每回合都必須派工」。
+#
+# ── 門檻怎麼定的：拿真 transcript 量，不是拍腦袋 ────────────────
+# 重放本機 6 份真 transcript（InkStoneCo 專案，**1965 個真實回合**），
+# 逐回合餵給這道閘，數它會響幾次：
+#
+#   起始門檻 3 → 4 次（92a75156 兩次、602ea4a1 一次、9e0144f1 一次）
+#   起始門檻 4 → **1 次**（92a75156 第 311 回合）
+#
+# 門檻 3 多出來的那三次，看下去都落在「leo 正在連問問題、我逐題查證回答」的段落
+# ——那正是票上第 3 條驗收明文保護的情境（**閘不能懲罰誠實回答問題**）。
+# 門檻 4 剩下的那一次，落在連續 10 個回合（308–317）只查不產出的那一段，
+# 那一段本來就同時被 delivery-police 與 wiki-first-police 連續攔了五次。
+# ⇒ **1/1965 ＝ 0.05%**。取 4。
+#
+# ⚠️ 重放時一律把 `stop_hook_active` 當成 false（最壞情況）。真實環境裡那幾個
+#    回合有不少是被別的 Stop 閘擋出來的 ⇒ 實際會響得比這個數字更少。
+#
+# ── 響過就退讓（不當那個永遠在響的警報）────────────────────────
+# 擋一次之後：計數歸零，**門檻加倍**（3 → 6 → 12 → 24…）。
+# 真的在空轉會被早早抓到；真的是一段長時間的正當偵察，警報會自己越來越稀。
+# 另外 `stop_hook_active` 為真（已被別的 Stop 閘擋過）時完全不計數。
+# ⇒ 不可能把人鎖死：擋完就放行，再送一次即可。
+#
+# ── 內部錯誤不准靜默放行 ────────────────────────────────────────
+# Stop 閘 fail-closed 會把 session 鎖死，而誤攔是本 repo 的第一級缺陷
+# ⇒ 內部錯誤走 exit 0，但**留痕**：log 記 ⚠️、stderr 也印一行。
+#   「不准靜默」是靠留痕滿足的，不是靠擋下。
+#
+# 迴歸測試：hooks/tests/mainline-idle-guard.test.sh（含「不該擋」的案例）
+set -u
+
+PROJ="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+PAYLOAD=$(cat 2>/dev/null || echo '{}')
+
+# ⑤ 工作區狀態指紋：HEAD ＋ 未提交變更的內容摘要。
+#    不是 git repo 就給空字串（這層證據不可用，其餘四層照跑）。
+GITSTATE=""
+if git -C "$PROJ" rev-parse --git-dir >/dev/null 2>&1; then
+  GITSTATE="$(git -C "$PROJ" rev-parse HEAD 2>/dev/null || echo '-')|$(
+    git -C "$PROJ" status --porcelain 2>/dev/null | shasum 2>/dev/null | cut -c1-16
+  )"
+fi
+
+VERDICT=$(printf '%s' "$PAYLOAD" | GITSTATE="$GITSTATE" python3 -c '
+import json, os, re, sys
+
+def out(s):
+    print(s); raise SystemExit
+
+try:
+    d = json.load(sys.stdin)
+except Exception:
+    out("SKIP:bad-payload")
+
+# 已被別的 Stop 閘擋過這一輪 ⇒ 不計數、不擋（避免疊擋）
+if d.get("stop_hook_active"):
+    out("SKIP:already-nudged")
+
+tp = d.get("transcript_path") or ""
+if not tp or not os.path.exists(tp):
+    out("SKIP:no-transcript")
+
+sid = d.get("session_id") or "nosid"
+sid = re.sub(r"[^A-Za-z0-9_.-]", "_", sid)[:64]
+state_path = os.path.join(os.environ.get("MAINLINE_IDLE_STATE_DIR", "/tmp"),
+                          ".mainline-idle-%s.json" % sid)
+
+rows = []
+try:
+    with open(tp) as f:
+        for line in f:
+            line = line.strip()
+            if line:
+                try: rows.append(json.loads(line))
+                except Exception: pass
+except Exception:
+    out("SKIP:unreadable")
+
+# 這個回合＝最後一則「真的來自使用者」的訊息之後（工具結果不算）
+start = 0
+for i, r in enumerate(rows):
+    if r.get("type") == "user":
+        c = (r.get("message") or {}).get("content")
+        blocks = c if isinstance(c, list) else [{"type": "text"}]
+        if not any(isinstance(b, dict) and b.get("type") == "tool_result" for b in blocks):
+            start = i
+turn = rows[start:]
+
+names, bash_cmds = [], []
+for r in turn:
+    if r.get("type") != "assistant":
+        continue
+    for b in (r.get("message") or {}).get("content") or []:
+        if isinstance(b, dict) and b.get("type") == "tool_use":
+            n = b.get("name") or ""
+            names.append(n)
+            if n == "Bash":
+                cmd = (b.get("input") or {}).get("command") or ""
+                if isinstance(cmd, str):
+                    bash_cmds.append(cmd)
+
+tools = len(names)
+
+# ── 推進證據（白名單：只用來放行）────────────────────────────
+DISPATCH = {"Agent", "Task", "SendMessage"}
+PRODUCE  = {"Write", "Edit", "MultiEdit", "NotebookEdit", "Artifact"}
+# 寫進外部系統的 MCP／內建工具，用動詞尾綴認（漏了只是少放行一次）
+WRITE_VERB = re.compile(
+    r"(create|push|update|send|reply|post|publish|deploy|submit|spawn_task|"
+    r"write|delete|upload|assign|comment|tag_resource|run_workflow)", re.I)
+BASH_WRITE = re.compile(
+    r"git\s+(commit|push|merge|tag|cherry-pick|revert|am|apply)"
+    r"|scripts/ticket|(^|\s)ticket\s+(say|new|assign|label|close|move)"
+    r"|wrangler\s+(deploy|publish|d1|kv|r2|secret)"
+    r"|gh\s+(issue|pr|release)\s+(create|comment|edit|close)"
+    r"|npm\s+publish|ship\.mjs|github-arm\.sh")
+
+why = ""
+if any(n in DISPATCH for n in names):
+    why = "dispatch"
+elif any(n in PRODUCE for n in names):
+    why = "produce"
+elif any(WRITE_VERB.search(n) for n in names):
+    why = "external-write"
+elif any(BASH_WRITE.search(c) for c in bash_cmds):
+    why = "bash-write"
+
+gitstate = os.environ.get("GITSTATE", "")
+
+# ── 狀態檔 ────────────────────────────────────────────────
+st = {}
+try:
+    with open(state_path) as f:
+        st = json.load(f)
+except Exception:
+    st = {}
+
+# 起始門檻。預設 4 是拿真 transcript 量出來的（見檔頭「門檻怎麼定的」段），
+# 環境變數只是為了讓那個量測可以重跑，不是給人隨手調鬆的旋鈕。
+try:
+    BASE = max(2, int(os.environ.get("MAINLINE_IDLE_THRESHOLD", "4")))
+except Exception:
+    BASE = 4
+
+streak    = int(st.get("streak", 0) or 0)
+threshold = int(st.get("threshold", BASE) or BASE)
+last_rows = int(st.get("rows", -1) or -1)
+last_git  = st.get("git", None)
+
+def save(verdict):
+    try:
+        with open(state_path, "w") as f:
+            json.dump({"streak": streak, "threshold": threshold,
+                       "rows": len(rows), "git": gitstate}, f)
+    except Exception:
+        pass
+    out(verdict)
+
+# 第一次見到這個 session：只立基準，不評分（沒有可比的前一格）
+if last_rows < 0:
+    save("SKIP:baseline")
+
+# 同一個回合被叫第二次（transcript 沒長）⇒ 不重複計數
+if len(rows) <= last_rows:
+    save("SKIP:same-turn")
+
+# ⑤ 工作區狀態變了 ⇒ 有產出（heredoc／sed／腳本改檔都吃得到）
+if not why and gitstate and last_git is not None and gitstate != last_git:
+    why = "worktree-changed"
+
+if why:
+    streak = 0
+    save("OK:%s:%d" % (why, tools))
+
+# 沒有推進證據，但這回合幾乎沒用力（≤2 個動作）⇒ 那是對話，不計數
+if tools < 3:
+    save("OK:light-turn:%d" % tools)
+
+streak += 1
+if streak >= threshold:
+    fired_at = streak
+    fired_threshold = threshold
+    streak = 0
+    threshold = threshold * 2      # 響過就退讓：3 → 6 → 12 → 24…
+    save("IDLE::%d::%d::%d" % (fired_at, fired_threshold, tools))
+
+save("OK:dry-turn:%d/%d" % (streak, threshold))
+' 2>/dev/null) || VERDICT="CRASH"
+[ -n "${VERDICT:-}" ] || VERDICT="CRASH"
+
+STAMP=$(date "+%Y-%m-%d %H:%M:%S" 2>/dev/null || echo "?")
+LOGDIR="$PROJ/.claude/hooks"
+note() {
+  if [ -d "$LOGDIR" ]; then
+    printf '| %s | %s | %s |\n' "$STAMP" "$1" "$2" >> "$LOGDIR/mainline-idle-guard.log" 2>/dev/null || true
+  fi
+}
+
+case "$VERDICT" in
+  IDLE::*)
+    N=$(printf '%s' "$VERDICT" | cut -d: -f3)
+    T=$(printf '%s' "$VERDICT" | cut -d: -f5)
+    C=$(printf '%s' "$VERDICT" | cut -d: -f7)
+    note "⛔ 擋下" "連續 ${N} 個乾回合（門檻 ${T}），本回合 ${C} 個動作、零推進"
+    cat >&2 <<MSG
+🛤️ 主線閒置警察：**連續 ${N} 個回合有動作、沒推進。**（本回合 ${C} 個動作）
+
+這一格是空手警察與稼動率警察中間的漏洞——
+  「沒動作」有人管、「宣告了下一步卻沒派工」有人管，
+  但**一直在查、一直在讀、什麼都沒交出去**，兩支都放行。
+🔴 只要不寫「下一步」三個字，就沒有任何閘抓得到。這支抓的就是它。
+
+本閘**一個字都不讀**。它只認這五種「推進」，任何一種成立就歸零：
+  ① 派工／驅動別人   Agent／Task／SendMessage
+  ② 產出東西         Write／Edit／Artifact
+  ③ 寫進外部系統     建票／留言／推工作流／部署
+  ④ Bash 寫入        git commit／push、scripts/ticket、wrangler deploy
+  ⑤ 工作區變了       HEAD 動了或有新的未提交變更（heredoc／sed 改檔也算）
+
+━━ 現在做一件就好，不必補一段說明 ━━━━━━━━━━━━━━━━━━━━━━
+  • 查到的東西**寫回票**（\`scripts/ticket say <owner/repo#N> -F <檔>\`）
+    ——查證只有落回票上才是資產，留在 transcript 裡下一個 session 就沒了
+  • 該別人做的**現在派出去**（帶【工單】一行票號）
+  • 自己該落地的**現在落地**（改檔／commit）
+
+━━ 如果這幾個回合的偵察本來就是正當的 ━━━━━━━━━━━━━━━━━━
+  直接再送一次即可，本閘已經歸零，而且**門檻已加倍**（下次要 $((T*2)) 個乾回合才會再響）。
+  🔴 不必為了過這道閘去做一件假的動作——**假派工比不派更糟。**
+MSG
+    exit 2 ;;
+  CRASH|SKIP:bad-payload)
+    # fail-closed 的精神在「不准靜默」：Stop 閘擋下內部錯誤會鎖死 session，
+    # 所以放行，但一定留痕（log ＋ stderr），讓「這道閘壞了」查得到。
+    note "⚠️ 內部錯誤" "$VERDICT"
+    printf '⚠️ mainline-idle-guard 內部錯誤（%s）——本回合未評分，已記入 log。\n' "$VERDICT" >&2
+    exit 0 ;;
+  *)
+    note "✅ 放行" "$VERDICT"
+    exit 0 ;;
+esac

hooks/milestone-account-guard.sh

@@ -0,0 +1,107 @@
+#!/usr/bin/env bash
+# 管什麼: 直接打 Gitea API 把一個里程碑改成 closed，卻沒有先記帳（估多久／花多久／
+#        差多少／為什麼差），就擋下來。
+# 為什麼: leo 2026-08-27 說那天「拖時間」，但拖了多久、比預計多拖多少、為什麼拖——
+#        一個數字都沒有。偵測器早就有了（mainline-idle-guard／factory-idle-guard），
+#        **但沒有人把它算成帳**，所以事後只能說「這次比較慢」，下次還是一樣。
+# 誤觸時怎麼關: 走正門 `scripts/milestone-account close <owner/repo#編號>`
+#        （它會自己算三個數字、自己去 Gitea 的時間軸取證據、然後幫你關）。
+#        真的有理由要繞過去 ⇒ 指令裡加 `milestone-account-ok`（留痕，commit 說明理由）。
+#
+# milestone-account-guard.sh — 結案要記帳（PreToolUse／Bash；inkstone/ISEP#85）
+#
+# ── 這支跟 milestone-due-guard.sh 是同一條線的兩端 ────────────────────
+#   那支管**開**里程碑要有真的期限（沒有期限就沒有「估多久」可言）。
+#   這支管**關**里程碑要留下那三個數字。少了任何一端，帳都算不出來。
+#
+# ── 判準：三件同時成立才擋，缺一放行 ──────────────────────────────
+#   ① 指令位置真的有人在發網路請求（curl／wget／python／node／gh）
+#      ——「講到它」跟「執行它」是兩件事，這是本 repo 已經證明過的判準
+#        （release-tag-guard.sh 的 `git tag` 位置比對、strip_heredoc.py 的來由）。
+#   ② URL 指名了**某一個**里程碑：`/repos/<owner>/<repo>/milestones/<數字>`
+#      ——沒有數字的（建里程碑、列清單）不是本閘管的形狀。
+#   ③ 有寫入動詞（PATCH／POST／.patch(／.post(）**而且**內容把 state 設成 closed。
+#
+#   ⇒ 純 GET、建里程碑、改標題改期限、`cat` 這支腳本、把指令寫進文件（heredoc 內文
+#     先被 strip_heredoc.py 剝掉）、走正門 `scripts/milestone-account close`
+#     ——全部放行，一條都不擋。
+#
+# ── 抽不出 owner/repo/編號就不擋 ────────────────────────────────────
+#   fail-open on 解析失敗（不是 fail-open on 檢查結果）。理由同 release-tag-guard.sh：
+#   誤攔比漏擋更該修——**誤攔會懲罰謹慎**，而被誤攔幾次之後人就學會繞過這支閘。
+#
+# ── 已知的漏擋（寫出來，不假裝沒有）────────────────────────────────
+#   `bash -c 'curl -X PATCH …'` 這種把真正的指令包進引號裡的寫法，本閘看不到。
+#   這是刻意的取捨：要接住它就得去猜引號裡的內容，而那條路的盡頭是關鍵字黑名單
+#   （leo 2026-08-17 已證偽：當日 8 次誤攔、0 次正確攔截）。
+#
+# 迴歸測試：hooks/tests/milestone-account-guard.test.sh（離線，不打 Gitea）
+set -uo pipefail
+
+HOOKDIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+INPUT=$(cat 2>/dev/null || echo '{}')
+CMD=$(printf '%s' "$INPUT" | python3 -c '
+import json, sys
+try: print(json.load(sys.stdin).get("tool_input", {}).get("command", "") or "")
+except Exception: print("")
+' 2>/dev/null || printf '')
+[ -n "$CMD" ] || exit 0
+
+# 明講的豁免（留痕）
+case "$CMD" in *milestone-account-ok*) exit 0 ;; esac
+
+# heredoc 的內文是資料不是指令——先剝掉，理由見 hooks/lib/strip_heredoc.py 檔頭
+if [ -f "$HOOKDIR/lib/strip_heredoc.py" ]; then
+  CMD=$(printf '%s' "$CMD" | python3 "$HOOKDIR/lib/strip_heredoc.py" 2>/dev/null || printf '%s' "$CMD")
+fi
+
+# ① 指令位置真的有人在發請求
+printf '%s' "$CMD" | grep -qE '(^|[;&|(`]|&&|\|\|)[[:space:]]*(sudo[[:space:]]+)?(curl|wget|http|python3?|node|gh)[[:space:]]' || exit 0
+
+# ② 指名某一個里程碑
+REF=$(printf '%s' "$CMD" | grep -oE '/repos/[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+/milestones/[0-9]+' | head -1 || printf '')
+[ -n "$REF" ] || exit 0
+
+# ③ 寫入動詞 ＋ 把 state 設成 closed
+printf '%s' "$CMD" | grep -qiE -- '-X[[:space:]]*[^A-Za-z]{0,3}(PATCH|POST)|--request[[:space:]]*[^A-Za-z]{0,3}(PATCH|POST)|\.(patch|post)\(|method[[:space:]]*=[[:space:]]*[^A-Za-z]{0,3}(PATCH|POST)' || exit 0
+printf '%s' "$CMD" | grep -qiE 'state[^A-Za-z0-9]{1,8}closed' || exit 0
+
+OWNER=$(printf '%s' "$REF" | cut -d/ -f3)
+REPO=$(printf '%s' "$REF" | cut -d/ -f4)
+NUM=$(printf '%s' "$REF" | cut -d/ -f6)
+TARGET="$OWNER/$REPO#$NUM"
+
+# 已經記過帳的就放行——正門 `milestone-account close` 是**先記帳、再關**，
+# 所以「帳本裡有這一筆」就代表三個數字已經留下來了。
+LEDGER="${MILESTONE_ACCOUNT_LEDGER:-}"
+if [ -z "$LEDGER" ] && [ -x "$HOOKDIR/../scripts/milestone-account" ]; then
+  LEDGER=$(python3 "$HOOKDIR/../scripts/milestone-account" ledger-path 2>/dev/null || printf '')
+fi
+if [ -n "$LEDGER" ] && [ -f "$LEDGER" ] && grep -qF "\"ref\": \"$TARGET\"" "$LEDGER" 2>/dev/null; then
+  exit 0
+fi
+
+cat >&2 <<MSG
+⏱️ 結案要記帳：**$TARGET 還沒有留下「估多久／花多久／差多少」。**
+
+【inkstone/ISEP#85】leo 2026-08-27 說那天「**拖時間**」。
+  但拖了多久、比預計多拖多少、為什麼拖——**沒有任何數字**。
+  「偵測器早就有了，但沒有人把它算成帳」⇒ 每次事後只能說「這次比較慢」，下次還是一樣。
+
+━━ 走正門，它會把該做的一次做完 ━━━━━━━━━━━━━━━━━━━━━━━━
+  先看時間軸怎麼說：  scripts/milestone-account audit $TARGET
+  結案（會自己算、自己關）：
+                      scripts/milestone-account close $TARGET [--reason <代號>]
+
+  三個數字**它自己算**（取自 Gitea 的 created_at／due_on／closed_at），不用你手填。
+  差超過 ±25%（超時或提早都算）才需要 --reason，而且代號只能從那七個裡面挑：
+      scripts/milestone-account codes
+  代號要有**時間軸撐得住**——證據取自 Gitea，不採信任何人的自述。
+
+━━ 為什麼不是「你自己 curl 一下就好」 ━━━━━━━━━━━━━━━━━━━━
+  這一關掉，那個里程碑就再也算不出帳了（closed_at 之後沒有人會回頭補）。
+  ⇒ 這是**不可逆**的一步，所以閘長在這裡，不長在誰的記性上。
+
+  真的有理由要手動關 ⇒ 指令裡加 `milestone-account-ok`（留痕，commit 說明理由）。
+MSG
+exit 2

hooks/pr-verdict-guard.sh

@@ -0,0 +1,394 @@
+#!/usr/bin/env bash
+# 管什麼: 收工那一刻清點「我這邊還有沒有 PR 沒給結論」——open 且沒人在管的 PR、
+#        以及已經 merge 但**分支還留著**的 PR。有就擋一次並點名是哪幾個。
+# 為什麼: 2026-08-27 實查，最久的三個 open PR 躺了兩星期（inkstone/arcrun-rag#91、
+#        inkstone/Arcrun#116、inkstone/Arcrun#104），而 v0.9.0 的 46 支閘沒有一支在管 PR。
+#        票看起來「已交付」，但東西沒進 main ⇒ 沒進版本 ⇒ leo 手上永遠不會出現它。
+# 誤觸時怎麼關: 直接再送一次即可（擋完就歸零，而且那幾個 PR 的門檻已加倍）。
+#        真的在等別人 ⇒ 把 PR 指派給他（或掛 Human），本閘立刻不再點名它。
+#
+# pr-verdict-guard.sh — PR 收斂警察（Stop；inkstone/ISEP#81）
+#
+# ── 為什麼是 Stop 而不是 PreToolUse ──────────────────────────────────
+#   PR 堆積不是「某個動作做錯了」，是「某個動作從來沒發生」。
+#   沒有發生的事情攔不到，只能在收工那一刻清點。同 worklist-guard.sh 的形狀。
+#   **刻意只掛 Stop，不掛 SubagentStop**：給 PR 結論是總管的事，
+#   subagent 手上沒有那個權（它連 main 都不准推）⇒ 掛上去只會變成對它的誤攔。
+#
+# ── 這支跟 baton-handback-guard.sh 是接力，不是重複 ────────────────
+#   baton 管「棒子有沒有交回來」（票的指派＋tag＋下一步三格）。
+#   本支管「交回來之後，總管有沒有動它」——PR 是那根棒子的實體。
+#
+# ── 🔴 已知的坑：這支很容易長成「讓總管永遠停不下來」的那一支 ──────
+#   ISEP v0.6.0 的 divergence 文件 §B4 記過同款：
+#     「`s/review` 佇列非空即 block 總管 stop」⇒ 佇列本來就不會空 ⇒ 永遠擋。
+#   ⇒ **要擋的是遺忘，不是等待。** 本閘用三層把「等待」全部放掉：
+#
+#     ① 有人被指派（或掛 Human）⇒ 不點名。
+#        指派是 Gitea 原生欄位、也是本 repo 既有的「現在誰該動」真相
+#        （見 baton-handback-guard 檔頭那張三格表）。棒子在誰手上是**事實**，
+#        不是措辭 ⇒ 有人拿著 ＝ 在等，不是忘了。
+#     ② 有一則 REQUEST_CHANGES 的 review ⇒ 不點名。
+#        「要求修改」這個結論已經給了，球在對方腳下。
+#     ③ 這一回合碰過它 ⇒ 不點名（見下面「怎麼算碰過」）。
+#     ④ 點名過就退讓：那個 PR 的門檻 1 → 4 → 8 → 16…（每 PR 各自算）。
+#        ⇒ 不可能鎖死：擋完歸零，再送一次就過；真的長期不理才會再響。
+#
+# ── 怎麼算「碰過」：不讀任何一句話 ──────────────────────────────
+#   ① `updated_at` 跟上一次收工比變了 ⇒ 碰過（留言／改標籤／推 commit／submit review
+#      全部會動它）。這是**外部系統的事實**，跟我在對話裡怎麼寫無關。
+#   ② 上一次收工時還不存在的 PR ⇒ 剛開出來 ⇒ 碰過（不在它誕生的那一回合就開罵）。
+#   ③ 這一回合的 tool call 裡出現它的**識別碼**（`owner/repo#N`／`/pulls/N`／它的網址）
+#      ⇒ 碰過。這一條是為了接住「結論寫在票上」——票被改了、PR 沒被改，
+#      ①②都看不到，但那正是本票規定的其中一種合法結論。
+#
+#   🔴 ③ 不是關鍵字黑名單（leo 2026-08-17 已證偽那條路：當日 8 次誤攔、0 次正確攔截）。
+#      差別在方向與集合：黑名單拿**措辭**來**擋**（措辭無限，永遠追不完）；
+#      這裡拿**識別碼**來**放行**（識別碼是有限且唯一的，而且比對錯了只會少擋一次）。
+#      本 repo 心法：只准往放行的方向做字面比對。
+#
+# ── merge 了但分支還在 ＝ 結論只給了一半 ────────────────────────
+#   票上寫死：「merge → 併完當場刪掉那條 branch」。所以某個 PR 從 open 清單消失時，
+#   本閘去看它是不是 merged、head 分支還在不在；還在就一起點名。
+#   （只在「上次還 open、這次不見了」時查，平常一通 API 都不多打。）
+#
+# ── 內部錯誤不准靜默放行 ────────────────────────────────────────
+#   Stop 閘 fail-closed 會鎖死 session，而誤攔是本 repo 的第一級缺陷
+#   ⇒ 內部錯誤走 exit 0，但留痕（log ＋ stderr 各一行）。同 mainline-idle-guard.sh。
+#
+# 迴歸測試：hooks/tests/pr-verdict-guard.test.sh（離線，走 PR_VERDICT_FIXTURE）
+set -u
+
+PROJ="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+PAYLOAD=$(cat 2>/dev/null || echo '{}')
+
+# ── token：同 scripts/ticket 的做法（掃 remote 找帶憑證的，再退到環境變數）──
+TOKEN=""
+if [ -z "${PR_VERDICT_FIXTURE:-}" ]; then
+  for d in "$PROJ" "$PROJ/products"/* "$PROJ/matrix"/* "$PROJ/polaris"/*; do
+    [ -e "$d/.git" ] || continue
+    U=$(git -C "$d" remote -v 2>/dev/null | grep -m1 'git\.uncle6\.me' | grep '@' | awk '{print $2}') || true
+    if [ -n "${U:-}" ]; then
+      T=$(printf '%s' "$U" | sed -E 's|.*//[^:]+:([^@]+)@.*|\1|')
+      [ "$T" != "$U" ] && { TOKEN="$T"; break; }
+    fi
+  done
+  [ -n "$TOKEN" ] || TOKEN="${GITEA_TOKEN_CLAUDE_CODE:-${GITEA_TOKEN:-}}"
+fi
+
+# PR_VERDICT_DEBUG=1 時把內部錯誤原文放出來（平常吞掉，避免雜訊蓋掉閘的訊息）
+ERRSINK=/dev/null
+[ -n "${PR_VERDICT_DEBUG:-}" ] && ERRSINK=/dev/stderr
+
+# 🔴 payload 走環境變數，不走 stdin——`python3 - <<PY` 的 stdin **就是腳本本身**，
+#    再從 sys.stdin 讀就會讀到自己的原始碼（第一版實撞，回 CRASH:bad-payload）。
+VERDICT=$(GITEA_TOKEN_RESOLVED="$TOKEN" PR_VERDICT_PAYLOAD="$PAYLOAD" python3 - <<'PY' 2>"$ERRSINK"
+import json, os, re, sys, time
+import urllib.error, urllib.parse, urllib.request
+
+HOST = os.environ.get("PR_VERDICT_HOST", "https://git.uncle6.me")
+ORGS = [o.strip().lower() for o in
+        os.environ.get("PR_VERDICT_ORGS", "inkstone").split(",") if o.strip()]
+FIXTURE = os.environ.get("PR_VERDICT_FIXTURE", "")
+TOKEN = os.environ.get("GITEA_TOKEN_RESOLVED", "")
+
+def out(s):
+    sys.stdout.write(s)
+    raise SystemExit
+
+try:
+    d = json.loads(os.environ.get("PR_VERDICT_PAYLOAD") or "{}")
+except Exception:
+    out("CRASH:bad-payload")
+
+# 已被別的 Stop 閘擋過這一輪 ⇒ 不計數、不擋（避免疊擋，同 mainline-idle-guard）
+if d.get("stop_hook_active"):
+    out("SKIP:already-nudged")
+
+sid = re.sub(r"[^A-Za-z0-9_.-]", "_", str(d.get("session_id") or "nosid"))[:64]
+state_path = os.path.join(os.environ.get("PR_VERDICT_STATE_DIR", "/tmp"),
+                          ".pr-verdict-%s.json" % sid)
+
+# ── 資料來源：正式打 Gitea，測試走 fixture（單一 JSON 檔或目錄下的 state.json）──
+FX = None
+if FIXTURE:
+    p = FIXTURE if os.path.isfile(FIXTURE) else os.path.join(FIXTURE, "state.json")
+    try:
+        with open(p) as f:
+            FX = json.load(f)
+    except Exception:
+        out("CRASH:bad-fixture")
+
+def api(path, soft=True):
+    """GET 一筆。fixture 模式完全不碰網路。失敗回 None（不影響該不該擋的核心判斷）。"""
+    if FX is not None:
+        return None
+    if not TOKEN:
+        return None
+    try:
+        req = urllib.request.Request(HOST + "/api/v1" + path,
+                                     headers={"Authorization": "token " + TOKEN})
+        return json.load(urllib.request.urlopen(req, timeout=12))
+    except urllib.error.HTTPError as e:
+        return {"__status__": e.code}
+    except Exception:
+        return None
+
+# ── ① 撈 open PR（一通跨 repo 的呼叫）─────────────────────────────
+if FX is not None:
+    pulls = FX.get("pulls", [])
+else:
+    if not TOKEN:
+        out("SKIP:no-token")
+    pulls = api("/repos/issues/search?type=pulls&state=open&limit=50")
+    if pulls is None or isinstance(pulls, dict):
+        out("SKIP:api-unreachable")
+
+def ref_of(pr):
+    return "%s#%s" % (pr.get("repository", {}).get("full_name", "?"), pr.get("number"))
+
+live = {}
+for pr in pulls:
+    full = (pr.get("repository") or {}).get("full_name") or ""
+    if "/" not in full:
+        continue
+    if ORGS and full.split("/", 1)[0].lower() not in ORGS:
+        continue            # 只管我這邊的 org；舊 org 的鏡像不是我的責任
+    if (pr.get("pull_request") or {}).get("draft"):
+        continue            # draft ＝ 作者自己說「還沒好」，不是等我給結論
+    live[ref_of(pr)] = pr
+
+# ── ② 讀上一次收工的快照 ─────────────────────────────────────────
+st = {}
+try:
+    with open(state_path) as f:
+        st = json.load(f)
+except Exception:
+    st = {}
+seen = st.get("seen") or {}
+leftover = st.get("leftover") or {}     # ref -> branch，merge 完分支還沒刪的
+first_run = not seen and "seen" not in st
+
+# ── ③ 這一回合的 tool call 裡提到了哪些識別碼（只用來放行）──────────
+turn_blob = ""
+tp = d.get("transcript_path") or ""
+if tp and os.path.exists(tp):
+    try:
+        rows = []
+        with open(tp) as f:
+            for line in f:
+                line = line.strip()
+                if line:
+                    try:
+                        rows.append(json.loads(line))
+                    except Exception:
+                        pass
+        start = 0
+        for i, r in enumerate(rows):
+            if r.get("type") == "user":
+                c = (r.get("message") or {}).get("content")
+                blocks = c if isinstance(c, list) else [{"type": "text"}]
+                if not any(isinstance(b, dict) and b.get("type") == "tool_result"
+                           for b in blocks):
+                    start = i
+        chunks = []
+        for r in rows[start:]:
+            if r.get("type") != "assistant":
+                continue
+            for b in (r.get("message") or {}).get("content") or []:
+                if isinstance(b, dict) and b.get("type") == "tool_use":
+                    chunks.append(json.dumps(b.get("input") or {}, ensure_ascii=False))
+        turn_blob = "\n".join(chunks)
+    except Exception:
+        turn_blob = ""
+
+def mentioned(ref):
+    """這一回合的 tool call 有沒有指名這個 PR。識別碼比對，只用來放行。"""
+    if not turn_blob:
+        return False
+    full, num = ref.split("#")
+    owner, repo = full.split("/", 1)
+    pats = ["%s#%s" % (full, num), "%s#%s" % (repo, num),
+            "/pulls/%s" % num, "/pull/%s" % num]
+    return any(p in turn_blob for p in pats)
+
+# ── ④ merge 完分支還在不在（只在「上次還 open、這次不見了」時查）────
+def branch_alive(owner, repo, br):
+    if FX is not None:
+        return bool((FX.get("branches") or {}).get("%s/%s:%s" % (owner, repo, br)))
+    r = api("/repos/%s/%s/branches/%s" % (owner, repo, urllib.parse.quote(br, safe="")))
+    if isinstance(r, dict) and r.get("__status__") == 404:
+        return False
+    return isinstance(r, dict) and "name" in r
+
+def pr_detail(ref):
+    if FX is not None:
+        return (FX.get("detail") or {}).get(ref)
+    full, num = ref.split("#")
+    owner, repo = full.split("/", 1)
+    r = api("/repos/%s/%s/pulls/%s" % (owner, repo, num))
+    return r if isinstance(r, dict) and "__status__" not in r else None
+
+for ref in list(seen.keys()):
+    if ref in live:
+        continue
+    det = pr_detail(ref)                       # 不見了：是被 merge 還是被 close？
+    if not det or not det.get("merged"):
+        continue
+    br = ((det.get("head") or {}).get("ref")) or ""
+    if not br:
+        continue
+    full = ref.split("#")[0]
+    owner, repo = full.split("/", 1)
+    if branch_alive(owner, repo, br):
+        leftover[ref] = br
+
+for ref in list(leftover.keys()):              # 已經刪掉的就從清單移除
+    full = ref.split("#")[0]
+    owner, repo = full.split("/", 1)
+    if not branch_alive(owner, repo, leftover[ref]):
+        leftover.pop(ref, None)
+
+# ── ⑤ 逐個 open PR 判「有沒有人在管」──────────────────────────────
+def reviews_of(ref):
+    if FX is not None:
+        return (FX.get("reviews") or {}).get(ref) or []
+    full, num = ref.split("#")
+    owner, repo = full.split("/", 1)
+    r = api("/repos/%s/%s/pulls/%s/reviews" % (owner, repo, num))
+    return r if isinstance(r, list) else []
+
+try:
+    BASE = max(1, int(os.environ.get("PR_VERDICT_THRESHOLD", "1")))
+except Exception:
+    BASE = 1
+
+overdue, newseen = [], {}
+for ref, pr in live.items():
+    prev = seen.get(ref) or {}
+    rec = {"updated_at": pr.get("updated_at"),
+           "quiet": int(prev.get("quiet", 0) or 0),
+           "threshold": int(prev.get("threshold", BASE) or BASE),
+           "fires": int(prev.get("fires", 0) or 0)}
+    newseen[ref] = rec
+
+    # 有人被指派／掛了 Human ＝ 棒子在某個人手上 ⇒ 在等，不是忘了
+    if pr.get("assignees"):
+        rec["quiet"] = 0
+        continue
+    if any((l.get("name") or "").lower() == "human" for l in (pr.get("labels") or [])):
+        rec["quiet"] = 0
+        continue
+    # 上一次收工時還不存在 ⇒ 剛開出來，別在它誕生的那一回合就開罵
+    if not first_run and ref not in seen:
+        rec["quiet"] = 0
+        continue
+    # 這一回合真的動過它（外部事實）／指名過它（識別碼）
+    if prev.get("updated_at") and pr.get("updated_at") != prev.get("updated_at"):
+        rec["quiet"] = 0
+        continue
+    if mentioned(ref):
+        rec["quiet"] = 0
+        continue
+
+    rec["quiet"] += 1
+    if rec["quiet"] < rec["threshold"]:
+        continue
+    # 「要求修改」這個結論已經給了 ⇒ 球在對方腳下（只在要開罵時才多打這通）
+    if any((rv.get("state") or "").upper() == "REQUEST_CHANGES" for rv in reviews_of(ref)):
+        rec["quiet"] = 0
+        continue
+
+    rec["quiet"] = 0
+    rec["threshold"] = max(4, rec["threshold"] * 4 if rec["threshold"] == 1
+                           else rec["threshold"] * 2)
+    rec["fires"] += 1
+    overdue.append((ref, pr))
+
+try:
+    with open(state_path, "w") as f:
+        json.dump({"seen": newseen, "leftover": leftover, "ts": time.time()}, f)
+except Exception:
+    pass
+
+if not overdue and not leftover:
+    out("OK:clean:%d-open" % len(live))
+
+def age_days(pr):
+    try:
+        t = time.mktime(time.strptime(pr.get("created_at", "")[:19], "%Y-%m-%dT%H:%M:%S"))
+        return max(0, int((time.time() - t) / 86400))
+    except Exception:
+        return -1
+
+lines = []
+if overdue:
+    lines.append("【沒有結論的 PR】（open、沒有人被指派、也沒有「要求修改」的 review）")
+    for ref, pr in sorted(overdue, key=lambda x: -age_days(x[1])):
+        dd = age_days(pr)
+        lines.append("  ❌ %-28s 開了 %s天  %s"
+                     % (ref, dd if dd >= 0 else "?", (pr.get("title") or "")[:36]))
+        lines.append("       %s" % ((pr.get("pull_request") or {}).get("html_url") or ""))
+if leftover:
+    lines.append("【merge 了，但分支還留著】（結論只給了一半）")
+    for ref, br in sorted(leftover.items()):
+        lines.append("  ❌ %-28s 分支 %s 還在" % (ref, br))
+
+out("FIRE::" + json.dumps({"body": "\n".join(lines),
+                           "n": len(overdue) + len(leftover)}, ensure_ascii=False))
+PY
+) || VERDICT="CRASH:hook-error"
+[ -n "${VERDICT:-}" ] || VERDICT="CRASH:empty"
+
+STAMP=$(date "+%Y-%m-%d %H:%M:%S" 2>/dev/null || echo "?")
+LOGDIR="$PROJ/.claude/hooks"
+note() {
+  if [ -d "$LOGDIR" ]; then
+    printf '| %s | %s | %s |\n' "$STAMP" "$1" "$2" >> "$LOGDIR/pr-verdict-guard.log" 2>/dev/null || true
+  fi
+}
+
+case "$VERDICT" in
+  FIRE::*)
+    BODY=$(printf '%s' "${VERDICT#FIRE::}" | python3 -c 'import json,sys; print(json.load(sys.stdin)["body"])')
+    N=$(printf '%s' "${VERDICT#FIRE::}" | python3 -c 'import json,sys; print(json.load(sys.stdin)["n"])')
+    note "⛔ 擋下" "$N 個 PR 沒有結論"
+    cat >&2 <<MSG
+🔀 PR 收斂警察：**還有 ${N} 個 PR 沒有結論，現在不是收工的時候。**
+
+$BODY
+
+【inkstone/ISEP#81】「我交出去的 PR 沒有人去看它⋯⋯票看起來是『已交付』，
+  但東西沒有進 main，也就沒有進版本，**leo 手上永遠不會出現它**。」
+
+━━ 「有結論」只有三種，缺一不可 ━━━━━━━━━━━━━━━━━━━━━━━━
+  merge      → **併完當場刪掉那條 branch**
+               scripts/pr-verdict merge <owner/repo#N>
+  退回       → 理由**寫在票上**（不是寫在訊息裡），然後關掉 PR
+               scripts/pr-verdict reject <owner/repo#N> --ticket <owner/repo#N> -F <檔>
+  要求修改   → 修改要求**寫在票上**，並在 PR 上留一則 REQUEST_CHANGES
+               scripts/pr-verdict changes <owner/repo#N> --ticket <owner/repo#N> -F <檔>
+
+  撈一次現況：scripts/pr-verdict list
+
+━━ 如果它本來就在等別人，不是被我忘了 ━━━━━━━━━━━━━━━━━━━━
+  **把它指派給那個人**（或掛 Human）——本閘立刻不再點名它。
+  指派是 Gitea 原生欄位，撈一次就看得到「現在誰該動」；
+  寫在對話裡的「我在等 X」會捲走，欄位不會。
+
+  這一條就是本閘跟「s/review 佇列非空即 block」的分界：
+  **擋的是遺忘，不是等待。**（ISEP v0.6.0 divergence §B4 記過那個坑）
+
+━━ 這幾個現在真的不該處理 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  直接再送一次即可，本閘已經歸零，而且這幾個 PR 的門檻已加倍
+  （1 → 4 → 8 → 16…，每個 PR 各自算）。**不必為了過這道閘去做一件假的動作。**
+MSG
+    exit 2 ;;
+  CRASH*)
+    note "⚠️ 內部錯誤" "$VERDICT"
+    printf '⚠️ pr-verdict-guard 內部錯誤（%s）——本回合未清點 PR，已記入 log。\n' "$VERDICT" >&2
+    exit 0 ;;
+  *)
+    note "✅ 放行" "$VERDICT"
+    exit 0 ;;
+esac

hooks/prod-write-guard.sh

@@ -41,6 +41,26 @@ try: print(json.load(sys.stdin).get("tool_input", {}).get("command", "") or "")
 except Exception: print("")
 ' 2>/dev/null || printf '')
 
+# ── 🔴 卡點二（inkstone/ISEP#63 → comment 5106）：「執行它」vs「談論它」，第八次 ──
+#
+#   總管要把「本閘擋住了發通知」這件事**貼到票上**，而那則留言的內文**引用了**
+#   本閘的判準（實例主機名、寫入旗標的字樣）⇒ **一則留言被自己擋下來。**
+#   同款的第八次（`inkstone/InkStoneCo#23` 的標題已經寫著「第七次」）。
+#   ⇒ 本次修這支閘時**又撞了一次**：連「把修法寫進檔案」的那條指令都被擋，
+#     因為它的內文引用了主機名。那就是這一格最好的證據。
+#
+#   leo 2026-08-17 的診斷：文字層的閘那天 **8 次誤攔、0 次正確攔截**，且方向穩定——
+#   **紅線寫得越細，命中關鍵字的機率越高 ⇒ 那些閘在懲罰謹慎。**
+#
+#   那一段內文**是資料，不是指令**。這支 lib（`github-contact-guard`／
+#   `main-and-prod-push-guard`／`stage-before-prod-guard` 三支已經在用）只剝內文、
+#   **保留起始行**——所以真的在部署的寫法（起始行就帶著實例網址與寫入旗標）
+#   仍然整條看得到、照樣擋。
+#
+#   ⚠️ 繞法（把內文先寫成檔案、再用不含關鍵字的指令送出）本來就通，
+#      但那正是 leo 說的「**人就會學會繞過它，那它就等於不存在**」⇒ 要修的是閘。
+CMD=$(printf '%s' "$CMD" | python3 "$(dirname "$0")/lib/strip_""heredoc.py" 2>/dev/null || printf '%s' "$CMD")
+
 # ── 總管戳記：**單次、15 分鐘失效** ────────────────────────────────────
 #
 # 🔴 這一版一開始寫成「15 分鐘內無限次放行」，而同一天 `main-and-prod-push-guard.sh`
@@ -48,11 +68,23 @@ except Exception: print("")
 #    **15 分鐘內一條並行的 subagent 把 commit 推上了另一個 repo 的 main**。
 #    ⇒ **多條 subagent 並行時，「時間窗」本身就是漏洞。** 所以改成單次用完即丟。
 #    ⇒ 而且只在**真的要擋的那一刻**才檢查——放在檔頭會被任何一條無關指令把戳記燒掉。
+# 🔴 戳記的 mtime 一律走 lib/mtime.sh：舊寫法（`stat -f %m || stat -c %Y`）在 Linux 上
+#   **永遠算不出數字**（GNU 的 `-f` 是「檔案系統資訊」，它一邊回非零一邊吐一整段文字，
+#   於是後面接上的秒數被那段垃圾污染）⇒ 這支閘給總管的逃生口在雲端整個焊死，
+#   而閘不會告訴他門是壞的（inkstone/ISEP#90 ④，全文見 hooks/lib/mtime.sh）。
+#   lib 不在時就地補一份同順序的定義——這道門不能因為少一個檔案就再關上一次。
+. "$(dirname "$0")/lib/mtime.sh" 2>/dev/null || file_mtime() {
+  _fm=$(stat -c %Y "$1" 2>/dev/null || true)
+  case "${_fm:-}" in ''|*[!0-9]*) _fm=$(stat -f %m "$1" 2>/dev/null || true) ;; esac
+  case "${_fm:-}" in ''|*[!0-9]*) _fm=0 ;; esac
+  printf '%s' "$_fm"
+}
+
 STAMP="/tmp/.prod-write-ok"
 stamp_ok() {
   [ -f "$STAMP" ] || return 1
   NOW=$(date +%s 2>/dev/null || echo 0)
-  MT=$(stat -f %m "$STAMP" 2>/dev/null || stat -c %Y "$STAMP" 2>/dev/null || echo 0)
+  MT=$(file_mtime "$STAMP")
   case "$NOW$MT" in *[!0-9]*) return 1 ;; esac
   [ "$NOW" -gt 0 ] && [ "$MT" -gt 0 ] || return 1
   [ $((NOW - MT)) -lt 900 ] || return 1
@@ -92,7 +124,9 @@ leo 原話：
 ━━━ 你是總管 ━━━
 看清楚它會覆蓋什麼（`arcrun_get_workflow` 先撈一份現況存起來，好回滾），確定要推，再：
 
-    touch /tmp/.prod-write-ok      # ⚠️ 只放行「下一個」動作，用完即消失
+    bash "$CLAUDE_PLUGIN_ROOT/scripts/gate-ok" prod-write   # ⚠️ 只放行「下一個」動作，用完即消失
+    （等價的手打法：touch /tmp/.prod-write-ok。gate-ok 是所有閘共用的同一個入口，
+      好處是它的形狀固定 ⇒ 一條規則就能事先放行，不會每次被權限層擋在門外）
 
 戳記 15 分鐘有效。**若這一推會讓封測者／用戶當場拿到東西，那就不是你的層級——要 leo 解保險。**
 MSG
@@ -220,6 +254,40 @@ case "$CMD_M" in
   *curl*|*httpie*|*" http "*|*wget*)
     case "$CMD" in
       *workers.dev*|*arcrun.dev*)
+        # 🔴 卡點一（inkstone/ISEP#63 → comment 5106）：發一則通知被當成部署擋下
+        #
+        #   leo 2026-08-28 要的是「每小時一個版本，用 Telegram 通知我」。
+        #   通道是 `notify_leo` 工作流（wiki `agent-memory.md`：一條 curl、不需任何金鑰）。
+        #   而發一則 Telegram **一定是帶 body 的寫入型請求打到那台實例**
+        #   ⇒ 在本閘眼裡它跟「部署一個工作流上線」長得一模一樣。
+        #
+        #   🔴 **這不是誤攔，是解析度不夠**：兩者打的是同一個 named webhook 家族路徑。
+        #      真正的差別在**打的是哪一個 named webhook**——
+        #        `…/webhooks/named/<ns>/notify_leo/trigger`        ＝ 發一則訊息，什麼都沒改
+        #        `…/webhooks/named`（無名字、無 /trigger）          ＝ 部署工作流定義
+        #        `…/webhooks/named/<ns>/ship_refresh_cdn/trigger`  ＝ 真的動線上狀態
+        #
+        #   判準因此看**目標的結構**（路徑形狀＋工作流名字），不是「有沒有寫入旗標」：
+        #     指令裡打到實例的**每一個**網址都是白名單裡的通知型 trigger ⇒ 放行
+        #     只要有一個不是（含部署端點、含別的工作流）⇒ 照擋
+        #   ⚠️ 放行的範圍刻意只有一個名字。**不放行整個 named webhook 家族**——
+        #      那會把部署一起放掉，等於拆了這道閘。
+        NOTIFY_ONLY=$(printf '%s' "$CMD" | python3 -c '
+import re, sys
+cmd = sys.stdin.read()
+ALLOW = {"notify_leo"}          # 通知型：只發訊息，不改線上任何狀態
+urls = re.findall(r"https?://[^\s\"\x27<>]+", cmd)
+inst = [u for u in urls if re.search(r"://[^/]*(workers\.dev|arcrun\.dev)", u)]
+if not inst:
+    raise SystemExit(0)         # 沒有實例網址 ⇒ 這裡不表態，交給下面的寫入語意判斷
+PAT = re.compile(r"https?://[^/]+/webhooks/named/[^/]+/([A-Za-z0-9_-]+)/trigger/?$")
+def notify(u):
+    m = PAT.match(u.rstrip(",;)"))
+    return bool(m) and m.group(1) in ALLOW
+print("notify-only" if all(notify(u) for u in inst) else "")
+' 2>/dev/null || printf '')
+        [ "$NOTIFY_ONLY" = "notify-only" ] && exit 0
+
         # 🔴 2026-08-12 修誤攔：` -d ` 不只是 curl 的 --data，**一堆唯讀工具也用 -d**
         #   （`tr -d`／`cut -d=`／`sort -d`／`date -d`／`xargs -d`／`paste -d`…）。
         #   實撞：總管要「唯讀」驗證一把金鑰能不能開 kbdb 的閘，指令第一行是
@@ -256,7 +324,9 @@ leo 原話：
 ━━━ 你是總管 ━━━
 確認過要推什麼、會蓋掉什麼之後：
 
-    touch /tmp/.prod-write-ok      # ⚠️ 只放行「下一個」動作，用完即消失
+    bash "$CLAUDE_PLUGIN_ROOT/scripts/gate-ok" prod-write   # ⚠️ 只放行「下一個」動作，用完即消失
+    （等價的手打法：touch /tmp/.prod-write-ok。gate-ok 是所有閘共用的同一個入口，
+      好處是它的形狀固定 ⇒ 一條規則就能事先放行，不會每次被權限層擋在門外）
 
 ⚠️ `acr recipe push` 另有一道**互動式暴露同意閘**（終端機裡要人親手輸入資源名）。
 那道閘擋的是「把資源變成可被外部呼叫」，**本閘的戳記蓋不過它**——那是 leo 的手。

hooks/reply-identity-guard.sh

@@ -0,0 +1,73 @@
+#!/bin/bash
+# 管什麼: 直接打 Gitea API 貼留言到票上時，內文第一行沒有【身份】就擋。
+# 為什麼: scripts/ticket 已經在正門擋了，但貼留言還有 API 這條側門——只封一條等於沒封。
+# 誤觸時怎麼關: 內文第一行加【身份】<總管|subagent|leo>／<owner/repo>／<分支>，或在指令裡加 reply-identity-ok 留痕放行。
+#
+# reply-identity-guard.sh — PreToolUse（Bash）：**票上的每一則留言都要認得出是誰寫的**
+#
+# 來由（leo 2026-08-27，inkstone/ISEP#30 comment 4325）：
+#   「**subagent 回覆時要表明身份**」
+#   實害（同日）：多條線並行，票上的留言看不出是誰寫的，
+#   **總管寫的診斷被當成 subagent 的結論，而其中一則是錯的**。
+#
+# 為什麼要有這一支，正門的檢查不夠：
+#   `scripts/ticket say` 已經在貼上去之前擋了。但**貼留言這個動作有兩條路**——
+#   而 `ticket-api-bypass-guard.sh` 是**刻意放行**「對既有票的留言」的（它管的是開新票）。
+#   ⇒ 側門大開。這正是那支閘檔頭自己記過的一課：
+#     「規範有、閘也有，但閘長在『工具』上，而那個動作有兩條路，只封了一條。」
+#
+# 判準是**結構**不是文字（leo 2026-08-17：「封的是動作，不是文字」）：
+#   本閘不看留言寫什麼，只看**那個欄位在不在**。
+#   三個條件都命中才擋：① 打到 /issues/<N>/comments 這條端點 ② 指令裡有 POST
+#   ③ 內文找不到【身份】。純讀取（GET 撈留言）一律放行。
+#
+# 逃生口：指令裡加 `reply-identity-ok`（會留在指令歷史上）。
+#
+# 測試：hooks/tests/reply-identity.test.sh
+set -uo pipefail
+
+INPUT=$(cat)
+CMD=$(printf '%s' "$INPUT" | python3 -c "
+import sys, json
+try: print(json.load(sys.stdin).get('tool_input', {}).get('command', ''))
+except Exception: print('')
+" 2>/dev/null)
+[ -n "$CMD" ] || exit 0
+
+# 逃生口（留痕）
+case "$CMD" in *reply-identity-ok*) exit 0 ;; esac
+# 正門有自己的閘，重複擋只會互相打架
+case "$CMD" in *scripts/ticket*|*"ticket say"*|*"ticket decide"*|*"ticket close"*) exit 0 ;; esac
+
+# ① 打到「某張票的留言」這條端點（帶票號的子路徑，這是本閘唯一管的東西）
+printf '%s' "$CMD" | grep -qE 'issues/[0-9]+/comments' || exit 0
+
+# ② 純讀取一律放行。同 ticket-api-bypass-guard 的理由：只認一個裸字就夠——
+#    ①已經確定這是留言端點，讀取的指令不會出現 POST，而且沒有跳脫的破口。
+printf '%s' "$CMD" | grep -qw 'POST' || exit 0
+
+# ③ 內文有沒有身份欄。只問「在不在」，不問「寫什麼」。
+printf '%s' "$CMD" | grep -q '【身份】' && exit 0
+
+cat >&2 <<'MSG'
+🚫 貼到票上的留言，第一行要表明身份（leo 2026-08-27：「**subagent 回覆時要表明身份**」）
+
+你正在用 Gitea API 直接貼留言，而內文裡找不到【身份】。
+
+第一行照這個寫（角色三選一：總管／subagent／leo）：
+
+    【身份】subagent／inkstone/ISEP／feat/my-branch
+    【身份】總管／inkstone/InkStoneCo／-
+
+**這條管所有人，不是只管 subagent。** 總管寫在票上的東西同樣要標——
+實害（2026-08-27）：多條線並行時票上看不出誰寫的，
+**總管寫的診斷被當成 subagent 的結論，而其中一則是錯的**。
+
+── 走正門比較省事 ─────────────────────────────────────────────
+    scripts/ticket say <owner/repo#N> -F <內文檔>
+  它會回一行「定址」，那串就是下次派工要寫進【工單】的東西。
+
+規約全文：docs/governance/dispatch-and-reply-format.md §3
+真的有例外 → 指令裡加 reply-identity-ok（會留在指令歷史上）。
+MSG
+exit 2

hooks/roster-guard.sh

@@ -0,0 +1,186 @@
+#!/usr/bin/env bash
+# 管什麼: 派工（帶【工單】的 Task／Agent）沒有指名工人、或指了名單上沒有的名字 → 擋；
+#        指對了就把那位工人的檔案原文注入給它（它是誰、先讀什麼、紅線）。
+# 為什麼: 派工派給「一個 agent」＝票上看不出這件事是誰做的，也沒有任何連續性。
+# 誤觸時怎麼關: `python3 scripts/roster list` 挑一個名字放進 subagent_type；
+#        真的沒有合適的人 → touch /tmp/.roster-ok-<session_id> 放行一次（用完即丟）。
+#
+# roster-guard.sh — PreToolUse（Task｜Agent）：**工人要有名字**（inkstone/ISEP#86）
+#
+# ━━ 來由（leo，inkstone/ISEP#86）━━━━━━━━━━━━━━━━━━━━━━━━━━━
+#   「身為派工的人，我要工人有名字，我才知道票上這件事到底是誰做的。」
+#
+#   實查（開票當日）：`/root/.claude/agents/` 不存在、`InkStoneCo/.claude/agents/`
+#   只有一支內建的說明用 agent ⇒ 派工派給的是**沒有名字的臨時工**。後果三件：
+#     · 票上只看得到「有個 agent 做了」，看不出是誰
+#     · 每次派工都要重新交代它是誰、該讀什麼——**而派工單只准寫票號**
+#       （`dispatch-format-guard.sh`，ISEP v0.5.0）
+#     · 同一個 repo 這次派的跟上次派的沒有任何連續性
+#
+# ━━ 這支跟 dispatch-format-guard.sh 的分界（兩支不會同時開口）━━━━━━━━
+#   dispatch-format-guard 管**派工單的內文**（只准有【工單】那一行）。
+#   本支管**派給誰**——那是 `Task` 的 `subagent_type` 欄，**不在內文裡**。
+#   ⇒ 兩者正交：加上這道閘，派工單格式一個字都不用改。
+#
+#   邊界同 dispatch-format-guard：派工單裡**沒有**【工單】時本閘閉嘴，
+#   那是 `no-ticket-no-dispatch.sh` 的地盤（沒票的東西還輪不到談派給誰）。
+#
+# ━━ 為什麼過得了「封動作不封文字」的檢驗（leo 2026-08-17）━━━━━━━━━
+#   判準是「這個名字**在不在名單裡**」——一次字面比對，方向是**放行**
+#   （在名單裡 ⇒ 放行）。沒有任何「命中某個詞就違規」的比對。
+#   名字是唯一識別碼、集合有限且可枚舉，正是 v0.11.0 那支閘用的形狀。
+#
+# ━━ 這支同時做兩件事 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+#   ① **擋**：沒指名／指了不存在的名字 → exit 2，並把整份名單印出來
+#   ② **注入**：指對了 → exit 0，把那位工人的檔案原文送給它
+#      （慣例同 dispatch-format-guard.sh 的共通規定注入）
+#      ⇒ 「你是誰、開工前先讀什麼、你的紅線」**不必寫進派工單**，機器每次都補。
+#        這正是 ISEP#86 說的那件共通規定補不了的事——它每個工人都不一樣。
+#
+# ━━ fail-open 的界線 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+#   名單目錄讀不到／解析器掛了 → **放行**（回到「沒有這支閘」的狀態）。
+#   一份讀不到的名單不該讓整台機器派不了工。
+#
+# 逃生口（留痕、用完即丟）：touch /tmp/.roster-ok-<session_id>
+#
+# 測試：hooks/tests/roster-guard.test.sh（離線、不打網路、不花錢）
+set -u
+
+INPUT="$(cat)"
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
+
+FACTS="$(printf '%s' "$INPUT" | ROSTER_LIB="$HERE/lib" python3 -c '
+import json, os, sys
+sys.path.insert(0, os.environ.get("ROSTER_LIB", ""))
+try:
+    import roster
+except Exception:
+    print(json.dumps({"status": "skip", "why": "roster lib 不在"})); raise SystemExit
+try:
+    d = json.load(sys.stdin)
+except Exception:
+    print(json.dumps({"status": "skip", "why": "payload 不是 JSON"})); raise SystemExit
+
+ti = d.get("tool_input") or {}
+prompt = ti.get("prompt") or ti.get("message") or ""
+# 邊界：沒有【工單】 ⇒ no-ticket-no-dispatch 的地盤，本閘閉嘴
+if "【工單】" not in prompt:
+    print(json.dumps({"status": "skip", "why": "沒有【工單】"})); raise SystemExit
+
+# 名字住在哪一欄：subagent_type 是 Task 的原生欄位；其餘是別的 surface 的別名。
+picked = ""
+for k in ("subagent_type", "agent_type", "agent", "persona", "name"):
+    v = ti.get(k)
+    if isinstance(v, str) and v.strip():
+        picked = v.strip(); break
+
+ws = roster.load()
+if not ws:
+    print(json.dumps({"status": "skip", "why": "名單是空的"})); raise SystemExit
+
+hit = roster.find(picked) if picked else None
+print(json.dumps({
+    "status": "ok",
+    "picked": picked,
+    "known": bool(hit),
+    "session_id": d.get("session_id") or "",
+    "roster": [roster.one_liner(w) for w in ws],
+    "card": (hit or {}).get("body", ""),
+    "card_name": (hit or {}).get("name", ""),
+    "card_repo": (hit or {}).get("repo", ""),
+}, ensure_ascii=False))
+' 2>/dev/null)"
+[ -n "$FACTS" ] || exit 0     # 解析器掛了 → fail-open
+
+get() { printf '%s' "$FACTS" | python3 -c "
+import sys, json
+try: print(json.load(sys.stdin).get('$1', '') or '')
+except Exception: print('')
+" 2>/dev/null; }
+
+[ "$(get status)" = "ok" ] || exit 0
+
+SESSION="$(get session_id)"
+KNOWN="$(get known)"
+
+if [ "$KNOWN" != "True" ]; then
+  # 明示豁免（留痕用，用掉就消失，不是永久開關）
+  if [ -n "$SESSION" ] && [ -f "/tmp/.roster-ok-$SESSION" ]; then
+    rm -f "/tmp/.roster-ok-$SESSION"
+    exit 0
+  fi
+  PICKED="$(get picked)"
+  ROSTER_TEXT="$(printf '%s' "$FACTS" | python3 -c '
+import sys, json
+try: rows = json.load(sys.stdin).get("roster", [])
+except Exception: rows = []
+print("\n".join("  " + r for r in rows))
+' 2>/dev/null)"
+
+  MSG="$(cat <<'EOF'
+🚫 __WHO__（inkstone/ISEP#86：「**我要工人有名字，我才知道票上這件事到底是誰做的**」）
+
+━━ 名單上有這幾位 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+__ROSTER__
+
+  看某一位的全文：python3 scripts/roster show <名字>
+  這個 repo 該派給誰：python3 scripts/roster which <owner/repo>
+
+━━ 怎麼派 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  把名字放進 Task 的 `subagent_type`。**派工單本身不用改**——
+  它仍然只有一行【工單】（`dispatch-format-guard.sh` 沒有變）。
+  指對名字之後，本閘會把那位工人的檔案原文注入給它：
+  它是誰、開工前先讀什麼、它的紅線是什麼。
+  ⇒ **這些不必寫進派工單**，也不可能寫進共通規定（每個工人都不一樣）。
+
+━━ 名單上真的沒有合適的人 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  加一個工人 ＝ 在 `agents/` 加一個 `.md`（照既有檔案的四段：
+  frontmatter 的 name／description、`**負責 repo**`、`## 開工前先讀`、`## 紅線`）。
+  **不必改任何 hook**——名單是資料，閘讀的是那個目錄。
+  規約：docs/governance/worker-roster.md
+
+真的有例外 → `touch /tmp/.roster-ok-__SESSION__` 後重送（用掉就消失，會留在指令歷史上）。
+EOF
+)"
+  if [ -z "$PICKED" ]; then
+    WHO="這次派工**沒有指名工人**（\`subagent_type\` 是空的）"
+  else
+    WHO="名單上**沒有「$PICKED」這個人**"
+  fi
+  RG_MSG="$MSG" RG_WHO="$WHO" RG_ROSTER="$ROSTER_TEXT" RG_SESSION="$SESSION" python3 -c '
+import os, sys
+sys.stderr.write(
+    os.environ["RG_MSG"]
+      .replace("__WHO__", os.environ.get("RG_WHO", ""))
+      .replace("__ROSTER__", os.environ.get("RG_ROSTER", ""))
+      .replace("__SESSION__", os.environ.get("RG_SESSION", "") or "<session_id>")
+    + "\n"
+)
+'
+  exit 2
+fi
+
+# ── 指名正確 → 把那位工人的檔案原文注入 ──────────────────────────────
+printf '%s' "$FACTS" | python3 -c '
+import json, sys
+try:
+    d = json.load(sys.stdin)
+except Exception:
+    raise SystemExit
+body = (d.get("card") or "").strip()
+if not body:
+    raise SystemExit
+print(json.dumps({
+    "hookSpecificOutput": {
+        "hookEventName": "PreToolUse",
+        "additionalContext":
+            "【自動注入：你是誰】%s（負責 %s）\n"
+            "（來源 agents/%s.md——派工單只給票號是刻意的，"
+            "「你是誰、先讀什麼、你的紅線」由機器補，不必寫進派工單）\n\n%s"
+            % (d.get("card_name", ""), d.get("card_repo", "") or "跨 repo",
+               d.get("card_name", ""), body),
+    }
+}, ensure_ascii=False))
+' 2>/dev/null
+
+exit 0

hooks/search-is-not-proof-guard.sh

@@ -0,0 +1,198 @@
+#!/usr/bin/env bash
+# 管什麼: 把 kbdb_search 掉出來的原始值當證據，貼進票或派工單裡，而那筆資料從沒走過產品檢索路徑時，擋一次。
+# 為什麼: 2026-08-27 inkstone/Arcrun#167 comment 4865——總管用 kbdb_search 的輸出判定「兩個缺陷都還在」，退回一張已經做完、有測試、東西在 main 的票，還重派一條線。半小時後自己更正（comment 4877）：那條路本來就不會有那個欄位。
+# 誤觸時怎麼關: 指令或派工單裡加 `search-is-evidence: <一句理由>` 重送（留痕）；同一 session 只擋一次。
+#
+# search-is-not-proof-guard.sh — 你判斷的那條路，和你走的那條路，是同一條嗎？
+#                                （PreToolUse: Bash / Agent / Task）
+#
+# ── 這一格為什麼原本沒有閘（inkstone/ISEP#30 comment 4879 的原話）──────
+#   「所有現有的閘防的是**危險動作**：推 main、推 prod、寫金鑰、打真庫、開重複票。
+#     而『用 kbdb_search 去證明某條路壞了』——不危險、不寫檔、不推 main。
+#     **它只是錯的方法。** ⇒ 閘的座標系裡沒有這一維。」
+#
+# ── 判準：出處，不是措辭 ────────────────────────────────────────────
+#   🔴 驗收條件第 4 條寫死：**不要用關鍵字比對我的措辭**。
+#      leo 2026-08-17 已經證偽過文字層——那天 **8 次誤攔、0 次正確攔截**，
+#      而且方向穩定：紅線寫得越細，命中關鍵字的機率越高 ⇒ **在懲罰謹慎**。
+#
+#   所以這支一個字都不看。它只問一件機械問題：
+#
+#       你正要送出去的這份東西裡，有沒有一個**只在 kbdb_search 的回應裡出現過**
+#       的值（entry id / `kb://` 來源位址）？而那筆資料，這個 session 從來沒有
+#       用產品檢索路徑（graph / wiki 內容）拿過？
+#
+#   ⇒ 兩個條件都成立，才代表「我在拿輔助工具的輸出，當產品檢索路徑的證據」。
+#     這是**資料的出處**，不是我的用詞。值跟動作一樣有限且可枚舉。
+#
+# ── D81：哪條才是產品檢索路徑（leo 2026-08-13 親自裁定）──────────────
+#   `system-dev/docs/2-architecture/decisions/D81-vector-only-for-entity-normalize.md`
+#     「你會用 **graph 找到該找的東西**，用 **LLM wiki 去拉到對的內容**，
+#       所以全量向量化沒意義⋯⋯**向量的目的是用來協助把 entities normalize**。」
+#   ⇒ 主路徑＝graph ＋ wiki 內容；向量／關鍵字搜尋＝**輔助**。
+#
+#   🔴 **這支不會讓 `kbdb_search` 變難用。** 它是合法的基本盤工具，
+#     subagent-wiki-guard.sh 還明文要求「查任何東西之前先用它查 wiki」。
+#     查一筆資料在不在、找 record_id、翻 wiki 找判例——**全部照放**，
+#     因為那些用途不會把 entry id 貼進票裡當證據。
+#
+# ── 真跡（本閘的規格，Arcrun#167 comment 4865 原文照貼）───────────────
+#     $ kbdb_search(q="小果 AFTEE 詐貸")   → count 5
+#     { "id": "e_b77f23a1-b467-4aa4-883c-58a051ab8e66", … }
+#     "metadata_json": "{\"source\":\"kb://小果被AFTEE詐貸.pdf#8\", … }"
+#   ⇒ 那則退回裡**同時**有 entry id 和 `kb://` 位址，兩類指紋都命中，
+#     而整個 session 沒有任何一次 graph／wiki 內容的呼叫。
+#   ⇒ 半小時後 comment 4877：「上一則退回是錯的；真正的缺口是那支工具 MCP 沒有」。
+#     **那半小時裡，一條線被停掉、一張做完的票被退回、一份工單被重寫。**
+#
+# ── 誠實邊界（不補，補了就變成文字層）────────────────────────────────
+#   1. **改寫過的證據抓不到**——「我看到出處還是 `../` 開頭」這種轉述沒有指紋。
+#      但房規本來就要求貼原始輸出（規則四之一、派工鐵律之三），
+#      而貼了原始輸出就會被抓到。**不貼的那條路由別的閘管，不歸這支。**
+#   2. **只認 KBDB 這一族**。別的「錯的驗證路徑」（拿 portal 畫面當 MCP 的證據——
+#      08-27 同一天的另一半）這支看不到，因為那不經過工具呼叫。
+#   3. 想不出乾淨判準的地方就留白，不硬做。
+#      `.claude/branch-holds.md` 檔頭那句：**永遠在響的警報，等於訓練人忽略這個警報。**
+set -uo pipefail
+
+INPUT=$(cat)
+
+SID=$(printf '%s' "$INPUT" | python3 -c "
+import sys, json
+try: print(json.load(sys.stdin).get('session_id','') or 'nosid')
+except Exception: print('nosid')
+" 2>/dev/null || echo nosid)
+
+SEARCH="/tmp/.kbdb-evidence-search-$SID"
+# 這個 session 從來沒用搜尋拿過任何東西 ⇒ 這支沒有立場說話，最便宜的出口放在最前面
+[ -s "$SEARCH" ] || exit 0
+
+WARNED="/tmp/.search-is-not-proof-warned-$SID"
+[ -f "$WARNED" ] && exit 0          # 同一 session 只擋一次，不鬼打牆
+
+# 🔴 env 要 export，不能掛在 `printf` 前面——那樣只餵到 printf，python3 收不到
+export SEARCH_FILE="$SEARCH"
+export WALKED_FILE="/tmp/.kbdb-evidence-walked-$SID"
+
+HIT=$(printf '%s' "$INPUT" | python3 -c '
+import json, os, re, sys
+
+try:
+    d = json.load(sys.stdin)
+except Exception:
+    raise SystemExit                       # 讀不到 payload 就不擋（那不是使用者的錯）
+
+tool = d.get("tool_name") or ""
+ti   = d.get("tool_input") or {}
+if not isinstance(ti, dict):
+    raise SystemExit
+
+# ── ① 這是不是一個「往外送」的動作？──────────────────────────────
+#   往外送 ＝ 這份文字會變成別人的前提：貼進票、關票、記裁決、或發包給另一條線。
+#   只在自己腦袋裡看搜尋結果，永遠不會走到這裡。
+body, kind = "", ""
+
+if tool in ("Agent", "Task"):
+    body = ti.get("prompt") or ""
+    kind = "派工單"
+elif tool == "Bash":
+    cmd = ti.get("command") or ""
+    if not cmd:
+        raise SystemExit
+    outward = False
+    if re.search(r"\bticket\s+(say|close|decide|new|subtask|handback)\b", cmd):
+        outward = True
+    if re.search(r"issues/\d+(/comments)?\b", cmd) and re.search(r"\b(POST|PATCH)\b", cmd):
+        outward = True
+    if not outward:
+        raise SystemExit
+    body, kind = cmd, "票上的留言"
+    # 內文常常放在 -F <檔> 裡，指令本身看不到 ⇒ 跟 comment-carries-task-guard 同一招
+    m = re.search(r"[\s](?:-F|--file)[\s]+(\S+)", cmd)
+    if m and os.path.isfile(m.group(1)):
+        try:
+            body += "\n" + open(m.group(1), encoding="utf-8", errors="replace").read()
+        except Exception:
+            pass
+else:
+    raise SystemExit
+
+if not body:
+    raise SystemExit
+
+# 逃生口（留痕：它會留在指令歷史／派工單上）
+if "search-is-evidence:" in body:
+    raise SystemExit
+
+def load(p):
+    try:
+        with open(p, encoding="utf-8") as f:
+            return {ln.strip() for ln in f if ln.strip()}
+    except Exception:
+        return set()
+
+searched = load(os.environ["SEARCH_FILE"])
+walked   = load(os.environ["WALKED_FILE"])
+
+# ── ② 只在搜尋裡出現過、真路徑沒走過的那些值 ─────────────────────
+#   走過真路徑的（graph / wiki 內容 / query）從候選裡扣掉——
+#   **搜完再去走一次真路徑，本來就是對的做法，不該被罰。**
+only_search = searched - walked
+if not only_search:
+    raise SystemExit
+
+# ── ③ 這些值有沒有真的被貼進要送出去的那份東西裡 ──────────────────
+hits = sorted(v for v in only_search if v in body)
+if not hits:
+    raise SystemExit
+
+print(kind + "\t" + "\t".join(hits[:3]))
+' 2>/dev/null) || exit 0
+
+[ -n "${HIT:-}" ] || exit 0
+
+KIND=$(printf '%s' "$HIT" | cut -f1)
+VALS=$(printf '%s' "$HIT" | cut -f2- | tr '\t' '\n' | sed 's/^/    /')
+
+date +%s > "$WARNED"
+
+cat >&2 <<EOF
+🧭 你正要把 **kbdb_search 掉出來的原始值**，當成證據送進${KIND}裡。
+
+被貼過去的值（這個 session 只在 kbdb_search 的回應裡出現過）：
+$VALS
+
+而這個 session **沒有用產品檢索路徑拿過這幾筆**——
+graph（\`kbdb_graph_neighbors\`）／wiki 內容（\`kbdb_get_record\`）／\`kbdb_query\` 一次都沒有。
+
+【D81｜leo 2026-08-13 親自裁定】
+  「你會用 **graph 找到該找的東西**，用 **LLM wiki 去拉到對的內容**⋯⋯
+    **向量的目的是用來協助把 entities normalize**。」
+  ⇒ 主路徑＝graph ＋ wiki 內容。**搜尋是輔助，不是產品檢索路徑。**
+  🔴 這不是說 \`kbdb_search\` 不能用——它是合法的基本盤工具，查 wiki 本來就該用它。
+     不能做的是**拿它的輸出，去斷定產品檢索那條路是好是壞**。
+
+【它花掉過多少（inkstone/Arcrun#167，2026-08-27）】
+  12:34  comment 4865  用 kbdb_search 的輸出判定「兩個缺陷都還在」→ 退回一張
+                       **已經做完、有測試、東西在 main** 的票，並重派一條線
+  13:08  comment 4877  總管自己更正：「上一則退回是錯的；
+                       真正的缺口是**那支工具 MCP 根本沒有**」
+  ⇒ 真相是那次修的是另一支工具的欄位，\`kbdb_search\` 本來就不會有它。
+    **在用一條錯的路，反覆確認一件錯的事**——而真正的缺口一直沒被看到。
+
+【送出前先回答這一題】
+  **你要下結論的那條路，和你剛才實際走的那條路，是同一條嗎？**
+  （08-27 那則退回自己就寫著：「我當時驗的是 portal 的來源顯示，
+    但這張票的驗收條件是 MCP client 問『原文在哪』。**兩條不同的路。**」）
+
+【出路，挑一條】
+  ① 走一次真的那條路再下結論 —— \`kbdb_graph_neighbors\` / \`kbdb_get_record\` / \`kbdb_query\`
+     走過之後同一筆資料就不再命中本閘（走過的會從候選裡扣掉）。
+  ② **那條路的工具根本不存在** ⇒ **那個才是你要回報的東西**（4877 就是這樣收的）。
+     照實寫「產品檢索路徑上少一支工具」，不要改用搜尋去補位再下判斷。
+  ③ 真的只是引用一筆資料、不是在斷定檢索好壞
+     ⇒ 加 \`search-is-evidence: <一句理由>\` 重送（留痕）。
+
+同一 session 只擋這一次。
+EOF
+exit 2

hooks/session-start-recall.sh

@@ -144,6 +144,33 @@ if [ -f "$MISTAKES_FILE" ] && grep -q 'MISTAKE' "$MISTAKES_FILE" 2>/dev/null; th
   echo ""
 fi
 
+# ── push 6：還債線今天撈過了沒（inkstone/ISEP#83）──────────────────────────
+# 🔴 **這裡不打網路、不撈票**——只看狀態檔的日期，講一句話。
+#    要真的撈是人（或這個 session）自己跑那一行；SessionStart 只負責讓它被想起來。
+#    「每天都在追新的，所以要用 Routine 去消化舊的」（leo 2026-08-27）——
+#    沒有這一句，沒掛 milestone 的那 170 多張永遠不會被任何人拿起來。
+DEBT_STATE="${ISEP_DEBT_STATE_DIR:-$HOME/.claude/isep-debt}/claimed.json"
+DEBT_LINE=$(python3 - "$DEBT_STATE" <<'PY' 2>/dev/null || true
+import json, sys, datetime
+try:
+    d = json.load(open(sys.argv[1]))
+except Exception:
+    d = {}
+last = (d.get("last_run") or "")[:10]
+today = datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%d")
+n = len(d.get("claims") or {})
+if last == today:
+    print(f"✅ 今天撈過了（手上領著 {n} 張）")
+else:
+    print("🔴 今天還沒撈過還債清單" + (f"（手上還領著 {n} 張沒關）" if n else ""))
+PY
+)
+echo "────────────────────────────────────────────────"
+echo "🧾 還債線（inkstone/ISEP#83）：${DEBT_LINE:-🔴 今天還沒撈過還債清單}"
+echo "   撈一次 ＝ python3 ${CLAUDE_PLUGIN_ROOT:-.}/scripts/debt-worklist list"
+echo "   它排的是「沒掛 milestone 的舊票」——掛著的歸緊急線（milestone）管，兩條線不互搶。"
+echo ""
+
 echo "────────────────────────────────────────────────"
 echo "以上是 index，不是內容——它只讓你知道「有這件事、去哪裡找」。"
 echo "要完整脈絡（decisions / mistakes / SDD）→ 執行 /wiki-recall"

hooks/stage-before-prod-guard.sh

@@ -159,6 +159,18 @@ fi
 #    ⇒ 改成兩者都認：內容有數字就用內容，沒有就用 mtime（`touch` 因此真的有效）。
 #
 # 另外認 leo 親手蓋的章（scripts/stage-ok.sh 產生），那是比我自評更強的訊號。
+# 🔴 戳記的 mtime 一律走 lib/mtime.sh：舊寫法（`stat -f %m || stat -c %Y`）在 Linux 上
+#   **永遠算不出數字**（GNU 的 `-f` 是「檔案系統資訊」，它一邊回非零一邊吐一整段文字，
+#   於是後面接上的秒數被那段垃圾污染）⇒ 這支閘給總管的逃生口在雲端整個焊死，
+#   而閘不會告訴他門是壞的（inkstone/ISEP#90 ④，全文見 hooks/lib/mtime.sh）。
+#   lib 不在時就地補一份同順序的定義——這道門不能因為少一個檔案就再關上一次。
+. "$(dirname "$0")/lib/mtime.sh" 2>/dev/null || file_mtime() {
+  _fm=$(stat -c %Y "$1" 2>/dev/null || true)
+  case "${_fm:-}" in ''|*[!0-9]*) _fm=$(stat -f %m "$1" 2>/dev/null || true) ;; esac
+  case "${_fm:-}" in ''|*[!0-9]*) _fm=0 ;; esac
+  printf '%s' "$_fm"
+}
+
 for STAMP in /tmp/.stage-ok-by-leo /tmp/.stage-verified; do
   [ -f "$STAMP" ] || continue
   now=$(date +%s)
@@ -172,7 +184,7 @@ for STAMP in /tmp/.stage-ok-by-leo /tmp/.stage-verified; do
   #    抽數字會得到天文數字 ⇒ `now - t` 是**負數** ⇒ `< 21600` 成立 ⇒ **永遠放行**。
   #    ⇒ 只有「不晚於現在」的時間戳才算數；不合理就退回 mtime，別當成通過。
   if [ "$t" -eq 0 ] || [ "$t" -gt "$now" ]; then
-    t=$(stat -f %m "$STAMP" 2>/dev/null || stat -c %Y "$STAMP" 2>/dev/null || echo 0)
+    t=$(file_mtime "$STAMP")
   fi
   [ "$t" -gt 0 ] && [ "$((now - t))" -lt 21600 ] && exit 0   # 6 小時內驗過 stage → 放行
 done
@@ -196,7 +208,8 @@ cat >&2 <<'EOF'
 ⚠️ 身分：leo 2026-07-25 令「測試一律用 youlin，別拿 leo21c 當探針（會製造假信號）」
    ⇒ 部署前先 `acr whoami` 確認身分。
 
-驗過了 ⇒ `touch /tmp/.stage-verified` 後重送，並在回覆裡**貼 stage 的實測輸出**
+驗過了 ⇒ `bash "$CLAUDE_PLUGIN_ROOT/scripts/gate-ok" stage-verified` 後重送
+（等價：`touch /tmp/.stage-verified`），並在回覆裡**貼 stage 的實測輸出**
 （「我測過了」不算——貼指令與它吐出來的東西）。
 EOF
 exit 2

hooks/subagent-claim-worksheet.sh

@@ -1,196 +0,0 @@
-#!/usr/bin/env bash
-# subagent-claim-worksheet.sh — subagent 交回時，把它的宣稱抽成一張待驗工作單
-#                               （SubagentStop；leo 2026-08-18 立）
-#
-# ── leo 的原話（本閘的規格）─────────────────────────────────────────
-#   「你如何確認說的都是真的？subagent 做完事，你應該在 SubagentStop 掛動作，
-#    **它說可以，你去驗證；它說不行，你想辦法，不行再報告**，
-#    這解決一半的未查證。你常常直接把 subagent 說的不經查證就回報，
-#    **它視野小，它說的你有更多資訊去檢驗**。」
-#
-# ── 為什麼是「工作單檔案」而不是提醒文字 ─────────────────────────────
-# leo 2026-08-17 診斷過：文字層封路是打不贏的軍火競賽，要封**動作**。
-# 所以這支不勸、也不偵測我的措辭——它**在磁碟上放一個必須被處理掉的東西**。
-# 配套的 Stop 閘（claim-verify-police.sh）看的是「那個檔還在不在」，
-# 而檔案只能被動作消滅，不能被文案消滅。
-#
-# ── 兩類宣稱，處理方式不同（leo 的規格就是這兩條）──────────────────
-#   ✅ 它說可以 → 我去驗證（我有跨 repo 視野、有 token、有瀏覽器，它沒有）
-#   ⛔ 它說不行 → 我想辦法（換路徑／查憑證地圖／自己撞一次），真的不行才報告 leo
-#
-# ⚠️ 這裡的關鍵詞比對只用來**列出候選**，不用來判定對錯——
-#    列多了我自己劃掉（要寫理由），列少了不影響我另外查。
-#    ⇒ 它的失敗模式是「多列幾條」，不是「擋錯事」。
-#
-# ── 留痕（InkStoneCo#48：36 支閘只有 2 支記錄自己做了什麼）─────────
-INPUT=$(cat)
-DIR="$CLAUDE_PROJECT_DIR/.claude/pending-verification"
-LOG="$CLAUDE_PROJECT_DIR/.claude/hooks/subagent-claim-worksheet.log"
-mkdir -p "$DIR" 2>/dev/null
-
-OUT=$(printf '%s' "$INPUT" | DIR="$DIR" python3 -c '
-import json, os, re, sys, hashlib
-
-try:
-    d = json.load(sys.stdin)
-except Exception:
-    print("SKIP:bad-json"); raise SystemExit
-
-tp = d.get("transcript_path") or ""
-if not tp or not os.path.exists(tp):
-    print("SKIP:no-transcript"); raise SystemExit
-
-# ── 取 subagent 的交件 ────────────────────────────────────────────
-# 🔴 2026-08-18 首次實跑就抓到自己的缺陷：`SubagentStop` 給的 `transcript_path`
-#    指向**主對話**，不是子代理的紀錄 ⇒ 原本「取最後一則 assistant 訊息」
-#    抓到的是**總管自己寫的句子**，這支 hook 當場退化成它要避免的「文字層自咬」。
-#
-#    正解：子代理的交件是以 `<task-notification>…<result>…</result>` 的形式
-#    進到主對話的 **user 訊息**裡。只認那個區塊，其餘一律不看。
-#    ⇒ 判準回到「這段話是誰說的」，而不是「這段話長什麼樣」。
-last = ""
-try:
-    blob = []
-    with open(tp, "r", encoding="utf-8", errors="replace") as f:
-        for line in f:
-            line = line.strip()
-            if not line:
-                continue
-            try:
-                ev = json.loads(line)
-            except Exception:
-                continue
-            msg = ev.get("message") or {}
-            if msg.get("role") != "user":
-                continue
-            parts = msg.get("content")
-            if isinstance(parts, str):
-                txt = parts
-            elif isinstance(parts, list):
-                txt = "".join(p.get("text", "") for p in parts
-                              if isinstance(p, dict) and p.get("type") == "text")
-            else:
-                txt = ""
-            if "<task-notification>" in txt:
-                blob.append(txt)
-    if blob:
-        m = re.search(r"<result>(.*?)</result>", blob[-1], re.S)
-        last = m.group(1) if m else ""
-except Exception:
-    print("SKIP:read-fail"); raise SystemExit
-
-if not last.strip():
-    print("SKIP:no-subagent-report"); raise SystemExit
-
-if not last.strip():
-    print("SKIP:empty-report"); raise SystemExit
-
-# ── 抽候選宣稱 ──────────────────────────────────────────────────
-# 成功類：它說某件事成立／做好了 ⇒ 我去驗
-OK = ("驗過", "測過", "通過", "全綠", "已部署", "部署完成", "可以用", "成立",
-      "完成", "修好", "已推", "已併", "沒問題", "正常", "一致", "對上",
-      "✅", "green", "passed", "verified", "deployed")
-# 阻擋類：它說做不到 ⇒ 我想辦法，不行才報告 leo
-NG = ("無法", "不行", "做不到", "被擋", "擋下", "失敗", "不存在", "找不到",
-      "沒有權限", "權限不足", "需要 leo", "要 leo", "請總管", "交給你",
-      "❌", "blocked", "denied", "cannot", "failed", "not found")
-
-def lines_of(text):
-    out = []
-    for raw in text.split("\n"):
-        s = raw.strip().lstrip("-*#>| ").strip()
-        if len(s) < 8 or len(s) > 220:
-            continue
-        out.append(s)
-    return out
-
-ls = lines_of(last)
-ok_hits, ng_hits = [], []
-for s in ls:
-    low = s.lower()
-    if any(k in s or k.lower() in low for k in NG):
-        ng_hits.append(s)
-    elif any(k in s or k.lower() in low for k in OK):
-        ok_hits.append(s)
-
-# 兩類都沒有 ⇒ 它交的是純資料／純提問，沒有事實宣稱要驗
-if not ok_hits and not ng_hits:
-    print("SKIP:no-claims"); raise SystemExit
-
-sid = (d.get("session_id") or "nosid")[:8]
-aid = (d.get("agent_id") or d.get("subagent_id") or "")[:10]
-# 🔴 2026-08-21：stamp 原本雜湊「交件路徑」⇒ 同樣的宣稱每回合生一個新檔名，
-# 而且不知道總管已經驗過了。實際發作：同兩條 sdd-guard 宣稱連生四張單
-# （1c97d461／fcb285dc／256de849／394b97ae），驗掉一張下一回合又冒一張。
-# ⇒ 改成雜湊**宣稱內容本身**：同樣的宣稱＝同一個檔名 ⇒ 驗過就不再冒出來。
-_claims = sorted(set(str(x) for x in (ok_hits + ng_hits)))
-# 🔴 空清單就退回舊行為 —— 但那等於這支閘沒抓到任何宣稱，本來就會 SKIP，
-#    所以這個 fallback 實際上不會被用到；留著只是不讓 stamp 變成空字串的雜湊。
-_basis = "\n".join(_claims) if _claims else (tp + sid + aid)
-stamp = hashlib.sha1(_basis.encode()).hexdigest()[:8]
-_name = "claims-%s-%s.md" % (sid, stamp)
-path = os.path.join(os.environ["DIR"], _name)
-
-# 已經驗過並移進 verified/ 的，不要再生一次。
-if os.path.exists(os.path.join(os.environ["DIR"], "verified", _name)):
-    print("SKIP:already-verified"); raise SystemExit
-
-def block(title, items, howto, cap):
-    if not items:
-        return ""
-    body = "\n".join("- [ ] %s" % x for x in items[:cap])
-    more = ""
-    if len(items) > cap:
-        more = "\n- [ ] （還有 %d 條同類，讀原始交件）" % (len(items) - cap)
-    return "## %s\n\n%s\n%s%s\n\n" % (title, howto, body, more)
-
-doc = []
-doc.append("# 待驗工作單（subagent 交回的宣稱）\n")
-doc.append("> leo 2026-08-18：「**它視野小，它說的你有更多資訊去檢驗。**」\n")
-doc.append("> 交件全文在：`%s`\n" % tp)
-doc.append("\n🔴 **這張單子只能用動作消滅，不能用文字消滅。**")
-doc.append("逐條處理完之後，把本檔**刪掉或移走**；在那之前 Stop 閘會擋。\n\n")
-doc.append(block(
-    "✅ 它說「可以」——我要自己驗一次",
-    ok_hits,
-    "判準：**我不採信，我自己跑一次**。它只看得到自己那個 repo 與自己那次呼叫；\n"
-    "我有跨 repo 視野、有 token、有瀏覽器。驗完把證據貼進回覆或票裡。\n",
-    12))
-doc.append(block(
-    "⛔ 它說「不行」——我先想辦法，真的不行才報告 leo",
-    ng_hits,
-    "判準：**它的「不存在／被擋」往往只是「我這裡看不到」**。\n"
-    "先做三件：① 查憑證地圖／wiki ② 換一條路徑 ③ **自己真的撞一次並貼出拒絕原文**。\n"
-    "🔴 沒撞過就不准說「我被 X 擋住」——那是虛構的閘（2026-08-18 已第五次）。\n"
-    "真的是人閘 ⇒ 走三件機械動作：`Human` 標籤 ＋ 指派給 Leo ＋ **一張它自己的票**，\n"
-    "不是在別張票的留言裡寫一段話（leo 08-18：「不是默默塞進錯的地方」）。\n",
-    12))
-
-with open(path, "w", encoding="utf-8") as f:
-    f.write("".join(doc))
-
-print("WROTE:%s:ok=%d:ng=%d" % (os.path.basename(path), len(ok_hits), len(ng_hits)))
-' 2>/dev/null)
-
-printf '%s\t%s\n' "$(date +%FT%T)" "${OUT:-SKIP:no-output}" >> "$LOG" 2>/dev/null
-
-case "$OUT" in
-  WROTE:*)
-    F=$(printf '%s' "$OUT" | cut -d: -f2)
-    N=$(printf '%s' "$OUT" | sed 's/.*ok=\([0-9]*\):ng=\([0-9]*\)/\1 成功宣稱、\2 阻擋宣稱/')
-    cat <<EOF
-🔍 交件查證：subagent 交回了 $N，已列成待驗工作單。
-
-【leo 2026-08-18 的規格】
-  「它說可以，你去驗證；它說不行，你想辦法，不行再報告。
-   **它視野小，它說的你有更多資訊去檢驗。**」
-
-工作單：.claude/pending-verification/$F
-
-🔴 **不要直接把它說的轉給 leo。** 逐條處理完，把那個檔刪掉；在那之前 Stop 閘會擋一次。
-   · 它說「可以」→ 你自己跑一次（測試／curl／瀏覽器／git，看那條宣稱是什麼）
-   · 它說「不行」→ 先換路徑、查憑證地圖；**要說「被擋」就得自己撞一次並貼原文**
-EOF
-    ;;
-esac
-exit 0

hooks/tests/countdown-guard.test.sh

@@ -0,0 +1,229 @@
+#!/usr/bin/env bash
+# countdown-guard.sh 的迴歸測試（inkstone/ISEP#63 → comment 5106）
+#
+# 三個方向都要有證據，對應票上那三條驗收：
+#   A 群「注入」—— 新 session 什麼都沒交代，那一行就在；數字對得上；連續呼叫遞增
+#   B 群「查核該擋」—— 回覆沒戴倒數 ⇒ 擋一次，且把算好的那一行印出來給它抄
+#   C 群「查核不該擋」—— 誤攔比漏擋更該修：純工具回合／子 session／已提醒過／
+#                       transcript 讀不到，全部放行
+#
+# 用法：hooks/tests/countdown-guard.test.sh [hooks/countdown-guard.sh 的路徑]
+# 🔴 全程離線：時鐘用 ISEP_COUNTDOWN_NOW 定住、狀態走 ISEP_COUNTDOWN_STATE_DIR，
+#    不打網路、不碰 $HOME、跑完自己清。
+set -u
+HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/countdown-guard.sh}"
+TMP=$(mktemp -d)
+trap 'rm -rf "$TMP"' EXIT
+export ISEP_COUNTDOWN_STATE_DIR="$TMP/state"
+mkdir -p "$ISEP_COUNTDOWN_STATE_DIR"
+
+PASS=0; FAIL=0
+
+# 定住的時鐘：2026-08-28 08:00 台北 ＝ 2026-08-28 00:00 UTC
+T0=$(python3 -c 'import datetime as d;print(int(d.datetime(2026,8,28,0,0,tzinfo=d.timezone.utc).timestamp()))')
+H=3600
+
+ok(){ printf '  ✅ %s\n' "$1"; PASS=$((PASS+1)); }
+no(){ printf '  ❌ %s —— %s\n' "$1" "$2"; FAIL=$((FAIL+1)); }
+
+# mk_transcript <檔> <起始 epoch> —— 一則帶時間戳的使用者訊息，當作對話起點
+mk_transcript(){
+  python3 - "$1" "$2" <<'PY'
+import datetime as d, json, sys
+p, ts = sys.argv[1], int(sys.argv[2])
+iso = d.datetime.fromtimestamp(ts, d.timezone.utc).isoformat().replace("+00:00", "Z")
+with open(p, "w") as f:
+    f.write(json.dumps({"type": "user", "timestamp": iso,
+                        "message": {"content": [{"type": "text", "text": "開工"}]}}) + "\n")
+PY
+}
+
+# add_turn <檔> <spec>... —— spec：`T:<文字>` assistant 文字；`U:<工具>` tool_use；
+#                                   `R:` 一列工具結果（不算新回合的分界）
+add_turn(){
+  python3 - "$@" <<'PY'
+import json, sys
+path, specs = sys.argv[1], sys.argv[2:]
+rows = []
+blocks = []
+for s in specs:
+    k, v = s.split(":", 1)
+    if k == "T":
+        blocks.append({"type": "text", "text": v})
+    elif k == "U":
+        blocks.append({"type": "tool_use", "name": v, "id": "t", "input": {}})
+    elif k == "R":
+        rows.append({"type": "user", "message": {"content": [
+            {"type": "tool_result", "tool_use_id": "t", "content": "ok"}]}})
+with open(path, "a") as f:
+    f.write(json.dumps({"type": "user", "message": {"content": [
+        {"type": "text", "text": "繼續"}]}}, ensure_ascii=False) + "\n")
+    for r in rows:
+        f.write(json.dumps(r, ensure_ascii=False) + "\n")
+    if blocks:
+        f.write(json.dumps({"type": "assistant", "message": {"content": blocks}},
+                           ensure_ascii=False) + "\n")
+PY
+}
+
+# inject <session> <transcript> <now epoch> —— 跑注入模式，回傳 additionalContext
+inject(){
+  printf '{"hook_event_name":"UserPromptSubmit","session_id":"%s","transcript_path":"%s"}' "$1" "$2" \
+    | ISEP_COUNTDOWN_NOW="$3" bash "$HOOK" 2>/dev/null \
+    | python3 -c 'import json,sys
+try: print(json.load(sys.stdin)["hookSpecificOutput"]["additionalContext"])
+except Exception: print("")'
+}
+
+# stop <session> <transcript> <now epoch> <extra json> —— 跑查核模式，回傳 "exit|訊息"
+stop(){
+  # 🔴 明著把 CLAUDE_CODE_CHILD_SESSION 清掉：測試本身常常跑在一條 subagent 裡，
+  #    而那正是本閘刻意放行的情況 ⇒ 不清掉的話 B 群會全綠，而且是**假綠**
+  #    （2026-08-28 第一次跑就撞到：B 群三條全 exit 0，因為跑測試的就是子 session）。
+  out=$(printf '{"hook_event_name":"Stop","session_id":"%s","transcript_path":"%s"%s}' "$1" "$2" "${4:-}" \
+        | ISEP_COUNTDOWN_NOW="$3" CLAUDE_CODE_CHILD_SESSION= CLAUDE_PROJECT_DIR="$TMP" \
+          bash "$HOOK" 2>&1); rc=$?
+  printf '%s|%s' "$rc" "$(printf '%s' "$out" | tr '\n' ' ')"
+}
+
+echo "── A 群：注入（每一則回覆眼前都有那一行）────────────────────────"
+
+TR="$TMP/a1.jsonl"; mk_transcript "$TR" "$T0"
+CTX=$(inject s-a1 "$TR" "$T0")
+case "$CTX" in
+  *"⏱"*) ok "① 新 session 什麼都沒交代 ⇒ 注入的內容帶著標記" ;;
+  *) no "① 新 session 什麼都沒交代 ⇒ 注入的內容帶著標記" "實得：$CTX" ;;
+esac
+case "$CTX" in
+  *"已過 0 分"*) ok "② 剛開工 ⇒ 已過 0 分" ;;
+  *) no "② 剛開工 ⇒ 已過 0 分" "實得：$CTX" ;;
+esac
+# 台北 08:00 → 16:00 收工線還有 8 小時
+case "$CTX" in
+  *"距收工線（台北 16:00）剩 8 小時"*) ok "③ 台北 08:00 ⇒ 距收工線剩 8 小時" ;;
+  *) no "③ 台北 08:00 ⇒ 距收工線剩 8 小時" "實得：$CTX" ;;
+esac
+
+# 票上驗收 2：數字要對得上真實經過的時間（期望 2 小時 13 分）
+CTX=$(inject s-a1 "$TR" $((T0 + 2*H + 13*60)))
+case "$CTX" in
+  *"已過 2 小時 13 分"*) ok "④ 過了 2h13m ⇒ 顯示「已過 2 小時 13 分」（期望＝實得）" ;;
+  *) no "④ 過了 2h13m ⇒ 顯示「已過 2 小時 13 分」" "實得：$CTX" ;;
+esac
+
+# 票上驗收 3：連續幾則要遞增，不歸零、不亂跳
+LAST=-1; SEQ_OK=1
+for k in 0 1 3 5; do
+  CTX=$(inject s-a1 "$TR" $((T0 + k*H)))
+  got=$(printf '%s' "$CTX" | sed -n 's/.*已過 \([0-9]*\) 小時.*/\1/p')
+  [ -z "$got" ] && got=0
+  [ "$got" -ge "$LAST" ] || SEQ_OK=0
+  LAST="$got"
+done
+[ "$SEQ_OK" = 1 ] && ok "⑤ 連續四則（0/1/3/5 小時）⇒ 遞增，不歸零不亂跳" \
+                  || no "⑤ 連續四則 ⇒ 遞增" "第 $LAST 則往回跳了"
+
+# resume：同一個 session 換一份較早起點的 transcript，起點取較早的那個
+TR2="$TMP/a2.jsonl"; mk_transcript "$TR2" $((T0 - 5*H))
+CTX=$(inject s-a1 "$TR2" "$T0")
+case "$CTX" in
+  *"已過 5 小時"*) ok "⑥ resume（transcript 起點更早）⇒ 昨天燒掉的時間仍然算" ;;
+  *) no "⑥ resume ⇒ 起點取較早" "實得：$CTX" ;;
+esac
+
+# 過了收工線：台北 17:30 ⇒ 顯示超過，不准悄悄換算成明天
+CTX=$(inject s-late "$TMP/a3.jsonl" $((T0 + 9*H + 30*60)))
+case "$CTX" in
+  *"已超過收工線"*) ok "⑦ 台北 17:30 ⇒ 顯示「已超過收工線」（超時不許消失）" ;;
+  *) no "⑦ 台北 17:30 ⇒ 顯示已超過" "實得：$CTX" ;;
+esac
+# 台北 21:00（過線四小時後）⇒ 滾到隔天 16:00，剩 19 小時
+CTX=$(inject s-next "$TMP/a4.jsonl" $((T0 + 13*H)))
+case "$CTX" in
+  *"距收工線（台北 16:00）剩 19 小時"*) ok "⑧ 台北 21:00 ⇒ 滾到隔天，剩 19 小時" ;;
+  *) no "⑧ 台北 21:00 ⇒ 滾到隔天" "實得：$CTX" ;;
+esac
+
+# milestone：沒有快取就整段不出現（不准編一個日期出來）
+# 🔴 只比對**第一行**（那條 ⏱ 倒數本身）。inkstone/ISEP#82 之後，同一個注入點還帶著
+#    第二行「🎯 主線……」與一段說明，那段文字裡本來就會出現「主線」兩個字
+#    ——拿整段去比對會把說明當成數字，變成一條**測不到重點的假紅**。
+#    這一格要驗的一直都是「⏱ 那一行有沒有多長出一段編出來的期限」。
+STAMP_LINE_ONLY=$(printf '%s\n' "$CTX" | head -1)
+case "$STAMP_LINE_ONLY" in
+  *"主線"*) no "⑨ 沒有 milestone 快取 ⇒ 那一段不出現" "實得：$STAMP_LINE_ONLY" ;;
+  *) ok "⑨ 沒有 milestone 快取 ⇒ 那一段不出現（不編數字）" ;;
+esac
+printf '2026-08-30|Sprint 8-28\n' > "$ISEP_COUNTDOWN_STATE_DIR/milestone-due"
+CTX=$(printf '%s\n' "$(inject s-ms "$TMP/a5.jsonl" "$T0")" | head -1)
+case "$CTX" in
+  *"主線 Sprint 8-28 剩"*) ok "⑩ 有 milestone 快取 ⇒ 期限那一段出現" ;;
+  *) no "⑩ 有 milestone 快取 ⇒ 期限那一段出現" "實得：$CTX" ;;
+esac
+rm -f "$ISEP_COUNTDOWN_STATE_DIR/milestone-due"
+
+echo "── B 群：查核——該擋 ────────────────────────────────────────────"
+
+TR="$TMP/b1.jsonl"; mk_transcript "$TR" "$T0"
+add_turn "$TR" 'U:Read' 'T:做完了，改了三個檔。'
+R=$(stop s-b1 "$TR" $((T0 + 2*H)))
+[ "${R%%|*}" = 2 ] && ok "⑪ 回覆沒戴倒數 ⇒ 擋" || no "⑪ 回覆沒戴倒數 ⇒ 擋" "實得 exit=${R%%|*}"
+case "${R#*|}" in
+  *"已過 2 小時"*) ok "⑫ 擋下時把算好的那一行印出來給它抄（不是叫它自己算）" ;;
+  *) no "⑫ 擋下時印出算好的那一行" "實得：${R#*|}" ;;
+esac
+
+# 回合邊界：上一回合戴了、這一回合沒戴 ⇒ 還是要擋
+TR="$TMP/b2.jsonl"; mk_transcript "$TR" "$T0"
+add_turn "$TR" 'T:⏱ 已過 1 小時｜距收工線剩 7 小時。上一回合戴過了。'
+add_turn "$TR" 'U:Edit' 'T:這回合忘了戴。'
+R=$(stop s-b2 "$TR" $((T0 + 2*H)))
+[ "${R%%|*}" = 2 ] && ok "⑬ 只有上一回合戴 ⇒ 這一回合仍要擋（回合邊界對）" \
+                  || no "⑬ 只有上一回合戴 ⇒ 仍要擋" "實得 exit=${R%%|*}"
+
+echo "── C 群：查核——不該擋（誤攔比漏擋更該修）──────────────────────"
+
+TR="$TMP/c1.jsonl"; mk_transcript "$TR" "$T0"
+add_turn "$TR" 'U:Read' 'T:⏱ 已過 2 小時｜距收工線（台北 16:00）剩 6 小時 —— 做完了。'
+R=$(stop s-c1 "$TR" $((T0 + 2*H)))
+[ "${R%%|*}" = 0 ] && ok "⑭ 回覆戴了倒數 ⇒ 放行" || no "⑭ 回覆戴了倒數 ⇒ 放行" "實得 exit=${R%%|*}"
+
+TR="$TMP/c2.jsonl"; mk_transcript "$TR" "$T0"
+add_turn "$TR" 'T:上一回合。'
+add_turn "$TR" 'U:Read' 'T:⏱ 已過 2 小時｜這一回合戴了。'
+R=$(stop s-c2 "$TR" $((T0 + 2*H)))
+[ "${R%%|*}" = 0 ] && ok "⑮ 這一回合戴了、上一回合沒戴 ⇒ 放行" \
+                  || no "⑮ 這一回合戴了 ⇒ 放行" "實得 exit=${R%%|*}"
+
+TR="$TMP/c3.jsonl"; mk_transcript "$TR" "$T0"
+add_turn "$TR" 'U:Read' 'R:' 'U:Grep'
+R=$(stop s-c3 "$TR" $((T0 + 2*H)))
+[ "${R%%|*}" = 0 ] && ok "⑯ 純工具回合（沒有任何文字）⇒ 放行，沒有東西可以戴" \
+                  || no "⑯ 純工具回合 ⇒ 放行" "實得 exit=${R%%|*}"
+
+TR="$TMP/c4.jsonl"; mk_transcript "$TR" "$T0"
+add_turn "$TR" 'T:沒戴。'
+R=$(stop s-c4 "$TR" $((T0 + 2*H)) ',"stop_hook_active":true')
+[ "${R%%|*}" = 0 ] && ok "⑰ 已經提醒過一次（stop_hook_active）⇒ 放行，至多擋一次" \
+                  || no "⑰ stop_hook_active ⇒ 放行" "實得 exit=${R%%|*}"
+
+TR="$TMP/c5.jsonl"; mk_transcript "$TR" "$T0"
+add_turn "$TR" 'T:我是 subagent，交件給總管。'
+out=$(printf '{"hook_event_name":"Stop","session_id":"s-c5","transcript_path":"%s"}' "$TR" \
+      | ISEP_COUNTDOWN_NOW=$((T0 + 2*H)) CLAUDE_CODE_CHILD_SESSION=1 \
+        CLAUDE_PROJECT_DIR="$TMP" bash "$HOOK" 2>&1); rc=$?
+[ "$rc" = 0 ] && ok "⑱ 子 session（subagent）⇒ 放行，它的回覆不是給 leo 看的" \
+             || no "⑱ 子 session ⇒ 放行" "實得 exit=$rc"
+
+R=$(stop s-c6 "$TMP/does-not-exist.jsonl" $((T0 + 2*H)))
+[ "${R%%|*}" = 0 ] && ok "⑲ transcript 讀不到 ⇒ 放行（節拍器壞掉不該卡死 session）" \
+                  || no "⑲ transcript 讀不到 ⇒ 放行" "實得 exit=${R%%|*}"
+
+printf 'not json at all\n{{{\n' > "$TMP/c7.jsonl"
+R=$(stop s-c7 "$TMP/c7.jsonl" $((T0 + 2*H)))
+[ "${R%%|*}" = 0 ] && ok "⑳ transcript 是壞的 ⇒ 放行，不是擋" \
+                  || no "⑳ transcript 壞掉 ⇒ 放行" "實得 exit=${R%%|*}"
+
+echo
+echo "結果：通過 $PASS 條，失敗 $FAIL 條"
+[ "$FAIL" -eq 0 ] || exit 1

hooks/tests/diagnosis-evidence-guard.test.sh

@@ -0,0 +1,171 @@
+#!/usr/bin/env bash
+# diagnosis-evidence-guard.sh ＋ investigate-first-stamp.sh 的迴歸測試（inkstone/ISEP#87）
+#
+# 票上的四條驗收條件，一條一組：
+#   1 開一張還沒有人查過的票，在裡面寫「根因是 X」        → 要被擋一次
+#   2 派人查過、結論貼回票上了，再寫診斷                  → 放行
+#   3 擋的訊息要講得出「你還沒派人查這件事」，不是「格式不對」
+#   4 只是轉述別人查到的東西（有出處）                    → **不能被誤擋**
+#
+# 🔴 全程離線：不打 Gitea、不開任何測試票、不碰 /tmp 的正式戳記
+#    （戳記走 `ISEP_STAMP_DIR`）。每次結果一樣——純結構判斷，沒有語意判官。
+#
+# 🔴 這支閘**沒有任何關鍵字比對**（票上明令：「根因」「因為」「應該是」不准當判準）。
+#    所以下面「該擋」的案例裡有沒有出現那些詞完全不影響結果——
+#    ⑬ 就是拿一段**一個那種詞都沒有**的內容，證明判準不是措辭。
+#
+# 用法：hooks/tests/diagnosis-evidence-guard.test.sh [hook 路徑]
+set -u
+unset CLAUDE_CODE_CHILD_SESSION
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$(cd "$HERE/../.." && pwd)"
+HOOK="${1:-$ROOT/hooks/diagnosis-evidence-guard.sh}"
+STAMP="$ROOT/hooks/investigate-first-stamp.sh"
+TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
+export ISEP_STAMP_DIR="$TMP"
+
+PASS=0; FAIL=0; N=0
+
+bash_payload() {
+  python3 - "$1" "$2" <<'PY'
+import json, sys
+print(json.dumps({"session_id": sys.argv[1], "hook_event_name": "PreToolUse",
+                  "tool_name": "Bash", "tool_input": {"command": sys.argv[2]}},
+                 ensure_ascii=False))
+PY
+}
+
+# t <期望 exit> <說明> <session> <指令> [必須出現的字串]
+t() {
+  want="$1"; desc="$2"; sid="$3"; cmd="$4"; must="${5:-}"
+  N=$((N+1))
+  err=$(bash_payload "$sid" "$cmd" | bash "$HOOK" 2>&1 >/dev/null); rc=$?
+  ok=1
+  [ "$rc" -eq "$want" ] || ok=0
+  if [ -n "$must" ] && ! printf '%s' "$err" | grep -qF "$must"; then ok=0; fi
+  if [ "$ok" -eq 1 ]; then printf '  ✅ %s\n' "$desc"; PASS=$((PASS+1))
+  else
+    printf '  ❌ %s —— 期望 exit=%s%s，實得 exit=%s\n' "$desc" "$want" \
+      "${must:+ 且訊息含「$must」}" "$rc"
+    printf '%s\n' "$err" | sed -n '1,8p' | sed 's/^/     /'
+    FAIL=$((FAIL+1))
+  fi
+}
+
+# 派一次工去查某張票（＝讓戳記出現）
+dispatch() {
+  python3 - "$1" "$2" <<'PY' | bash "$STAMP"
+import json, sys
+print(json.dumps({"session_id": sys.argv[1], "tool_name": "Task",
+                  "tool_input": {"prompt": "【工單】%s" % sys.argv[2]}},
+                 ensure_ascii=False))
+PY
+}
+
+# ── 測資：三份內文 ────────────────────────────────────────────────
+#   ① 沒查過的診斷（0 個出處）
+cat > "$TMP/diagnosis.md" <<'EOF'
+【身份】總管／inkstone/ISEP／-
+根因是 KV 額度爆掉，所以執行紀錄寫不進去；我判斷應該改用另一顆資料庫來存，
+這樣就不會再撞到額度上限了。這件事拖了很久一直沒解，先照這個方向做下去。
+EOF
+#   ② 同一段話，但帶著出處（轉述別人查到的）
+cat > "$TMP/relayed.md" <<'EOF'
+【身份】總管／inkstone/ISEP／-
+scout 查回來的：寫入那段在 hooks/lib/evidence.py:42，額度是在那裡爆的，
+出處 inkstone/Arcrun#142 → comment 4327。我只是把它的結論搬過來，沒有自己加判斷。
+EOF
+#   ③ 一段**一個「根因／因為／應該是」都沒有**的長內容，同樣沒有出處
+cat > "$TMP/no-keyword.md" <<'EOF'
+【身份】總管／inkstone/ISEP／-
+那個匯入流程跑不動是設定檔的問題，換掉那個欄位就會通了，我看過一次有印象。
+先照這個方向改，改完應該就不會再出現同樣的狀況了，不用另外再查。
+EOF
+#   ④ 短回覆
+SHORT="收到，我來看"
+
+echo "── 驗收 1＋3：沒人查過、也沒出處 ⇒ 擋，且說得出「還沒派人查」──"
+
+t 2 "① 貼一段沒人查過的診斷到票上 ⇒ 擋" \
+  S-A "python3 scripts/ticket say inkstone/ISEP#87 -F $TMP/diagnosis.md"
+t 2 "② 訊息講得出「這個 session 沒有派人去查這張票」（不是籠統的「格式不對」）" \
+  S-B "python3 scripts/ticket say inkstone/ISEP#87 -F $TMP/diagnosis.md" \
+  '沒有派人去查這張票'
+t 2 "③ 訊息要點名是哪一張票（人才知道該派誰去查什麼）" \
+  S-C "python3 scripts/ticket say inkstone/ISEP#87 -F $TMP/diagnosis.md" 'inkstone/ISEP#87'
+t 2 "④ 訊息要給兩條出路：先派人查／把出處帶上" \
+  S-D "python3 scripts/ticket say inkstone/ISEP#87 -F $TMP/diagnosis.md" '先派人去查'
+t 2 "⑤ 開新票也一樣（新票天生沒人查過，`ticket new`）" \
+  S-E "python3 scripts/ticket new ISEP -F $TMP/diagnosis.md --title 身為X我要Y我才Z"
+t 2 "⑥ 側門：直接打 Gitea API POST 留言 ⇒ 同樣擋（認動作的方式不准漏一條路）" \
+  S-F "curl -X POST -H 'Authorization: token T' -d '{\"body\":\"根因是 KV 額度爆掉，所以執行紀錄寫不進去；我判斷應該改用另一顆資料庫來存，這樣就不會再撞到額度上限了，這件事拖了很久一直沒解，先照這個方向做下去不要再查了\"}' https://git.uncle6.me/api/v1/repos/inkstone/ISEP/issues/87/comments"
+t 2 "⑦ 側門：隱式 POST（requests.post）也要認得" \
+  S-G "python3 -c \"requests.post(url + '/repos/inkstone/ISEP/issues/87/comments', json={'body': '根因是 KV 額度爆掉，所以執行紀錄寫不進去；我判斷應該改用另一顆資料庫來存，這樣就不會再撞到額度上限了，這件事拖了很久一直沒解，先照這個方向做下去不要再查了'})\""
+
+echo "── 驗收 2：派人查過 ⇒ 放行 ─────────────────────────────────"
+
+dispatch S-H inkstone/ISEP#87
+t 0 "⑧ 同一 session 派過人去查 #87 ⇒ 同一段診斷放行" \
+  S-H "python3 scripts/ticket say inkstone/ISEP#87 -F $TMP/diagnosis.md"
+
+dispatch S-I inkstone/ISEP#86
+t 2 "⑨ 派的是**別張票**（#86）⇒ #87 仍然沒人查過 ⇒ 照擋（戳記按票分，不是按 session）" \
+  S-I "python3 scripts/ticket say inkstone/ISEP#87 -F $TMP/diagnosis.md"
+
+echo "── 驗收 4：轉述有出處 ⇒ 不能被誤擋 ─────────────────────────"
+
+t 0 "⑩ 帶檔案:行號＋票號＋comment 號的轉述 ⇒ 放行" \
+  S-J "python3 scripts/ticket say inkstone/ISEP#87 -F $TMP/relayed.md"
+
+for pair in "網址:https://git.uncle6.me/inkstone/ISEP/pulls/97" \
+            "commit:8e28041" \
+            "檔案路徑:hooks/lib/dispatch_parse.py"; do
+  kind="${pair%%:*}"; token="${pair#*:}"
+  printf '【身份】總管／inkstone/ISEP／-\n那段行為我核對過了，寫在 %s，跟票上寫的不一樣，所以下一步要照那邊的實況走，先不要動別的地方。\n' \
+    "$token" > "$TMP/one-source.md"
+  t 0 "⑪ 出處只有一個「$kind」也算數 ⇒ 放行" \
+    "S-K-$kind" "python3 scripts/ticket say inkstone/ISEP#87 -F $TMP/one-source.md"
+done
+
+printf '【身份】總管／inkstone/ISEP／-\n實測輸出如下，這是它自己跑出來的，不是我推的：\n```\n$ bash hooks/tests/x.sh\n通過 20 條，失敗 0 條\n```\n' > "$TMP/fenced.md"
+t 0 "⑫ 貼實測輸出（圍欄）也算出處 ⇒ 放行" \
+  S-L "python3 scripts/ticket say inkstone/ISEP#87 -F $TMP/fenced.md"
+
+echo "── 判準不是措辭（本閘沒有關鍵字比對）────────────────────────"
+
+t 2 "⑬ 一個「根因／因為／應該是」都沒有的內容，照樣擋（判準是結構不是詞）" \
+  S-M "python3 scripts/ticket say inkstone/ISEP#87 -F $TMP/no-keyword.md"
+
+echo "── 不該擋（誤攔比漏擋嚴重）──────────────────────────────────"
+
+t 0 "⑭ 一句短回覆（「$SHORT」）⇒ 不可能是診斷，放行" \
+  S-N "python3 scripts/ticket say inkstone/ISEP#87 --body '$SHORT'"
+t 0 "⑮ GET 撈票（唯讀）⇒ 放行" \
+  S-O "curl -s https://git.uncle6.me/api/v1/repos/inkstone/ISEP/issues/87"
+t 0 "⑯ ticket where（搜尋）⇒ 不是寫票，放行" \
+  S-P "python3 scripts/ticket where 診斷 調查 順序"
+t 0 "⑰ ticket close（關票）⇒ 不是寫內文，放行" \
+  S-Q "python3 scripts/ticket close inkstone/ISEP#87 --deliverable https://git.uncle6.me/x"
+t 0 "⑱ 一般指令（ls）⇒ 一律不管" S-R "ls -la"
+t 0 "⑲ 逃生口 evidence-ok 在指令裡 ⇒ 放行（留痕）" \
+  S-S "python3 scripts/ticket say inkstone/ISEP#87 -F $TMP/diagnosis.md  # evidence-ok"
+
+echo "── 只擋一次，不鬼打牆 ──────────────────────────────────────"
+
+t 2 "⑳ 第一次 ⇒ 擋" S-T "python3 scripts/ticket say inkstone/ISEP#87 -F $TMP/diagnosis.md"
+t 0 "㉑ 同一 session 同一張票第二次 ⇒ 放行（閘是絆一下，不是把人關起來）" \
+  S-T "python3 scripts/ticket say inkstone/ISEP#87 -F $TMP/diagnosis.md"
+t 2 "㉒ 同一 session **換一張票** ⇒ 仍然擋（不是一次就永久解鎖）" \
+  S-T "python3 scripts/ticket say inkstone/Arcrun#142 -F $TMP/diagnosis.md"
+
+echo "── 內部壞掉不准把人鎖死 ────────────────────────────────────"
+
+t 0 "㉓ 整包不是合法 JSON ⇒ fail-open" S-U ''
+N=$((N+1))
+err=$(printf 'not json at all' | bash "$HOOK" 2>&1 >/dev/null); rc=$?
+if [ "$rc" -eq 0 ]; then printf '  ✅ ㉔ payload 不是 JSON ⇒ fail-open\n'; PASS=$((PASS+1))
+else printf '  ❌ ㉔ payload 壞掉時擋住了（exit=%s）\n' "$rc"; FAIL=$((FAIL+1)); fi
+
+echo
+printf '結果：%s 通過 / %s 失敗（共 %s 條）\n' "$PASS" "$FAIL" "$N"
+[ "$FAIL" -eq 0 ] || exit 1

hooks/tests/dispatch-format-guard.test.sh

@@ -0,0 +1,325 @@
+#!/usr/bin/env bash
+# dispatch-format-guard.sh 的迴歸測試（inkstone/ISEP#30 comment 4322／4325／4327）。
+#
+# **離線、不打網路、不花錢、每次結果一樣**——這支閘是純結構判斷，沒有語意判官，
+# 所以它不像 ask-user-question-guard 那樣需要一支 live 測試量準度。
+#
+# 三群，兩個方向都要有證據：
+#   A 群「該放行」——合規的派工（只有票號）、不是派工的動作、沒有【工單】（別人的地盤）、
+#                    豁免戳記；**而且合規時要真的把共通規定注入出去**
+#   B 群「該擋」  ——真跡一份（那 5 次違規裡唯一還拿得回來的），
+#                    加上一條規則一個最小案例
+#   C 群「訊息本身」——講得出出路、沒有被 shell 展開
+#
+# 用法：hooks/tests/dispatch-format-guard.test.sh [hook 路徑]
+
+set -u
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="${1:-$(cd "$HERE/.." && pwd)/dispatch-format-guard.sh}"
+FIX="$HERE/fixtures"
+
+PASS=0; FAIL=0; N=0
+
+# payload <prompt 檔或字串> [tool_name]
+payload() {
+  python3 - "$1" "${2:-Task}" <<'PY'
+import json, os, sys
+src, tool = sys.argv[1], sys.argv[2]
+prompt = open(src, encoding="utf-8").read() if os.path.isfile(src) else src
+print(json.dumps({"session_id": "S-TEST", "hook_event_name": "PreToolUse",
+                  "tool_name": tool, "tool_input": {"prompt": prompt}},
+                 ensure_ascii=False))
+PY
+}
+
+# reply_payload <tool_name> <裝話的欄位名> <內容> [額外欄位 JSON]
+#   ISEP#88：通往 subagent 的路不只 Task／Agent 一條，每一條裝話的欄位還不一樣。
+reply_payload() {
+  python3 - "$1" "$2" "$3" "${4:-{\}}" <<'RP'
+import json, sys
+tool, key, text, extra = sys.argv[1], sys.argv[2], sys.argv[3], sys.argv[4]
+ti = {key: text}
+ti.update(json.loads(extra))
+print(json.dumps({"session_id": "S-TEST", "hook_event_name": "PreToolUse",
+                  "tool_name": tool, "tool_input": ti}, ensure_ascii=False))
+RP
+}
+
+# t <期望 exit> <說明> <payload JSON>
+t() {
+  want="$1"; desc="$2"; body="$3"
+  N=$((N+1))
+  err=$(printf '%s' "$body" | bash "$HOOK" 2>&1 >/dev/null); rc=$?
+  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,6p' | sed 's/^/     /'
+    FAIL=$((FAIL+1))
+  fi
+}
+
+clean() { rm -f /tmp/.dispatch-ok-S-TEST 2>/dev/null || true; }
+
+echo "── A 群：該放行 ────────────────────────────────────────────────"
+clean
+
+t 0 "① 合規：整份派工單只有一行票號" \
+  "$(payload '【工單】inkstone/ISEP#30 → comment 4322')"
+
+t 0 "② 合規：兩張票就兩行【工單】" \
+  "$(payload '【工單】inkstone/ISEP#30
+【工單】inkstone/InkStoneCo#55')"
+
+t 0 "③ 合規：用 #issuecomment- 定址也認得" \
+  "$(payload '【工單】inkstone/ISEP#30#issuecomment-4327')"
+
+# ── inkstone/ISEP#65：CLAUDE.md 規定的合格格式（全形／半形括號包住 → comment M）
+#    曾經被本閘自己擋下——這裡把它釘成迴歸測試，不再走回頭路。
+t 0 "③b 合規：全形括號包住 → comment M（CLAUDE.md 標準寫法，曾被自己的閘擋下）" \
+  "$(payload '【工單】inkstone/ISEP#65（→ comment 4515）')"
+
+t 0 "③c 合規：半形括號變體" \
+  "$(payload '【工單】inkstone/ISEP#65(→ comment 4515)')"
+
+# ── inkstone/ISEP#65 test 4：不該擋的三種雜訊 ────────────────────────
+t 0 "③d 不該擋：票號後面只有空行" \
+  "$(payload '【工單】inkstone/ISEP#65
+
+')"
+
+t 0 "③e 不該擋：票號後面只有一句「謝謝」（零資訊禮貌收尾，白名單豁免）" \
+  "$(payload '【工單】inkstone/ISEP#65
+謝謝')"
+
+t 0 "③f 不該擋：禮貌收尾帶標點也認得（「謝謝！」）" \
+  "$(payload '【工單】inkstone/ISEP#65
+謝謝！')"
+
+t 2 "③g 白名單不是漏洞：禮貌詞混在真內容裡照樣算數" \
+  "$(payload '【工單】inkstone/ISEP#65
+辛苦了，順便告訴你 main 現在是 8e28041')"
+
+t 0 "④ 不是派工的動作（Bash）→ 一律不管" \
+  '{"tool_name":"Bash","tool_input":{"command":"ls"}}'
+
+t 0 "⑤ 整包不是合法 JSON → fail-open" 'this is not json at all'
+
+t 0 "⑥ 沒有【工單】→ 閉嘴，那是 no-ticket-no-dispatch 的地盤（不准兩支閘同時開口）" \
+  "$(payload '去把 arcrun 那個 worker 修一修，順便跑一下測試')"
+
+# 注入：合規時要真的把共通規定送出去（leo 的驗收條件之一——
+#       「收工方**沒讀派工單**也知道要貼回原票」）
+N=$((N+1))
+inj=$(printf '%s' "$(payload '【工單】inkstone/ISEP#30')" | bash "$HOOK" 2>/dev/null)
+if printf '%s' "$inj" | python3 -c '
+import sys, json
+d = json.load(sys.stdin)
+c = d["hookSpecificOutput"]["additionalContext"]
+assert "貼回那張票" in c, "沒有交件方式"
+assert "【身份】" in c, "沒有身份欄規定"
+assert "不准 push" in c, "沒有 main 紅線"
+' 2>/dev/null; then
+  printf '  ✅ ⑦ 合規的派工會被注入共通規定（交件方式＋身份欄＋不准 push main）\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ⑦ 共通規定沒有被注入，或缺了其中一項\n'
+  printf '%s\n' "$inj" | sed -n '1,4p' | sed 's/^/     /'
+  FAIL=$((FAIL+1))
+fi
+
+clean
+touch /tmp/.dispatch-ok-S-TEST
+t 0 "⑧ 明示豁免戳記在 → 放行一次" \
+  "$(payload '【工單】inkstone/ISEP#30
+這一次真的有例外')"
+N=$((N+1))
+if [ -f /tmp/.dispatch-ok-S-TEST ]; then
+  printf '  ❌ ⑧b 豁免戳記用完沒被消掉（會變成永久開關）\n'; FAIL=$((FAIL+1))
+else
+  printf '  ✅ ⑧b 豁免戳記用完就消失，不是永久開關\n'; PASS=$((PASS+1))
+fi
+clean
+
+echo
+echo "── B 群：該擋 ──────────────────────────────────────────────────"
+
+t 2 "⑨ **真跡**：產生 ISEP#30 這條線的那一次派工（散文開場＋指令圍欄＋三點就地＋交件）" \
+  "$(payload "$FIX/real-violation-isep30.txt")"
+
+t 2 "⑩ 只多一行散文——沒有「一句而已」這種豁免" \
+  "$(payload '【工單】inkstone/ISEP#30
+記得先讀 CLAUDE.md')"
+
+t 2 "⑪ 帶【交件】——那是「每次都一樣」，該進共通規定" \
+  "$(payload '【工單】inkstone/ISEP#30
+【交件】貼回 inkstone/ISEP#30，回報分支名')"
+
+t 2 "⑫ 帶【就地】——那是「這次才知道」，該寫進票" \
+  "$(payload '【工單】inkstone/ISEP#30
+【就地】main 現在是 8e7e265')"
+
+t 2 "⑬ 帶【人格】——已收回的欄位" \
+  "$(payload '【工單】inkstone/ISEP#30
+【人格】ISEP plugin 維護者')"
+
+t 2 "⑭ 票號形狀不對（裸號，跨 repo 會撞號）" \
+  "$(payload '【工單】#30')"
+
+t 2 "⑮ 內容躲在圍欄裡也算數（圍欄只讓裡面的【】不被當欄位，不讓內容變成不存在）" \
+  "$(payload '【工單】inkstone/ISEP#30
+```
+【就地】main 現在是 8e7e265
+```')"
+
+# ── inkstone/ISEP#65 test 5：拿「寫完規則之後總管又犯的 8 次」當回歸樣本 ──
+#    內容是從各自票的真實內文摘錄（hooks/tests/fixtures/README.md 記著來歷），
+#    不是想像出來的例子。8 種形狀都要被擋，證明這不是只補了一個特例。
+t 2 "⑮b 回歸：ISEP#60 那次的內容（自造第四套機制的診斷）" \
+  "$(payload "$FIX/real-content-isep60.txt")"
+
+t 2 "⑮c 回歸：ISEP#61 那次的內容（push-guard 戳記機制失敗史）" \
+  "$(payload "$FIX/real-content-isep61.txt")"
+
+t 2 "⑮d 回歸：ISEP#64 那次的內容（PR 分診現況數字）" \
+  "$(payload "$FIX/real-content-isep64.txt")"
+
+t 2 "⑮e 回歸：Arcrun#142 那次的內容（庫索引從沒被產生過）" \
+  "$(payload "$FIX/real-content-arcrun142.txt")"
+
+t 2 "⑮f 回歸：Arcrun#144 那次的內容（樹狀圖驗收記錄）" \
+  "$(payload "$FIX/real-content-arcrun144.txt")"
+
+t 2 "⑮g 回歸：Arcrun#165 那次的內容（MCP 徹查現場）" \
+  "$(payload "$FIX/real-content-arcrun165.txt")"
+
+t 2 "⑮h 回歸：arcrun-rag#104 那次的內容（收檔實測數字）" \
+  "$(payload "$FIX/real-content-arcrunrag104.txt")"
+
+t 2 "⑮i 回歸：InkStoneCo#102 那次的內容（milestone 打假背景）" \
+  "$(payload "$FIX/real-content-inkstoneco102.txt")"
+
+echo
+echo "── C 群：訊息本身 ──────────────────────────────────────────────"
+clean
+msg=$(printf '%s' "$(payload "$FIX/real-violation-isep30.txt")" | bash "$HOOK" 2>&1 >/dev/null)
+
+N=$((N+1))
+if printf '%s' "$msg" | grep -q '這句話換一張票還成立嗎' \
+   && printf '%s' "$msg" | grep -q '共通規定' \
+   && printf '%s' "$msg" | grep -q '寫進那張票'; then
+  printf '  ✅ ⑯ 訊息講得出判準與兩條出路（共通規定／寫進票）\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ⑯ 訊息缺了判準或其中一條出路\n'
+  printf '%s\n' "$msg" | sed -n '1,10p' | sed 's/^/     /'
+  FAIL=$((FAIL+1))
+fi
+
+# 迴歸：訊息裡的反引號一度在別支閘被 shell 當成命令替換執行掉
+#   （2026-08-26 ask-user-question-guard：閘照擋，但**它教人怎麼解的那兩行變成空白**）
+N=$((N+1))
+if printf '%s' "$msg" | grep -q 'scripts/ticket say' \
+   && printf '%s' "$msg" | grep -q 'touch /tmp/.dispatch-ok-S-TEST' \
+   && ! printf '%s' "$msg" | grep -qi 'is a directory\|command not found'; then
+  printf '  ✅ ⑰ 訊息原文照印：反引號沒被當命令執行，出路那兩行沒有變空白\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ⑰ 訊息被 shell 展開了（指令消失，或冒出 shell 錯誤）\n'
+  printf '%s\n' "$msg" | sed -n '1,20p' | sed 's/^/     /'
+  FAIL=$((FAIL+1))
+fi
+
+# 訊息要點名是哪一格違規（可迭代的最小單位——leo 4325：「照這種散文寫法根本無法迭代」）
+N=$((N+1))
+if printf '%s' "$msg" | grep -q '派工單不只有票號'; then
+  printf '  ✅ ⑱ 訊息點得出違反的是哪一條規則，不是一句籠統的「格式不對」\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ⑱ 訊息沒有點名違反哪一條\n'; FAIL=$((FAIL+1))
+fi
+
+echo
+echo "── D 群：回覆也是派工（inkstone/ISEP#88）────────────────────────"
+clean
+
+# 驗收 1：回覆一個正在跑的 subagent，訊息裡夾一段修改要求 ⇒ 擋
+t 2 "⑲ **驗收 1**：SendMessage 夾了一段修改要求 ⇒ 擋" \
+  "$(reply_payload SendMessage message '順便把 hooks.json 也改一下，改完重跑一次測試貼給我' '{"to":"isep-hand"}')"
+
+# 驗收 2：內容貼上票之後，回覆只給票號 ⇒ 放行
+t 0 "⑳ **驗收 2**：內容貼上票之後，回覆只有票號 ⇒ 放行" \
+  "$(reply_payload SendMessage message '【工單】inkstone/ISEP#88 → comment 5001' '{"to":"isep-hand"}')"
+
+# 驗收 1 的後半：擋的時候要把那段內容原文印出來（不然人得回頭自己找）
+N=$((N+1))
+rmsg=$(printf '%s' "$(reply_payload SendMessage message '去 main 分支重驗那三支 hook，把輸出貼回來' '{"to":"scout"}')" \
+       | bash "$HOOK" 2>&1 >/dev/null)
+if printf '%s' "$rmsg" | grep -q '直接貼上票' \
+   && printf '%s' "$rmsg" | grep -q '去 main 分支重驗那三支 hook'; then
+  printf '  ✅ ㉑ 擋下來時把那段內容**原文**印出來，可以直接貼上票\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ㉑ 沒有把原文印出來（出路要求「寫進票」，找不到原文就得回頭自己翻）\n'
+  printf '%s\n' "$rmsg" | sed -n '1,10p' | sed 's/^/     /'
+  FAIL=$((FAIL+1))
+fi
+
+N=$((N+1))
+if printf '%s' "$rmsg" | grep -q '回覆也是派工'; then
+  printf '  ✅ ㉒ 訊息說得出這是「回覆」那條路，不是照抄派工單那段\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ㉒ 回覆被擋時給的是派工單的說法，人會找不到自己違反了什麼\n'; FAIL=$((FAIL+1))
+fi
+
+# 真跡重演（驗收 4）：那兩則回覆的原文只活在總管的對話裡，拿不回來；
+# 這裡改用**同一天真的寫進派工單的那幾段內容**（fixtures/README.md 記著來歷），
+# 從**回覆這條路**再送一次——形狀一樣：一大段這次才知道的事實，票上一個字都沒有。
+for fx in real-content-isep60 real-content-arcrun142 real-content-arcrunrag104; do
+  t 2 "㉓ 真跡（$fx）從回覆這條路送出去 ⇒ 一樣擋" \
+    "$(reply_payload SendMessage message "$(cat "$FIX/$fx.txt")" '{"to":"isep-hand"}')"
+done
+
+echo "── E 群：通往 subagent 的路要列全（一條都不能漏）──────────────"
+
+t 2 "㉔ 雲端開新 session（create_session 的 prompt）" \
+  "$(reply_payload mcp__Claude_Code_Remote__create_session prompt '去把那個 worker 修好，順便升版')"
+t 2 "㉕ 送訊息進某個 session（send_message 的 text）" \
+  "$(reply_payload mcp__Claude_Code_Remote__send_message text '改一下剛剛那段，然後重跑測試')"
+t 2 "㉖ 排程派工（create_trigger 的 prompt）" \
+  "$(reply_payload mcp__Claude_Code_Remote__create_trigger prompt '每天早上去檢查 PR 有沒有結論，有的話處理掉')"
+t 2 "㉗ 當場點燃排程派工（fire_trigger 的 text）" \
+  "$(reply_payload mcp__Claude_Code_Remote__fire_trigger text '這次順便把 bundle 也重打一次')"
+t 2 "㉘ 排一則訊息給自己（send_later 的 message）" \
+  "$(reply_payload mcp__Claude_Code_Remote__send_later message '記得回頭把那三支 hook 的測試補齊')"
+t 2 "㉙ 用 CLI 開一個新 session（Bash 的 claude -p）" \
+  '{"session_id":"S-TEST","tool_name":"Bash","tool_input":{"command":"claude -p '"'"'去把 arcrun 那個 worker 修一修'"'"'"}}'
+
+echo "── F 群：這幾條**不該**被這支閘碰（誤攔比漏擋嚴重）─────────────"
+
+t 0 "㉚ subagent 往上回報（SendMessage to: main）＝交件不是派工 ⇒ 不管" \
+  "$(reply_payload SendMessage message '做完了，分支是 feat/x，測試 26/26' '{"to":"main"}')"
+t 0 "㉛ 一般的 Bash 指令裡剛好有【工單】字樣（判準是指令名不是內容）⇒ 不管" \
+  '{"session_id":"S-TEST","tool_name":"Bash","tool_input":{"command":"echo 【工單】inkstone/ISEP#88 順便改一下那個檔 > /tmp/x.md"}}'
+t 0 "㉜ claude 但沒有 -p（開互動 session，不是一次性派工）⇒ 不管" \
+  '{"session_id":"S-TEST","tool_name":"Bash","tool_input":{"command":"claude --version"}}'
+t 0 "㉝ 回覆是空的（這條路這次沒帶任何話）⇒ 不管" \
+  "$(reply_payload SendMessage message '' '{"to":"isep-hand"}')"
+
+N=$((N+1))
+child=$(printf '%s' "$(reply_payload SendMessage message '順便把那個檔也改一下' '{"to":"peer"}')" \
+        | CLAUDE_CODE_CHILD_SESSION=1 bash "$HOOK" 2>&1 >/dev/null); crc=$?
+if [ "$crc" -eq 0 ]; then
+  printf '  ✅ ㉞ 子 session 送出的回覆不管（它送的是交件，不是派工）\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ㉞ 子 session 的回覆被擋了（exit=%s）——那會擋掉交件本身\n' "$crc"; FAIL=$((FAIL+1))
+fi
+
+N=$((N+1))
+kid=$(printf '%s' "$(payload '【工單】inkstone/ISEP#88
+順便把 hooks.json 也改一下')" | CLAUDE_CODE_CHILD_SESSION=1 bash "$HOOK" 2>&1 >/dev/null); krc=$?
+if [ "$krc" -eq 2 ]; then
+  printf '  ✅ ㉟ 但子 session **自己往下派工**（Task）時，派工單的規矩照樣管它\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ㉟ 子 session 派工被整個放掉了（exit=%s）——那是一個逃逸艙口\n' "$krc"; FAIL=$((FAIL+1))
+fi
+
+clean
+echo
+echo "══ $PASS/$N 通過${FAIL:+，$FAIL 個失敗} ══"
+[ "$FAIL" -eq 0 ]

hooks/tests/fixtures/README.md

@@ -0,0 +1,32 @@
+# 測資的來歷
+
+`real-violation-isep30.txt` 是**真的發生過的那一份派工單**，一字未改（只把家目錄路徑
+換成 `/Users/x` 去識別）——它就是產生 `inkstone/ISEP#30` 這條線的那一次派工。
+
+leo 2026-08-27 要的測資是「今天實際發生的 5 次違規派工」
+（`arcrun-rag#104`／`Arcrun#142`／`Arcrun#127`／`Arcrun#144`／`InkStoneCo#55`）。
+
+🔴 **其中 4 份拿不回來了。** 它們住在那幾次派工的 prompt 裡，agent 結束就沒了——
+**這件事本身就是這條規則的證據**（4327：「那個 agent 被停掉／換人接手，
+那段事實就消失了」）。所以這裡只放拿得到的那一份真跡，
+其餘的覆蓋率改用「一條規則一個最小案例」來補（見 dispatch-format-guard.test.sh B 群）。
+
+**不要用想像出來的例子替補那 4 份**，那會讓測試看起來比實際更綠。
+
+---
+
+## 第二批：`real-content-*.txt`（inkstone/ISEP#65）
+
+leo 2026-08-27 又在同一天抓到總管**寫完規則之後又犯了 8 次**（八條線的派工單，
+每一條都帶了「這個 session 才知道的事」）：`ISEP#60`／`#61`／`#64`、
+`Arcrun#142`／`#144`／`#165`、`arcrun-rag#104`、`InkStoneCo#102`。
+
+🔴 **原始的違規派工 prompt 本身一樣拿不回來**（同一個道理：agent 一停就蒸發），
+但這 8 次的**內容已經被總管補寫回各自的票**（ISEP#65 body 明講）。
+這裡的 8 份 `real-content-*.txt` 是**從那些票的真實內文摘錄**（一字未改地複製，
+只是截取一段，並在最前面加回 `【工單】owner/repo#N` 讓它符合派工單的殼）——
+不是想像出來的例子，是真的存在於 Gitea 上、總管真的寫過的句子，只是原本的位置
+錯了（在 prompt 裡，不在票上）。
+
+用途：驗證 dispatch-format-guard.sh 修完 ISEP#65 之後，**這 8 種「票號 + 這個
+session 才知道的事」的形狀全部會被擋下**——不是只驗一個最小案例。

hooks/tests/fixtures/real-content-arcrun142.txt

@@ -0,0 +1,5 @@
+【工單】inkstone/Arcrun#142
+
+實查結論：這兩樣東西（庫索引與全庫摘要）從沒被產生過，不是壞掉，是根本沒做。
+於是「開場就知道有哪些子庫、各裝了什麼」這件事永遠靠現查，查不到就當作沒有。
+相關：inkstone/Arcrun#81、#87、#100（總圖說 0 條關聯，實際 1854 條）。

hooks/tests/fixtures/real-content-arcrun144.txt

@@ -0,0 +1,5 @@
+【工單】inkstone/Arcrun#144
+
+leo 明講「不要現在執行，記下來」，本票只是把它接住，開工前要先確認優先序。
+測試 OK，出現了樹狀圖，但不符合需求——達成的是 mindmap 向右向上分佈，
+上下間距很大、展開字很小，用戶要擁有觸控板否則很難閱讀。

hooks/tests/fixtures/real-content-arcrun165.txt

@@ -0,0 +1,5 @@
+【工單】inkstone/Arcrun#165
+
+不要先修，先查清楚再說——現在連斷在哪都還沒人講得出來。
+已知的現場（總管 2026-08-26 用 MCP 實查，不是讀 code 推的）：同一個知識庫
+（youlin／yuga3bse），同一套 MCP 工具，四次查詢分數與筆數都對不上。

hooks/tests/fixtures/real-content-arcrunrag104.txt

@@ -0,0 +1,5 @@
+【工單】inkstone/arcrun-rag#104
+
+現況（總管 2026-08-14 實測，非推測）：leo 把 5 個資料夾接上重裝後的 leo21c，
+App 顯示你的檔案 12022 共幾份、819 已送上去、11183 排隊中、20 送不上去。
+逐資料夾實數（find 計 .md/.pdf/.txt，已排除 node_modules／.git）。

hooks/tests/fixtures/real-content-inkstoneco102.txt

@@ -0,0 +1,5 @@
+【工單】inkstone/InkStoneCo#102
+
+背景（同一天稍早，leo 對同一件事說過的重話）：昨天要完成 51，你現在還有沒派的，
+去看看 milestone 一大堆沒有一個完成，現在整理，不要詐騙，去看清楚哪些完成的。
+Gitea 的百分比只數票的開關，它不知道票裡的東西通了沒。

hooks/tests/fixtures/real-content-isep60.txt

@@ -0,0 +1,6 @@
+【工單】inkstone/ISEP#60
+
+`subagent-claim-worksheet.sh`（`SubagentStop` 產待驗單）與 `claim-verify-police.sh`
+（`Stop` 擋收工）這一套自造的第四套機制整個移除，它守的東西改由 Gitea 原生的三格承接
+（子票相依／tag／指派——見 `inkstone/ISEP#59` 與 PR `#58`）。
+`#issuecomment-4289` 量到同一份待驗單重生三次、同內容兩個檔名。

hooks/tests/fixtures/real-content-isep61.txt

@@ -0,0 +1,5 @@
+【工單】inkstone/ISEP#61
+
+`main-and-prod-push-guard.sh` 的戳記機制已經走進死路：原設計用
+`CLAUDE_CODE_CHILD_SESSION=1` 判斷 subagent，實測結果總管主 session 也是 1，
+那個變數不是身分標記，誰都擋。改成戳記（`/tmp/.main-push-ok`，總管手動寫）也失敗。

hooks/tests/fixtures/real-content-isep64.txt

@@ -0,0 +1,6 @@
+【工單】inkstone/ISEP#64
+
+現況（總管實查，2026-08-27 12:40）：open PR 總數 23，總管已關掉 8 個「內容早就在
+main」的空 PR，剩 15 個要分診。已關的 8 個實測 git merge-base --is-ancestor 證明
+HEAD 已是 main 的祖先，diff +0/-0：Arcrun#166／#161／#158／#155／#153、
+arcrun-rag#142／#141／#139。

hooks/tests/fixtures/real-violation-isep30.txt

@@ -0,0 +1,17 @@
+你要動 **ISEP plugin**（Gitea `inkstone/ISEP`，全機共用的閘）。開工前先讀該 repo 的 CLAUDE.md 與 `system-dev/wiki/`。
+
+【工單】`inkstone/ISEP#30` → **comment 4322**（任務全文在那則，去讀它）
+
+```
+TOKEN=$(cd /Users/x/InkStoneCo && git remote get-url gitea | sed -E 's|.*//[^:]+:([^@]+)@.*|\1|')
+curl -s -H "Authorization: token $TOKEN" "https://git.uncle6.me/api/v1/repos/inkstone/ISEP/issues/30/comments?limit=60"
+```
+
+這個 session 才知道、票上還沒有的事：
+
+- `~/Documents/tech_projects/` 若讀不到（macOS TCC），立刻回報，不要硬撐；今天稍早發生過，leo 已開權限
+- 正本也可從 `~/.claude/plugins/marketplaces/inkstone` clone（origin 是 `inkstone/ISEP.git`），
+  今天 `v0.4.0` 那條線就是這樣施工的
+- `main` 現在是 `8e7e265`（`v0.4.0`，`ask-user-question-guard.sh` 剛上線）
+
+交件：貼回 `inkstone/ISEP#30`，回報分支名。

hooks/tests/gate-ok.test.sh

@@ -0,0 +1,88 @@
+#!/usr/bin/env bash
+# scripts/gate-ok ＋「戳記真的打得開門」的迴歸測試（inkstone/ISEP#90 ④）
+#
+# ══ 這支守的是什麼 ═════════════════════════════════════════════════════
+# 三支閘（prod-write／main-and-prod-push／stage-before-prod）都是
+# 「擋下來，但**總管看過就可以放行**」的設計。既有的測試只驗了「擋得住」，
+# **一條都沒有驗過「放得開」**——於是 2026-08-28 才發現：
+#   `stat -f %m` 在 GNU coreutils 上是「檔案系統資訊」，它一邊回非零一邊吐一整段文字，
+#   把接在後面的秒數污染掉 ⇒ **在 Linux（＝每一個雲端 session）上，那三支閘的戳記
+#   永遠不會被接受** ⇒ 它們在雲端等於純擋，而閘不會告訴你門是壞的。
+#
+# 所以這支的第一優先是「門打得開」，第二優先是「門沒有因此變寬」。
+#
+# 🔴 這支會真的寫 /tmp 的戳記檔（那是閘寫死的路徑，沒有覆寫的開關）。
+#    每一條測完就把它刪掉；跑之前若有真的在等的戳記，會被這支洗掉——
+#    請不要在「已經蓋好戳記正要推東西」的當下跑它。
+set -u
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"        # hooks/
+REPO="$(cd "$ROOT/.." && pwd)"
+GATEOK="$REPO/scripts/gate-ok"
+TMP=$(mktemp -d); trap 'rm -rf "$TMP"; rm -f /tmp/.prod-write-ok /tmp/.main-push-ok /tmp/.stage-verified /tmp/.solo-ok-TESTSID' EXIT
+export GIT_CONFIG_GLOBAL="$TMP/gitconfig"; : > "$GIT_CONFIG_GLOBAL"
+export GIT_AUTHOR_NAME=t GIT_AUTHOR_EMAIL=t@t GIT_COMMITTER_NAME=t GIT_COMMITTER_EMAIL=t@t
+
+PASS=0; FAIL=0
+ok(){ if [ "$2" = "$3" ]; then printf '  ✅ %s\n' "$1"; PASS=$((PASS+1));
+      else printf '  ❌ %s —— 期望 %s，實得 %s\n' "$1" "$3" "$2"; FAIL=$((FAIL+1)); fi; }
+
+mkrepo(){ d="$TMP/$1"; git init -q -b main "$d"; ( cd "$d" && echo a>a && git add a && git commit -qm x ) >/dev/null 2>&1; printf '%s\n' "$d"; }
+fire_prod(){ printf '{"tool_name":"Bash","tool_input":{"command":"acr push x.yaml"}}' \
+             | bash "$ROOT/prod-write-guard.sh" >/dev/null 2>&1; echo $?; }
+fire_push(){ printf '{"tool_name":"Bash","tool_input":{"command":"git push origin main"}}' \
+             | ( cd "$1" && bash "$ROOT/main-and-prod-push-guard.sh" >/dev/null 2>&1; echo $? ); }
+
+rm -f /tmp/.prod-write-ok /tmp/.main-push-ok /tmp/.stage-verified
+
+echo "── 最重要：門打得開（Linux 上 stat -f %m 那個 bug 的迴歸）──────"
+ok "① 沒戳記 → prod-write 擋"            "$(fire_prod)" 2
+bash "$GATEOK" prod-write >/dev/null
+ok "② gate-ok prod-write 之後 → 放行"     "$(fire_prod)" 0
+ok "③ 單次用完即丟：同一枚不能放行第二次" "$(fire_prod)" 2
+
+R1=$(mkrepo r1); R2=$(mkrepo r2)
+ok "④ 沒戳記 → 推 main 擋"                "$(fire_push "$R1")" 2
+bash "$GATEOK" main-push "$R1" >/dev/null
+ok "⑤ gate-ok main-push <repo> 之後 → 放行" "$(fire_push "$R1")" 0
+
+echo "── 門沒有因此變寬 ────────────────────────────────────────────"
+bash "$GATEOK" main-push "$R1" >/dev/null
+ok "⑥ 替 r1 開的門，r2 走不過（綁 repo 沒鬆）" "$(fire_push "$R2")" 2
+rm -f /tmp/.main-push-ok
+# 過期的戳記不算數：把 mtime 調到 16 分鐘前
+bash "$GATEOK" prod-write >/dev/null
+touch -d '16 minutes ago' /tmp/.prod-write-ok 2>/dev/null || touch -A -001600 /tmp/.prod-write-ok 2>/dev/null
+ok "⑦ 16 分鐘前的戳記 → 過期，照樣擋"      "$(fire_prod)" 2
+rm -f /tmp/.prod-write-ok
+# 空內容的 main-push 戳記＝萬用鑰匙，08-12 那次穿透的形狀，不准復活
+: > /tmp/.main-push-ok
+ok "⑧ 空內容的 main-push 戳記 → 不算數"    "$(fire_push "$R1")" 2
+rm -f /tmp/.main-push-ok
+
+echo "── gate-ok 自己：不認得的就要拒絕，別蓋一枚打不開的戳記 ──────"
+bash "$GATEOK" nonsense >/dev/null 2>&1; ok "⑨ 不認得的閘名 → 離開碼 2" "$?" 2
+bash "$GATEOK" solo >/dev/null 2>&1;     ok "⑩ solo 沒帶 session id → 離開碼 2" "$?" 2
+bash "$GATEOK" main-push "$TMP" >/dev/null 2>&1; ok "⑪ 不是 git repo → 離開碼 2" "$?" 2
+ok "⑫ 而且**沒有**留下一枚註定打不開的空戳記" "$([ -f /tmp/.main-push-ok ] && echo yes || echo no)" no
+bash "$GATEOK" solo TESTSID >/dev/null 2>&1
+ok "⑬ solo <sid> → 蓋出 /tmp/.solo-ok-<sid>" "$([ -f /tmp/.solo-ok-TESTSID ] && echo yes || echo no)" yes
+bash "$GATEOK" stage-verified >/dev/null 2>&1
+ok "⑭ stage-verified → 蓋出 /tmp/.stage-verified" "$([ -f /tmp/.stage-verified ] && echo yes || echo no)" yes
+
+echo "── file_mtime 本身：兩個平台的寫法都要答得出純數字 ────────────"
+. "$ROOT/lib/mtime.sh"
+touch "$TMP/probe"
+M=$(file_mtime "$TMP/probe")
+case "$M" in ''|*[!0-9]*) R=bad ;; *) R=ok ;; esac
+ok "⑮ file_mtime 回純數字（舊寫法在 Linux 上會回一整段文字）" "$R" ok
+ok "⑯ 檔案不存在 → 回 0，不是空字串" "$(file_mtime "$TMP/nope")" 0
+# 🔴 ⑰ 守的是這個 bug 的最後一層：舊寫法的行為**取決於 cwd 裡有沒有一個叫 `%m` 的檔**
+#    （GNU 的 -f 是布林旗標，`%m` 被當成另一個檔名運算元）。有 ⇒ exit 0 ⇒ `||` 連跑都不跑。
+#    一個行為取決於 cwd 有沒有某個檔的判斷式，不管跑不跑都是壞的。
+M2=$( cd "$TMP" && touch '%m' && file_mtime "$TMP/probe" )
+case "$M2" in ''|*[!0-9]*) R2=bad ;; *) R2=ok ;; esac
+ok "⑰ cwd 裡有一個叫 %m 的檔 → 仍要回純數字" "$R2" ok
+
+echo
+printf '通過 %s 條，失敗 %s 條\n' "$PASS" "$FAIL"
+[ "$FAIL" = 0 ] || exit 1

hooks/tests/isep-presence-beacon.test.sh

@@ -0,0 +1,117 @@
+#!/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

hooks/tests/lib/hook-sandbox.sh

@@ -0,0 +1,101 @@
+# hooks/tests/lib/hook-sandbox.sh — 讓「會寫檔的閘」在測試時寫到暫存區，不寫進 repo。
+# 不是獨立掛的閘（沒進 hooks.json），給 hooks/tests 與 scripts/test-* `source` 用。
+#
+# 🔴 為什麼需要這支（inkstone/ISEP#59 comment 4779 第 ① 條，實測重演過）：
+#   main-and-prod-push-guard.sh 擋下「推 main」的同時，會把那次請求寫成一份
+#   `<hooks 的上一層>/pending-main-push/<誰>--<repo>.md`——**那份檔案的語意是
+#   「有一筆推 main 正在等總管裁」**。而測試的測資本來就全是「推 main」，
+#   於是每跑一次測試，工作區就多／改幾筆**偽造的待裁決**：
+#
+#     $ git status --short          # 跑完測試之後（修之前的實測）
+#      M pending-main-push/unnamed--ISEP.md      ← 被測試覆寫（它是被追蹤的）
+#     ?? pending-main-push/unnamed--A.md         ← 跨 repo 測試建的臨時 repo
+#
+#   兩個後果，後者比較貴：
+#     ① `git add -A` 很容易把它們帶進 commit（08-27 那次真的帶進去了，事後才拔掉）
+#     ② **永遠在響的警報**：總管的迴圈讀這個目錄，讀到的每一筆都該是真的在等他裁。
+#        測試每跑一次就偽造一筆 ⇒ 下一筆真的請求會混在雜訊裡。
+#
+# 做法：把整個 `hooks/` 複製到暫存區再跑那支複本。閘算 `pending-main-push` 的位置
+# 靠的是 `$0` 的上一層，所以複本會寫進暫存區，**產品程式碼一行都不用改**
+# （不必為了測試在閘上多開一個「寫去哪」的開關——那種開關會變成關掉紀錄的路）。
+#
+# 用法：
+#   . "$(dirname "$0")/lib/hook-sandbox.sh"
+#   hook_sandbox "$REAL_HOOK" || exit 1
+#   G=$HOOK_SANDBOX_HOOK               # 之後一律測 $G
+#   before=$(hook_sandbox_hostsum)     # repo 那份 pending-main-push 的指紋
+#   ... 跑測試 ...
+#   hook_sandbox_assert "$before"      # 回 0＝乾淨且沙盒裡真的有留下請求
+
+# hook_sandbox <真跡 hook 的路徑> → 建好沙盒，設三個變數，回 0／1
+#   HOOK_SANDBOX_HOOK  沙盒裡那支同名 hook（之後一律測這支）
+#   HOOK_SANDBOX       沙盒根（`pending-main-push` 會長在這底下）
+#   HOOK_SANDBOX_HOST  真跡 repo 的 pending-main-push（拿來比對有沒有被弄髒）
+#
+# 🔴 **刻意不用 `printf` 把路徑印出來讓呼叫端 `G=$(hook_sandbox …)` 接**——
+#   命令替換跑在子殼裡，函式設的那三個變數**回不到呼叫端**。
+#   寫這支的當下就這樣寫，第一次跑的結果是：`HOOK_SANDBOX` 在呼叫端是空的
+#   ⇒ hostsum 兩次都回 `NODIR`（相等）、沙盒的請求數當然是 0
+#   ⇒ **第一條斷言變成「拿空的比空的」的假綠**。
+#   所以改成「設變數、不印」，而且 hook_sandbox_assert 開頭會擋空值（見下）。
+hook_sandbox() {
+  _hs_real=$1
+  _hs_hooks=$(CDPATH= cd -- "$(dirname -- "$_hs_real")" && pwd) || return 1
+  HOOK_SANDBOX=$(mktemp -d) || return 1
+  cp -R "$_hs_hooks" "$HOOK_SANDBOX/hooks" || return 1
+  HOOK_SANDBOX_HOST="${_hs_hooks%/hooks}/pending-main-push"
+  HOOK_SANDBOX_HOOK="$HOOK_SANDBOX/hooks/$(basename "$_hs_real")"
+  [ -f "$HOOK_SANDBOX_HOOK" ] || return 1
+}
+
+# hook_sandbox_hostsum → 印出真跡 repo 那份 pending-main-push 的指紋（檔名＋內容）
+# 目錄不存在時印 NODIR——「本來就沒有」跟「空的」要分得出來。
+hook_sandbox_hostsum() {
+  if [ -d "${HOOK_SANDBOX_HOST:-/nonexistent}" ]; then
+    find "$HOOK_SANDBOX_HOST" -type f 2>/dev/null | LC_ALL=C sort | while IFS= read -r _f; do
+      cksum "$_f" 2>/dev/null || printf 'UNREADABLE %s\n' "$_f"
+    done
+  else
+    printf 'NODIR\n'
+  fi
+}
+
+# hook_sandbox_assert <before 的指紋> → 印出兩行結果，全過回 0
+# 🔴 兩件都要驗，只驗前者會養出「把紀錄關掉也算通過」的假綠：
+#   ① repo 那份 pending-main-push 一個位元都沒動（測試沒有偽造待裁決）
+#   ② 沙盒那份真的多了請求檔（**留請求這件事本身還在做**）
+hook_sandbox_assert() {
+  _hs_before=$1
+  # fail-closed：沙盒沒建起來（或變數沒傳到這裡）時，下面兩條會變成「空的比空的」＝假綠。
+  if [ -z "${HOOK_SANDBOX:-}" ] || [ -z "${HOOK_SANDBOX_HOST:-}" ]; then
+    printf '  ❌ %-58s\n' "沙盒變數是空的——這兩條斷言等於沒跑，當失敗處理"
+    HS_PASS=0; HS_FAIL=2; return 1
+  fi
+  _hs_after=$(hook_sandbox_hostsum)
+  _hs_rc=0; HS_PASS=0; HS_FAIL=0
+  if [ "$_hs_before" = "$_hs_after" ]; then
+    printf '  ✅ %-58s\n' "repo 的 pending-main-push 沒被測試碰過"; HS_PASS=$((HS_PASS+1))
+  else
+    printf '  ❌ %-58s\n' "repo 的 pending-main-push 被測試寫髒了"
+    printf '     before/after diff：\n'
+    printf '%s\n' "$_hs_before" > "$HOOK_SANDBOX/.before"
+    printf '%s\n' "$_hs_after" > "$HOOK_SANDBOX/.after"
+    diff "$HOOK_SANDBOX/.before" "$HOOK_SANDBOX/.after" | sed 's/^/     /'
+    _hs_rc=1; HS_FAIL=$((HS_FAIL+1))
+  fi
+  _hs_n=$(find "$HOOK_SANDBOX/pending-main-push" -type f 2>/dev/null | wc -l | tr -d ' ')
+  if [ "${_hs_n:-0}" -gt 0 ]; then
+    printf '  ✅ %-58s（%s 筆）\n' "請求有被留下來，只是留在沙盒裡" "$_hs_n"; HS_PASS=$((HS_PASS+1))
+  else
+    printf '  ❌ %-58s\n' "沙盒裡一筆請求都沒有——留請求的機制可能被關掉了"
+    _hs_rc=1; HS_FAIL=$((HS_FAIL+1))
+  fi
+  return $_hs_rc
+}
+
+hook_sandbox_cleanup() {
+  case "${HOOK_SANDBOX:-}" in
+    /*/*) rm -rf "$HOOK_SANDBOX" ;;   # 只刪 mktemp 給的那種深路徑，不接受空值/根目錄
+  esac
+}

hooks/tests/main-and-prod-push-guard-cross-repo.test.sh

@@ -9,10 +9,21 @@
 #   路徑務必給絕對路徑——測試會 cd 進臨時建立的 A／B repo 再呼叫它，相對路徑
 #   到那時就對不上了（自己撞過一次：exit=127 command not found）。
 set -u
-G="$1"
+REAL="$1"
+
+# 🔴 測沙盒裡的複本，不測真跡：這支閘擋下推 main 時會把請求寫進
+#   `<repo>/pending-main-push/`，而這裡每一條測資都是推 main
+#   ⇒ 直接測真跡，每跑一次就在 ISEP 的工作區偽造幾筆「還沒裁」
+#   （實測留下過 `pending-main-push/unnamed--A.md`——A 是這支自己建的臨時 repo，
+#   inkstone/ISEP#59 comment 4779 第 ① 條）。收尾會驗兩件（見 lib 檔頭）。
+. "$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)/lib/hook-sandbox.sh"
+hook_sandbox "$REAL" || { echo "❌ 沙盒建不起來"; exit 1; }
+G=$HOOK_SANDBOX_HOOK
+HOSTSUM_BEFORE=$(hook_sandbox_hostsum)
+
 STAMP=/tmp/.main-push-ok
 WORK=$(mktemp -d)
-trap 'rm -rf "$WORK"; rm -f "$STAMP"' EXIT
+trap 'rm -rf "$WORK"; rm -f "$STAMP"; hook_sandbox_cleanup' EXIT
 
 for d in A B; do
   git init -q -b main "$WORK/$d"
@@ -101,5 +112,9 @@ touch -t "$(date -v-16M +%Y%m%d%H%M.%S 2>/dev/null || date -d '-16 minutes' +%Y%
 t "16 分鐘前開的戳記 → 已過期，推 B 應擋" "$A" "cd $B && git push origin HEAD:main" 2
 rm -f "$STAMP"
 
+echo "── 測試自己不准弄髒工作區（inkstone/ISEP#59）──"
+hook_sandbox_assert "$HOSTSUM_BEFORE"
+pass=$((pass+HS_PASS)); fail=$((fail+HS_FAIL))
+
 echo "────── 通過 $pass ／ 失敗 $fail"
 [ "$fail" = 0 ]

hooks/tests/main-and-prod-push-guard.test.sh

@@ -1,7 +1,17 @@
 #!/usr/bin/env bash
 # 八向實測 main-and-prod-push-guard.sh
 # 放在檔案裡跑，因為測試字串本身會觸發「舊版」那支閘（第五次誤攔）。
-G="$1"   # 要測的 hook 路徑
+REAL="$1"   # 要測的 hook 路徑（真跡）
+
+# 🔴 不要直接測真跡：這支閘擋下推 main 的同時會把請求寫進 `<repo>/pending-main-push/`，
+#   而這裡的測資全是推 main ⇒ 每跑一次就在工作區偽造幾筆「還沒裁」（inkstone/ISEP#59）。
+#   改測沙盒裡的複本，閘照原樣跑，請求寫進暫存區。收尾會驗兩件（見 lib 檔頭）。
+. "$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)/lib/hook-sandbox.sh"
+hook_sandbox "$REAL" || { echo "❌ 沙盒建不起來"; exit 1; }
+G=$HOOK_SANDBOX_HOOK
+trap 'hook_sandbox_cleanup' EXIT
+HOSTSUM_BEFORE=$(hook_sandbox_hostsum)
+
 pass=0; fail=0
 
 t() {  # t <說明> <指令> <期望 exit>
@@ -25,5 +35,9 @@ t "直接推預設分支" 'git push origin ma'"in" 2
 t "HEAD:預設分支" 'git push origin HEAD:ma'"in" 2
 t "推 master" 'git push -q origin mas'"ter" 2
 
+echo "── 測試自己不准弄髒工作區（inkstone/ISEP#59）──"
+hook_sandbox_assert "$HOSTSUM_BEFORE"
+pass=$((pass+HS_PASS)); fail=$((fail+HS_FAIL))
+
 echo "────── 通過 $pass ／ 失敗 $fail"
 [ "$fail" = "0" ]

hooks/tests/mainline-focus-guard.test.sh

@@ -0,0 +1,202 @@
+#!/usr/bin/env bash
+# 主線那一條線的迴歸測試（inkstone/ISEP#82）
+#
+# 票上四條驗收，這裡一條一群：
+#   A 「現在的主線是哪一個」→ 一個指令答得出來，而且答案唯一
+#   B 標了主線之後開新回合 → 目標宣告自己出現（不用人去翻）
+#   C 派一張不屬於主線的票 → 攔一次，並問是補收還是跳線
+#   D 沒有任何主線 → 不能整組壞掉，要講得出「現在沒有主線」
+#   E 不該擋的（誤攔比漏擋更該修）
+#
+# 用法：hooks/tests/mainline-focus-guard.test.sh
+# 🔴 全程離線：狀態走 ISEP_COUNTDOWN_STATE_DIR、時鐘走 ISEP_COUNTDOWN_NOW、
+#    「那張票掛在哪」走 ISEP_MAINLINE_FIXTURE，並把 TICKET_HOST 指到一個
+#    連不上的位址——**任何一條真的走到網路，就會在那裡當場失敗，不會靜靜地變成假綠**。
+set -u
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+GUARD="$ROOT/mainline-focus-guard.sh"
+COUNTDOWN="$ROOT/countdown-guard.sh"
+MAINLINE="$ROOT/../scripts/mainline"
+
+TMP=$(mktemp -d)
+trap 'rm -rf "$TMP"' EXIT
+export ISEP_COUNTDOWN_STATE_DIR="$TMP/state"
+export TICKET_HOST="http://127.0.0.1:9"     # 連不上：走到網路就會馬上失敗
+mkdir -p "$ISEP_COUNTDOWN_STATE_DIR"
+unset ISEP_MAINLINE_FIXTURE
+
+PASS=0; FAIL=0
+ok(){ printf '  ✅ %s\n' "$1"; PASS=$((PASS+1)); }
+no(){ printf '  ❌ %s —— %s\n' "$1" "$2"; FAIL=$((FAIL+1)); }
+
+T0=$(python3 -c 'import datetime as d;print(int(d.datetime(2026,8,28,0,0,tzinfo=d.timezone.utc).timestamp()))')
+
+# set_mainline <標題> <成員 ref...> —— 直接寫 state（離線；`mainline set` 那半要網路）
+set_mainline(){
+  python3 - "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" "$@" <<'PY'
+import json, sys
+path, title = sys.argv[1], sys.argv[2]
+json.dump({"ref": "inkstone/ISEP#57", "owner": "inkstone", "repo": "ISEP", "id": 57,
+           "title": title, "description": "把 SOP 變成閘：規則要長在機器上，不是長在誰的記性上。",
+           "due_on": "2026-08-31T15:59:59+08:00",
+           "open_issues": 12, "closed_issues": 1,
+           "members": list(sys.argv[3:]), "set_at": "2026-08-28 08:00"},
+          open(path, "w"), ensure_ascii=False)
+PY
+}
+clear_mainline(){ rm -f "$ISEP_COUNTDOWN_STATE_DIR/mainline.json"; }
+
+# dispatch <派工單內文> → "exit|訊息"
+dispatch(){
+  out=$(python3 -c '
+import json,sys; print(json.dumps({"tool_input":{"prompt":sys.argv[1]},"session_id":"t"}))' "$1" \
+    | CLAUDE_CODE_CHILD_SESSION= bash "$GUARD" 2>&1); rc=$?
+  printf '%s|%s' "$rc" "$(printf '%s' "$out" | tr '\n' ' ')"
+}
+
+# inject <now> → UserPromptSubmit 注入的內容
+inject(){
+  printf '{"hook_event_name":"UserPromptSubmit","session_id":"s","transcript_path":"%s"}' "$TMP/none.jsonl" \
+    | ISEP_COUNTDOWN_NOW="$1" bash "$COUNTDOWN" 2>/dev/null \
+    | python3 -c 'import json,sys
+try: print(json.load(sys.stdin)["hookSpecificOutput"]["additionalContext"])
+except Exception: print("")'
+}
+
+echo "── A 群：「現在的主線是哪一個」一個指令答得出來，答案唯一（驗收 1）──"
+
+clear_mainline
+OUT=$(python3 "$MAINLINE" 2>&1); RC=$?
+[ "$RC" = 0 ] && ok "① 沒標過主線 ⇒ 指令仍然回答得出來（exit 0，不是壞掉）" \
+              || no "① 沒標過主線 ⇒ exit 0" "實得 exit=$RC"
+case "$OUT" in
+  *"現在沒有主線"*) ok "② 沒標過主線 ⇒ 答案是「現在沒有主線」（驗收 4）" ;;
+  *) no "② 沒標過 ⇒ 說「現在沒有主線」" "實得：$OUT" ;;
+esac
+
+set_mainline "SOP 變成閘" "inkstone/ISEP#82" "inkstone/ISEP#57"
+OUT=$(python3 "$MAINLINE" 2>&1)
+N=$(printf '%s\n' "$OUT" | grep -c "現在的主線")
+[ "$N" = 1 ] && ok "③ 標了之後 ⇒ 只有一個答案（「現在的主線」出現 1 次，不是 14 個）" \
+             || no "③ 答案唯一" "「現在的主線」出現 $N 次"
+case "$OUT" in
+  *"SOP 變成閘"*) ok "④ 答案指名道姓（標題印出來了）" ;;
+  *) no "④ 答案指名道姓" "實得：$OUT" ;;
+esac
+
+set_mainline "換一條線" "inkstone/ISEP#82"
+# 🔴 只看標題那一行：描述欄裡本來就會提到舊標題（它是同一份測資），
+#    拿整份輸出去比對會**因為描述而誤判**——那不是「舊的還是主線」。
+OUT=$(python3 "$MAINLINE" 2>&1 | head -1)
+case "$OUT" in
+  *"SOP 變成閘"*) no "⑤ 換標一條 ⇒ 舊的不再是主線" "舊標題還在：$OUT" ;;
+  *"換一條線"*) ok "⑤ 換標一條 ⇒ 舊的當場不再是主線（一個檔放得下一條）" ;;
+  *) no "⑤ 換標一條" "實得：$OUT" ;;
+esac
+
+echo "── B 群：標了之後開新回合，目標宣告自己出現（驗收 2）──────────"
+
+set_mainline "SOP 變成閘" "inkstone/ISEP#82"
+CTX=$(inject "$T0")
+case "$CTX" in
+  *"🎯 主線："*) ok "⑥ 什麼都沒交代 ⇒ 注入裡有 🎯 主線那一行" ;;
+  *) no "⑥ 注入裡有 🎯 主線那一行" "實得：$CTX" ;;
+esac
+case "$CTX" in
+  *"SOP 變成閘"*) ok "⑦ 注入裡有主線的名字" ;;
+  *) no "⑦ 注入裡有主線的名字" "實得：$CTX" ;;
+esac
+case "$CTX" in
+  *"目標：把 SOP 變成閘"*) ok "⑧ 注入裡有**目標宣告**（milestone 的描述），不用人去翻" ;;
+  *) no "⑧ 注入裡有目標宣告" "實得：$CTX" ;;
+esac
+# ⏱ 那一行是**已經有 Stop 閘在查**的那一行（ISEP#63）。主線的名字掛在它上面，
+# 就跟著那道驗過的閘一起到 leo 眼前——不必為了同一件事再立第二道會擋人的閘。
+FIRST=$(printf '%s\n' "$CTX" | head -1)
+case "$FIRST" in
+  *"⏱"*"主線 SOP 變成閘"*) ok "⑨ 被查核的那一行（⏱）也帶著主線名字 ⇒ 主線會到 leo 眼前" ;;
+  *) no "⑨ ⏱ 那一行帶主線名字" "實得：$FIRST" ;;
+esac
+# 被標定的主線要蓋過「期限最近的那個」快取——後者是猜的，前者是被指定的
+printf '2026-08-29|某個期限更近的\n' > "$ISEP_COUNTDOWN_STATE_DIR/milestone-due"
+FIRST=$(inject "$T0" | head -1)
+case "$FIRST" in
+  *"主線 SOP 變成閘"*) ok "⑩ 標定的主線蓋過「期限最近」的猜測（不准用猜的蓋過指定的）" ;;
+  *) no "⑩ 標定的主線優先" "實得：$FIRST" ;;
+esac
+rm -f "$ISEP_COUNTDOWN_STATE_DIR/milestone-due"
+
+clear_mainline
+CTX=$(inject "$T0")
+case "$CTX" in
+  *"現在沒有主線"*) ok "⑪ 沒有主線 ⇒ 注入照樣講得出「現在沒有主線」（驗收 4，不編一條）" ;;
+  *) no "⑪ 沒有主線 ⇒ 注入講「現在沒有主線」" "實得：$CTX" ;;
+esac
+
+echo "── C 群：派了不在主線上的票 ⇒ 攔一次並問清楚（驗收 3）──────────"
+
+set_mainline "SOP 變成閘" "inkstone/ISEP#82" "inkstone/ISEP#57"
+printf '{"inkstone/Arcrun#50":"AI 問得到內文"}\n' > "$TMP/fx.json"
+export ISEP_MAINLINE_FIXTURE="$TMP/fx.json"
+
+R=$(dispatch '【工單】inkstone/ISEP#82')
+[ "${R%%|*}" = 0 ] && ok "⑫ 派主線上的票 ⇒ 放行" || no "⑫ 派主線上的票 ⇒ 放行" "實得 exit=${R%%|*}"
+
+R=$(dispatch '【工單】inkstone/Arcrun#50')
+[ "${R%%|*}" = 2 ] && ok "⑬ 派不在主線上的票 ⇒ 擋" || no "⑬ 派不在主線上的票 ⇒ 擋" "實得 exit=${R%%|*}"
+case "${R#*|}" in
+  *"補收"*"跳線"*) ok "⑭ 擋下時問的是「補收還是跳線」，兩條路都給了指令" ;;
+  *) no "⑭ 訊息問補收/跳線" "實得：${R#*|}" ;;
+esac
+case "${R#*|}" in
+  *"SOP 變成閘"*) ok "⑮ 擋下時說得出現在的主線是誰（不是只說「你錯了」）" ;;
+  *) no "⑮ 訊息說出主線是誰" "實得：${R#*|}" ;;
+esac
+
+R=$(dispatch '【工單】inkstone/Arcrun#50')
+[ "${R%%|*}" = 0 ] && ok "⑯ 同一張票重送 ⇒ 放行（至多擋一次，不鬼打牆）" \
+                  || no "⑯ 重送 ⇒ 放行" "實得 exit=${R%%|*}"
+
+J=$(wc -l < "$ISEP_COUNTDOWN_STATE_DIR/mainline-jumps.jsonl" 2>/dev/null || echo 0)
+[ "$J" -ge 1 ] && ok "⑰ 跳線留痕（mainline-jumps.jsonl 記了一筆）——不留痕的話跳線與專注長得一樣" \
+               || no "⑰ 跳線留痕" "jumps 檔有 $J 行"
+
+R=$(dispatch '【工單】inkstone/Arcrun#50
+【工單】inkstone/ISEP#82')
+[ "${R%%|*}" = 0 ] && ok "⑱ 多張票只要有一張在主線上 ⇒ 放行（那次派工有在推主線）" \
+                  || no "⑱ 多張票有一張在主線 ⇒ 放行" "實得 exit=${R%%|*}"
+
+echo "── D／E 群：不該擋（誤攔比漏擋更該修）──────────────────────────"
+
+clear_mainline
+R=$(dispatch '【工單】inkstone/Arcrun#50')
+[ "${R%%|*}" = 0 ] && ok "⑲ 沒有主線 ⇒ 一律放行（驗收 4：不能整組壞掉）" \
+                  || no "⑲ 沒有主線 ⇒ 放行" "實得 exit=${R%%|*}"
+
+set_mainline "SOP 變成閘" "inkstone/ISEP#82"
+R=$(dispatch '幫我看一下這個 repo 的狀況')
+[ "${R%%|*}" = 0 ] && ok "⑳ 派工單裡沒有票號 ⇒ 放行（那是 no-ticket-no-dispatch 的地盤）" \
+                  || no "⑳ 沒有票號 ⇒ 放行" "實得 exit=${R%%|*}"
+
+out=$(python3 -c '
+import json;print(json.dumps({"tool_input":{"prompt":"【工單】inkstone/Arcrun#50"},"session_id":"t"}))' \
+      | CLAUDE_CODE_CHILD_SESSION=1 bash "$GUARD" 2>&1); rc=$?
+[ "$rc" = 0 ] && ok "㉑ 子 session ⇒ 放行（主線是派工者手上的判準，不是收工方要背的）" \
+             || no "㉑ 子 session ⇒ 放行" "實得 exit=$rc"
+
+unset ISEP_MAINLINE_FIXTURE
+R=$(dispatch '【工單】inkstone/mira#999')
+[ "${R%%|*}" = 0 ] && ok "㉒ 問不到那張票掛在哪（沒 fixture、網路也不通）⇒ 放行：讀不到 ≠ 不屬於" \
+                  || no "㉒ 問不到 ⇒ 放行" "實得 exit=${R%%|*}"
+
+printf 'not json {{{\n' > "$ISEP_COUNTDOWN_STATE_DIR/mainline.json"
+R=$(dispatch '【工單】inkstone/Arcrun#50')
+[ "${R%%|*}" = 0 ] && ok "㉓ state 檔壞掉 ⇒ 放行（節拍器壞掉不該讓派工停擺）" \
+                  || no "㉓ state 壞掉 ⇒ 放行" "實得 exit=${R%%|*}"
+OUT=$(python3 "$MAINLINE" 2>&1); RC=$?
+[ "$RC" = 0 ] && ok "㉔ state 檔壞掉 ⇒ 指令仍然回答得出來（當成「現在沒有主線」）" \
+             || no "㉔ state 壞掉 ⇒ 指令不崩" "實得 exit=$RC：$OUT"
+
+echo
+echo "結果：通過 $PASS 條，失敗 $FAIL 條"
+[ "$FAIL" -eq 0 ] || exit 1

hooks/tests/mainline-idle-guard.test.sh

@@ -0,0 +1,187 @@
+#!/usr/bin/env bash
+# mainline-idle-guard.sh 的迴歸測試（inkstone/ISEP#30 → comment 4851）
+#
+# 兩個方向都要有證據：
+#   A 群「不該擋」——回答問題、輕量回合、任何一種推進證據、未達門檻、響過之後退讓
+#   B 群「該擋」  ——連續乾回合（有動作、零推進）踩到門檻
+#   C 群「訊息承諾的出路真的走得通」——擋完歸零、門檻加倍
+#
+# 用法：hooks/tests/mainline-idle-guard.test.sh [hooks/mainline-idle-guard.sh 的路徑]
+# 🔴 全程在乾淨的 TMP 底下造假 transcript 與假狀態檔，跑完自己清；
+#    不碰任何真 repo、不打網路、不寫 /tmp 的正式狀態檔（走 MAINLINE_IDLE_STATE_DIR）。
+set -u
+HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/mainline-idle-guard.sh}"
+TMP=$(mktemp -d)
+trap 'rm -rf "$TMP"' EXIT
+
+PASS=0; FAIL=0; N=0
+
+# append_turn <transcript> <block spec>...
+#   block spec：`T:<文字>` ＝ assistant 文字段；`U:<工具名>` ＝ tool_use；
+#               `B:<指令>` ＝ Bash tool_use（帶 command）
+append_turn() {
+  python3 - "$@" <<'PY'
+import json, sys
+path, specs = sys.argv[1], sys.argv[2:]
+blocks = []
+for s in specs:
+    k, v = s.split(":", 1)
+    if k == "T":
+        blocks.append({"type": "text", "text": v})
+    elif k == "B":
+        blocks.append({"type": "tool_use", "name": "Bash", "id": "t", "input": {"command": v}})
+    else:
+        blocks.append({"type": "tool_use", "name": v, "id": "t", "input": {}})
+with open(path, "a") as f:
+    f.write(json.dumps({"type": "user",
+                        "message": {"content": [{"type": "text", "text": "繼續"}]}},
+                       ensure_ascii=False) + "\n")
+    f.write(json.dumps({"type": "assistant", "message": {"content": blocks}},
+                       ensure_ascii=False) + "\n")
+PY
+}
+
+# fire <session> <transcript> <期望 exit> <說明> [extra-json]
+fire() {
+  sid="$1"; tr="$2"; want="$3"; desc="$4"; extra="${5:-}"
+  N=$((N+1))
+  payload=$(printf '{"session_id":"%s","transcript_path":"%s"%s}' "$sid" "$tr" "$extra")
+  out=$(printf '%s' "$payload" \
+        | CLAUDE_PROJECT_DIR="${PROJ_OVERRIDE:-$TMP}" \
+          MAINLINE_IDLE_STATE_DIR="$TMP" bash "$HOOK" 2>&1); rc=$?
+  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' "$out" | sed -n '1,6p' | sed 's/^/     /'
+    FAIL=$((FAIL+1))
+  fi
+}
+
+# 造一個新 session 的 transcript，並吃掉第一次的 baseline
+new_session() {
+  sid="$1"; tr="$TMP/$sid.jsonl"; : > "$tr"
+  append_turn "$tr" 'U:Read'
+  printf '{"session_id":"%s","transcript_path":"%s"}' "$sid" "$tr" \
+    | CLAUDE_PROJECT_DIR="${PROJ_OVERRIDE:-$TMP}" MAINLINE_IDLE_STATE_DIR="$TMP" \
+      bash "$HOOK" >/dev/null 2>&1
+  echo "$tr"
+}
+
+DRY=(U:Read U:Grep B:git\ status U:Read)   # 4 個動作、零推進 ＝ 乾回合
+
+echo "── A 群：不該擋 ────────────────────────────────────────────"
+
+tr=$(new_session s-light)
+fire s-light "$tr" 0 "① 第一次見到這個 session（立基準，不評分）"
+
+# 票上第 3 條驗收：回答一個不需要派工的問題 ⇒ 放行（且**不計數**）
+for i in 1 2 3 4 5; do
+  append_turn "$tr" 'U:Read' 'U:Grep' "T:查了一下，答案是 X。"
+  fire s-light "$tr" 0 "② 回答問題的輕量回合（2 個動作）第 $i 次——連 5 次都不該擋"
+done
+
+tr=$(new_session s-dispatch)
+for i in 1 2 3 4; do
+  append_turn "$tr" "${DRY[@]}" 'U:Agent'
+  fire s-dispatch "$tr" 0 "③ 有派工（Agent）第 $i 次 ⇒ 永遠歸零"
+done
+
+tr=$(new_session s-send)
+for i in 1 2 3 4; do
+  append_turn "$tr" "${DRY[@]}" 'U:SendMessage'
+  fire s-send "$tr" 0 "④ 驅動既有 agent（SendMessage）第 $i 次"
+done
+
+tr=$(new_session s-write)
+for i in 1 2 3 4; do
+  append_turn "$tr" "${DRY[@]}" 'U:Edit'
+  fire s-write "$tr" 0 "⑤ 有產出（Edit）第 $i 次"
+done
+
+tr=$(new_session s-ticket)
+for i in 1 2 3 4; do
+  append_turn "$tr" 'U:Read' 'U:Grep' 'B:scripts/ticket say inkstone/ISEP#30 -F /tmp/x.md'
+  fire s-ticket "$tr" 0 "⑥ 寫回票（scripts/ticket say）第 $i 次"
+done
+
+tr=$(new_session s-mcp)
+for i in 1 2 3 4; do
+  append_turn "$tr" "${DRY[@]}" 'U:mcp__x__kbdb_create_record'
+  fire s-mcp "$tr" 0 "⑦ 寫進外部系統（kbdb_create_record）第 $i 次"
+done
+
+tr=$(new_session s-under)
+for i in 1 2 3; do
+  append_turn "$tr" "${DRY[@]}"; fire s-under "$tr" 0 "⑧ 第 $i 個乾回合——未達門檻（4），不擋"
+done
+
+tr=$(new_session s-active)
+append_turn "$tr" "${DRY[@]}"
+fire s-active "$tr" 0 "⑩ stop_hook_active（已被別的 Stop 閘擋過）⇒ 不計數" ',"stop_hook_active":true'
+append_turn "$tr" "${DRY[@]}"
+fire s-active "$tr" 0 "⑪ 同上，第 2 次仍不擋（不會被別的閘的擋下推著累積）" ',"stop_hook_active":true'
+
+tr=$(new_session s-dup)
+append_turn "$tr" "${DRY[@]}"
+fire s-dup "$tr" 0 "⑫ 同一個回合被叫兩次（transcript 沒長）——第 1 次"
+fire s-dup "$tr" 0 "⑬ 同上第 2 次：不重複計數"
+fire s-dup "$tr" 0 "⑭ 同上第 3 次：仍不擋（重複呼叫不該累積成擋下）"
+
+fire s-bad "$TMP/does-not-exist.jsonl" 0 "⑮ 讀不到 transcript ⇒ 放行（不亂擋）"
+
+echo "── B 群：該擋 ──────────────────────────────────────────────"
+
+tr=$(new_session s-idle)
+for i in 1 2 3; do
+  append_turn "$tr" "${DRY[@]}"; fire s-idle "$tr" 0 "⑯ 乾回合 $i／4"
+done
+append_turn "$tr" "${DRY[@]}"; fire s-idle "$tr" 2 "⑰ 乾回合 4／4 ⇒ **擋下**"
+
+tr=$(new_session s-idle2)
+for i in 1 2 3; do
+  append_turn "$tr" 'U:Read' 'U:Read' 'U:Read'; fire s-idle2 "$tr" 0 "⑱ 純唯讀乾回合 $i／4"
+done
+append_turn "$tr" 'U:Bash' 'U:Bash' 'U:Read'; fire s-idle2 "$tr" 2 "⑲ 唯讀 Bash 也算乾回合 ⇒ **擋下**"
+
+echo "── C 群：響過就退讓（訊息裡承諾的出路真的存在）───────────────"
+
+# 接續 s-idle：它剛在 ⑰ 被擋過 ⇒ 計數歸零、門檻 4→8
+tr="$TMP/s-idle.jsonl"
+for i in 1 2 3 4 5 6 7; do
+  append_turn "$tr" "${DRY[@]}"
+  fire s-idle "$tr" 0 "⑳ 擋過之後第 $i 個乾回合——門檻已加倍（4→8），不該再響"
+done
+append_turn "$tr" "${DRY[@]}"
+fire s-idle "$tr" 2 "㉑ 第 8 個乾回合 ⇒ 再擋一次（門檻 8）"
+
+# 量測用的旋鈕要真的有效（檔頭那份實測靠它重跑）
+export MAINLINE_IDLE_THRESHOLD=2
+tr=$(new_session s-th)
+append_turn "$tr" "${DRY[@]}"; fire s-th "$tr" 0 "㉒ MAINLINE_IDLE_THRESHOLD=2：第 1 個乾回合"
+append_turn "$tr" "${DRY[@]}"; fire s-th "$tr" 2 "㉓ 同上第 2 個 ⇒ 擋（證明門檻可被量測腳本改）"
+unset MAINLINE_IDLE_THRESHOLD
+
+echo "── D 群：工作區狀態變了就算推進（heredoc／sed 改檔吃得到）──────"
+
+REPO="$TMP/repo"; mkdir -p "$REPO"
+git -C "$REPO" init -q 2>/dev/null
+git -C "$REPO" config user.email t@t; git -C "$REPO" config user.name t
+echo a > "$REPO/a.txt"; git -C "$REPO" add -A; git -C "$REPO" commit -qm init
+PROJ_OVERRIDE="$REPO"
+tr=$(new_session s-git)
+for i in 1 2 3; do
+  append_turn "$tr" "${DRY[@]}"; fire s-git "$tr" 0 "㉔ 乾回合 $i／4（工作區沒動）"
+done
+# 用 heredoc／sed 改檔——工具名是 Bash、指令不在白名單，只有狀態指紋看得出來
+echo "changed by heredoc" >> "$REPO/a.txt"
+append_turn "$tr" "${DRY[@]}"; fire s-git "$tr" 0 "㉕ 第 4 個乾回合，但工作區變了 ⇒ 算推進，不擋"
+for i in 1 2 3; do
+  append_turn "$tr" "${DRY[@]}"; fire s-git "$tr" 0 "㉖ 之後乾回合 $i／4（證明上一格真的歸零過）"
+done
+append_turn "$tr" "${DRY[@]}"; fire s-git "$tr" 2 "㉗ 乾回合 4／4 ⇒ **擋下**"
+PROJ_OVERRIDE=""
+
+echo
+printf '結果：%s 通過 / %s 失敗（共 %s 條）\n' "$PASS" "$FAIL" "$N"
+[ "$FAIL" -eq 0 ] || exit 1

hooks/tests/milestone-account-guard.test.sh

@@ -0,0 +1,85 @@
+#!/usr/bin/env bash
+# milestone-account-guard.sh 的迴歸測試（inkstone/ISEP#85）
+#
+#   A 群「不該擋」——純讀取／建里程碑／改別的欄位／只是談論它／heredoc 內文／
+#                    走正門 `milestone-account close`／已經記過帳／解析不出來
+#   B 群「該擋」  ——真的用 curl／python 把某一個里程碑 PATCH 成 closed，而帳本裡沒有它
+#   C 群「訊息承諾的出路真的走得通」——記過帳之後立刻不再擋；加了豁免字樣就放行
+#
+# 🔴 全程離線：帳本走 MILESTONE_ACCOUNT_LEDGER 指到 mktemp 的檔，不打 Gitea。
+#    **誤攔比漏擋更該修**——A 群任何一條紅，就是這支閘在懲罰謹慎。
+set -u
+HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/milestone-account-guard.sh}"
+TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
+LED="$TMP/ledger.jsonl"; : > "$LED"
+PASS=0; FAIL=0; N=0
+
+fire() {
+  want="$1"; desc="$2"; cmd="$3"
+  N=$((N+1))
+  payload=$(python3 -c 'import json,sys; print(json.dumps({"tool_input":{"command":sys.argv[1]}}))' "$cmd")
+  out=$(printf '%s' "$payload" | MILESTONE_ACCOUNT_LEDGER="$LED" bash "$HOOK" 2>&1 >/dev/null); rc=$?
+  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' "$out" | sed -n '1,6p' | sed 's/^/     /'; FAIL=$((FAIL+1))
+  fi
+}
+
+CLOSE='curl -s -X PATCH -H "Authorization: token X" -d {"state":"closed"} https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones/12'
+
+echo "── A 群：不該擋（誤攔比漏擋更該修）─────────────────────────"
+fire 0 "① 空指令" ""
+fire 0 "② 純 GET 撈里程碑" \
+  'curl -s https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones/12'
+fire 0 "③ 列出所有里程碑" \
+  'curl -s "https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones?state=open"'
+fire 0 "④ 建一個新里程碑（那是 milestone-due-guard 管的，不是這支）" \
+  'curl -X POST -d {"title":"x","due_on":"2026-09-05T23:59:59Z"} https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones'
+fire 0 "⑤ PATCH 但只是改期限，沒有要關它" \
+  'curl -X PATCH -d {"due_on":"2026-09-05T23:59:59Z"} https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones/12'
+fire 0 "⑥ 只是談論它（echo 在指令位置，curl 在字串裡）" \
+  "echo '$CLOSE'"
+fire 0 "⑦ 讀這支閘自己的原始碼" 'cat hooks/milestone-account-guard.sh'
+fire 0 "⑧ commit 訊息裡出現「關掉 milestone」" \
+  'git commit -m "關掉 milestone 12，state closed"'
+fire 0 "⑨ 走正門：scripts/milestone-account close" \
+  'python3 scripts/milestone-account close inkstone/ISEP#12 --reason idle'
+fire 0 "⑩ 正門的 --dry-run" \
+  'python3 scripts/milestone-account close inkstone/ISEP#12 --reason idle --dry-run'
+fire 0 "⑪ 把那段指令寫進文件（heredoc 內文是資料不是指令）" \
+  "$(printf 'cat > docs/x.md <<%s\n%s\nEOD\n' "'EOD'" "$CLOSE")"
+fire 0 "⑫ 網址沒有里程碑編號（抽不出目標 ⇒ 不擋）" \
+  'curl -X PATCH -d {"state":"closed"} https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones'
+fire 0 "⑬ 關的是一張票不是里程碑" \
+  'curl -X PATCH -d {"state":"closed"} https://git.uncle6.me/api/v1/repos/inkstone/ISEP/issues/12'
+
+echo "── B 群：該擋 ──────────────────────────────────────────────"
+fire 2 "⑭ curl PATCH state=closed，帳本裡沒有它" "$CLOSE"
+fire 2 "⑮ 換成 python urllib（method=\"PATCH\"）一樣擋" \
+  'python3 -c "import urllib.request,json; urllib.request.urlopen(urllib.request.Request(\"https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones/12\", data=json.dumps({\"state\":\"closed\"}).encode(), method=\"PATCH\"))"'
+fire 2 "⑯ 前面串一個無害指令也擋（不是靠前綴判斷）" "ls && $CLOSE"
+fire 2 "⑰ --request PATCH 的長寫法" \
+  'curl --request PATCH --data {"state":"closed"} https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones/12'
+fire 2 "⑱ 別的 repo 的里程碑一樣管" \
+  'curl -X PATCH -d {"state":"closed"} https://git.uncle6.me/api/v1/repos/inkstone/arcrun-rag/milestones/47'
+
+echo "── C 群：訊息承諾的出路真的走得通 ──────────────────────────"
+N=$((N+1))
+out=$(python3 -c 'import json,sys; print(json.dumps({"tool_input":{"command":sys.argv[1]}}))' "$CLOSE" \
+      | MILESTONE_ACCOUNT_LEDGER="$LED" bash "$HOOK" 2>&1 >/dev/null)
+if printf '%s' "$out" | grep -q "scripts/milestone-account audit inkstone/ISEP#12"; then
+  printf '  ✅ ⑲ 訊息直接給出可以照打的那一行（含正確的 owner/repo#編號）\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ⑲ 訊息沒有點名目標\n'; FAIL=$((FAIL+1))
+fi
+
+echo '{"ref": "inkstone/ISEP#12", "reason": "idle"}' >> "$LED"
+fire 0 "⑳ 記過帳之後立刻放行（正門是先記帳再關）" "$CLOSE"
+fire 2 "㉑ 但別的里程碑還是照擋（不是一記帳就全開）" \
+  'curl -X PATCH -d {"state":"closed"} https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones/13'
+fire 0 "㉒ 明講的豁免字樣（留痕）" "$CLOSE # milestone-account-ok"
+
+echo
+echo "通過 $PASS 條，失敗 $FAIL 條（共 $N 條）"
+[ "$FAIL" -eq 0 ]

hooks/tests/pr-verdict-guard.test.sh

@@ -0,0 +1,220 @@
+#!/usr/bin/env bash
+# pr-verdict-guard.sh 的迴歸測試（inkstone/ISEP#81）
+#
+# 兩個方向都要有證據：
+#   A 群「不該擋」——沒有 PR／有人指派／掛 Human／draft／不在 org／剛開出來／
+#                    這回合動過／這回合指名過／已有 REQUEST_CHANGES／已被別的閘擋過／
+#                    merge 完分支已刪／fixture 壞掉
+#   B 群「該擋」  ——沒人管的 open PR、放著不管一回合、merge 了但分支還在、
+#                    以及**票上那三個躺了兩週的真跡**
+#   C 群「訊息承諾的出路真的走得通」——擋完歸零門檻加倍、指派下去立刻閉嘴
+#
+# 🔴 全程離線（PR_VERDICT_FIXTURE），不打 Gitea、不留任何測試票／測試 PR。
+#    狀態檔走 PR_VERDICT_STATE_DIR，不碰 /tmp 的正式檔。
+#
+# 用法：hooks/tests/pr-verdict-guard.test.sh [hooks/pr-verdict-guard.sh 的路徑]
+set -u
+HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/pr-verdict-guard.sh}"
+TMP=$(mktemp -d)
+trap 'rm -rf "$TMP"' EXIT
+
+PASS=0; FAIL=0; N=0
+NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+OLD="2026-08-13T04:34:01Z"
+
+# fixture <檔名> <PR 規格...>
+#   PR 規格：ref|updated|created|assignee|labels|draft
+mkfx() { python3 - "$@" <<'PY'
+import json, sys, os
+path, specs = sys.argv[1], sys.argv[2:]
+extra = {}
+if os.path.exists(path):
+    extra = json.load(open(path))
+pulls = []
+for s in specs:
+    ref, upd, crt, asg, lbl, draft = (s.split("|") + [""] * 6)[:6]
+    full, num = ref.split("#")
+    pulls.append({
+        "number": int(num),
+        "title": "測試 PR " + ref,
+        "created_at": crt, "updated_at": upd,
+        "repository": {"full_name": full, "id": 1},
+        "assignees": [{"login": a} for a in asg.split(",") if a],
+        "labels": [{"name": n} for n in lbl.split(",") if n],
+        "pull_request": {"merged": False, "draft": draft == "draft",
+                         "html_url": "https://git.uncle6.me/%s/pulls/%s" % (full, num)},
+    })
+extra["pulls"] = pulls
+json.dump(extra, open(path, "w"), ensure_ascii=False)
+PY
+}
+
+# 加一筆「這個 PR 已經被 merge，head 分支叫 X」的細節，以及分支還在不在
+mkdetail() { python3 - "$@" <<'PY'
+import json, sys, os
+path, ref, branch, alive = sys.argv[1:5]
+d = json.load(open(path)) if os.path.exists(path) else {}
+full = ref.split("#")[0]
+d.setdefault("detail", {})[ref] = {
+    "merged": True, "head": {"ref": branch, "repo": {"full_name": full}}}
+d.setdefault("branches", {})["%s:%s" % (full, branch)] = (alive == "alive")
+json.dump(d, open(path, "w"), ensure_ascii=False)
+PY
+}
+
+mkreview() { python3 - "$@" <<'PY'
+import json, sys, os
+path, ref, state = sys.argv[1:4]
+d = json.load(open(path)) if os.path.exists(path) else {}
+d.setdefault("reviews", {})[ref] = [{"state": state}]
+json.dump(d, open(path, "w"), ensure_ascii=False)
+PY
+}
+
+# 造一份「這一回合叫過這些工具、輸入長這樣」的 transcript
+mktranscript() { python3 - "$@" <<'PY'
+import json, sys
+path = sys.argv[1]
+with open(path, "w") as f:
+    f.write(json.dumps({"type": "user",
+                        "message": {"content": [{"type": "text", "text": "繼續"}]}}) + "\n")
+    blocks = [{"type": "tool_use", "name": "Bash", "id": "t",
+               "input": {"command": c}} for c in sys.argv[2:]]
+    f.write(json.dumps({"type": "assistant", "message": {"content": blocks}},
+                       ensure_ascii=False) + "\n")
+PY
+}
+
+# fire <session> <fixture> <期望 exit> <說明> [transcript] [extra-json] [必須出現的字串]
+fire() {
+  sid="$1"; fx="$2"; want="$3"; desc="$4"; tr="${5:-/nonexistent}"; extra="${6:-}"; must="${7:-}"
+  N=$((N+1))
+  payload=$(printf '{"session_id":"%s","transcript_path":"%s"%s}' "$sid" "$tr" "$extra")
+  out=$(printf '%s' "$payload" | PR_VERDICT_FIXTURE="$fx" PR_VERDICT_STATE_DIR="$TMP" \
+        CLAUDE_PROJECT_DIR="$TMP" bash "$HOOK" 2>&1 >/dev/null); rc=$?
+  ok=1
+  [ "$rc" -eq "$want" ] || ok=0
+  if [ -n "$must" ] && ! printf '%s' "$out" | grep -qF "$must"; then ok=0; fi
+  if [ "$ok" -eq 1 ]; then
+    printf '  ✅ %s\n' "$desc"; PASS=$((PASS+1))
+  else
+    printf '  ❌ %s —— 期望 exit=%s%s，實得 exit=%s\n' "$desc" "$want" \
+      "${must:+ 且訊息含「$must」}" "$rc"
+    printf '%s\n' "$out" | sed -n '1,8p' | sed 's/^/     /'
+    FAIL=$((FAIL+1))
+  fi
+}
+
+echo "── A 群：不該擋 ────────────────────────────────────────────"
+
+FX="$TMP/empty.json"; mkfx "$FX"
+fire s-empty "$FX" 0 "① 一個 open PR 都沒有 ⇒ 放行"
+
+FX="$TMP/assigned.json"; mkfx "$FX" "inkstone/Arcrun#104|$OLD|$OLD|Leo||"
+fire s-asg "$FX" 0 "② 有人被指派（棒子在他手上＝在等，不是忘了）⇒ 不點名"
+
+FX="$TMP/human.json"; mkfx "$FX" "inkstone/Arcrun#104|$OLD|$OLD||Human,p/high|"
+fire s-hum "$FX" 0 "③ 掛了 Human（等 leo 親手做）⇒ 不點名"
+
+FX="$TMP/draft.json"; mkfx "$FX" "inkstone/Arcrun#104|$OLD|$OLD|||draft"
+fire s-drf "$FX" 0 "④ draft（作者自己說還沒好）⇒ 不點名"
+
+FX="$TMP/otherorg.json"; mkfx "$FX" "Leo/Arcrun#104|$OLD|$OLD|||"
+fire s-org "$FX" 0 "⑤ 不在 inkstone org（舊 org 的鏡像）⇒ 不點名"
+
+FX="$TMP/review.json"; mkfx "$FX" "inkstone/Arcrun#104|$OLD|$OLD|||"
+mkreview "$FX" "inkstone/Arcrun#104" "REQUEST_CHANGES"
+fire s-rev "$FX" 0 "⑥ 已經留了 REQUEST_CHANGES（結論給過了，球在對方腳下）⇒ 不點名"
+
+FX="$TMP/active.json"; mkfx "$FX" "inkstone/Arcrun#104|$OLD|$OLD|||"
+fire s-act "$FX" 0 "⑦ stop_hook_active（已被別的 Stop 閘擋過）⇒ 不疊擋" \
+  /nonexistent ',"stop_hook_active":true'
+
+fire s-bad "$TMP/does-not-exist.json" 0 "⑧ fixture 讀不到 ⇒ 放行（Stop 閘不准把 session 鎖死）"
+
+echo "── B 群：該擋 ──────────────────────────────────────────────"
+
+# 票上那三個真跡（真實 ref、真實開票日）
+FX="$TMP/real.json"
+mkfx "$FX" \
+  "inkstone/arcrun-rag#91|$OLD|$OLD|||" \
+  "inkstone/Arcrun#116|2026-08-13T05:24:51Z|2026-08-13T05:24:51Z|||" \
+  "inkstone/Arcrun#104|2026-08-12T08:51:06Z|2026-08-12T08:51:06Z|||"
+fire s-real "$FX" 2 "⑨ 真跡重演：三個躺了兩週的 PR ⇒ **擋下**" \
+  /nonexistent '' 'inkstone/arcrun-rag#91'
+FX2="$TMP/real2.json"; cp "$FX" "$FX2"
+fire s-real2 "$FX2" 2 "⑩ 同上，訊息要點名 inkstone/Arcrun#116" \
+  /nonexistent '' 'inkstone/Arcrun#116'
+FX3="$TMP/real3.json"; cp "$FX" "$FX3"
+fire s-real3 "$FX3" 2 "⑪ 同上，訊息要點名 inkstone/Arcrun#104" \
+  /nonexistent '' 'inkstone/Arcrun#104'
+
+echo "── C 群：驗收條件 1–3（開著不管 → 擋；merge → 放行；分支要不見）──"
+
+# 驗收 1：一個新 PR 出現（不在它誕生那回合開罵），下一回合放著不管 ⇒ 擋
+FX="$TMP/ac.json"; mkfx "$FX"
+fire s-ac "$FX" 0 "⑫ 基準回合：目前沒有 PR"
+mkfx "$FX" "inkstone/ISEP#999|$NOW|$NOW|||"
+fire s-ac "$FX" 0 "⑬ PR 剛開出來（上一回合還不存在）⇒ 不在它誕生的回合開罵"
+fire s-ac "$FX" 2 "⑭ **驗收 1**：開著放著不管，收工 ⇒ 擋下，且點名它" \
+  /nonexistent '' 'inkstone/ISEP#999'
+
+# 驗收 2＋3：merge 掉（PR 從 open 清單消失）且分支已刪 ⇒ 放行
+mkfx "$FX"                                   # #999 從 open 清單消失
+mkdetail "$FX" "inkstone/ISEP#999" "feat/x" "gone"
+fire s-ac "$FX" 0 "⑮ **驗收 2＋3**：merge 掉且分支已不存在 ⇒ 放行"
+
+# 驗收 3 的反面：merge 了但分支還在 ＝ 結論只給了一半 ⇒ 擋
+FX="$TMP/left.json"; mkfx "$FX" "inkstone/ISEP#998|$NOW|$NOW|||"
+fire s-left "$FX" 2 "⑯ 先讓 #998 進到快照（沒人管 ⇒ 擋一次）" \
+  /nonexistent '' 'inkstone/ISEP#998'
+mkfx "$FX"                                   # 消失了
+mkdetail "$FX" "inkstone/ISEP#998" "feat/y" "alive"
+fire s-left "$FX" 2 "⑰ **驗收 3**：merge 了但分支 feat/y 還在 ⇒ 擋下並點名分支" \
+  /nonexistent '' 'feat/y'
+mkfx "$FX"; mkdetail "$FX" "inkstone/ISEP#998" "feat/y" "gone"
+fire s-left "$FX" 0 "⑱ 分支刪掉之後 ⇒ 放行（清單會自己清乾淨）"
+
+echo "── D 群：這一回合碰過它就不點名（不讀任何一句話）──────────────"
+
+FX="$TMP/touch.json"; mkfx "$FX" "inkstone/ISEP#997|$OLD|$OLD|||"
+fire s-t1 "$FX" 2 "⑲ 沒人管 ⇒ 擋一次（建立基準）"
+# updated_at 動了 ＝ 外部系統的事實（留言／推 commit／改標籤都會動它）
+mkfx "$FX" "inkstone/ISEP#997|$NOW|$OLD|||"
+for i in 1 2 3 4 5; do
+  fire s-t1 "$FX" 0 "⑳ updated_at 變了（這回合真的動過它）第 $i 次 ⇒ 不點名"
+  mkfx "$FX" "inkstone/ISEP#997|$NOW-$i|$OLD|||"
+done
+
+FX="$TMP/mention.json"; mkfx "$FX" "inkstone/ISEP#996|$OLD|$OLD|||"
+TR="$TMP/tr.jsonl"
+mktranscript "$TR" "python3 scripts/ticket say inkstone/ISEP#996 -F /tmp/x.md"
+fire s-t2 "$FX" 0 "㉑ 這回合的 tool call 指名了 inkstone/ISEP#996（結論寫在票上）⇒ 不點名" "$TR"
+for i in 1 2 3 4; do
+  fire s-t2 "$FX" 0 "㉒ 同上第 $i 次——指名過就不該累積成擋下" "$TR"
+done
+mktranscript "$TR" "python3 scripts/ticket say inkstone/ISEP#111 -F /tmp/x.md"
+fire s-t2 "$FX" 2 "㉓ 換成指名**別的**票號 ⇒ 這個 PR 仍然沒被碰 ⇒ 擋"
+
+echo "── E 群：響過就退讓（訊息裡承諾的出路真的存在）────────────────"
+
+FX="$TMP/backoff.json"; mkfx "$FX" "inkstone/ISEP#995|$OLD|$OLD|||"
+fire s-bo "$FX" 2 "㉔ 第 1 次 ⇒ 擋（門檻 1）"
+for i in 1 2 3; do
+  fire s-bo "$FX" 0 "㉕ 擋過之後第 $i 個回合——門檻已加倍（1→4），不該再響"
+done
+fire s-bo "$FX" 2 "㉖ 第 4 個回合 ⇒ 再擋一次（門檻 4）"
+for i in 1 2 3 4 5 6 7; do
+  fire s-bo "$FX" 0 "㉗ 再擋過之後第 $i 個回合——門檻 4→8，不該響"
+done
+fire s-bo "$FX" 2 "㉘ 第 8 個回合 ⇒ 再擋（證明退讓是加倍不是無限）"
+
+# 訊息說「把它指派給那個人，本閘立刻不再點名它」——這條出路要真的走得通
+mkfx "$FX" "inkstone/ISEP#995|$OLD|$OLD|claude-code||"
+for i in 1 2 3 4 5 6 7 8 9; do
+  fire s-bo "$FX" 0 "㉙ 指派下去之後第 $i 個回合 ⇒ 永遠不再點名（訊息承諾的出路成立）"
+done
+
+echo
+printf '結果：%s 通過 / %s 失敗（共 %s 條）\n' "$PASS" "$FAIL" "$N"
+[ "$FAIL" -eq 0 ] || exit 1

hooks/tests/prod-write-guard.test.sh

@@ -68,6 +68,42 @@ t block "heredoc 之後的真指令（剝內文不能連指令一起剝）" \
 EOF
 $ACR_U --force"
 
+# ══ inkstone/ISEP#63 → comment 5106：兩個卡點 ═══════════════════════════
+#
+# 卡點一：發一則 Telegram 給 leo（`notify_leo`）跟「部署一個工作流上線」在本閘眼裡
+#         長得一模一樣——兩者都是帶 body 的寫入型請求打到同一台實例。
+#         判準改成看**打的是哪一個 named webhook**（路徑形狀＋名字），
+#         而放行的範圍只有一個名字，家族其他成員照擋。
+# 卡點二：連「把這個卡點寫進票裡」都被同一支閘擋（同款第八次）——
+#         內文引用了主機名與寫入旗標，而閘比對的是指令文字。
+EXE="https://arcrun-cypher-executor.leo21c.wo""rkers.dev"
+NAMED="$EXE/webhooks/named"
+
+echo "── 卡點一：通知放得過，家族其他成員照擋 ──"
+t pass "發一則 Telegram 給 leo（notify_leo trigger）" \
+  "curl -s -X POST $NAMED/leo/notify_leo/trigger $DASH_D '{\"text\":\"[總管] 進度\"}'"
+t pass "同上，網址後面帶斜線" \
+  "curl -s -X POST $NAMED/leo/notify_leo/trigger/ --data '{\"text\":\"[總管] x\"}'"
+t block "別的 named webhook（會動線上狀態）不在白名單裡" \
+  "curl -X POST $NAMED/leo/ship_refresh_cdn/trigger $DASH_D '{}'"
+t block "部署端點（沒有名字、沒有 /trigger）" \
+  "curl -X POST $NAMED $DASH_D @workflow.json"
+t block "通知混著一筆真的寫入 ⇒ 整條照擋（白名單要每一個都符合）" \
+  "curl -X POST $NAMED/leo/notify_leo/trigger $DASH_D '{}' && curl -X POST $EXE/entries $DASH_D '{}'"
+t block "名字只是前綴相同（notify_leo_deploy）不算通知" \
+  "curl -X POST $NAMED/leo/notify_leo_deploy/trigger $DASH_D '{}'"
+
+echo "── 卡點二：談論它（內文引用）不是執行它 ──"
+t pass "把卡點貼回票上，內文引用了實例網址與寫入旗標（本次實撞）" \
+  "B=\$(cat <<'EOF'
+閘擋下來了：\`curl -X POST $NAMED\` 被當成部署。
+EOF
+); curl -X POST https://git.uncle6.me/api/v1/repos/inkstone/ISEP/issues/63/comments $DASH_D \"\$B\""
+t block "真的在部署、只是把 payload 放進內文 ⇒ 起始行仍看得到，照擋" \
+  "curl -X POST $NAMED $DASH_D @- <<'EOF'
+{\"name\":\"x\"}
+EOF"
+
 echo
 echo "結果：通過 $PASS ／ 失敗 $FAIL"
 [ $FAIL -eq 0 ] || exit 1

hooks/tests/reply-identity.test.sh

@@ -0,0 +1,99 @@
+#!/usr/bin/env bash
+# 身份欄的兩道閘（inkstone/ISEP#30 comment 4325：「subagent 回覆時要表明身份」）。
+#
+# 貼留言到票上有**兩條路**，所以測兩道閘：
+#   正門  scripts/ticket say / decide  —— 檢查在打任何 API 之前，所以本測試離線跑得動
+#   側門  直接打 Gitea API             —— hooks/reply-identity-guard.sh
+#
+# **離線、不打網路。** 正門的案例全部在 `die()` 之前就結束，不會真的送出留言。
+#
+# 用法：hooks/tests/reply-identity.test.sh
+
+set -u
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$(cd "$HERE/../.." && pwd)"
+HOOK="$ROOT/hooks/reply-identity-guard.sh"
+TICKET="$ROOT/scripts/ticket"
+TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
+
+PASS=0; FAIL=0; N=0
+
+ok()  { printf '  ✅ %s\n' "$1"; PASS=$((PASS+1)); N=$((N+1)); }
+bad() { printf '  ❌ %s\n' "$1"; shift; printf '%s\n' "$*" | sed -n '1,6p' | sed 's/^/     /'
+        FAIL=$((FAIL+1)); N=$((N+1)); }
+
+# ── 側門：hooks/reply-identity-guard.sh ─────────────────────────────────
+h() {  # h <期望 exit> <說明> <command 字串>
+  want="$1"; desc="$2"; cmd="$3"
+  body=$(python3 - "$cmd" <<'PY'
+import json, sys
+print(json.dumps({"tool_name": "Bash", "tool_input": {"command": sys.argv[1]}},
+                 ensure_ascii=False))
+PY
+)
+  err=$(printf '%s' "$body" | bash "$HOOK" 2>&1 >/dev/null); rc=$?
+  if [ "$rc" -eq "$want" ]; then ok "$desc"; else
+    bad "$desc —— 期望 exit=$want，實得 exit=$rc" "$err"; fi
+}
+
+echo "── 側門（直接打 Gitea API）─────────────────────────────────────"
+
+h 2 "① POST 留言但沒有【身份】→ 擋" \
+  'curl -X POST -H "Authorization: token $T" -d @body.json https://git.uncle6.me/api/v1/repos/inkstone/ISEP/issues/30/comments'
+
+h 0 "② POST 留言且內文帶【身份】→ 放行" \
+  'curl -X POST -d "{\"body\":\"【身份】subagent／inkstone/ISEP／feat/x\n做完了\"}" https://git.uncle6.me/api/v1/repos/inkstone/ISEP/issues/30/comments'
+
+h 0 "③ 純讀取（GET 撈留言）→ 放行，這是最常做的動作，誤攔它比漏擋更糟" \
+  'curl -s -H "Authorization: token $T" https://git.uncle6.me/api/v1/repos/inkstone/ISEP/issues/30/comments?limit=60'
+
+h 0 "④ 走正門 scripts/ticket → 放行（正門有自己的閘，兩支同時擋會互相打架）" \
+  'scripts/ticket say inkstone/ISEP#30 -F /tmp/body.md'
+
+h 0 "⑤ 開新票的端點（不帶票號）→ 不是本閘的地盤" \
+  'curl -X POST -d @t.json https://git.uncle6.me/api/v1/repos/inkstone/ISEP/issues'
+
+h 0 "⑥ 逃生口 reply-identity-ok → 放行（留在指令歷史上）" \
+  'curl -X POST -d @body.json https://git.uncle6.me/api/v1/repos/inkstone/ISEP/issues/30/comments  # reply-identity-ok'
+
+h 0 "⑦ 只是在講這件事（把端點寫進文件）而沒有 POST → 不擋" \
+  'echo "留言端點是 issues/30/comments" >> docs/notes.md'
+
+echo
+echo "── 正門（scripts/ticket）───────────────────────────────────────"
+
+g() {  # g <期望 exit> <說明> <內文>
+  want="$1"; desc="$2"; content="$3"
+  printf '%s' "$content" > "$TMP/body.md"
+  err=$(python3 "$TICKET" say inkstone/ISEP#30 -F "$TMP/body.md" 2>&1 >/dev/null); rc=$?
+  if [ "$rc" -eq "$want" ]; then ok "$desc"; else
+    bad "$desc —— 期望 exit=$want，實得 exit=$rc" "$err"; fi
+}
+
+g 2 "⑧ 內文沒有身份欄 → 在打 API 之前就擋（所以這一格離線也測得動）" \
+  '做完了，分支是 feat/x'
+
+g 2 "⑨ 有【身份】但角色不在三選一之內 → 擋" \
+  '【身份】機器人／inkstone/ISEP／feat/x
+
+做完了'
+
+g 2 "⑩ 身份欄不在第一行 → 擋（要一眼看得到，不是藏在中間）" \
+  '做完了
+【身份】subagent／inkstone/ISEP／feat/x'
+
+# ⑪ 合規的內文要能通過身份檢查——它會往下走到打 API，
+#    離線環境打不出去所以 exit 非 0；判準改成「錯誤訊息不是身份欄那一段」。
+printf '%s' '【身份】subagent／inkstone/ISEP／feat/x
+
+做完了' > "$TMP/ok.md"
+err=$(python3 "$TICKET" say inkstone/ISEP#30 -F "$TMP/ok.md" 2>&1 >/dev/null || true)
+if printf '%s' "$err" | grep -q '第一行要表明身份'; then
+  bad "⑪ 合規的內文被身份閘擋掉了（誤攔）" "$err"
+else
+  ok "⑪ 合規的內文通過身份閘（之後成不成功是網路的事，不是本閘的事）"
+fi
+
+echo
+echo "══ $PASS/$N 通過${FAIL:+，$FAIL 個失敗} ══"
+[ "$FAIL" -eq 0 ]

hooks/tests/roster-guard.test.sh

@@ -0,0 +1,181 @@
+#!/usr/bin/env bash
+# roster-guard.sh 的迴歸測試（inkstone/ISEP#86）
+#
+# 票上的四條驗收條件，一條一組：
+#   1 列出名單 → 看得到有哪幾個工人、各自管什麼      （scripts/roster list）
+#   2 派工要能指名派給誰                              （subagent_type 認得出來）
+#   3 票上的紀錄看得出是哪個工人做的                  （【身份】欄吃得下工人名字）
+#   4 派一個名單裡沒有的名字 → 要講得出「沒有這個人」
+#
+# 另外兩群：**不該擋**（誤攔比漏擋嚴重）、**注入**（指對名字就把它的檔案原文送過去）。
+#
+# 🔴 全程離線，不打網路、不花錢、每次結果一樣（純結構判斷，沒有語意判官）。
+#
+# 用法：hooks/tests/roster-guard.test.sh [hook 路徑]
+set -u
+unset CLAUDE_CODE_CHILD_SESSION   # 殘留會讓別的閘行為不同；本閘不看它，但別讓環境有變數
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$(cd "$HERE/../.." && pwd)"
+HOOK="${1:-$ROOT/hooks/roster-guard.sh}"
+TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
+
+PASS=0; FAIL=0; N=0
+
+# payload <prompt> <subagent_type> [tool_name]
+payload() {
+  python3 - "$1" "$2" "${3:-Task}" <<'PY'
+import json, sys
+print(json.dumps({"session_id": "S-ROSTER", "hook_event_name": "PreToolUse",
+                  "tool_name": sys.argv[3],
+                  "tool_input": {"prompt": sys.argv[1], "subagent_type": sys.argv[2]}},
+                 ensure_ascii=False))
+PY
+}
+
+# t <期望 exit> <說明> <payload> [必須出現的字串] [ISEP_ROSTER_DIR]
+t() {
+  want="$1"; desc="$2"; body="$3"; must="${4:-}"; rdir="${5:-}"
+  N=$((N+1))
+  if [ -n "$rdir" ]; then
+    err=$(printf '%s' "$body" | ISEP_ROSTER_DIR="$rdir" bash "$HOOK" 2>&1 >/dev/null); rc=$?
+  else
+    err=$(printf '%s' "$body" | bash "$HOOK" 2>&1 >/dev/null); rc=$?
+  fi
+  ok=1
+  [ "$rc" -eq "$want" ] || ok=0
+  if [ -n "$must" ] && ! printf '%s' "$err" | grep -qF "$must"; then ok=0; fi
+  if [ "$ok" -eq 1 ]; then printf '  ✅ %s\n' "$desc"; PASS=$((PASS+1))
+  else
+    printf '  ❌ %s —— 期望 exit=%s%s，實得 exit=%s\n' "$desc" "$want" \
+      "${must:+ 且訊息含「$must」}" "$rc"
+    printf '%s\n' "$err" | sed -n '1,6p' | sed 's/^/     /'
+    FAIL=$((FAIL+1))
+  fi
+}
+
+clean() { rm -f /tmp/.roster-ok-S-ROSTER 2>/dev/null || true; }
+clean
+
+echo "── 驗收 1：列出名單 ────────────────────────────────────────────"
+
+N=$((N+1))
+out=$(python3 "$ROOT/scripts/roster" list 2>&1)
+if printf '%s' "$out" | grep -q 'isep-hand' && printf '%s' "$out" | grep -q 'inkstone/ISEP' \
+   && printf '%s' "$out" | grep -q '負責 repo'; then
+  printf '  ✅ ① `roster list` 印得出「有哪幾個工人、各自管什麼」\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ① `roster list` 沒有名字或沒有負責的 repo\n'; printf '%s\n' "$out" | sed 's/^/     /'
+  FAIL=$((FAIL+1))
+fi
+
+N=$((N+1))
+if python3 "$ROOT/scripts/roster" show isep-hand 2>&1 | grep -q '## 紅線'; then
+  printf '  ✅ ② `roster show` 印得出那位工人的紅線（它開工時會讀到的東西）\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ② `roster show` 沒有印出紅線段\n'; FAIL=$((FAIL+1))
+fi
+
+N=$((N+1))
+if [ "$(python3 "$ROOT/scripts/roster" which inkstone/ISEP 2>/dev/null)" = "isep-hand" ]; then
+  printf '  ✅ ③ `roster which <repo>` 答得出這個 repo 該派給誰\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ③ `roster which inkstone/ISEP` 沒有回 isep-hand\n'; FAIL=$((FAIL+1))
+fi
+
+echo "── 驗收 2：派工要能指名派給誰（不該擋）────────────────────────"
+
+for who in isep-hand arcrun-hand arcrun-rag-hand inkstoneco-hand mira-hand collector-hand scout; do
+  t 0 "④ 指名 $who ⇒ 放行" "$(payload '【工單】inkstone/ISEP#86' "$who")"
+done
+
+t 0 "⑤ Agent 這條路也認得（不是只認 Task）" \
+  "$(payload '【工單】inkstone/ISEP#86' 'scout' 'Agent')"
+
+echo "── 驗收 4：名單上沒有的名字 → 講得出「沒有這個人」──────────────"
+
+t 2 "⑥ 派 general-purpose（就是「沒有名字的臨時工」）⇒ 擋，並說沒有這個人" \
+  "$(payload '【工單】inkstone/ISEP#86' 'general-purpose')" '沒有「general-purpose」這個人'
+
+t 2 "⑦ 完全沒指名（subagent_type 是空的）⇒ 擋" \
+  "$(payload '【工單】inkstone/ISEP#86' '')" '沒有指名工人'
+
+t 2 "⑧ 打錯字（isep-hands）⇒ 擋。名字是唯一識別碼，不做模糊比對" \
+  "$(payload '【工單】inkstone/ISEP#86' 'isep-hands')" '沒有「isep-hands」這個人'
+
+t 2 "⑨ 擋下來的時候要把整份名單印出來（不然人不知道有誰可以派）" \
+  "$(payload '【工單】inkstone/ISEP#86' 'nobody')" 'arcrun-rag-hand'
+
+echo "── 不該擋（誤攔比漏擋嚴重）──────────────────────────────────"
+
+t 0 "⑩ 沒有【工單】⇒ 閉嘴（那是 no-ticket-no-dispatch 的地盤，不准兩支閘同時開口）" \
+  "$(payload '去查一下那個 worker 為什麼沒更新' 'general-purpose')"
+
+t 0 "⑪ 不是派工的動作（Bash）⇒ 一律不管" \
+  '{"session_id":"S-ROSTER","tool_name":"Bash","tool_input":{"command":"ls"}}'
+
+t 0 "⑫ 整包不是合法 JSON ⇒ fail-open" 'this is not json at all'
+
+t 0 "⑬ 名單目錄是空的 ⇒ fail-open（讀不到的名單不該讓整台機器派不了工）" \
+  "$(payload '【工單】inkstone/ISEP#86' 'general-purpose')" '' "$TMP"
+
+clean
+touch /tmp/.roster-ok-S-ROSTER
+t 0 "⑭ 明示豁免戳記在 ⇒ 放行一次" \
+  "$(payload '【工單】inkstone/ISEP#86' 'general-purpose')"
+N=$((N+1))
+if [ -f /tmp/.roster-ok-S-ROSTER ]; then
+  printf '  ❌ ⑮ 豁免戳記用完沒被消掉（會變成永久開關）\n'; FAIL=$((FAIL+1))
+else
+  printf '  ✅ ⑮ 豁免戳記用完就消失，不是永久開關\n'; PASS=$((PASS+1))
+fi
+clean
+
+echo "── 注入：指對名字就把那位工人的檔案原文送過去 ──────────────────"
+
+N=$((N+1))
+inj=$(printf '%s' "$(payload '【工單】inkstone/ISEP#86' 'isep-hand')" | bash "$HOOK" 2>/dev/null)
+if printf '%s' "$inj" | python3 -c '
+import sys, json
+c = json.load(sys.stdin)["hookSpecificOutput"]["additionalContext"]
+assert "isep-hand" in c, "沒有名字"
+assert "inkstone/ISEP" in c, "沒有負責的 repo"
+assert "開工前先讀" in c, "沒有「開工前先讀」"
+assert "紅線" in c, "沒有紅線"
+' 2>/dev/null; then
+  printf '  ✅ ⑯ 指對名字 ⇒ 注入「你是誰／負責哪個 repo／開工前先讀／紅線」四件\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ⑯ 沒有注入，或缺了其中一件\n'; printf '%s\n' "$inj" | sed -n '1,4p' | sed 's/^/     /'
+  FAIL=$((FAIL+1))
+fi
+
+N=$((N+1))
+inj2=$(printf '%s' "$(payload '【工單】inkstone/Arcrun#142' 'arcrun-hand')" | bash "$HOOK" 2>/dev/null)
+if printf '%s' "$inj2" | grep -q 'arcrun-hand' && ! printf '%s' "$inj2" | grep -q 'isep-hand'; then
+  printf '  ✅ ⑰ 注入的是**那一位**的檔案，不是整份名單\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ⑰ 注入的內容不是指名的那一位\n'; FAIL=$((FAIL+1))
+fi
+
+echo "── 驗收 3：票上的紀錄看得出是哪個工人做的（身份欄）──────────────"
+
+N=$((N+1))
+if python3 - "$ROOT" <<'PY' 2>/dev/null
+import sys, os
+sys.path.insert(0, os.path.join(sys.argv[1], "hooks", "lib"))
+import dispatch_parse as dp
+ok, _ = dp.parse_identity("【身份】isep-hand／inkstone/ISEP／feat/x")
+assert ok, "工人名字不被身份欄接受"
+ok2, _ = dp.parse_identity("【身份】總管／inkstone/ISEP／-")
+assert ok2, "原本的三個角色被弄壞了"
+bad, _ = dp.parse_identity("【身份】某某某／inkstone/ISEP／-")
+assert not bad, "亂寫的名字被放行了"
+PY
+then
+  printf '  ✅ ⑱ 【身份】欄吃得下工人名字，原本三個角色照舊，亂寫的仍然擋\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ⑱ 身份欄沒有吃下工人名字（或把原本的三個角色弄壞了）\n'; FAIL=$((FAIL+1))
+fi
+
+echo
+printf '結果：%s 通過 / %s 失敗（共 %s 條）\n' "$PASS" "$FAIL" "$N"
+[ "$FAIL" -eq 0 ] || exit 1

hooks/tests/search-is-not-proof-guard.test.sh

@@ -0,0 +1,254 @@
+#!/usr/bin/env bash
+# search-is-not-proof-guard.sh ＋ kbdb-evidence-stamp.sh 的迴歸測試
+# （inkstone/ISEP#30 → comment 4879）
+#
+# **離線、不打網路、不碰真庫、每次結果一樣。** 兩支都是純結構判斷，沒有語意判官。
+#
+# 🔴 這支測試的重點在 A 群，不在 B 群。
+#    ISEP 的第一級缺陷是**誤攔**——leo 2026-08-17 實證：在文字層封路的閘
+#    8 次誤攔、0 次正確攔截。所以「該擋有擋到」只是及格，
+#    **「不該擋的一個都沒擋」才是這支閘能不能活下來的條件。**
+#
+# 用法：hooks/tests/search-is-not-proof-guard.test.sh [guard 路徑] [stamp 路徑]
+
+set -u
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOKS="$(cd "$HERE/.." && pwd)"
+GUARD="${1:-$HOOKS/search-is-not-proof-guard.sh}"
+STAMP="${2:-$HOOKS/kbdb-evidence-stamp.sh}"
+
+SID="S-SINP-TEST"
+SEARCH="/tmp/.kbdb-evidence-search-$SID"
+WALKED="/tmp/.kbdb-evidence-walked-$SID"
+WARNED="/tmp/.search-is-not-proof-warned-$SID"
+TMPD="$(mktemp -d)"
+trap 'rm -rf "$TMPD"; rm -f "$SEARCH" "$WALKED" "$WARNED"' EXIT
+
+PASS=0; FAIL=0; N=0
+
+# 真跡：Arcrun#167 comment 4865 裡真的被貼出去的那兩個值
+REAL_ID="e_b77f23a1-b467-4aa4-883c-58a051ab8e66"
+REAL_SRC="kb://小果被AFTEE詐貸.pdf#8"
+
+clean() { rm -f "$SEARCH" "$WALKED" "$WARNED"; }
+
+# seen <search|walked> <值...>  —— 直接寫登記檔（模擬 stamp 已經跑過）
+seen() {
+  f="/tmp/.kbdb-evidence-$1-$SID"; shift
+  for v in "$@"; do printf '%s\n' "$v" >> "$f"; done
+}
+
+# bash_payload <command>
+bash_payload() {
+  python3 - "$SID" "$1" <<'PY'
+import json, sys
+print(json.dumps({"session_id": sys.argv[1], "hook_event_name": "PreToolUse",
+                  "tool_name": "Bash", "tool_input": {"command": sys.argv[2]}},
+                 ensure_ascii=False))
+PY
+}
+
+# agent_payload <prompt>
+agent_payload() {
+  python3 - "$SID" "$1" <<'PY'
+import json, sys
+print(json.dumps({"session_id": sys.argv[1], "hook_event_name": "PreToolUse",
+                  "tool_name": "Agent", "tool_input": {"prompt": sys.argv[2]}},
+                 ensure_ascii=False))
+PY
+}
+
+# post_payload <tool_name> <tool_response JSON 字串> [有沒有 tool_response 欄位:yes|no]
+post_payload() {
+  python3 - "$SID" "$1" "$2" "${3:-yes}" <<'PY'
+import json, sys
+sid, tool, resp, has = sys.argv[1:5]
+d = {"session_id": sid, "hook_event_name": "PostToolUse",
+     "tool_name": tool, "tool_input": {}}
+if has == "yes":
+    d["tool_response"] = json.loads(resp)
+print(json.dumps(d, ensure_ascii=False))
+PY
+}
+
+t() {
+  want="$1"; desc="$2"; body="$3"; hook="${4:-$GUARD}"
+  N=$((N+1))
+  err=$(printf '%s' "$body" | bash "$hook" 2>&1 >/dev/null); rc=$?
+  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,6p' | sed 's/^/     /'
+    FAIL=$((FAIL+1))
+  fi
+}
+
+echo "── A 群：🔴 不該擋（誤攔是這個 repo 的第一級缺陷）────────────────"
+
+clean
+t 0 "① 這個 session 從沒用過 kbdb_search → 完全沒有立場說話" \
+  "$(bash_payload "scripts/ticket say inkstone/Arcrun#167 -F /tmp/x.md")"
+
+clean; seen search "$REAL_ID" "$REAL_SRC"
+t 0 "② 搜過，但只是自己看——沒有任何往外送的動作（git status）" \
+  "$(bash_payload "git status --short")"
+
+clean; seen search "$REAL_ID" "$REAL_SRC"
+printf '總管：這一輪的三張票都關了，版本 1.4.59 已上 stage。\n' > "$TMPD/plain.md"
+t 0 "③ 搜過，也貼了票，但**沒有引用任何搜尋出來的值**（最常見的正常情況）" \
+  "$(bash_payload "scripts/ticket say inkstone/ISEP#30 -F $TMPD/plain.md")"
+
+clean; seen search "$REAL_ID"; seen walked "$REAL_ID"
+printf '總管：這筆我用 kbdb_get_record 拉過了，id 是 %s\n' "$REAL_ID" > "$TMPD/walked.md"
+t 0 "④ 搜完**又走了真路徑**才引用 → 這是對的做法，不准罰" \
+  "$(bash_payload "scripts/ticket say inkstone/Arcrun#167 -F $TMPD/walked.md")"
+
+clean; seen search "$REAL_ID"
+t 0 "⑤ 逃生口：指令裡寫了 search-is-evidence: 的理由" \
+  "$(bash_payload "scripts/ticket say inkstone/Arcrun#167 --body '$REAL_ID' search-is-evidence: 只是引用一筆資料的編號")"
+
+clean; seen search "$REAL_ID"
+t 0 "⑥ 讀那支閘的原始碼（值只是出現在指令裡，不是往外送）" \
+  "$(bash_payload "cat hooks/search-is-not-proof-guard.sh | grep $REAL_ID")"
+
+clean; seen search "$REAL_ID"
+t 0 "⑦ 撈票／搜票這些讀取動作，不是往外送" \
+  "$(bash_payload "curl -s -H 'Authorization: token X' 'https://git.uncle6.me/api/v1/repos/inkstone/Arcrun/issues/167'")"
+
+clean; seen search "$REAL_SRC"
+t 0 "⑧ 只在 wiki 裡查東西、然後改自己 repo 的檔（Write 不歸這支管）" \
+  "$(bash_payload "sed -i '' 's/a/b/' system-dev/wiki/status.md")"
+
+clean; seen search "$REAL_ID"
+printf '【工單】inkstone/ISEP#30\n' > "$TMPD/dispatch-ok.md"
+t 0 "⑨ 合規派工單（只有票號，沒有引用搜尋值）" \
+  "$(agent_payload "$(cat "$TMPD/dispatch-ok.md")")"
+
+clean; seen search "$REAL_ID"
+t 2 "⑩ 第一次命中 → 擋（這一發是下一條的前置）" \
+  "$(bash_payload "scripts/ticket say inkstone/Arcrun#167 --body '$REAL_ID'")"
+t 0 "⑩' 同一 session 第二次同樣的動作 → 放行，不鬼打牆" \
+  "$(bash_payload "scripts/ticket say inkstone/Arcrun#167 --body '$REAL_ID'")"
+
+echo "── B 群：該擋（真跡重演）──────────────────────────────────────"
+
+clean; seen search "$REAL_ID" "$REAL_SRC"
+cat > "$TMPD/4865.md" <<EOF
+# 🔴【總管複驗・退回】兩個缺陷都還在——我用 MCP 實打的
+
+\`\`\`
+\$ kbdb_search(q="小果 AFTEE 詐貸")   → count 5
+\`\`\`
+
+\`\`\`json
+{
+  "id": "$REAL_ID",
+  "content": "### 出處\n- \`../小果被AFTEE詐貸.pdf\` >> 提及 >> 小果被AFTEE詐貸"
+}
+\`\`\`
+
+"metadata_json": "{\"source\":\"$REAL_SRC\",\"library\":\"youlinhsieh-test1\"}"
+EOF
+t 2 "⑪ 真跡重演：Arcrun#167 comment 4865 那則退回，原文照貼" \
+  "$(bash_payload "scripts/ticket say inkstone/Arcrun#167 -F $TMPD/4865.md")"
+
+clean; seen search "$REAL_ID"
+t 2 "⑫ 同一件事走派工單（重派一條線）" \
+  "$(agent_payload "【工單】inkstone/Arcrun#167
+上一版沒修好，實測 $REAL_ID 那塊的出處還是 ../ 開頭")"
+
+clean; seen search "$REAL_SRC"
+t 2 "⑬ 只貼了 kb:// 來源位址（沒貼 id）也認得出來" \
+  "$(bash_payload "scripts/ticket close inkstone/Arcrun#167 --deliverable '$REAL_SRC'")"
+
+clean; seen search "$REAL_ID"
+t 2 "⑭ 直接打 Gitea API 貼留言（繞開 scripts/ticket）" \
+  "$(bash_payload "curl -X POST -d '{\"body\":\"$REAL_ID 還是壞的\"}' 'https://git.uncle6.me/api/v1/repos/inkstone/Arcrun/issues/167/comments'")"
+
+clean; seen search "$REAL_ID"; seen walked "e_00000000-0000-0000-0000-000000000000"
+t 2 "⑮ 走過真路徑，但走的是**別筆**資料 → 這一筆仍然只有搜尋當來源" \
+  "$(bash_payload "scripts/ticket say inkstone/Arcrun#167 --body '$REAL_ID'")"
+
+echo "── C 群：訊息本身講不講得出出路 ──────────────────────────────"
+
+clean; seen search "$REAL_ID"
+MSG=$(printf '%s' "$(bash_payload "scripts/ticket say inkstone/Arcrun#167 --body '$REAL_ID'")" | bash "$GUARD" 2>&1 >/dev/null)
+for want in "D81" "kbdb_graph_neighbors" "search-is-evidence:" "4877" "同一條嗎"; do
+  N=$((N+1))
+  if printf '%s' "$MSG" | grep -q -- "$want"; then
+    printf '  ✅ 訊息裡有「%s」\n' "$want"; PASS=$((PASS+1))
+  else
+    printf '  ❌ 訊息裡找不到「%s」\n' "$want"; FAIL=$((FAIL+1))
+  fi
+done
+N=$((N+1))
+if printf '%s' "$MSG" | grep -q '`kbdb_get_record`'; then
+  printf '  ✅ 反引號沒有被 shell 吃掉（heredoc 有跳脫）\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ 反引號被 shell 展開了\n'; FAIL=$((FAIL+1))
+fi
+
+echo "── D 群：登記處（stamp）──────────────────────────────────────"
+
+clean
+RESP=$(python3 -c "
+import json
+print(json.dumps({'ok':True,'data':{'entries':[{'id':'$REAL_ID','metadata_json':'{\"source\":\"$REAL_SRC\"}'}]}}, ensure_ascii=False))
+")
+t 0 "⑯ kbdb_search 的回應 → 登記進 search 檔" \
+  "$(post_payload "mcp__abc__kbdb_search" "$RESP")" "$STAMP"
+N=$((N+1))
+if grep -q "$REAL_ID" "$SEARCH" 2>/dev/null && grep -q "$REAL_SRC" "$SEARCH" 2>/dev/null; then
+  printf '  ✅ 兩類指紋（entry id ＋ kb:// 位址）都抓到了\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ 指紋沒抓到：%s\n' "$(cat "$SEARCH" 2>/dev/null)"; FAIL=$((FAIL+1))
+fi
+
+clean
+# 🔴 MCP 的回應**不保證**是拆好的物件——常見的是包成 content blocks，
+#    整份 JSON 縮成一個字串塞在 text 裡（連引號都被跳脫過）。
+#    stamp 對兩種包裝都要認得，否則它在真的環境裡會靜默失效。
+INNER=$(python3 -c "
+import json
+print(json.dumps({'ok':True,'data':{'entries':[{'id':'$REAL_ID','metadata_json':'{\"source\":\"$REAL_SRC\"}'}]}}, ensure_ascii=False))
+")
+WRAPPED=$(python3 -c "
+import json,sys
+print(json.dumps({'content':[{'type':'text','text':sys.argv[1]}]}, ensure_ascii=False))
+" "$INNER")
+t 0 "⑯' 同一份回應包成 MCP content blocks（字串裡的 JSON）→ 一樣認得出來" \
+  "$(post_payload "mcp__abc__kbdb_search" "$WRAPPED")" "$STAMP"
+N=$((N+1))
+if grep -q "$REAL_ID" "$SEARCH" 2>/dev/null && grep -q "$REAL_SRC" "$SEARCH" 2>/dev/null; then
+  printf '  ✅ content blocks 包裝下兩類指紋都抓到了\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ 被包裝擋住了：%s\n' "$(cat "$SEARCH" 2>/dev/null)"; FAIL=$((FAIL+1))
+fi
+
+clean
+t 0 "⑰ kbdb_get_record 的回應 → 登記進 walked 檔" \
+  "$(post_payload "mcp__abc__kbdb_get_record" "$RESP")" "$STAMP"
+N=$((N+1))
+if grep -q "$REAL_ID" "$WALKED" 2>/dev/null && [ ! -s "$SEARCH" ]; then
+  printf '  ✅ 走過真路徑的記在 walked，沒有污染 search\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ 記錯檔了\n'; FAIL=$((FAIL+1))
+fi
+
+clean
+t 0 "⑱ 不是 kbdb 的工具 → 什麼都不做" \
+  "$(post_payload "Bash" "$RESP")" "$STAMP"
+
+clean
+t 0 "⑲ 搜尋 0 筆（回應讀得到但沒有指紋）→ 正常，不出聲" \
+  "$(post_payload "mcp__abc__kbdb_search" '{"ok":true,"data":{"entries":[],"count":0}}')" "$STAMP"
+
+clean
+t 2 "⑳ fail-closed：payload 裡沒有 tool_response 欄位 → 出聲說自己失效了" \
+  "$(post_payload "mcp__abc__kbdb_search" "$RESP" "no")" "$STAMP"
+
+clean
+echo
+printf '共 %d 條：✅ %d  ❌ %d\n' "$N" "$PASS" "$FAIL"
+[ "$FAIL" -eq 0 ] || exit 1

hooks/tests/unpushed-police.test.sh

@@ -0,0 +1,137 @@
+#!/usr/bin/env bash
+# unpushed-police.sh 的迴歸測試（inkstone/ISEP#90）
+#
+# 這支存在的理由是一個**穩定重現**的誤報：雲端 session 開出來的工作分支
+# 天生沒有 upstream，內容卻等於遠端 main ⇒ 每個雲端 session、每次收工都被攔一次。
+# 2026-08-27 一個 session 攔五次，五次全是誤報。
+#
+# 兩個方向都要有證據，而且 **A 群（不該報）比 B 群更重要**：
+#   永遠在響的警報＝訓練人忽略這個警報，下一條真的失蹤的分支會混在雜訊裡。
+#
+# 🔴 全程離線：用本機 bare repo 當「遠端」，`git ls-remote` 打的是檔案路徑。
+#    不碰任何真 repo、不打網路、不寫 /tmp 的正式快取（走 UNPUSHED_CACHE_DIR）。
+set -u
+HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/unpushed-police.sh}"
+TMP=$(mktemp -d)
+trap 'rm -rf "$TMP"' EXIT
+export GIT_CONFIG_GLOBAL="$TMP/gitconfig"; : > "$GIT_CONFIG_GLOBAL"
+export GIT_AUTHOR_NAME=t GIT_AUTHOR_EMAIL=t@t GIT_COMMITTER_NAME=t GIT_COMMITTER_EMAIL=t@t
+
+PASS=0; FAIL=0; N=0
+
+# mk <名字> → 造一個「遠端 bare + 本機 clone」的場，印出本機 repo 路徑
+mk() {
+  d="$TMP/$1"; mkdir -p "$d"
+  git init -q --bare "$d/remote.git"
+  git init -q -b main "$d/work"
+  ( cd "$d/work"
+    echo a > a.txt; git add a.txt; git commit -qm first
+    git remote add origin "$d/remote.git"
+    git push -q origin main
+    git branch --unset-upstream 2>/dev/null || true ) >/dev/null 2>&1
+  printf '%s\n' "$d/work"
+}
+
+# fire <repo> <期望 exit> <說明> [期望訊息片段]
+fire() {
+  repo="$1"; want="$2"; desc="$3"; want_msg="${4:-}"
+  N=$((N+1))
+  out=$(printf '{}' | CLAUDE_PROJECT_DIR="$repo" UNPUSHED_CACHE_DIR="$TMP/cache-$N" \
+        bash "$HOOK" 2>&1); rc=$?
+  mkdir -p "$TMP/cache-$N" 2>/dev/null
+  ok=1
+  [ "$rc" -eq "$want" ] || ok=0
+  if [ -n "$want_msg" ] && ! printf '%s' "$out" | grep -qF "$want_msg"; then ok=0; fi
+  if [ "$ok" = 1 ]; then
+    printf '  ✅ %s\n' "$desc"; PASS=$((PASS+1))
+  else
+    printf '  ❌ %s —— 期望 exit=%s%s，實得 exit=%s\n' "$desc" "$want" \
+      "${want_msg:+ 且訊息含「$want_msg」}" "$rc"
+    printf '%s\n' "$out" | sed -n '1,14p' | sed 's/^/     /'
+    FAIL=$((FAIL+1))
+  fi
+}
+# 每個案例先把快取目錄準備好（fire 用的是自己那一格，互不污染）
+for i in $(seq 1 40); do mkdir -p "$TMP/cache-$i"; done
+
+echo "── A 群：不該報（誤攔比漏擋更該修）──────────────────────────"
+
+# ① 這就是雲端那個現場：分支沒有 upstream，但它那顆 commit 就是遠端 main 那顆
+r=$(mk cloud)
+( cd "$r" && git checkout -q -b claude/session-xyz && git branch -D main -q 2>/dev/null
+  git remote set-head origin -d 2>/dev/null; git update-ref -d refs/remotes/origin/main ) >/dev/null 2>&1
+fire "$r" 0 "① 沒 upstream，但遠端就有這顆 commit（雲端每個 session 的現場）"
+
+# ② HEAD 是遠端 main 的**祖先**（遠端已經走在前面）——同樣不是「沒推」
+r=$(mk ancestor)
+( cd "$r"
+  echo b > b.txt && git add b.txt && git commit -qm second && git push -q origin main
+  git checkout -q -b work HEAD~1
+  git update-ref -d refs/remotes/origin/main ) >/dev/null 2>&1
+fire "$r" 0 "② HEAD 是遠端 main 的祖先 → 遠端已經有它"
+
+# ③ 本機的 remote-tracking ref **過期**（08-28 實測落後遠端 4 天的那一格）
+r=$(mk stale)
+( cd "$r"
+  old=$(git rev-parse HEAD)
+  echo b > b.txt && git add b.txt && git commit -qm second && git push -q origin main
+  git update-ref refs/remotes/origin/main "$old"     # 本機那份停在舊的
+  git checkout -q -b claude/session-abc ) >/dev/null 2>&1
+fire "$r" 0 "③ 本機 origin/main 過期，但遠端真的有這顆 → 不報"
+
+# ④ 完全問不到遠端（沒有任何 remote）→ **不當成沒推**
+r="$TMP/noremote"; git init -q -b main "$r"
+( cd "$r" && echo a > a.txt && git add a.txt && git commit -qm only ) >/dev/null 2>&1
+fire "$r" 0 "④ 沒有任何 remote＝問不到 → 不報（不拿離線當罪證）"
+
+# ⑤ 基準過期時，已經在遠端 main 上的分支不算散落
+r=$(mk straystale)
+( cd "$r"
+  old=$(git rev-parse HEAD)
+  git checkout -q -b feat/done
+  echo b > b.txt && git add b.txt && git commit -qm done
+  git push -q origin feat/done:main                  # 遠端 main 已經含它
+  git update-ref refs/remotes/origin/main "$old" ) >/dev/null 2>&1
+fire "$r" 0 "⑤ 分支已在遠端 main 上，只是本機基準舊 → 不算散落"
+
+# ⑥ stop_hook_active → 一律放行
+r=$(mk stopactive)
+( cd "$r" && echo x >> a.txt ) >/dev/null 2>&1
+N=$((N+1))
+out=$(printf '{"stop_hook_active":true}' | CLAUDE_PROJECT_DIR="$r" \
+      UNPUSHED_CACHE_DIR="$TMP/cache-$N" bash "$HOOK" 2>&1); rc=$?
+if [ "$rc" -eq 0 ]; then printf '  ✅ %s\n' "⑥ stop_hook_active＝true → 放行"; PASS=$((PASS+1))
+else printf '  ❌ %s（exit=%s）\n' "⑥ stop_hook_active＝true → 放行" "$rc"; FAIL=$((FAIL+1)); fi
+
+echo "── B 群：該報（不能為了不吵就變成放行）────────────────────"
+
+# ⑦ 真的有遠端沒有的 commit ＝ 真的沒推
+r=$(mk unpushed)
+( cd "$r"
+  git checkout -q -b feat/real
+  echo b > b.txt && git add b.txt && git commit -qm "沒推的那筆" ) >/dev/null 2>&1
+fire "$r" 2 "⑦ 分支有遠端沒有的 commit → 要報" "從未推過"
+
+# ⑧ 有改動沒 commit
+r=$(mk dirty)
+( cd "$r" && echo more >> a.txt ) >/dev/null 2>&1
+fire "$r" 2 "⑧ 工作區有未 commit 的改動 → 要報" "未 commit"
+
+# ⑨ 散落分支：本地分支有遠端 main 沒有的東西
+r=$(mk stray)
+( cd "$r"
+  git checkout -q -b feat/lost
+  echo c > c.txt && git add c.txt && git commit -qm "躺著的那筆"
+  git checkout -q main ) >/dev/null 2>&1
+fire "$r" 2 "⑨ 有分支沒併回、遠端也沒有 → 要報散落" "feat/lost"
+
+# ⑩ 判準沒有滑回「有沒有 upstream」：有 upstream 但真的領先，照樣要報
+r=$(mk ahead)
+( cd "$r"
+  git branch --set-upstream-to=origin/main main
+  echo b > b.txt && git add b.txt && git commit -qm "領先一筆" ) >/dev/null 2>&1
+fire "$r" 2 "⑩ 有 upstream 且真的領先 → 照樣要報" "領先"
+
+echo
+printf '通過 %s 條，失敗 %s 條（共 %s 條）\n' "$PASS" "$FAIL" "$N"
+[ "$FAIL" = 0 ] || exit 1

hooks/ticket-api-bypass-guard.sh

@@ -1,26 +1,45 @@
 #!/bin/bash
-# 管什麼: 用 Gitea API 直接開新票時，要求這一輪有跑過跨 repo 的搜尋（/tmp/.ticket-where-ok，30 分鐘內）。
-# 為什麼: scripts/ticket 早就強制先搜，但那道閘只擋走正門的人。2026-08-20 總管走 API 側門開了 12 張票，每一張都跟舊票重疊。
-# 誤觸時怎麼關: 跑 `scripts/ticket where <關鍵字>` 先搜（之後 30 分鐘 API 也放行），或在指令裡加 `ticket-api-ok` 留痕放行。
-# ticket-api-bypass-guard.sh — 開票的「側門」也要經過同一道搜尋閘
+# 管什麼: 用 Gitea API 直接「新增」東西時（開新票／開新 milestone／開新 label／開新 PR），
+#        要求這一輪有跑過搜尋（/tmp/.ticket-where-ok，30 分鐘內）。
+# 為什麼: scripts/ticket 早就強制先搜，但那道閘只擋走正門的人；而擋側門的第一版只認
+#        大寫裸字 POST，2026-08-27 總管用 `requests.post(...)`／隱式 POST 的 urllib
+#        繞了過去，同一天又用 API 直接開了 milestone/label/PR（這版都沒管）。
+# 誤觸時怎麼關: 跑 `scripts/ticket where <關鍵字>` 先搜（之後 30 分鐘所有寫入端點都放行），
+#        或在指令裡加 `ticket-api-ok` 留痕放行。
+# ticket-api-bypass-guard.sh — 新增 Gitea 東西的每一道側門，都要經過同一道搜尋閘
 #
-# 來由（leo 2026-08-20 當場問「如何防止」）：
+# 來由（leo 2026-08-20 當場問「如何防止」；2026-08-27 leo 把範圍講寬：
+#   「不只開票前⋯⋯所有新增 gitea 的東西，都要搜尋」）：
 #   `scripts/ticket new` 早就強制「開票前先搜」（/tmp/.ticket-where-ok 戳記，30 分鐘失效）。
-#   但總管當天開了 12 張與舊票重疊的新票——因為他**沒用那支工具，直接打 Gitea API**。
-#   ⇒ 規範有、閘也有，但閘長在「工具」上，而那個動作有兩條路，只封了一條。
-#   leo：「你在讓事情複雜化」／「每張票開以前都要搜尋現有票，你為什麼會開了不搜？」
+#   但 2026-08-20 總管開了 12 張與舊票重疊的新票——沒用那支工具，直接打 API。
+#   2026-08-27 總管又開了 13 張，這次連當時的 v1 guard 都繞過了：
+#     v1 判準只認一個裸字 `grep -qw POST`（leo 2026-08-17 定的哲學：封動作不封文字，
+#     一個裸字夠了），但那天實際指令是 `req = urllib.request.Request(url, data=...)`
+#     （靠傳 data= 隱式變成 POST，指令裡從頭到尾沒有 "POST" 三個字母），或
+#     `requests.post(...)`（小寫 post，`grep -qw POST` 大小寫敏感照樣漏）。
+#   ⇒ 這不是「該封文字改封動作」的問題（v1 本來就在封動作：打了寫入端點），
+#     是「認動作的方式」本身漏了 HTTP 語意裡的隱式 POST。本版把「寫入訊號」從
+#     單一裸字，換成「curl 的資料類旗標／`.post(`／`method=post`／urllib 隱式 POST」
+#     這組結構性訊號——訊號種類有限、可枚舉，跟關鍵字黑名單不是同一件事。
 #
-# 這支封的是**動作**：任何 Bash 指令只要在對 Gitea 的 issues 端點做寫入，
+# 這支封的是**動作**：任何 Bash 指令只要在對 Gitea 的「集合端點」
+# （issues／milestones／labels／pulls，不帶 ID＝新增；帶 ID＝改既有的，放行）做寫入，
 # 就要有一個新鮮的搜尋戳記。它不強迫你用 scripts/ticket，只強迫你搜過。
 #   （同 InkStoneCo#36：「守 prod 的閘，包一層腳本就繞過去了——它看的是指令長相」。
-#     本支同樣只看得到指令文字，這是 PreToolUse 這層的天花板；
-#     所以判準取「端點 ＋ 寫入動詞」兩個都命中才擋，讓純讀取一律放行。）
+#     本支同樣只看得到指令文字，這是 PreToolUse 這層的天花板。）
 #
-# 放行（刻意，這些都不是「開票」）：
+# 放行（刻意，這些都不是「新增」）：
 #   - 只讀不寫（GET）：撈清單、看票、對帳
-#   - 對既有票的留言／改標籤／關票（/issues/<N>/... 這種帶票號的子路徑）
-#   - scripts/ticket 自己（它有自己的閘，重複擋只會互相打架）
+#   - 對既有票號的子路徑（/issues/<N>/... ／/milestones/<N> ／/labels/<N> ／/pulls/<N>...）：
+#     留言、改標籤、關票、改狀態、合併 PR——leo 要的是「不要亂開新的」，不是「不准動 Gitea」
+#   - scripts/ticket 自己（它有自己的三道閘，重複擋只會互相打架）
 #   - 指令裡出現 ticket-api-ok（逃生口，會留在指令歷史上）
+#
+# 只對「issues」做主動搜尋＋在擋下的訊息裡直接點名可能撞到的舊票（milestones/labels/pulls
+# 沒有對應的跨 repo 全文搜尋端點可用，一律只要求「搜尋戳記新鮮」，不生產額外訊息——
+# 這是刻意的簡化，不是漏做；真要幫 milestone/label/PR 做語意重複檢查是另一張票的事）。
+# 搜尋本身連不上網路 → 不影響擋／放行的判斷，只影響訊息裡有沒有列出候選舊票（fail-open
+# 在「錦上添花」的部分，不 fail-open 在「該不該擋」這個核心判斷上）。
 set -uo pipefail
 
 INPUT=$(cat)
@@ -34,18 +53,54 @@ except Exception: print('')
 # 逃生口（留痕）
 case "$CMD" in *ticket-api-ok*) exit 0 ;; esac
 # scripts/ticket 有自己的閘
-case "$CMD" in *scripts/ticket*|*"ticket where"*|*"ticket new"*|*"ticket say"*) exit 0 ;; esac
+case "$CMD" in *scripts/ticket*|*"ticket where"*|*"ticket new"*|*"ticket say"*|*"ticket close"*|*"ticket decide"*) exit 0 ;; esac
 
-# ① 有沒有打到 Gitea 的 issues 端點（不帶票號的那個＝建立新票的路徑）
-printf '%s' "$CMD" | grep -qE 'repos/[^ "'"'"']*/issues([?"'"'"'`,)\\[:space:]]|$)' || exit 0
+# ① 先放行「帶了 ID 的子路徑」——issues/<N>、milestones/<N>、labels/<N>、
+#    pulls/<N>（後面不管接留言／labels／合併都算），這些是在動既有的東西，
+#    不是新增。獨立判斷、排在最前面，不要留給下面那條「集合端點」regex 用
+#    貪婪比對去猜——第一版把 owner/repo 寫成「允許斜線的萬用字元」時，
+#    `/repos/{REPO}/issues/5/labels`（既有票 #5 底下的 labels，不該擋）會被
+#    貪婪比對成「owner/repo 吃掉 {REPO}/issues/5，資源名是 labels」，跟真正
+#    的頂層 /labels 端點混在一起——先用「resource/數字」這個特徵擋在前面，
+#    後面那條就不必再猜。
+printf '%s' "$CMD" | grep -qE '(issues|milestones|labels|pulls)/[0-9]+' && exit 0
 
-# ② 指令裡有沒有 POST 這個詞（純 GET 一律放行）
-#    刻意只認一個裸字：跳脫引號、heredoc、python、curl、各種包裝的寫法無限多，
-#    逐個補 pattern 追不完（leo 2026-08-17：「自然語言的變體是無限的，blacklist 永遠追不完」）。
-#    ①已經確定這是「開票那條端點」，純讀取的指令不會出現 POST ⇒ 一個字就夠，而且沒有跳脫的破口。
-printf '%s' "$CMD" | grep -qw 'POST' || exit 0
+# ② 有沒有打到 Gitea 的「集合端點」（不帶 ID 的那個＝新增的路徑）
+#    repos/<owner>/<repo>/<resource> 或 orgs/<org>/<resource>，資源名後面立刻是
+#    「不是路徑字元」的東西（問號／引號／逗號／右括號／空白／結尾）。
+#    中間那段刻意只排除空白（不必排引號）：①已經先擋掉「帶 ID」的形狀，這裡
+#    只要认出「打到了這個資源的集合端點」就好，多抓一點字元進中間那段不影響
+#    判斷——這也是為什麼 f-string 占位符 `f"{API}/repos/{REPO}/issues"`
+#    （owner/repo 被壓成一個不含斜線的 token）跟真實網址 `repos/inkstone/ISEP/issues`
+#    （owner/repo 是兩段）都吃得下，不必為了兩種形狀各寫一條 pattern。
+ENDPOINT_RE='(repos|orgs)/[^[:space:]]+/(issues|milestones|labels|pulls)([^A-Za-z0-9_/]|$)'
+printf '%s' "$CMD" | grep -qE "$ENDPOINT_RE" || exit 0
 
-# ③ 要有新鮮的搜尋戳記（與 scripts/ticket 共用同一個，30 分鐘）
+RESOURCE=$(printf '%s' "$CMD" | grep -oE '/(issues|milestones|labels|pulls)([^A-Za-z0-9_/]|$)' | head -1 | grep -oE 'issues|milestones|labels|pulls')
+
+# ③ 有沒有寫入訊號（純 GET 一律放行）。刻意取「結構性訊號」而非單一裸字：
+#    - curl：顯式 -X/--request POST，或帶了資料類旗標（curl 帶 -d/--data* 時，
+#      沒寫 -X 也會自動變 POST——這正是舊版漏掉的其中一種隱式 POST）
+#    - requests 系函式庫：`.post(`（大小寫都收）
+#    - 任何函式庫的 `method=` 參數值是 post（大小寫都收）
+#    - urllib.request：`Request(`／`urlopen(` 與 `data=` 同時出現（不要求同一行——
+#      多行 heredoc 裡兩者常常不在同一行）＝隱式 POST，這是 2026-08-27 實際撞到的那種寫法
+WRITE_SIGNAL=no
+if printf '%s' "$CMD" | grep -qiw 'POST'; then
+  # 保留 v1 的裸字比對，但**大小寫不敏感**——v1 只認大寫 POST，
+  # 2026-08-27 `requests.post(...)` 小寫照樣繞過，這裡補上不分大小寫的字。
+  WRITE_SIGNAL=yes
+elif printf '%s' "$CMD" | grep -qiE -- '-X[[:space:]]*POST|--request[[:space:]=]*POST|--data(-raw|-binary|-urlencode)?([[:space:]=]|$)|--json([[:space:]=]|$)|\.post\(|method[[:space:]]*=[[:space:]]*.{0,2}post'; then
+  WRITE_SIGNAL=yes
+elif printf '%s' "$CMD" | grep -qE 'urllib\.request\.(Request|urlopen)\(' \
+  && printf '%s' "$CMD" | grep -qE '\bdata[[:space:]]*='; then
+  # 隱式 POST：urllib.request 傳了 data= 卻沒寫明 method——這是 2026-08-27
+  # 實際撞到的寫法，指令裡從頭到尾沒有 "POST" 三個字母，上面兩層都攔不到。
+  WRITE_SIGNAL=yes
+fi
+[ "$WRITE_SIGNAL" = yes ] || exit 0
+
+# ④ 要有新鮮的搜尋戳記（與 scripts/ticket 共用同一個，30 分鐘）
 STAMP=/tmp/.ticket-where-ok
 NOW=$(date +%s)
 FRESH=no
@@ -55,30 +110,108 @@ if [ -f "$STAMP" ]; then
 fi
 [ "$FRESH" = "yes" ] && exit 0
 
-cat >&2 <<'MSG'
-🚫 你正在用 Gitea API 直接開新票，而這一輪沒有搜尋紀錄
+# 只有 issues 才做「主動幫你搜一次」——從指令裡的 title 欄位猜關鍵字，
+# 真的搜得到就把候選舊票直接列進擋下的訊息裡（重演 2026-08-27 的 Arcrun#100）。
+# 任何一步失敗（拿不到 token、連不上網、payload 裡沒有 title）都安靜放棄，
+# 不影響「擋下來」這個判斷本身。
+HITS=""
+if [ "$RESOURCE" = "issues" ]; then
+  REMOTES=$(git -C "${CLAUDE_PROJECT_DIR:-.}" remote -v 2>/dev/null || true)
+  CRED_LINE=$(printf '%s' "$REMOTES" | grep -m1 'git\.uncle6\.me' | grep -m1 '@' || true)
+  if [ -n "$CRED_LINE" ]; then
+    TOKEN=$(printf '%s' "$CRED_LINE" | sed -E 's|.*//[^:]+:([^@]+)@.*|\1|')
+    # 只認雙引號的 "title": "..."（curl -d／json.dumps 輸出的實際格式，也是
+    # 2026-08-27 那 13 張票真實用的寫法，見 scripts/test-ticket-api-bypass-guard.sh
+    # 既有的模擬指令）。刻意不支援單引號版本——這段 python 要塞進 bash 單引號
+    # 參數字串（`python3 -c '...'`），bash 的單引號字串裡放不進一個字面單引號
+    # （沒有跳脫機制），另外分岔一段處理單引號只會逼自己走回「兩層語言的引號
+    # 疊在一起」那個坑。找不到 title 就安靜放棄——不影響「擋下來」這個判斷本身，
+    # 只是訊息裡少列候選舊票。
+    HITS=$(printf '%s' "$CMD" | _TICKET_TOKEN="$TOKEN" python3 -c '
+import os, re, sys, json, urllib.request, urllib.parse
 
-leo 2026-08-16：「**寫開票前先去搜尋要開在哪裡，不然你永遠會亂開新票**」
-leo 2026-08-20：「**每張票開以前都要搜尋現有票，你為什麼會開了不搜？這個規範不是早就有 hook 了？**」
+cmd = sys.stdin.read()
+pat = "\"title\"\\s*:\\s*\"((?:\\\\.|[^\"\\\\])*)\""
+m = re.search(pat, cmd)
+if not m:
+    sys.exit(0)
+title = m.group(1)
+title = title.replace("\\n", " ").replace("\\\"", "\"")
 
-規範有，閘也有——但那道閘長在 `scripts/ticket` 這支工具裡，
-而你走的是 API 這條側門。**本閘就是把那道門也封上。**
+toks = []
+for t in re.findall(r"[A-Za-z0-9]+|[一-鿿]{2,}", title):
+    if t not in toks:
+        toks.append(t)
+toks = toks[:3]
+if not toks:
+    sys.exit(0)
 
-實錯（2026-08-20 同日）：總管用 API 開了 12 張票，事後盤點**每一張都跟舊票重疊**，
-全部只能關掉指回舊票。leo：「**你在讓事情複雜化**」。
+token = os.environ.get("_TICKET_TOKEN", "")
+seen = {}
+for kw in toks:
+    q = urllib.parse.urlencode({"q": kw, "state": "open", "type": "issues", "limit": 20})
+    url = "https://git.uncle6.me/api/v1/repos/issues/search?" + q
+    try:
+        req = urllib.request.Request(url, headers={"Authorization": "token " + token})
+        data = json.load(urllib.request.urlopen(req, timeout=6))
+    except Exception:
+        continue
+    for it in (data or []):
+        ref = it["repository"]["full_name"] + "#" + str(it["number"])
+        row = seen.setdefault(ref, {"score": 0, "title": it["title"]})
+        row["score"] = row["score"] + 1
+
+hits = sorted(seen.items(), key=lambda kv: -kv[1]["score"])[:6]
+if not hits:
+    sys.exit(0)
+joined = " ".join(toks)
+print("（用猜出來的關鍵字「" + joined + "」順手搜了一次，命中：）")
+for ref, info in hits:
+    score = info["score"]
+    t2 = info["title"][:56]
+    print("  [" + str(score) + "] " + ref + "  " + t2)
+' 2>/dev/null || true)
+  fi
+fi
+
+case "$RESOURCE" in
+  issues)      VERB="開新票" ;;
+  milestones)  VERB="開新 milestone" ;;
+  labels)      VERB="開新 label" ;;
+  pulls)       VERB="開新 PR" ;;
+  *)           VERB="新增東西" ;;
+esac
+
+{
+cat <<MSG
+🚫 你正在用 Gitea API 直接${VERB}，而這一輪沒有搜尋紀錄
+
+leo 2026-08-16：「寫開票前先去搜尋要開在哪裡，不然你永遠會亂開新票」
+leo 2026-08-27：「開票不查是否有現成的，這是什麼問題？」「不只開票前，
+                 所有新增 gitea 的東西，都要搜尋」
+
+規範有，閘也有——但上一版只認裸字 POST，你這次用的寫法（隱式 POST／小寫
+requests.post／milestone·label·PR 端點）沒被管到。**本閘把這些側門也封上。**
+MSG
+if [ -n "$HITS" ]; then
+  printf '\n%s\n' "$HITS"
+fi
+cat <<'MSG'
 
 ── 怎麼過（擇一）───────────────────────────────
-  1. 先搜（預設，戳記 30 分鐘有效，之後 API 也放行）：
+  1. 先搜（預設，戳記 30 分鐘有效，之後所有寫入端點都放行）：
          scripts/ticket where <關鍵字...>
-     🔴 搜到了就**貼進那張票**，不要開新的：
+     🔴 搜到同一條線就貼進那張票，不要開新的：
          scripts/ticket say <owner/repo#N> -F <內文檔>
 
-  2. 真的是新的一條線 → 直接用那支工具開，它會幫你把該檢查的檢查完：
+  2. 開票真的是新的一條線 → 直接用那支工具開，它會幫你把該檢查的檢查完：
          scripts/ticket new <repo> -F <內文檔> --title <標題>
 
-  3. 這次確實不是在開新票（例如批次改標籤／關票／留言）
+  3. 這次確實不是在新增（例如批次改標籤／關票／留言／改 milestone 狀態）
      → 指令裡加 `ticket-api-ok` 說明理由，留痕放行。
 
-放行的情況（本閘不管）：純讀取（GET）、對既有票 /issues/<N>/ 的留言與標籤、scripts/ticket 自己。
+放行的情況（本閘不管）：純讀取（GET）、對既有票號的留言與標籤與關票、
+scripts/ticket 自己。
 MSG
+} >&2
 exit 2

hooks/unpushed-police.sh

@@ -35,10 +35,119 @@ except Exception: print(False)
 ' 2>/dev/null)"
 [ "$stop_active" = "True" ] && exit 0
 
+# ══════════════════════════════════════════════════════════════════════
+# 「遠端到底有沒有這顆 commit」——本檔唯一的判準（inkstone/ISEP#90，2026-08-28）
+# ══════════════════════════════════════════════════════════════════════
+#
+# 🔴 舊判準是「這條分支有沒有 upstream」，而**雲端 session 開出來的工作分支
+#    天生就沒有 upstream**，內容卻等於遠端 main：
+#
+#      薄殼 HEAD        = 081c547d90dc2d80692485af083ca1f71f2094f2
+#      GitHub 遠端 main = 081c547d90dc2d80692485af083ca1f71f2094f2   ← 同一顆
+#
+#    ⇒ 每個雲端 session、每次收工都被攔一次。2026-08-27 一個 session 攔五次，
+#      **五次全是誤報**。而永遠在響的警報＝訓練人忽略這個警報
+#      （本檔第 ③ 段自己在 08-12 就寫過這句，這次是同一個病長在別的判準上）。
+#
+# 🔴 也不能改成「本機的 remote-tracking ref 有沒有含它」的變體：
+#    那份 ref 會過期——08-28 實測本 session 的 `origin/main` 落後遠端整整 4 天。
+#    本機只答得準「有」，答不準「沒有」⇒ 答「沒有」的時候要去問遠端。
+#
+# 三態，不是兩態：0＝遠端有　1＝遠端沒有　2＝問不到（沒 remote／網路不通／沒權限）。
+# **2 一律不報。** 誤攔比漏擋更該修（leo 2026-08-17：文字層那些閘 8 次誤攔、
+# 0 次正確攔截）——把「離線」當成「你沒推」，就是拿雜訊懲罰謹慎。
+
+# 🔴 戳記的 mtime 一律走 lib/mtime.sh：舊寫法（`stat -f %m || stat -c %Y`）在 Linux 上
+#   **永遠算不出數字**（GNU 的 `-f` 是「檔案系統資訊」，它一邊回非零一邊吐一整段文字，
+#   於是後面接上的秒數被那段垃圾污染）⇒ 這支閘給總管的逃生口在雲端整個焊死，
+#   而閘不會告訴他門是壞的（inkstone/ISEP#90 ④，全文見 hooks/lib/mtime.sh）。
+#   lib 不在時就地補一份同順序的定義——這道門不能因為少一個檔案就再關上一次。
+. "$(dirname "$0")/lib/mtime.sh" 2>/dev/null || file_mtime() {
+  _fm=$(stat -c %Y "$1" 2>/dev/null || true)
+  case "${_fm:-}" in ''|*[!0-9]*) _fm=$(stat -f %m "$1" 2>/dev/null || true) ;; esac
+  case "${_fm:-}" in ''|*[!0-9]*) _fm=0 ;; esac
+  printf '%s' "$_fm"
+}
+
+GIT_ASK="env GIT_TERMINAL_PROMPT=0 GIT_ASKPASS=/bin/echo GIT_SSH_COMMAND=ssh\ -oBatchMode=yes"
+_TO=""
+command -v timeout  >/dev/null 2>&1 && _TO="timeout 15"
+command -v gtimeout >/dev/null 2>&1 && _TO="gtimeout 15"
+
+# ls_remote_heads <repo> <remote> → 印出「<sha> <ref>」數行；問不到就印空、離開碼 1
+# 快取 120 秒：Stop hook 每個回合都跑，同一個遠端不必每回合都打一次網路。
+ls_remote_heads() {
+  _lr_repo="$1"; _lr_rm="$2"
+  _lr_key="$(printf '%s|%s' "$_lr_repo" "$_lr_rm" | cksum | tr -d ' /')"
+  # 快取位置可被 UNPUSHED_CACHE_DIR 覆寫——測試要能造「同一個 repo、遠端變了」的場，
+  # 不能被上一個案例的快取餵到舊答案（那會是假綠）。
+  _lr_cache="${UNPUSHED_CACHE_DIR:-/tmp}/.unpushed-lsremote-$_lr_key"
+  if [ -f "$_lr_cache" ]; then
+    _lr_now=$(date +%s 2>/dev/null || echo 0)
+    _lr_mt=$(file_mtime "$_lr_cache")
+    case "$_lr_now$_lr_mt" in *[!0-9]*) _lr_mt=0 ;; esac
+    if [ "$_lr_mt" -gt 0 ] && [ $((_lr_now - _lr_mt)) -lt 120 ]; then
+      [ -s "$_lr_cache" ] || return 1
+      cat "$_lr_cache"; return 0
+    fi
+  fi
+  if _lr_out="$($_TO $GIT_ASK git -C "$_lr_repo" ls-remote --heads "$_lr_rm" 2>/dev/null)" \
+     && [ -n "$_lr_out" ]; then
+    printf '%s\n' "$_lr_out" > "$_lr_cache" 2>/dev/null || true
+    printf '%s\n' "$_lr_out"
+    return 0
+  fi
+  : > "$_lr_cache" 2>/dev/null || true   # 記「這次問不到」，免得每回合都等一次 timeout
+  return 1
+}
+
+# remote_has_commit <repo> <sha> → 0 遠端有／1 遠端沒有／2 問不到
+remote_has_commit() {
+  _rh_repo="$1"; _rh_sha="$2"
+  [ -n "$_rh_sha" ] || return 2
+  # ① 本機就答得出「有」：任何 remote-tracking ref 含這顆 ⇒ 一定推過，不必打網路
+  if [ -n "$(git -C "$_rh_repo" branch -r --contains "$_rh_sha" 2>/dev/null | head -1)" ]; then
+    return 0
+  fi
+  _rh_asked=0
+  for _rh_rm in $(git -C "$_rh_repo" remote 2>/dev/null); do
+    _rh_ls="$(ls_remote_heads "$_rh_repo" "$_rh_rm")" || continue
+    _rh_asked=1
+    # 遠端某條 head 就是這顆 ⇒ 推過（雲端那個誤報正是落在這一格）
+    printf '%s\n' "$_rh_ls" | awk '{print $1}' | grep -qx "$_rh_sha" && return 0
+    # 遠端那顆本機也有時，才問得出祖先關係（本機沒有就只能靠上面的等值比對）
+    printf '%s\n' "$_rh_ls" | while read -r _rh_rsha _; do
+      [ -n "$_rh_rsha" ] || continue
+      git -C "$_rh_repo" cat-file -e "${_rh_rsha}^{commit}" 2>/dev/null || continue
+      git -C "$_rh_repo" merge-base --is-ancestor "$_rh_sha" "$_rh_rsha" 2>/dev/null && exit 7
+    done
+    [ $? = 7 ] && return 0
+  done
+  [ "$_rh_asked" = 1 ] && return 1
+  return 2
+}
+
+# remote_sha_of <repo> <遠端名> <分支名> → 印出遠端那顆 sha（拿不到印空）
+remote_sha_of() {
+  ls_remote_heads "$1" "$2" 2>/dev/null \
+    | awk -v b="refs/heads/$3" '$2 == b { print $1; exit }'
+}
+
 TOP="${CLAUDE_PROJECT_DIR:-$(cd "$(dirname "$0")/../.." && pwd)}"
 
 # 掃描對象：頂層 + 各子 repo（存在才掃）。worktree 一併涵蓋（git -C 會自己解）。
-REPOS="$TOP $TOP/matrix/arcrun $TOP/products/arcrun-rag $TOP/polaris/mira"
+#
+# 🔴 2026-08-28（inkstone/ISEP#90）補雲端那一格：雲端的 `$CLAUDE_PROJECT_DIR`
+#    是**薄殼根**，真身被 bootstrap.sh clone 到 `$TOP/InkStoneCo/`，子 repo 在
+#    `$TOP/InkStoneCo/matrix/arcrun` …。舊清單只認地端那種「頂層就是真身」的排法
+#    ⇒ **雲端上真身有東西沒推，本閘一輩子不會知道**（它掃的四個路徑一個都不存在）。
+#    ⇒ 這跟 ① 的誤攔是同一個病的兩面：在雲端，這支閘既亂叫、又看不到該看的地方。
+REPOS=""
+for _body in "$TOP" "$TOP/InkStoneCo"; do
+  [ -d "$_body/.git" ] || [ -f "$_body/.git" ] || continue
+  REPOS="$REPOS $_body $_body/matrix/arcrun $_body/products/arcrun-rag $_body/polaris/mira"
+done
+[ -n "$REPOS" ] || REPOS="$TOP"
 
 problems=""
 for r in $REPOS; do
@@ -50,17 +159,33 @@ for r in $REPOS; do
   staged="$(git -C "$r" diff --cached --shortstat 2>/dev/null | head -1)"
 
   # ② 已 commit 但沒推（**當前分支**）
+  #
+  unknown=""
+  # 🔴 判準是「遠端有沒有這顆 commit」，不是「有沒有 upstream」（ISEP#90，見檔頭那段）。
+  #    有 upstream 時仍照原本的算法報「領先幾筆」——那個數字有用；
+  #    沒 upstream 時去問遠端，問不到就**不報**。
   unpushed=""
   br="$(git -C "$r" branch --show-current 2>/dev/null)"
   if [ -n "$br" ]; then
+    head_sha="$(git -C "$r" rev-parse HEAD 2>/dev/null || true)"
     up="$(git -C "$r" rev-parse --abbrev-ref "@{upstream}" 2>/dev/null || true)"
     if [ -n "$up" ]; then
       n="$(git -C "$r" rev-list --count "$up".."$br" 2>/dev/null || echo 0)"
-      [ "$n" != "0" ] && unpushed="領先 $up $n 筆"
+      if [ "$n" != "0" ]; then
+        # upstream 本身可能過期（本機那份 ref 落後遠端 4 天是實測過的）
+        # ⇒ 先問遠端；遠端已經有這顆就不是「沒推」。
+        remote_has_commit "$r" "$head_sha"
+        [ "$?" = 0 ] || unpushed="領先 $up $n 筆"
+      fi
     else
-      # 沒 upstream＝這條分支從來沒推過（今天 fix/cis-round3-install 就是這樣）
-      has_commits="$(git -C "$r" rev-list --count HEAD 2>/dev/null || echo 0)"
-      [ "$has_commits" != "0" ] && unpushed="分支 $br **從未推過**（無 upstream）"
+      remote_has_commit "$r" "$head_sha"
+      case "$?" in
+        1) unpushed="分支 $br **從未推過**（遠端沒有 $(printf '%.7s' "$head_sha")）" ;;
+        # 0＝遠端有這顆（雲端 session 的工作分支就是這種）→ 不報
+        # 2＝問不到遠端 → 不報，但這件事本身值得知道，收在下面當脈絡
+        2) [ -n "$(git -C "$r" rev-list --count HEAD 2>/dev/null)" ] \
+             && unknown="分支 $br 問不到遠端（沒有 remote／網路不通）——**不當成沒推**" ;;
+      esac
     fi
   fi
 
@@ -79,9 +204,27 @@ for r in $REPOS; do
   #   **這正是同一晚重複八次的那個病：檢查跑了，但檢查的對象是錯的。**
   #   ⇒ 基準改成「整合分支」：gitea/main > origin/main > main > 當前分支。
   base="$br"
+  base_label=""
   for cand in gitea/main origin/main main; do
     if git -C "$r" rev-parse --verify -q "$cand" >/dev/null 2>&1; then base="$cand"; break; fi
   done
+  base_label="$base"
+  # 🔴 2026-08-28（inkstone/ISEP#90）：**基準的 ref 也會過期。**
+  #   08-28 實測：本機 `origin/main` 落後遠端整整 4 天 ⇒ 拿它當基準，
+  #   「已經在遠端 main 上」的分支會被整批報成散落——包括**雲端 session 自己
+  #   那條工作分支**（它的內容就等於遠端 main）。
+  #   08-15 那次訂正的是「基準挑錯了分支」，這次是「基準挑對了但那份是舊的」：
+  #   同一個病的第三面——檢查跑了，但檢查的對象是舊的。
+  #   ⇒ 問一次遠端；拿得到、而且本機真的有那顆 commit（不然算不了祖先），才換過去。
+  case "$base_label" in
+    */*) _base_rm="${base_label%%/*}"; _base_br="${base_label#*/}" ;;
+    *)   _base_rm="origin";            _base_br="$base_label" ;;
+  esac
+  _base_fresh="$(remote_sha_of "$r" "$_base_rm" "$_base_br")"
+  if [ -n "$_base_fresh" ] && git -C "$r" cat-file -e "${_base_fresh}^{commit}" 2>/dev/null; then
+    base="$_base_fresh"
+    base_label="$_base_rm/$_base_br（遠端實際那顆 $(printf '%.7s' "$_base_fresh")）"
+  fi
   if [ -n "$base" ]; then
     for b in $(git -C "$r" for-each-ref --format='%(refname:short)' refs/heads/ 2>/dev/null); do
       [ "$b" = "$base" ] && continue
@@ -111,7 +254,7 @@ for r in $REPOS; do
       age="$(git -C "$r" log -1 --format='%ad' --date=format:'%m-%d' "$b" 2>/dev/null)"
       # 用真實換行累積，不用 \n 逃脫——否則後面的 printf '%b' 會把分支名再解讀一次
       stray="$stray
-       - $b：$cnt 筆未併入 $base（最後動 $age）"
+       - $b：$cnt 筆未併入 $base_label（最後動 $age）"
     done
   fi
 
@@ -123,10 +266,12 @@ for r in $REPOS; do
   [ -n "$unpushed" ] && line="$line
      · $unpushed"
   [ -n "$stray" ]    && line="$line
-     · 🔀 **散落分支**（有 commit 沒併回 $br）：$stray"
+     · 🔀 **散落分支**（有 commit 沒併回 $base_label）：$stray"
   # 刻意保留的分支**不會自己觸發警報**（那正是加它的目的），
   # 但這個 repo 若本來就有別的問題要報，就順便把它列出來當脈絡——
   # 免得「保留」變成另一種看不見。
+  [ -n "$line" ] && [ -n "$unknown" ] && line="$line
+     · ❔ $unknown"
   [ -n "$line" ] && [ -n "$held" ] && line="$line
      · ⏸️ 刻意保留（不觸發警報，理由在 .claude/branch-holds.md）：$held"
   [ -n "$line" ] && problems="$problems

labels.yaml

@@ -101,6 +101,26 @@ labels:
     exclusive: true
     description: "雜務、整理、不改行為"
 
+  # ── 使用者旅程（正交，`j/` scope）──────────────────
+  #
+  # inkstone/ISEP#92：「這件事服務哪個使用者旅程，沒有記錄⋯⋯後面要把相關的票
+  # 聚成一包時，只能靠人重新讀一遍每張票在講什麼。」
+  #
+  # `ticket subtask/handoff --journey <名>` 會把 `j/<名>` **同時貼在母子兩端**
+  # （只貼一端就聚不起來）。標籤不存在時它會擋下來並指回本檔——
+  # **「要求標籤在場」，不是「猜哪些名字合法」**。
+  #
+  # 🔴 這裡刻意是空的。旅程怎麼切、叫什麼名字，是方向題（四題公式第 4 題），
+  #    不該由工具或 subagent 代決；隨手造名字會讓同一條旅程長出三個拼法。
+  #    要新增一條就照這個形狀加一筆，然後跑 scripts/gitea-labels-sync.sh：
+  #
+  #  - name: "j/收件匣"
+  #    color: "fbca04"
+  #    exclusive: false
+  #    description: "🧭 旅程：<一句話講這條旅程的頭和尾>"
+  #
+  #    （票上明講「對不上就不貼，不硬湊」——沒有對應旅程的票就不要加 --journey。）
+
   # ── 結構（正交）──────────────────────────────────
   - name: "hub"
     color: "0052cc"

pending-main-push/README.md

@@ -0,0 +1,16 @@
+# `pending-main-push/` — 被擋下的推 main 請求（本機狀態，不進版控）
+
+`hooks/main-and-prod-push-guard.sh` 擋下一次推 main 的同時，會把那次請求寫成
+`<誰>--<哪個 repo>.md` 丟進這個目錄：repo／分支／逐筆 commit／改了哪些檔，**原始資料**。
+
+> leo 2026-08-12：「**它會問你的意見，所以每個你叫起來的 subagent 都有名字。**」
+> 閘做不到「同步問總管」（不同行程），做得到的是「**當場擋 ＋ 留下是誰要求的**」。
+
+## 規約
+
+- **一份檔案 ＝ 一筆還沒裁的請求。** 總管裁完就刪掉它——留著代表還沒裁。
+- **這個目錄的內容不進版控**（`.gitignore` 有一段寫了為什麼），只有本檔在版控裡。
+- **測試不准在這裡留東西。** 推 main 的測資本來就都會觸發這支閘，
+  所以那幾支測試改成跑 `hooks/tests/lib/hook-sandbox.sh` 建的複本，請求寫進暫存區；
+  每支測完都會驗兩件：這裡沒被碰過、而且沙盒裡**真的有**留下請求
+  （只驗前者的話，「把留紀錄的功能關掉」也會綠——那是假綠）。

pending-main-push/unnamed--ISEP.md

@@ -1,43 +0,0 @@
-# 推 main 的請求：未署名
-
-- repo：/Users/youlinhsieh/Documents/tech_projects/ISEP
-- 分支：fix/push-guard-target-not-substring
-- 時間：2026-08-21 01:28:51
-
-- 它想跑的指令：
-```
-git push -q origin master
-```
-
-## 還沒推上去的 commit（原始資料，不是轉述）
-
-```
-43c328d Merge pull request 'feat/milestone-must-have-due' (#50) from feat/milestone-must-have-due into main
-bcb736e Merge pull request 'fix/worksheet-dedup-by-content' (#49) from fix/worksheet-dedup-by-content into main
-6772ca6 每個里程碑都要有真的期限，9999 也擋
-1b55512 待驗工作單改用宣稱內容去重，驗過的不再冒出來
-1920d4c Merge pull request '身為 leo，我要雲端 clone 下來就有閘，我才不用先處理憑證' (#48) from fix/b4-real-probe into main
-47ed778 改走「直接複製進薄殼 repo」，並修掉一支會偷跑指令的閘
-03d9782 查了官方文件才發現：setup script 根本讀不到環境變數，而 exit 1 會鎖死 session
-36d8e05 認證驗證加 timeout：掛住比失敗更糟
-1356372 B4 的探針我自己沒撞過，實撞後發現它根本不會擋
-d306158 Merge pull request '身為 leo，我要雲端 env 檔能直接產在桌面，我才不用去翻隱藏目錄' (#46) from feat/cloud-env-outdir into main
-9099c3f make-cloud-env.sh：輸出路徑可指定，且不再對使用者指定的目錄動權限
-5bceb03 v0.3.1
-4e73b8b Merge pull request '身為 leo，我要雲端驗收步驟在閘死掉時真的變紅，我才不會再被三個綠燈騙一次' (#45) from fix/testing-b-section-discriminating into main
-291787e TESTING.md B 段整段換掉——舊版在閘全滅時會回綠
-3a95121 雲端零閘的兩個真因：setup 不自驗＋沒有 release 撐版本號 (#44)
-daa1674 雲端零閘的兩個真因：setup 從不驗證自己＋沒有任何 release 撐版本號
-c48495d Merge pull request 'fix(hooks): sdd-guard.sh 修「解析失敗仍照擋、且訊息洩漏 /nonexistent」' (#42) from fix/sdd-guard-path-resolution into main
-8718658 fix(hooks): sdd-guard.sh 修「解析失敗仍照擋、且訊息洩漏 /nonexistent」（InkStoneCo#22）
-e6d183d Merge pull request '產生雲端 env 設定給 leo 貼（InkStoneCo#14）' (#41) from feat/cloud-env-generator into main
-f855d82 產生雲端 env 設定，不要 leo 自己拼湊（InkStoneCo#14）
-```
-
-## 改了哪些檔
-
-```
-```
-
----
-總管裁完請刪掉這個檔——留著代表「還沒裁」。

pending-main-push/unnamed--InkStoneCo.md

@@ -1,23 +0,0 @@
-# 推 main 的請求：未署名
-
-- repo：/Users/youlinhsieh/Documents/tech_projects/InkStoneCo
-- 分支：main
-- 時間：2026-08-21 01:28:23
-
-- 它想跑的指令：
-```
-git push -q origin master
-```
-
-## 還沒推上去的 commit（原始資料，不是轉述）
-
-```
-```
-
-## 改了哪些檔
-
-```
-```
-
----
-總管裁完請刪掉這個檔——留著代表「還沒裁」。

scripts/countdown-milestone-refresh.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# countdown-milestone-refresh.sh — 把「主線 milestone 的期限」寫進倒數用的快取
+#                                  （inkstone/ISEP#63 的第二個基準）
+#
+# 為什麼是一支獨立腳本、而不是寫在 hook 裡：
+#   倒數那一行走在 **UserPromptSubmit** 上，也就是每一則訊息的關鍵路徑。
+#   在那裡打 HTTP ＝ leo 每講一句話都先等一次網路。
+#   ⇒ hook 只讀快取（`hooks/lib/countdown.py` 從不打網路），
+#     快取由本支在 **SessionStart** 更新一次。不是輪詢、不掛排程（守 D14 紅線）。
+#
+# 寫出來的檔：`$ISEP_COUNTDOWN_STATE_DIR/milestone-due`，一行 `YYYY-MM-DD|<名稱>`。
+# 拿不到 token／拿不到期限 ⇒ **不寫、不報錯、不留舊資料以外的東西**：
+#   倒數那一行寧可少一段，也不要顯示一個編出來的日期。
+set -uo pipefail
+
+HOST="${TICKET_HOST:-https://git.uncle6.me}"
+TOKEN="${GITEA_TOKEN_CLAUDE_CODE:-${GITEA_TOKEN:-}}"
+REPOS="${ISEP_COUNTDOWN_REPOS:-inkstone/InkStoneCo inkstone/ISEP}"
+
+DIR="${ISEP_COUNTDOWN_STATE_DIR:-$HOME/.claude/isep-countdown}"
+mkdir -p "$DIR" 2>/dev/null || exit 0
+OUT="$DIR/milestone-due"
+
+[ -n "$TOKEN" ] || exit 0
+
+RAW=""
+for repo in $REPOS; do
+  body=$(curl -s --max-time 4 -H "Authorization: token $TOKEN" \
+          "$HOST/api/v1/repos/$repo/milestones?state=open" 2>/dev/null) || continue
+  RAW="$RAW$body"$'\n'
+done
+
+printf '%s' "$RAW" | ISEP_OUT="$OUT" python3 -c '
+import json, os, sys
+from datetime import datetime, timezone
+
+best = None
+for chunk in sys.stdin.read().split("\n"):
+    chunk = chunk.strip()
+    if not chunk:
+        continue
+    try:
+        rows = json.loads(chunk)
+    except Exception:
+        continue
+    if not isinstance(rows, list):
+        continue
+    for m in rows:
+        due = (m or {}).get("due_on") or ""
+        if not due:
+            continue                      # 沒設期限的 milestone 不是節拍器
+        try:
+            dt = datetime.fromisoformat(due.replace("Z", "+00:00"))
+        except Exception:
+            continue
+        if dt.tzinfo is None:
+            dt = dt.replace(tzinfo=timezone.utc)
+        # 最近的那一個＝現在真的在追的那一個
+        if best is None or dt < best[0]:
+            best = (dt, (m or {}).get("title") or "主線")
+
+if best is None:
+    raise SystemExit(0)
+dt, title = best
+with open(os.environ["ISEP_OUT"], "w") as f:
+    f.write("%s|%s\n" % (dt.astimezone().strftime("%Y-%m-%d"), title))
+' 2>/dev/null || true
+
+exit 0

scripts/debt-worklist

@@ -0,0 +1,559 @@
+#!/usr/bin/env python3
+"""debt-worklist — 還債線：每天固定撈一次「今天可以領什麼」，整包整包地領。
+
+leo 2026-08-27（inkstone/ISEP#83 的來由，他當場訂正總管的誤解）：
+  「這是兩件不同的事，你根本沒搞清楚，距離是在確定有個緊急事件要儘速達成時，
+   現在每天都在追新的，所以**要用 Routine 去消化舊的**，可以有多個條件」
+
+⇒ **兩條線，各用各的判準**，不是二選一：
+
+    緊急線   有事要趕        → 用「距離目標的遠近」排（＝掛在 open milestone 上的那些）
+    還債線   每天消化舊的     → 用多條件排（事故／擋人／承諾／票齡／估工）  ← 本工具
+
+病根：全 org 229 張 open 票，每天在動的只有掛在 active milestone 上的那些。
+沒掛的不是不重要，是**沒有任何機制會去拿它們**。`worklist-guard.sh` 擋的是
+「這一輪已經領到的工作沒做完就收工」——它不會去把舊票撈出來。本工具補的是供給面。
+
+三個動詞：
+
+    debt-worklist list                   撈一次，排好序印出來（預設動作）
+    debt-worklist claim <票...>          領走（今天領的，明天就不會再出現在清單上）
+    debt-worklist forget <票...>         放回去（領錯了、或那條線改方向了）
+
+票的寫法：`owner/repo#N`，例：`inkstone/InkStoneCo#44`
+
+🔴 **不是輪詢。** 這支腳本自己不會醒——是人跑它、或 SessionStart 那一次順手跑。
+   不准掛 Gitea Actions／webhook fan-out（CLAUDE.md 避免再被 flag 的硬規則，
+   `issue-handle` 明寫「有事才讀」，換成 Gitea 也不放寬）。
+
+離線可測：設 `ISEP_DEBT_FIXTURE=<json 檔>` 就完全不打網路（測試用）。
+狀態檔位置可用 `ISEP_DEBT_STATE_DIR` 改（測試用，預設 `~/.claude/isep-debt/`）。
+"""
+import json
+import os
+import re
+import subprocess
+import sys
+import urllib.error
+import urllib.parse
+import urllib.request
+from datetime import datetime, timezone
+
+HOST = os.environ.get("TICKET_HOST") or "https://git.uncle6.me"
+ORG = os.environ.get("ISEP_DEBT_ORG") or "inkstone"
+
+# ── 「現在的主線是哪一個」只有一份答案（inkstone/ISEP#82 → hooks/lib/mainline.py）──
+#   本工具排除的是**緊急線正在管的那些**。在 #82 之前，「哪個是 active」沒有指涉對象
+#   （14 個 open milestone 同時亮著），所以第一版只能粗暴地「掛 open milestone 就排除」。
+#   現在有唯一答案了 ⇒ 接上去，**不要自己養第二套判斷**（兩份必然漂移）。
+sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "hooks", "lib"))
+try:
+    import mainline as ML
+except Exception:      # 拿不到共用零件就退回舊行為（fail-open），不讓還債線整個癱掉
+    ML = None
+
+# 等 leo 的票不進「可領清單」——不是它們不重要，是**沒有人能替他領**：
+#   Human／human/exec ＝ 要他親手批示或動手
+#   s/stage           ＝ 已經部到 stage，等他驗（session-start-recall 就是這樣定義的）
+# 這些的正確動作是「催」不是「領」，而催辦是 inkstone/ISEP#93 的事。本票是供給面。
+WAITING_LEO_LABELS = {"Human", "human/exec", "s/stage"}
+
+# 已經有人在做／已經有 PR 的狀態：這是「答應過人家的」，債比沒開工的還硬。
+STARTED_LABELS = {"s/doing", "s/review"}
+
+
+def die(msg, code=2):
+    print(msg, file=sys.stderr)
+    sys.exit(code)
+
+
+# ── 連線（跟 scripts/ticket 同一套：先找帶憑證的 remote，再退環境變數）────────
+def token():
+    root = os.environ.get("CLAUDE_PROJECT_DIR") or os.getcwd()
+    host = HOST.split("//")[-1].rstrip("/")
+    try:
+        out = subprocess.run(["git", "-C", root, "remote", "-v"],
+                             capture_output=True, text=True, timeout=20).stdout
+    except Exception:
+        out = ""
+    for line in out.splitlines():
+        if host in line:
+            m = re.search(r"//[^:/]+:([^@]+)@", line)
+            if m:
+                return m.group(1)
+    for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
+        if os.environ.get(env):
+            return os.environ[env]
+    die(f"""🔴 拿不到 {host} 的 token
+
+擇一：
+  • 讓某個 remote 帶憑證（多數 repo 的 gitea/origin 本來就有）
+  • 或設環境變數 GITEA_TOKEN_CLAUDE_CODE""")
+
+
+def api(path):
+    url = f"{HOST}/api/v1{path}"
+    req = urllib.request.Request(url, headers={"Authorization": f"token {token()}"})
+    try:
+        return json.load(urllib.request.urlopen(req, timeout=60))
+    except urllib.error.HTTPError as e:
+        die(f"🔴 Gitea {e.code}：{e.read().decode()[:300]}\n   （path={path}）")
+    except Exception as e:
+        die(f"🔴 打不到 {HOST}：{e}\n   （path={path}）")
+
+
+# ── 收集：全 org 每個 repo 的 open issue ＋ open PR ──────────────────────────
+def collect():
+    """回 (repos, items)。repos 是「我查了哪些」的證明，items 是原始票。
+
+    fixture 模式（測試用）：完全不打網路，資料從 json 檔讀。
+    """
+    fx = os.environ.get("ISEP_DEBT_FIXTURE")
+    if fx:
+        with open(fx) as f:
+            data = json.load(f)
+        return data["repos"], data["items"]
+
+    repos, items = [], []
+    for r in api(f"/orgs/{ORG}/repos?limit=100") or []:
+        full = r["full_name"]
+        if not r.get("has_issues", True):
+            repos.append({"name": full, "issues": 0, "prs": 0, "skipped": "issues 關閉"})
+            continue
+        got, page = [], 1
+        while True:
+            q = urllib.parse.urlencode({"state": "open", "limit": 50, "page": page})
+            batch = api(f"/repos/{full}/issues?{q}") or []
+            got.extend(batch)
+            if len(batch) < 50:
+                break
+            page += 1
+            if page > 20:      # 保險絲：不可能有一千張，有的話是我寫錯了
+                break
+        for it in got:
+            it.setdefault("repository", {"full_name": full})
+        n_pr = sum(1 for it in got if it.get("pull_request"))
+        repos.append({"name": full, "issues": len(got) - n_pr, "prs": n_pr})
+        items.extend(got)
+    return repos, items
+
+
+# ── 工具 ───────────────────────────────────────────────────────────────────
+def ref_of(it):
+    return f"{it['repository']['full_name']}#{it['number']}"
+
+
+def labels_of(it):
+    return {l["name"] for l in (it.get("labels") or [])}
+
+
+def is_pr(it):
+    return bool(it.get("pull_request"))
+
+
+def parse_ts(s):
+    if not s:
+        return None
+    try:
+        return datetime.fromisoformat(s.replace("Z", "+00:00"))
+    except Exception:
+        return None
+
+
+def now():
+    """時鐘可以被定住——測試要能重現，不能今天跑綠明天跑紅。"""
+    inj = os.environ.get("ISEP_DEBT_NOW")
+    if inj:
+        d = parse_ts(inj)
+        if d:
+            return d
+    return datetime.now(timezone.utc)
+
+
+def days_since(s):
+    d = parse_ts(s)
+    if not d:
+        return 0.0
+    return max(0.0, (now() - d).total_seconds() / 86400)
+
+
+REF_RE = re.compile(r"(?:([\w.-]+)/([\w.-]+))?#(\d+)")
+
+
+def refs_in(it):
+    """從標題＋內文抓出它指到的別張票。裸 `#12` 算同 repo。
+
+    只認得出「文字上指了誰」——這是零成本的訊號（內文本來就在清單裡）。
+    Gitea 原生的 dependencies 要一張票打一次 API，229 張＝229 次，不值得。
+    """
+    owner, repo = it["repository"]["full_name"].split("/")
+    out = set()
+    text = f"{it.get('title') or ''}\n{it.get('body') or ''}"
+    for o, r, n in REF_RE.findall(text):
+        out.add(f"{o or owner}/{r or repo}#{n}")
+    out.discard(ref_of(it))
+    return out
+
+
+# ── 排序：多個條件，每一條都看得見自己貢獻了幾分 ─────────────────────────────
+#
+# leo 給的順序（票上原文）：出事的 → 擋住別人的 → 答應過人家的 → 放最久的 → 最快做完的。
+# 分數只是把這個順序寫成可重現的東西；**每一項都會印在票旁邊**，
+# 排出來覺得不對可以直接指著說「這一項給太多」，而不是猜它為什麼在第一名。
+def score(it, in_degree):
+    lab = labels_of(it)
+    parts = []
+
+    if "type/bug" in lab:
+        parts.append(("事故", 40))
+    if "p/high" in lab:
+        parts.append(("高優先", 20))
+    if "p/low" in lab:
+        parts.append(("低優先", -12))
+
+    blocked = in_degree.get(ref_of(it), 0)
+    if blocked:
+        parts.append((f"擋住{blocked}張", min(12 * blocked, 36)))
+    if is_pr(it):
+        # 躺著沒結論的 PR 擋的是 merge 那條路（inkstone/ISEP#81 是它的另一半）
+        parts.append(("PR躺著", 25))
+
+    started = lab & STARTED_LABELS
+    if started:
+        parts.append((f"已開工({'/'.join(sorted(started))})", 18))
+    if it.get("assignees") or it.get("assignee"):
+        parts.append(("有人接了", 12))
+
+    ms = it.get("milestone") or {}
+    if ms and (ms.get("state") or "open") == "open" and ML is not None:
+        due = ML.due_of(ms)
+        if due and due < now():
+            # 掛在**別條**（非主線）而且期限已經過去的 milestone ⇒ 這是承諾過的日期，
+            # 而那個日期已經過了。它之所以還在這份清單上，正是因為沒有人在管那條線。
+            parts.append((f"逾期{int((now() - due).total_seconds() // 86400)}天的承諾", 15))
+
+    age = days_since(it.get("updated_at"))
+    if age >= 1:
+        parts.append((f"擱置{int(age)}天", round(min(age * 0.6, 30), 1)))
+
+    body_len = len(it.get("body") or "")
+    if "type/chore" in lab or body_len < 800:
+        parts.append(("看起來小", 10))
+
+    total = round(sum(p[1] for p in parts), 1)
+    return total, parts
+
+
+def pick(items, claimed):
+    """把原始票分成三堆：可領的／緊急線的／要 leo 動手的。並回統計。"""
+    open_refs = {ref_of(it) for it in items}
+    in_degree = {}
+    for it in items:
+        for target in refs_in(it):
+            if target in open_refs:
+                in_degree[target] = in_degree.get(target, 0) + 1
+
+    ml = ML.load() if ML is not None else None
+    pool, stats = [], {"milestone": 0, "human": 0, "claimed": 0, "total": len(items),
+                       "other_ms": 0, "mainline": ml}
+    for it in items:
+        ref = ref_of(it)
+        ms = it.get("milestone")
+        if ms and (ms.get("state") or "open") == "open":
+            if ml is None:
+                # 現在沒有主線 ⇒ 分不出哪一條是緊急線在管的。退回保守做法：
+                # 掛 open milestone 的一律不領（寧可少領，不要跟緊急線搶同一張）。
+                stats["milestone"] += 1
+                continue
+            if ML.belongs(ref, ml, ms.get("title")):
+                stats["milestone"] += 1   # 這張真的在主線上 ⇒ 緊急線在管，不重複領
+                continue
+            # 掛在**別條** milestone 上：那條線現在沒有人在推 ⇒ 它就是債
+            stats["other_ms"] += 1
+        if labels_of(it) & WAITING_LEO_LABELS:
+            stats["human"] += 1           # 沒有人能替 leo 領（催辦是 ISEP#93）
+            continue
+        if ref in claimed:
+            stats["claimed"] += 1         # 昨天領走的，今天不再出現
+            continue
+        s, parts = score(it, in_degree)
+        pool.append({"ref": ref, "title": it.get("title") or "", "score": s,
+                     "why": parts, "labels": sorted(labels_of(it)),
+                     "pr": is_pr(it), "url": it.get("html_url"),
+                     "age": round(days_since(it.get("updated_at")), 1),
+                     "refs": sorted(refs_in(it) & open_refs)})
+    pool.sort(key=lambda d: (-d["score"], d["ref"]))
+    return pool, stats, in_degree
+
+
+# ── 成包：互相指著的必然同包（票上原文「相關的票要成包一起領，不要拆散」）──────
+#
+# 🔴 **只認強訊號，寧可少成包**。第一版用「單向文字引用」成包，結果是
+#    **前 190 張裡有 121 張黏成一包**——因為大家都會順手引用 hub 票。
+#    一包 121 張＝沒有人領得動＝跟沒分包一樣。所以只認這兩種：
+#      ① 互相指著（A 的內文提 B，且 B 的內文提 A）——單向不算
+#      ② Gitea 原生相依（`ticket subtask` 建的母子票就是這個）
+#    代價：同一條使用者旅程但沒有互指、也沒建相依的兩張票不會成包。
+#    這是誠實的取捨——**寧可漏成包，不要成一包沒人領得動的**。
+BUNDLE_CAP = 8            # 一包最多印幾張；超過就說「還有幾張」
+DEPS_TOP_K = 25           # 只對前 K 名查原生相依（一張一次 API，不對全部查）
+
+
+def dep_edges(pool, enabled=True):
+    """回 [(a, b)…]：前 K 名的原生相依邊，只留兩端都在 pool 裡的。"""
+    fx = os.environ.get("ISEP_DEBT_FIXTURE")
+    if fx:
+        with open(fx) as f:
+            deps = (json.load(f).get("deps") or {})
+        in_pool = {d["ref"] for d in pool}
+        return [(a, b) for a, bs in deps.items() for b in bs
+                if a in in_pool and b in in_pool]
+    if not enabled:
+        return []
+    in_pool = {d["ref"] for d in pool}
+    edges = []
+    for d in pool[:DEPS_TOP_K]:
+        owner, rest = d["ref"].split("/", 1)
+        repo, num = rest.split("#")
+        try:
+            got = api(f"/repos/{owner}/{repo}/issues/{num}/dependencies") or []
+        except SystemExit:
+            continue
+        for i in got:
+            other = f"{i['repository']['full_name']}#{i['number']}"
+            if other in in_pool:
+                edges.append((d["ref"], other))
+    return edges
+
+
+def mutual_edges(pool):
+    idx = {d["ref"]: set(d["refs"]) for d in pool}
+    out = []
+    for ref, targets in idx.items():
+        for t in targets:
+            if t in idx and ref in idx[t] and ref < t:
+                out.append((ref, t))
+    return out
+
+
+def bundle(pool, edges):
+    idx = {d["ref"]: d for d in pool}
+    parent = {r: r for r in idx}
+
+    def find(x):
+        while parent[x] != x:
+            parent[x] = parent[parent[x]]
+            x = parent[x]
+        return x
+
+    def union(a, b):
+        ra, rb = find(a), find(b)
+        if ra != rb:
+            parent[rb] = ra
+
+    for a, b in edges:
+        if a in idx and b in idx:
+            union(a, b)
+
+    groups = {}
+    for d in pool:
+        groups.setdefault(find(d["ref"]), []).append(d)
+    out = []
+    for members in groups.values():
+        members.sort(key=lambda d: (-d["score"], d["ref"]))
+        out.append({"lead": members[0], "members": members,
+                    "score": members[0]["score"]})
+    out.sort(key=lambda b: (-b["score"], b["lead"]["ref"]))
+    return out
+
+
+# ── 狀態：領走了什麼（明天的清單要看得出昨天領走的不見了）───────────────────
+def state_dir():
+    d = os.environ.get("ISEP_DEBT_STATE_DIR") or os.path.expanduser("~/.claude/isep-debt")
+    os.makedirs(d, exist_ok=True)
+    return d
+
+
+def state_path():
+    return os.path.join(state_dir(), "claimed.json")
+
+
+def load_state():
+    try:
+        with open(state_path()) as f:
+            d = json.load(f)
+    except Exception:
+        d = {}
+    d.setdefault("claims", {})
+    d.setdefault("last_run", None)
+    return d
+
+
+def save_state(d):
+    with open(state_path(), "w") as f:
+        json.dump(d, f, ensure_ascii=False, indent=1)
+
+
+# ── 印 ─────────────────────────────────────────────────────────────────────
+def print_proof(repos, stats):
+    scanned = [r for r in repos if not r.get("skipped")]
+    n_iss = sum(r["issues"] for r in scanned)
+    n_pr = sum(r["prs"] for r in scanned)
+    print(f"🔎 查過的 repo：{len(repos)} 個（{ORG} 全組織）"
+          f"　open issue {n_iss}、open PR {n_pr}")
+    for r in sorted(repos, key=lambda x: -(x["issues"] + x["prs"])):
+        mark = f"（跳過：{r['skipped']}）" if r.get("skipped") else ""
+        print(f"     · {r['name']}　issue {r['issues']}／PR {r['prs']} {mark}")
+    ml = stats.get("mainline")
+    if ml:
+        print(f"\n🎯 現在的主線：{ML.ref_of(ml)}「{ml.get('title')}」"
+              f"（唯一答案來自 scripts/mainline，本工具不自己判）")
+        print(f"     掛在**別條** milestone 上的 {stats['other_ms']} 張仍算債"
+              "——那條線現在沒有人在推")
+    else:
+        print("\n🎯 現在沒有標主線（`scripts/mainline set …`）"
+              "⇒ 分不出哪條是緊急線在管的，保守起見：掛 open milestone 的一律不領")
+    print(f"\n   扣掉：掛在 open milestone 上的 {stats['milestone']} 張（那些歸緊急線管）"
+          f"／等 leo 的 {stats['human']} 張"
+          f"（Human・human/exec・s/stage——那些要催不是要領，見 inkstone/ISEP#93）"
+          f"／已經領走的 {stats['claimed']} 張")
+
+
+def print_carry(state, items):
+    """昨天領走的，今天怎麼了——**這一段就是「看得出領走的不在清單上」**。"""
+    claims = state.get("claims") or {}
+    if not claims:
+        return
+    open_refs = {ref_of(it) for it in items}
+    done = [r for r in claims if r not in open_refs]
+    doing = [r for r in claims if r in open_refs]
+    print(f"\n📦 之前領走的 {len(claims)} 張：已關 {len(done)}、還開著 {len(doing)}")
+    for r in sorted(doing):
+        c = claims[r]
+        print(f"     ◻ {r}　（{c.get('at', '?')[:10]} 領的）{c.get('title', '')[:40]}")
+    for r in sorted(done):
+        print(f"     ✅ {r}　已關")
+    if doing:
+        print("     🔴 還開著的沒有回到可領清單裡——做完就關票，或 "
+              "`debt-worklist forget <票>` 把它放回去。")
+
+
+def print_bundle(i, b, verbose):
+    lead = b["lead"]
+    kind = "PR" if lead["pr"] else "票"
+    print(f"\n  {i}. [{lead['score']}] {lead['ref']}（{kind}）")
+    print(f"     {lead['title'][:72]}")
+    print("     為什麼排這裡：" + "、".join(f"{n}{v:+g}" for n, v in lead["why"]))
+    if lead["labels"]:
+        print(f"     標籤：{lead['labels']}")
+    others = b["members"][1:]
+    if others:
+        print(f"     ↳ 同一包（互相指著／原生相依，要一起領）共 {len(b['members'])} 張：")
+        shown = others if verbose else others[:BUNDLE_CAP]
+        for m in shown:
+            print(f"        · [{m['score']}] {m['ref']}　{m['title'][:56]}")
+        if len(others) > len(shown):
+            print(f"        · …另外 {len(others) - len(shown)} 張（`--all` 看全部）")
+
+
+def cmd_list(argv):
+    top = int(argv[argv.index("--top") + 1]) if "--top" in argv else 6
+    verbose = "--all" in argv
+    as_json = "--json" in argv
+
+    repos, items = collect()
+    state = load_state()
+    pool, stats, _ = pick(items, set(state.get("claims") or {}))
+    edges = mutual_edges(pool) + dep_edges(pool, enabled="--no-deps" not in argv)
+    bundles = bundle(pool, edges)
+
+    if as_json:
+        print(json.dumps({
+            "at": now().isoformat(), "repos": repos, "stats": stats,
+            "claimed": sorted(state.get("claims") or {}),
+            "bundles": [{"score": b["score"],
+                         "members": [{"ref": m["ref"], "score": m["score"],
+                                      "title": m["title"], "why": m["why"]}
+                                     for m in b["members"]]} for b in bundles],
+        }, ensure_ascii=False, indent=1))
+    else:
+        print(f"🧾 還債清單　{now().strftime('%Y-%m-%d %H:%M UTC')}\n")
+        print_proof(repos, stats)
+        print_carry(state, items)
+        print(f"\n── 今天可以領的：{len(pool)} 張，收斂成 {len(bundles)} 包 "
+              f"────────────────────")
+        if not pool:
+            # 🔴 空清單要說話。默默結束＝人分不出「查過沒東西」跟「根本沒查」。
+            print("\n  ✅ **查詢跑過了，結果是零。**"
+                  f"\n     {len(repos)} 個 repo 都掃過（見上面那份清單），"
+                  "沒有一張是「沒掛 milestone、沒等 leo、還沒被領走」的。"
+                  "\n     這代表舊債清乾淨了——不是查詢壞掉。")
+        for i, b in enumerate(bundles[:len(bundles) if verbose else top], 1):
+            print_bundle(i, b, verbose)
+        if not verbose and len(bundles) > top:
+            print(f"\n  …另外 {len(bundles) - top} 包（`--top N` 或 `--all` 看更多）")
+        if pool:
+            first = " ".join(m["ref"] for m in bundles[0]["members"][:BUNDLE_CAP])
+            print(f"""
+── 領走它 ──────────────────────────────────────────────────
+    debt-worklist claim {first}
+
+  領走 ＝ 今天要做它。領了之後它就不會再出現在這份清單上，
+  直到你把票關掉、或 `debt-worklist forget` 把它放回去。
+  🔴 **整包一起領**：同一包是互相指著的，拆開做會做到一半發現卡在另一張。""")
+
+    state["last_run"] = now().isoformat()
+    save_state(state)
+    return 0
+
+
+def _titles(items):
+    return {ref_of(it): (it.get("title") or "") for it in items}
+
+
+def cmd_claim(argv):
+    refs = [a for a in argv if not a.startswith("-")]
+    if not refs:
+        die("用法：debt-worklist claim <owner/repo#N> [更多…]")
+    for r in refs:
+        if not re.match(r"^[\w.-]+/[\w.-]+#\d+$", r):
+            die(f"🔴 票的寫法是 owner/repo#N，你給的是：{r}")
+    _, items = collect()
+    titles = _titles(items)
+    unknown = [r for r in refs if r not in titles]
+    if unknown:
+        die("🔴 這幾張不在 open 清單裡（打錯了？已經關了？）：" + "、".join(unknown))
+    state = load_state()
+    for r in refs:
+        state["claims"][r] = {"at": now().isoformat(), "title": titles[r]}
+    save_state(state)
+    print(f"📦 領走 {len(refs)} 張，明天的清單不會再出現它們：")
+    for r in refs:
+        print(f"   · {r}　{titles[r][:60]}")
+    print("\n🔴 領了就是今天要做它。做完關票；改方向就 `debt-worklist forget`。")
+    return 0
+
+
+def cmd_forget(argv):
+    refs = [a for a in argv if not a.startswith("-")]
+    if not refs:
+        die("用法：debt-worklist forget <owner/repo#N> [更多…]")
+    state = load_state()
+    gone = [r for r in refs if state["claims"].pop(r, None) is not None]
+    save_state(state)
+    print(f"↩️ 放回清單 {len(gone)} 張：" + ("、".join(gone) or "（本來就沒領過）"))
+    return 0
+
+
+CMDS = {"list": cmd_list, "claim": cmd_claim, "forget": cmd_forget}
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        sys.exit(cmd_list([]))
+    if sys.argv[1] in ("-h", "--help", "help"):
+        print(__doc__)
+        sys.exit(0)
+    if sys.argv[1] not in CMDS:
+        print(__doc__)
+        sys.exit(2)
+    sys.exit(CMDS[sys.argv[1]](sys.argv[2:]))

scripts/gate-ok

@@ -0,0 +1,113 @@
+#!/usr/bin/env bash
+# gate-ok — 各道閘「總管看過了，放行下一個動作」的**單一入口**（inkstone/ISEP#90 ④）
+#
+# ══ 為什麼要有這支 ═════════════════════════════════════════════════════
+#
+# 這些閘每一支都留了一道給總管的門，而每一道門長得都不一樣：
+#     touch /tmp/.prod-write-ok
+#     git rev-parse --show-toplevel > /tmp/.main-push-ok
+#     touch /tmp/.stage-verified
+#     touch /tmp/.solo-ok-<session_id>
+#     …
+# 兩個後果：
+#   ① **記不住**。門的形狀藏在被擋下的那則訊息裡，每支都不同，
+#      而且有兩支還帶參數（綁 repo、綁 session）——照著抄錯一個字，門就打不開。
+#   ② **放行不了**。逃生口是「一條臨時湊出來的 Bash 指令」，
+#      而臨時湊出來的指令**沒有穩定的形狀可以事先放行**：
+#      `.claude/settings.json` 的 allow 只能逐條寫死
+#      （現場真的就寫著 `Bash(touch /tmp/.prod-write-ok)` 這種完全比對的一行），
+#      多一個 `&&`、換一個檔名、加一個 session id，就落在那條規則之外。
+#      2026-08-28（inkstone/InkStoneCo#99）總管在雲端連續四次沒能把
+#      prod-write 的戳記蓋出去 ⇒ **閘留了一道給總管的門，而那道門打不開**
+#      ⇒ 任何「擋下來、但總管可以放行」的閘，在那個環境裡等於「純擋」。
+#
+# ⇒ 這支把所有逃生口收斂成**一個名字、一種形狀**：
+#       bash "$CLAUDE_PLUGIN_ROOT/scripts/gate-ok" <閘名> [參數]
+#   一條前綴規則就涵蓋全部，而且以後新增閘不必再動一次設定。
+#
+# 🔴 這支**不會弱化任何一道閘**：它蓋的戳記跟閘原本認的是同一個檔、同一種語意
+#   （單次用完即丟、綁 repo、綁 session、有效期都不變）。它換掉的只有「怎麼蓋」。
+# 🔴 也**不是給 subagent 用的**：閘擋的是無心不是惡意（見 main-and-prod-push-guard
+#   第 76 行）。subagent 照樣造得出戳記，但它得刻意繞過一段明講「不要這樣做」的訊息。
+set -eu
+
+usage() {
+  cat <<'USAGE'
+用法：gate-ok <閘名> [參數]
+
+  prod-write                改到線上實例（prod-write-guard）——放行下一個動作，用完即消失
+  main-push [repo 路徑]     推 gitea main（main-and-prod-push-guard）——綁 repo，預設是 cwd
+  stage-verified            stage 真的驗過了（stage-before-prod-guard）——記得在回覆貼實測輸出
+  solo <session_id>         這件事真的該自己做（subagent-first-guard）——回覆裡要寫理由
+  dispatch <session_id>     派工單真的有例外（dispatch-format-guard）
+  ask <session_id>          這題真的是人閘（ask-user-question-guard）
+  kbdb-down                 KBDB 真的連不上（history-first-guard）——回覆裡要說明
+
+  --list                    列出目前存在的戳記
+
+🔴 每一枚戳記都是**留痕**：它會出現在指令歷史上，而且多數是單次用完即丟。
+   蓋之前先確定你真的看過那個動作會改到什麼；蓋完在回覆裡寫一句為什麼。
+USAGE
+}
+
+stamp() {  # stamp <檔> <說明> [內容]
+  if [ $# -ge 3 ]; then printf '%s\n' "$3" > "$1"; else : >> "$1"; touch "$1"; fi
+  printf '✅ 已蓋戳記：%s\n   %s\n' "$1" "$2"
+}
+
+[ $# -ge 1 ] || { usage; exit 2; }
+
+case "$1" in
+  -h|--help|help) usage; exit 0 ;;
+  --list)
+    printf '目前存在的戳記：\n'
+    ls -la /tmp/.prod-write-ok /tmp/.main-push-ok /tmp/.stage-verified \
+           /tmp/.kbdb-down /tmp/.solo-ok-* /tmp/.dispatch-ok-* /tmp/.ask-ok-* 2>/dev/null \
+      || printf '（一枚都沒有）\n'
+    exit 0 ;;
+esac
+
+GATE="$1"; shift || true
+
+case "$GATE" in
+  prod-write)
+    stamp /tmp/.prod-write-ok "只放行**下一個**會改到線上那台的動作，用完即消失（15 分鐘失效）" ;;
+
+  main-push)
+    # 綁 repo：戳記內容要是那個 repo 的 toplevel，閘會拿它跟「push 的目標 repo」比對。
+    # 🔴 解不出 repo 時**寧可失敗也不蓋空的**——閘明文寫著空內容不算數
+    #    （08-12 那次穿透就是空檔案變成萬用鑰匙），蓋一個註定打不開的戳記
+    #    只會讓人以為門開了。
+    D="${1:-$(pwd)}"
+    TOP="$(git -C "$D" rev-parse --show-toplevel 2>/dev/null || true)"
+    if [ -z "$TOP" ]; then
+      printf '❌ %s 不在任何 git repo 裡，解不出要放行哪個 repo。\n' "$D" >&2
+      printf '   用法：gate-ok main-push <那個 repo 的路徑>\n' >&2
+      exit 2
+    fi
+    stamp /tmp/.main-push-ok "只放行推 $TOP 的 main，單次、15 分鐘失效" "$TOP" ;;
+
+  stage-verified)
+    stamp /tmp/.stage-verified "stage 驗過了（6 小時）——**記得在回覆裡貼 stage 的實測輸出**" ;;
+
+  kbdb-down)
+    stamp /tmp/.kbdb-down "KBDB 連不上而放行——**回覆裡要說明**，這是留痕不是豁免" ;;
+
+  solo|dispatch|ask)
+    SID="${1:-${CLAUDE_SESSION_ID:-}}"
+    if [ -z "$SID" ]; then
+      printf '❌ %s 要綁 session id（閘用它認「是不是同一個 session」）。\n' "$GATE" >&2
+      printf '   被擋下的那則訊息裡就有；或 gate-ok %s <session_id>\n' "$GATE" >&2
+      exit 2
+    fi
+    case "$GATE" in
+      solo)     stamp "/tmp/.solo-ok-$SID"     "這件事自己做——**回覆裡要寫理由**" ;;
+      dispatch) stamp "/tmp/.dispatch-ok-$SID" "這張派工單的例外，放行一次" ;;
+      ask)      stamp "/tmp/.ask-ok-$SID"      "這題確認是人閘，放行一次" ;;
+    esac ;;
+
+  *)
+    printf '❌ 不認得的閘名：%s\n\n' "$GATE" >&2
+    usage >&2
+    exit 2 ;;
+esac

scripts/mainline

@@ -0,0 +1,332 @@
+#!/usr/bin/env python3
+"""mainline — 「現在的主線是哪一個」這個問題的**唯一指令**（inkstone/ISEP#82）。
+
+leo 2026-08-27：「**14 個里程碑同時亮著卻不知道該看哪個**」。
+當天實查 `GET /repos/inkstone/*/milestones?state=open` 回 14 個，其中「Mira 現代化」
+這個名字同時活在 5 個 repo，另有 5 個已經逾期。
+⇒ SOP 說的「**那個** active milestone」在現場根本沒有指涉對象——
+  要注入不知道注哪一個，要擋跳線也不知道拿哪一個當基準。
+
+這支不解「milestone 太多」（跨 repo 同名是既有做法，不動它），
+它解的是「**這一刻我在做哪一條**」沒有答案：
+
+    mainline                      現在的主線是哪一個（＝ show，唯一答案，離線）
+    mainline list                 有哪些 open milestone 可以選（打網路）
+    mainline set <owner/repo#id>  把某一個 milestone 標成主線（打網路，寫進 state）
+    mainline clear                現在沒有主線（例：一條線收掉了，下一條還沒開始）
+    mainline refresh [--members]  更新進度／期限（SessionStart 跑一次，不輪詢）
+    mainline adopt <owner/repo#N> 「補收」：把一張票掛進主線（打網路）
+    mainline has <owner/repo#N>   這張票在不在主線上（exit 0 ＝在，1 ＝不在）
+
+🔴 **`<owner/repo#id>` 的 id 是 milestone 的 id，不是 issue 的號碼。**
+   兩者在 Gitea 是兩套獨立編號，`mainline list` 印出來的就是可以直接貼的那一個。
+
+── 答案為什麼唯一 ─────────────────────────────────────────────────
+主線住在一個檔裡（`~/.claude/isep-countdown/mainline.json`），那個檔**放得下一條**。
+沒有清單、沒有優先序、沒有「前三名」——`set` 覆蓋掉的那條就不再是主線。
+⇒ 問一次只會拿到 0 或 1 個答案，不會拿到 14 個。
+
+── 主線是一個名字，錨在一個具體的 milestone 上 ────────────────────
+Gitea 的 milestone 不能跨 repo，而同一條線常常同時開在 5 個 repo。所以
+**錨**（期限／進度／目標宣告都讀它）是 `owner/repo#id`，
+**成員判定**看的是「票所屬 milestone 的標題與主線標題相同」（不分 repo）。
+兩件事都成立：同名跨 repo 照舊能用，而「現在在做哪一條」仍然只有一個答案。
+"""
+import importlib.machinery
+import importlib.util
+import os
+import sys
+import urllib.parse
+from datetime import datetime, timezone
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+
+
+def _load(name, path):
+    """把一個檔載進來當模組。`scripts/ticket` 沒有 `.py` 副檔名，所以要明著給 loader
+    （`spec_from_file_location` 只靠副檔名認不出它，會回 None）。"""
+    loader = importlib.machinery.SourceFileLoader(name, path)
+    spec = importlib.util.spec_from_file_location(name, path, loader=loader)
+    mod = importlib.util.module_from_spec(spec)
+    loader.exec_module(mod)
+    return mod
+
+
+# 憑證怎麼拿、API 怎麼打、票號怎麼解析——**全部沿用 `scripts/ticket` 那一份**。
+# 🔴 刻意不自己再寫一份 token()：金鑰的取得只准有一條路（頂層 CLAUDE.md 金鑰鐵律
+#   ＋ 2026-07-29 t145 的實害——同一把金鑰兩種寫法並存，必然漂移）。
+ML = _load("isep_mainline", os.path.join(HERE, "..", "hooks", "lib", "mainline.py"))
+try:
+    T = _load("isep_ticket", os.path.join(HERE, "ticket"))
+except Exception:
+    # 🔴 載不到就只是「打不了網路的那幾個動作不能用」，不是整支壞掉。
+    #   ISEP#82 驗收第 4 條要的是「沒有主線也不能整組壞掉」，同一個道理：
+    #   `show` 是離線的，它不該因為別的零件壞了而回答不出來。
+    T = None
+
+
+def die(msg, code=2):
+    print(msg, file=sys.stderr)
+    sys.exit(code)
+
+
+def need_net():
+    if T is None:
+        die("🔴 載不到 `scripts/ticket`（憑證與 API 都沿用它），這個動作打不了網路。\n"
+            "   `scripts/mainline show` 仍然可以用——它是離線的。")
+
+
+def parse_ms_ref(s):
+    """`owner/repo#<milestone id>`。與票號同形，所以錯手貼票號會拿到 404，訊息要講清楚。"""
+    import re
+    m = re.match(r"^([\w.-]+)/([\w.-]+)#(\d+)$", (s or "").strip())
+    if not m:
+        die("🔴 寫法是 owner/repo#<milestone id>，你給的是：%s\n"
+            "（先跑 `scripts/mainline list` 看有哪些，那裡印的就是可以直接貼的）" % s)
+    return m.group(1), m.group(2), int(m.group(3))
+
+
+def org_repos(owner):
+    rows = T.api_soft("/orgs/%s/repos?limit=100" % owner) or []
+    return [r["name"] for r in rows if isinstance(r, dict) and r.get("name")]
+
+
+def issues_in_milestone(owner, repo, title):
+    q = urllib.parse.urlencode({"state": "all", "type": "issues",
+                                "milestones": title, "limit": 100})
+    rows = T.api_soft("/repos/%s/%s/issues?%s" % (owner, repo, q)) or []
+    out = []
+    for it in rows:
+        if not isinstance(it, dict) or it.get("pull_request"):
+            continue
+        ms = it.get("milestone") or {}
+        # 🔴 再比對一次標題：`milestones=` 這個參數在不同 Gitea 版本上對「名稱 vs id」
+        #   的解讀不完全一致，拿回來的東西要自己確認過才算數（不要相信查詢字串）。
+        if ML.norm(ms.get("title")) != ML.norm(title):
+            continue
+        out.append("%s/%s#%d" % (owner, repo, it["number"]))
+    return out
+
+
+def collect_members(owner, title, anchor_repo):
+    """跨 repo 收齊「掛在同名 milestone 底下」的票。"""
+    refs, scanned = [], []
+    repos = org_repos(owner)
+    if anchor_repo not in repos:
+        repos.append(anchor_repo)
+    for r in repos:
+        got = issues_in_milestone(owner, r, title)
+        if got:
+            scanned.append((r, len(got)))
+            refs.extend(got)
+    return sorted(set(refs)), scanned
+
+
+def fetch_milestone(owner, repo, mid):
+    d = T.api_soft("/repos/%s/%s/milestones/%d" % (owner, repo, mid))
+    if not isinstance(d, dict) or not d.get("title"):
+        die("🔴 讀不到 %s/%s#%d 這個 milestone。\n"
+            "  · id 是 milestone 的 id，不是 issue 的號碼（`scripts/mainline list` 會印對的）\n"
+            "  · 或是這台機器現在拿不到 Gitea（那就先別標，不要標一個猜的）" % (owner, repo, mid))
+    return d
+
+
+# ── show ─────────────────────────────────────────────────────────────────
+def cmd_show(argv):
+    """離線。**永遠回一個答案**，包括「現在沒有主線」（ISEP#82 驗收第 4 條）。"""
+    ms = ML.load()
+    if not ms:
+        print("🎯 現在沒有主線。")
+        print()
+        print("  這不是故障——沒有人標過，或上一條收掉了。")
+        print("  要標一條：`scripts/mainline list` 看有哪些 → `scripts/mainline set <owner/repo#id>`")
+        print()
+        print("📌 在標之前，每回合的 🎯 那一行也會照樣講「現在沒有主線」，不會編一條出來。")
+        return
+    c, total, pct = ML.progress(ms)
+    print("🎯 現在的主線：%s「%s」" % (ML.ref_of(ms), ms.get("title")))
+    desc = (ms.get("description") or "").strip()
+    if desc:
+        first = desc.splitlines()[0].strip()
+        # 只印第一行、最多 150 字：這是**一眼掃**的答案，不是 milestone 的全文。
+        # leo 一天看兩眼（白話鐵律），整段貼過來他就不會看。
+        print("   目標：" + (first[:150] + "…" if len(first) > 150 else first))
+    print("   期限：%s" % ML.due_phrase(ms))
+    print("   進度：%d／%d 張已關（%d%%）" % (c, total, pct))
+    mem = sorted(ML.members(ms))
+    byrepo = {}
+    for r in mem:
+        byrepo[r.split("#")[0]] = byrepo.get(r.split("#")[0], 0) + 1
+    print("   屬於主線的票：%d 張%s" % (
+        len(mem), ("（" + "、".join("%s %d" % (k, v) for k, v in sorted(byrepo.items())) + "）") if byrepo else ""))
+    if ms.get("set_at"):
+        print("   標定於：%s" % ms["set_at"])
+    if ms.get("refreshed_at"):
+        print("   最後更新：%s" % ms["refreshed_at"])
+    print()
+    print("📌 這是唯一答案——主線住在一個檔裡，那個檔放得下一條：%s" % ML.path())
+
+
+# ── list ─────────────────────────────────────────────────────────────────
+def cmd_list(argv):
+    need_net()
+    owner = argv[0] if argv else T.ORG
+    rows = []
+    for r in org_repos(owner):
+        for m in (T.api_soft("/repos/%s/%s/milestones?state=open" % (owner, r)) or []):
+            if not isinstance(m, dict):
+                continue
+            rows.append((owner, r, m))
+    if not rows:
+        die("🔴 一個 open milestone 都沒讀到——多半是拿不到 Gitea，不是真的沒有。\n"
+            "（讀不到 ≠ 不存在。先修連線，不要因此標一個猜的主線。）", 1)
+    now = datetime.now(timezone.utc)
+    cur = ML.load()
+    print("open milestone 共 %d 個（%s）：\n" % (len(rows), owner))
+    for o, r, m in sorted(rows, key=lambda x: (ML.due_of(x[2]) or datetime.max.replace(tzinfo=timezone.utc))):
+        c, total, pct = ML.progress(m)
+        mark = "  ← 現在的主線" if cur and ML.ref_of(cur) == "%s/%s#%s" % (o, r, m.get("id")) else ""
+        print("  %-28s %-24s %3d%%  期限 %s%s" % (
+            "%s/%s#%s" % (o, r, m.get("id")), (m.get("title") or "")[:24],
+            pct, ML.due_phrase(m, now), mark))
+    print("\n📌 貼左邊那一欄：`scripts/mainline set <owner/repo#id>`")
+
+
+# ── set ──────────────────────────────────────────────────────────────────
+def cmd_set(argv):
+    need_net()
+    if not argv:
+        die("用法：mainline set <owner/repo#milestone_id>")
+    owner, repo, mid = parse_ms_ref(argv[0])
+    m = fetch_milestone(owner, repo, mid)
+    title = m.get("title")
+    refs, scanned = collect_members(owner, title, repo)
+    now = datetime.now(timezone.utc).astimezone().strftime("%Y-%m-%d %H:%M")
+    ok = ML.save({
+        "ref": "%s/%s#%d" % (owner, repo, mid),
+        "owner": owner, "repo": repo, "id": mid,
+        "title": title,
+        "description": m.get("description") or "",
+        "due_on": m.get("due_on") or "",
+        "open_issues": m.get("open_issues") or 0,
+        "closed_issues": m.get("closed_issues") or 0,
+        "members": refs,
+        "set_at": now, "refreshed_at": now,
+    })
+    if not ok:
+        die("🔴 寫不進 %s——主線沒有被標上。" % ML.path())
+    print("✅ 主線已標定：%s/%s#%d「%s」" % (owner, repo, mid, title))
+    if scanned:
+        print("   跨 repo 收到同名 milestone 的票 %d 張：%s"
+              % (len(refs), "、".join("%s %d" % (r, n) for r, n in scanned)))
+    print()
+    cmd_show([])
+
+
+def cmd_clear(argv):
+    had = ML.load()
+    ML.clear()
+    print("✅ 已清掉主線%s。現在沒有主線——每回合的 🎯 那一行會照實說。"
+          % ("（原本是 %s「%s」）" % (ML.ref_of(had), had.get("title")) if had else ""))
+
+
+# ── refresh ──────────────────────────────────────────────────────────────
+def cmd_refresh(argv):
+    """SessionStart 跑一次。**拿不到就原封不動**——寧可資料舊，不要把主線弄丟。"""
+    ms = ML.load()
+    if not ms:
+        return                      # 沒有主線就沒有東西要更新，安靜結束
+    d = T.api_soft("/repos/%s/%s/milestones/%s" % (ms["owner"], ms["repo"], ms["id"]))
+    if not isinstance(d, dict) or not d.get("title"):
+        return                      # 讀不到 ≠ 主線不存在
+    ms.update({
+        "title": d.get("title") or ms["title"],
+        "description": d.get("description") or ms.get("description") or "",
+        "due_on": d.get("due_on") or ms.get("due_on") or "",
+        "open_issues": d.get("open_issues") or 0,
+        "closed_issues": d.get("closed_issues") or 0,
+        "refreshed_at": datetime.now(timezone.utc).astimezone().strftime("%Y-%m-%d %H:%M"),
+    })
+    if "--members" in argv:
+        refs, _ = collect_members(ms["owner"], ms["title"], ms["repo"])
+        if refs:
+            ms["members"] = refs
+    ML.save(ms)
+
+
+# ── adopt（補收）──────────────────────────────────────────────────────────
+def cmd_adopt(argv):
+    need_net()
+    if not argv:
+        die("用法：mainline adopt <owner/repo#N>（把一張票掛進主線＝「補收」）")
+    ms = ML.load()
+    if not ms:
+        die("🔴 現在沒有主線，沒有東西可以補收進去。先 `scripts/mainline set …`。")
+    owner, repo, num = T.parse_ref(argv[0])
+    cands = [m for m in (T.api_soft("/repos/%s/%s/milestones?state=all" % (owner, repo)) or [])
+             if isinstance(m, dict) and ML.norm(m.get("title")) == ML.norm(ms["title"])]
+    if not cands:
+        die("""🔴 `%s/%s` 底下沒有叫「%s」的 milestone，所以這張票掛不進去。
+
+兩條路，**都要人決定，這支不會替你選**：
+  · 這件事真的屬於主線 ⇒ 在 `%s/%s` 開一個同名 milestone（記得設真的期限，
+    `milestone-due-guard.sh` 會擋沒期限的），再跑一次 adopt
+  · 這件事其實是另一條線 ⇒ 那就是**跳線**，不是補收。直接重送派工
+    （本閘同一張票只擋一次），並在回覆說清楚為什麼現在要岔開主線。""" % (
+            owner, repo, ms["title"], owner, repo))
+    mid = cands[0]["id"]
+    T.api("/repos/%s/%s/issues/%d" % (owner, repo, num), {"milestone": mid}, method="PATCH")
+    ref = "%s/%s#%d" % (owner, repo, num)
+    ms["members"] = sorted(set(ms.get("members") or []) | {ref})
+    ML.save(ms)
+    print("✅ 補收：%s 已掛進「%s」（%s/%s#%d）" % (ref, ms["title"], owner, repo, mid))
+
+
+# ── has ──────────────────────────────────────────────────────────────────
+def cmd_has(argv):
+    if not argv:
+        die("用法：mainline has <owner/repo#N>")
+    ms = ML.load()
+    ref = argv[0].strip()
+    if not ms:
+        print("🎯 現在沒有主線 ⇒ 沒有「不屬於主線」這回事。")
+        return
+    v = ML.belongs(ref, ms)
+    if v is None:
+        owner, repo, num = T.parse_ref(ref)
+        it = T.api_soft("/repos/%s/%s/issues/%d" % (owner, repo, num))
+        title = ((it or {}).get("milestone") or {}).get("title") if isinstance(it, dict) else None
+        v = ML.belongs(ref, ms, ticket_milestone_title=title or "")
+        if not isinstance(it, dict):
+            print("⚪ 讀不到 %s，判不出來（讀不到 ≠ 不屬於）。" % ref)
+            sys.exit(0)
+    if v:
+        print("✅ %s 在主線「%s」上。" % (ref, ms["title"]))
+        sys.exit(0)
+    print("🚧 %s **不在**主線「%s」上。\n"
+          "   補收 ⇒ `scripts/mainline adopt %s`；真的是插件事 ⇒ 那是跳線，說清楚再做。"
+          % (ref, ms["title"], ref))
+    sys.exit(1)
+
+
+CMDS = {"show": cmd_show, "list": cmd_list, "set": cmd_set, "clear": cmd_clear,
+        "refresh": cmd_refresh, "adopt": cmd_adopt, "has": cmd_has}
+
+if __name__ == "__main__":
+    # `mainline | head` 是很自然的用法，別讓它吐一段 BrokenPipe 的 traceback
+    # ——那會讓人以為這支壞了。
+    try:
+        import signal
+        signal.signal(signal.SIGPIPE, signal.SIG_DFL)
+    except Exception:
+        pass
+    if len(sys.argv) < 2:
+        cmd_show([])
+        sys.exit(0)
+    if sys.argv[1] in ("-h", "--help", "help"):
+        print(__doc__)
+        sys.exit(0)
+    if sys.argv[1] not in CMDS:
+        print(__doc__)
+        sys.exit(2)
+    CMDS[sys.argv[1]](sys.argv[2:])

scripts/milestone-account

@@ -0,0 +1,634 @@
+#!/usr/bin/env python3
+"""milestone-account — 每次結案都留下「估多久／花多久／差多少／為什麼」（inkstone/ISEP#85）。
+
+leo 的問題（票上原文）：「leo 2026-08-27 說今天『**拖時間**』。但拖了多久、
+比預計多拖多少、為什麼拖——**沒有任何數字**⋯⋯每次事後只能用『這次比較慢』
+這種話帶過，下次還是一樣。」
+
+    milestone-account codes                          七個代號是哪七個（封閉集合）
+    milestone-account list --org inkstone [--overdue] 現在每個里程碑的三個數字
+    milestone-account audit  inkstone/ISEP#12         從 Gitea 時間軸算證據
+    milestone-account close  inkstone/ISEP#12 --reason idle [--dry-run]
+    milestone-account report                          累計：哪一種原因最常發生
+    milestone-account ledger-path                     帳本檔在哪（給閘問的）
+
+🔴 這支工具的三條，全部長在機器上（不是寫在規範裡靠人記得）：
+
+  ① **三個數字自己算，不用手填**：期限與實際都取自 Gitea 的 `created_at`／
+     `due_on`／`closed_at`。手填的數字沒有人會去對，等於沒有。
+  ② **差超過 25%（超時或提早都算）就一定要挑一個代號**，挑不出來不准結案。
+     提早太多不是好消息，是**當初估太鬆**——所以兩個方向同一條線。
+  ③ **代號要有時間軸撐得住**：`audit` 先從 Gitea 的時間軸算出哪幾個訊號成立，
+     `close` 只接受**訊號成立的那幾個代號**；一個都沒成立時，唯一合法的代號
+     就是 `misestimate`（＝票上那句「以上都沒有，但還是差很多」）。
+     ⇒ **不採信我自己說的**，這是票上寫死的。
+
+🔴 代號是**封閉集合**，這一點是刻意的——票上原文：「**能統計的前提是分類有限**」。
+   真的歸不進去才提案加一個，而那要走 leo 核准（開票，不是自己加）。
+
+離線測試：`scripts/test-milestone-account.sh`（走 `MILESTONE_ACCOUNT_FIXTURE`，不打網路）。
+"""
+import json
+import os
+import re
+import subprocess
+import sys
+import time
+import urllib.error
+import urllib.parse
+import urllib.request
+
+HOST = os.environ.get("MILESTONE_ACCOUNT_HOST", "https://git.uncle6.me")
+HERE = os.path.dirname(os.path.abspath(__file__))
+ROOT = os.path.dirname(HERE)
+def _resolve_dir():
+    """帳本住哪裡。
+
+    🔴 **不能住在 plugin 目錄裡**：ISEP 是用 marketplace 裝的，
+       `claude plugin update` 會把那個目錄整個換掉 ⇒ 累積幾個月的帳一次歸零，
+       而這張票的全部價值就在「累積」。
+    順序：環境變數 → 這個 session 的專案根底下的 `system-dev/`（總管的跨專案知識庫，
+    帳本本來就屬於那一層）→ 這份原始碼所在 repo 的 `system-dev/` → `~/.claude/`。
+    """
+    v = os.environ.get("MILESTONE_ACCOUNT_DIR")
+    if v:
+        return v
+    for base in (os.environ.get("CLAUDE_PROJECT_DIR") or "", ROOT):
+        if base and os.path.isdir(os.path.join(base, "system-dev")):
+            return os.path.join(base, "system-dev", "estimates")
+    return os.path.join(os.path.expanduser("~"), ".claude", "isep-estimates")
+
+
+DIR = _resolve_dir()
+LEDGER = os.path.join(DIR, "ledger.jsonl")
+FIXTURE = os.environ.get("MILESTONE_ACCOUNT_FIXTURE", "")
+DRY = False
+THRESHOLD = 25.0     # 差超過幾 % 就一定要挑代號（票上寫死「四分之一」）
+
+# ── 封閉集合：七個代號，一個都不准多、不准少 ──────────────────────────────
+CODES = [
+    ("idle",         "磨洋工",   "小事拖成大事",       "時間軸上有長長的空白"),
+    ("sidetrack",    "分心跳線", "講到別的就跑去做",   "期間出現不屬於這條線的動作"),
+    ("undispatched", "忘了派工", "該派沒派，票停著",   "票很久沒有人被指派"),
+    ("cherry-pick",  "偏科",     "挑喜歡的做，難的擱著", "完成順序跟優先順序倒過來"),
+    ("waiting",      "等答案",   "問了就原地等，沒去做別的", "等待期間其他票零進度"),
+    ("scope-creep",  "範圍變大", "一直塞新東西進來",   "補收的次數、票數成長曲線"),
+    ("misestimate",  "純粹估錯", "過程沒異常，就是估錯", "以上都沒有，但還是差很多"),
+]
+CODE_IDS = [c[0] for c in CODES]
+LABEL = {c[0]: c[1] for c in CODES}
+
+
+def die(msg, code=2):
+    print(msg, file=sys.stderr)
+    sys.exit(code)
+
+
+def token():
+    root = os.environ.get("CLAUDE_PROJECT_DIR") or HERE
+    host = HOST.split("//")[-1].rstrip("/")
+    try:
+        out = subprocess.run(["git", "-C", root, "remote", "-v"],
+                             capture_output=True, text=True, timeout=20).stdout
+    except Exception:
+        out = ""
+    for line in out.splitlines():
+        if host in line:
+            m = re.search(r"//[^:/]+:([^@]+)@", line)
+            if m:
+                return m.group(1)
+    for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
+        if os.environ.get(env):
+            return os.environ[env]
+    return ""
+
+
+_FX = None
+
+
+def fx():
+    global _FX
+    if _FX is None:
+        try:
+            with open(FIXTURE) as f:
+                _FX = json.load(f)
+        except Exception:
+            die("🔴 讀不到 MILESTONE_ACCOUNT_FIXTURE：%s" % FIXTURE)
+    return _FX
+
+
+def api(path, payload=None, method=None):
+    verb = method or ("POST" if payload is not None else "GET")
+    if FIXTURE:
+        if verb == "GET":
+            return (fx().get("api") or {}).get(path)
+        print("  [fixture] %s %s %s" % (verb, path, json.dumps(payload or {})))
+        return {}
+    if DRY and verb != "GET":
+        print("  [dry-run] %s %s %s" % (verb, path, json.dumps(payload or {})))
+        return {}
+    tk = token()
+    if not tk:
+        die("🔴 拿不到 %s 的 token（remote 沒帶憑證，也沒有 GITEA_TOKEN_CLAUDE_CODE）" % HOST)
+    data = json.dumps(payload).encode() if payload is not None else None
+    req = urllib.request.Request(
+        HOST + "/api/v1" + path, data=data, method=verb,
+        headers={"Authorization": "token " + tk, "Content-Type": "application/json"})
+    try:
+        raw = urllib.request.urlopen(req, timeout=30).read()
+        return json.loads(raw) if raw.strip() else {}
+    except urllib.error.HTTPError as e:
+        if e.code == 404:
+            return None
+        die("🔴 Gitea %d on %s %s：%s" % (e.code, verb, path, e.read().decode()[:200]))
+    except Exception as e:
+        die("🔴 連不上 %s：%s" % (HOST, e))
+
+
+# ── 時間 ─────────────────────────────────────────────────────────────────
+_TS = re.compile(r"^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2}):(\d{2})"
+                 r"(?:\.\d+)?(Z|[+-]\d{2}:?\d{2})?$")
+
+
+def ts(s):
+    """Gitea 的時間字串 → epoch 秒。認得 Z 與 +08:00 兩種尾巴；認不得回 None。"""
+    if not s:
+        return None
+    m = _TS.match(str(s).strip())
+    if not m:
+        return None
+    y, mo, d, h, mi, se, off = m.groups()
+    t = time.mktime((int(y), int(mo), int(d), int(h), int(mi), int(se), 0, 1, 0)) \
+        - time.timezone
+    if off and off not in ("Z", "z"):
+        sign = 1 if off[0] == "+" else -1
+        off = off[1:].replace(":", "")
+        t -= sign * (int(off[:2]) * 3600 + int(off[2:]) * 60)
+    return t
+
+
+def now():
+    v = os.environ.get("MILESTONE_ACCOUNT_NOW")
+    return ts(v) if v else time.time()
+
+
+def days(sec):
+    return sec / 86400.0
+
+
+def parse_ref(s):
+    m = re.match(r"^([\w.-]+)/([\w.-]+)#(\d+)$", s.strip())
+    if not m:
+        die("🔴 寫法是 owner/repo#里程碑編號，你給的是：%s" % s)
+    return m.group(1), m.group(2), int(m.group(3))
+
+
+# ── 三個數字 ─────────────────────────────────────────────────────────────
+def numbers(ms):
+    """回 (planned_days, actual_days, deviation_pct)。算不出來的格子回 None。"""
+    c, due = ts(ms.get("created_at")), ts(ms.get("due_on"))
+    end = ts(ms.get("closed_at")) or now()
+    if c is None:
+        return None, None, None
+    actual = days(end - c)
+    if due is None or due <= c:
+        return None, actual, None
+    planned = days(due - c)
+    return planned, actual, (actual - planned) / planned * 100.0
+
+
+def fmt(v, unit=""):
+    return "—" if v is None else ("%.1f%s" % (v, unit))
+
+
+def three_lines(ms, planned, actual, dev):
+    return ("   當初訂的期限　%s天　（%s → %s）\n"
+            "   實際花掉的　　%s天　（到 %s）\n"
+            "   差了　　　　　%s"
+            % (fmt(planned), (ms.get("created_at") or "?")[:10],
+               (ms.get("due_on") or "沒填期限")[:10],
+               fmt(actual), (ms.get("closed_at") or "現在")[:10],
+               "算不出來（期限沒填，或期限不晚於建立日）" if dev is None
+               else "%+.0f%%%s" % (dev, "　🔴 超過 ±25%，要挑代號"
+                                   if abs(dev) > THRESHOLD else "")))
+
+
+# ── 從 Gitea 時間軸取證據 ────────────────────────────────────────────────
+def fetch_issues(owner, repo):
+    rows, page = [], 1
+    while page <= 5:
+        r = api("/repos/%s/%s/issues?state=all&type=issues&limit=50&page=%d"
+                % (owner, repo, page))
+        if not isinstance(r, list) or not r:
+            break
+        rows.extend(r)
+        if len(r) < 50:
+            break
+        page += 1
+    return rows
+
+
+def fetch_comments(owner, repo, since):
+    q = "?limit=100"
+    if since:
+        q += "&since=" + urllib.parse.quote(since)
+    r = api("/repos/%s/%s/issues/comments%s" % (owner, repo, q))
+    return r if isinstance(r, list) else []
+
+
+def prio(issue):
+    """優先度：p/high=3、p/med=2、p/low=1、沒標=0。"""
+    v = 0
+    for l in issue.get("labels") or []:
+        n = (l.get("name") or "").lower()
+        if n in ("p/high", "p/urgent", "p0", "p1"):
+            v = max(v, 3)
+        elif n in ("p/med", "p/medium", "p2"):
+            v = max(v, 2)
+        elif n in ("p/low", "p3"):
+            v = max(v, 1)
+    return v
+
+
+def evidence(owner, repo, ms):
+    """把 Gitea 時間軸算成七個訊號。回 (signals, detail)。
+
+    🔴 這裡**一句話都不讀**：全部只看時間戳、指派欄位、標籤、票的歸屬。
+       票上寫死「不採信我自己說的」，所以判準不能碰任何自然語言。
+    """
+    start = ts(ms.get("created_at"))
+    end = ts(ms.get("closed_at")) or now()
+    span = max(end - start, 1.0)
+    mid = ms.get("id")
+
+    issues = fetch_issues(owner, repo)
+    if issues is None:
+        issues = []
+    mine = [i for i in issues if (i.get("milestone") or {}).get("id") == mid]
+    others = [i for i in issues if (i.get("milestone") or {}).get("id") != mid]
+    comments = fetch_comments(owner, repo, ms.get("created_at"))
+
+    mine_ids = set(i.get("number") for i in mine)
+
+    def cnum(c):
+        u = c.get("issue_url") or c.get("html_url") or ""
+        m = re.search(r"/(?:issues|pulls)/(\d+)", u)
+        return int(m.group(1)) if m else c.get("issue_number")
+
+    ev_mine, ev_other = [], []
+    for i in mine:
+        for k in ("created_at", "closed_at"):
+            t = ts(i.get(k))
+            if t and start <= t <= end:
+                ev_mine.append(t)
+    for c in comments:
+        t = ts(c.get("created_at"))
+        if not t or not (start <= t <= end):
+            continue
+        (ev_mine if cnum(c) in mine_ids else ev_other).append(t)
+    for i in others:
+        t = ts(i.get("created_at"))
+        if t and start <= t <= end:
+            ev_other.append(t)
+
+    marks = sorted([start] + ev_mine + [end])
+    gap, gap_at = 0.0, None
+    for a, b in zip(marks, marks[1:]):
+        if b - a > gap:
+            gap, gap_at = b - a, a
+    sig, det = {}, {}
+
+    # ① 磨洋工：時間軸上有長長的空白
+    sig["idle"] = days(gap) >= 2.0 and gap / span >= 0.35
+    det["idle"] = ("最長空白 %.1f 天（佔整段 %.0f%%），起點 %s"
+                   % (days(gap), gap / span * 100,
+                      time.strftime("%Y-%m-%d", time.gmtime(gap_at)) if gap_at else "?"))
+
+    # ② 分心跳線：期間出現不屬於這條線的動作
+    tot = len(ev_mine) + len(ev_other)
+    ratio = (len(ev_other) / tot) if tot else 0.0
+    sig["sidetrack"] = len(ev_other) >= 5 and ratio >= 0.30
+    det["sidetrack"] = ("這段期間 %d 個動作在這條線上、%d 個在別的票上（%.0f%%）"
+                        % (len(ev_mine), len(ev_other), ratio * 100))
+
+    # ③ 忘了派工：票很久沒有人被指派
+    naked = [i for i in mine if not (i.get("assignees") or i.get("assignee"))
+             and days(end - (ts(i.get("created_at")) or end)) >= days(span) * 0.5]
+    sig["undispatched"] = len(naked) > 0
+    det["undispatched"] = ("%d 張票整段期間沒有人被指派：%s"
+                           % (len(naked), ", ".join("#%s" % i.get("number")
+                                                    for i in naked[:6])) if naked
+                           else "每一張票都有人被指派過")
+
+    # ④ 偏科：完成順序跟優先順序倒過來
+    inv = 0
+    closed = [i for i in mine if ts(i.get("closed_at"))]
+    openv = [i for i in mine if not ts(i.get("closed_at"))]
+    for a in closed:
+        for b in closed:
+            if prio(a) < prio(b) and ts(a["closed_at"]) < ts(b["closed_at"]):
+                inv += 1
+    for a in closed:
+        for b in openv:
+            if prio(a) < prio(b):
+                inv += 1
+    sig["cherry-pick"] = inv >= 2
+    det["cherry-pick"] = ("低優先先收掉、高優先還晾著的配對 %d 組" % inv)
+
+    # ⑤ 等答案：等待期間其他票零進度
+    waitset = [i for i in mine
+               if any((l.get("name") or "").lower() == "human"
+                      for l in (i.get("labels") or []))]
+    wait_days = 0.0
+    for i in waitset:
+        s = ts(i.get("created_at")) or start
+        e = ts(i.get("closed_at")) or end
+        wait_days = max(wait_days, days(e - s))
+    moved = sum(1 for i in mine
+                if ts(i.get("closed_at")) and i not in waitset)
+    sig["waiting"] = bool(waitset) and wait_days >= days(span) * 0.30 and moved == 0
+    det["waiting"] = ("掛 Human 的票 %d 張、最長等 %.1f 天；期間其他票關掉 %d 張"
+                      % (len(waitset), wait_days, moved))
+
+    # ⑥ 範圍變大：補收的次數、票數成長曲線
+    late = [i for i in mine
+            if (ts(i.get("created_at")) or start) > start + span * 0.25]
+    sig["scope-creep"] = len(late) >= 1 and len(mine) and len(late) / len(mine) >= 0.20
+    det["scope-creep"] = ("開跑之後才補進來的票 %d／%d 張：%s"
+                          % (len(late), len(mine),
+                             ", ".join("#%s" % i.get("number") for i in late[:6])))
+
+    # ⑦ 純粹估錯：以上都沒有
+    sig["misestimate"] = not any(sig[c] for c in CODE_IDS if c != "misestimate")
+    det["misestimate"] = ("上面六個訊號%s成立"
+                          % ("一個都沒有" if sig["misestimate"] else "有"))
+    return sig, det
+
+
+def get_milestone(owner, repo, num):
+    ms = api("/repos/%s/%s/milestones/%d" % (owner, repo, num))
+    if not isinstance(ms, dict) or not ms.get("id"):
+        die("🔴 抓不到里程碑 %s/%s#%d（編號對嗎？）" % (owner, repo, num))
+    return ms
+
+
+# ── 指令 ─────────────────────────────────────────────────────────────────
+def cmd_codes(argv):
+    print("七個代號（封閉集合，inkstone/ISEP#85）——「能統計的前提是分類有限」\n")
+    for cid, label, plain, how in CODES:
+        print("  %-13s %-8s %-22s 從哪看出來：%s" % (cid, label, plain, how))
+    print("\n真的歸不進去 ⇒ 開一張票請 leo 核准加一個，**不要自己加**。")
+
+
+def _repos(argv):
+    rs = [r for r in (argv[i + 1] for i, a in enumerate(argv)
+                      if a == "--repo" and i + 1 < len(argv))]
+    if rs:
+        return rs
+    org = None
+    for i, a in enumerate(argv):
+        if a == "--org" and i + 1 < len(argv):
+            org = argv[i + 1]
+    if not org:
+        die("用法：milestone-account list --org inkstone [--overdue]  或  --repo owner/repo")
+    rows = api("/orgs/%s/repos?limit=100" % org)
+    if not isinstance(rows, list):
+        die("🔴 撈不到 %s 底下的 repo" % org)
+    return [r["full_name"] for r in rows]
+
+
+def cmd_list(argv):
+    overdue = "--overdue" in argv
+    n = 0
+    for full in _repos(argv):
+        owner, repo = full.split("/", 1)
+        mss = api("/repos/%s/%s/milestones?state=open&limit=50" % (owner, repo))
+        if not isinstance(mss, list):
+            continue
+        for ms in mss:
+            planned, actual, dev = numbers(ms)
+            late = dev is not None and dev > 0
+            if overdue and not late:
+                continue
+            n += 1
+            print("%s %-34s %-30s 估 %s天／已 %s天／%s"
+                  % ("🔴" if (dev is not None and abs(dev) > THRESHOLD) else "  ",
+                     "%s#%s" % (full, ms.get("id")), (ms.get("title") or "")[:28],
+                     fmt(planned), fmt(actual),
+                     "—" if dev is None else "%+.0f%%" % dev))
+    print("\n共 %d 個%s里程碑。🔴 ＝ 差超過 ±25%%，結案時一定要挑一個代號。"
+          % (n, "逾期的 " if overdue else "open "))
+    print("挑代號之前先跑：milestone-account audit <owner/repo#編號>")
+
+
+def cmd_audit(argv):
+    if not argv:
+        die("用法：milestone-account audit <owner/repo#里程碑編號>")
+    owner, repo, num = parse_ref(argv[0])
+    ms = get_milestone(owner, repo, num)
+    planned, actual, dev = numbers(ms)
+    print("【%s/%s#%d】%s\n" % (owner, repo, num, ms.get("title") or ""))
+    print(three_lines(ms, planned, actual, dev))
+    sig, det = evidence(owner, repo, ms)
+    print("\n【時間軸怎麼說】（全部取自 Gitea 的時間戳／欄位，一句話都沒讀）")
+    for cid, label, _plain, _how in CODES:
+        print("  %s %-13s %-8s %s" % ("🔴" if sig[cid] else "  ", cid, label, det[cid]))
+    ok = [c for c in CODE_IDS if sig[c]]
+    print("\n可以挑的代號：%s" % " / ".join(ok))
+    print("結案：milestone-account close %s/%s#%d --reason %s" % (owner, repo, num, ok[0]))
+
+
+def _ledger():
+    rows = []
+    try:
+        with open(LEDGER) as f:
+            for line in f:
+                line = line.strip()
+                if line:
+                    try:
+                        rows.append(json.loads(line))
+                    except Exception:
+                        pass
+    except Exception:
+        pass
+    return rows
+
+
+def cmd_close(argv):
+    if not argv:
+        die("用法：milestone-account close <owner/repo#編號> [--reason 代號] [--dry-run]")
+    owner, repo, num = parse_ref(argv[0])
+    ref = "%s/%s#%d" % (owner, repo, num)
+    reason = None
+    for i, a in enumerate(argv):
+        if a == "--reason" and i + 1 < len(argv):
+            reason = argv[i + 1]
+
+    ms = get_milestone(owner, repo, num)
+    planned, actual, dev = numbers(ms)
+    print("【%s】%s\n" % (ref, ms.get("title") or ""))
+    print(three_lines(ms, planned, actual, dev))
+
+    sig, det = evidence(owner, repo, ms)
+    legal = [c for c in CODE_IDS if sig[c]]
+    need = dev is None or abs(dev) > THRESHOLD
+
+    if need and not reason:
+        die("\n🚫 **差 %s，超過 ±25%%——挑不出代號不准結案。**\n\n"
+            "【inkstone/ISEP#85】「差超過四分之一（不管是超時還是提早太多，\n"
+            "  **提早太多代表當初估太鬆**）就要挑一個原因，而且**只能從固定的幾個裡面挑**，\n"
+            "  不准用一段話帶過。」\n\n"
+            "時間軸撐得住的代號：%s\n"
+            "%s\n"
+            "  再送一次：milestone-account close %s --reason %s\n"
+            "  想看全部七個：milestone-account codes ／ 看證據：milestone-account audit %s"
+            % ("算不出來（期限沒填）" if dev is None else "%+.0f%%" % dev,
+               " / ".join(legal),
+               "\n".join("    %-13s %s" % (c, det[c]) for c in legal), ref, legal[0], ref))
+
+    if reason:
+        if reason not in CODE_IDS:
+            die("\n🚫 `%s` 不是那七個代號之一。\n"
+                "   【inkstone/ISEP#85】代號是**封閉集合**——「能統計的前提是分類有限」。\n"
+                "   七個：%s\n"
+                "   真的歸不進去 ⇒ 開票請 leo 核准加一個，不要自己造。"
+                % (reason, " / ".join(CODE_IDS)))
+        if reason not in legal:
+            die("\n🚫 `%s`（%s）**時間軸撐不住**——不接受。\n\n"
+                "   【inkstone/ISEP#85】「證據一律從 Gitea 的時間軸取"
+                "（留言、指派、標籤、commit 都有時間戳），**不採信我自己說的**。」\n\n"
+                "   這個代號的訊號：%s\n"
+                "   撐得住的是：%s\n"
+                "   （訊號真的判錯了 ⇒ 那是 audit 的 bug，去修偵測器，"
+                "不是在這裡繞過去——這條線的意義就是「可以統計、可以迭代」。）"
+                % (reason, LABEL[reason], det[reason], " / ".join(legal)))
+
+    rec = {"ref": ref, "title": ms.get("title") or "",
+           "created_at": ms.get("created_at"), "due_on": ms.get("due_on"),
+           "closed_at": ms.get("closed_at") or time.strftime(
+               "%Y-%m-%dT%H:%M:%SZ", time.gmtime(now())),
+           "planned_days": None if planned is None else round(planned, 2),
+           "actual_days": None if actual is None else round(actual, 2),
+           "deviation_pct": None if dev is None else round(dev, 1),
+           "over_threshold": bool(need),
+           "reason": reason, "reason_label": LABEL.get(reason or "", ""),
+           "signals": {c: bool(sig[c]) for c in CODE_IDS},
+           "evidence": {c: det[c] for c in CODE_IDS},
+           "recorded_at": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime(now()))}
+
+    if DRY:
+        print("\n[dry-run] 會寫進 %s：" % LEDGER)
+        print(json.dumps(rec, ensure_ascii=False, indent=2)[:900])
+        print("  [dry-run] PATCH /repos/%s/%s/milestones/%d {\"state\": \"closed\"}"
+              % (owner, repo, num))
+        print("[dry-run] 一筆都沒有真的寫出去。")
+        return
+
+    # 🔴 順序：**先記帳、再關**。反過來的話，關成功而記帳失敗，
+    #    那個里程碑就永遠不會出現在統計裡——而那正是這張票要解的病。
+    os.makedirs(DIR, exist_ok=True)
+    with open(LEDGER, "a") as f:
+        f.write(json.dumps(rec, ensure_ascii=False) + "\n")
+    print("\n✅ 已記帳：%s　估 %s天／花 %s天／%s%s"
+          % (ref, fmt(planned), fmt(actual),
+             "—" if dev is None else "%+.0f%%" % dev,
+             "　原因＝%s（%s）" % (reason, LABEL[reason]) if reason else ""))
+
+    if (ms.get("state") or "") != "closed":
+        api("/repos/%s/%s/milestones/%d" % (owner, repo, num),
+            {"state": "closed"}, method="PATCH")
+        print("✅ 里程碑已關閉")
+    else:
+        print("ℹ️ 里程碑本來就是 closed，只補記帳")
+    write_report()
+    print("📊 累計統計已更新：%s" % os.path.join(DIR, "REPORT.md"))
+
+
+def write_report():
+    rows = _ledger()
+    cnt = {}
+    for r in rows:
+        if r.get("reason"):
+            cnt[r["reason"]] = cnt.get(r["reason"], 0) + 1
+    devs = [r["deviation_pct"] for r in rows if r.get("deviation_pct") is not None]
+    lines = ["# 估多久／花多久／差多少——累計統計", "",
+             "> 這份檔案由 `scripts/milestone-account` 自動重寫，**不要手改**。",
+             "> 【inkstone/ISEP#85】「每次事後只能用『這次比較慢』這種話帶過，"
+             "下次還是一樣。」", "",
+             "- 累計結案 **%d** 個里程碑" % len(rows)]
+    if devs:
+        lines.append("\t- 平均偏差 **%+.0f%%**（正＝超時，負＝提早）"
+                     % (sum(devs) / len(devs)))
+        lines.append("\t- 超過 ±25%% 的有 **%d** 個"
+                     % sum(1 for d in devs if abs(d) > THRESHOLD))
+    lines.append("- 哪一種原因最常發生（這才是迭代的依據）")
+    if not cnt:
+        lines.append("\t- 目前還沒有任何被挑過的代號。")
+    for cid, n in sorted(cnt.items(), key=lambda kv: -kv[1]):
+        lines.append("\t- **%s（%s）** ×%d" % (LABEL.get(cid, cid), cid, n))
+    lines.append("- 逐筆")
+    for r in sorted(rows, key=lambda r: r.get("recorded_at") or "", reverse=True):
+        lines.append("\t- `%s` %s" % (r["ref"], r.get("title", "")))
+        lines.append("\t\t- 估 %s 天／花 %s 天／差 %s"
+                     % (r.get("planned_days"), r.get("actual_days"),
+                        "—" if r.get("deviation_pct") is None
+                        else "%+.0f%%" % r["deviation_pct"]))
+        if r.get("reason"):
+            lines.append("\t\t- 原因：**%s（%s）**" % (r.get("reason_label"), r["reason"]))
+            lines.append("\t\t- 時間軸證據：%s"
+                         % (r.get("evidence") or {}).get(r["reason"], "—"))
+    try:
+        os.makedirs(DIR, exist_ok=True)
+        with open(os.path.join(DIR, "REPORT.md"), "w") as f:
+            f.write("\n".join(lines) + "\n")
+    except Exception as e:
+        die("🔴 寫不進 %s：%s" % (DIR, e))
+
+
+def cmd_report(argv):
+    rows = _ledger()
+    if not rows:
+        print("（帳本還是空的：%s）" % LEDGER)
+        print("關掉第一個里程碑就會有第一筆：milestone-account close <owner/repo#編號>")
+        return
+    cnt = {}
+    for r in rows:
+        if r.get("reason"):
+            cnt[r["reason"]] = cnt.get(r["reason"], 0) + 1
+    devs = [r["deviation_pct"] for r in rows if r.get("deviation_pct") is not None]
+    print("累計結案 %d 個里程碑" % len(rows))
+    if devs:
+        print("平均偏差 %+.0f%%（正＝超時，負＝提早）；超過 ±25%% 的有 %d 個"
+              % (sum(devs) / len(devs), sum(1 for d in devs if abs(d) > THRESHOLD)))
+    print("\n哪一種原因最常發生：")
+    if not cnt:
+        print("  （還沒有任何被挑過的代號）")
+    for cid, n in sorted(cnt.items(), key=lambda kv: -kv[1]):
+        print("  %-13s %-8s ×%d  %s" % (cid, LABEL.get(cid, cid), n, "█" * n))
+    write_report()
+    print("\n人看的版本：%s" % os.path.join(DIR, "REPORT.md"))
+
+
+def main():
+    global DRY
+    argv = sys.argv[1:]
+    if "--dry-run" in argv:
+        DRY = True
+        argv = [a for a in argv if a != "--dry-run"]
+    if not argv:
+        print(__doc__)
+        return
+    cmd, rest = argv[0], argv[1:]
+    table = {"codes": cmd_codes, "list": cmd_list, "audit": cmd_audit,
+             "close": cmd_close, "report": cmd_report,
+             # 給 hooks/milestone-account-guard.sh 問「帳本在哪」用的。
+             # 讓「怎麼找到帳本」只有一份答案，閘不必自己再實作一次解析。
+             "ledger-path": lambda a: print(LEDGER)}
+    if cmd not in table:
+        print(__doc__)
+        die("🔴 沒有這個子指令：%s" % cmd)
+    table[cmd](rest)
+
+
+if __name__ == "__main__":
+    main()

scripts/pr-verdict

@@ -0,0 +1,257 @@
+#!/usr/bin/env python3
+"""pr-verdict — 給 PR 一個結論，一個動作把該做的全做完（inkstone/ISEP#81）。
+
+leo 的問題（票上原文）：「我交出去的 PR 沒有人去看它⋯⋯票看起來是『已交付』，
+但東西沒有進 main，也就沒有進版本，**leo 手上永遠不會出現它**。」
+
+「有結論」只有三種，缺一不可：
+
+    pr-verdict merge   <owner/repo#N>                      併 ＋ **當場刪掉那條 branch**
+    pr-verdict reject  <owner/repo#N> --ticket <票> -F <檔>  退回：理由寫**票上** ＋ 關 PR
+    pr-verdict changes <owner/repo#N> --ticket <票> -F <檔>  要求修改：寫**票上** ＋ REQUEST_CHANGES
+    pr-verdict list                                        撈一次：誰還沒有結論
+
+🔴 為什麼要有這支、而不是叫人記得多做一步：
+   「merge 完要刪 branch」「退回理由要寫在票上」都是**第二個動作**，
+   而所有掉棒的形狀都長一樣——第一個動作做了，第二個沒有。
+   把兩件事綁成一個指令，就沒有「忘了做第二件」這個狀態可以存在。
+
+🔴 `--dry-run` 會把要打的每一通 API 印出來但不送出。
+   加在任何子指令上都有效；**收工前想確認自己按下去會發生什麼，用它。**
+"""
+import json
+import os
+import re
+import subprocess
+import sys
+import urllib.error
+import urllib.parse
+import urllib.request
+
+HOST = os.environ.get("PR_VERDICT_HOST", "https://git.uncle6.me")
+DRY = False
+
+
+def die(msg, code=2):
+    print(msg, file=sys.stderr)
+    sys.exit(code)
+
+
+def token():
+    root = os.environ.get("CLAUDE_PROJECT_DIR") or os.getcwd()
+    host = HOST.split("//")[-1].rstrip("/")
+    try:
+        out = subprocess.run(["git", "-C", root, "remote", "-v"],
+                             capture_output=True, text=True, timeout=20).stdout
+    except Exception:
+        out = ""
+    for line in out.splitlines():
+        if host in line:
+            m = re.search(r"//[^:/]+:([^@]+)@", line)
+            if m:
+                return m.group(1)
+    for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
+        if os.environ.get(env):
+            return os.environ[env]
+    die(f"🔴 拿不到 {host} 的 token（remote 沒帶憑證，也沒有 GITEA_TOKEN_CLAUDE_CODE）")
+
+
+def api(path, payload=None, method=None, soft=False):
+    verb = method or ("POST" if payload is not None else "GET")
+    if DRY and verb != "GET":
+        print(f"  [dry-run] {verb} {path}"
+              + (f"\n            {json.dumps(payload, ensure_ascii=False)}" if payload else ""))
+        return {}
+    url = path if path.startswith("http") else f"{HOST}/api/v1{path}"
+    data = json.dumps(payload).encode() if payload is not None else None
+    req = urllib.request.Request(
+        url, data=data, method=verb,
+        headers={"Authorization": f"token {token()}", "Content-Type": "application/json"})
+    try:
+        raw = urllib.request.urlopen(req, timeout=40).read()
+        return json.loads(raw) if raw.strip() else {}
+    except urllib.error.HTTPError as e:
+        if soft:
+            return {"__status__": e.code}
+        die(f"🔴 Gitea {e.code} on {verb} {path}：{e.read().decode()[:300]}")
+
+
+def parse_ref(s):
+    m = re.match(r"^([\w.-]+)/([\w.-]+)#(\d+)$", s.strip())
+    if not m:
+        die(f"🔴 寫法是 owner/repo#N，你給的是：{s}")
+    return m.group(1), m.group(2), int(m.group(3))
+
+
+def read_body(argv, what):
+    if "-F" not in argv:
+        die(f"🚫 缺 -F <檔>：{what}要**寫在票上**，不是寫在訊息裡。\n"
+            f"   （inkstone/ISEP#81：「退回理由寫在票上（寫票，不是寫訊息）」）")
+    p = argv[argv.index("-F") + 1]
+    try:
+        with open(p) as f:
+            return f.read().strip()
+    except Exception as e:
+        die(f"🔴 讀不到 {p}：{e}")
+
+
+def opt(argv, name, default=None):
+    return argv[argv.index(name) + 1] if name in argv else default
+
+
+def say_on_ticket(ref, body):
+    """把結論貼進**票**（不是貼進 PR 的討論串——PR 會隨自己沉掉，票才是那條線的家）。
+
+    內文第一行帶【總管】身份欄，對齊 reply-identity-guard 的規約
+    （leo 2026-08-27：「subagent 回覆時要表明身份」）。
+    """
+    owner, repo, num = parse_ref(ref)
+    if DRY:
+        print(f"  [dry-run] POST /repos/{owner}/{repo}/issues/{num}/comments")
+        print(f"            {body[:120]}…")
+        return
+    api(f"/repos/{owner}/{repo}/issues/{num}/comments", {"body": body})
+
+
+# ── merge ────────────────────────────────────────────────────────────────
+def cmd_merge(argv):
+    if not argv:
+        die("用法：pr-verdict merge <owner/repo#N> [--style merge|squash|rebase] [--dry-run]")
+    owner, repo, num = parse_ref(argv[0])
+    style = opt(argv, "--style", "merge")
+
+    pr = api(f"/repos/{owner}/{repo}/pulls/{num}")
+    branch = ((pr.get("head") or {}).get("ref")) or ""
+    same_repo = ((pr.get("head") or {}).get("repo") or {}).get("full_name") == f"{owner}/{repo}"
+
+    if not pr.get("merged"):
+        if pr.get("state") != "open":
+            die(f"🔴 {owner}/{repo}#{num} 不是 open（state={pr.get('state')}）——沒得 merge。")
+        api(f"/repos/{owner}/{repo}/pulls/{num}/merge",
+            {"Do": style, "delete_branch_after_merge": True})
+        if not DRY:
+            print(f"✅ {owner}/{repo}#{num} 已 merge（{style}）")
+    else:
+        print(f"ℹ️ {owner}/{repo}#{num} 本來就是 merged，只補刪分支")
+
+    # 🔴 第二件事：**當場複驗分支真的不見了**。
+    #    Gitea 的 delete_branch_after_merge 在某些設定下不會生效（保護分支、
+    #    跨 fork），而「我下了刪除的指令」不等於「它被刪掉了」——
+    #    本 repo 心法：交出去之前，我知不知道它能不能用。
+    if not branch:
+        print("⚠️ 拿不到 head 分支名，無法複驗——請自己確認分支已刪。")
+        return
+    if not same_repo:
+        print(f"ℹ️ head 在別的 repo（fork），本指令不跨 repo 刪分支：{branch}")
+        return
+    if DRY:
+        print(f"  [dry-run] DELETE /repos/{owner}/{repo}/branches/{branch}（若還在）")
+        return
+    if _branch_alive(owner, repo, branch):
+        api(f"/repos/{owner}/{repo}/branches/{urllib.parse.quote(branch, safe='')}",
+            method="DELETE", soft=True)
+    if _branch_alive(owner, repo, branch):
+        die(f"🔴 分支 {branch} 刪不掉（保護分支？權限？）——**結論只給了一半**，"
+            f"pr-verdict-guard 會繼續點名它。")
+    print(f"✅ 分支 {branch} 已刪除（複驗過：查不到了）")
+
+
+def _branch_alive(owner, repo, br):
+    r = api(f"/repos/{owner}/{repo}/branches/{urllib.parse.quote(br, safe='')}", soft=True)
+    return isinstance(r, dict) and "name" in r
+
+
+# ── reject / changes ─────────────────────────────────────────────────────
+def _verdict_with_reason(argv, kind):
+    if not argv:
+        die(f"用法：pr-verdict {kind} <owner/repo#N> --ticket <owner/repo#N> -F <檔> [--dry-run]")
+    owner, repo, num = parse_ref(argv[0])
+    ticket = opt(argv, "--ticket")
+    if not ticket:
+        die("🚫 缺 --ticket <owner/repo#N>：結論要寫在**票**上。\n"
+            "   PR 的討論串會隨 PR 一起沉掉；票才是那條線的家。")
+    body = read_body(argv, "退回理由" if kind == "reject" else "修改要求")
+
+    pr = api(f"/repos/{owner}/{repo}/pulls/{num}")
+    head = f"{owner}/{repo}#{num}"
+    url = (pr.get("html_url") or "")
+    title = "退回" if kind == "reject" else "要求修改"
+    say_on_ticket(ticket, f"【總管】**PR {title}**：{head}　{url}\n\n{body}")
+    if not DRY:
+        print(f"✅ {title}理由已寫進票 {ticket}")
+
+    if kind == "reject":
+        api(f"/repos/{owner}/{repo}/issues/{num}", {"state": "closed"}, method="PATCH")
+        if not DRY:
+            print(f"✅ {head} 已關閉")
+        br = ((pr.get("head") or {}).get("ref")) or ""
+        same = ((pr.get("head") or {}).get("repo") or {}).get("full_name") == f"{owner}/{repo}"
+        if br and same and not DRY and _branch_alive(owner, repo, br):
+            api(f"/repos/{owner}/{repo}/branches/{urllib.parse.quote(br, safe='')}",
+                method="DELETE", soft=True)
+            print(f"✅ 分支 {br} 已刪除")
+    else:
+        # REQUEST_CHANGES：**讓「已經給過結論」變成 Gitea 查得到的事實**，
+        # 這樣 pr-verdict-guard 就不會再把它當成被遺忘的 PR（＝擋等待）。
+        api(f"/repos/{owner}/{repo}/pulls/{num}/reviews",
+            {"event": "REQUEST_CHANGES", "body": f"修改要求寫在 {ticket}"})
+        if not DRY:
+            print(f"✅ {head} 已留下 REQUEST_CHANGES review（閘看得到，不會再點名它）")
+    if DRY:
+        print("\n[dry-run] 以上一通都沒有送出。")
+        return
+    print("\n📌 兩件事是同一個動作——不會只寫了理由而 PR 還開著"
+          "（reject），也不會留了 review 而票上查不到理由（changes）。")
+
+
+# ── list ─────────────────────────────────────────────────────────────────
+def cmd_list(argv):
+    orgs = [o.strip().lower() for o in
+            os.environ.get("PR_VERDICT_ORGS", "inkstone").split(",") if o.strip()]
+    rows = api("/repos/issues/search?type=pulls&state=open&limit=50")
+    import time
+    now = time.time()
+    n = 0
+    for pr in rows:
+        full = (pr.get("repository") or {}).get("full_name") or ""
+        if "/" not in full or (orgs and full.split("/", 1)[0].lower() not in orgs):
+            continue
+        try:
+            t = time.mktime(time.strptime(pr["created_at"][:19], "%Y-%m-%dT%H:%M:%S"))
+            age = int((now - t) / 86400)
+        except Exception:
+            age = -1
+        who = [a["login"] for a in (pr.get("assignees") or [])]
+        mark = "🕒" if who else "❌"
+        print(f"{mark} {full}#{pr['number']:<5} 開了 {age:>3} 天  "
+              f"{'指派＝' + ','.join(who) if who else '沒有人被指派'}  {pr['title'][:34]}")
+        n += 1
+    print(f"\n共 {n} 個 open PR（org：{'/'.join(orgs) or '全部'}）。"
+          f"　❌＝沒有人在管，pr-verdict-guard 會點名它")
+
+
+def main():
+    global DRY
+    argv = sys.argv[1:]
+    if "--dry-run" in argv:
+        DRY = True
+        argv.remove("--dry-run")
+    if not argv:
+        print(__doc__)
+        sys.exit(0)
+    cmd, rest = argv[0], argv[1:]
+    if cmd == "merge":
+        cmd_merge(rest)
+    elif cmd == "reject":
+        _verdict_with_reason(rest, "reject")
+    elif cmd == "changes":
+        _verdict_with_reason(rest, "changes")
+    elif cmd == "list":
+        cmd_list(rest)
+    else:
+        print(__doc__)
+        die(f"🔴 沒有這個子指令：{cmd}")
+
+
+if __name__ == "__main__":
+    main()

scripts/release-manifest

@@ -0,0 +1,410 @@
+#!/usr/bin/env python3
+"""release-manifest — 一次交貨 ＝ 一份清單（inkstone/ISEP#84）。
+
+leo 的問題（票上原文）：「一次交貨常常同時動到好幾個 repo，但**沒有任何地方記著
+『這一版 ＝ 哪幾個 repo 的哪幾個版本』**⋯⋯要退版的時候，只退了其中一個 repo，
+剩下的還停在新版 ⇒ **變成一組從來沒測過的組合**。」
+
+    release-manifest freeze R-2026.08.30 --part inkstone/Arcrun@v1.4.52 \
+                                         --part inkstone/arcrun-collector@v0.18.36
+    release-manifest current                     我現在手上是哪一版、由什麼組成
+    release-manifest list                        全部清單，新的在上面
+    release-manifest show    R-2026.08.30
+    release-manifest verify  R-2026.08.30        清單上的版本號現在還抓得到嗎
+    release-manifest diff    R-2026.08.29 R-2026.08.30
+    release-manifest rollback R-2026.08.29       退版：**整份一起退**
+
+🔴 三條硬規則，全部長在這支工具裡（不是寫在文件裡靠人記得）：
+
+  ① **freeze 之前每一個版本號都真的去 Gitea 抓一次**。抓不到就不給凍結——
+     「寫上去」跟「存在」是兩件事，而清單的用處完全建立在後者。
+  ② **凍結了就不准再加東西**。同名清單已存在 ⇒ 拒絕覆寫，新的需求進下一份。
+  ③ **退版沒有「只退一個」這個選項**。`rollback` 一定吐出整份清單的每一格；
+     指名單一 repo（`--only`）會被擋下，因為那正是票上那個病：
+     **剩下的還停在新版 ⇒ 一組從來沒測過的組合。**
+
+📌 跟 `release-tag-guard.sh` 是包含關係不是重複：那支管「打 tag 那一刻，
+   單一 repo 內版本號三處一致」；這支管它上面那一層——**跨 repo 的組合**。
+
+📌 單一 repo 的交貨不必特例：清單就退化成只有一格，規則一字不改。
+
+離線測試：`scripts/test-release-manifest.sh`（走 `RELEASE_MANIFEST_FIXTURE`，不打網路）。
+"""
+import json
+import os
+import re
+import subprocess
+import sys
+import time
+import urllib.error
+import urllib.request
+
+HOST = os.environ.get("RELEASE_MANIFEST_HOST", "https://git.uncle6.me")
+HERE = os.path.dirname(os.path.abspath(__file__))
+def _resolve_dir():
+    """清單住哪裡。
+
+    🔴 **不能住在 plugin 目錄裡**：ISEP 是用 marketplace 裝的，
+       `claude plugin update` 會把那個目錄整個換掉 ⇒ 所有出貨清單一次消失，
+       而清單的用處全部發生在「以後要退版的那一天」。
+    順序：環境變數 → 這個 session 的專案根（有 `system-dev/` ＝總管的工作區，
+    跨 repo 的出貨清單本來就屬於那一層）→ 這份原始碼所在 repo → `~/.claude/`。
+    """
+    v = os.environ.get("RELEASE_MANIFEST_DIR")
+    if v:
+        return v
+    root = os.path.dirname(HERE)
+    for base in (os.environ.get("CLAUDE_PROJECT_DIR") or "", root):
+        if base and os.path.isdir(os.path.join(base, "system-dev")):
+            return os.path.join(base, "releases")
+    return os.path.join(os.path.expanduser("~"), ".claude", "isep-releases")
+
+
+DIR = _resolve_dir()
+FIXTURE = os.environ.get("RELEASE_MANIFEST_FIXTURE", "")
+DRY = False
+
+NAME_RE = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$")
+PART_RE = re.compile(r"^([\w.-]+)/([\w.-]+)@(\S+)$")
+
+
+def die(msg, code=2):
+    print(msg, file=sys.stderr)
+    sys.exit(code)
+
+
+def token():
+    root = os.environ.get("CLAUDE_PROJECT_DIR") or HERE
+    host = HOST.split("//")[-1].rstrip("/")
+    try:
+        out = subprocess.run(["git", "-C", root, "remote", "-v"],
+                             capture_output=True, text=True, timeout=20).stdout
+    except Exception:
+        out = ""
+    for line in out.splitlines():
+        if host in line:
+            m = re.search(r"//[^:/]+:([^@]+)@", line)
+            if m:
+                return m.group(1)
+    for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
+        if os.environ.get(env):
+            return os.environ[env]
+    return ""
+
+
+def _fixture():
+    try:
+        with open(FIXTURE) as f:
+            return json.load(f)
+    except Exception:
+        die("🔴 讀不到 RELEASE_MANIFEST_FIXTURE：%s" % FIXTURE)
+
+
+def api(path):
+    """GET 一筆。回 dict／list，查不到回 None。fixture 模式完全不碰網路。"""
+    if FIXTURE:
+        return None
+    tk = token()
+    if not tk:
+        die("🔴 拿不到 %s 的 token（remote 沒帶憑證，也沒有 GITEA_TOKEN_CLAUDE_CODE）" % HOST)
+    try:
+        req = urllib.request.Request(HOST + "/api/v1" + path,
+                                     headers={"Authorization": "token " + tk})
+        return json.load(urllib.request.urlopen(req, timeout=25))
+    except urllib.error.HTTPError:
+        return None
+    except Exception as e:
+        die("🔴 連不上 %s：%s" % (HOST, e))
+
+
+def resolve(owner, repo, ver):
+    """這個版本號**真的存在嗎**。存在回一段可以貼給人看的證據，不存在回 None。
+
+    先問 release，再問 tag：有些 repo 只打 tag 沒建 release，那也算存在
+    （票上要的是「抓得到那個 release」＝抓得到那個版本，不是逼每個 repo 都建 release 頁）。
+    """
+    if FIXTURE:
+        fx = _fixture().get("versions") or {}
+        return fx.get("%s/%s@%s" % (owner, repo, ver))
+    r = api("/repos/%s/%s/releases/tags/%s" % (owner, repo, ver))
+    if isinstance(r, dict) and r.get("tag_name"):
+        return {"kind": "release", "url": r.get("html_url") or "",
+                "commit": (r.get("target_commitish") or "")[:12]}
+    t = api("/repos/%s/%s/tags/%s" % (owner, repo, ver))
+    if isinstance(t, dict) and t.get("name"):
+        return {"kind": "tag", "url": (t.get("commit") or {}).get("url") or "",
+                "commit": ((t.get("commit") or {}).get("sha") or "")[:12]}
+    return None
+
+
+# ── 清單的存取 ────────────────────────────────────────────────────────────
+def path_of(name):
+    return os.path.join(DIR, name + ".json")
+
+
+def load(name):
+    try:
+        with open(path_of(name)) as f:
+            return json.load(f)
+    except Exception:
+        return None
+
+
+def all_manifests():
+    try:
+        names = [f[:-5] for f in os.listdir(DIR) if f.endswith(".json")]
+    except Exception:
+        return []
+    rows = [load(n) for n in names]
+    rows = [m for m in rows if m]
+    # 🔴 排序鍵不能只用時間戳：同一分鐘凍兩份清單就會並列，
+    #    而並列之後「現在手上的是哪一份」會變成 os.listdir 的順序（等於隨機）。
+    #    seq 是 freeze 當下遞增的流水號 ⇒ 先後永遠有唯一解。
+    rows.sort(key=lambda m: (m.get("seq", 0), m.get("frozen_at") or ""), reverse=True)
+    return rows
+
+
+def parse_part(s):
+    m = PART_RE.match(s.strip())
+    if not m:
+        die("🔴 寫法是 owner/repo@版本號，你給的是：%s" % s)
+    return m.group(1), m.group(2), m.group(3)
+
+
+def opts(argv, name):
+    return [argv[i + 1] for i, a in enumerate(argv) if a == name and i + 1 < len(argv)]
+
+
+def opt(argv, name, default=None):
+    v = opts(argv, name)
+    return v[0] if v else default
+
+
+# ── INDEX.md：leo 打開就看得懂「我現在手上是哪一版」 ──────────────────────
+def write_index():
+    rows = all_manifests()
+    lines = ["# 出貨清單（哪一版由哪幾個 repo 的哪幾版組成）", "",
+             "> 這份檔案由 `scripts/release-manifest` 自動重寫，**不要手改**"
+             "（手改的那一份會安靜地騙人）。", "",
+             "- 每一列 ＝ 一次交貨。**最上面那一份就是現在手上的這一版。**"]
+    if not rows:
+        lines.append("\t- 目前還沒有任何凍結過的清單。")
+    for i, m in enumerate(rows):
+        head = "**%s**%s" % (m["name"], "　← 現在手上的這一版" if i == 0 else "")
+        lines.append("\t- " + head)
+        lines.append("\t\t- 凍結於 %s（UTC）" % m.get("frozen_at", "?"))
+        if m.get("note"):
+            lines.append("\t\t- 說明：%s" % m["note"])
+        lines.append("\t\t- 由這些組成（沒有更動的 repo 不會出現在這裡）")
+        for p in m.get("parts", []):
+            ev = p.get("verified") or {}
+            lines.append("\t\t\t- `%s` @ **%s**　（凍結當下驗過：%s %s）"
+                         % (p["repo"], p["version"], ev.get("kind", "?"),
+                            ev.get("commit", "")))
+        lines.append("\t\t- 要退回這一版：`scripts/release-manifest rollback %s`" % m["name"])
+    lines.append("")
+    lines.append("- 為什麼要有這份東西（`inkstone/ISEP#84`）")
+    lines.append("\t- 退版只退了其中一個 repo，剩下的還停在新版"
+                 " ⇒ **變成一組從來沒測過的組合**。")
+    lines.append("\t- 所以送測、放行、出貨、退版**全部以一份清單為單位**，"
+                 "不以單一 repo 為單位。")
+    try:
+        os.makedirs(DIR, exist_ok=True)
+        with open(os.path.join(DIR, "INDEX.md"), "w") as f:
+            f.write("\n".join(lines) + "\n")
+    except Exception as e:
+        die("🔴 寫不進 %s：%s" % (DIR, e))
+
+
+# ── freeze ───────────────────────────────────────────────────────────────
+def cmd_freeze(argv):
+    if not argv:
+        die("用法：release-manifest freeze <清單名> --part owner/repo@版本 [--part …] "
+            "[--note 說明] [--dry-run]")
+    name = argv[0]
+    if not NAME_RE.match(name):
+        die("🔴 清單名只准英數與 . _ -（例：R-2026.08.30），你給的是：%s" % name)
+    raw = opts(argv[1:], "--part")
+    if not raw:
+        die("🚫 一份清單至少要有一格 --part owner/repo@版本號。\n"
+            "   （單一 repo 的交貨也要開清單——它只是退化成一格，規則不變。）")
+
+    if load(name) is not None:
+        die("🚫 %s 已經凍結過了，不准再加東西。\n"
+            "   【inkstone/ISEP#84】「清單一旦凍結就不再加東西，**新的需求進下一版**。」\n"
+            "   要出新的組合 ⇒ 換一個清單名重新 freeze（舊的留著，退版時要用）。" % name)
+
+    seen, parts = set(), []
+    for s in raw:
+        owner, repo, ver = parse_part(s)
+        full = "%s/%s" % (owner, repo)
+        if full in seen:
+            die("🔴 同一個 repo 在清單裡出現兩次：%s" % full)
+        seen.add(full)
+        ev = resolve(owner, repo, ver)
+        if not ev:
+            die("🚫 %s@%s **在 Gitea 上抓不到**——不給凍結。\n"
+                "   【inkstone/ISEP#84 驗收 1】「清單上的版本號**真的存在**"
+                "（不是寫上去而已，要抓得到那個 release）」。\n"
+                "   先把那個 repo 的版本打出來（tag／release），再回來 freeze。"
+                % (full, ver))
+        parts.append({"repo": full, "version": ver, "verified": ev})
+
+    nxt = max([m.get("seq", 0) for m in all_manifests()] or [0]) + 1
+    man = {"name": name, "seq": nxt,
+           "frozen_at": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()),
+           "note": opt(argv[1:], "--note", "") or "",
+           "parts": parts}
+
+    if DRY:
+        print("[dry-run] 會寫進 %s" % path_of(name))
+        print(json.dumps(man, ensure_ascii=False, indent=2))
+        print("[dry-run] 一個檔都沒有真的寫出去。")
+        return
+    os.makedirs(DIR, exist_ok=True)
+    with open(path_of(name), "w") as f:
+        json.dump(man, f, ensure_ascii=False, indent=2)
+    write_index()
+    print("✅ 清單 %s 已凍結（%d 個 repo，每一格都驗過真的抓得到）" % (name, len(parts)))
+    for p in parts:
+        print("   %-34s %s" % (p["repo"], p["version"]))
+    print("\n📌 從現在起：送測／放行／出貨／退版都以 %s 為單位，不以單一 repo 為單位。" % name)
+    print("   人看的版本：%s" % os.path.join(DIR, "INDEX.md"))
+
+
+# ── verify / show / list / current / diff ────────────────────────────────
+def cmd_verify(argv):
+    if not argv:
+        die("用法：release-manifest verify <清單名>")
+    man = load(argv[0]) or die("🔴 沒有這份清單：%s" % argv[0])
+    bad = 0
+    for p in man["parts"]:
+        owner, repo = p["repo"].split("/", 1)
+        ev = resolve(owner, repo, p["version"])
+        print("%s %-34s %s" % ("✅" if ev else "❌", p["repo"], p["version"]))
+        if not ev:
+            bad += 1
+    if bad:
+        die("\n🔴 %d 格抓不到了——這份清單現在**退不回去**，"
+            "要嘛版本被刪了，要嘛當初就沒真的存在。" % bad)
+    print("\n✅ %s 全部 %d 格都還抓得到，可以拿它退版。" % (man["name"], len(man["parts"])))
+
+
+def cmd_show(argv):
+    if not argv:
+        die("用法：release-manifest show <清單名>")
+    man = load(argv[0]) or die("🔴 沒有這份清單：%s" % argv[0])
+    print(json.dumps(man, ensure_ascii=False, indent=2))
+
+
+def cmd_list(argv):
+    rows = all_manifests()
+    if not rows:
+        print("（還沒有任何凍結過的清單。第一份用 release-manifest freeze 開。）")
+        return
+    for i, m in enumerate(rows):
+        print("%s %-18s %s  %d 個 repo：%s"
+              % ("👉" if i == 0 else "  ", m["name"], m.get("frozen_at", "?"),
+                 len(m.get("parts", [])),
+                 " + ".join("%s@%s" % (p["repo"].split("/")[-1], p["version"])
+                            for p in m.get("parts", []))))
+    print("\n👉 ＝ 現在手上的這一版。人看的版本：%s" % os.path.join(DIR, "INDEX.md"))
+
+
+def cmd_current(argv):
+    rows = all_manifests()
+    if not rows:
+        die("🔴 一份清單都沒有——「我現在手上是哪一版」目前沒有人答得出來。", 1)
+    m = rows[0]
+    print("現在手上的這一版：%s（凍結於 %s）" % (m["name"], m.get("frozen_at", "?")))
+    for p in m["parts"]:
+        print("   %-34s %s" % (p["repo"], p["version"]))
+
+
+def cmd_diff(argv):
+    if len(argv) < 2:
+        die("用法：release-manifest diff <舊清單> <新清單>")
+    a = load(argv[0]) or die("🔴 沒有這份清單：%s" % argv[0])
+    b = load(argv[1]) or die("🔴 沒有這份清單：%s" % argv[1])
+    va = {p["repo"]: p["version"] for p in a["parts"]}
+    vb = {p["repo"]: p["version"] for p in b["parts"]}
+    for repo in sorted(set(va) | set(vb)):
+        x, y = va.get(repo), vb.get(repo)
+        if x == y:
+            print("   = %-34s %s" % (repo, x))
+        elif x is None:
+            print("   + %-34s %s（新進來的）" % (repo, y))
+        elif y is None:
+            print("   - %-34s %s（新清單裡沒有了）" % (repo, x))
+        else:
+            print("   ~ %-34s %s → %s" % (repo, x, y))
+
+
+# ── rollback：整份一起退，沒有「只退一個」這個選項 ────────────────────────
+def cmd_rollback(argv):
+    if not argv:
+        die("用法：release-manifest rollback <清單名> [--dry-run]")
+    name = argv[0]
+    man = load(name) or die("🔴 沒有這份清單：%s" % name)
+
+    only = opts(argv[1:], "--only")
+    if only:
+        die("🚫 **退版沒有「只退一個」這個選項。**（你指名了：%s）\n\n"
+            "   【inkstone/ISEP#84】「要退版的時候，只退了其中一個 repo，\n"
+            "     剩下的還停在新版 ⇒ **變成一組從來沒測過的組合**。」\n\n"
+            "   %s 這一版由 %d 個 repo 組成：\n%s\n"
+            "   ⇒ 拿掉 --only，整份一起退：release-manifest rollback %s\n"
+            "   ⇒ 真的只有一個 repo 要動 ⇒ 那就 freeze 一份**新的**清單，"
+            "把不動的那幾格照抄過去。"
+            % (", ".join(only), name, len(man["parts"]),
+               "\n".join("       %s @ %s" % (p["repo"], p["version"])
+                         for p in man["parts"]), name))
+
+    cur = all_manifests()
+    curv = {p["repo"]: p["version"] for p in cur[0]["parts"]} if cur else {}
+    curname = cur[0]["name"] if cur else "（沒有）"
+
+    print("退版目標：%s（現在手上的是 %s）\n" % (name, curname))
+    moves, stays = [], []
+    for p in man["parts"]:
+        (stays if curv.get(p["repo"]) == p["version"] else moves).append(p)
+
+    print("【要動的】")
+    if not moves:
+        print("   （沒有——現在手上的組合已經等於這份清單）")
+    for p in moves:
+        owner_repo = p["repo"]
+        print("   %-34s %s → %s" % (owner_repo, curv.get(owner_repo, "?"), p["version"]))
+        print("       git -C <%s 的工作目錄> fetch --tags && "
+              "git -C <同上> checkout %s" % (owner_repo.split("/")[-1], p["version"]))
+    if stays:
+        print("\n【已經在目標版本、不必動】（列出來是為了讓你確認**沒有一格被漏掉**）")
+        for p in stays:
+            print("   %-34s %s" % (p["repo"], p["version"]))
+
+    print("\n🔴 這 %d 格是一組，要嘛全部到位，要嘛就不算退版完成。"
+          % len(man["parts"]))
+    print("   退完跑一次複驗：release-manifest verify %s" % name)
+
+
+def main():
+    global DRY
+    argv = sys.argv[1:]
+    if "--dry-run" in argv:
+        DRY = True
+        argv = [a for a in argv if a != "--dry-run"]
+    if not argv:
+        print(__doc__)
+        return
+    cmd, rest = argv[0], argv[1:]
+    table = {"freeze": cmd_freeze, "verify": cmd_verify, "show": cmd_show,
+             "list": cmd_list, "current": cmd_current, "diff": cmd_diff,
+             "rollback": cmd_rollback}
+    if cmd not in table:
+        print(__doc__)
+        die("🔴 沒有這個子指令：%s" % cmd)
+    table[cmd](rest)
+
+
+if __name__ == "__main__":
+    main()

scripts/roster

@@ -0,0 +1,94 @@
+#!/usr/bin/env python3
+"""roster — 工人名單（inkstone/ISEP#86）
+
+    python3 scripts/roster list             名單：有哪幾個工人、各自管什麼
+    python3 scripts/roster show <名字>       一個工人的全文（它開工時會讀到的東西）
+    python3 scripts/roster names            只印名字，一行一個（給腳本用）
+    python3 scripts/roster which <owner/repo>  這個 repo 該派給誰
+
+leo（ISEP#86）：「身為派工的人，我要工人有名字，我才知道票上這件事到底是誰做的。」
+
+名單是**資料**（`agents/*.md`），不是程式：加一個工人＝加一個檔，不改任何 hook。
+派工時把名字放進 `Task` 的 `subagent_type`；名字不在名單上，
+`hooks/roster-guard.sh` 會擋下來並說「沒有這個人」。
+"""
+import os
+import sys
+
+sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "hooks", "lib"))
+try:
+    import roster as R
+except Exception as e:                                   # pragma: no cover
+    print("🔴 讀不到 hooks/lib/roster.py：%s" % e, file=sys.stderr)
+    sys.exit(1)
+
+
+def cmd_list():
+    ws = R.load()
+    if not ws:
+        print("🔴 名單是空的（找不到 %s 底下任何工人檔）" % R.roster_dir(), file=sys.stderr)
+        return 1
+    print("工人名單（%d 位）　來源：%s\n" % (len(ws), R.roster_dir()))
+    print("  %-18s %-26s %s" % ("名字", "負責 repo", "它是誰"))
+    print("  " + "─" * 100)
+    for w in ws:
+        print("  " + R.one_liner(w))
+    print("\n派工：把「名字」放進 Task 的 subagent_type；派工單本身仍然只有一行【工單】。")
+    print("看某一位的全文：python3 scripts/roster show <名字>")
+    return 0
+
+
+def cmd_show(name):
+    w = R.find(name)
+    if not w:
+        print("🚫 名單上沒有「%s」這個人。現有的是：\n  %s"
+              % (name, "\n  ".join(R.names()) or "（空）"), file=sys.stderr)
+        return 2
+    print("# %s\n" % w["name"])
+    print("負責 repo：%s" % (w["repo"] or "（跨 repo）"))
+    print("一句話　：%s" % w["description"])
+    print("檔案　　：%s\n" % w["path"])
+    print(w["body"])
+    return 0
+
+
+def cmd_which(repo):
+    hits = [w for w in R.load() if w["repo"].lower() == (repo or "").strip().lower()]
+    if not hits:
+        print("🚫 名單上沒有負責「%s」的人。現有的是：" % repo, file=sys.stderr)
+        for w in R.load():
+            print("  " + R.one_liner(w), file=sys.stderr)
+        return 2
+    for w in hits:
+        print(w["name"])
+    return 0
+
+
+def main():
+    argv = sys.argv[1:]
+    if not argv or argv[0] in ("-h", "--help", "help"):
+        print(__doc__)
+        return 0
+    verb, rest = argv[0], argv[1:]
+    if verb == "list":
+        return cmd_list()
+    if verb == "names":
+        for n in R.names():
+            print(n)
+        return 0
+    if verb == "show":
+        if not rest:
+            print("用法：scripts/roster show <名字>", file=sys.stderr)
+            return 1
+        return cmd_show(rest[0])
+    if verb == "which":
+        if not rest:
+            print("用法：scripts/roster which <owner/repo>", file=sys.stderr)
+            return 1
+        return cmd_which(rest[0])
+    print("不認得的動詞「%s」。\n%s" % (verb, __doc__), file=sys.stderr)
+    return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

scripts/test-baton-handback-guard.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+# 交棒警察的測試——三格（指派／tag／下一步）各自缺漏時要被抓到
+# 判準：5 種該報、5 種不該報
+# 用 fixture 跑，不打網路、不在票池留下任何一張測試票。
+cd "$(dirname "$0")/.." || exit 1
+H=hooks/baton-handback-guard.sh
+PASS=0; FAIL=0
+FX=$(mktemp -d); trap 'rm -rf "$FX"' EXIT
+
+mkfx(){ # $1=state $2=assignees(csv) $3=labels(csv) $4=有沒有交棒留言(y/n)
+  python3 - "$FX" "$1" "$2" "$3" "$4" <<'PY'
+import json, sys, os
+d, state, asg, labs, baton = sys.argv[1:6]
+issue = {"state": state,
+         "assignees": [{"login": a} for a in asg.split(",") if a],
+         "labels": [{"name": l} for l in labs.split(",") if l]}
+comments = [{"body": "一般進度留言"}]
+if baton == "y":
+    comments.append({"body": "🏃 **棒子交回**　→ `claude-code`\n\n**下一步**：去驗那一格"})
+json.dump(issue, open(os.path.join(d, "issue.json"), "w"))
+json.dump(comments, open(os.path.join(d, "comments.json"), "w"))
+PY
+}
+
+run(){ # $1=want $2=說明  （fixture 已備好）
+  printf '%s' '{"tool_name":"Agent","tool_input":{"prompt":"【工單】inkstone/arcrun-rag#136\n做點事"}}' \
+    | BATON_GUARD_FIXTURE="$FX" bash "$H" >/dev/null 2>&1
+  got=$?
+  if [ "$got" = "$1" ]; then PASS=$((PASS+1)); printf '  ✅ '; else FAIL=$((FAIL+1)); printf '  ❌ '; fi
+  printf 'want=%s got=%s  %s\n' "$1" "$got" "$2"
+}
+
+echo "── 該報：三格有缺 ──"
+mkfx open ""            "s/doing"   n ; run 2 "三格全缺（＝08-26 那次掉棒的狀態）"
+mkfx open ""            "s/review"  y ; run 2 "缺指派：撈 assignee 撈不到它"
+mkfx open "claude-code" ""          y ; run 2 "缺 tag：看不出它卡在哪一段"
+mkfx open "claude-code" "s/review"  n ; run 2 "缺下一步：收下的人得重讀整串"
+mkfx open "claude-code" "s/doing"   y ; run 2 "tag 還停在 s/doing，但這條線收工了"
+
+echo "── 不該報 ──"
+mkfx open   "claude-code" "s/review"          y ; run 0 "三格都齊（交回總管等 review）"
+mkfx open   "Leo"         "s/stage,Human"     y ; run 0 "三格都齊（交給 leo 驗收）"
+mkfx open   "claude-code" "s/pending,p/high"  y ; run 0 "卡在依賴上，但三格都齊"
+mkfx closed ""            ""                  n ; run 0 "票已關＝棒子到終點，沒有下一手"
+
+echo "── 派工單裡沒有【工單】那行 ⇒ 不歸這支管 ──"
+printf '%s' '{"tool_name":"Agent","tool_input":{"prompt":"隨便做點事"}}' \
+  | BATON_GUARD_FIXTURE="$FX" bash "$H" >/dev/null 2>&1
+got=$?
+if [ "$got" = 0 ]; then PASS=$((PASS+1)); printf '  ✅ '; else FAIL=$((FAIL+1)); printf '  ❌ '; fi
+printf 'want=0 got=%s  沒有票號的派工單\n' "$got"
+
+echo
+echo "$PASS/$((PASS+FAIL)) 通過"
+[ "$FAIL" = 0 ]

scripts/test-comment-carries-task-guard.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+# 討論串裡的任務要長成子票——這道閘的測試
+# 判準：6 種該擋（留言裡真的藏著待辦）、10 種不該擋
+# 🔴 「不該擋」比「該擋」重要：branch-holds.md 檔頭那句——
+#    永遠在響的警報，等於訓練人忽略這個警報。
+cd "$(dirname "$0")/.." || exit 1
+H=hooks/comment-carries-task-guard.sh
+PASS=0; FAIL=0
+SID=test-cctg-$$
+run(){ # $1=want $2=cmd
+  rm -f "/tmp/.comment-task-guard-warned-$SID"
+  printf '%s' "{\"session_id\":\"$SID\",\"tool_name\":\"Bash\",\"tool_input\":{\"command\":$(python3 -c 'import json,sys;print(json.dumps(sys.argv[1]))' "$2")}}" \
+    | bash "$H" >/dev/null 2>&1
+  got=$?
+  if [ "$got" = "$1" ]; then PASS=$((PASS+1)); printf '  ✅ '; else FAIL=$((FAIL+1)); printf '  ❌ '; fi
+  printf 'want=%s got=%s  %.62s\n' "$1" "$got" "$2"
+}
+
+echo "── 該擋：留言裡藏著一件還沒做完的事 ──"
+# 這一條就是 2026-08-26 真的掉了的那則的形狀
+run 2 'req("POST", f"{API}/repos/inkstone/arcrun-rag/issues/136/comments", {"body":"Phase 1 的驗收在雲端那半出貨之前驗不了"})'
+run 2 'curl -X POST "$API/repos/inkstone/Arcrun/issues/12/comments" -d "{\"body\":\"要等 leo 開閘才能部署\"}"'
+run 2 'req("POST", f"{API}/repos/x/y/issues/3/comments", {"body":"[blocker] 收端還沒上線"})'
+run 2 'req("POST", f"{API}/repos/x/y/issues/3/comments", {"body":"這條路徑還沒測，先擱著"})'
+run 2 'req("POST", f"{API}/repos/x/y/issues/3/comments", {"body":"TODO: 補一條端到端測試"})'
+run 2 'req("POST", f"{API}/repos/x/y/issues/3/comments", {"body":"等雲端出貨之後要回頭重驗一次"})'
+
+echo "── 不該擋 ──"
+run 0 'curl -s "$API/repos/inkstone/ISEP/issues/30/comments"'                       # 純讀
+run 0 'req("POST", f"{API}/repos/x/y/issues/3/comments", {"body":"已驗過，8/8 全綠"})'  # 沒有待辦形狀
+run 0 'scripts/ticket subtask inkstone/arcrun-rag#136 --title "身為x，我要y，我才z" -F /tmp/c.md'
+run 0 'scripts/ticket handback inkstone/arcrun-rag#136 --to claude-code --next "還沒驗的那格去驗"'
+run 0 'scripts/ticket mine'
+run 0 'scripts/ticket close inkstone/x#1 --deliverable https://example.invalid/pr/1'
+run 0 'grep -n "驗不了" hooks/comment-carries-task-guard.sh'                          # 只是讀這支閘
+run 0 'echo "這則留言等雲端出貨才驗得了 —— no-subtask: 它已經有子票 #143 了"'          # 逃生口
+run 0 'curl -X POST "$API/repos/x/y/issues" -d "{\"title\":\"等出貨\"}"'               # 開新票不歸這支管
+run 0 'req("POST", f"{API}/repos/x/y/issues/3/comments", {"body":"🏃 **棒子交回**　→ claude-code\n\n**下一步**：等 #143"})'
+
+echo "── 交棒標記只認第一行（2026-08-27 dogfood 抓到的漏）──"
+# 真的交棒留言：🏃 在第一行 ⇒ 放行
+run 0 'req("POST", f"{API}/repos/x/y/issues/3/comments", {"body":"🏃 **棒子交回**　→ claude-code\n\n**下一步**：等 #143"})'
+# 交件報告**引用**了一段有 🏃 的輸出，而報告本身帶著待辦 ⇒ 不准被豁免
+TMPR=$(mktemp)
+printf '交件報告\n\n```\n🏃 在總管手上的棒子：2 根\n```\n\n還有一格等雲端那半出貨才驗得了\n' > "$TMPR"
+run 2 "scripts/ticket say inkstone/ISEP#30 -F $TMPR"
+rm -f "$TMPR"
+
+echo "── 同一 session 只擋一次（不鬼打牆）──"
+rm -f "/tmp/.comment-task-guard-warned-$SID"
+C='req("POST", f"{API}/repos/x/y/issues/3/comments", {"body":"驗不了"})'
+for want in 2 0; do
+  printf '%s' "{\"session_id\":\"$SID\",\"tool_name\":\"Bash\",\"tool_input\":{\"command\":$(python3 -c 'import json,sys;print(json.dumps(sys.argv[1]))' "$C")}}" \
+    | bash "$H" >/dev/null 2>&1
+  got=$?
+  if [ "$got" = "$want" ]; then PASS=$((PASS+1)); printf '  ✅ '; else FAIL=$((FAIL+1)); printf '  ❌ '; fi
+  printf 'want=%s got=%s  第 %s 次同樣的指令\n' "$want" "$got" "$([ "$want" = 2 ] && echo 1 || echo 2)"
+done
+
+echo "── -F <檔>：內文在檔案裡也要看得到 ──"
+TMPF=$(mktemp); printf '這件事等雲端那半出貨才驗得了\n' > "$TMPF"
+run 2 "scripts/ticket say inkstone/arcrun-rag#136 -F $TMPF"
+printf '已驗完，全部綠燈\n' > "$TMPF"
+run 0 "scripts/ticket say inkstone/arcrun-rag#136 -F $TMPF"
+rm -f "$TMPF" "/tmp/.comment-task-guard-warned-$SID"
+
+echo
+echo "$PASS/$((PASS+FAIL)) 通過"
+[ "$FAIL" = 0 ]

scripts/test-debt-worklist.sh

@@ -0,0 +1,222 @@
+#!/bin/bash
+# 還債清單（scripts/debt-worklist）的測試——inkstone/ISEP#83 的四條驗收條件，一條一組。
+#
+# 全程離線：資料走 ISEP_DEBT_FIXTURE、時鐘走 ISEP_DEBT_NOW、狀態走 ISEP_DEBT_STATE_DIR。
+# **不打 Gitea、不留任何測試票、不碰 $HOME**。
+#
+# 為什麼要能離線測：這支工具的判斷（誰排前面、誰算緊急線、領走的還在不在）
+# 全都是純函式，只有「撈」那一步要網路。把撈的那一步換掉，其餘每一條都測得動——
+# 否則就只剩「今天跑起來看起來對」，那不是測試（本 repo 心法：跑過 ≠ 驗過）。
+cd "$(dirname "$0")/.." || exit 1
+W=scripts/debt-worklist
+PASS=0; FAIL=0
+T=$(mktemp -d); trap 'rm -rf "$T"' EXIT
+NOW=2026-08-28T00:00:00Z
+
+ok(){ # $1=條件 $2=說明
+  if eval "$1"; then PASS=$((PASS+1)); printf '  ✅ %s\n' "$2"
+  else FAIL=$((FAIL+1)); printf '  ❌ %s\n     判準：%s\n' "$2" "$1"; fi
+}
+
+run(){ # 跑 list（或任何子命令），輸出留在 $OUT，離開碼留在 $RC
+  # 🔴 ISEP_COUNTDOWN_STATE_DIR 也要指到暫存目錄：主線（hooks/lib/mainline.py）住在那裡，
+  #    不隔離的話這支測試的結果會取決於「這台機器現在標了哪條主線」——那就不是測試了。
+  OUT=$(ISEP_DEBT_FIXTURE="$FX" ISEP_DEBT_STATE_DIR="$T/state" ISEP_DEBT_NOW="$NOW" \
+        ISEP_COUNTDOWN_STATE_DIR="$ML_DIR" python3 "$W" "$@" 2>&1); RC=$?
+}
+
+ML_DIR="$T/mainline"; mkdir -p "$ML_DIR"
+set_mainline(){ # $1=主線 milestone 標題（空＝沒有主線）
+  if [ -z "$1" ]; then rm -f "$ML_DIR/mainline.json"; return; fi
+  python3 - "$ML_DIR/mainline.json" "$1" <<'PY'
+import json, sys
+path, title = sys.argv[1], sys.argv[2]
+json.dump({"ref": "inkstone/A#1", "owner": "inkstone", "repo": "A", "id": 1,
+           "title": title, "members": [], "due_on": ""}, open(path, "w"))
+PY
+}
+
+# ── 造資料：一份長得像 Gitea 回應的 fixture ─────────────────────────────────
+mkfx(){ FX="$T/$1.json"; python3 - "$FX" "$1" <<'PY'
+import json, sys
+path, which = sys.argv[1], sys.argv[2]
+
+def it(repo, n, title, labels=(), ms=None, ms_state="open", assignees=(),
+       updated="2026-08-01T00:00:00Z", body="", pr=False):
+    d = {"number": n, "title": title, "body": body, "updated_at": updated,
+         "created_at": "2026-07-01T00:00:00Z", "state": "open",
+         "labels": [{"name": l} for l in labels],
+         "assignees": [{"login": a} for a in assignees] or None,
+         "repository": {"full_name": repo},
+         "html_url": f"https://git.uncle6.me/{repo}/issues/{n}"}
+    if ms:
+        d["milestone"] = {"title": ms, "state": ms_state}
+        if ms == "上個 sprint":
+            d["milestone"]["due_on"] = "2026-08-10T23:59:59Z"   # 已經過了 18 天
+    if pr:
+        d["pull_request"] = {"merged": False}
+    return d
+
+repos = [{"name": "inkstone/A", "issues": 0, "prs": 0},
+         {"name": "inkstone/B", "issues": 0, "prs": 0}]
+deps, items = {}, []
+
+if which == "full":
+    items = [
+        # 事故＋擋住別人的 → 該排第一
+        it("inkstone/A", 1, "壞掉了", ["type/bug"], updated="2026-08-20T00:00:00Z",
+           body="x" * 2000),
+        it("inkstone/A", 2, "我等 A#1", updated="2026-08-27T00:00:00Z",
+           body="被 inkstone/A#1 擋住" + "y" * 2000),
+        it("inkstone/B", 9, "我也等 A#1", updated="2026-08-27T00:00:00Z",
+           body="要先解 inkstone/A#1" + "y" * 2000),
+        # 掛在 open milestone 上＝緊急線在管，不該出現
+        it("inkstone/A", 3, "緊急線的票", ["p/high", "type/bug"], ms="這週出貨"),
+        # 掛在**別條**（非主線）milestone 上，而且期限已經過了
+        it("inkstone/A", 8, "別條線的票", ms="上個 sprint", body="q" * 2000),
+        # milestone 已關但票還開著＝孤兒，該出現
+        it("inkstone/A", 4, "孤兒票", ms="上週", ms_state="closed", body="z" * 2000),
+        # 等 leo 的三種，都不該出現在可領清單
+        it("inkstone/A", 5, "等 leo 批", ["Human", "p/high", "type/bug"]),
+        it("inkstone/A", 6, "等 leo 動手", ["human/exec"]),
+        it("inkstone/A", 7, "等 leo 驗", ["s/stage", "p/high"]),
+        # 放很久沒人動 vs 昨天才動過：同條件下前者要排前面
+        it("inkstone/B", 10, "放了很久", updated="2026-06-01T00:00:00Z", body="w" * 2000),
+        it("inkstone/B", 11, "昨天才動過", updated="2026-08-27T00:00:00Z", body="w" * 2000),
+        # 躺著的 PR 也是債
+        it("inkstone/B", 12, "躺著的 PR", pr=True, updated="2026-08-10T00:00:00Z",
+           body="v" * 2000),
+        # p/low：往後排
+        it("inkstone/B", 13, "晚點沒關係", ["p/low"], body="u" * 2000),
+        # 互相指著＝必然同包
+        it("inkstone/B", 20, "雙胞胎甲", body="跟 inkstone/B#21 是同一件事" + "t" * 2000,
+           updated="2026-08-05T00:00:00Z"),
+        it("inkstone/B", 21, "雙胞胎乙", body="見 inkstone/B#20" + "t" * 2000,
+           updated="2026-08-05T00:00:00Z"),
+        # 母票／子票：只有原生相依看得出來（內文沒有互指）
+        it("inkstone/B", 30, "母票", body="s" * 2000, updated="2026-08-05T00:00:00Z"),
+        it("inkstone/B", 31, "子票", body="s" * 2000, updated="2026-08-05T00:00:00Z"),
+    ]
+    deps = {"inkstone/B#30": ["inkstone/B#31"]}
+
+elif which == "empty":
+    items = [it("inkstone/A", 3, "緊急線的票", ["p/high"], ms="這週出貨"),
+             it("inkstone/A", 5, "等 leo 批", ["Human"])]
+
+elif which == "onedone":
+    # 「昨天領走的今天關掉了」——它從 open 清單消失
+    items = [it("inkstone/A", 2, "我等 A#1", body="y" * 2000)]
+
+json.dump({"repos": repos, "items": items, "deps": deps}, open(path, "w"))
+PY
+}
+
+mkfx full; FULL="$T/full.json"
+mkfx empty
+mkfx onedone
+
+echo "── 驗收 1：跑一次要吐出排好序的清單＋「我查了哪些 repo」的證明 ──"
+FX="$FULL"; run list --top 20
+ok '[ "$RC" = 0 ]'                              '離開碼 0'
+ok 'grep -q "查過的 repo：2 個" <<<"$OUT"'       '證明段落列出查過的 repo 數'
+ok 'grep -q "inkstone/A" <<<"$OUT" && grep -q "inkstone/B" <<<"$OUT"' '每個 repo 都列名（不是只給總數）'
+ok 'grep -q "1\. \[.*\] inkstone/A#1" <<<"$OUT"' '事故＋擋住兩張 ⇒ 排第一名'
+ok 'grep -q "事故+40" <<<"$OUT"'                 '每張票旁邊看得到「為什麼排這裡」的分項'
+ok 'grep -q "擋住2張" <<<"$OUT"'                 '「擋住別人的」算得出來（兩張指著 A#1）'
+
+echo "── 驗收 1b：排序的五個條件真的有作用 ──"
+pos(){ grep -n "$1" <<<"$OUT" | head -1 | cut -d: -f1; }
+ok '[ "$(pos "inkstone/B#10")" -lt "$(pos "inkstone/B#11")" ]' '放最久的排在昨天才動過的前面'
+ok '[ "$(pos "inkstone/B#12")" -lt "$(pos "inkstone/B#13")" ]' '躺著的 PR 排在 p/low 前面'
+ok 'grep -q "PR躺著+25" <<<"$OUT"'                             'PR 被認出來（不是只算 issue）'
+ok '! grep -q "inkstone/A#3" <<<"$OUT"'   '掛 open milestone 的不進清單（那歸緊急線）'
+ok 'grep -q "inkstone/A#4" <<<"$OUT"'     'milestone 已關但票還開著 ⇒ 是債，要進清單'
+ok '! grep -q "inkstone/A#5" <<<"$OUT" && ! grep -q "inkstone/A#6" <<<"$OUT"' \
+   'Human／human-exec 不進可領清單（沒有人能替 leo 領）'
+ok '! grep -q "inkstone/A#7" <<<"$OUT"'   's/stage＝等 leo 驗，要催不是要領'
+ok 'grep -q "等 leo 的 3 張" <<<"$OUT"'    '被扣掉的有講數字，不是靜靜消失'
+
+echo "── 驗收 1c：成包——相關的要一起領，但不准黏成一坨 ──"
+ok 'grep -A6 "inkstone/B#20（票）" <<<"$OUT" | grep -q "inkstone/B#21"' '互相指著的成同一包'
+ok 'grep -A6 "inkstone/B#30（票）" <<<"$OUT" | grep -q "inkstone/B#31"' '原生相依（母票→子票）成同一包'
+ok '! (grep -A6 "inkstone/A#1（票）" <<<"$OUT" | grep -q "同一包")' \
+   '單向引用不成包（A#2、B#9 都指著 A#1，但 A#1 沒指回來 ⇒ 不能黏成一坨）'
+
+echo "── 接上「現在的主線是哪一個」（inkstone/ISEP#82 的唯一答案）──"
+set_mainline ""; FX="$FULL"; run list --top 20
+ok 'grep -q "現在沒有標主線" <<<"$OUT"'     '沒標主線 ⇒ 照實說，不編一條出來'
+ok '! grep -q "inkstone/A#3" <<<"$OUT" && ! grep -q "inkstone/A#8" <<<"$OUT"' \
+   '沒標主線 ⇒ 保守：掛 open milestone 的一律不領（不跟緊急線搶同一張）'
+set_mainline "這週出貨"; run list --top 20
+ok 'grep -q "現在的主線" <<<"$OUT" && grep -q "這週出貨" <<<"$OUT"' \
+   '標了主線 ⇒ 清單上講得出用的是哪一條（判斷來自 scripts/mainline，不是自己算的）'
+ok '! grep -q "inkstone/A#3" <<<"$OUT"'  '在主線上的票仍然不領（那是緊急線在管的）'
+ok 'grep -q "inkstone/A#8" <<<"$OUT"'    '掛在別條 milestone 的是債（那條線現在沒人推）'
+ok 'grep -q "逾期17天的承諾+15" <<<"$OUT"' '別條 milestone 已逾期 ⇒ 算「答應過人家的」加分'
+ok 'grep -q "別條\*\* milestone 上的 1 張仍算債" <<<"$OUT"' '被改判成債的有幾張，講出來'
+set_mainline ""    # 收回去，後面幾組回到「沒有主線」的世界
+
+echo "── 驗收 2：清單是空的要說話，不能默默結束 ──"
+FX="$T/empty.json"; run list
+ok '[ "$RC" = 0 ]'                          '離開碼 0（沒東西可領不是錯誤）'
+ok 'grep -q "查詢跑過了，結果是零" <<<"$OUT"' '明講「查過了，結果是零」'
+ok 'grep -q "查過的 repo：2 個" <<<"$OUT"'    '空清單一樣附查詢證明（分得出「沒東西」與「沒查」）'
+
+echo "── 驗收 3：今天領走的，明天不在清單上 ──"
+rm -rf "$T/state"; FX="$FULL"
+run claim inkstone/B#20 inkstone/B#21
+ok '[ "$RC" = 0 ]'                        '領走兩張成功'
+run list --top 20
+PICK=$(sed -n '/今天可以領的/,$p' <<<"$OUT")
+ok '! grep -q "inkstone/B#21" <<<"$PICK"'  '領走的不再出現在可領清單（只看清單那一段）'
+ok 'grep -q "之前領走的 2 張" <<<"$OUT"'   '第二天看得到「之前領走的」那一段'
+ok 'grep -q "還開著 2" <<<"$OUT"'          '還開著的照實說（沒關就是還沒做完）'
+ok 'grep -q "已經領走的 2 張" <<<"$OUT"'   '扣除數字對得上'
+
+echo "── 驗收 3b：領走的票關掉之後，狀態要跟著變 ──"
+FX="$T/onedone.json"; run list
+ok 'grep -q "已關 2" <<<"$OUT"'  '票已經不在 open 清單 ⇒ 認定它做完了'
+
+echo "── 驗收 3c：放回去 ──"
+FX="$FULL"; run forget inkstone/B#20 inkstone/B#21
+ok '[ "$RC" = 0 ]' 'forget 成功'
+run list --top 20
+ok 'grep -q "inkstone/B#20" <<<"$OUT"' '放回去之後又回到可領清單'
+
+echo "── 誤用：擋得住，而且說得出怎麼改 ──"
+run claim B#20
+ok '[ "$RC" = 2 ] && grep -q "owner/repo#N" <<<"$OUT"' '票號寫錯 ⇒ 擋下並示範正確寫法'
+run claim inkstone/B#999
+ok '[ "$RC" = 2 ]'                                     '領一張不存在／已關的票 ⇒ 擋下'
+run claim
+ok '[ "$RC" = 2 ] && grep -q "用法" <<<"$OUT"'          '沒給票號 ⇒ 印用法'
+
+echo "── 機器可讀（要接進別的東西時不用 parse 中文）──"
+run list --json
+ok 'python3 -c "import json,sys;d=json.load(sys.stdin);sys.exit(0 if d[\"bundles\"] and d[\"repos\"] else 1)" <<<"$OUT"' \
+   '--json 吐得出合法 JSON，且有 bundles／repos'
+
+echo "── 紅線：這支腳本自己不會醒（不准做成輪詢／fan-out）──"
+ok '! grep -nE "time\\.sleep|crontab|sched|urlopen.*hooks" '"$W" \
+   '原始碼裡沒有等待／排程／裝 webhook 的動作（只有註解在談紅線，那不算）'
+
+echo "── SessionStart 那一句：不用有人記得下指令，也不准偷偷打網路 ──"
+# 把 session-start-recall.sh 裡「還債線」那一段切出來單獨跑（其餘段落會打雲端，這裡不要）。
+FRAG="$T/frag.sh"
+sed -n '/push 6：還債線/,/^echo ""$/p' hooks/session-start-recall.sh > "$FRAG"
+ok '[ -s "$FRAG" ]' 'session-start-recall.sh 裡真的有那一段（被刪掉就會紅）'
+rm -rf "$T/nudge"; mkdir -p "$T/nudge"
+OUT=$(set -euo pipefail; ISEP_DEBT_STATE_DIR="$T/nudge" bash "$FRAG" 2>&1); RC=$?
+ok '[ "$RC" = 0 ]'                              '沒有狀態檔也跑得過（第一次開 session）'
+ok 'grep -q "今天還沒撈過" <<<"$OUT"'            '今天沒撈過 ⇒ 開 session 就會說'
+ok 'grep -q "debt-worklist list" <<<"$OUT"'      '順手把要跑的那一行給出來'
+printf '{"claims":{"a/b#1":{}},"last_run":"%sT00:00:00Z"}' "$(date -u +%Y-%m-%d)" > "$T/nudge/claimed.json"
+OUT=$(ISEP_DEBT_STATE_DIR="$T/nudge" bash "$FRAG" 2>&1)
+ok 'grep -q "今天撈過了" <<<"$OUT"'              '今天撈過了 ⇒ 不再重複催'
+ok 'grep -q "手上領著 1 張" <<<"$OUT"'           '手上還領著幾張講出來'
+ok '! grep -qE "curl|urlopen|http" <<<"$(cat "$FRAG")"' \
+   'SessionStart 那一段完全不打網路（撈是人決定的動作，不是開機自動去撈）'
+
+echo
+echo "通過 $PASS 條，失敗 $FAIL 條"
+[ "$FAIL" = 0 ]

scripts/test-main-and-prod-push-guard.sh

@@ -4,7 +4,19 @@
 # 開頭包一層讀取指令）都不准擋；推自己的分支、含子字串但目標不是 main/master
 # 的分支（如 fix/custom-domain-setup）也不准擋。
 cd "$(dirname "$0")/.." || exit 1
-H=hooks/main-and-prod-push-guard.sh
+
+# 🔴 測沙盒裡的複本，不測真跡（inkstone/ISEP#59 comment 4779 第 ① 條）：
+#   這支閘擋下推 main 的同時會把請求寫進 `<repo>/pending-main-push/`，那份檔案的
+#   語意是「有一筆推 main 正在等總管裁」。這裡的測資本來就都是推 main
+#   ⇒ 直接測真跡的話，**每跑一次測試就偽造一筆待裁決**（實測：`unnamed--ISEP.md`
+#   每跑一次被覆寫一次，而它當時還是被追蹤的 ⇒ `git status` 永遠是髒的）。
+#   cwd 仍然留在 repo 根——戳記比對問的是「人站在哪個 repo」，那件事沒有變。
+. hooks/tests/lib/hook-sandbox.sh
+hook_sandbox "$PWD/hooks/main-and-prod-push-guard.sh" || { echo "❌ 沙盒建不起來"; exit 1; }
+trap 'hook_sandbox_cleanup' EXIT
+HOSTSUM_BEFORE=$(hook_sandbox_hostsum)
+H=$HOOK_SANDBOX_HOOK
+
 PASS=0; FAIL=0
 run(){ # $1=want $2=cmd
   printf '%s' "{\"tool_name\":\"Bash\",\"tool_input\":{\"command\":$(python3 -c 'import json,sys;print(json.dumps(sys.argv[1]))' "$2")}}" \
@@ -31,6 +43,10 @@ run 0 'grep -n "git push" hooks/main-and-prod-push-guard.sh'
 echo "── 真違規不能因為這次改動而漏擋：戳記過期／戳記綁錯 repo 一樣要擋 ──"
 run 2 'git push gitea HEAD:main'  # 沒有任何戳記檔時
 
+echo "── 測試自己不准弄髒工作區（inkstone/ISEP#59）──"
+hook_sandbox_assert "$HOSTSUM_BEFORE"
+PASS=$((PASS+HS_PASS)); FAIL=$((FAIL+HS_FAIL))
+
 echo
 echo "$PASS/$((PASS+FAIL)) 通過"
 [ "$FAIL" -eq 0 ]

scripts/test-milestone-account.sh

@@ -0,0 +1,155 @@
+#!/usr/bin/env bash
+# scripts/milestone-account 的迴歸測試（inkstone/ISEP#85）
+#
+#   驗收 1：關掉一個 milestone → 三個數字要自己算出來，不用手填
+#   驗收 2：差超過 25% → 要逼我挑一個代號，挑不出來不准結案
+#   驗收 3：累積幾次之後 → 看得出哪一種原因最常發生
+#   驗收 4：拿已經逾期的 milestone 進去算 → 要算得出數字
+#
+# 🔴 全程離線（MILESTONE_ACCOUNT_FIXTURE ＝一份假的 Gitea 回應表），
+#    時鐘用 MILESTONE_ACCOUNT_NOW 定住，帳本寫在 mktemp 目錄。
+#    **不打 Gitea、不關任何真的 milestone、不碰 repo 裡的 system-dev/estimates/。**
+set -u
+TOOL="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/milestone-account}"
+TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
+PASS=0; FAIL=0; N=0
+NOW="2026-08-28T00:00:00Z"
+FX="$TMP/fx.json"
+
+python3 - "$FX" <<'PY'
+import json, sys, urllib.parse
+api = {}
+
+def iso(d, h=0):
+    return "2026-08-%02dT%02d:00:00Z" % (d, h)
+
+def issue(n, created, closed=None, assignee=True, labels=(), ms=None):
+    return {"number": n, "created_at": created, "closed_at": closed,
+            "updated_at": closed or created,
+            "assignees": [{"login": "cc"}] if assignee else [],
+            "labels": [{"name": l} for l in labels],
+            "milestone": ({"id": ms} if ms else None)}
+
+def comment(n, at):
+    return {"issue_url": "https://x/api/v1/repos/o/r/issues/%d" % n, "created_at": at}
+
+def repo(full, mid, title, created, due, closed, issues, comments, open_ms=True):
+    o, r = full.split("/")
+    ms = {"id": mid, "title": title, "created_at": created, "due_on": due,
+          "closed_at": closed, "state": "open" if closed is None else "closed"}
+    api["/repos/%s/%s/milestones/%d" % (o, r, mid)] = ms
+    api["/repos/%s/%s/issues?state=all&type=issues&limit=50&page=1" % (o, r)] = issues
+    api["/repos/%s/%s/issues/comments?limit=100&since=%s"
+        % (o, r, urllib.parse.quote(created))] = comments
+    api["/repos/%s/%s/milestones?state=open&limit=50" % (o, r)] = [ms] if open_ms else []
+
+# ① A#12 磨洋工：08-02 收掉一張之後，時間軸整整空了 24 天
+repo("inkstone/A", 12, "sprint-磨洋工", iso(1), "2026-08-08T23:59:59Z", None,
+     [issue(1, iso(1, 1), iso(2), ms=12), issue(2, iso(1, 2), ms=12),
+      issue(3, iso(1, 3), ms=12), issue(9, iso(10), ms=None)],
+     [comment(1, iso(26))])
+
+# ② B#13 準時收掉：偏差只有 -6%，不必挑代號
+repo("inkstone/B", 13, "sprint-準時", iso(20), "2026-08-27T23:59:59Z",
+     "2026-08-27T12:00:00Z",
+     [issue(1, iso(20, 1), iso(25), ms=13), issue(2, iso(20, 2), iso(26), ms=13)],
+     [comment(1, iso(22)), comment(2, iso(24))], open_ms=False)
+
+# ③ C#14 過程沒異常、就是估錯：每兩天都有動作，其他六個訊號全不成立
+repo("inkstone/C", 14, "sprint-估錯", iso(1), "2026-08-10T23:59:59Z",
+     "2026-08-25T00:00:00Z",
+     [issue(1, iso(1, 1), iso(24), ms=14), issue(2, iso(1, 2), iso(23), ms=14)],
+     [comment(1, iso(d)) for d in range(3, 25, 2)], open_ms=False)
+
+# ④ D#15 範圍變大：開跑之後又補進來三張票
+repo("inkstone/D", 15, "sprint-範圍變大", iso(1), "2026-08-10T23:59:59Z",
+     "2026-08-25T00:00:00Z",
+     [issue(1, iso(1, 1), iso(24), ms=15), issue(2, iso(1, 2), iso(23), ms=15),
+      issue(3, iso(15), ms=15), issue(4, iso(15, 1), ms=15),
+      issue(5, iso(15, 2), ms=15)],
+     [comment(1, iso(d)) for d in range(3, 25, 2)], open_ms=False)
+
+api["/orgs/inkstone/repos?limit=100"] = [
+    {"full_name": "inkstone/%s" % x} for x in "ABCD"]
+json.dump({"api": api}, open(sys.argv[1], "w"), ensure_ascii=False)
+PY
+
+run() { MILESTONE_ACCOUNT_FIXTURE="$FX" MILESTONE_ACCOUNT_DIR="$TMP/led" \
+        MILESTONE_ACCOUNT_NOW="$NOW" python3 "$TOOL" "$@" 2>&1; }
+
+t() {
+  want="$1"; desc="$2"; must="$3"; shift 4
+  N=$((N+1)); out=$(run "$@"); rc=$?
+  ok=1; [ "$rc" -eq "$want" ] || ok=0
+  if [ -n "$must" ] && ! printf '%s' "$out" | grep -qF "$must"; then ok=0; fi
+  if [ "$ok" -eq 1 ]; then printf '  ✅ %s\n' "$desc"; PASS=$((PASS+1))
+  else
+    printf '  ❌ %s —— 期望 exit=%s%s，實得 exit=%s\n' "$desc" "$want" \
+      "${must:+ 且輸出含「$must」}" "$rc"
+    printf '%s\n' "$out" | sed -n '1,12p' | sed 's/^/     /'; FAIL=$((FAIL+1))
+  fi
+}
+
+echo "── 驗收 1：三個數字自己算出來 ─────────────────────────────"
+t 0 "① audit 印出「當初訂的期限」" "當初訂的期限" -- audit inkstone/A#12
+t 0 "② audit 印出「實際花掉的」"   "實際花掉的"   -- audit inkstone/A#12
+t 0 "③ 偏差算得出來（A#12 逾期 +238%）" "+238%" -- audit inkstone/A#12
+t 0 "④ 期限是 08-08、實際算到今天 08-28 ⇒ 27 天" "27.0天" -- audit inkstone/A#12
+
+echo "── 驗收 2：差超過 25% 逼你挑代號 ──────────────────────────"
+t 2 "⑤ A#12 差 +237% 卻沒給 --reason ⇒ 不准結案" "挑不出代號不准結案" -- \
+   close inkstone/A#12
+t 2 "⑥ 承上：訊息要直接列出撐得住的代號" "時間軸撐得住的代號：idle" -- close inkstone/A#12
+t 0 "⑦ B#13 只差 -6% ⇒ 不必挑代號，直接結得掉" "已記帳" -- close inkstone/B#13
+t 2 "⑧ 造一個不存在的代號 ⇒ 擋（封閉集合）" "不是那七個代號之一" -- \
+   close inkstone/A#12 --reason 拖延症
+t 2 "⑨ 挑一個時間軸撐不住的代號 ⇒ 擋（不採信我自己說的）" "時間軸撐不住" -- \
+   close inkstone/C#14 --reason idle
+t 0 "⑩ C#14 六個訊號都不成立 ⇒ 唯一合法的是 misestimate" "misestimate" -- \
+   audit inkstone/C#14
+t 0 "⑪ 承上：--reason misestimate 收得掉" "原因＝misestimate" -- \
+   close inkstone/C#14 --reason misestimate
+t 0 "⑫ A#12 挑 idle（時間軸真的有 24 天空白）⇒ 收得掉" "原因＝idle" -- \
+   close inkstone/A#12 --reason idle
+t 0 "⑬ D#15 開跑後補三張票 ⇒ scope-creep 撐得住" "原因＝scope-creep" -- \
+   close inkstone/D#15 --reason scope-creep
+
+echo "── 驗收 3：看得出哪一種原因最常發生 ───────────────────────"
+t 0 "⑭ report 數得出每個代號各幾次" "磨洋工" -- report
+t 0 "⑮ report 算得出累計結案幾個" "累計結案 4 個里程碑" -- report
+N=$((N+1))
+if grep -q "哪一種原因最常發生" "$TMP/led/REPORT.md" 2>/dev/null \
+   && grep -q "時間軸證據" "$TMP/led/REPORT.md"; then
+  printf '  ✅ ⑯ REPORT.md 寫出來了，而且每一筆都帶時間軸證據\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ⑯ REPORT.md 內容不對\n'; FAIL=$((FAIL+1))
+fi
+N=$((N+1))
+if [ "$(wc -l < "$TMP/led/ledger.jsonl")" = "4" ]; then
+  printf '  ✅ ⑰ 帳本剛好四筆（沒有被擋下的那幾次也記進去）\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ⑰ 帳本筆數不對：%s\n' "$(wc -l < "$TMP/led/ledger.jsonl" 2>/dev/null)"
+  FAIL=$((FAIL+1))
+fi
+
+echo "── 驗收 4：拿已經逾期的里程碑進去算 ───────────────────────"
+t 0 "⑱ list --overdue 撈得到逾期的那一個，而且帶數字" "inkstone/A#12" -- \
+   list --org inkstone --overdue
+t 0 "⑲ 承上：逾期的要被標成「差超過 ±25%」那一類" "🔴" -- \
+   list --org inkstone --overdue
+
+echo "── 其他 ───────────────────────────────────────────────────"
+t 0 "⑳ codes 印得出七個代號，一個不多一個不少" "misestimate" -- codes
+N=$((N+1))
+if [ "$(run codes | grep -cE '^  [a-z-]+ ')" = "7" ]; then
+  printf '  ✅ ㉑ 真的是七個（封閉集合）\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ㉑ 代號數量不是 7：%s\n' "$(run codes | grep -cE '^  [a-z-]+ ')"; FAIL=$((FAIL+1))
+fi
+t 0 "㉒ --dry-run 印出要打的那通 API 但不送出" "一筆都沒有真的寫出去" -- \
+   close inkstone/A#12 --reason idle --dry-run
+t 2 "㉓ 里程碑編號寫錯 ⇒ 講清楚寫法" "寫法是 owner/repo#里程碑編號" -- audit ISEP-12
+
+echo
+echo "通過 $PASS 條，失敗 $FAIL 條（共 $N 條）"
+[ "$FAIL" -eq 0 ]

scripts/test-release-manifest.sh

@@ -0,0 +1,98 @@
+#!/usr/bin/env bash
+# scripts/release-manifest 的迴歸測試（inkstone/ISEP#84）
+#
+# 兩個方向都要有證據：
+#   A 群「該擋」——版本號在 Gitea 抓不到／清單已凍結還想加東西／退版只退一個
+#   B 群「該過」——版本號真的存在就凍結得起來、退版吐出整份、diff 看得出差在哪
+#   C 群「leo 打開看得懂」——INDEX.md 真的被重寫，而且第一份標著「現在手上的這一版」
+#
+# 🔴 全程離線（RELEASE_MANIFEST_FIXTURE），不打 Gitea、不建任何真的 release。
+#    清單寫在 mktemp 的目錄（RELEASE_MANIFEST_DIR），不碰 repo 裡的 releases/。
+set -u
+TOOL="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/release-manifest}"
+TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
+PASS=0; FAIL=0; N=0
+
+FX="$TMP/fx.json"
+cat > "$FX" <<'JSON'
+{"versions": {
+  "inkstone/Arcrun@v1.4.52":            {"kind":"release","url":"u1","commit":"aaaaaaaaaaaa"},
+  "inkstone/Arcrun@v1.4.51":            {"kind":"release","url":"u2","commit":"bbbbbbbbbbbb"},
+  "inkstone/arcrun-collector@v0.18.36": {"kind":"tag","url":"u3","commit":"cccccccccccc"},
+  "inkstone/arcrun-collector@v0.18.35": {"kind":"tag","url":"u4","commit":"dddddddddddd"}
+}}
+JSON
+
+run() { RELEASE_MANIFEST_FIXTURE="$FX" RELEASE_MANIFEST_DIR="$TMP/rel" python3 "$TOOL" "$@" 2>&1; }
+
+# t <期望 exit> <說明> <必須出現的字串（可空）> -- <參數…>
+t() {
+  want="$1"; desc="$2"; must="$3"; shift 4
+  N=$((N+1))
+  out=$(run "$@"); rc=$?
+  ok=1
+  [ "$rc" -eq "$want" ] || ok=0
+  if [ -n "$must" ] && ! printf '%s' "$out" | grep -qF "$must"; then ok=0; fi
+  if [ "$ok" -eq 1 ]; then printf '  ✅ %s\n' "$desc"; PASS=$((PASS+1))
+  else
+    printf '  ❌ %s —— 期望 exit=%s%s，實得 exit=%s\n' "$desc" "$want" \
+      "${must:+ 且輸出含「$must」}" "$rc"
+    printf '%s\n' "$out" | sed -n '1,8p' | sed 's/^/     /'; FAIL=$((FAIL+1))
+  fi
+}
+
+echo "── B 群：該過 ──────────────────────────────────────────────"
+t 0 "① 兩個 repo 的版本都真的存在 ⇒ 凍結得起來" "已凍結（2 個 repo" -- \
+   freeze R-2026.08.29 --part inkstone/Arcrun@v1.4.51 --part inkstone/arcrun-collector@v0.18.35
+t 0 "② 單一 repo 的交貨不必特例（清單退化成一格）" "已凍結（1 個 repo" -- \
+   freeze R-single --part inkstone/Arcrun@v1.4.51
+t 0 "③ 再凍一份新的（這才是「新的需求進下一版」）" "已凍結（2 個 repo" -- \
+   freeze R-2026.08.30 --part inkstone/Arcrun@v1.4.52 --part inkstone/arcrun-collector@v0.18.36
+t 0 "④ current 答得出「我現在手上是哪一版」" "R-2026.08.30" -- current
+t 0 "⑤ verify：每一格都還抓得到" "全部 2 格都還抓得到" -- verify R-2026.08.30
+t 0 "⑥ diff 看得出兩份差在哪一格" "v1.4.51 → v1.4.52" -- diff R-2026.08.29 R-2026.08.30
+t 0 "⑦ --dry-run 不寫檔" "一個檔都沒有真的寫出去" -- \
+   freeze R-dryrun --part inkstone/Arcrun@v1.4.52 --dry-run
+t 2 "⑧ 承上：--dry-run 那份真的沒被寫出去" "沒有這份清單" -- show R-dryrun
+
+echo "── A 群：該擋 ──────────────────────────────────────────────"
+t 2 "⑨ 版本號在 Gitea 抓不到 ⇒ 不給凍結（驗收 1）" "在 Gitea 上抓不到" -- \
+   freeze R-bad --part inkstone/Arcrun@v9.9.9
+t 2 "⑩ 承上：整份都不寫（不會留下半份清單）" "沒有這份清單" -- show R-bad
+t 2 "⑪ 一格都不給 ⇒ 擋" "至少要有一格" -- freeze R-empty
+t 2 "⑫ 同名清單已凍結 ⇒ 不准再加東西" "新的需求進下一版" -- \
+   freeze R-2026.08.30 --part inkstone/Arcrun@v1.4.51
+t 2 "⑬ 同一個 repo 出現兩次 ⇒ 擋" "出現兩次" -- \
+   freeze R-dup --part inkstone/Arcrun@v1.4.51 --part inkstone/Arcrun@v1.4.52
+t 2 "⑭ 清單名亂寫 ⇒ 擋" "清單名只准" -- freeze "R 2026/08" --part inkstone/Arcrun@v1.4.51
+t 2 "⑮ part 寫法不對 ⇒ 擋" "寫法是 owner/repo@版本號" -- \
+   freeze R-x --part Arcrun-v1.4.52
+
+echo "── 驗收 2／3：退版 ─────────────────────────────────────────"
+t 0 "⑯ 退版吐出整份清單的每一格（驗收 2）" "這 2 格是一組" -- rollback R-2026.08.29
+t 0 "⑰ 承上：兩個 repo 都被列進「要動的」" "arcrun-collector" -- rollback R-2026.08.29
+t 2 "⑱ 試著只退其中一個 ⇒ 被擋下來（驗收 3）" "沒有「只退一個」這個選項" -- \
+   rollback R-2026.08.29 --only inkstone/Arcrun
+t 0 "⑲ 已經在目標版本的那幾格也要列出來（沒有一格被漏掉）" "不必動" -- \
+   rollback R-2026.08.30
+
+echo "── 驗收 4：leo 打開那份清單看得懂 ──────────────────────────"
+N=$((N+1))
+IDX="$TMP/rel/INDEX.md"
+if [ -f "$IDX" ] && grep -q "現在手上的這一版" "$IDX" \
+   && grep -q "R-2026.08.30" "$IDX" && grep -q "從來沒測過的組合" "$IDX"; then
+  printf '  ✅ ⑳ INDEX.md 被重寫，標出「現在手上的這一版」與為什麼要有它\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ⑳ INDEX.md 內容不對\n'; sed -n '1,20p' "$IDX" 2>/dev/null | sed 's/^/     /'
+  FAIL=$((FAIL+1))
+fi
+N=$((N+1))
+if head -20 "$IDX" 2>/dev/null | grep -A2 "R-2026.08.30" | grep -q "現在手上的這一版"; then
+  printf '  ✅ ㉑ 最新那一份（不是最舊那份）才被標成「現在手上的」\n'; PASS=$((PASS+1))
+else
+  printf '  ❌ ㉑ 標錯了哪一份是現在手上的\n'; FAIL=$((FAIL+1))
+fi
+
+echo
+echo "通過 $PASS 條，失敗 $FAIL 條（共 $N 條）"
+[ "$FAIL" -eq 0 ]

scripts/test-ticket-api-bypass-guard.sh

@@ -1,6 +1,8 @@
 #!/bin/bash
 # 開票側門閘的測試（docs/TESTING.md A4）
-# 判準：4 種該擋、8 種不該擋、1 種有戳記時放行 = 13 條
+# 判準：4 種該擋、8 種不該擋、1 種有戳記時放行 = 13 條（v1，仍須全過，不能為了
+# 新案例把舊的改壞）＋ inkstone/ISEP#72 擴大範圍後新增的案例（隱式/小寫 POST、
+# milestone／label／PR、org 端點、Arcrun#100 重演）。
 cd "$(dirname "$0")/.." || exit 1
 H=hooks/ticket-api-bypass-guard.sh
 PASS=0; FAIL=0
@@ -33,8 +35,53 @@ run 0 'curl -s "$API/repos/inkstone/Arcrun/issues?state=open&limit=100"'
 echo "── 有新鮮戳記時放行 ──"
 python3 -c "import json,time;json.dump({'at':time.time(),'n':0,'top':[]},open('/tmp/.ticket-where-ok','w'))"
 run 0 'curl -X POST https://git.uncle6.me/api/v1/repos/inkstone/ISEP/issues'
-
 rm -f /tmp/.ticket-where-ok
+
+echo
+echo "── ISEP#72：2026-08-27 實際撞到的繞法（v1 grep -qw POST 漏掉的），該擋 ──"
+run 2 'url = "https://git.uncle6.me/api/v1/repos/inkstone/ISEP/issues"; req = urllib.request.Request(url, data=json.dumps(payload).encode(), headers=h); urllib.request.urlopen(req)'
+run 2 'python3 -c "requests.post(f\"{API}/repos/{REPO}/issues\", json={\"title\":\"x\"})"'
+
+echo
+echo "── ISEP#72：範圍擴大到 milestone／label／PR，該擋 ──"
+run 2 'curl -X POST https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones -d @m.json'
+run 2 'curl -X POST https://git.uncle6.me/api/v1/repos/inkstone/ISEP/labels -d @l.json'
+run 2 'curl -X POST https://git.uncle6.me/api/v1/repos/inkstone/ISEP/pulls -d @p.json'
+run 2 'curl -X POST https://git.uncle6.me/api/v1/orgs/inkstone/labels -d @l.json'
+
+echo
+echo "── ISEP#72：帶 ID 的 milestone／label／PR 子路徑，不該擋（改狀態／合併，不是新增）──"
+run 0 'curl -X PATCH https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones/3 -d @m.json'
+run 0 'curl -X PATCH https://git.uncle6.me/api/v1/repos/inkstone/ISEP/labels/9 -d @l.json'
+run 0 'curl -X POST https://git.uncle6.me/api/v1/repos/inkstone/ISEP/pulls/12/merge'
+
+echo
+echo "── ISEP#72：有戳記時，milestone／label／PR 也放行（不是只有 issues）──"
+python3 -c "import json,time;json.dump({'at':time.time(),'n':0,'top':[]},open('/tmp/.ticket-where-ok','w'))"
+run 0 'curl -X POST https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones -d @m.json'
+rm -f /tmp/.ticket-where-ok
+
+echo
+echo "── ISEP#72：Arcrun#100 重演——標題撞同主題舊票，擋下來還要點名 ──"
+echo "   （這條打真實 Gitea 網路；離線環境會印 SKIP，不算失敗。標題故意用"
+echo "   裸引號的 python dict 寫法，跟 2026-08-27 那 13 張票實際的寫法一致——"
+echo "   curl -d 那種「JSON 被跳脫成字串塞進另一層引號」的寫法，本閘的猜題功能"
+echo "   刻意不支援，見 hook 檔頭「只認雙引號」那段註解，訊息裡不會列候選舊票，"
+echo "   但擋下來這件事不受影響，另有獨立案例覆蓋。）"
+if git remote -v 2>/dev/null | grep 'git\.uncle6\.me' | grep -q '@'; then
+  OUT=$(printf '%s' "{\"tool_name\":\"Bash\",\"tool_input\":{\"command\":$(python3 -c 'import json,sys;print(json.dumps(sys.argv[1]))' 'req("POST", f"{API}/repos/{REPO}/issues", {"title":"總圖說我一條關聯都沒有，三元組 graph 全部消失"})')}}" \
+    | bash "$H" 2>&1 >/dev/null)
+  RC=$?
+  if [ "$RC" = 2 ] && printf '%s' "$OUT" | grep -q 'Arcrun#100'; then
+    PASS=$((PASS+1)); echo "  ✅ 擋下來（rc=2）且點名 Arcrun#100"
+  else
+    FAIL=$((FAIL+1)); echo "  ❌ rc=$RC，訊息裡有沒有 Arcrun#100："; printf '%s\n' "$OUT" | grep -q 'Arcrun#100' && echo "有" || echo "沒有"
+    printf '%s\n' "$OUT"
+  fi
+else
+  echo "  ⏭️  SKIP（這台機器的 git remote 沒帶 git.uncle6.me 的憑證，連不上就不算數）"
+fi
+
 [ -n "$SAVED" ] && printf '%s' "$SAVED" > /tmp/.ticket-where-ok
 echo
 echo "$PASS/$((PASS+FAIL)) 通過"

scripts/test-ticket-handoff-writeback.sh

@@ -0,0 +1,274 @@
+#!/bin/bash
+# 「下游做完時頂層跟著關」的測試（inkstone/ISEP#92）
+#
+# 這支測三件事：
+#   ① 判準本身（純函式 is_loose／writeback_plan／journey_label）
+#      —— 這三支不打網路，所以「撈得對不對」「回寫該做什麼」測得動，
+#         不必真的開票、關票來驗。
+#   ② `subtask`／`handoff` 的參數閘：該擋的擋、齊全的放得過
+#   ③ `loose` 這個動詞真的接得上（走到網路那一層才炸）
+#
+# 怎麼在「不真的動任何票」的前提下分辨擋／放行（沿用 test-ticket-where-seen-guard.sh）：
+#   TICKET_HOST 指到一個連不上的位址（127.0.0.1:9）
+#     離開碼 2 ＝ 閘擋下（die）
+#     離開碼 1 ＝ 閘全部放行，走到網路那一層才炸（Connection refused）
+# 全程離線、不打真實 Gitea、不產生任何票、不關任何票。
+cd "$(dirname "$0")/.." || exit 1
+T=scripts/ticket
+TMP=$(mktemp -d)
+trap 'rm -rf "$TMP"' EXIT
+PASS=0; FAIL=0
+
+cat > "$TMP/body.md" <<'MD'
+## 目標
+測試用內文。
+
+## 驗收條件
+離開碼 2 ＝ 被擋；離開碼 1 ＝ 放行（走到網路才炸）。
+
+## deliverable 類型
+code
+MD
+BAD_BODY="$TMP/bad.md"; echo "沒有模板欄位" > "$BAD_BODY"
+TITLE="身為看頂層票的人，我要下游做完時頂層跟著關，我才不會看到一堆早就做完的票"
+
+# ── 純函式探針：把 scripts/ticket 當模組載進來問 ────────────────────────
+probe() { # probe <python 片段> → 印出結果
+  python3 - "$1" <<'PY'
+import sys, importlib.util as u
+from importlib.machinery import SourceFileLoader as L
+spec = u.spec_from_loader("t", L("t", "scripts/ticket"))
+m = u.module_from_spec(spec); spec.loader.exec_module(m)
+print(eval(sys.argv[1], {"m": m}))
+PY
+}
+
+p() { # p <說明> <want> <python 片段>
+  got=$(probe "$3" 2>&1)
+  if [ "$got" = "$2" ]; then PASS=$((PASS+1)); printf '  ✅ '; else FAIL=$((FAIL+1)); printf '  ❌ '; fi
+  printf 'want=%s got=%s  %s\n' "$2" "$got" "$1"
+}
+
+O='{"state":"open"}'; C='{"state":"closed"}'
+
+echo "── ① is_loose：「下游都關了、自己還開著」是機械事實 ──"
+p "★ open ＋ 下游全關 → 撈得到（票上驗收第 3 條）" "True"  "m.is_loose('open',[$C,$C])"
+p "open ＋ 還有一張下游開著 → 不撈（它還在跑）"      "False" "m.is_loose('open',[$C,$O])"
+p "open ＋ 從來沒有下游 → 不撈（它根本不是頂層票）"  "False" "m.is_loose('open',[])"
+p "closed ＋ 下游全關 → 不撈（自己都關了）"          "False" "m.is_loose('closed',[$C,$C])"
+p "open ＋ 下游全開 → 不撈"                          "False" "m.is_loose('open',[$O,$O])"
+
+echo
+echo "── ② writeback_plan：下游關掉之後，頂層票該被怎麼處理 ──"
+p "★ 最後一張下游關掉 → handback（指派回總管＋s/review，不默默留著）" \
+  "('handback', [])" "m.writeback_plan('open',[$C,$C])"
+p "還有別的下游沒關 → 只記一筆，別假裝它可以收了" \
+  "('note', [{'state': 'open'}])" "m.writeback_plan('open',[$C,$O])"
+p "頂層票自己已經關了 → skip" \
+  "('skip', [])" "m.writeback_plan('closed',[$C,$C])"
+p "頂層票已關但還有 open 下游 → 一樣 skip（不去吵已關的票）" \
+  "('skip', [{'state': 'open'}])" "m.writeback_plan('closed',[$O])"
+p "防禦：頂層票沒有任何下游（實務上到不了這裡）→ 不會炸" \
+  "('handback', [])" "m.writeback_plan('open',[])"
+
+echo
+echo "── ③ journey_label：只加前綴，不猜名字合不合法 ──"
+p "收件匣 → j/收件匣"           "j/收件匣" "m.journey_label('收件匣')"
+p "已經帶前綴 → 不重複加"       "j/收件匣" "m.journey_label('j/收件匣')"
+p "前後空白 → 修掉"             "j/收件匣" "m.journey_label('  收件匣 ')"
+
+echo
+echo "── ④ subtask／handoff 的參數閘（該擋）──"
+run() { # run <want_rc> <說明> <verb> [參數...]
+  want=$1; what=$2; verb=$3; shift 3
+  out=$(TICKET_HOST=http://127.0.0.1:9 GITEA_TOKEN=x \
+        python3 "$T" "$verb" inkstone/ISEP#92 "$@" 2>&1)
+  got=$?
+  LAST_OUT="$out"
+  if [ "$got" = "$want" ]; then PASS=$((PASS+1)); printf '  ✅ '; else FAIL=$((FAIL+1)); printf '  ❌ '; fi
+  printf 'want=%s got=%s  %s\n' "$want" "$got" "$what"
+}
+has() { if printf '%s' "$LAST_OUT" | grep -q "$1"; then PASS=$((PASS+1)); printf '  ✅ '
+        else FAIL=$((FAIL+1)); printf '  ❌ '; fi; printf '訊息裡有「%s」  %s\n' "$1" "$2"; }
+
+run 2 "缺 --title" subtask -F "$TMP/body.md"
+run 2 "缺 -F" subtask --title "$TITLE"
+run 2 "標題不是 User Story" subtask --title "整理一下票" -F "$TMP/body.md"
+run 2 "內文缺模板欄位" subtask --title "$TITLE" -F "$BAD_BODY"
+run 2 "指派了人卻沒寫 --next" subtask --title "$TITLE" -F "$TMP/body.md" --assign someone
+run 2 "--journey 給了空字串（對不上就不要加這個參數）" \
+      subtask --title "$TITLE" -F "$TMP/body.md" --journey ""
+has "不硬湊" "空 journey 的訊息講的是「不硬湊」，不是叫人隨便填一個"
+
+echo
+echo "── ⑤ 齊全就放得過（誤攔比漏擋更該修）──"
+run 1 "subtask 齊全 → 走到網路才炸" subtask --title "$TITLE" -F "$TMP/body.md"
+run 1 "★ handoff 是同一個動作的別名，一樣放得過" handoff --title "$TITLE" -F "$TMP/body.md" --to arcrun-rag
+run 1 "帶 --journey 一樣放得過" subtask --title "$TITLE" -F "$TMP/body.md" --journey 收件匣
+run 1 "--assign 有配 --next → 放行" subtask --title "$TITLE" -F "$TMP/body.md" --assign someone --next "先看一眼"
+
+echo
+echo "── ⑥ loose 這個動詞接得上 ──"
+out=$(TICKET_HOST=http://127.0.0.1:9 GITEA_TOKEN=x python3 "$T" loose 2>&1); got=$?
+if [ "$got" = 1 ]; then PASS=$((PASS+1)); printf '  ✅ '; else FAIL=$((FAIL+1)); printf '  ❌ '; fi
+printf 'want=1 got=%s  loose 走到網路那一層才炸（動詞有註冊、參數不擋）\n' "$got"
+
+out=$(python3 "$T" 2>&1)
+if printf '%s' "$out" | grep -q "ticket loose"; then PASS=$((PASS+1)); printf '  ✅ '
+else FAIL=$((FAIL+1)); printf '  ❌ '; fi
+printf '不帶參數的說明裡列得出 loose（撈不到的東西等於不存在）\n'
+
+echo
+echo "── ⑦ 完工回寫的接線（票上驗收第 2 條）──"
+echo "     把 api() 換成錄音機跑一次 _writeback，驗它到底打了哪些端點、送了什麼。"
+echo "     不打網路、不動任何真票；/blocks 的回應形狀取自 2026-08-28 實查 inkstone/ISEP#75。"
+w() { # w <說明> <want> <python 片段（用 rec 這個錄音清單）>
+  got=$(python3 - "$3" <<'PY' 2>&1
+import sys, json, importlib.util as u
+from importlib.machinery import SourceFileLoader as L
+spec = u.spec_from_loader("t", L("t", "scripts/ticket"))
+m = u.module_from_spec(spec); spec.loader.exec_module(m)
+
+SCEN = json.loads(__import__("os").environ["SCEN"])
+rec = []
+def fake_api(path, payload=None, method=None):
+    rec.append((method or ("POST" if payload is not None else "GET"), path, payload))
+    if path.endswith("/blocks"):
+        return SCEN["blocks"]
+    if path.endswith("/dependencies"):
+        return SCEN["deps"]
+    if "/labels" in path and (method or "GET") == "GET":
+        return [{"name": n, "id": i} for i, n in enumerate(SCEN.get("labels", []), 1)]
+    return {}
+m.api = fake_api
+# _writeback 會把進度印出來——那是給人看的，不是這支測試的判準。
+# 判準是**它打了哪些端點、送了什麼**（rec），所以把它的輸出吞掉。
+import contextlib, io
+buf = io.StringIO()
+with contextlib.redirect_stdout(buf), contextlib.redirect_stderr(buf):
+    m._writeback("inkstone", "arcrun-rag", 143, "https://example/pr/1")
+print(eval(sys.argv[1], {"rec": rec, "m": m}))
+PY
+)
+  if [ "$got" = "$2" ]; then PASS=$((PASS+1)); printf '  ✅ '; else FAIL=$((FAIL+1)); printf '  ❌ '; fi
+  printf 'want=%s got=%s  %s\n' "$2" "$got" "$1"
+}
+
+PARENT='{"number":136,"state":"open","title":"頂層票","labels":[{"name":"s/doing"},{"name":"p/high"}],"repository":{"full_name":"inkstone/arcrun-rag"}}'
+LBL='["s/todo","s/doing","s/review","p/high"]'
+
+# 情境 A：這是最後一張下游 → 母票要被指派回總管＋改 s/review
+export SCEN="{\"blocks\":[$PARENT],\"deps\":[{\"state\":\"closed\",\"number\":143,\"title\":\"x\",\"repository\":{\"full_name\":\"inkstone/arcrun-rag\"}}],\"labels\":$LBL}"
+w "★ 有去問子票的 /blocks（誰在等我）" "True" \
+  "any(p.endswith('/issues/143/blocks') for _,p,_ in rec)"
+w "★ 有在母票的時間軸貼回寫留言" "True" \
+  "any(mm=='POST' and p=='/repos/inkstone/arcrun-rag/issues/136/comments' for mm,p,_ in rec)"
+w "★ 留言裡點名了剛關掉的那張下游票" "True" \
+  "any('arcrun-rag#143' in (pl or {}).get('body','') for _,p,pl in rec if p.endswith('/136/comments'))"
+w "★ 留言裡有交付物連結（不是空口說做完了）" "True" \
+  "any('https://example/pr/1' in (pl or {}).get('body','') for _,p,pl in rec if p.endswith('/136/comments'))"
+w "★ 留言第一行有身份欄（機器貼的留言一樣要標）" "True" \
+  "all((pl or {}).get('body','').startswith('【身份】') for _,p,pl in rec if p.endswith('/136/comments'))"
+w "★ 母票被指派回總管（欄位，不是一句話）" "['claude-code']" \
+  "[(pl or {}).get('assignees') for mm,p,pl in rec if mm=='PATCH' and p=='/repos/inkstone/arcrun-rag/issues/136'][0]"
+w "★ 母票的 s/* 換成 s/review，而非 s/* 的標籤留著" "True" \
+  "[sorted(pl['labels'])==sorted([3,4]) for mm,p,pl in rec if mm=='PUT' and p.endswith('/136/labels')][0]"
+w "沒有去關母票（關票要有人驗——默默關掉跟默默留著是同一個病）" "False" \
+  "any((pl or {}).get('state')=='closed' for _,_,pl in rec)"
+
+# 情境 B：母票還有別的下游沒關 → 只記一筆，不准指派、不准改 tag
+export SCEN="{\"blocks\":[$PARENT],\"deps\":[{\"state\":\"closed\",\"number\":143,\"title\":\"x\",\"repository\":{\"full_name\":\"inkstone/arcrun-rag\"}},{\"state\":\"open\",\"number\":150,\"title\":\"還沒做的\",\"repository\":{\"full_name\":\"inkstone/Arcrun\"}}],\"labels\":$LBL}"
+w "還有下游沒關 → 只貼留言，不指派" "False" "any(mm=='PATCH' for mm,_,_ in rec)"
+w "還有下游沒關 → 不改 tag" "False" "any(mm=='PUT' for mm,_,_ in rec)"
+w "留言裡把還沒關的那張列出來（跨 repo 也要列全稱）" "True" \
+  "any('inkstone/Arcrun#150' in (pl or {}).get('body','') for _,p,pl in rec if p.endswith('/136/comments'))"
+
+# 情境 C：母票自己已經關了 → 完全不動它
+PARENT_CLOSED='{"number":136,"state":"closed","title":"頂層票","labels":[],"repository":{"full_name":"inkstone/arcrun-rag"}}'
+export SCEN="{\"blocks\":[$PARENT_CLOSED],\"deps\":[{\"state\":\"closed\",\"number\":143,\"title\":\"x\",\"repository\":{\"full_name\":\"inkstone/arcrun-rag\"}}],\"labels\":$LBL}"
+w "母票已關 → 一則留言都不貼（不去吵已關的票）" "False" \
+  "any(p.endswith('/136/comments') for _,p,_ in rec)"
+
+# 情境 D：這張票沒有任何頂層票在等它 → 不要吵
+export SCEN="{\"blocks\":[],\"deps\":[],\"labels\":$LBL}"
+w "沒有頂層票在等它 → 只問一次 /blocks 就收工" "1" "len(rec)"
+unset SCEN
+
+echo
+echo "── ⑧ 雙向連結的接線（票上驗收第 1 條）──"
+echo "     同樣用錄音機跑一次 subtask：驗「兩張票互相看得到對方」不是靠人記得補。"
+b() { # b <說明> <want> <python 片段> [額外 argv...]
+  what=$1; want=$2; frag=$3; shift 3
+  got=$(ARGS_JSON=$(printf '%s\n' "$@" | python3 -c "import sys,json;print(json.dumps([l.rstrip('\n') for l in sys.stdin if l.strip()!='']))") \
+        python3 - "$frag" <<'PY' 2>&1
+import sys, os, json, contextlib, io, importlib.util as u
+from importlib.machinery import SourceFileLoader as L
+spec = u.spec_from_loader("t", L("t", "scripts/ticket"))
+m = u.module_from_spec(spec); spec.loader.exec_module(m)
+
+rec = []
+def fake_api(path, payload=None, method=None):
+    rec.append((method or ("POST" if payload is not None else "GET"), path, payload))
+    if path.endswith("/labels?limit=100"):
+        return [{"name": n, "id": i} for i, n in
+                enumerate(["s/todo", "s/review", "p/high", "j/收件匣"], 1)]
+    if path.endswith("/dependencies"):
+        return [{"state": "open", "number": 900, "title": "子票",
+                 "repository": {"full_name": "inkstone/arcrun-rag"}}]
+    if path == "/repos/inkstone/ISEP/issues":
+        return {"number": 900, "html_url": "https://git.uncle6.me/inkstone/ISEP/issues/900"}
+    if path == "/repos/inkstone/arcrun-rag/issues":
+        return {"number": 900, "html_url": "https://git.uncle6.me/inkstone/arcrun-rag/issues/900"}
+    if path == "/repos/inkstone/ISEP/issues/92":
+        return {"number": 92, "labels": [{"name": "p/high"}]}
+    return {}
+m.api = fake_api
+argv = ["inkstone/ISEP#92"] + json.loads(os.environ["ARGS_JSON"])
+buf = io.StringIO()
+blocked = False
+with contextlib.redirect_stdout(buf), contextlib.redirect_stderr(buf):
+    try:
+        m.cmd_subtask(argv)
+    except SystemExit:
+        blocked = True        # 被閘擋下也是一種結果，不該讓整支測試靜靜掛掉
+print(eval(sys.argv[1], {"rec": rec, "m": m, "blocked": blocked, "buf": buf.getvalue()}))
+PY
+)
+  if [ "$got" = "$want" ]; then PASS=$((PASS+1)); printf '  ✅ '; else FAIL=$((FAIL+1)); printf '  ❌ '; fi
+  printf 'want=%s got=%s  %s\n' "$want" "$got" "$what"
+}
+
+A_BASE=(--title "$TITLE" -F "$TMP/body.md" --to arcrun-rag)
+
+b "★ 子票內文寫著它的頂層票是誰（下游看得到上游）" "True" \
+  "any('Parent: inkstone/ISEP#92' in (pl or {}).get('body','') for mm,p,pl in rec if p=='/repos/inkstone/arcrun-rag/issues')" \
+  "${A_BASE[@]}"
+b "★ 有掛上 Gitea 原生相依（不是只寫在內文裡）" "True" \
+  "any(mm=='POST' and p=='/repos/inkstone/ISEP/issues/92/dependencies' for mm,p,pl in rec)" \
+  "${A_BASE[@]}"
+b "★ 頂層票的時間軸上有一則指向下游的留言（上游看得到下游）" "True" \
+  "any('inkstone/arcrun-rag#900' in (pl or {}).get('body','') for mm,p,pl in rec if p=='/repos/inkstone/ISEP/issues/92/comments')" \
+  "${A_BASE[@]}"
+b "★ 那則留言明講「不會因為轉出去就自動關」（第 2 條的預告）" "True" \
+  "any('不會因為轉出去就自動關' in (pl or {}).get('body','') for mm,p,pl in rec if p=='/repos/inkstone/ISEP/issues/92/comments')" \
+  "${A_BASE[@]}"
+b "沒給 --journey → 留言裡誠實寫「沒有貼」（不硬湊，也不假裝有）" "True" \
+  "any('沒有貼' in (pl or {}).get('body','') for mm,p,pl in rec if p=='/repos/inkstone/ISEP/issues/92/comments')" \
+  "${A_BASE[@]}"
+b "沒給 --journey → 不去動任何一端的標籤軸（只設子票的 s/*）" "1" \
+  "len([1 for mm,p,pl in rec if mm=='PUT' and p.endswith('/labels')])" \
+  "${A_BASE[@]}"
+b "★ 給了 --journey → 母子兩端都被貼（只貼一端就聚不起來）" "2" \
+  "len([1 for mm,p,pl in rec if mm=='PUT' and p.endswith('/labels') and 4 in pl['labels']])" \
+  "${A_BASE[@]}" --journey 收件匣
+b "★ 貼在頂層票上時保留它原本的標籤（不是整組蓋掉）" "True" \
+  "any(mm=='PUT' and p=='/repos/inkstone/ISEP/issues/92/labels' and sorted(pl['labels'])==[3,4] for mm,p,pl in rec)" \
+  "${A_BASE[@]}" --journey 收件匣
+b "labels.yaml 沒有的旅程名 → 擋下來（要求標籤在場，不是猜名字合不合法）" "True" \
+  "blocked" "${A_BASE[@]}" --journey 沒這條旅程
+b "擋下來時直接指回 labels.yaml（不叫人自己猜怎麼修）" "True" \
+  "'labels.yaml' in buf" "${A_BASE[@]}" --journey 沒這條旅程
+
+echo
+echo "通過 $PASS 條，失敗 $FAIL 條"
+[ "$FAIL" = 0 ] || exit 1

scripts/test-ticket-where-seen-guard.sh

@@ -0,0 +1,116 @@
+#!/bin/bash
+# 「戳記要證明看過，不是跑過」的測試（inkstone/ISEP#72 → comment 4873）
+#
+# 這支測的是 scripts/ticket 的閘一之二：搜尋跑了，但輸出被丟進 /dev/null 時，
+# `ticket new` 要擋下來，並把那份被丟掉的候選清單交到眼前。
+#
+# 怎麼在「不真的開票」的前提下分辨擋／放行：
+#   TICKET_HOST 指到一個連不上的位址（127.0.0.1:9）
+#     離開碼 2 ＝ 閘擋下（die）
+#     離開碼 1 ＝ 閘全部放行，走到網路那一層才炸（Connection refused）
+# 全程離線、不打真實 Gitea、不產生任何票。
+cd "$(dirname "$0")/.." || exit 1
+T=scripts/ticket
+STAMP=/tmp/.ticket-where-ok
+TMP=$(mktemp -d)
+trap 'rm -rf "$TMP"' EXIT
+PASS=0; FAIL=0
+
+SAVED=""; [ -f "$STAMP" ] && SAVED=$(cat "$STAMP")
+rm -f "$STAMP"
+
+cat > "$TMP/body.md" <<'MD'
+## 目標
+測試用內文。
+
+## 驗收條件
+離開碼 2 ＝ 被擋；離開碼 1 ＝ 放行（走到網路才炸）。
+
+## deliverable 類型
+code
+MD
+TITLE="身為要開票的人，我要先看過命中的舊票，我才不會又開一張一樣的"
+
+# stamp <n> <shown|none> <age_sec>
+stamp() {
+  python3 - "$1" "$2" "$3" <<'PY'
+import json, sys, time
+n, shown, age = int(sys.argv[1]), sys.argv[2], float(sys.argv[3])
+st = {"at": time.time() - age, "kws": ["ingest", "queue"], "n": n,
+      "top": ["inkstone/arcrun-rag#104"],
+      "top_detail": [{"ref": "inkstone/arcrun-rag#104", "score": 2,
+                      "title": "它把我整個 repo 的一萬多個檔案排進佇列",
+                      "labels": ["Human"],
+                      "excerpt": "這些庫都早就萃好了，所以它要辨識這個庫已經有 wiki"}]}
+if shown != "none":
+    st["shown"] = (shown == "true")
+json.dump(st, open("/tmp/.ticket-where-ok", "w"))
+PY
+}
+
+# run <want_rc> <說明> [額外參數...]
+run() {
+  want=$1; what=$2; shift 2
+  out=$(TICKET_HOST=http://127.0.0.1:9 GITEA_TOKEN=x \
+        python3 "$T" new ISEP -F "$TMP/body.md" --title "$TITLE" "$@" 2>&1)
+  got=$?
+  LAST_OUT="$out"
+  if [ "$got" = "$want" ]; then PASS=$((PASS+1)); printf '  ✅ '; else FAIL=$((FAIL+1)); printf '  ❌ '; fi
+  printf 'want=%s got=%s  %s\n' "$want" "$got" "$what"
+}
+
+has() { # has <字串> <說明>
+  if printf '%s' "$LAST_OUT" | grep -q "$1"; then PASS=$((PASS+1)); printf '  ✅ '
+  else FAIL=$((FAIL+1)); printf '  ❌ '; fi
+  printf '訊息裡有「%s」  %s\n' "$1" "$2"
+}
+
+echo "── 該擋 ──"
+rm -f "$STAMP"
+run 2 "完全沒搜過（既有閘一，回歸）"
+stamp 3 true 3600
+run 2 "戳記過期（既有閘一，回歸）"
+stamp 72 false 10
+run 2 "★ 今天的重演：where 的輸出被丟進 /dev/null，命中 72 張一眼沒看"
+has "沒有到任何人眼前" "擋下的理由講的是「沒看」不是「沒搜」"
+has "arcrun-rag#104" "擋下的訊息把被丟掉的候選清單交到眼前"
+has "這些庫都早就萃好了" "連內文摘要都給了（光看標題看不出是同一條線）"
+stamp 72 false 10
+run 2 "★ 閉著眼睛先寫好理由也繞不過（--not-a-comment 在前面就被擋）" --not-a-comment "這是新的一條線"
+stamp 72 none 10
+run 2 "舊格式戳記（沒有 shown 欄位）→ fail-closed，當成沒看過" --not-a-comment "x"
+stamp 72 true 10
+run 2 "命中卻沒給理由（既有閘二，回歸）"
+
+echo
+echo "── 不該擋（誤攔比漏擋更該修）──"
+stamp 72 true 10
+run 1 "看過了、也給了理由 → 放行（走到網路才炸）" --not-a-comment "這是新的一條線"
+stamp 0 false 10
+run 1 "沒有命中任何票 → 沒東西可看，不要吵"
+stamp 0 none 10
+run 1 "沒命中 ＋ 舊格式戳記 → 一樣不吵"
+
+echo
+echo "── 擋完之後：那一次的擋本身就是「把清單交到眼前」 ──"
+stamp 72 false 10
+run 2 "第一次：被擋" --not-a-comment "這是新的一條線"
+run 1 "第二次下一模一樣的指令 → 放行（不必多打任何字）" --not-a-comment "這是新的一條線"
+
+echo
+echo "── fd_is_devnull：判準是 fstat 問出來的事實，不是猜文字 ──"
+u() { # u <want> <說明> <shell 片段>
+  got=$(eval "$3")
+  if [ "$got" = "$2" ]; then PASS=$((PASS+1)); printf '  ✅ '; else FAIL=$((FAIL+1)); printf '  ❌ '; fi
+  printf 'want=%s got=%s  %s\n' "$2" "$got" "$1"
+}
+PROBE="import importlib.util as u,sys; from importlib.machinery import SourceFileLoader as L; s=u.spec_from_loader('t',L('t','scripts/ticket')); m=u.module_from_spec(s); s.loader.exec_module(m); print(m.fd_is_devnull(1), file=sys.stderr)"
+u "stdout 丟進 /dev/null → True" "True" "python3 -c \"\$PROBE\" >/dev/null 2>&1; python3 -c \"\$PROBE\" 2>&1 >/dev/null"
+u "stdout 接到 pipe（Claude Code 就是這種）→ False" "False" "python3 -c \"\$PROBE\" 2>&1 | cat"
+u "stdout 寫進一般檔案（讀得回來）→ False" "False" "python3 -c \"\$PROBE\" 2>&1 >\"$TMP/o.txt\""
+
+rm -f "$STAMP"
+[ -n "$SAVED" ] && printf '%s' "$SAVED" > "$STAMP"
+echo
+echo "通過 $PASS 條，失敗 $FAIL 條"
+[ "$FAIL" = 0 ] || exit 1

scripts/ticket

@@ -18,11 +18,20 @@ leo 2026-08-16 三句話，本工具就是它們的機械化：
     ticket close <票> --deliverable <URL>   關票（要有交付物連結）
     ticket decide <票> -F <答案檔>          記 leo 的裁決＋改狀態（同一個動作）
 
+三個 Gitea 原生欄位（leo 2026-08-27「這些全部都要」，缺一個就會掉棒）：
+
+    ticket subtask <母票> --title <US> -F <檔>   討論串裡的一件事 → 看得見的子票＋相依
+    ticket handoff <頂層票> --to <repo> …         同一個動作，換個名字：頂層 → 下游 repo
+    ticket handback <票> --to <誰> --next <一句>  收工＝指派＋改 tag＋寫下一步，一個動作
+    ticket mine [--user <誰>]                     撈一次：棒子在誰手上、每根下一步是什麼
+    ticket loose                                  撈一次：下游都關了、自己還開著的頂層票
+
 票的寫法：`owner/repo#N`，例：`inkstone/InkStoneCo#44`
 """
 import json
 import os
 import re
+import stat
 import subprocess
 import sys
 import time
@@ -30,7 +39,44 @@ import urllib.error
 import urllib.parse
 import urllib.request
 
-HOST = "https://git.uncle6.me"
+# ── 身份欄：與 hooks/lib/dispatch_parse.py 共用同一份定義 ──────────────────
+#   leo 2026-08-27：「**subagent 回覆時要表明身份**」
+#   實害（同日）：多條線並行，票上的留言看不出是誰寫的，
+#   **總管寫的診斷被當成 subagent 的結論，而其中一則是錯的**。
+#   規約與側門閘見 docs/governance/dispatch-and-reply-format.md §3。
+sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "hooks", "lib"))
+try:
+    from dispatch_parse import parse_identity, IDENTITY_ROLES
+except Exception:      # 拿不到共用零件就不擋（fail-open）——開票的路不該被一個 import 卡死
+    parse_identity, IDENTITY_ROLES = None, ("總管", "subagent", "leo")
+
+
+def check_identity(body, what):
+    """貼進票的內文第一行要表明身份。**在打任何 API 之前就擋**，所以離線測得動。"""
+    if parse_identity is None:
+        return
+    ok, detail = parse_identity(body)
+    if ok:
+        return
+    die(f"""🚫 {what}的第一行要表明身份（leo 2026-08-27：「**subagent 回覆時要表明身份**」）
+
+  現在的問題：{detail}
+
+第一行照這個寫（角色三選一：{'／'.join(IDENTITY_ROLES)}）：
+
+    【身份】subagent／inkstone/ISEP／feat/my-branch
+    【身份】總管／inkstone/InkStoneCo／-
+
+**這條管所有人，不是只管 subagent。** 總管寫在票上的東西同樣要標。
+實害（2026-08-27）：多條線並行時票上看不出誰寫的，
+總管寫的診斷被當成 subagent 的結論，而其中一則是錯的。
+
+規約全文：docs/governance/dispatch-and-reply-format.md §3""")
+
+
+# TICKET_HOST 只給測試用（指到一個連不上的位址，就能在不真的開票的前提下
+# 驗「閘放行了沒」——閘擋下＝離開碼 2 且有 🚫；閘放行＝走到網路那一層才炸）。
+HOST = os.environ.get("TICKET_HOST") or "https://git.uncle6.me"
 ORG = "inkstone"
 STAMP_DIR = "/tmp"
 STAMP_TTL = 30 * 60  # 戳記 30 分鐘失效——搜過就要趁記憶還熱的時候開
@@ -97,10 +143,65 @@ def parse_ref(s):
     return m.group(1), m.group(2), int(m.group(3))
 
 
+def api_soft(path):
+    """讀一筆，失敗就回 None（不 die）。給「錦上添花」的資訊用，不影響任何判斷。"""
+    try:
+        url = f"{HOST}/api/v1{path}"
+        req = urllib.request.Request(
+            url, headers={"Authorization": f"token {token()}"})
+        return json.load(urllib.request.urlopen(req, timeout=20))
+    except SystemExit:
+        raise
+    except Exception:
+        return None
+
+
 def stamp_path():
     return os.path.join(STAMP_DIR, ".ticket-where-ok")
 
 
+# ── 「跑過」與「看過」的分界（inkstone/ISEP#72 → comment 4873）────────────
+#
+# 2026-08-27 實錯（本段的來由，leo 當場點破）：
+#     python3 scripts/ticket where 卡片 沒上雲 收檔 佇列 送達 ingest >/dev/null 2>&1
+#     python3 scripts/ticket new arcrun-rag -F … --title "…"   → ✅ #147 已開
+# 而重跑同一個搜尋、這次看輸出：**第一名就是 arcrun-rag#104**，同一件事，開了 13 天。
+#
+# ⇒ 舊戳記證明的是「這個程序被執行過」，不是「這個人看過結果」。
+#   而「有沒有看」在 stdout 那一端——閘本來完全碰不到。
+#
+# 這支函式就是把那一端變成**機械事實**：一個 fd 是不是 /dev/null，
+# 是 fstat 問得出來的，不是對文字的猜測（本 repo 心法第 1 條：封動作不封文字）。
+#
+# 🔴 刻意只認 /dev/null 這一種，不擴大到「重導到檔案」「接到 pipe」：
+#    寫進檔案還讀得回來、接進 pipe 還有下游，只有 /dev/null 是**物理上找不回來**。
+#    多認一種都會開始誤攔（心法第 2 條：永遠在響的警報等於沒有警報）。
+def fd_is_devnull(fd):
+    try:
+        s = os.fstat(fd)
+        if not stat.S_ISCHR(s.st_mode):
+            return False        # 一般檔案／pipe／socket：內容至少送到了讀得回來的地方
+        return s.st_rdev == os.stat(os.devnull).st_rdev
+    except Exception:
+        return True             # 問不出來就當「沒被看見」——閘不准因為內部錯誤靜默放行
+
+
+def excerpt(body, n=220):
+    t = re.sub(r"\s+", " ", body or "").strip()
+    return (t[:n] + "…") if len(t) > n else (t or "（沒有內文）")
+
+
+def candidate_lines(detail):
+    """把候選票印成同一個樣子——`where` 印它，`new` 擋下來時也印它（同一份東西）。"""
+    out = []
+    for d in detail:
+        out.append(f"  [{d.get('score', '?')}] {d['ref']}  {d.get('labels', [])}")
+        out.append(f"       {(d.get('title') or '')[:70]}")
+        if d.get("excerpt"):
+            out.append(f"       ↳ {d['excerpt'][:170]}")
+    return out
+
+
 # ── where ────────────────────────────────────────────────────────────────
 def cmd_where(argv):
     if not argv:
@@ -117,18 +218,39 @@ def cmd_where(argv):
             seen[ref] = {"score": 1, "it": it}
     hits = sorted(seen.values(), key=lambda x: -x["score"])
 
+    detail = []
+    for h in hits[:12]:
+        it = h["it"]
+        detail.append({"ref": it["repository"]["full_name"] + "#" + str(it["number"]),
+                       "score": h["score"], "title": it["title"] or "",
+                       "labels": [l["name"] for l in it.get("labels", [])]})
+
+    # 前 3 名補內文摘要。2026-08-27 的實害正是「光看標題看不出是同一條線」：
+    # arcrun-rag#104 的標題是「它把我整個 repo 的一萬多個檔案排進佇列」，
+    # 而它票頭第一段講的就是「這些庫都早就萃好了…直接 ingest」——同一件事。
+    # 拿不到就安靜跳過（純加分，不影響任何判斷）。
+    for d in detail[:3]:
+        o, r, n = parse_ref(d["ref"])
+        got = api_soft(f"/repos/{o}/{r}/issues/{n}")
+        if got:
+            d["excerpt"] = excerpt(got.get("body"))
+
     print(f"🔍 搜尋：{' '.join(kws)}　→ 命中 {len(hits)} 張 open 票\n")
     if not hits:
         print("  （沒有命中——換幾個講法再試一次。真的沒有，才輪到開新票）")
-    for h in hits[:12]:
-        it, labels = h["it"], [l["name"] for l in h["it"].get("labels", [])]
-        print(f"  [{h['score']}] {it['repository']['full_name']}#{it['number']}  {labels}")
-        print(f"       {it['title'][:70]}")
+    for line in candidate_lines(detail):
+        print(line)
 
+    # 🔴 這行是本閘的全部：輸出有沒有可能到得了人眼前，是 fstat 問得出來的事實。
+    shown = not fd_is_devnull(1)
     with open(stamp_path(), "w") as f:
-        json.dump({"at": time.time(), "kws": kws, "n": len(hits),
-                   "top": [h["it"]["repository"]["full_name"] + "#" + str(h["it"]["number"])
-                           for h in hits[:12]]}, f)
+        json.dump({"at": time.time(), "kws": kws, "n": len(hits), "shown": shown,
+                   "top": [d["ref"] for d in detail], "top_detail": detail}, f)
+    if not shown:
+        # stdout 被丟進 /dev/null。訊息改走 stderr（它常常還活著）；
+        # 就算兩邊都被丟掉也沒關係——戳記已經記下 shown=false，`new` 那端會擋。
+        print("\n⚠️ 這次搜尋的輸出被丟進 /dev/null，等於沒有人看過。"
+              "\n   `ticket new` 會擋下來並把上面這份清單再交到你眼前一次。", file=sys.stderr)
 
     print(f"""
 ── 決定要做什麼 ───────────────────────────────────────────────
@@ -148,6 +270,7 @@ def cmd_say(argv):
         die("用法：ticket say <owner/repo#N> -F <內文檔>")
     owner, repo, num = parse_ref(argv[0])
     body = open(argv[2]).read()
+    check_identity(body, "貼進票的留言")
     c = api(f"/repos/{owner}/{repo}/issues/{num}/comments", {"body": body})
     print(f"✅ 已貼進 {owner}/{repo}#{num}")
     print(f"   定址：{owner}/{repo}#{num}#issuecomment-{c['id']}")
@@ -179,9 +302,47 @@ leo 原話：「**寫開票前先去搜尋要開在哪裡，不然你永遠會
     if time.time() - st["at"] > STAMP_TTL:
         die(f"🚫 搜尋戳記已過期（超過 {STAMP_TTL // 60} 分鐘）。重跑一次 ticket where")
 
+    # 閘一之二：搜尋的結果**到得了人眼前**了沒（inkstone/ISEP#72 → comment 4873）
+    #
+    # 🔴 這道閘要擋的不是「沒搜」，是「搜了但沒看」——今天實犯：
+    #    `ticket where … >/dev/null 2>&1` 之後直接 `new`，命中的 72 張一眼都沒看，
+    #    而第一名 arcrun-rag#104 就是同一件事（開了 13 天）。
+    #
+    # ⚠️ 這一段刻意放在閘二**之前**：否則第一次就帶 `--not-a-comment "理由"`
+    #    的人永遠不會看到候選清單——理由是閉著眼睛寫的，那道閘等於沒有。
+    #
+    # 成本落在「看」不落在「寫」：擋下來的訊息**本身就是那份被丟掉的輸出**，
+    # 看完重下同一個指令就會過。不要求多打任何一個字，也不判斷理由寫得好不好
+    # （leo 2026-08-17 已證偽文字層判準：8 次誤攔、0 次正確攔截）。
+    if st["n"] > 0 and not st.get("shown"):
+        lines = candidate_lines(st.get("top_detail") or []) or \
+            ["  " + r for r in (st.get("top") or [])]
+        # 只要 stderr 不是 /dev/null，這一次的擋就已經把清單交到眼前了 → 記進戳記。
+        # 兩邊都被丟掉時**不記**（fail-closed）：下次還是擋，不會靜默放行。
+        if not fd_is_devnull(2):
+            st["shown"] = True
+            with open(stamp_path(), "w") as f:
+                json.dump(st, f)
+        die("""🚫 搜尋跑過了，但那份輸出沒有到任何人眼前（stdout 是 /dev/null）。
+
+leo 2026-08-27：「**同一個 session 開兩個一樣的任務就算了，新開票沒搜尋就隨便動手開**」
+實錯（同日）：`ticket where … >/dev/null` → 開出 arcrun-rag#147，
+而命中的第一名 arcrun-rag#104 講的就是同一件事，已經開了 13 天。
+
+⇒ **戳記證明的是「這個程序被執行過」，不是「這個人看過結果」。**
+
+命中的 {n} 張，前幾張在這裡——這就是剛才被丟掉的那一份：
+
+{lines}
+
+看完覺得真的都不是同一條線 → **重下一次一模一樣的指令就會過**，不必多打任何字。
+（判準是「輸出有沒有進得了 /dev/null 以外的地方」，不看你寫了什麼理由。）""".format(
+            n=st["n"], lines="\n".join(lines)))
+
     # 閘二：搜到了東西，就要說明為什麼不是貼進去
     if st["n"] > 0 and "--not-a-comment" not in argv:
-        top = "\n".join("     " + t for t in st["top"][:8])
+        top = "\n".join(candidate_lines((st.get("top_detail") or [])[:8])) or \
+            "\n".join("     " + t for t in st["top"][:8])
         die(f"""🚫 剛才那次搜尋命中 {st['n']} 張 open 票，你卻要開新的。
 
 命中的前幾張：
@@ -293,10 +454,87 @@ def cmd_close(argv):
 
     if deliv:
         api(f"/repos/{owner}/{repo}/issues/{num}/comments",
-            {"body": f"✅ 結案。交付物：{deliv}"})
+            {"body": f"{_identity(owner, repo)}\n\n✅ 結案。交付物：{deliv}"})
     api(f"/repos/{owner}/{repo}/issues/{num}", {"state": "closed"}, method="PATCH")
     print(f"✅ {owner}/{repo}#{num} 已關（交付物：{deliv or ('PR' if has_pr else '票上回報')}）")
 
+    # ── 完工回寫（inkstone/ISEP#92 最痛的那一格）─────────────────────────
+    # 關掉一張下游票之後，**同一個動作**回頭處理它的頂層票。
+    # 不做這件事的後果票上寫得很清楚：「頂層票會永遠掛著，而 leo 是看頂層的」。
+    _writeback(owner, repo, num, deliv or ("PR" if has_pr else "票上回報"))
+
+
+def _writeback(owner, repo, num, deliv):
+    """子票關掉 → 回頭處理每一張在等它的頂層票。
+
+    🔴 失敗要吵。回寫悄悄失敗 ＝ 這格等於沒做，而沒有人會發現
+       （那正是本票在治的病）。所以任何一張處理失敗就非零離開。
+    """
+    child = f"{owner}/{repo}#{num}"
+    try:
+        parents = _blocks(owner, repo, num)
+    except SystemExit:
+        print(f"\n⚠️ 撈不到 {child} 的頂層票（/blocks 讀失敗）——"
+              f"回寫這一格**沒有做**，請手動確認或跑 `ticket loose`", file=sys.stderr)
+        sys.exit(1)
+
+    if not parents:
+        print("\n📌 這張票沒有任何頂層票在等它（沒有相依邊）⇒ 不需要回寫。")
+        return
+
+    print(f"\n🔗 有 {len(parents)} 張頂層票在等這張票，逐一回寫：")
+    failed = []
+    for pt in parents:
+        pfull = pt["repository"]["full_name"]
+        po, pr = pfull.split("/")
+        pn = pt["number"]
+        try:
+            pdeps = _deps(po, pr, pn)
+            action, open_left = writeback_plan(pt.get("state"), pdeps)
+
+            if action == "skip":
+                print(f"   · {pfull}#{pn}　已經是 closed ⇒ 不動")
+                continue
+
+            lines = [_identity(po, pr), "",
+                     f"⬇️ **下游完工回寫**：`{child}` 已關（交付物：{deliv}）"]
+            if open_left:
+                lines += ["", f"這張票還在等 {len(open_left)} 張下游（都關了才輪到它）："]
+                lines += [f"- ◻ {i['repository']['full_name']}#{i['number']}　{i['title'][:60]}"
+                          for i in open_left]
+                lines += ["", "⇒ 本票維持原狀，不要當成可以收了。"]
+            else:
+                lines += ["", "**這是最後一張下游——本票的下游已經全部關閉。**", "",
+                          f"{BATON_MARK}　→ `{HANDBACK_TO}`", "",
+                          "**下一步**：驗一次頂層要的東西真的到齊了，到齊就 "
+                          f"`ticket close {pfull}#{pn} --deliverable <URL>`；"
+                          "沒到齊就開下一張下游票，不要把它留在原地。", "",
+                          "（本則由 `ticket close` 的完工回寫自動貼上，"
+                          "機制見 `inkstone/ISEP#92`）"]
+            api(f"/repos/{po}/{pr}/issues/{pn}/comments", {"body": "\n".join(lines)})
+
+            if action == "handback":
+                # 指派 ＋ 改 tag：**欄位**才撈得到，留言撈不到。
+                # 08-26 那次掉棒就是話有說、欄位沒動，棒子躺在地上 14 小時。
+                api(f"/repos/{po}/{pr}/issues/{pn}",
+                    {"assignees": [HANDBACK_TO]}, method="PATCH")
+                cur = [l["name"] for l in (pt.get("labels") or [])]
+                keep = [n for n in cur if not n.startswith("s/")] + ["s/review"]
+                _set_labels(po, pr, pn, keep)
+                print(f"   · {pfull}#{pn}　下游全關 ⇒ 已指派 {HANDBACK_TO}＋s/review（等人驗）")
+            else:
+                print(f"   · {pfull}#{pn}　還有 {len(open_left)} 張下游沒關 ⇒ 只記一筆")
+        except SystemExit:
+            failed.append(f"{pfull}#{pn}")
+        except Exception as e:
+            failed.append(f"{pfull}#{pn}（{e}）")
+
+    if failed:
+        print(f"\n⚠️ 這幾張頂層票**沒有回寫成功**：{'、'.join(failed)}\n"
+              f"   回寫失敗要吵——悄悄失敗等於這格沒做。手動補，或稍後跑 `ticket loose` 對帳。",
+              file=sys.stderr)
+        sys.exit(1)
+
 
 
 # ── decide ───────────────────────────────────────────────────────────────
@@ -323,6 +561,8 @@ def cmd_decide(argv):
     body = open(argv[2]).read()
     nxt = argv[argv.index("--next") + 1] if "--next" in argv else None
 
+    check_identity(body, "裁決紀錄")
+
     if "leo" not in body.lower() and "原話" not in body:
         die("🚫 答案檔裡看不到 leo 的原話。\n"
             "   **裁決要記原話，不是記你的轉述**——轉述會漂，原話不會。\n"
@@ -351,7 +591,454 @@ def cmd_decide(argv):
     print("   兩件事是同一個動作——不會只改標籤而忘了記，也不會記了而看板還在說『等 leo』。")
 
 
-CMDS = {"where": cmd_where, "say": cmd_say, "new": cmd_new, "close": cmd_close, "decide": cmd_decide}
+# ══════════════════════════════════════════════════════════════════════════
+# 三個 Gitea 原生欄位（leo 2026-08-27：「子票相依是 gitea 原有機制，改 tag 和指定
+# 也是，**這些全部都要**」）。三者正交，各回答一個問題：
+#
+#   子票相依  這件事存在嗎？做完了嗎？   ← 缺了它：任務藏在討論串，撈 open 票看不到
+#   tag s/*   它現在卡在哪一段？          ← 缺了它：撈得到票但要重讀整串才知道在等什麼
+#   指派      現在誰該動？                ← 缺了它：大家都以為是別人的事
+#
+# 08-26 那次掉棒（arcrun-rag#136 comment 4267「等雲端那半出貨才驗得了」躺了 14 小時）
+# 三格全缺：沒有子票、tag 沒動、沒指派給任何人。
+# ══════════════════════════════════════════════════════════════════════════
+
+BATON_MARK = "🏃 **棒子交回**"
+
+# 棒子的預設終點：總管。**這是 Gitea 的 assignee 欄位，不是一句話**——
+# 撈「指派給你的」一頁就看得到，撈留言看不到。
+HANDBACK_TO = os.environ.get("ISEP_HANDBACK_TO") or "claude-code"
+
+
+def _labels_of(owner, repo):
+    return {l["name"]: l["id"] for l in api(f"/repos/{owner}/{repo}/labels?limit=100")}
+
+
+def _set_labels(owner, repo, num, keep):
+    ids = _labels_of(owner, repo)
+    unknown = [n for n in keep if n not in ids]
+    if unknown:
+        die(f"🚫 這個 repo 沒有這些標籤：{unknown}\n"
+            f"   （標籤的唯一真相源是 ISEP 的 labels.yaml，改標籤要改那裡再 sync）")
+    api(f"/repos/{owner}/{repo}/issues/{num}/labels",
+        {"labels": [ids[n] for n in keep]}, method="PUT")
+
+
+def _deps(owner, repo, num):
+    return api(f"/repos/{owner}/{repo}/issues/{num}/dependencies") or []
+
+
+def _blocks(owner, repo, num):
+    """反方向：**誰把這張票當相依**——也就是這張票的頂層票（可能不只一張、可能跨 repo）。
+
+    Gitea 原生兩個端點是同一條邊的兩端，方向不可混淆：
+        /issues/<N>/dependencies   這張票在等誰      → 它的下游
+        /issues/<N>/blocks         誰在等這張票      → 它的頂層
+    `subtask` POST 的是**母票的 dependencies**，所以子票這端看到的是 `blocks`。
+    """
+    return api(f"/repos/{owner}/{repo}/issues/{num}/blocks") or []
+
+
+def _identity(owner, repo):
+    """票上的每一則留言第一行要表明身份（規約見 docs/governance/dispatch-and-reply-format.md §3）。
+
+    機器自動貼的留言同樣要標——不標的話，回寫留言看起來像某個人寫的，
+    而下一個讀票的人會去找那個人。
+    """
+    return os.environ.get("ISEP_IDENTITY") or f"【身份】總管／{owner}/{repo}／-"
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# inkstone/ISEP#92 — 「下游做完時頂層跟著關」的三格
+#
+# 票上的原話：「開在頂層的票，下游做完了卻沒人回來關⋯⋯頂層票會永遠掛著，
+#              而 leo 是看頂層的。」
+#
+# 缺的三格，各由下面一段承接：
+#   ① 雙向連結的強制  → cmd_subtask 一個動作同時掛相依 ＋ 在母票留下指回來的留言
+#   ② journey 標籤    → journey_label()（對不上就不貼，不硬湊）
+#   ③ 完工回寫        → writeback_plan() ＋ cmd_close 關完子票立刻回頭處理母票
+#   ④ 撈得出來        → is_loose() ＋ cmd_loose（③ 走側門漏掉的，這張網補回來）
+#
+# 🔴 這四格的判準**全部是機械事實**（相依邊在不在、state 是什麼），
+#    沒有一格在猜文字。leo 2026-08-17 已證偽關鍵字黑名單那條路
+#    （8 次誤攔、0 次正確攔截）。
+# ══════════════════════════════════════════════════════════════════════════
+
+JOURNEY_PREFIX = "j/"
+
+
+def journey_label(name):
+    """`--journey 收件匣` → `j/收件匣`。只加前綴，不做語意判斷。
+
+    標籤存不存在由 `_set_labels` 去問 Gitea（不存在就擋，並指回 labels.yaml）——
+    **「要求某個東西在場」，不是「猜哪些名字合法」**。
+    ⇒ 新的一條旅程要先加進 labels.yaml 再 sync，這是刻意的：
+      journey 是**跨票聚類的軸**，隨手造名字會讓同一條旅程長出三個拼法。
+    """
+    n = (name or "").strip()
+    if not n:
+        die("🚫 --journey 後面要接旅程名（例：--journey 收件匣）。\n"
+            "   對不上任何旅程就**不要加這個參數**——票上明講不硬湊。")
+    return n if n.startswith(JOURNEY_PREFIX) else JOURNEY_PREFIX + n
+
+
+def is_loose(state, deps):
+    """這張票是不是「下游都關了、自己還開著」的頂層票。
+
+    純函式（不打網路）⇒ 判準本身測得動，不必開真的票來驗。
+
+    三個條件缺一不可：
+      · 自己還 open        關掉的票不用管
+      · 曾經有下游         沒有相依邊 ⇒ 它根本不是頂層票，不要拿它來吵
+      · 沒有任何 open 下游 有一張還開著就還在跑，不是掉在地上
+    """
+    if state != "open":
+        return False
+    if not deps:
+        return False
+    return not any(d.get("state") == "open" for d in deps)
+
+
+def writeback_plan(parent_state, parent_deps):
+    """下游關掉之後，它的頂層票該被怎麼處理。**只回計畫，不做副作用**⇒ 離線測得動。
+
+    回 (動作, 還開著的下游)：
+      "skip"      頂層票自己已經關了 ⇒ 沒事
+      "note"      還有別的下游沒關   ⇒ 只在頂層票記一筆，別假裝它可以收了
+      "handback"  下游全關了          ⇒ 這張票現在**只等人驗**：
+                                        指派回總管 ＋ s/review，讓它出現在「指派給你的」
+
+    🔴 為什麼不自動關母票：關票要有交付物、要有人看過（`ticket close` 的既有閘）。
+       票上要的是「不能默默留著」，不是「自動消失」——
+       默默關掉跟默默留著是同一個病的兩面。
+    """
+    open_left = [d for d in (parent_deps or []) if d.get("state") == "open"]
+    if parent_state != "open":
+        return "skip", open_left
+    return ("note" if open_left else "handback"), open_left
+
+
+# ── subtask ──────────────────────────────────────────────────────────────
+def cmd_subtask(argv):
+    """把「討論串裡的一件事」長成看得見的子票，並掛成母票的 Gitea 原生相依。
+
+    為什麼是子票而不是留言（leo 2026-08-27）：
+      「可以在討論串延伸子票，它完成了子票就完工，不然這筆任務就是沒完工⋯⋯
+        票沒完工可以察覺嗎？」
+    留言要有人回頭讀才看得見；票的 open/closed 是**狀態**，撈一次就在眼前。
+
+    而且相依是**硬的**，不是提醒——實測（2026-08-27，Gitea 1.26.4）：
+      子票還開著時 PATCH 母票 state=closed → **HTTP 412
+      "cannot close this issue or pull request because it still has open dependencies"**
+    ⇒ 子票沒關，母票關不掉。這是平台保證，不是自律。
+
+    刻意不要求 `ticket where` 戳記：leaf 屬於一條**已知**的線（它的母票就是那條線），
+    不是「新開一條線」——那道閘擋的是後者。
+    """
+    if len(argv) < 1:
+        die("用法：ticket subtask <母票 owner/repo#N> --title \"<User Story>\" -F <內文檔>\n"
+            "      [--repo <收件 repo，預設跟母票同一個>] [--label <s/xxx，預設 s/todo>]\n"
+            "      [--journey <旅程名>]　← 這件事服務哪條使用者旅程（對不上就不要加）\n"
+            "      [--assign <誰做> --next \"<他第一件事要做什麼>\"]　← 指派了就一定要寫下一步\n"
+            "\n（`ticket handoff` 是同一個動作的別名：頂層票 → 下游 repo）")
+    powner, prepo, pnum = parse_ref(argv[0])
+
+    def opt(name, default=None):
+        return argv[argv.index(name) + 1] if name in argv else default
+
+    title = opt("--title")
+    fpath = opt("-F") or opt("--file")
+    if not title or not fpath:
+        die("🚫 缺 --title 或 -F <內文檔>")
+    check_title(title)
+    body = open(fpath).read()
+
+    missing = [s for s in REQUIRED_SECTIONS if s not in body]
+    if missing:
+        die(f"🚫 子票一樣是票，模板欄位不能少：{'、'.join(missing)}\n"
+            "   （子票通常很小，但「小」不等於「可以說不清楚」——\n"
+            "     leo 2026-08-27：『每個事情沒有歷史記錄才是大問題』，\n"
+            "     而沒寫驗收條件的票，關掉之後就沒有歷史，只剩一個關字）")
+
+    # `--to <repo>` 是 `ticket handoff` 那個名字底下比較自然的講法，同一個東西。
+    # （handback 的 `--to` 是「交給誰」，subtask 沒有那個參數，不會撞。）
+    repo = opt("--repo", opt("--to", prepo))
+    label = opt("--label", "s/todo")
+    assign = opt("--assign")
+    nxt = opt("--next")
+    jlabel = journey_label(opt("--journey")) if "--journey" in argv else None
+    if assign and not nxt:
+        die("🚫 指派了人卻沒寫 --next。\n"
+            "   **有人被指到這張票，他撈到它的第一件事就是問「所以我要做什麼」**——\n"
+            "   那句話現在就要寫下來，不是等他重讀整串。\n"
+            "   （沒有要指派給誰就不要加 --assign，那張票會留在票池等人領。）")
+
+    body = (f"Parent: {powner}/{prepo}#{pnum}\n"
+            f"> 這張票是從母票的討論串裡長出來的一件事。\n"
+            f"> **它沒關，母票關不掉**（Gitea 原生相依，實測 412 硬擋）。\n"
+            f"> **它關掉時，母票會收到一則回寫**（`ticket close` 自動做，見 `inkstone/ISEP#92`）。\n\n") + body
+
+    d = api(f"/repos/{ORG}/{repo}/issues", {"title": title, "body": body})
+    cnum = d["number"]
+    print(f"✅ 子票 {ORG}/{repo}#{cnum} 已開：{d['html_url']}")
+
+    _set_labels(ORG, repo, cnum, [label])
+    print(f"   tag：{label}（它卡在哪一段）")
+    if assign:
+        api(f"/repos/{ORG}/{repo}/issues/{cnum}", {"assignees": [assign]}, method="PATCH")
+        api(f"/repos/{ORG}/{repo}/issues/{cnum}/comments",
+            {"body": f"{BATON_MARK}　→ `{assign}`\n\n**下一步**：{nxt}\n\n"
+                     f"（這張票是 `{powner}/{prepo}#{pnum}` 的相依——它沒關，母票關不掉）"})
+        print(f"   指派：{assign}（誰該動）")
+        print(f"   下一步：{nxt}")
+
+    # 🔴 相依掛不上去 ＝ 這張子票對母票是隱形的 ⇒ 整個動作算失敗，要讓人看到
+    api(f"/repos/{powner}/{prepo}/issues/{pnum}/dependencies",
+        {"owner": ORG, "repo": repo, "index": cnum})
+    deps = _deps(powner, prepo, pnum)
+    openn = [i for i in deps if i["state"] == "open"]
+    print(f"   相依：已掛上 {powner}/{prepo}#{pnum}（它存在、且擋著母票）")
+
+    # 🔴 雙向連結：相依邊只長在 Gitea 的側欄，**母票的時間軸上什麼都沒有**。
+    #    票上的原話：「頂層票寫了『轉去某個 repo』，但那邊的票沒有指回來，
+    #    從下游那張票看不出它從哪來，脈絡就斷了。」
+    #    ⇒ 兩端各留一個看得見的指標：子票內文的 `Parent:`（上面），母票時間軸的這一則。
+    #    跨 repo 時尤其重要——側欄的相依很容易被當成同 repo 的東西。
+    plines = [_identity(powner, prepo), "",
+              f"➡️ **已轉往下游**：`{ORG}/{repo}#{cnum}`　{title}", "",
+              f"{d['html_url']}", "",
+              f"- 收件 repo：`{ORG}/{repo}`　tag：`{label}`"
+              + (f"　旅程：`{jlabel}`" if jlabel else "")
+              + (f"　指派：`{assign}`" if assign else "　（還沒指派，留在票池等人領）")]
+    if jlabel is None:
+        plines += ["- 旅程：**沒有貼**（開票時判定對不上任何一條，不硬湊）"]
+    plines += ["",
+               "**這張頂層票不會因為轉出去就自動關**——下游那張關掉時，"
+               "`ticket close` 會回頭在這裡貼一則回寫；"
+               "全部下游關完，這張票會被指派回總管等驗。（機制：`inkstone/ISEP#92`）"]
+    api(f"/repos/{powner}/{prepo}/issues/{pnum}/comments", {"body": "\n".join(plines)})
+    print(f"   回指：已在母票 {powner}/{prepo}#{pnum} 的時間軸貼上指向子票的留言")
+
+    # journey 標籤：兩端都貼，聚類才聚得起來（只貼一端＝撈不到另一端）
+    if jlabel:
+        _set_labels(ORG, repo, cnum, [label, jlabel])
+        pcur = [l["name"] for l in (api(f"/repos/{powner}/{prepo}/issues/{pnum}")
+                                    .get("labels") or [])]
+        if jlabel not in pcur:
+            _set_labels(powner, prepo, pnum, pcur + [jlabel])
+        print(f"   旅程：`{jlabel}`（母子兩端都貼——只貼一端就聚不起來）")
+    else:
+        print("   旅程：沒有貼（沒給 --journey）。對得上就補一次："
+              f"`ticket subtask … --journey <旅程名>`；對不上就不要硬湊。")
+    print(f"\n📌 母票 {powner}/{prepo}#{pnum} 目前有 {len(openn)} 張未關的相依：")
+    for i in deps:
+        mark = "◻" if i["state"] == "open" else "☑"
+        print(f"     {mark} {i['repository']['full_name']}#{i['number']}  {i['title'][:50]}")
+    print("   在它們全關之前，母票 PATCH state=closed 會被 Gitea 擋下（412）。")
+
+
+# ── handback ─────────────────────────────────────────────────────────────
+def cmd_handback(argv):
+    """收工＝把棒子交回去：**指派 ＋ tag ＋ 下一步**，一個動作三件事。
+
+    leo 2026-08-27：「它把事情做完後如果要檢查後續，就要把任務指定給你並改 tag，
+      你收到指定用 tag 查就知道要去做，所以**每個任務結束必須要指派回總管**，
+      要說明下一步怎麼做，直到最後交出正確 deliverable 並且驗證」
+
+    🔴 關鍵在「指派」是**欄位**不是文字——撈一次就看得到，不必讀 comment。
+    08-26 那次掉棒，交回的話寫在 comment 裡，票沒指派、tag 沒動 ⇒ 棒子躺在地上 14 小時。
+    """
+    if len(argv) < 1:
+        die("用法：ticket handback <owner/repo#N> --to <claude-code|Leo> --next \"<下一步一句話>\"\n"
+            "      [--label <s/xxx>] [--evidence <URL 或一行實測>]\n"
+            "（--to claude-code ＝ 交回總管；--to Leo ＝ 要 leo 親手做，會自動加 Human）")
+    owner, repo, num = parse_ref(argv[0])
+
+    def opt(name, default=None):
+        return argv[argv.index(name) + 1] if name in argv else default
+
+    to = opt("--to")
+    nxt = opt("--next")
+    if not to or not nxt:
+        die("🚫 缺 --to 或 --next。\n"
+            "   **「下一步」不准省略**——收下棒子的人要能不重讀整串就知道該做什麼。\n"
+            "   （這正是 08-26 掉棒那次缺的：話有說，但沒有欄位在說「這張票在等你」）")
+    label = opt("--label")
+    ev = opt("--evidence")
+
+    issue = api(f"/repos/{owner}/{repo}/issues/{num}")
+    cur = [l["name"] for l in issue.get("labels") or []]
+
+    deps = _deps(owner, repo, num)
+    openn = [i for i in deps if i["state"] == "open"]
+
+    lines = [f"{BATON_MARK}　→ `{to}`", "",
+             f"**下一步**：{nxt}"]
+    if ev:
+        lines += ["", f"**證據**：{ev}"]
+    if openn:
+        lines += ["", "**未關的相依**（它們全關之前這張票關不掉）："]
+        lines += [f"- {i['repository']['full_name']}#{i['number']}　{i['title'][:60]}" for i in openn]
+    api(f"/repos/{owner}/{repo}/issues/{num}/comments", {"body": "\n".join(lines)})
+
+    api(f"/repos/{owner}/{repo}/issues/{num}", {"assignees": [to]}, method="PATCH")
+
+    keep = list(cur)
+    if label:
+        keep = [n for n in keep if not n.startswith("s/")] + [label]
+    if to == "Leo" and "Human" not in keep:
+        keep.append("Human")
+    if to != "Leo" and "Human" in keep:
+        keep = [n for n in keep if n != "Human"]
+    _set_labels(owner, repo, num, keep)
+
+    print(f"✅ {owner}/{repo}#{num} 棒子交回 `{to}`")
+    print(f"   指派：{to}　　tag：{[n for n in keep if n.startswith('s/')] or '（未動）'}"
+          f"{'　＋Human' if 'Human' in keep else ''}")
+    print(f"   下一步：{nxt}")
+    if openn:
+        print(f"   ⚠️ 還有 {len(openn)} 張未關的相依 ⇒ 這張票現在關不掉（412），這是對的")
+    print("\n📌 三件事是同一個動作——不會只留言而忘了指派，也不會指派了而看板還說 s/doing。")
+
+
+# ── mine ─────────────────────────────────────────────────────────────────
+def cmd_mine(argv):
+    """撈一次：**哪幾根棒子在誰手上、每根的下一步是什麼**。
+
+    不是輪詢——掛在本來就會做的動作上（session 開場、收工對帳）跑一次。
+    """
+    user = argv[argv.index("--user") + 1] if "--user" in argv else None
+
+    if user in (None, "", "me"):
+        who = "總管（本 token 的身份）"
+        items = api("/repos/issues/search?state=open&type=issues&assigned=true&limit=100") or []
+    else:
+        who = user
+        items = []
+        for r in api(f"/orgs/{ORG}/repos?limit=100") or []:
+            q = urllib.parse.urlencode({"state": "open", "assigned_by": user, "limit": 50})
+            for it in api(f"/repos/{ORG}/{r['name']}/issues?{q}") or []:
+                if it.get("pull_request"):
+                    continue
+                it.setdefault("repository", {"full_name": f"{ORG}/{r['name']}"})
+                items.append(it)
+
+    print(f"🏃 在「{who}」手上的棒子：{len(items)} 根\n")
+    if not items:
+        print("  （沒有——每一根都已經交出去或關掉了）")
+    for it in items:
+        ref = it["repository"]["full_name"] + "#" + str(it["number"])
+        st = [l["name"] for l in it.get("labels") or []]
+        o, rp, n = ref.split("/")[0], ref.split("/")[1].split("#")[0], it["number"]
+        deps = _deps(o, rp, n)
+        openn = [i for i in deps if i["state"] == "open"]
+        print(f"  ● {ref}　{st}")
+        print(f"    {it['title'][:64]}")
+        nxt = _last_next(o, rp, n)
+        print(f"    下一步：{nxt or '❌ 沒有人寫下一步（交棒時漏了 --next）'}")
+        if openn:
+            print(f"    ◻ 未關相依 {len(openn)}：" +
+                  "、".join(f"{i['repository']['full_name']}#{i['number']}" for i in openn))
+    print("\n📌 終點是 leo 說的「直到最後交出正確 deliverable 並且驗證」——"
+          "驗完就關票、清指派，這張表才會縮短。")
+
+
+def _last_next(owner, repo, num):
+    """從最後一則交棒留言抓「下一步」。抓不到就誠實回 None，不要編。"""
+    try:
+        cs = api(f"/repos/{owner}/{repo}/issues/{num}/comments?limit=100") or []
+    except SystemExit:
+        return None
+    for c in reversed(cs):
+        b = c.get("body") or ""
+        if BATON_MARK.strip("*") .replace("**", "") in b or BATON_MARK in b:
+            m = re.search(r"\*\*下一步\*\*[：:]\s*(.+)", b)
+            if m:
+                return m.group(1).strip()[:100]
+    return None
+
+
+# ── loose ────────────────────────────────────────────────────────────────
+def cmd_loose(argv):
+    """撈一次：**下游都關了、自己還開著**的頂層票。
+
+    票上的驗收條件第 3、4 條（`inkstone/ISEP#92`）：
+      「撈一次『已經沒有 open 下游票、但自己還開著的頂層票』→ 要撈得出來（現在撈不出來）」
+      「拿現有的頂層票跑一次 → 要能指出哪幾張是這種情況」
+
+    這是 `ticket close` 自動回寫的**補網**：回寫只在走正門（`ticket close`）時發生，
+    而關票的側門（直接 PATCH `state=closed`）是刻意放行的
+    （見 `hooks/ticket-api-bypass-guard.sh`：「帶了 ID 的子路徑」一律放行）。
+    ⇒ 側門漏掉的，由這張網撈回來。**不是輪詢**——掛在開場／收工對帳跑一次。
+    """
+    def opt(name, default=None):
+        return argv[argv.index(name) + 1] if name in argv else default
+
+    org = opt("--org", ORG)
+    only = opt("--repo")
+
+    print(f"🔎 掃 `{org}` 的 open 票，找「下游都關了、自己還開著」的頂層票"
+          + (f"（只看 {only}）" if only else "") + " …")
+
+    items, page = [], 1
+    while page <= 12:
+        q = urllib.parse.urlencode({"state": "open", "type": "issues",
+                                    "limit": 50, "page": page, "owner": org})
+        got = api(f"/repos/issues/search?{q}") or []
+        if not got:
+            break
+        items += got
+        page += 1
+    if only:
+        items = [i for i in items if i["repository"]["full_name"].split("/")[-1] == only]
+    print(f"   open 票 {len(items)} 張，逐張問它的下游 …")
+
+    def probe(it):
+        full = it["repository"]["full_name"]
+        o, r = full.split("/")
+        try:
+            deps = _deps(o, r, it["number"])
+        except SystemExit:
+            return None            # 讀不到 ≠ 沒有下游；寧可漏報也不要編一筆出來
+        except Exception:
+            return None
+        return (full, it, deps)
+
+    from concurrent.futures import ThreadPoolExecutor
+    with ThreadPoolExecutor(max_workers=12) as ex:
+        probed = [x for x in ex.map(probe, items) if x]
+
+    parents = [x for x in probed if x[2]]
+    loose = [x for x in parents if is_loose("open", x[2])]
+
+    print(f"\n   有下游相依的頂層票：{len(parents)} 張")
+    print(f"   其中「下游都關了、自己還開著」：**{len(loose)} 張**\n")
+
+    if not loose:
+        print("✅ 一張都沒有——每張頂層票都還有下游在跑，或已經跟著關了。")
+    for full, it, deps in loose:
+        n = it["number"]
+        st = [l["name"] for l in it.get("labels") or []]
+        who = [a["login"] for a in (it.get("assignees") or [])] or ["（沒有人）"]
+        print(f"  ● {full}#{n}　{st}　指派：{'、'.join(who)}")
+        print(f"    {it['title'][:64]}")
+        for d in deps:
+            print(f"      ☑ {d['repository']['full_name']}#{d['number']}"
+                  f"　{d['title'][:52]}")
+        print(f"    → 驗過就關：ticket close {full}#{n} --deliverable <URL>")
+        print(f"      還缺東西：ticket subtask {full}#{n} --title \"<US>\" -F <檔>")
+        print()
+
+    print("📌 這張表撈的是**機械事實**（相依邊的 state），不是猜文字。")
+    print("   走 `ticket close` 關下游時會自動回寫、這張表就不會長；")
+    print("   會長出來的都是走側門關掉的那些。")
+    return loose
+
+
+CMDS = {"where": cmd_where, "say": cmd_say, "new": cmd_new, "close": cmd_close,
+        "decide": cmd_decide, "subtask": cmd_subtask, "handoff": cmd_subtask,
+        "handback": cmd_handback, "mine": cmd_mine, "loose": cmd_loose}
 
 if __name__ == "__main__":
     if len(sys.argv) < 2 or sys.argv[1] not in CMDS:

system-dev/wiki/mistakes.md

@@ -77,3 +77,44 @@ Gitea 上**一個 release tag 都沒有**。
       **不要用 sed**，正體中文加上訊息裡的 `/`、`&`、`\` 讓跳脫非常脆。
       迴歸測試要**檢查訊息內容**，不能只檢查離開碼
       （`hooks/tests/ask-user-question-guard.test.sh` 的 ⑩b 就是這一條）。
+
+## ⚠️ MISTAKE: 閘只驗了規則的**殼**，沒驗規則本身
+
+`no-ticket-no-dispatch.sh` 掛在派工的當下，檢查「派工單裡有沒有一行 `【工單】owner/repo#N`」。
+規則的原文卻是「**不准把票上已經有的東西再抄一遍進派工單**⋯⋯派工單只寫票號」。
+
+⇒ 於是可以**把 40 行任務全寫在 prompt 裡、票號補一行**，閘照樣放行。
+⇒ 2026-08-27 一天之內這樣做了 5 次，每一次票上都沒有那份任務。
+   leo：「**這些話票上都沒有，你根本沒照規則做事，你的 hook 讓你這樣搞？**」
+
+**根因不是那支閘寫壞了，是它驗的東西比規則小。**
+「有沒有票號」是規則最容易機械化的那一格，所以它被實作了；
+「任務有沒有真的落在票上」比較難，所以沒有——而漏掉的那格才是規則的本體。
+
+⇒ **判準：寫完一支閘，回頭把規則原文逐句對一次，問「這一句被驗到了嗎」。**
+   只驗得到最容易的那一格 ⇒ 那支閘會製造「有在管」的錯覺，比沒有閘更危險。
+⇒ 同款：history-first／KBDB-first／stage-first／`AskUserQuestion` 裸奔，全是這個形狀。
+
+修法（v0.5.0）：`dispatch-format-guard.sh`——**派工單 ＝ 票號，多一個字都擋**。
+規則變得比原本更嚴，反而更好驗：判準從「內容夠不夠」變成「這一行是不是【工單】欄位」，
+純結構、不用語意判官、每次結果一樣。
+規約：`docs/governance/dispatch-and-reply-format.md`。
+
+日期: 2026-08-27（`inkstone/ISEP#30` comment 4322／4325／4327）
+
+## ⚠️ MISTAKE: 「這是 session 才知道的事」被當成寫進 prompt 的正當理由
+
+派工鐵律允許派工單帶「這個 session 才知道、票上還沒有的事」。
+總管照字面理解，把 TCC 權限、`main` 是哪顆 commit、正本能從哪裡 clone 三件事寫進 prompt。
+
+leo 當場：「**這些為什麼不寫到票裡？**」
+
+⇒ **「票上還沒有」不是把它寫進 prompt 的理由——它就是「去把它寫上票」的指令。**
+⇒ 實害（同日）：總管停掉重派 3 次，**前兩次的任務與 session 事實全部隨 prompt 蒸發**。
+   票活得比任何一個 agent 久，prompt 不是。
+
+判準：**「這句話換一張票還成立嗎？」**
+還成立 ⇒ 共通規定（`docs/governance/dispatch-and-reply-format.md` §2，機器自動注入）。
+只有這次成立 ⇒ 寫進那張票。**兩種都不進派工單。**
+
+日期: 2026-08-27（`inkstone/ISEP#30` comment 4327）