雲端要拿得到票、主線與通知：白名單住 ISEP、主線檔隨 repo 走、leo21c 讀放寫擋（inkstone/ISEP#130）

- docs/permissions-allow.json ＋ scripts/settings-allow-sync：四個 Gitea 正門工具的權限白名單一份，
  setup script 裝完 plugin 寫一次、SessionStart 每次再對一次（只加不減、冪等）
- hooks/lib/mainline.py／scripts/mainline：家目錄沒主線就讀 InkStoneCo/system-dev/mainline.json；
  set／adopt／clear 兩份一起寫，refresh 只寫家目錄
- hooks/leo21c-write-guard.sh：唯讀 -d（tr/cut/sort…）先剪掉再判、notify_leo trigger 放行
  （與 prod-write-guard 同一份白名單）、改法段改印 09-02 起的 youlin 子網域；補第一支測試（26 條）
- prod-write-guard／main-and-prod-push-guard／kbdb-live-exam：認得 youlin 新子網域 arcrun-yuga3bse
- scripts/ticket：收件 repo 寫 inkstone/ISEP 不再 404（org 寫錯當場講）
- scripts/isep-notify：有 TELEGRAM_BOT_TOKEN／TELEGRAM_CHAT_ID 先走 Bot API 直送（雲端唯一通的路）
- 測試：A31–A35 共 79 條；README／plugin.json／hooks-inventory 數字實數（61 支、85 條、53 支腳本）

假設（記在這裡等 review）：權限規則的形狀沿用 leo 09-07 親手加、實測有效的那四條；
「分類器真的不擋」要雲端一趟 run 的 permission_denials 才驗得到，本 PR 驗不了。
版本：待總管定版（plugin.json 仍 0.22.0）。

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DTZ9QtvjY7MNxjfQbexAm7

docs/hooks-inventory.md

@@ -7,14 +7,14 @@
 
 ## 一句話結論
 
-`hooks/` 底下有 **61 個 `.sh` 檔**，`hooks.json` 實際掛上 **84 條註冊**（同一支閘常被多種情境同時掛上）；
+`hooks/` 底下有 **61 個 `.sh` 檔**，`hooks.json` 實際掛上 **85 條註冊**（同一支閘常被多種情境同時掛上）；
 其中 **3 支檔案存在但沒被掛上**（2 支是待人填的空範本、1 支是刻意留著沒開的止血帶，見下面「未生效」表）。
 下面按「你會在什麼時候撞到它」分組，一支一行。
 
 > 🔴 **這兩個數字上一版是錯的（2026-08-26 實際數過才發現）**：本頁原本寫「43 個檔、53 條註冊」，
 > 而當時真實是 **45 個檔、55 條註冊**——中間有兩支閘進來時沒有回頭改這裡。
 > 現在的寫法是實際數出來的：
-> `ls hooks/*.sh | wc -l` ＝ 61；`grep -c '"command":' hooks/hooks.json` ＝ 84。
+> `ls hooks/*.sh | wc -l` ＝ 61；`grep -c '"command":' hooks/hooks.json` ＝ 85。
 > ⚠️ **冒號不能省**：`grep -c '"command"'`（沒冒號）會連 `"type": "command"` 一起數到，回 **120**。
 > 本頁 2026-08-27 之前寫的是沒冒號那版——**照著它跑會拿到一個跟本頁不符的數字**。
 > **一份會偷偷過期的盤點表，跟沒有盤點表差不多**——見本頁最後「怎麼跟實況對帳」那段。
@@ -32,6 +32,13 @@
 > **兩個事件是同一件事的兩半**：只注入 ＝ 又一個會被忽略的提醒；只查核 ＝ 罰它做一件拿不到資料的事。
 > 這兩個數字是併之前當場數出來的，不是從上一版加減推出來的。
 
