出貨鏈三站上 main：release-ship 前置①改看 tag 的樹、release-check 可指定版本、信標開場報「打了 tag 沒 release」（inkstone/ISEP#67）

- hooks/lib/release_chain.py：問 Gitea 的判準一份三處用（匿名讀，D20）
- scripts/release-ship：前置①比「要建的那個 tag 的樹」裡的 plugin.json，不比工作樹／最新 tag
  （總管 09-07 在 v0.23.0 被擋的情境現在放行）；note 從 Gitea compare 生，從 plugin 快取跑也行；
  覆核改跑 release-check <那個 tag>
- scripts/release-check [vX.Y.Z]：指定版本；v0.19／0.20／0.21 依裁決標「不補」不再黃字；補法印正本絕對路徑
- hooks/lib/beacon_report.py ④：最新 tag 沒 release／main 定版沒打 tag ⇒ 一行缺站＋補法；都在安靜；
  只快取「都在」6 小時
- 測試：test-release-ship 14、test-release-check 14、信標 26→33；docs：TESTING A37/A38、盤點表、README 60 支腳本、
  白名單加 release-ship／release-check 形狀、mistakes 一條
- 沒改 plugin.json 版本號（待總管定版）

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

.claude-plugin/marketplace.json

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

.claude-plugin/plugin.json

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

README.md

@@ -27,7 +27,7 @@
 | `agents/` | 7 位 | **工人名單**（`inkstone/ISEP#86`）——派工時指名派給誰，規約見 `docs/governance/worker-roster.md` |
 | `commands/` | 7 支 | `/wiki-recall` `/wiki-capture` `/cp-write` `/issue-handle` … |
 | `skills/` | 2 支 | `ship-check`（東西要出去之前）／`deep-recall`（把散落的枝葉還原成一棵樹）。🔴 **這兩支的內容不一定是在這裡寫的**——誰是真相源查 `docs/file-ownership.tsv` |
-| `scripts/` | 54 支 | `ticket`／`roster`／`isep-nag`／`wiki-compress`／`github-arm.sh` …（頂層檔案，不含 `lib/` 等子目錄） |
+| `scripts/` | 60 支 | `ticket`／`roster`／`isep-nag`／`wiki-compress`／`github-arm.sh` …（頂層檔案，不含 `lib/` 等子目錄） |
 
 > 🔴 這五個數字**每次都要在自己的樹上實數**，不准沿用上一版、也不准用加減推
 > （`system-dev/wiki/mistakes.md`：那是 leo 的驗收介面，多報就是假綠）：

docs/TESTING.md

@@ -330,12 +330,13 @@ bash hooks/tests/unpushed-police.test.sh
 - B 群（⑦—⑩，該報）任一紅 ⇒ 為了不吵而改成放行了，那是把閘關掉不是修好
 - 特別看 ④：問不到遠端（離線）**不准當成「你沒推」**
 
-### A18 — 信標會講出雲端會壞掉的那幾件事：26 條
+### A18 — 信標會講出雲端會壞掉的那幾件事：33 條
 ```
 bash hooks/tests/isep-presence-beacon.test.sh
 ```
-**該看到**：`通過 26 條，失敗 0 條`。全離線。
+**該看到**：`通過 33 條，失敗 0 條`。全離線。
 
+> 📌 `inkstone/ISEP#67`（2026-09-07）從 26 條加到 33 條：信標 ④ 開場報「打了 tag 卻沒 release」，見 A38。
 > 📌 `inkstone/ISEP#122` 從 14 條加到 26 條：信標原本只掃 `scripts/`，
 > 而**真正會自動載入的東西**（skill／command／agent）同樣兩邊各有一份。
 > 實查：那 9 個檔案在 `0.1.0`（c263866）複製過來之後**一次都沒再同步**，
@@ -822,6 +823,94 @@ api.telegram.org      → 302，通
 **失敗**：A1 紅 ⇒ 沒憑證時不講缺什麼，leo 不知道要在 Cloud environment 加哪兩個；
 B3 紅 ⇒ 送到了還去打實例；C1 紅 ⇒ 401 被講成送到；D1 紅 ⇒ 舊版閘 block 時直送也被連坐。
 
+### A36 — 雲端對 stage 的寫入有正門，而且只寫得進 stage：45 條
+```
+bash scripts/test-stage.sh
+```
+**該看到**：`45/45 通過`。CF API 與 stage 實例都指到本機一個假伺服器——不打真 Cloudflare、不碰任何 worker。
+假伺服器對 secret PUT 回 **201**（真 CF 就是 201）。
+
+**它在守什麼**（inkstone/ISEP#137，2026-09-07 三條主線工人在雲端撞的同一面牆）：
+```
+printf … | npx wrangler secret put …                 ← 分類器擋（複合指令對不上白名單任何一條前綴）
+python3 scripts/stage-deploy-artifacts.py all --confirm   ← 分類器擋
+curl -X POST …arcrun-yuga3bse.workers.dev/records     ← 分類器擋；0.21.0 的 prod-write-guard 又當它是 prod
+```
+⇒ `scripts/stage`：`secret put／list／delete`（直接打 CF API，不經 npx）與 `api <METHOD> <worker>/<path>`
+（curl 打實例，標頭與 body 走 stdin，不走 argv）。**只寫 stage**：secret 先 `GET /accounts` 看這把 token
+打得到誰、URL 永遠只帶 `1129efd7…`；api 的主機只會長在 `*.arcrun-yuga3bse.workers.dev`。
+值只從環境變數名讀（`--from-env`／`--bearer-env`／`--header-env`／`--data-env`），`--value`／`--bearer`／`--header` 一律拒收。
+Arcrun 的 `stage-deploy-artifacts.py` 自己已寫死只認 youlin 帳號 ID、不收 `--account`／`--token`，
+白名單直接放它從 Arcrun 根目錄跑的相對形狀，不重造一支。
+
+**失敗**：
+- A1／B1／B2／D1／D2 紅 ⇒ **非 stage 也寫得進去**——這是本工具存在的唯一理由
+- A4／D3 紅 ⇒ 值可以從指令列進來（會進 shell 歷史與 session log）
+- C1 紅 ⇒ 又把 201 講成失敗（第一次實跑就是這樣：CF 種好了、工具說失敗）
+- C7／C9 紅 ⇒ 只信 PUT 的回應不去列
+- **E2 紅 ⇒ ISEP 自己的閘誤攔正門**——誤攔比漏擋嚴重，被擋的人會去走側門
+- E4 紅 ⇒ 又長出第二支平行的工具
+
+**真實跑（2026-09-07，雲端 session，isep-hand）**：
+`stage secret put` 把隨機值的 `ISEP_137_PROBE` 種進 youlin `arcrun-cypher-executor` → 不經工具用 CF API 列到
+`["ISEP_137_PROBE","KBDB_INTERNAL_TOKEN"]` → `stage secret delete` → 再列剩 `["KBDB_INTERNAL_TOKEN"]`（stage 恢復原狀）。
+`stage api GET arcrun-cypher-executor/health` → HTTP 200；`stage api POST arcrun-kbdb/map/recompute…` 不帶 Bearer → HTTP 401、離開碼 1（打到了、沒寫）；
+完整網址指到 leo21c → 拒絕、離開碼 2、零請求。
+⚠️ **帶 Bearer 真的寫進 stage KBDB** 這格沒跑——雲端 Cloud environment 沒有 `KBDB_INTERNAL_TOKEN`（它只住在安裝器中心側 KV，Arcrun#176 comment 6487 步驟 0）；
+`CF_SECRETS_API_TOKEN` 的真值是主線 B-3（Arcrun#86）的東西，由總管用 `stage secret put` 種，本票不編一個假的塞進去。
+⚠️ 「分類器真的不擋」與 A33 同款：要下一版裝進雲端之後，看一趟 run 的 `permission_denials`。
+
+### A37 — 打了 tag 之後那一站：把 tag 建成 leo 看得到的 release：14 條
+```
+bash scripts/test-release-ship.sh
+```
+**該看到**：`共 14 項：✅ 14 ／ ❌ 0`。全程離線（`RELEASE_SHIP_FIXTURE`＋`RELEASE_SHIP_SINK`），
+**不打 Gitea、不建任何真 release**。fixture 的形狀見 `hooks/lib/release_chain.py`。
+
+**它在守什麼**（`inkstone/ISEP#67`）：ISEP 全樹沒有任何東西會建 release，於是 tag 推了、
+Releases 頁停在舊版——08-27（v0.4.0／v0.5.0）、09-02（v0.22.0）、09-07（v0.23.0／v0.24.0）
+同一站斷了三輪；09-07 那次交棒給 leo 的「測試位置」打開是一頁空 tag。
+三個前置**必須在場**才放行：① **那個 tag 的樹**裡 `plugin.json` ＝ tag 號碼（問 Gitea `contents?ref=<tag>`，
+**不是工作樹**）② tag 真的在 Gitea ③ note 有內容（沒給就從 Gitea compare 生事實清單）。
+建完回頭跑 `release-check <那個 tag>` 拿收貨端覆核——送的人說成功不算數。
+
+**失敗**：
+- A1 紅 ⇒ tag 的樹自己講錯版本也建得了，leo 裝到的會各說各話
+- B4 那三條任一紅 ⇒ **前置①又回去比「最新的 tag」或工作樹了**——總管 09-07 在 v0.23.0 的 checkout
+  跑 `release-ship v0.23.0` 就是這樣被擋的（訊息說最新是 v0.24.0），這一組工作樹故意擺 `9.9.9`
+- B2 第二條紅 ⇒ 已存在的 release 被說成「已建立」（09-05 comment 6207 那句假綠，scout 6213 抓到的）
+- B3 第二條紅 ⇒ `--dry-run` 真的寫了東西
+
+**真實跑（2026-09-07，isep-hand，全部唯讀）**：工作樹在本分支（plugin.json 0.24.0）跑
+`release-ship v0.23.0 --dry-run` → 前置②✅、前置①「tag v0.23.0 的樹裡 plugin.json ＝ 0.23.0」✅、
+「本來就在了——不重複建、不動它」、覆核 `v0.23.0 ✅✅✅ ←`、exit 0（09-05 那版在同一情境是 exit 2）；
+`release-ship v0.3.4 --dry-run`（現存唯一沒 release 的 tag）走到「要建」那條路：note 從 Gitea compare 生 8 行、不 POST、exit 0。
+
+### A38 — 回頭問收貨端「到了嗎」，而且開場就會問：14 條＋信標 7 條
+```
+bash scripts/test-release-check.sh
+bash hooks/tests/isep-presence-beacon.test.sh        # ㉗–㉝ 那七條
+```
+**該看到**：`共 14 項：✅ 14 ／ ❌ 0`；信標 `通過 33 條，失敗 0 條`。全離線。
+
+**它在守什麼**（`inkstone/ISEP#67` → comment 6574，總管 09-07 裁定②）：「打了 tag 卻沒 release」
+要在**下一個 session 開場**就被報出來（一行：缺哪一站＋怎麼補），不靠人記得；兩者都在時安靜。
+`release-check` 逐版問 Gitea（匿名，D20），現行版本缺站 ⇒ exit 2 ＋指名缺哪一站＋補法（正本絕對路徑）；
+更舊版本缺件只黃字；**v0.19／0.20／0.21 已裁定不補**（同一則 comment 裁定①），表上標出處、不再黃字。
+信標 ④ 用同一份判準（`hooks/lib/release_chain.py`）：最新 tag 沒 release ⇒ 報；main 定版比最新 tag 新 ⇒ 報缺 tag；
+只快取「都在」6 小時，缺件不快取——補完的下一個 session 就該安靜。
+
+**失敗**：
+- A1／A2 紅 ⇒ 驗收 4 沒過：故意漏一站，管線說不出缺哪一站
+- A3 紅 ⇒ `release-check <版本>` 沒看你指定的那一版（release-ship 送完覆核會覆核到錯的版本）
+- B2 紅 ⇒ **誤攔**：現行版本好好的，舊版缺件卻擋下來（懲罰謹慎）
+- B4 紅 ⇒ 裁定過不補的三版又天天黃字（會被學會忽略）；或裁決把事實也改掉了（指定它來問應該照擋）
+- 信標 ㉗ 紅 ⇒ 開場報不出來，斷點又回到靠人記得；㉙ 紅 ⇒ **誤攔**：都在還念；
+  ㉚ 紅 ⇒ 問不到收貨端時亂猜；㉜ 紅 ⇒ 印了一條在這一份裡不存在的路徑當出路；㉝ 紅 ⇒ 補完還要念 6 小時
+
+**真實跑（2026-09-07）**：信標不帶 fixture 打真 Gitea（匿名）→ 安靜（v0.24.0 tag＋release 都在），
+留下 `.isep-chain-ok-v0.24.0` 快取；`release-check` 在本分支 → `v0.24.0 ✅✅✅ ←`、三個裁定不補的版本標 ⏭、exit 0。
+
 ### A5 — 開票前的搜尋是跨 repo 的
 ```
 python3 scripts/ticket where 標籤 模組化
@@ -1104,6 +1193,9 @@ B2（信標那行）／B3（setup 輸出）／B4（閘的訊息）三個畫面
 | **A33 權限白名單住 ISEP 一份** | isep-hand | ✅ 19/19（2026-09-07，inkstone/ISEP#130）；「分類器真的不擋」要雲端 run 的 `permission_denials` 才驗得到 |
 | **A34 收件 repo 寫 owner/repo 不 404** | isep-hand | ✅ 7/7（2026-09-07，inkstone/ISEP#130） |
 | **A35 Bot API 直送** | isep-hand | ✅ 10/10（2026-09-07）；**真的到 leo 手機**要 Cloud environment 先有 `TELEGRAM_BOT_TOKEN`／`TELEGRAM_CHAT_ID`（leo） |
+| **A36 雲端對 stage 的寫入有正門、只寫得進 stage** | isep-hand | ✅ 45/45（2026-09-07，inkstone/ISEP#137）＋真實種進 youlin 一把探針再刪掉、真打 stage GET 200／無 Bearer POST 401；「帶 Bearer 真寫 KBDB」缺 `KBDB_INTERNAL_TOKEN` 沒跑 |
+| **A37 tag → release 那一站** | isep-hand | ✅ 14/14（2026-09-07，inkstone/ISEP#67→6574）＋真 Gitea 唯讀 dry-run 兩次（v0.23.0 總管被擋的情境、v0.3.4 走到建那條路） |
+| **A38 回頭問收貨端＋開場會問** | isep-hand | ✅ 14/14＋信標 33/33（2026-09-07，inkstone/ISEP#67→6574）＋信標真 Gitea 匿名實跑一次安靜 |
 | A7 plugin 裝得起來 | 總管 | ✅ |
 | **A8 新 session 閘會觸發** | 總管 | 見本版 release note |
 | **B1–B5 雲端** | **leo** | 還沒跑（機器碰不到 Cloud environment） |

docs/cloud-session-bootstrap.md

@@ -201,9 +201,9 @@ $ curl … https://git.uncle6.me/api/v1/version                         → 200
 | 本機 daemon（`~/.arcrun-rag`、`~/.arcrun/config.yaml`）的改與驗 | 住在 leo 的家目錄 |
 | 用 `~/.wrangler` OAuth 登入態出貨到 uncle6 | 登入態不隨 clone 走（`make-cloud-env.sh` 檔頭記過） |
 | 要 leo 親手輸入的互動閘（`acr recipe push` 的暴露同意、密碼打進登入欄） | surface 層硬規則，誰都不能代 |
-| 打 youlin stage 的驗證 | **暫時**：egress proxy 擋（上一段）。leo 放行主機後這條就回到雲端 |
+| ~~打 youlin stage 的驗證~~ | 09-07 已回到雲端：`*.arcrun-yuga3bse.workers.dev` 從雲端 curl 200。**寫入走 `scripts/stage`**（secret／api，inkstone/ISEP#137），不再交回地端 |
 
-其餘（讀票、認領、留言、handback、寫 code、跑測試、開 PR、對 leo21c 唯讀查詢、發 Telegram）雲端全做。
+其餘（讀票、認領、留言、handback、寫 code、跑測試、開 PR、對 leo21c 唯讀查詢、發 Telegram、**種 secret／直推成品／POST 到 stage 實例**——走 `scripts/stage` 與 Arcrun 的 `stage-deploy-artifacts.py`）雲端全做。
 📌 這份清單的家是 `inkstone/InkStoneCo` 的 `cloud-worker.md`（票上驗收第 4 條），ISEP 只放草稿；併進去由總管做。
 
 ## 這張票沒動、也不會動的東西

docs/hooks-inventory.md

@@ -32,6 +32,12 @@
 > **兩個事件是同一件事的兩半**：只注入 ＝ 又一個會被忽略的提醒；只查核 ＝ 罰它做一件拿不到資料的事。
 > 這兩個數字是併之前當場數出來的，不是從上一版加減推出來的。
 
+> 📌 **`inkstone/ISEP#67`（2026-09-07）＋0 支、＋0 條、腳本 56→60**：沒加閘。`isep-presence-beacon.sh`
+> 多報一格 ④「打了 tag 卻沒 release」（改判準不加閘）；`scripts/` 多了運送鏈的兩站 `release-ship`／`release-check`
+> 與各自的測試，判準收在 `hooks/lib/release_chain.py` 一份三處用。
+> **61 支、85 條、60 支腳本是在這棵樹上當場數出來的**（`ls hooks/*.sh | wc -l`＝61、
+> `grep -c '"command":' hooks/hooks.json`＝85、`ls -p scripts | grep -v / | wc -l`＝60）。
+
 > 📌 **`inkstone/ISEP#130`（2026-09-07）＋0 支、＋1 條**：SessionStart 多掛一條
 > `scripts/settings-allow-sync --quiet`（不是閘，是腳本：把 ISEP 的權限白名單寫進這台的
 > `~/.claude/settings.json`，雲端才不會每個正門工具都被分類器擋）。
@@ -210,9 +216,9 @@
 
 | 閘名 | 對你意味著什麼 | 動作 |
 |---|---|---|