+> 📌 **`inkstone/ISEP#130`（2026-09-07）＋0 支、＋1 條**：SessionStart 多掛一條
+> `scripts/settings-allow-sync --quiet`（不是閘，是腳本：把 ISEP 的權限白名單寫進這台的
+> `~/.claude/settings.json`，雲端才不會每個正門工具都被分類器擋）。
+> **61 支不變、84→85 條，兩個數字是掛完之後當場數出來的**（`ls hooks/*.sh | wc -l`＝61、
+> `grep -c '"command":' hooks/hooks.json`＝85）。同票順手：`leo21c-write-guard.sh` 補了
+> 唯讀 `-d` 與 notify_leo 的放行、三支閘認得 youlin 09-02 起的新子網域——**都是改判準不是加閘**。
+
 > 📌 **`inkstone/ISEP#82`（2026-08-28）＋1 支、＋3 條**：`mainline-focus-guard.sh`
 > 同時掛在 `Agent` 與 `Task`（派工的兩個入口都要守，只守一個等於沒守），
 > 加上 SessionStart 多掛一條 `scripts/mainline refresh`（更新主線的進度／期限，不是閘）。
@@ -122,7 +129,7 @@
 | `main-and-prod-push-guard.sh` | 兩層確認：① subagent 想推 Gitea `main` 分支 → 一定要交回總管，總管確認過才放行；② 任何 `wrangler deploy` 打正式環境 → 一定要你親手解鎖。 | 🛑 擋 |
 | `prod-write-guard.sh` | AI 想做任何「會真的改到線上正式帳號（leo21c）」的操作（不只是 push，也包含直接呼叫會寫入的工具）就擋下，交回總管處理。 | 🛑 擋 |
 | `not-my-branch-guard.sh` | AI 想 commit 到「別的 subagent 正在施工中」的分支（登記在 `branch-holds.md`）就擋下，避免兩個 AI 互踩同一條分支。 | 🛑 擋 |