-| `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 注入） |
+| `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 本身的內容跟那張歸屬表對不對得上（雲端沒有專案那一份可比時，這是唯一還作數的檢查）③工作區有沒有已退役機制留下的產物 ④**打了 tag 卻沒 release**（Gitea 最新 tag 沒有 release、或 main 定版了還沒打 tag）——一行說缺哪一站＋可以直接貼著跑的補法（`scripts/release-ship`），都在時一個字都不說；判準跟 `release-ship`／`release-check` 同一份（`hooks/lib/release_chain.py`），匿名讀、問不到就閉嘴（`inkstone/ISEP#67`）。**全部只講不擋。** | 📝 記錄（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/settings-allow-sync --quiet` | （不是閘，是腳本）對話一開始把 ISEP 的權限白名單（`docs/permissions-allow.json`：`ticket`／`mainline`／`gate-ok`／`gitea-pr-merge`／`stage`（inkstone/ISEP#137 起，雲端對 stage 寫入的正門）五個正門工具，外加 Arcrun 的 `stage-deploy-artifacts.py`）寫進**這台機器**的 `~/.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 注入） |

docs/permissions-allow.json

@@ -4,12 +4,15 @@
     "leo 09-07 親手把四個 Gitea 正門工具（ticket／mainline／gate-ok／gitea-pr-merge）加進本機 InkStoneCo/.claude/settings.json，auto mode 的分類器才不擋。",
     "雲端 session 沒有那四條，同樣的動作照樣被擋（09-04 progress-guard run log：permission_denials=6）。",
     "薄殼 repo（GitHub）要 D20 開閘才推得動 ⇒ 白名單住 ISEP，`scripts/settings-allow-sync` 開工時寫進那台機器的 ~/.claude/settings.json。",
-    "以後加規則只改這個檔、出一版，雲端下一趟就有。"
+    "以後加規則只改這個檔、出一版，雲端下一趟就有。",
+    "inkstone/ISEP#137：09-07 雲端對 stage 的三種寫入（`npx wrangler secret put`／`stage-deploy-artifacts.py`／curl POST 到 arcrun-yuga3bse）全被分類器擋——複合指令與任意 curl 對不上任何一條前綴。收成 `scripts/stage`（secret／api 兩個子命令，只寫 stage、值只從環境變數名讀）四種形狀，外加 Arcrun 自己那支 `scripts/stage-deploy-artifacts.py`（它已寫死只認 youlin 帳號 ID、不收 --account／--token）從 Arcrun repo 根目錄的相對形狀。不放 `Bash(npx *)`／`Bash(wrangler *)`／`Bash(curl *)`。",
+    "inkstone/ISEP#67：SessionStart 信標印的補法是 `python3 <plugin root>/scripts/release-ship vX.Y.Z`——那一行在雲端要是被分類器擋，出路就走不通（閘的價值是「擋下來＋給一條走得通的路」）。release-ship 只 POST 一件事（建 release，tag 與 release 名寫死從 Gitea 讀）；release-check 純讀。"
   ],
   "_rules": [
     "開頭的 `~` 由 settings-allow-sync 換成那台機器的家目錄（本機 /Users/…、雲端 /root），其餘一字不改。",
     "只放「正門工具」：每一條都要說得出它是哪支腳本的哪種呼叫形狀。不放 Bash(python3 *) 這種整類放行。",
-    "同一支工具幾種呼叫形狀就幾條（快取路徑／$CLAUDE_PLUGIN_ROOT／相對路徑）——權限規則是逐條完全比對，形狀差一個字就落在規則之外（scripts/gate-ok 檔頭記過這一課）。"
+    "同一支工具幾種呼叫形狀就幾條（快取路徑／$CLAUDE_PLUGIN_ROOT／相對路徑）——權限規則是逐條完全比對，形狀差一個字就落在規則之外（scripts/gate-ok 檔頭記過這一課）。",
+    "別的 repo 的正門工具也可以進來（例 Arcrun 的 `scripts/stage-deploy-artifacts.py`），條件一樣：那支腳本自己把「只打哪台」寫死在程式裡，本清單放的是它從那個 repo 根目錄跑的相對形狀。"
   ],
   "allow": [
     "Bash(python3 ~/.claude/plugins/cache/inkstone/isep/*/scripts/ticket *)",
@@ -24,6 +27,19 @@
     "Bash(bash \"$CLAUDE_PLUGIN_ROOT/scripts/gate-ok\" *)",
     "Bash(bash \"$CLAUDE_PLUGIN_ROOT\"/scripts/gate-ok *)",
     "Bash(bash scripts/gate-ok *)",
-    "Bash(bash scripts/gitea-pr-merge.sh *)"
+    "Bash(bash scripts/gitea-pr-merge.sh *)",
+    "Bash(python3 ~/.claude/plugins/cache/inkstone/isep/*/scripts/stage *)",
+    "Bash(python3 \"$CLAUDE_PLUGIN_ROOT/scripts/stage\" *)",
+    "Bash(python3 \"$CLAUDE_PLUGIN_ROOT\"/scripts/stage *)",
+    "Bash(python3 scripts/stage *)",
+    "Bash(python3 scripts/stage-deploy-artifacts.py *)",
+    "Bash(python3 ~/.claude/plugins/cache/inkstone/isep/*/scripts/release-ship *)",
+    "Bash(python3 \"$CLAUDE_PLUGIN_ROOT/scripts/release-ship\" *)",
+    "Bash(python3 \"$CLAUDE_PLUGIN_ROOT\"/scripts/release-ship *)",
+    "Bash(python3 scripts/release-ship *)",
+    "Bash(python3 ~/.claude/plugins/cache/inkstone/isep/*/scripts/release-check *)",
+    "Bash(python3 \"$CLAUDE_PLUGIN_ROOT/scripts/release-check\" *)",
+    "Bash(python3 \"$CLAUDE_PLUGIN_ROOT\"/scripts/release-check *)",
+    "Bash(python3 scripts/release-check *)"
   ]
 }

hooks/lib/beacon_report.py

@@ -59,6 +59,76 @@ if MAIN and VER != "未知" and MAIN != VER:
     else:
         notes.append("ℹ️ 這一份比 ISEP main 新（載入 %s ／ main %s）——沒發版的改動只在這台機器上。" % (VER, MAIN))
 
+# ══ ④ 打了 tag 卻沒 release（運送鏈斷在 leo 看得到的那一站之前）═══════════
+#
+# 🔴 為什麼要在開場報（inkstone/ISEP#67 → comment 6574，總管 2026-09-07 裁定）：
+#     v0.23.0／v0.24.0 的 tag 都推了，Gitea Releases 頁卻停在 v0.22.0——
+#     交棒給 leo 的「測試位置 releases/tag/v0.24.0」打開是一頁空 tag。
+#   建 release 的工具（scripts/release-ship）在 09-05 就寫好了，但**沒有任何東西在
+#   下一個 session 開場說「你上一版少了一站」**——於是斷點靠人記得，而人沒記得。
+#   判準（與 release-ship／release-check 同一份：hooks/lib/release_chain.py）：
+#     · Gitea 上最新的 tag，它的 release 在不在 → 不在＝「打了 tag 沒 release」
+#     · main 宣稱的版本（①已經拿到的 MAIN）比最新 tag 新 → 「定版了沒打 tag」
+#   兩者都在 ⇒ 一個字都不說（天天念的東西會被學會忽略）。
+#   匿名讀（D20）、逾時 6 秒、問不到就閉嘴；只快取「都在」的結果 6 小時，
+#   缺件不快取——補完的下一個 session 就該安靜，不該再念 6 小時。
+def chain_gap():
+    """回 (版本, [(站, 補法)]) 或 None（問不到／沒有 tag／都在）。"""
+    fx = None
+    if os.environ.get("ISEP_BEACON_SKIP_NET") == "1":
+        fxp = os.environ.get("ISEP_BEACON_CHAIN_FIXTURE")
+        if not fxp:
+            return None
+        try:
+            fx = json.load(open(fxp, encoding="utf-8"))
+        except Exception:
+            return None
+    try:
+        sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+        import release_chain as rc
+    except Exception:
+        return None
+    ship = os.path.join(ROOT, "scripts", "release-ship")
+    ship_cmd = ("python3 %s" % ship) if os.path.isfile(ship) else \
+        "先 `claude plugin update isep@inkstone`（這一份 v%s 還沒有 scripts/release-ship）再跑 `python3 \"$CLAUDE_PLUGIN_ROOT\"/scripts/release-ship`" % VER
+    chain = rc.Chain(fixture=fx, timeout=6)
+    try:
+        tags = chain.tags()
+        if not tags:
+            return None
+        latest = max(tags, key=rc.vtuple)
+        cache = os.path.join(os.environ.get("ISEP_BEACON_CACHE_DIR", "/tmp"), ".isep-chain-ok-" + latest)
+        # main 定版了、tag 還沒打 ⇒ 缺的是 tag 那一站（MAIN 來自 ①，可能是 6 小時內的快取）
+        if MAIN and rc.vtuple(MAIN) > rc.vtuple(latest):
+            g = [(label, fix.format(v=MAIN, ship=ship_cmd)) for k, label, fix in rc.STATIONS if k == "tag"]
+            return MAIN, g
+        try:
+            if fx is None and time.time() - os.path.getmtime(cache) < 6 * 3600:
+                return None
+        except Exception:
+            pass
+        rels = chain.releases()
+        g = [(label, fix.format(v=latest.lstrip("v"), ship=ship_cmd))
+             for k, label, fix in rc.gaps(latest, tags, rels) if k == "release"]
+        if not g:
+            try:
+                open(cache, "w").write(latest)
+            except Exception:
+                pass
+            return None
+        return latest.lstrip("v"), g
+    except Exception:
+        return None
+
+cg = chain_gap()
+if cg:
+    ver_gap, stations = cg
+    notes.append(
+        "🔴 **v%s 送到一半：%s**——leo 那頁（Gitea Releases）看不到這一版，對他等於不存在。"
+        "補：%s（inkstone/ISEP#67）"
+        % (ver_gap, "、".join("缺 " + label for label, _f in stations),
+           "；".join(fix for _l, fix in stations)))
+
 # ══ ② 專案裡有沒有 ISEP 腳本的舊複本在遮蔽正門 ══════════════════════════
 #
 # 🔴 實例（inkstone/ISEP#90 ②）：`InkStoneCo/scripts/ticket` 是 ISEP `scripts/ticket`

hooks/lib/release_chain.py

@@ -0,0 +1,220 @@
+"""release_chain — ISEP 運送鏈「tag → release」那兩站的**收貨端事實**，一份定義三處用
+（inkstone/ISEP#67）
+
+誰在用：
+    scripts/release-ship        送貨：把已推的 tag 建成 release（前置條件從這裡問）
+    scripts/release-check       覆核：逐版問 Gitea「到了嗎」
+    hooks/lib/beacon_report.py  開場：SessionStart 報「打了 tag 卻沒 release」
+
+🔴 為什麼收成一份：09-05 那版 release-ship／release-check 各自抄了一套「問 Gitea」
+   的程式碼；要再讓 SessionStart 也問一次，就是第三份。同一個判準散在三處，
+   修一份不會帶動另外兩份——`leo21c-write-guard.sh` 那一族就是這樣漂掉的
+   （system-dev/wiki/mistakes.md 2026-09-07）。
+
+🔴 讀一律匿名（D20：讀不帶憑證＝自由、不計次）。inkstone/ISEP 是公開 repo，
+   tags／releases／某個 tag 底下的檔案／兩個 tag 之間的 commit 都不需要 token。
+   只有 401／403 才退回帶 token 再試一次；token 只有 POST（建 release）才是必要的。
+
+判準是結構不是關鍵字：某一版「送到了沒」＝它的 tag 與 release **在不在** Gitea 上。
+
+離線：每個入口各自把 fixture dict 傳進來（鍵：tags／releases／manifest／commits），
+      不打網路。fixture 的形狀在 `Chain.__init__` 的註解。
+"""
+import base64
+import json
+import os
+import re
+import subprocess
+import urllib.error
+import urllib.request
+
+DEFAULT_HOST = "https://git.uncle6.me"
+DEFAULT_REPO = "inkstone/ISEP"
+MANIFEST_PATH = ".claude-plugin/plugin.json"
+
+# 運送鏈的三站：鍵、人話、怎麼補（補法的指令由呼叫端決定要不要換成絕對路徑）
+STATIONS = [
+    ("dingban", "定版 commit",
+     "在 main 上 commit 一顆 `定版 v{v}`（＝ plugin.json 也改成那一版）"),
+    ("tag", "tag（Gitea）",
+     "打並推 tag：`git tag v{v} && git push origin v{v}`"),
+    ("release", "release（Gitea）",
+     "建 release：`{ship} v{v}`（這一站就是最常斷的那站）"),
+]
+
+
+class ChainError(Exception):
+    """問不到收貨端（網路／HTTP 非 404）。呼叫端自己決定要死還是要閉嘴。"""
+
+
+def vtuple(v):
+    nums = re.findall(r"\d+", v or "")
+    return tuple(int(x) for x in nums[:3]) if nums else (0,)
+
+
+def tagname(v):
+    v = (v or "").strip()
+    return v if v.startswith("v") else "v" + v
+
+
+def token_from_env_or_remote(host, root=None):
+    """建 release 才用得到。環境變數優先；沒有就從 remote URL 裡撈（bootstrap 會帶）。"""
+    for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
+        if os.environ.get(env):
+            return os.environ[env]
+    if not root:
+        return ""
+    h = 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 h in line:
+            m = re.search(r"//[^:/]+:([^@]+)@", line)
+            if m:
+                return m.group(1)
+    return ""
+
+
+class Chain:
+    """一個 repo 的運送鏈收貨端。
+
+    fixture（離線用）的形狀：
+        {"tags": ["v0.24.0", ...],
+         "releases": ["v0.23.0", ...],
+         "manifest": {"v0.24.0": "0.24.0", ...},     # 那個 tag 底下 plugin.json 的 version
+         "commits": {"v0.23.0...v0.24.0": ["定版 v0.24.0（…）", "..."],   # 兩 tag 之間的 commit 標題
+                     "v0.24.0": ["…"]}}                                     # 沒有上一個 release 時
+    """
+
+    def __init__(self, host=None, repo=None, fixture=None, timeout=25, token=None):
+        self.host = (host or DEFAULT_HOST).rstrip("/")
+        self.repo = repo or DEFAULT_REPO
+        self.fx = fixture
+        self.timeout = timeout
+        self.token = token
+
+    # ── HTTP：匿名優先 ───────────────────────────────────────────────────
+    def _get(self, path, params=""):
+        url = "%s/api/v1/repos/%s/%s%s" % (self.host, self.repo, path, params)
+        headers = {"Cache-Control": "no-cache"}   # 09-05 實撞：邊緣快取的舊值被當 live
+        for attempt in (0, 1):
+            if attempt == 1:
+                if not self.token:
+                    raise ChainError("Gitea 對匿名讀回 401／403，而這裡沒有 token：%s" % url)
+                headers["Authorization"] = "token " + self.token
+            req = urllib.request.Request(url, headers=headers)
+            try:
+                with urllib.request.urlopen(req, timeout=self.timeout) as r:
+                    return json.load(r)
+            except urllib.error.HTTPError as e:
+                if e.code == 404:
+                    return None
+                if e.code in (401, 403) and attempt == 0:
+                    continue
+                raise ChainError("Gitea %s：%s %s" % (e.code, url, e.read().decode()[:200]))
+            except Exception as e:
+                raise ChainError("連不上 %s：%s" % (url, e))
+        return None
+
+    def _names(self, path, key):
+        names, page = set(), 1
+        while True:
+            rows = self._get(path, "?limit=50&page=%d" % page) or []
+            for r in rows:
+                n = r.get(key)
+                if n:
+                    names.add(n)
+            if len(rows) < 50:
+                return names
+            page += 1
+
+    # ── 收貨端事實 ───────────────────────────────────────────────────────
+    def tags(self):
+        if self.fx is not None:
+            return set(self.fx.get("tags") or [])
+        return self._names("tags", "name")
+
+    def releases(self):
+        if self.fx is not None:
+            return set(self.fx.get("releases") or [])
+        return self._names("releases", "tag_name")
+
+    def release(self, tag):
+        """這個 tag 的 release（dict），沒有就 None。"""
+        if self.fx is not None:
+            return {"tag_name": tag, "html_url": "(fixture)"} if tag in self.releases() else None
+        return self._get("releases/tags/%s" % tag)
+
+    def manifest_version_at(self, tag):
+        """那個 tag 的樹裡 plugin.json 宣稱的版本（None ＝ tag 不在或檔案不在）。
+
+        🔴 這是 release-ship 前置①的對象：**要建 release 的那個 tag 的樹**，
+        不是「現在 checkout 出來的工作樹」——工作樹可能是任何分支，跟那個 tag 無關。
+        """
+        if self.fx is not None:
+            return (self.fx.get("manifest") or {}).get(tag)
+        d = self._get("contents/%s" % MANIFEST_PATH, "?ref=%s" % tag)
+        if not d:
+            return None
+        try:
+            raw = base64.b64decode(d.get("content") or "").decode("utf-8")
+            return (json.loads(raw) or {}).get("version")
+        except Exception:
+            return None
+
+    def commits_between(self, base, head):
+        """base（可 None）到 head 之間的 commit 標題，**不含 merge commit**，舊在前。"""
+        key = ("%s...%s" % (base, head)) if base else head
+        if self.fx is not None:
+            return list((self.fx.get("commits") or {}).get(key) or [])
+        if base:
+            d = self._get("compare/%s...%s" % (base, head)) or {}
+            rows = d.get("commits") or []
+        else:
+            rows = self._get("commits", "?sha=%s&limit=50&stat=false&verification=false&files=false" % head) or []
+            rows = list(reversed(rows))
+        out = []
+        for c in rows:
+            if len(c.get("parents") or []) > 1:
+                continue
+            msg = ((c.get("commit") or {}).get("message") or "").strip()
+            if msg:
+                out.append(msg.splitlines()[0])
+        return out
+
+    def tag_commit_message(self, tag):
+        """tag 指到的那顆 commit 的完整訊息（取 `定版 vX（人話）` 用）。"""
+        if self.fx is not None:
+            for lines in (self.fx.get("commits") or {}).values():
+                for line in lines:
+                    if "定版" in line and tag.lstrip("v") in line:
+                        return line
+            return ""
+        t = self._get("tags/%s" % tag)
+        sha = ((t or {}).get("commit") or {}).get("sha")
+        if not sha:
+            return ""
+        c = self._get("git/commits/%s" % sha) or {}
+        return ((c.get("commit") or {}).get("message") or "")
+
+    # ── 判準 ─────────────────────────────────────────────────────────────
+    def latest_release_before(self, ver, releases=None):
+        rels = releases if releases is not None else self.releases()
+        older = [t for t in rels if vtuple(t) < vtuple(ver)]
+        return max(older, key=vtuple) if older else None
+
+
+def gaps(ver, tags, releases, dingban=True):
+    """某一版缺哪幾站 → [(key, label, fix_template)]，按運送順序。空 list ＝ 都在。"""
+    t = tagname(ver)
+    present = {"dingban": dingban, "tag": t in tags, "release": t in releases}
+    return [(k, label, fix) for k, label, fix in STATIONS if not present[k]]
+
+
+def dingban_title(message, ver):
+    """從 `定版 vX.Y.Z（一句人話）` 抓括號那句——leo 既有 release 的命名慣例。"""
+    m = re.search(r"定版\s+v?%s[（(]([^）)]+)[）)]" % re.escape(ver.lstrip("v")), message or "")
+    return m.group(1).strip() if m else None

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