-| `leo21c-write-guard.sh` | AI 想寫東西到你私人帳號 `leo21c` 就擋下——這個帳號只准你自己用，AI 的實驗一律走別的測試帳號。 | 🛑 擋 |
+| `leo21c-write-guard.sh` | AI 想寫東西到你私人帳號 `leo21c` 就擋下——這個帳號只准你自己用，AI 的實驗一律走別的測試帳號。**讀一律放行**（含 `tr -d`／`cut -d=` 這種唯讀的 `-d`，09-04 雲端就是被這個誤攔到「連讀都讀不到」），發一則 `notify_leo`（只送訊息、什麼都沒改）也放行——跟 `prod-write-guard.sh` 同一份白名單（inkstone/ISEP#130）。 | 🛑 擋 |
 | `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 東西（開新票／milestone／label／PR，會漏掉「新增前先搜過」這道檢查）就擋下——不管是隱式 POST（urllib 傳 data= 沒寫 method）還是小寫 `requests.post(...)`。 | 🛑 擋 |
 | `milestone-due-guard.sh` | AI 想開一個新的里程碑（milestone）卻沒填期限就擋下，**填 `9999-01-01` 一樣擋**——那是「沒有期限」穿了一件期限的衣服，盤點時每一格看起來都有值，其實一格都沒有。只管「建里程碑」這個動作，查詢／改別的欄位都放行。 | 🛑 擋 |
@@ -205,6 +212,7 @@
 |---|---|---|
 | `isep-presence-beacon.sh` | 對話一開始印一行 `🟢 ISEP vX.Y.Z 已載入（N 支閘｜來源：…）`。**這行不是裝飾，是唯一能證明「這個 session 真的有閘」的東西**——它自己就住在 plugin 裡，看得到它就表示 plugin 載入了；某個 session 從頭到尾沒有這行，那個 session 是零閘狀態，先修 plugin 再做事。同一台機器可能同時有兩份 ISEP（marketplace 裝的、repo 裡 vendor 的），所以那行會講出這次是哪一份在說話。它另外會報四件「這一份是不是還有效」：①這一份落後 ISEP main 幾版 ②專案裡有沒有內容不同的同名**腳本**②b 專案裡有沒有內容不同的同名**skill／command／agent**——這些是**自動載入**的，載到舊的那份不會有任何症狀，只會安靜地教錯的東西（`docs/file-ownership.tsv` 說得出每一組的真相源是哪一份、往哪個方向修）②c 本身的內容跟那張歸屬表對不對得上（雲端沒有專案那一份可比時，這是唯一還作數的檢查）③工作區有沒有已退役機制留下的產物。**全部只講不擋。** | 📝 記錄（context 注入） |
 | `session-start-recall.sh` | 對話一開始就自動把「全局現況」（Gitea 各 repo 的票、KBDB 的藏書地圖）推到 AI 眼前，不必等它自己想到要查。 | 📝 記錄（context 注入） |
+| `scripts/settings-allow-sync --quiet` | （不是閘，是腳本）對話一開始把 ISEP 的權限白名單（`docs/permissions-allow.json`：`ticket`／`mainline`／`gate-ok`／`gitea-pr-merge` 四個正門工具）寫進**這台機器**的 `~/.claude/settings.json`。只加不減、冪等；目標檔壞掉就不碰它、講一聲。**為什麼**：leo 09-07 親手加的四條只在本機，雲端沒有 ⇒ 同樣的動作被分類器擋（09-04 run log `permission_denials=6`）；薄殼 repo 要 D20 開閘才推得動，所以清單住 ISEP 一份、兩台各自寫進自己的家目錄（inkstone/ISEP#130）。 | 📝 記錄（寫 settings） |
 | `scripts/mainline refresh` | （不是閘，是腳本）對話一開始把**現在的主線**那條 milestone 的進度與期限更新一次，好讓每回合眼前那一行講的是今天的數字。拿不到 Gitea 就原封不動——**寧可資料舊，不要把主線弄丟**。跑一次就結束，不輪詢。 | 📝 記錄 |
 | `overdue-nag-guard.sh` | 對話一開始就去 Gitea 撈**沒有人會叫的事**：逾期的 milestone、掛著等你的票（標「等了幾天」）、標著「有人在做」卻好幾天沒動的票；撈完用白話講出來，**有事就發 Telegram 給你**。沒東西可報時它會說「查過了，沒有」——**安靜跟壞掉長得一模一樣**。發不出去時不會靜默：它會先問這個 session 的 `prod-write-guard` 會不會擋（舊版把「發通知」誤認成「部署」），擋就改貼回票上並把原文印在眼前。只在開 session 時跑一次，**不輪詢、不掛排程**。 | 📝 記錄（context 注入 ＋ Telegram） |
 | `wiki-size-guard.sh` | 對話一開始講出「哪幾個 wiki 檔已經沒有人讀得完了」（預設超過 1200 行就點名）。**讀不完的必讀檔，跟沒有那個檔的差別只在於它讓人以為有。** 另一半掛在寫檔上，見 B 組。 | 📝 記錄（context 注入） |
@@ -288,8 +296,8 @@ countdown-milestone-refresh.sh    ← 假警報：它在 scripts/ 不在 hooks/
 🔴 **上面那一筆是假警報，不是「指向空氣」的閘**：`inkstone/ISEP#63` 之後，
 SessionStart 上掛的東西不全是 `hooks/*.sh`——`scripts/countdown-milestone-refresh.sh`
 是腳本不是閘。這組指令只比檔名、不看目錄，所以它會出現在這裡。
-（`inkstone/ISEP#82` 又多掛一條 `scripts/mainline refresh`，那一條沒有 `.sh`
-副檔名，所以不會落進這個名單。）**照著跑會看到它，這裡先講清楚，
+（`inkstone/ISEP#82` 又多掛一條 `scripts/mainline refresh`、`inkstone/ISEP#130` 多掛一條
+`scripts/settings-allow-sync --quiet`，這兩條沒有 `.sh` 副檔名，所以不會落進這個名單。）**照著跑會看到它，這裡先講清楚，
 免得下一個人以為是自己弄壞的。**
 
 🔴 **上面那兩行驗不出「表格漏列」**——它們比的是 `hooks.json`，不是這張表。