@@ -24,6 +24,7 @@ mkplugin() {
     > "$d/hooks/hooks.json"
   cp "$HOOK" "$d/hooks/$(basename "$HOOK")"
   cp "$REAL_HOOKS/lib/beacon_report.py" "$d/hooks/lib/beacon_report.py"
+  cp "$REAL_HOOKS/lib/release_chain.py" "$d/hooks/lib/release_chain.py"
   printf '#!/bin/sh\necho real\n' > "$d/scripts/ticket"
   # inkstone/ISEP#122：會自動載入的東西（skill／command／agent）也要造得出來
   mkdir -p "$d/skills/demo" "$d/commands" "$d/agents" "$d/docs"
@@ -190,6 +191,43 @@ out=$(run "$P2" "$JS")
 check "㉖ ②b 有報告時，那行綠色信標仍在且 JSON 合法" "$out" \
   "🟢 ISEP v1.0.0 已載入" "!__BADJSON__"
 
+echo "── ④打了 tag 卻沒 release（inkstone/ISEP#67 → 6574）──────────────────"
+# 🔴 這一組守的是 09-07 那件：v0.23.0／v0.24.0 tag 都推了、Releases 頁停在 v0.22.0，
+#    交棒給 leo 的測試位置打開是一頁空 tag。開場要說「缺哪一站＋怎麼補」，都在時安靜。
+P4=$(mkplugin 0.24.0); printf '#!/usr/bin/env python3\n' > "$P4/scripts/release-ship"
+FX4="$TMP/chain-gap.json"
+printf '{"tags":["v0.24.0","v0.23.0"],"releases":["v0.23.0"]}\n' > "$FX4"
+out=$(ISEP_BEACON_CHAIN_FIXTURE="$FX4" run "$P4" "$J")
+check "㉗ 最新 tag v0.24.0 沒有 release → 一行說缺哪一站＋怎麼補（正本絕對路徑）" "$out" \
+  "v0.24.0 送到一半" "缺 release（Gitea）" "python3 $P4/scripts/release-ship v0.24.0" "inkstone/ISEP#67"
+check "㉘ 信標那一行仍在、JSON 合法" "$out" "🟢 ISEP v0.24.0 已載入" "!__BADJSON__"
+
+FX4b="$TMP/chain-ok.json"
+printf '{"tags":["v0.24.0","v0.23.0"],"releases":["v0.24.0","v0.23.0"]}\n' > "$FX4b"
+out=$(ISEP_BEACON_CHAIN_FIXTURE="$FX4b" run "$P4" "$J")
+check "㉙ tag 與 release 都在 → 一個字都不說（天天念會被學會忽略）" "$out" "!送到一半" "!缺 release"
+
+out=$(run "$P4" "$J")
+check "㉚ 問不到收貨端（沒網路、沒 fixture）→ 閉嘴，不猜" "$out" "!送到一半" "🟢 ISEP v0.24.0 已載入"
+
+out=$(ISEP_FAKE_MAIN_VERSION=0.25.0 ISEP_BEACON_CHAIN_FIXTURE="$FX4b" run "$P4" "$J")
+check "㉛ main 定版到 0.25.0、Gitea 最新 tag 還是 v0.24.0 → 說缺 tag 站＋push tag 的補法" "$out" \
+  "v0.25.0 送到一半" "缺 tag（Gitea）" "git push origin v0.25.0"
+
+P4o=$(mkplugin 0.21.0)   # 載入的這一份還沒有 scripts/release-ship（舊版）
+out=$(ISEP_BEACON_CHAIN_FIXTURE="$FX4" run "$P4o" "$J")
+check "㉜ 載入的這一份還沒有 release-ship → 補法先教 plugin update，不印一條不存在的路徑" "$out" \
+  "v0.24.0 送到一半" "claude plugin update isep@inkstone" "!python3 $P4o/scripts/release-ship"
+
+# 只快取「都在」：缺件那次不留快取，補完的下一個 session 立刻安靜；都在那次留快取
+rm -f "$TMP"/.isep-chain-ok-*
+out=$(ISEP_BEACON_CHAIN_FIXTURE="$FX4" run "$P4" "$J")
+[ ! -e "$TMP/.isep-chain-ok-v0.24.0" ] && r1=1 || r1=0
+out=$(ISEP_BEACON_CHAIN_FIXTURE="$FX4b" run "$P4" "$J")
+[ -e "$TMP/.isep-chain-ok-v0.24.0" ] && r2=1 || r2=0
+N=$((N+1)); if [ "$r1$r2" = "11" ]; then printf '  ✅ ㉝ 缺件不快取、都在才快取（補完下一個 session 就安靜）\n'; PASS=$((PASS+1))
+else printf '  ❌ ㉝ 快取方向錯了（缺件留了快取=%s／都在沒留=%s）\n' "$((1-r1))" "$((1-r2))"; FAIL=$((FAIL+1)); fi
+
 echo
 printf '通過 %s 條，失敗 %s 條（共 %s 條）\n' "$PASS" "$FAIL" "$N"
 [ "$FAIL" = 0 ] || exit 1

scripts/release-check

@@ -0,0 +1,255 @@
+#!/usr/bin/env python3
+"""release-check — 回頭問「這一版真的送到了嗎」，而且**問的人不是送的人**
+                  （inkstone/ISEP#67）
+
+leo 2026-08-27 的病（票上原文）：
+    「版本只到 ISEP v0.3.9，你有新版為什麼不推？」
+    v0.4.0／v0.5.0 的 tag 早就推了，但 Gitea Releases 頁停在 v0.3.9
+    ⇒ 對 leo 等於這兩版不存在；claude plugin list 也還顯示舊版。
+2026-09-07 又一次：v0.23.0／v0.24.0 打了 tag，Releases 頁停在 v0.22.0——
+    交棒給 leo 的「測試位置 releases/tag/v0.24.0」打開是一頁空 tag。
+
+ISEP 的運送鏈有這幾段，**每一段都要有人回頭問「到了嗎」**：
+
+    定版 commit  →  tag（Gitea）  →  release（Gitea）  →  main 的 plugin.json
+                                                       →  這個 session 真的載入到的版本
+
+🔴 這支的全部價值在一句話：**它不聽上一站說「我送了」，它自己去問收貨的那一端。**
+   tag 在不在 → 問 Gitea 的 tags；release 在不在 → 問 Gitea 的 releases（leo 會看的那頁）；
+   載入到了沒 → 看這個 session 真的掛著的那一份 plugin.json。
+   問的方式全部匿名（D20：讀不帶憑證），判準與 release-ship／SessionStart 信標同一份
+   （hooks/lib/release_chain.py）。
+
+用法：
+    release-check              現行版本 ＝ 這棵樹 plugin.json 宣稱的那一版
+    release-check v0.23.0      現行版本 ＝ 你指定的那一版（release-ship 送完拿來覆核**那一版**，
+                               不管工作樹現在 checkout 在哪）
+
+判準是**結構**，不是關鍵字（leo 2026-08-17 已證偽關鍵字黑名單：8 次誤攔、0 次正確）：
+   · 哪些版本「應該」被送到 ＝ main 上有 `定版 vX.Y.Z` commit 的那些（git 說了算，不是猜）
+   · 那個版本「送到了沒」＝ 去 Gitea 問它的 tag 與 release 在不在（在＝到了）
+
+離開碼：
+    0  現行版本 **tag 與 release 都在** ⇒ 送貨端完成
+    2  現行版本缺 tag 或缺 release ⇒ **送貨端斷了**，stderr 講出缺哪一站＋怎麼補
+       （這正是工單驗收 4：「故意漏一步 → 管線要擋下來並說出缺哪一站」）
+  說明：比現行版本更舊的 `定版` 版本若缺 tag／release，只**黃字提醒**、不改離開碼——
+       它們多半已被新版取代，硬擋等於「懲罰謹慎」（over-block 比 under-block 嚴重）。
+       v0.19／0.20／0.21 就是總管 09-07 裁定「不補」的那三個。
+       載入端落後（這個 session 跑的比 main 舊）也只提醒：那要 update＋重啟，
+       是收貨端的動作，不是送貨端能修的，且 SessionStart 信標本來就一直在報。
+
+離線測試：`scripts/test-release-check.sh`（走 `RELEASE_CHECK_FIXTURE`，不打 Gitea）。
+"""
+import json
+import os
+import re
+import subprocess
+import sys
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+sys.path.insert(0, os.path.join(HERE, "..", "hooks", "lib"))
+try:
+    import release_chain as rc
+except Exception as e:                       # pragma: no cover
+    print("🔴 讀不到 hooks/lib/release_chain.py：%s" % e, file=sys.stderr)
+    sys.exit(2)
+
+HOST = os.environ.get("RELEASE_CHECK_HOST", rc.DEFAULT_HOST)
+REPO = os.environ.get("RELEASE_CHECK_REPO", rc.DEFAULT_REPO)
+FIXTURE = os.environ.get("RELEASE_CHECK_FIXTURE", "")
+
+
+def die(msg, code=2):
+    print(msg, file=sys.stderr)
+    sys.exit(code)
+
+
+def proj_root():
+    """這支腳本操作的那個 ISEP repo 的根。"""
+    v = os.environ.get("CLAUDE_PROJECT_DIR")
+    if v and os.path.isfile(os.path.join(v, ".claude-plugin", "plugin.json")):
+        return v
+    return os.path.dirname(HERE)
+
+
+def load_fixture():
+    if not FIXTURE:
+        return None
+    try:
+        with open(FIXTURE) as f:
+            return json.load(f)
+    except Exception:
+        die("🔴 讀不到 RELEASE_CHECK_FIXTURE：%s" % FIXTURE)
+
+
+FX = load_fixture()
+CHAIN = rc.Chain(HOST, REPO, fixture=FX)
+
+# 🔴 裁定不補的歷史版本（唯一識別碼往放行方向比對，不是關鍵字）：
+#   總管 2026-09-07（inkstone/ISEP#67 → comment 6574）：「v0.19／0.20／0.21 不補——
+#   沒 tag，v0.22.0 的 note 已列到那三個定版。」這三個定版 commit 永遠在 main 上，
+#   不列在這裡它們就會每次都黃字——天天念的東西會被學會忽略，等於不存在。
+WAIVED = {"0.19.0": "inkstone/ISEP#67 → 6574", "0.20.0": "inkstone/ISEP#67 → 6574",
+          "0.21.0": "inkstone/ISEP#67 → 6574"}
+
+
+# ══ 送貨端事實：main 上「定版」了哪些、現在宣稱哪一版、這個 session 載到哪一版 ══
+def dingban_versions():
+    """main 上有 `定版 vX.Y.Z` commit 的版本 —— 「應該被送到」的權威清單。"""
+    if FX is not None:
+        return list(FX.get("dingban") or [])
+    root = proj_root()
+    try:
+        out = subprocess.run(
+            ["git", "-C", root, "log", "--format=%s", "--grep", "定版 v"],
+            capture_output=True, text=True, timeout=30).stdout
+    except Exception:
+        out = ""
+    seen, vers = set(), []
+    for line in out.splitlines():
+        m = re.search(r"定版\s+v?(\d+\.\d+\.\d+)", line)
+        if m and m.group(1) not in seen:
+            seen.add(m.group(1))
+            vers.append(m.group(1))
+    return vers
+
+
+def current_version():
+    """plugin.json 現在宣稱的那一版（＝ main 要送出去的那一版）。"""
+    if FX is not None:
+        return FX.get("current") or ""
+    try:
+        with open(os.path.join(proj_root(), ".claude-plugin", "plugin.json")) as f:
+            return json.load(f).get("version") or ""
+    except Exception:
+        return ""
+
+
+def loaded_version():
+    """這個 session 真的掛著的那一份 plugin 是哪一版（收貨端最後一段）。
+
+    拿不到就回 None —— 不猜、不謊稱到了（house style：不知道就說不知道）。
+    """
+    if FX is not None:
+        return FX.get("loaded")
+    root = os.environ.get("CLAUDE_PLUGIN_ROOT")
+    if not root:
+        return None
+    try:
+        with open(os.path.join(root, ".claude-plugin", "plugin.json")) as f:
+            return json.load(f).get("version")
+    except Exception:
+        return None
+
+
+# ══ 覆核：逐版問「到了嗎」 ════════════════════════════════════════════════
+def audit(focus=None):
+    cur = focus or current_version()
+    if not cur:
+        die("🔴 讀不到 .claude-plugin/plugin.json 的 version —— 這不是 ISEP repo，或檔案壞了。")
+    dingban = dingban_versions()
+    if cur not in dingban:
+        # 現行版本連 `定版` commit 都沒有 ⇒ plugin.json 宣稱了一個沒被定版的號碼。
+        # 這是 check-version-consistency 那條線的病，不是這支的守備範圍——但要講出來。
+        dingban = [cur] + dingban
+    try:
+        tags = CHAIN.tags()
+        rels = CHAIN.releases()
+    except rc.ChainError as e:
+        die("🔴 問不到收貨端，這一支不猜：%s" % e)
+
+    rows = []
+    for v in sorted(set(dingban), key=rc.vtuple, reverse=True):
+        rows.append({
+            "ver": v,
+            "dingban": True,   # 這份清單本來就是從 定版 commit 來的
+            "tag": rc.tagname(v) in tags,
+            "release": rc.tagname(v) in rels,
+            "current": v == cur,
+            "gaps": rc.gaps(v, tags, rels),
+            "waived": WAIVED.get(v) if v != cur else None,
+        })
+    return cur, rows
+
+
+def ship_cmd():
+    """補 release 的那一行要能直接貼著跑：印正本自己的絕對路徑（mistakes.md 2026-08-31）。"""
+    return "python3 %s" % os.path.join(HERE, "release-ship")
+
+
+def report(focus=None):
+    cur, rows = audit(focus)
+    loaded = loaded_version()
+    icon = {True: "✅", False: "❌"}
+    lines = ["ISEP 運送鏈覆核（收貨端事實，不聽送的人說）  repo=%s" % REPO, ""]
+    lines.append("  版本        定版  tag   release   （← ＝%s）"
+                 % ("你指定的版本" if focus else "現行 plugin.json 宣稱的版本"))
+    for r in rows:
+        mark = " ←" if r["current"] else ""
+        if r["waived"] and r["gaps"]:
+            mark = "  ⏭ 裁定不補（%s）" % r["waived"]
+        lines.append("  %-10s %s    %s     %s%s" % (
+            "v" + r["ver"], icon[r["dingban"]], icon[r["tag"]], icon[r["release"]], mark))
+
+    # ── 載入端（這個 session）──────────────────────────────────────────
+    lines.append("")
+    if loaded is None:
+        lines.append("  載入端：這個 context 讀不到 CLAUDE_PLUGIN_ROOT ⇒ 說不出「這個 session 載到哪一版」"
+                     "（不是 session 裡跑的，或沒裝 plugin）。")
+    elif rc.vtuple(loaded) < rc.vtuple(cur):
+        lines.append("  🟡 載入端落後：這個 session 掛的是 v%s，main 已到 v%s。" % (loaded, cur))
+        lines.append("     修：本機 `claude plugin update isep@inkstone` **並重啟 session**"
+                     "（升版與生效是兩件事）；雲端去動一下 Environment 的 setup script 逼它重拍快照。")
+        lines.append("     這一段 SessionStart 信標本來就一直在報（beacon_report.py ①）。")
+    else:
+        lines.append("  ✅ 載入端：這個 session 掛的是 v%s，跟 main 宣稱的一致。" % loaded)
+
+    # ── 判決 ────────────────────────────────────────────────────────────
+    currow = next((r for r in rows if r["current"]), None)
+    hard = currow["gaps"] if currow else []
+    older_gaps = [r for r in rows if not r["current"] and r["gaps"] and not r["waived"]]
+
+    lines.append("")
+    if hard:
+        lines.append("🔴 **現行版本 v%s 的送貨端斷了** —— 對 leo 等於這一版不存在：" % cur)
+        for _key, label, fix in hard:
+            lines.append("     缺這一站：%s" % label)
+            lines.append("        怎麼補：%s" % fix.format(v=cur, ship=ship_cmd()))
+        if older_gaps:
+            lines.append("   （另外還有更舊的版本也缺，見下方黃字，但那些不擋。）")
+    else:
+        lines.append("✅ 現行版本 v%s：定版、tag、release 都在 —— 送貨端完成，leo 那頁看得到。" % cur)
+
+    if older_gaps:
+        lines.append("")
+        lines.append("🟡 更舊的定版版本也缺件（多半已被新版取代，只提醒、不擋）：")
+        for r in older_gaps:
+            lines.append("     v%s 缺：%s" % (r["ver"], "＋".join(label for _k, label, _f in r["gaps"])))
+        lines.append("     要補歷史版本 ⇒ 逐版 `%s v<版本>`；"
+                     "確定不補 ⇒ 這是 leo／總管的決定，記一句在 inkstone/ISEP#67"
+                     "（v0.19／0.20／0.21 已於 2026-09-07 裁定不補）。" % ship_cmd())
+
+    out = "\n".join(lines)
+    if hard:
+        print(out, file=sys.stderr)
+        return 2
+    print(out)
+    return 0
+
+
+def main(argv):
+    focus = None
+    for a in argv:
+        if a in ("-h", "--help"):
+            print(__doc__)
+            return 0
+        m = re.match(r"^v?(\d+\.\d+\.\d+)$", a.strip())
+        if not m:
+            die("用法：release-check [vX.Y.Z]（--help 看說明）；不認得：%s" % a)
+        focus = m.group(1)
+    return report(focus)
+
+
+if __name__ == "__main__":
+    sys.exit(main(sys.argv[1:]))

scripts/release-ship

@@ -0,0 +1,290 @@
+#!/usr/bin/env python3
+"""release-ship — 把「已經推上去的 tag」變成「leo 那頁看得到的 release」
+                 （inkstone/ISEP#67，對應 arcrun-rag 的 release-record 站）
+
+工單抓到的斷點，一句話：**沒有任何東西會建 release。**
+    ISEP repo 全樹 grep「建 release」的 API 呼叫 → 0 命中。
+    後果：tag 早就推了，Gitea Releases 頁卻停在舊版
+    ⇒ 對 leo 等於這一版不存在（「ISEP 現在是哪一版」只有 Releases 答得出來）。
+    08-27 v0.4.0／v0.5.0、09-02 v0.22.0、09-07 v0.23.0／v0.24.0——同一站斷了三輪。
+
+這支就是補上那一站。它**只做 tag → release** 這一段，不打 tag、不改 plugin.json、
+不碰 main —— 打 tag 是 `release-tag-guard.sh` 在管的、總管驗過整個 milestone 之後的動作。
+
+🔴 送之前，三件事「必須在場」才放行（require-something-present，不是關鍵字黑名單）：
+   ① **那個 tag 的樹**裡 `plugin.json` 的 version ＝ 這個 tag 的號碼。
+      比對的對象是 tag 自己的樹（問 Gitea `contents/…?ref=<tag>`），**不是工作樹**。
+      🔴 09-05 那版拿 `check-version-consistency.sh`（工作樹 plugin.json vs 本機最新 tag）
+      當前置①，結果對「不是最新的那個 tag」永遠建不了：總管在 v0.23.0 的 checkout
+      跑 `release-ship v0.23.0` 被擋，訊息說最新 tag 是 v0.24.0——而 v0.23.0 的樹
+      明明就一致。**要送的東西是 tag，判它的就該看它的樹**；工作樹可能是任何分支
+      （這支本身就是在一條 feature 分支上寫的），跟那個 tag 沒有關係。
+      `check-version-consistency.sh` 守的是「main 上 plugin.json 跟最新 tag 一致」，
+      那是打 tag 那一刻的事（release-tag-guard.sh），不是建 release 這一刻的事。
+   ② tag 真的在 Gitea 上：去問收貨端，不在就不給建 release（先去推 tag）。
+   ③ release note 有內容：沒給 `--notes-file` 就從 Gitea「上一個 release ⋯ 這個 tag」
+      的 compare 自動生一份**事實**清單（哪幾顆 commit，不含 merge）——leo 可以再改，但不留白。
+      問 Gitea 而不是本機 git log：這支從 plugin 快取目錄跑時**旁邊沒有 git repo**。
+
+🔴 送完**自己不算數**：最後回頭跑一次 `release-check <這個 tag>`，拿收貨端（Gitea releases 頁）
+   的事實覆核「真的建起來了」。送的人說成功不算，問收貨的那一端才算
+   （工單：「問的人不能是送的人」）。
+
+讀全部匿名（D20），只有 POST 建 release 才要 token
+（`GITEA_TOKEN_CLAUDE_CODE`／`GITEA_TOKEN`，或這個 repo remote URL 裡帶的那把）。
+
+冪等：release 已經在了 ⇒ 報「本來就在」、離開碼 0，不重複建、不報錯、**不動它的內容**。
+
+離開碼：0 ＝ release 在 Gitea 上了（新建的或本來就在）
+        2 ＝ 某個前置條件沒滿足（stderr 講出是哪一個＋怎麼補）
+
+離線測試：`scripts/test-release-ship.sh`（走 `RELEASE_SHIP_FIXTURE`，不打 Gitea、不建真 release）。
+"""
+import json
+import os
+import re
+import subprocess
+import sys
+import urllib.error
+import urllib.request
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+sys.path.insert(0, os.path.join(HERE, "..", "hooks", "lib"))
+try:
+    import release_chain as rc
+except Exception as e:                       # pragma: no cover
+    print("🔴 讀不到 hooks/lib/release_chain.py：%s" % e, file=sys.stderr)
+    sys.exit(2)
+
+HOST = os.environ.get("RELEASE_SHIP_HOST", rc.DEFAULT_HOST)
+REPO = os.environ.get("RELEASE_SHIP_REPO", rc.DEFAULT_REPO)
+FIXTURE = os.environ.get("RELEASE_SHIP_FIXTURE", "")
+VER_RE = re.compile(r"^v?(\d+\.\d+\.\d+)$")
+
+
+def die(msg, code=2):
+    print(msg, file=sys.stderr)
+    sys.exit(code)
+
+
+def proj_root():
+    v = os.environ.get("CLAUDE_PROJECT_DIR")
+    if v and os.path.isfile(os.path.join(v, ".claude-plugin", "plugin.json")):
+        return v
+    return os.path.dirname(HERE)
+
+
+def load_fixture():
+    if not FIXTURE:
+        return None
+    try:
+        with open(FIXTURE) as f:
+            return json.load(f)
+    except Exception:
+        die("🔴 讀不到 RELEASE_SHIP_FIXTURE：%s" % FIXTURE)
+
+
+FX = load_fixture()
+CHAIN = rc.Chain(HOST, REPO, fixture=FX)
+
+
+def ask(fn, *a):
+    """問收貨端；問不到就死（不猜）。"""
+    try:
+        return fn(*a)
+    except rc.ChainError as e:
+        die("🔴 問不到收貨端 %s：%s" % (HOST, e))
+
+
+# ══ 前置條件 ③ release note ════════════════════════════════════════════
+def auto_notes(tagname, releases):
+    """從 Gitea compare 生一份事實 note：上一個 release 之後到這個 tag 之間的 commit。"""
+    since = CHAIN.latest_release_before(tagname, releases)
+    subjects = ask(CHAIN.commits_between, since, tagname)
+    head = ("這一版收了以下改動（%s 之後）：" % since) if since else "這一版收了以下改動："
+    body = "\n".join("- %s" % s for s in subjects)
+    if not body:
+        body = "-（Gitea 取不到 commit 清單，請手動補；release 已建起來，leo 可直接編輯。）"
+    return ("%s\n\n%s\n\n---\n（本 note 由 scripts/release-ship 從 git log 自動生成，"
+            "leo／總管可直接在 Gitea 上編輯。inkstone/ISEP#67）" % (head, body))
+
+
+def release_name(tagname):
+    """`vX.Y.Z — 定版 commit 括號那句人話`，對齊 leo 既有 release 的命名慣例；找不到就純 tag 名。"""
+    ver = tagname.lstrip("v")
+    msg = ask(CHAIN.tag_commit_message, tagname)
+    title = rc.dingban_title(msg, ver)
+    if not title:
+        for s in ask(CHAIN.commits_between, None, tagname)[-20:]:
+            title = rc.dingban_title(s, ver)
+            if title:
+                break
+    return ("%s — %s" % (tagname, title)) if title else tagname
+
+
+# ══ 真的建 release（POST 收貨端）═══════════════════════════════════════════
+def create_release(tagname, notes, dry, name):
+    payload = {"tag_name": tagname, "name": name, "body": notes,
+               "draft": False, "prerelease": False}
+    if dry:
+        return None, "🧪 --dry-run：不 POST。要建的 release payload：\n%s" % \
+            json.dumps({"tag_name": tagname, "name": name,
+                        "body_lines": notes.count("\n") + 1}, ensure_ascii=False)
+    if FX is not None:
+        sink = os.environ.get("RELEASE_SHIP_SINK")
+        if sink:
+            try:
+                cur = json.load(open(sink)) if os.path.exists(sink) else []
+            except Exception:
+                cur = []
+            cur.append(tagname)
+            json.dump(cur, open(sink, "w"))
+        return {"tag_name": tagname, "html_url": "(fixture-created)"}, "（fixture 模式，未打網路）"
+    tk = rc.token_from_env_or_remote(HOST, proj_root())
+    if not tk:
+        die("🔴 拿不到 %s 的 token —— 建 release 是寫入，一定要憑證"
+            "（GITEA_TOKEN_CLAUDE_CODE，或這個 repo 的 remote URL 帶憑證）。" % HOST)
+    url = "%s/api/v1/repos/%s/releases" % (HOST, REPO)
+    req = urllib.request.Request(
+        url, data=json.dumps(payload).encode(), method="POST",
+        headers={"Authorization": "token " + tk, "Content-Type": "application/json"})
+    try:
+        r = json.load(urllib.request.urlopen(req, timeout=40))
+        return r, "已建立"
+    except urllib.error.HTTPError as e:
+        die("🔴 Gitea 建 release 失敗 %s：%s" % (e.code, e.read().decode()[:300]))
+    except Exception as e:
+        die("🔴 連不上 %s：%s" % (HOST, e))
+
+
+# ══ 送完覆核：回頭問收貨端（不是問自己）══════════════════════════════════
+def verify_via_check(tagname):
+    """跑 `release-check <tag>`，拿收貨端事實覆核**這一版**。回 (ok, 輸出)。"""
+    check = os.path.join(HERE, "release-check")
+    env = dict(os.environ)
+    if FX is not None:
+        # fixture 模式下，把剛「建」進 sink 的 release 併進 release-check 的 fixture 視圖
+        sink = os.environ.get("RELEASE_SHIP_SINK")
+        extra = []
+        if sink and os.path.exists(sink):
+            try:
+                extra = json.load(open(sink))
+            except Exception:
+                extra = []
+        merged = dict(FX)
+        merged["releases"] = sorted(set((FX.get("releases") or []) + extra))
+        cf = (sink or "/tmp/rs") + ".checkfx.json"
+        json.dump(merged, open(cf, "w"))
+        env["RELEASE_CHECK_FIXTURE"] = cf
+    env.setdefault("RELEASE_CHECK_HOST", HOST)
+    env.setdefault("RELEASE_CHECK_REPO", REPO)
+    try:
+        p = subprocess.run(["python3", check, tagname], capture_output=True, text=True,
+                           timeout=60, env=env)
+        return p.returncode == 0, (p.stdout + p.stderr).strip()
+    except Exception as e:
+        return False, "跑不動 release-check：%s" % e
+
+
+# ══ 主流程 ════════════════════════════════════════════════════════════════
+def ship(arg, notes_file=None, dry=False, do_verify=True):
+    m = VER_RE.match(arg.strip())
+    if not m:
+        die("🔴 版本寫法是 vX.Y.Z 或 X.Y.Z，你給的是：%s" % arg)
+    ver = m.group(1)
+    tagname = "v" + ver
+    out = ["📦 release-ship %s（把 tag 變成 leo 看得到的 release）" % tagname, ""]
+
+    tags = ask(CHAIN.tags)
+    # 前置 ②（先問 tag 在不在——①要讀它的樹，tag 不在就沒有樹可讀）
+    if tagname not in tags:
+        die("🚫 前置② Gitea 上沒有 tag %s —— 不給建 release。\n"
+            "   release 是「把已存在的 tag 公開成一頁」，tag 都還沒推，先推：\n"
+            "        git tag %s   &&   git push origin %s\n"
+            "   （推 tag 那一刻 release-tag-guard.sh 會擋下版本對不上的 tag。）"
+            % (tagname, tagname, tagname))
+    # 前置 ①（看 tag 自己的樹，不看工作樹）
+    at_tag = ask(CHAIN.manifest_version_at, tagname)
+    if at_tag != ver:
+        die("🚫 前置① tag %s 的樹裡 plugin.json 寫的是「%s」—— 不給建 release。\n"
+            "   建 release 是把這個 tag 公開給 leo 裝；tag 的樹自己就講錯版本，裝了會各說各話。\n"
+            "   這種 tag 不該存在（release-tag-guard.sh 在推 tag 那一刻就會擋），\n"
+            "   修法：刪掉這個 tag、在 main 上把 plugin.json 改成 %s 重新定版、再打一次 tag。"
+            % (tagname, at_tag or "（讀不到）", ver))
+    out.append("✅ 前置② Gitea 上有 tag %s（問過收貨端）" % tagname)
+    out.append("✅ 前置① tag %s 的樹裡 plugin.json ＝ %s（看的是 tag 的樹，不是工作樹）" % (tagname, ver))
+
+    # 冪等
+    existing = ask(CHAIN.release, tagname)
+    if existing:
+        out.append("ℹ️ release %s 本來就在了（%s）—— 不重複建、不動它。"
+                   % (tagname, existing.get("html_url") or ""))
+        code = 0
+        if do_verify:
+            vok, vout = verify_via_check(tagname)
+            out.append("")
+            out.append("── 覆核（release-check %s，問收貨端）──" % tagname)
+            out.append(vout)
+            code = 0 if vok else 2
+        return code, "\n".join(out)
+
+    # 前置 ③
+    releases = ask(CHAIN.releases)
+    if notes_file:
+        with open(notes_file) as f:
+            notes = f.read()
+        out.append("✅ 前置③ release note 來自 %s" % notes_file)
+    else:
+        notes = auto_notes(tagname, releases)
+        out.append("✅ 前置③ release note 由 Gitea 的 commit 清單自動生成（leo 可再改）")
+
+    # 建（release 名對齊 leo 慣例：vX.Y.Z — 定版 commit 那句人話）
+    relname = release_name(tagname)
+    rel, how = create_release(tagname, notes, dry, relname)
+    if dry:
+        out.append("   release 名：%s" % relname)
+        out.append("")
+        out.append(how)
+        return 0, "\n".join(out)
+    out.append("✅ 已建立 release「%s」（%s）" % (relname, (rel or {}).get("html_url") or how))
+
+    # 覆核（送完問收貨端）
+    code = 0
+    if do_verify:
+        vok, vout = verify_via_check(tagname)
+        out.append("")
+        out.append("── 覆核（release-check %s，問收貨端，不是問自己）──" % tagname)
+        out.append(vout)
+        code = 0 if vok else 2
+    return code, "\n".join(out)
+
+
+def main(argv):
+    arg, notes_file, dry, do_verify = None, None, False, True
+    i = 0
+    while i < len(argv):
+        a = argv[i]
+        if a in ("-h", "--help"):
+            print(__doc__)
+            return 0
+        elif a == "--notes-file":
+            i += 1
+            notes_file = argv[i]
+        elif a == "--dry-run":
+            dry = True
+        elif a == "--no-verify":
+            do_verify = False
+        elif a.startswith("-"):
+            die("不認得的參數：%s（--help 看用法）" % a)
+        else:
+            arg = a
+        i += 1
+    if not arg:
+        die("用法：release-ship <版本 vX.Y.Z> [--notes-file <檔>] [--dry-run] [--no-verify]")
+    code, report = ship(arg, notes_file, dry, do_verify)
+    print(report, file=(sys.stdout if code == 0 else sys.stderr))
+    return code
+
+
+if __name__ == "__main__":
+    sys.exit(main(sys.argv[1:]))

scripts/stage

@@ -0,0 +1,410 @@
+#!/usr/bin/env python3
+"""stage — 雲端對 **stage（youlin）** 寫入的正門（inkstone/ISEP#137）
+
+━━ 為什麼有這支 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+09-07 三條主線工人在雲端對 stage 的寫入全被 Claude Code auto mode 的分類器擋（不是 ISEP 的閘）：
+  ① `printf … | npx wrangler secret put CF_SECRETS_API_TOKEN --name arcrun-cypher-executor`
+  ② `python3 scripts/stage-deploy-artifacts.py all --confirm`（Arcrun 的成品直推，CF API 上傳）
+  ③ `curl -X POST …arcrun-yuga3bse.workers.dev/records`／`/graph/canonicalize-entities`／`/map/recompute`
+權限白名單（docs/permissions-allow.json）是**逐條完全比對前綴**：複合指令（`cd … && printf … | VAR=… npx …`）
+與任意寫法的 curl 永遠對不上任何一條；放整類 `Bash(npx *)`／`Bash(curl *)` 又是紅線。
+leo 09-07：「為什麼會擋你，這就是要修復的問題」「本機環境跟你不同應該不行」。
+
+⇒ 每一種寫入收成**一支固定形狀**，白名單放它的四種呼叫形狀：
+   `stage secret …`  ＝ ①（打 api.cloudflare.com，不經 npx——雲端每次要重抓 wrangler，
+                         而且 wrangler 會讀 ~/.wrangler 的登入態：本機是 uncle6、雲端沒有，兩台行為不同）
+   `stage api …`     ＝ ③（用 curl 打 stage 實例；youlin 邊緣對 python-urllib UA 回 403 code 1010，
+                         Arcrun#176 comment 6487——所以這一段**不用 urllib**）
+   ②                ＝ Arcrun 自己那支已經寫死只認 youlin 帳號 ID、憑證只從
+                         CLOUDFLARE_API_TOKEN_YOULIN_CC_USE 讀、不收 --account／--token；
+                         白名單直接放它的形狀（`python3 scripts/stage-deploy-artifacts.py *`），不重造一支。
+
+━━ 只寫 stage，判準是唯一識別碼往放行方向比對，不是名字 ━━━━━━━━━━━━━━━━━━━━━━
+stage 隨便炸；出貨機（geek6688／uncle6）與 leo 的實例（leo21c）不是。
+  secret：這把 token 打得到的帳號（GET /accounts 現查）裡要有 1129efd7df2e8899d537e9c8fbabb6cb，
+          而且寫入的 URL 永遠只帶這個 ID。打不到 ⇒ 拒絕、印出它打得到誰、離開碼 2。
+  api   ：URL 只會長在 `<worker>.arcrun-yuga3bse.workers.dev`（09-02 重裝後的 stage 子網域）。
+          給完整網址時主機必須等於它，否則拒絕、離開碼 2——不管那個主機叫 leo21c 還是別的什麼。
+不看變數名字裡有沒有 `leo21c`／`geek6688`——名字改了黑名單就漏，ID 與主機改不了。
+
+━━ 值不進指令列 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+secret 的值、Bearer、任何標頭值都只從**環境變數名**讀（--from-env／--bearer-env／--header-env）；
+不落磁碟、不 echo、不進 git、不進 shell 歷史。curl 的標頭與 body 走 stdin 設定檔＋管線，不走 argv。
+
+━━ 用法 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  stage secret put    --worker <script> --secret <NAME> --from-env <VAR>   [--token-env VAR] [--account ID]
+  stage secret list   --worker <script>
+  stage secret delete --worker <script> --secret <NAME>
+      --token-env <VAR>   CF token 的環境變數名（預設 CLOUDFLARE_API_TOKEN_YOULIN_CC_USE，雲端就有）
+      --account <ID>      目標帳號（預設 stage；給別的 ID 一律拒絕、不打網路）
+
+  stage api <METHOD> <worker>/<path>[?query] [--json '<body>' | --data-env <VAR> | --data-file <檔>]
+                                              [--bearer-env <VAR>] [--header-env <Name>=<VAR>]…
+      <worker>/<path>     例 arcrun-kbdb/records、arcrun-cypher-executor/webhooks/named/yuga3bse/x/trigger
+                          也收完整網址，但主機必須是 *.arcrun-yuga3bse.workers.dev
+      --bearer-env VAR    Authorization: Bearer <VAR 的值>（stage KBDB 的 POST 要 KBDB_INTERNAL_TOKEN）
+      --header-env N=VAR  任一標頭，值從環境變數讀（例 X-Arcrun-API-Key=ARCRUN_NS_YOULIN）
+      body 有給就自動帶 Content-Type: application/json
+      印 `HTTP <code>` ＋ 回應；2xx 離開碼 0，其餘 1；curl 連不上印它的錯誤字串（不記成 000）
+
+  例（雲端）：
+    python3 "$CLAUDE_PLUGIN_ROOT/scripts/stage" secret put --worker arcrun-cypher-executor \\
+        --secret CF_SECRETS_API_TOKEN --from-env CF_SECRETS_API_TOKEN_VALUE
+    python3 "$CLAUDE_PLUGIN_ROOT/scripts/stage" api POST 'arcrun-kbdb/map/recompute?library=rt-lib&owner_id=yuga3bse' \\
+        --bearer-env KBDB_INTERNAL_TOKEN
+
+  離開碼：0 成功 ／ 2 被本工具拒絕（非 stage、缺變數、值在指令列）／ 1 API・網路失敗
+  測試用：STAGE_SECRET_PUT_API_BASE（CF API）、STAGE_API_BASE_OVERRIDE（實例）指到假伺服器——scripts/test-stage.sh
+"""
+import json
+import os
+import subprocess
+import sys
+import urllib.error
+import urllib.parse
+import urllib.request
+
+STAGE_ACCOUNT_ID = "1129efd7df2e8899d537e9c8fbabb6cb"   # youlin（D37 定的 stage 帳號）
+STAGE_LABEL = "youlin（stage）"
+STAGE_HOST_SUFFIX = ".arcrun-yuga3bse.workers.dev"      # 09-02 重裝後的 stage 子網域（ISEP#130）
+DEFAULT_TOKEN_ENV = "CLOUDFLARE_API_TOKEN_YOULIN_CC_USE"
+CF_API_BASE = os.environ.get("STAGE_SECRET_PUT_API_BASE", "https://api.cloudflare.com/client/v4").rstrip("/")
+API_BASE_OVERRIDE = os.environ.get("STAGE_API_BASE_OVERRIDE", "").rstrip("/")   # 測試用：整個實例指到假伺服器
+
+EXIT_OK, EXIT_API, EXIT_REFUSED = 0, 1, 2
+FORBIDDEN_VALUE_FLAGS = ("--value", "--text", "--bearer", "--token", "--header")
+
+
+def die(code, msg):
+    print(msg, file=sys.stderr)
+    return code
+
+
+class Refuse(Exception):
+    pass
+
+
+# ───────────────────────── secret（CF API，api.cloudflare.com）─────────────────────────
+
+def parse_secret(argv):
+    if not argv or argv[0] not in ("put", "list", "delete"):
+        raise Refuse("secret 後面要接 put／list／delete，不是 %r（--help 看用法）" % (argv[:1] or [""])[0])
+    cmd = argv[0]
+    o = {"worker": None, "secret": None, "from_env": None, "token_env": DEFAULT_TOKEN_ENV, "account": STAGE_ACCOUNT_ID}
+    keys = {"--worker": "worker", "--secret": "secret", "--from-env": "from_env", "--token-env": "token_env", "--account": "account"}
+    i = 1
+    while i < len(argv):
+        a = argv[i]
+        if a in FORBIDDEN_VALUE_FLAGS:
+            raise Refuse("本工具不收 %s：值只從環境變數名讀（--from-env／--token-env），不准出現在指令列" % a)
+        if a not in keys:
+            raise Refuse("不認得的參數：%s（--help 看用法）" % a)
+        if i + 1 >= len(argv):
+            raise Refuse("%s 後面要接一個值" % a)
+        o[keys[a]] = argv[i + 1]
+        i += 2
+    if not o["worker"]:
+        raise Refuse("缺 --worker <script 名>")
+    if cmd in ("put", "delete") and not o["secret"]:
+        raise Refuse("缺 --secret <SECRET 名>")
+    if cmd == "put" and not o["from_env"]:
+        raise Refuse("缺 --from-env <環境變數名>（值只從這裡讀）")
+    return cmd, o
+
+
+def cf(method, path, token, body=None):
+    """回 (http_status, parsed_json)；網路層失敗回 (None, 錯誤字串)——不把三種病都記成 000。"""
+    data = None
+    headers = {"Authorization": "Bearer " + token, "User-Agent": "isep-stage/1 (+inkstone/ISEP#137)"}
+    if body is not None:
+        data = json.dumps(body).encode("utf-8")
+        headers["Content-Type"] = "application/json"
+    req = urllib.request.Request(CF_API_BASE + path, data=data, headers=headers, method=method)
+    try:
+        with urllib.request.urlopen(req, timeout=60) as resp:
+            return resp.status, json.loads(resp.read().decode("utf-8") or "{}")
+    except urllib.error.HTTPError as e:
+        try:
+            return e.code, json.loads(e.read().decode("utf-8") or "{}")
+        except Exception:
+            return e.code, {"success": False, "errors": [{"message": "HTTP %d（非 JSON 回應）" % e.code}]}
+    except Exception as e:
+        return None, "%s: %s" % (type(e).__name__, e)
+
+
+def cf_ok(status, d):
+    # CF 對「建立」回 201（secret PUT 實測就是 201，inkstone/ISEP#137 第一次實跑抓到的）——2xx ＋ success 才算好
+    return status is not None and 200 <= status < 300 and isinstance(d, dict) and bool(d.get("success"))
+
+
+def cf_errors(d):
+    if isinstance(d, dict):
+        errs = d.get("errors") or []
+        return "；".join("%s（code %s）" % (e.get("message"), e.get("code")) for e in errs) or "（CF 沒給錯誤訊息）"
+    return str(d)
+
+
+def refuse_account(given):
+    return die(EXIT_REFUSED, "\n".join([
+        "🛑 本工具只種 stage，不種 %s。" % given,
+        "",
+        "   stage ＝ %s，帳號 ID %s" % (STAGE_LABEL, STAGE_ACCOUNT_ID),
+        "   你給的   ＝ %s" % given,
+        "",
+        "【為什麼】stage 隨便炸；出貨機（geek6688／uncle6）與 leo 的實例（leo21c）不是（inkstone/ISEP#137）。",
+        "【出路】要種進那兩類帳號 ⇒ 交回地端，由 leo 親手在 Mac 上 `wrangler secret put`；",
+        "        雲端這支不會、也不該會。要種 stage ⇒ 把 --account 拿掉（預設就是 stage）。",
+    ]))
+
+
+def check_token_reaches_stage(token, token_env):
+    status, d = cf("GET", "/accounts", token)
+    if status is None:
+        return die(EXIT_API, "🔴 連不到 CF API（%s）：%s\n   雲端看到這個先查 `curl -sS \"$HTTPS_PROXY/__agentproxy/status\"`（policy 拒絕 vs DNS vs 對方沒回，三種修法不同）。" % (CF_API_BASE, d))
+    if not cf_ok(status, d):
+        return die(EXIT_API, "🔴 CF 不認這把 token（%s，HTTP %s）：%s" % (token_env, status, cf_errors(d)))
+    accounts = [(a.get("id"), a.get("name")) for a in (d.get("result") or []) if isinstance(a, dict)]
+    if STAGE_ACCOUNT_ID not in [i for i, _ in accounts]:
+        reach = "\n".join("     · %s  %s" % (i, n) for i, n in accounts) or "     ·（一個都沒有）"
+        return die(EXIT_REFUSED, "\n".join([
+            "🛑 這把 token（%s）打不到 stage，拒絕。" % token_env,
+            "",
+            "   stage ＝ %s，帳號 ID %s" % (STAGE_LABEL, STAGE_ACCOUNT_ID),
+            "   這把 token 打得到的帳號：",
+            reach,
+            "",
+            "【為什麼】本工具只種 stage；token 是誰的就會種進誰的帳號，所以先問 CF 它打得到誰（inkstone/ISEP#137）。",
+            "【出路】用 stage 的那把：--token-env %s（雲端 Cloud environment 就有，本機在頂層 .env）。" % DEFAULT_TOKEN_ENV,
+            "        真要種出貨機／leo21c ⇒ 交回地端由 leo 親手做。",
+        ]))
+    return None
+
+
+def list_names(token, account, worker):
+    status, d = cf("GET", "/accounts/%s/workers/scripts/%s/secrets" % (account, worker), token)
+    if status is None:
+        return None, "連不到 CF API（%s）：%s" % (CF_API_BASE, d)
+    if not cf_ok(status, d):
+        return None, "列 secrets 失敗（HTTP %s）：%s" % (status, cf_errors(d))
+    return sorted(s.get("name") for s in (d.get("result") or []) if isinstance(s, dict) and s.get("name")), None
+
+
+def run_secret(argv):
+    try:
+        cmd, o = parse_secret(argv)
+    except Refuse as e:
+        return die(EXIT_REFUSED, "🛑 %s" % e)
+
+    if o["account"] != STAGE_ACCOUNT_ID:
+        return refuse_account(o["account"])
+    token = os.environ.get(o["token_env"], "")
+    if not token:
+        return die(EXIT_REFUSED, "🛑 環境變數 %s 沒有值（CF token）。\n【出路】雲端：Cloud environment 要有它（scripts/make-cloud-env.sh 的清單裡就有）；本機：從頂層 .env 匯出。" % o["token_env"])
+    value = None
+    if cmd == "put":
+        value = os.environ.get(o["from_env"], "")
+        if not value:
+            return die(EXIT_REFUSED, "🛑 環境變數 %s 沒有值（要種進去的 secret 本身）。\n【出路】把值放進這個環境變數再跑；不要改成把值寫在指令列——那是紅線（值不落磁碟、不進指令歷史）。" % o["from_env"])
+
+    rc = check_token_reaches_stage(token, o["token_env"])
+    if rc is not None:
+        return rc
+    acct, worker = o["account"], o["worker"]
+
+    if cmd == "list":
+        names, err = list_names(token, acct, worker)
+        if err:
+            return die(EXIT_API, "🔴 %s" % err)
+        print("✅ %s@%s 現有 %d 把 secret：%s" % (worker, STAGE_LABEL, len(names), "、".join(names) or "（沒有）"))
+        return EXIT_OK
+
+    if cmd == "delete":
+        status, d = cf("DELETE", "/accounts/%s/workers/scripts/%s/secrets/%s" % (acct, worker, o["secret"]), token)
+        if status is None:
+            return die(EXIT_API, "🔴 連不到 CF API：%s" % d)
+        if not cf_ok(status, d):
+            return die(EXIT_API, "🔴 刪 %s 失敗（HTTP %s）：%s" % (o["secret"], status, cf_errors(d)))
+        names, err = list_names(token, acct, worker)
+        if err:
+            return die(EXIT_API, "🔴 刪了但列不出來確認：%s" % err)
+        if o["secret"] in names:
+            return die(EXIT_API, "🔴 CF 說刪了，列表卻還有 %s" % o["secret"])
+        print("✅ 已刪 %s ← %s@%s；剩 %d 把：%s" % (o["secret"], worker, STAGE_LABEL, len(names), "、".join(names) or "（沒有）"))
+        return EXIT_OK
+
+    body = {"name": o["secret"], "text": value, "type": "secret_text"}
+    status, d = cf("PUT", "/accounts/%s/workers/scripts/%s/secrets" % (acct, worker), token, body)
+    del value, body
+    if status is None:
+        return die(EXIT_API, "🔴 連不到 CF API：%s" % d)
+    if not cf_ok(status, d):
+        return die(EXIT_API, "🔴 種 %s → %s 失敗（HTTP %s）：%s" % (o["secret"], worker, status, cf_errors(d)))
+    names, err = list_names(token, acct, worker)
+    if err:
+        return die(EXIT_API, "🔴 CF 說種好了，但列不出來確認：%s" % err)
+    if o["secret"] not in names:
+        return die(EXIT_API, "🔴 CF 說種好了，列表卻沒有 %s（有的是：%s）" % (o["secret"], "、".join(names)))
+    print("✅ 已種 %s → %s@%s（值來自環境變數 %s，沒印、沒落地）" % (o["secret"], worker, STAGE_LABEL, o["from_env"]))
+    print("   現有 %d 把：%s" % (len(names), "、".join(names)))
+    return EXIT_OK
+
+
+# ───────────────────────── api（curl 打 stage 實例）─────────────────────────
+
+def parse_api(argv):
+    if len(argv) < 2:
+        raise Refuse("api 後面要接 <METHOD> <worker>/<path>（--help 看用法）")
+    method, target = argv[0].upper(), argv[1]
+    if method not in ("GET", "POST", "PUT", "PATCH", "DELETE"):
+        raise Refuse("METHOD 要是 GET／POST／PUT／PATCH／DELETE，不是 %r" % argv[0])
+    o = {"json": None, "data_env": None, "data_file": None, "bearer_env": None, "header_envs": []}
+    i = 2
+    while i < len(argv):
+        a = argv[i]
+        if a in FORBIDDEN_VALUE_FLAGS:
+            raise Refuse("本工具不收 %s：標頭值只從環境變數名讀（--bearer-env／--header-env Name=VAR），不准出現在指令列" % a)
+        if i + 1 >= len(argv):
+            raise Refuse("%s 後面要接一個值" % a)
+        v = argv[i + 1]
+        if a == "--json":
+            o["json"] = v
+        elif a == "--data-env":
+            o["data_env"] = v
+        elif a == "--data-file":
+            o["data_file"] = v
+        elif a == "--bearer-env":
+            o["bearer_env"] = v
+        elif a == "--header-env":
+            if "=" not in v:
+                raise Refuse("--header-env 的形狀是 Name=VAR（例 X-Arcrun-API-Key=ARCRUN_NS_YOULIN），不是 %r" % v)
+            o["header_envs"].append(tuple(v.split("=", 1)))
+        else:
+            raise Refuse("不認得的參數：%s（--help 看用法）" % a)
+        i += 2
+    if sum(1 for k in ("json", "data_env", "data_file") if o[k]) > 1:
+        raise Refuse("--json／--data-env／--data-file 只能給一個")
+    return method, target, o
+
+
+def stage_url(target):
+    """把 <worker>/<path> 或完整網址變成 stage 的網址；主機不是 stage 就拒絕。"""
+    if "://" in target:
+        u = urllib.parse.urlsplit(target)
+        host = (u.hostname or "").lower()
+        if not host.endswith(STAGE_HOST_SUFFIX) or host == STAGE_HOST_SUFFIX.lstrip("."):
+            raise Refuse("\n".join([
+                "本工具只打 stage，不打 %s。" % host,
+                "",
+                "   stage ＝ %s，主機一律是 <worker>%s" % (STAGE_LABEL, STAGE_HOST_SUFFIX),
+                "   你給的 ＝ %s" % target,
+                "",
+                "【為什麼】stage 隨便炸；leo21c 是 leo 本人在用的實例、geek6688／uncle6 是出貨機（inkstone/ISEP#137）。",
+                "【出路】打 stage ⇒ 寫成 <worker>/<path>（例 arcrun-kbdb/records），主機由本工具補。",
+                "        對 leo21c 唯讀查詢 ⇒ 直接 curl GET（leo21c-write-guard 放行讀）；要寫 ⇒ 交回地端由 leo 親手做。",
+            ]))
+        if API_BASE_OVERRIDE:
+            return API_BASE_OVERRIDE + "/" + host.split(".")[0] + (u.path or "/") + ("?" + u.query if u.query else "")
+        return urllib.parse.urlunsplit(("https", host, u.path or "/", u.query, ""))
+    if "/" not in target:
+        raise Refuse("目標要寫成 <worker>/<path>（例 arcrun-kbdb/records），不是 %r" % target)
+    worker, rest = target.split("/", 1)
+    if not worker or any(c in worker for c in ".:@ "):
+        raise Refuse("<worker> 只能是 worker 名（例 arcrun-kbdb），不是 %r" % worker)
+    if API_BASE_OVERRIDE:
+        return API_BASE_OVERRIDE + "/" + worker + "/" + rest
+    return "https://" + worker + STAGE_HOST_SUFFIX + "/" + rest
+
+
+def curl_quote(s):
+    return '"' + s.replace("\\", "\\\\").replace('"', '\\"').replace("\n", "\\n").replace("\t", "\\t") + '"'
+
+
+def run_api(argv):
+    try:
+        method, target, o = parse_api(argv)
+        url = stage_url(target)
+    except Refuse as e:
+        return die(EXIT_REFUSED, "🛑 %s" % e)
+
+    headers = []
+    if o["bearer_env"]:
+        v = os.environ.get(o["bearer_env"], "")
+        if not v:
+            return die(EXIT_REFUSED, "🛑 環境變數 %s 沒有值（Bearer）。\n【出路】把值放進這個環境變數再跑；不要改成寫在指令列。" % o["bearer_env"])
+        headers.append("Authorization: Bearer " + v)
+    for name, var in o["header_envs"]:
+        v = os.environ.get(var, "")
+        if not v:
+            return die(EXIT_REFUSED, "🛑 環境變數 %s 沒有值（標頭 %s）。" % (var, name))
+        headers.append(name + ": " + v)
+
+    body = None
+    if o["json"] is not None:
+        body = o["json"]
+    elif o["data_env"]:
+        body = os.environ.get(o["data_env"], "")
+        if not body:
+            return die(EXIT_REFUSED, "🛑 環境變數 %s 沒有值（body）。" % o["data_env"])
+    elif o["data_file"]:
+        try:
+            with open(o["data_file"], encoding="utf-8") as f:
+                body = f.read()
+        except OSError as e:
+            return die(EXIT_REFUSED, "🛑 讀不了 --data-file %s：%s" % (o["data_file"], e))
+    if body is not None:
+        headers.append("Content-Type: application/json")
+
+    # 標頭與 body 都不走 argv：設定檔從 stdin 進，body 從一條管線（/dev/fd/N）進
+    rfd, wfd = os.pipe()
+    cfg = ["url = " + curl_quote(url), "request = " + curl_quote(method), "silent", "show-error",
+           "write-out = " + curl_quote("\\n__STAGE_HTTP__%{http_code}"), "max-time = 120",
+           "user-agent = " + curl_quote("isep-stage/1 (+inkstone/ISEP#137)")]
+    for h in headers:
+        cfg.append("header = " + curl_quote(h))
+    if body is not None:
+        cfg.append("data-binary = " + curl_quote("@/dev/fd/%d" % rfd))
+    try:
+        p = subprocess.Popen(["curl", "--config", "-"], stdin=subprocess.PIPE, stdout=subprocess.PIPE,
+                             stderr=subprocess.PIPE, pass_fds=(rfd,) if body is not None else ())
+    except FileNotFoundError:
+        os.close(rfd); os.close(wfd)
+        return die(EXIT_API, "🔴 這台沒有 curl。")
+    os.close(rfd)
+    if body is not None:
+        with os.fdopen(wfd, "w", encoding="utf-8") as w:
+            w.write(body)
+    else:
+        os.close(wfd)
+    out, err = p.communicate(("\n".join(cfg) + "\n").encode("utf-8"))
+    del headers, cfg
+    text = out.decode("utf-8", "replace")
+    if p.returncode != 0:
+        return die(EXIT_API, "🔴 curl 失敗（離開碼 %d）：%s\n   雲端 403 CONNECT ⇒ `curl -sS \"$HTTPS_PROXY/__agentproxy/status\"`（policy）；`error code: 1010` ⇒ youlin 邊緣擋 UA。"
+                   % (p.returncode, err.decode("utf-8", "replace").strip()))
+    resp, _, code = text.rpartition("\n__STAGE_HTTP__")
+    code = code.strip() or "000"
+    try:
+        pretty = json.dumps(json.loads(resp), ensure_ascii=False, indent=2) if resp.strip() else ""
+    except ValueError:
+        pretty = resp
+    print("HTTP %s  %s %s" % (code, method, url))
+    if pretty:
+        print(pretty)
+    return EXIT_OK if code.isdigit() and 200 <= int(code) < 300 else EXIT_API
+
+
+# ───────────────────────── 入口 ─────────────────────────
+
+def main(argv):
+    if not argv or argv[0] in ("-h", "--help"):
+        print(__doc__)
+        return EXIT_OK
+    if argv[0] == "secret":
+        return run_secret(argv[1:])
+    if argv[0] == "api":
+        return run_api(argv[1:])
+    return die(EXIT_REFUSED, "🛑 第一個參數要是 secret／api，不是 %r（--help 看用法）" % argv[0])
+
+
+if __name__ == "__main__":
+    sys.exit(main(sys.argv[1:]))

scripts/test-release-check.sh

@@ -0,0 +1,129 @@
+#!/usr/bin/env bash
+# scripts/release-check 的迴歸測試（inkstone/ISEP#67）
+#
+# 兩個方向都要有證據：
+#   A 群「該擋」（exit 2）——現行版本缺 tag 或缺 release，且**說得出缺哪一站＋怎麼補**
+#     （這就是工單驗收 4：「故意漏一步 → 管線要擋下來並說出缺哪一站」）
+#   B 群「該過」（exit 0）——現行版本 tag＋release 都在；更舊版本缺件只黃字提醒不擋；
+#     指定版本時看的是那一版；裁定不補的版本不再黃字
+#
+# 🔴 全程離線（RELEASE_CHECK_FIXTURE），不打 Gitea。fixture 直接給收貨端與送貨端的事實。
+set -u
+TOOL="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/release-check}"
+TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
+PASS=0; FAIL=0; N=0
+
+mkfx() { # $1=檔名 之後 heredoc
+  cat > "$TMP/$1"
+}
+
+# t <期望exit> <說明> <必須出現的字串> <fixture檔> [額外參數…]
+t() {
+  want="$1"; desc="$2"; must="$3"; fx="$4"; shift 4
+  N=$((N+1))
+  out=$(RELEASE_CHECK_FIXTURE="$TMP/$fx" python3 "$TOOL" "$@" 2>&1); 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,16p' | sed 's/^/     /'; FAIL=$((FAIL+1))
+  fi
+}
+# not <說明> <不該出現的字串> <fixture檔> [額外參數…]
+not() {
+  desc="$1"; bad="$2"; fx="$3"; shift 3
+  N=$((N+1))
+  out=$(RELEASE_CHECK_FIXTURE="$TMP/$fx" python3 "$TOOL" "$@" 2>&1)
+  if printf '%s' "$out" | grep -qF "$bad"; then
+    printf '  ❌ %s —— 不該出現卻出現了：%s\n' "$desc" "$bad"; FAIL=$((FAIL+1))
+  else printf '  ✅ %s\n' "$desc"; PASS=$((PASS+1)); fi
+}
+
+echo "── A 群：該擋（現行版本送貨端斷了，要說出缺哪一站）──"
+
+# A1：這就是 2026-09-07 的真實狀態——v0.24.0 有 tag、沒 release
+mkfx a1.json <<'JSON'
+{"current":"0.24.0",
+ "dingban":["0.24.0","0.23.0","0.22.0"],
+ "tags":["v0.24.0","v0.23.0","v0.22.0"],
+ "releases":["v0.22.0"],
+ "loaded":"0.24.0"}
+JSON
+t 2 "現行 v0.24.0 有 tag 沒 release → 擋，且指名缺 release 站" "缺這一站：release（Gitea）" a1.json
+t 2 "缺 release 時給得出補法，而且是正本的絕對路徑（貼了就能跑）" "$(dirname "$TOOL")/release-ship v0.24.0" a1.json
+
+# A2：連 tag 都沒有（定版了、tag 沒推）
+mkfx a2.json <<'JSON'
+{"current":"0.20.0",
+ "dingban":["0.20.0","0.18.0"],
+ "tags":["v0.18.0"],
+ "releases":["v0.18.0"],
+ "loaded":"0.20.0"}
+JSON
+t 2 "現行版本連 tag 都沒有 → 擋，且指名缺 tag 站" "缺這一站：tag（Gitea）" a2.json
+t 2 "缺 tag 時給得出補法（push tag）" "git push origin v0.20.0" a2.json
+
+# A3：指定版本 → 判的是那一版
+mkfx a3.json <<'JSON'
+{"current":"0.24.0",
+ "dingban":["0.24.0","0.23.0"],
+ "tags":["v0.24.0","v0.23.0"],
+ "releases":["v0.24.0"],
+ "loaded":"0.24.0"}
+JSON
+t 2 "指定 v0.23.0 而它沒 release → 擋（就算工作樹宣稱的 v0.24.0 是好的）" "現行版本 v0.23.0 的送貨端斷了" a3.json v0.23.0
+t 0 "同一份事實不指定版本 → 看 v0.24.0，放行" "送貨端完成" a3.json
+
+echo "── B 群：該過（現行版本 tag＋release 都在）──"
+
+# B1：全部送到
+mkfx b1.json <<'JSON'
+{"current":"0.18.0",
+ "dingban":["0.18.0","0.9.0"],
+ "tags":["v0.18.0","v0.9.0"],
+ "releases":["v0.18.0","v0.9.0"],
+ "loaded":"0.18.0"}
+JSON
+t 0 "現行版本 tag＋release 都在 → 放行" "送貨端完成" b1.json
+
+# B2：現行版本送到了，但更舊的 定版 版本缺件 → 仍放行，只黃字
+mkfx b2.json <<'JSON'
+{"current":"0.24.0",
+ "dingban":["0.24.0","0.23.0","0.22.0"],
+ "tags":["v0.24.0","v0.22.0"],
+ "releases":["v0.24.0","v0.22.0"],
+ "loaded":"0.24.0"}
+JSON
+t 0 "現行送到、舊版缺件 → 放行（不 over-block）" "送貨端完成" b2.json
+t 0 "舊版缺件會被黃字提醒出來" "v0.23.0 缺：tag（Gitea）＋release（Gitea）" b2.json
+
+# B3：載入端落後（送貨端完成，但這個 session 掛的是舊版）→ 仍 exit 0，但要報出來
+mkfx b3.json <<'JSON'
+{"current":"0.22.0",
+ "dingban":["0.22.0","0.18.0"],
+ "tags":["v0.22.0","v0.18.0"],
+ "releases":["v0.22.0","v0.18.0"],
+ "loaded":"0.21.0"}
+JSON
+t 0 "載入端落後 → 送貨端仍算完成（exit 0）" "送貨端完成" b3.json
+t 0 "載入端落後會被明確報出＋給 update／重啟的修法" "載入端落後" b3.json
+
+# B4：裁定不補的三版（總管 09-07）→ 不再黃字，表上標「裁定不補」
+mkfx b4.json <<'JSON'
+{"current":"0.24.0",
+ "dingban":["0.24.0","0.22.0","0.21.0","0.20.0","0.19.0","0.18.0"],
+ "tags":["v0.24.0","v0.22.0","v0.18.0"],
+ "releases":["v0.24.0","v0.22.0","v0.18.0"],
+ "loaded":"0.24.0"}
+JSON
+t 0 "v0.19／0.20／0.21 缺 tag＋release 但已裁定不補 → 表上標出裁決出處" "裁定不補（inkstone/ISEP#67 → 6574）" b4.json
+not "裁定不補的版本不再黃字念（天天念會被學會忽略）" "更舊的定版版本也缺件" b4.json
+t 2 "但指定 v0.21.0 來問，它就是現行、照擋（裁決只免黃字，不改事實）" "現行版本 v0.21.0 的送貨端斷了" b4.json v0.21.0
+
+echo ""
+echo "──────────────────────────────"
+printf '共 %d 項：✅ %d ／ ❌ %d\n' "$N" "$PASS" "$FAIL"
+[ "$FAIL" -eq 0 ]

scripts/test-release-ship.sh

@@ -0,0 +1,116 @@
+#!/usr/bin/env bash
+# scripts/release-ship 的迴歸測試（inkstone/ISEP#67）
+#
+# 兩個方向都要有證據：
+#   A 群「該擋」（exit 2）——前置條件沒滿足就不給建 release，且說得出是哪一個前置
+#     ① 那個 tag 的樹裡 plugin.json 跟 tag 號碼對不上 ② Gitea 上沒那個 tag ③ 版本寫法不對
+#   B 群「該放行」（exit 0）——前置都在就建；release 已存在則冪等不重複建；--dry-run 不 POST；
+#     🔴 **不是最新的那個 tag 也建得了**（總管 09-07 在 v0.23.0 被擋的那個情境）
+#
+# 🔴 全程離線（RELEASE_SHIP_FIXTURE ＋ RELEASE_SHIP_SINK），不打 Gitea、不建任何真 release。
+#    fixture 的形狀見 hooks/lib/release_chain.py `Chain` 的註解。
+set -u
+TOOL="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/release-ship}"
+TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
+PASS=0; FAIL=0; N=0
+
+# 🔴 工作樹故意擺一個跟任何 tag 都對不上的版本：前置①要是偷看工作樹，B 群會整組紅
+WT="$TMP/worktree"; mkdir -p "$WT/.claude-plugin"
+printf '{"name":"isep","version":"9.9.9"}\n' > "$WT/.claude-plugin/plugin.json"
+export CLAUDE_PROJECT_DIR="$WT"
+
+# t <期望exit> <說明> <必須出現的字串> <fixture檔> [額外參數…]
+t() {
+  want="$1"; desc="$2"; must="$3"; fx="$4"; shift 4
+  N=$((N+1))
+  rm -f "$TMP/sink.json" "$TMP/sink.json.checkfx.json"
+  out=$(RELEASE_SHIP_FIXTURE="$TMP/$fx" RELEASE_SHIP_SINK="$TMP/sink.json" \
+        python3 "$TOOL" "$@" 2>&1); 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,14p' | sed 's/^/     /'; FAIL=$((FAIL+1))
+  fi
+}
+# not <說明> <不該出現的字串> <fixture檔> [額外參數…]
+not() {
+  desc="$1"; bad="$2"; fx="$3"; shift 3
+  N=$((N+1))
+  rm -f "$TMP/sink.json" "$TMP/sink.json.checkfx.json"
+  out=$(RELEASE_SHIP_FIXTURE="$TMP/$fx" RELEASE_SHIP_SINK="$TMP/sink.json" \
+        python3 "$TOOL" "$@" 2>&1)
+  if printf '%s' "$out" | grep -qF "$bad"; then
+    printf '  ❌ %s —— 不該出現卻出現了：%s\n' "$desc" "$bad"; FAIL=$((FAIL+1))
+  else printf '  ✅ %s\n' "$desc"; PASS=$((PASS+1)); fi
+}
+
+echo "── A 群：該擋（前置條件沒滿足）──"
+
+# A1：tag 的樹裡 plugin.json 跟 tag 號碼對不上（這種 tag 本來就不該存在）
+cat > "$TMP/a1.json" <<'JSON'
+{"tags":["v0.22.0"],"manifest":{"v0.22.0":"0.21.0"},"releases":[]}
+JSON
+t 2 "tag 的樹裡 plugin.json 是 0.21.0、tag 是 v0.22.0 → 擋，指名前置①" "前置①" a1.json v0.22.0
+t 2 "前置①被擋時講得出修法（刪 tag、重新定版）" "重新定版" a1.json v0.22.0
+
+# A2：Gitea 上沒有這個 tag
+cat > "$TMP/a2.json" <<'JSON'
+{"tags":["v0.18.0"],"manifest":{"v0.18.0":"0.18.0"},"releases":["v0.18.0"]}
+JSON
+t 2 "Gitea 沒有該 tag → 擋，指名前置②＋叫人先推 tag" "git push origin v0.22.0" a2.json v0.22.0
+
+# A3：版本寫法不對
+cat > "$TMP/a3.json" <<'JSON'
+{"tags":[],"releases":[]}
+JSON
+t 2 "版本寫法不對 → 擋" "版本寫法" a3.json "0.22"
+
+echo "── B 群：該放行 ──"
+
+# B1：前置都在、release 還沒建 → 建（fixture sink），然後覆核通過
+cat > "$TMP/b1.json" <<'JSON'
+{"current":"0.22.0","dingban":["0.22.0","0.18.0"],"loaded":"0.22.0",
+ "tags":["v0.22.0","v0.18.0"],"manifest":{"v0.22.0":"0.22.0","v0.18.0":"0.18.0"},
+ "releases":["v0.18.0"],
+ "commits":{"v0.18.0...v0.22.0":["定版 v0.22.0（ship-check 送得到）","修一支閘（inkstone/ISEP#1）"]}}
+JSON
+t 0 "前置齊全、release 缺 → 建起來" "已建立 release「v0.22.0 — ship-check 送得到」" b1.json v0.22.0
+t 0 "建完回頭跑 release-check 覆核（問收貨端）" "覆核（release-check v0.22.0" b1.json v0.22.0
+t 0 "note 自動從 Gitea 的 commit 清單生成（不靠本機 git log）" "commit 清單自動生成" b1.json v0.22.0
+
+# B2：release 已存在 → 冪等，不重複建、不動它
+cat > "$TMP/b2.json" <<'JSON'
+{"current":"0.18.0","dingban":["0.18.0"],"loaded":"0.18.0",
+ "tags":["v0.18.0"],"manifest":{"v0.18.0":"0.18.0"},"releases":["v0.18.0"]}
+JSON
+t 0 "release 已存在 → 冪等放行、不重複建" "本來就在了" b2.json v0.18.0 --notes-file "$TMP/b2.json"
+not "release 已存在時不准說「已建立」（09-05 那句假綠）" "已建立 release" b2.json v0.18.0
+
+# B3：--dry-run 不 POST
+cat > "$TMP/b3.json" <<'JSON'
+{"tags":["v0.22.0"],"manifest":{"v0.22.0":"0.22.0"},"releases":[]}
+JSON
+t 0 "--dry-run 全走一遍但不 POST" "不 POST" b3.json v0.22.0 --dry-run
+not "--dry-run 不寫 sink（真的沒建）" "fixture-created" b3.json v0.22.0 --dry-run
+
+# B4：🔴 不是最新的 tag 也建得了（總管 09-07：在 v0.23.0 的 checkout 跑被擋，訊息說最新是 v0.24.0）
+cat > "$TMP/b4.json" <<'JSON'
+{"current":"0.24.0","dingban":["0.24.0","0.23.0","0.22.0"],"loaded":"0.24.0",
+ "tags":["v0.24.0","v0.23.0","v0.22.0"],
+ "manifest":{"v0.24.0":"0.24.0","v0.23.0":"0.23.0","v0.22.0":"0.22.0"},
+ "releases":["v0.22.0"],
+ "commits":{"v0.22.0...v0.23.0":["定版 v0.23.0（雲端拿得到票與主線）"]}}
+JSON
+t 0 "最新 tag 是 v0.24.0，要建的是 v0.23.0 → 照建（前置①看 tag 的樹，不看「最新」）" \
+  "已建立 release「v0.23.0 — 雲端拿得到票與主線」" b4.json v0.23.0
+t 0 "覆核的是 v0.23.0 這一版，不是工作樹宣稱的 0.24.0" "v0.23.0    ✅    ✅     ✅ ←" b4.json v0.23.0
+not "工作樹 plugin.json 是 9.9.9 也不會被拿來比（B 群全綠就是證據，這條釘住訊息）" "9.9.9" b4.json v0.23.0
+
+echo ""
+echo "──────────────────────────────"
+printf '共 %d 項：✅ %d ／ ❌ %d\n' "$N" "$PASS" "$FAIL"
+[ "$FAIL" -eq 0 ]

scripts/test-settings-allow-sync.sh

@@ -16,11 +16,11 @@ bad(){  FAIL=$((FAIL+1)); printf '  ❌ %s\n' "$1"; }
 N=$(python3 -c "import json;print(len(json.load(open('$LIST'))['allow']))")
 
 echo "── A. 清單本身的形狀 ──"
-python3 - "$LIST" <<'PY' && ok "A1 每一條都是 Bash(…) 形狀，而且四個正門工具都在場（ticket／mainline／gate-ok／gitea-pr-merge）" || bad "A1 清單形狀不對或少了正門工具"
+python3 - "$LIST" <<'PY' && ok "A1 每一條都是 Bash(…) 形狀，而且六個正門工具都在場（ticket／mainline／gate-ok／gitea-pr-merge／stage／Arcrun 的 stage-deploy-artifacts.py）" || bad "A1 清單形狀不對或少了正門工具"
 import json, sys
 rules = json.load(open(sys.argv[1]))["allow"]
 assert rules and all(r.startswith("Bash(") and r.endswith(")") for r in rules), rules
-for tool in ("scripts/ticket", "scripts/mainline", "scripts/gate-ok", "scripts/gitea-pr-merge.sh"):
+for tool in ("scripts/ticket", "scripts/mainline", "scripts/gate-ok", "scripts/gitea-pr-merge.sh", "scripts/stage ", "scripts/stage-deploy-artifacts.py"):
     assert any(tool in r for r in rules), "缺 " + tool
 assert not any(r.strip() in ("Bash(python3 *)", "Bash(*)", "Bash(bash *)") for r in rules), "整類放行"
 PY

scripts/test-stage.sh

@@ -0,0 +1,247 @@
+#!/bin/bash
+# scripts/stage 的測試（inkstone/ISEP#137）
+#
+# 它守什麼: 「雲端總管對 stage 的每一種寫入都有一支固定形狀的正門，而且**只**寫得進 stage」這件事的機器那一半。
+#   09-07 三種寫入（`npx wrangler secret put`／`stage-deploy-artifacts.py`／curl POST 到 arcrun-yuga3bse）在雲端
+#   全被 auto mode 分類器擋（複合指令與任意 curl 對不上白名單任何一條）。
+#   收成 `stage secret …`（CF API）與 `stage api …`（curl 打實例）；值只從環境變數名讀；
+#   判準是 CF 帳號 ID／stage 主機往放行方向比對，不看名字。
+#
+# 🔴 全程離線：CF API 與 stage 實例都指到本機一個假伺服器，不打真 Cloudflare、不碰任何 worker。
+#    真的種一把進 youlin、真的打 stage 實例的實跑在 docs/TESTING.md A36 另記。
+#    假伺服器對 secret PUT 回 **201**——真 CF 就是回 201，第一次實跑把 201 講成失敗就是這樣抓到的。
+#
+# 四個方向都要驗，缺一個就是假綠：
+#   A 拒絕（非 stage／缺變數／值在指令列）⇒ 離開碼 2，而且**沒打網路**
+#   B token 打不到 stage ⇒ 拒絕、印出它打得到誰、沒有任何 PUT
+#   C 種進 stage ⇒ PUT 的路徑帶 stage ID、body 對、值不出現在任何輸出、種完用列表確認
+#   D api：主機只會是 stage；標頭值從環境變數來；body 三種來源；非 2xx 離開碼 1
+#   E 接線：白名單有它四種形狀＋Arcrun 那支；ISEP 自己的 Bash 閘對這些呼叫形狀一支都不擋（誤攔比漏擋嚴重）
+cd "$(dirname "$0")/.." || exit 1
+ROOT=$(pwd)
+S=scripts/stage
+STAGE=1129efd7df2e8899d537e9c8fbabb6cb
+TMP=$(mktemp -d); trap 'kill $SRV 2>/dev/null; rm -rf "$TMP"' EXIT
+PASS=0; FAIL=0
+ok(){   PASS=$((PASS+1)); printf '  ✅ %s\n' "$1"; }
+bad(){  FAIL=$((FAIL+1)); printf '  ❌ %s\n' "$1"; }
+LOG="$TMP/log.jsonl"; MODE="$TMP/mode"; STATE="$TMP/secrets.json"
+export STAGE_TEST_VALUE="v-ISEP137-$(python3 -c 'import secrets;print(secrets.token_hex(12))')-must-never-print"   # 每次隨機：C8 才驗得出「值落地」
+export TOK_STAGE='tok-stage-abcdefghijklmnopqrstuvwxyz0123456789'
+export KBDB_TOK_TEST="kbdb-$(python3 -c 'import secrets;print(secrets.token_hex(8))')"
+
+# ── 假伺服器：/accounts… 扮 CF API；/<worker>/… 扮 stage 實例。mode 檔決定 CF 扮誰 ──
+cat > "$TMP/stub.py" <<'PY'
+import json, os, sys
+from http.server import BaseHTTPRequestHandler, HTTPServer
+TMP = sys.argv[1]; PORT = int(sys.argv[2])
+STAGE = "1129efd7df2e8899d537e9c8fbabb6cb"
+def mode(): return open(os.path.join(TMP, "mode")).read().strip()
+def state():
+    p = os.path.join(TMP, "secrets.json")
+    return json.load(open(p)) if os.path.exists(p) else ["KBDB_INTERNAL_TOKEN"]
+def save(s): json.dump(s, open(os.path.join(TMP, "secrets.json"), "w"))
+class H(BaseHTTPRequestHandler):
+    def log_message(self, *a): pass
+    def _send(self, code, obj):
+        b = json.dumps(obj).encode(); self.send_response(code)
+        self.send_header("Content-Type", "application/json"); self.send_header("Content-Length", str(len(b)))
+        self.end_headers(); self.wfile.write(b)
+    def _body(self):
+        n = int(self.headers.get("Content-Length", "0")); return self.rfile.read(n).decode() if n else ""
+    def _log(self, raw=None):
+        rec = {"method": self.command, "path": self.path, "auth": self.headers.get("Authorization", ""),
+               "ua": self.headers.get("User-Agent", ""), "ct": self.headers.get("Content-Type", ""),
+               "xkey": self.headers.get("X-Arcrun-API-Key", "")}
+        if raw is not None:
+            try: body = json.loads(raw)
+            except ValueError: body = {}
+            rec["body_name"] = body.get("name"); rec["body_type"] = body.get("type")
+            rec["text_ok"] = body.get("text") == os.environ.get("STAGE_TEST_VALUE")
+            rec["body_raw"] = raw if os.environ.get("STAGE_TEST_VALUE") not in raw else "<redacted>"
+        with open(os.path.join(TMP, "log.jsonl"), "a") as f: f.write(json.dumps(rec) + "\n")
+    def _instance(self):
+        # 扮 stage 實例：POST 沒帶 Bearer ⇒ 401（真 kbdb 就是這樣）；其餘 200 回聲
+        raw = self._body(); self._log(raw)
+        if self.command != "GET" and not self.headers.get("Authorization"):
+            return self._send(401, {"error": "Unauthorized"})
+        self._send(200, {"ok": True, "echo_path": self.path, "echo_method": self.command})
+    def do_GET(self):
+        if not self.path.startswith("/accounts"): return self._instance()
+        self._log(); m = mode()
+        if self.path == "/accounts":
+            if m == "401": return self._send(401, {"success": False, "errors": [{"code": 10000, "message": "Authentication error"}]})
+            acct = {"stage": [{"id": STAGE, "name": "Youlin.hsieh.dev@gmail.com's Account"}],
+                    "leo21c": [{"id": "9f3b2c1d000000000000000000000leo", "name": "Leo21c's Account"}],
+                    "geek": [{"id": "77aa11bb000000000000000000000geek", "name": "geek6688's Account"}],
+                    "both": [{"id": STAGE, "name": "Youlin"}, {"id": "9f3b2c1d000000000000000000000leo", "name": "Leo21c"}]}
+            return self._send(200, {"success": True, "errors": [], "result": acct.get(m, acct["stage"])})
+        if self.path.endswith("/secrets"):
+            names = state()
+            if m == "put-ok-list-missing": names = [n for n in names if n != "ISEP_137_PROBE"]
+            return self._send(200, {"success": True, "errors": [], "result": [{"name": n, "type": "secret_text"} for n in names]})
+        self._send(404, {"success": False, "errors": [{"code": 7003, "message": "not found"}]})
+    def do_PUT(self):
+        if not self.path.startswith("/accounts"): return self._instance()
+        raw = self._body(); self._log(raw); body = json.loads(raw or "{}")
+        s = state(); s = [x for x in s if x != body.get("name")] + [body.get("name")]; save(s)
+        self._send(201, {"success": True, "errors": [], "result": {"name": body.get("name"), "type": "secret_text"}})   # 真 CF 回 201
+    def do_DELETE(self):
+        if not self.path.startswith("/accounts"): return self._instance()
+        self._log(); name = self.path.rsplit("/", 1)[-1]
+        save([x for x in state() if x != name]); self._send(200, {"success": True, "errors": [], "result": None})
+    def do_POST(self): self._instance()
+    def do_PATCH(self): self._instance()
+HTTPServer(("127.0.0.1", PORT), H).serve_forever()
+PY
+PORT=$(python3 -c "import socket;s=socket.socket();s.bind(('127.0.0.1',0));print(s.getsockname()[1])")
+python3 "$TMP/stub.py" "$TMP" "$PORT" & SRV=$!
+for _ in $(seq 1 50); do python3 -c "import socket;socket.create_connection(('127.0.0.1',$PORT),1)" 2>/dev/null && break; sleep 0.1; done
+export STAGE_SECRET_PUT_API_BASE="http://127.0.0.1:$PORT"
+export STAGE_API_BASE_OVERRIDE="http://127.0.0.1:$PORT"
+echo stage > "$MODE"; : > "$LOG"
+reset(){ : > "$LOG"; rm -f "$STATE"; echo "${1:-stage}" > "$MODE"; }
+run(){ OUT=$(python3 "$S" "$@" 2>&1); RC=$?; }
+hits(){ grep -c "\"method\": \"$1\"" "$LOG" 2>/dev/null || true; }
+no_value(){ ! printf '%s' "$OUT" | grep -qF "$STAGE_TEST_VALUE"; }
+
+echo "── A. 本工具自己拒絕的：離開碼 2，而且沒打網路 ──"
+reset; run secret put --worker w --secret X --from-env STAGE_TEST_VALUE --token-env TOK_STAGE --account 58309bb90fd93ad6d0fe0aae99170e9d
+[ "$RC" = 2 ] && printf '%s' "$OUT" | grep -q "$STAGE" && printf '%s' "$OUT" | grep -q '交回地端' && [ "$(wc -l < "$LOG")" = 0 ] \
+  && ok "A1 --account 給非 stage（uncle6 的 ID）⇒ 拒絕、講出 stage 是誰、出路是交回地端、一個請求都沒發" || bad "A1 rc=$RC hits=$(wc -l < "$LOG") $OUT"
+reset; run secret put --worker w --secret X --from-env STAGE_TEST_VALUE --token-env NOPE_TOKEN_VAR
+[ "$RC" = 2 ] && printf '%s' "$OUT" | grep -q 'NOPE_TOKEN_VAR' && [ "$(wc -l < "$LOG")" = 0 ] \
+  && ok "A2 token 的環境變數沒值 ⇒ 拒絕、點名那個變數、沒打網路" || bad "A2 rc=$RC $OUT"
+reset; run secret put --worker w --secret X --from-env NOPE_VALUE_VAR --token-env TOK_STAGE
+[ "$RC" = 2 ] && printf '%s' "$OUT" | grep -q 'NOPE_VALUE_VAR' && printf '%s' "$OUT" | grep -q '紅線' && [ "$(wc -l < "$LOG")" = 0 ] \
+  && ok "A3 值的環境變數沒值 ⇒ 拒絕、點名變數、明講不准改寫進指令列、沒打網路" || bad "A3 rc=$RC $OUT"
+reset; run secret put --worker w --secret X --value "$STAGE_TEST_VALUE" --token-env TOK_STAGE
+[ "$RC" = 2 ] && printf '%s' "$OUT" | grep -q -- '--value' && no_value && [ "$(wc -l < "$LOG")" = 0 ] \
+  && ok "A4 --value（值在指令列）⇒ 拒收，而且拒絕訊息裡不回顯那個值" || bad "A4 rc=$RC $OUT"
+reset; run secret put --secret X --from-env STAGE_TEST_VALUE --token-env TOK_STAGE
+[ "$RC" = 2 ] && printf '%s' "$OUT" | grep -q -- '--worker' && ok "A5 缺 --worker ⇒ 拒絕、講缺哪個" || bad "A5 rc=$RC $OUT"
+reset; run frobnicate --worker w
+[ "$RC" = 2 ] && ok "A6 不認得的子命令 ⇒ 拒絕" || bad "A6 rc=$RC $OUT"
+run --help; [ "$RC" = 0 ] && printf '%s' "$OUT" | grep -q -- '--from-env' && printf '%s' "$OUT" | grep -q -- '--bearer-env' && ok "A7 --help 印兩個子命令的用法、離開碼 0" || bad "A7 rc=$RC"
+
+echo "── B. token 打不到 stage ⇒ 拒絕、印出它打得到誰、沒有 PUT ──"
+reset leo21c; run secret put --worker w --secret X --from-env STAGE_TEST_VALUE --token-env TOK_STAGE
+[ "$RC" = 2 ] && printf '%s' "$OUT" | grep -q "Leo21c's Account" && printf '%s' "$OUT" | grep -q "$STAGE" && [ "$(hits PUT)" = 0 ] && no_value \
+  && ok "B1 token 只打得到 leo21c ⇒ 拒絕、列出那個帳號、講出 stage 是哪個 ID、零 PUT" || bad "B1 rc=$RC PUT=$(hits PUT) $OUT"
+reset geek; run secret put --worker w --secret X --from-env STAGE_TEST_VALUE --token-env TOK_STAGE
+[ "$RC" = 2 ] && printf '%s' "$OUT" | grep -q "geek6688" && [ "$(hits PUT)" = 0 ] \
+  && ok "B2 token 只打得到 geek6688（出貨機）⇒ 同樣拒絕、零 PUT" || bad "B2 rc=$RC $OUT"
+reset 401; run secret put --worker w --secret X --from-env STAGE_TEST_VALUE --token-env TOK_STAGE
+[ "$RC" = 1 ] && printf '%s' "$OUT" | grep -q 'Authentication error' && [ "$(hits PUT)" = 0 ] \
+  && ok "B3 CF 回 401 ⇒ 離開碼 1（API 失敗，不是「拒絕」也不是 000）、帶 CF 的錯誤字串、零 PUT" || bad "B3 rc=$RC $OUT"
+reset; STAGE_SECRET_PUT_API_BASE="http://127.0.0.1:1" run secret put --worker w --secret X --from-env STAGE_TEST_VALUE --token-env TOK_STAGE
+[ "$RC" = 1 ] && printf '%s' "$OUT" | grep -q '__agentproxy/status' && no_value \
+  && ok "B4 連不到 CF ⇒ 離開碼 1、印錯誤類型、指到 agentproxy status（不把三種病記成 000）" || bad "B4 rc=$RC $OUT"
+reset both; run secret put --worker w --secret ISEP_137_PROBE --from-env STAGE_TEST_VALUE --token-env TOK_STAGE
+[ "$RC" = 0 ] && grep -q "\"path\": \"/accounts/$STAGE/workers/scripts/w/secrets\"" "$LOG" && ! grep -q '0000leo' "$LOG" \
+  && ok "B5 token 兩個帳號都打得到 ⇒ 放行，但 URL 只帶 stage 的 ID（寫入永遠只到 stage）" || bad "B5 rc=$RC $(cat "$LOG")"
+
+echo "── C. 種進 stage（假 CF 對 PUT 回 201，跟真的一樣）──"
+reset; run secret put --worker arcrun-cypher-executor --secret ISEP_137_PROBE --from-env STAGE_TEST_VALUE --token-env TOK_STAGE
+[ "$RC" = 0 ] && ok "C1 離開碼 0（201 算成功——第一次實跑把 201 講成失敗，就是這格抓的）" || bad "C1 rc=$RC $OUT"
+grep -q "\"method\": \"PUT\", \"path\": \"/accounts/$STAGE/workers/scripts/arcrun-cypher-executor/secrets\"" "$LOG" \
+  && ok "C2 PUT 打的是 stage 帳號 ID 底下那顆 worker" || bad "C2 $(cat "$LOG")"
+grep '"method": "PUT"' "$LOG" | grep -q '"body_name": "ISEP_137_PROBE", "body_type": "secret_text", "text_ok": true' \
+  && ok "C3 body 的 name／type 對，而且 text 就是環境變數裡那個值（不是變數名）" || bad "C3 $(grep PUT "$LOG")"
+no_value && ok "C4 stdout／stderr 不含那個值" || bad "C4 值印出來了"
+grep -q '"auth": "Bearer tok-stage-' "$LOG" && ok "C5 Authorization 帶的是 --token-env 指的那把" || bad "C5 $(head -1 "$LOG")"
+printf '%s' "$OUT" | grep -q 'ISEP_137_PROBE' && printf '%s' "$OUT" | grep -q 'KBDB_INTERNAL_TOKEN' \
+  && ok "C6 種完把列表印出來（新的那把＋原本就有的）" || bad "C6 $OUT"
+[ "$(grep -c '"method": "GET", "path": "/accounts/'"$STAGE"'/workers/scripts/arcrun-cypher-executor/secrets"' "$LOG")" = 1 ] \
+  && ok "C7 種完真的去列了一次（不是只信 PUT 的回應）" || bad "C7 $(cat "$LOG")"
+! grep -rqF "$STAGE_TEST_VALUE" "$ROOT" 2>/dev/null \
+  && ok "C8 值沒落在 repo 樹裡任何檔案" || bad "C8 值落地了：$(grep -rlF "$STAGE_TEST_VALUE" "$ROOT")"
+reset put-ok-list-missing; run secret put --worker w --secret ISEP_137_PROBE --from-env STAGE_TEST_VALUE --token-env TOK_STAGE
+[ "$RC" = 1 ] && printf '%s' "$OUT" | grep -q '列表卻沒有' \
+  && ok "C9 CF 說成功但列表沒有 ⇒ 離開碼 1（不把 2xx 講成種好了）" || bad "C9 rc=$RC $OUT"
+reset; run secret list --worker w --token-env TOK_STAGE
+[ "$RC" = 0 ] && printf '%s' "$OUT" | grep -q 'KBDB_INTERNAL_TOKEN' && [ "$(hits PUT)" = 0 ] && ok "C10 secret list 印名字、不寫" || bad "C10 rc=$RC $OUT"
+reset; run secret delete --worker w --secret KBDB_INTERNAL_TOKEN --token-env TOK_STAGE
+[ "$RC" = 0 ] && grep -q "\"method\": \"DELETE\", \"path\": \"/accounts/$STAGE/workers/scripts/w/secrets/KBDB_INTERNAL_TOKEN\"" "$LOG" \
+  && ok "C11 secret delete 打對路徑、刪完列表確認" || bad "C11 rc=$RC $OUT $(cat "$LOG")"
+reset leo21c; run secret delete --worker w --secret X --token-env TOK_STAGE
+[ "$RC" = 2 ] && [ "$(hits DELETE)" = 0 ] && ok "C12 delete 對非 stage 的 token 一樣拒絕" || bad "C12 rc=$RC"
+
+echo "── D. api：主機只會是 stage、標頭值從環境變數來、body 三種來源 ──"
+reset; run api POST https://arcrun-cypher-executor.leo21c.workers.dev/kbdb/entries --json '{}'
+[ "$RC" = 2 ] && printf '%s' "$OUT" | grep -q 'leo21c.workers.dev' && printf '%s' "$OUT" | grep -q 'arcrun-yuga3bse' && [ "$(wc -l < "$LOG")" = 0 ] \
+  && ok "D1 完整網址指到 leo21c ⇒ 拒絕、講出 stage 主機是什麼、沒打網路" || bad "D1 rc=$RC $OUT"
+reset; run api POST https://arcrun-kbdb.youlin-hsieh-dev.workers.dev/records --json '{}'
+[ "$RC" = 2 ] && [ "$(wc -l < "$LOG")" = 0 ] && ok "D2 09-02 已死的舊子網域 youlin-hsieh-dev 也拒絕（不是 stage 的識別碼）" || bad "D2 rc=$RC $OUT"
+reset; run api POST arcrun-kbdb/records --bearer 'Bearer xyz' --json '{}'
+[ "$RC" = 2 ] && printf '%s' "$OUT" | grep -q -- '--bearer' && [ "$(wc -l < "$LOG")" = 0 ] && ok "D3 --bearer／--header（值在指令列）⇒ 拒收" || bad "D3 rc=$RC $OUT"
+reset; run api POST arcrun-kbdb/records --bearer-env NOPE_KBDB --json '{}'
+[ "$RC" = 2 ] && printf '%s' "$OUT" | grep -q 'NOPE_KBDB' && [ "$(wc -l < "$LOG")" = 0 ] && ok "D4 --bearer-env 指的變數沒值 ⇒ 拒絕、點名" || bad "D4 rc=$RC $OUT"
+reset; run api POST 'arcrun-kbdb/map/recompute?library=rt-lib&owner_id=yuga3bse' --bearer-env KBDB_TOK_TEST
+[ "$RC" = 0 ] && grep -q '"method": "POST", "path": "/arcrun-kbdb/map/recompute?library=rt-lib&owner_id=yuga3bse", "auth": "Bearer kbdb-' "$LOG" \
+  && printf '%s' "$OUT" | grep -q '^HTTP 200' && ok "D5 POST <worker>/<path>?query：主機由工具補、query 原樣、Bearer 從環境變數來、印 HTTP 200、離開碼 0" || bad "D5 rc=$RC $OUT $(cat "$LOG")"
+reset; run api POST arcrun-kbdb/records --bearer-env KBDB_TOK_TEST --json '{"template":"triplet","values":{"s":"a"}}'
+grep -q '"ct": "application/json"' "$LOG" && grep -q '"body_raw": "{\\"template\\":\\"triplet\\",\\"values\\":{\\"s\\":\\"a\\"}}"' "$LOG" \
+  && ok "D6 --json：body 原樣送到、自動帶 Content-Type: application/json" || bad "D6 $(cat "$LOG")"
+reset; STAGE_BODY_TEST='{"secret_ref":"'"$STAGE_TEST_VALUE"'"}' run api PUT arcrun-cypher-executor/credentials/gitea_token --bearer-env KBDB_TOK_TEST --data-env STAGE_BODY_TEST
+[ "$RC" = 0 ] && grep -q '"method": "PUT", "path": "/arcrun-cypher-executor/credentials/gitea_token"' "$LOG" && grep -q '"body_raw": "<redacted>"' "$LOG" && no_value \
+  && ok "D7 --data-env：body 從環境變數來（機敏 body 不進指令列），值沒印出來" || bad "D7 rc=$RC $OUT $(cat "$LOG")"
+reset; printf '{"x":1}' > "$TMP/body.json"; run api POST arcrun-kbdb/records --bearer-env KBDB_TOK_TEST --data-file "$TMP/body.json"
+[ "$RC" = 0 ] && grep -q '"body_raw": "{\\"x\\":1}"' "$LOG" && ok "D8 --data-file：body 從檔案來" || bad "D8 rc=$RC $(cat "$LOG")"
+reset; run api POST arcrun-kbdb/records --json '{}'
+[ "$RC" = 1 ] && printf '%s' "$OUT" | grep -q '^HTTP 401' && ok "D9 沒帶 Bearer 的 POST ⇒ 實例回 401 ⇒ 離開碼 1（不把非 2xx 講成成功）" || bad "D9 rc=$RC $OUT"
+reset; run api GET arcrun-cypher-executor/health
+[ "$RC" = 0 ] && grep -q '"method": "GET", "path": "/arcrun-cypher-executor/health"' "$LOG" && ok "D10 GET 不帶 body、不帶 Content-Type" || bad "D10 rc=$RC $OUT"
+grep -q '"ct": ""' "$LOG" && ok "D11 GET 的請求真的沒有 Content-Type" || bad "D11 $(cat "$LOG")"
+reset; run api POST arcrun-cypher-executor/webhooks/named/yuga3bse/x/trigger --header-env X-Arcrun-API-Key=KBDB_TOK_TEST --bearer-env KBDB_TOK_TEST --json '{}'
+grep -q '"xkey": "kbdb-' "$LOG" && ok "D12 --header-env Name=VAR：任意標頭值從環境變數來" || bad "D12 $(cat "$LOG")"
+reset; run api POST https://arcrun-kbdb.arcrun-yuga3bse.workers.dev/records --bearer-env KBDB_TOK_TEST --json '{}'
+[ "$RC" = 0 ] && grep -q '"path": "/arcrun-kbdb/records"' "$LOG" && ok "D13 完整網址但主機就是 stage ⇒ 收" || bad "D13 rc=$RC $OUT"
+reset; run api POST 'arcrun-kbdb/records' --bearer-env KBDB_TOK_TEST --json '{}' --data-file x
+[ "$RC" = 2 ] && [ "$(wc -l < "$LOG")" = 0 ] && ok "D14 --json 與 --data-file 同時給 ⇒ 拒絕" || bad "D14 rc=$RC"
+reset; run api FROB arcrun-kbdb/records
+[ "$RC" = 2 ] && ok "D15 不認得的 METHOD ⇒ 拒絕" || bad "D15 rc=$RC"
+reset; STAGE_API_BASE_OVERRIDE="http://127.0.0.1:1" run api GET arcrun-cypher-executor/health
+[ "$RC" = 1 ] && printf '%s' "$OUT" | grep -q 'curl 失敗' && printf '%s' "$OUT" | grep -q '__agentproxy/status' && ok "D16 curl 連不上 ⇒ 離開碼 1、印 curl 的錯誤字串與 agentproxy 出路（不記成 000）" || bad "D16 rc=$RC $OUT"
+grep -q '"ua": "isep-stage/1' "$LOG" 2>/dev/null || { reset; run api GET arcrun-cypher-executor/health; }
+grep -q '"ua": "isep-stage/1' "$LOG" && ok "D17 UA 是自己的名字（youlin 邊緣擋 python-urllib UA，Arcrun#176 comment 6487）" || bad "D17 $(cat "$LOG")"
+
+echo "── E. 接線 ──"
+python3 - <<'PY' && ok "E1 docs/permissions-allow.json 有 stage 四種呼叫形狀＋Arcrun 的 stage-deploy-artifacts.py，沒放整類" || bad "E1 白名單形狀不齊或放了整類"
+import json
+rules = json.load(open("docs/permissions-allow.json"))["allow"]
+need = ['Bash(python3 ~/.claude/plugins/cache/inkstone/isep/*/scripts/stage *)',
+        'Bash(python3 "$CLAUDE_PLUGIN_ROOT/scripts/stage" *)',
+        'Bash(python3 "$CLAUDE_PLUGIN_ROOT"/scripts/stage *)',
+        'Bash(python3 scripts/stage *)',
+        'Bash(python3 scripts/stage-deploy-artifacts.py *)']
+for n in need: assert n in rules, "缺 " + n
+assert not any(r in ("Bash(npx *)", "Bash(wrangler *)", "Bash(npx wrangler *)", "Bash(python3 *)", "Bash(curl *)") for r in rules)
+PY
+# ISEP 自己掛在 PreToolUse Bash 上的每一支閘，對三種真實呼叫形狀都不准擋（清單當場從 hooks.json 讀，不寫死）
+BLOCKED=""
+while IFS= read -r CMD; do
+  for h in $(python3 -c "
+import json
+d=json.load(open('hooks/hooks.json'))
+for g in d['hooks']['PreToolUse']:
+    if 'Bash' in (g.get('matcher') or ''):
+        for x in g['hooks']: print(x['command'].split('/')[-1])
+"); do
+    [ -f "hooks/$h" ] || continue
+    printf '%s' "{\"tool_name\":\"Bash\",\"tool_input\":{\"command\":$(python3 -c 'import json,sys;print(json.dumps(sys.argv[1]))' "$CMD")},\"session_id\":\"t137\",\"cwd\":\"$ROOT\"}" \
+      | CLAUDE_PLUGIN_ROOT="$ROOT" CLAUDE_PROJECT_DIR="$ROOT" bash "hooks/$h" >/dev/null 2>"$TMP/hook.err"; rc=$?
+    [ "$rc" = 2 ] && BLOCKED="$BLOCKED $h←$(printf '%s' "$CMD" | cut -c1-40)"
+  done
+done <<'CMDS'
+python3 ~/.claude/plugins/cache/inkstone/isep/0.24.0/scripts/stage secret put --worker arcrun-cypher-executor --secret CF_SECRETS_API_TOKEN --from-env CF_SECRETS_API_TOKEN_VALUE
+python3 "$CLAUDE_PLUGIN_ROOT/scripts/stage" api POST 'arcrun-kbdb/map/recompute?library=rt-lib&owner_id=yuga3bse' --bearer-env KBDB_INTERNAL_TOKEN
+python3 scripts/stage-deploy-artifacts.py all --confirm
+CMDS
+[ -z "$BLOCKED" ] && ok "E2 ISEP 掛在 Bash 上的閘，對三種真實呼叫形狀（含 secret 字樣、POST、--confirm）一支都不擋——誤攔比漏擋嚴重" || bad "E2 這幾支誤攔：$BLOCKED"
+grep -q 'scripts/stage ' scripts/test-settings-allow-sync.sh && grep -q 'stage-deploy-artifacts.py' scripts/test-settings-allow-sync.sh \
+  && ok "E3 settings-allow-sync 的測試把兩支都算進正門工具（少了會紅）" || bad "E3 settings-allow-sync 測試不認得它們"
+[ ! -e scripts/stage-secret-put ] && ok "E4 沒有第二支平行的工具（stage-secret-put 已收進 stage secret）" || bad "E4 還留著 stage-secret-put"
+
+echo; echo "$PASS/$((PASS+FAIL)) 通過"
+[ "$FAIL" -eq 0 ]

system-dev/wiki/mistakes.md

@@ -295,3 +295,60 @@ leo 當場：「**這些為什麼不寫到票裡？**」
 正確做法: `repo_arg()` 兩種寫法都收；org 寫錯（`Leo/`）當場講「org 是 inkstone」，不讓它變成一個要人猜的 404。
       測試 `scripts/test-ticket-repo-arg.sh` 把 `api()` 換成假貨記路徑，離線驗路徑裡不准出現 `inkstone/inkstone`。
 
+
+## ⚠️ MISTAKE: 權限白名單是「逐條比前綴」，複合指令永遠對不上——而假伺服器照自己的想像回 200
+
+票: `inkstone/ISEP#137`（母票 `inkstone/ISEP#130`）
+日期: 2026-09-07
+
+症狀: 三條主線工人在雲端對 stage 的寫入全被 Claude Code auto mode 分類器擋：
+      `printf … | npx wrangler secret put …`、`python3 scripts/stage-deploy-artifacts.py all --confirm`、
+      `curl -X POST …arcrun-yuga3bse.workers.dev/records`。同一回合連 `ticket where <含 token 字樣>` 都被擋。
+      leo：「為什麼會擋你，這就是要修復的問題」「本機環境跟你不同應該不行」。
+
+實查: `docs/permissions-allow.json` 的每一條是**完全比對前綴**。`cd … && printf … | VAR=… npx …` 這種複合指令
+      沒有任何一條對得上，任意寫法的 curl 更不可能；放整類（`Bash(npx *)`／`Bash(curl *)`）又是紅線。
+      ⇒ 分類器擋的不是「這件事」，是「這個形狀沒被事先放行」。
+
+原因: 正門工具的價值在**形狀固定**——一條規則就能事先放行。之前四個正門（ticket／mainline／gate-ok／gitea-pr-merge）
+      都是這樣活下來的；對 stage 的寫入沒有正門，人就只能拼複合指令，而複合指令天生對不上任何前綴。
+
+正確做法:
+  - 每一種要放行的動作收成一支固定形狀（`scripts/stage secret …`／`stage api …`），白名單放它四種呼叫形狀。
+    「只打 stage」寫死在程式裡（帳號 ID 現查、主機後綴固定），不靠變數名字裡有沒有 `leo21c`。
+  - 別的 repo 已經有的正門（Arcrun `stage-deploy-artifacts.py` 自己寫死 youlin 帳號 ID）**直接放它的形狀**，不重造一支。
+  - 值只從環境變數名讀；`--value`／`--bearer`／`--header` 一律拒收——指令列會進 shell 歷史與 session log。
+
+📌 同票第二個坑：**假伺服器要照真 API 回，不是照自己的想像回。**
+   離線測試的假 CF 對 secret PUT 回 200，27/27 全綠；第一次真跑 CF 回 **201**，工具把它講成「失敗」——
+   而獨立用 CF API 一列，那把 secret 明明種進去了。全綠的測試證明的是「工具跟假伺服器合得來」，
+   不是「工具跟 CF 合得來」。⇒ 假伺服器的回應碼要抄真的（現在回 201），而且**離線全綠之後一定要真跑一次**。
+
+## ⚠️ MISTAKE: 前置條件判的是「手邊的樹」，而要送出去的東西是「那個 tag 的樹」
+
+票: `inkstone/ISEP#67` → comment 6574
+日期: 2026-09-07
+
+症狀: 總管在 v0.23.0 的 checkout 跑 `release-ship v0.23.0 --dry-run` 被擋，訊息說
+      「最新 tag 是 v0.24.0」。v0.23.0 的樹明明一致，只因為它不是最新的那個 tag，
+      就永遠建不了 release——而 09-07 缺 release 的正是 v0.23.0 與 v0.24.0 兩個。
+
+實查: 09-05 那版 release-ship 的前置①直接跑 `check-version-consistency.sh`
+      （工作樹 `plugin.json` vs **本機最新** tag）當判準，理由寫著「不另立判準」。
+      但那支守的是「打 tag 那一刻 main 跟最新 tag 一致」（release-tag-guard.sh 的事），
+      建 release 這一刻要問的是「**要送的那個 tag 的樹**，自己講的版本對不對」——
+      工作樹可能是任何分支（release-ship 本身就是在一條 feature 分支上寫的），跟那個 tag 無關。
+
+原因: 「重用既有判準」是對的方向，但重用之前要問「**它判的是哪個對象**」。
+      對象錯了，判準再對也只是在檢查一個跟交付物無關的東西——而且會用一條看起來
+      很有道理的訊息把正確的操作擋掉（誤攔）。
+
+正確做法: 前置①改成問 Gitea `contents/.claude-plugin/plugin.json?ref=<tag>`，
+      比的是 tag 自己的樹；工作樹的版本完全不參與（`scripts/test-release-ship.sh` 把工作樹
+      故意擺成 `9.9.9`，B 群全綠才算證明）。同時把「問 Gitea」收成一份
+      （`hooks/lib/release_chain.py`），release-ship／release-check／SessionStart 信標三處共用——
+      判準散在三處各寫一份，就是 `leo21c-write-guard.sh` 那一族漂掉的路。
+
+📌 判準：**送出去之前，先問「我判的是不是我要送的那個東西」**。
+   工作樹、最新 tag、main——都不是；tag 指到的那棵樹才是。
+