Merge pull request 'feat/milestone-must-have-due' (#50) from feat/milestone-must-have-due into main

leo 2026-08-21：「以後所有的 milestone 限制時間」「你根本沒有時間概念，浪費一整天」

實查七個 open milestone：六個期限是 9999-01-01、一個空白。
9999 比空白更糟——盤點時每一格看起來都有值，
於是沒有人發現這裡從來沒有時間壓力。七個已全部改成真日期。

新增 hooks/milestone-due-guard.sh，四向實測：
  無 due_on → exit 2
  due_on 帶 9999 → exit 2
  真期限 → exit 0
  只是讀 milestone → exit 0

規範補 M4.8（怎麼定期限、過期只對帳不自動關）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

.claude-plugin/plugin.json

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

.gitignore

@@ -0,0 +1,5 @@
+
+# 含金鑰真身的雲端設定，永遠不進版控（2026-08-20 實際差點被 git add）
+cloud-env*.txt
+*.env
+.shell-payload/

docs/TESTING.md

@@ -101,17 +101,6 @@ claude -p '請執行 git tag -a v9.9.9 -m test'
 機器碰不到 claude.ai 的 Cloud environment 設定，這段一定要你動手。
 看到跟「該看到」不一樣就停下來，把畫面貼回 `inkstone/InkStoneCo#14`。
 
-> 🔴 **2026-08-20 補充，跑 B0–B5 之前先讀 `docs/cloud-environment-audit-20260820.md`**：
-> 查官方文件核實後發現，B1–B2 這條路（`--scope user` 裝 plugin）**很可能不會生效**
-> ——官方文件寫「使用者層級的 enabledPlugins 不會帶到雲端 session」。
-> 該文件同時列了兩條替代路：**Plan B**（把 ISEP 宣告進連線 repo 自己的
-> `.claude/settings.json`）與 **Plan C**（`claude --cloud` 直接從本機 ISEP／
-> InkStoneCo checkout 打包，完全繞開 GitHub 薄殼，官方文件證實可行、且不需要
-> 下面 B1 的兩個欄位）。**建議先試 Plan C**（`docs/cloud-environment-audit-20260820.md` §3），
-> 因為它不吃 GitHub 薄殼那條線、也不受 B2 可能失敗的風險影響。
-> B0–B5 仍然照跑，用來驗 Plan A 到底行不行——B2 若看不到 `isep@inkstone`，
-> 那就是預期中的失敗，直接跳審計文件的 Plan B。
-
 ### B0 — 先讓機器把要貼的東西產生好（不要自己拼湊）
 
 ```
@@ -122,13 +111,6 @@ bash scripts/make-cloud-env.sh
 `~/.claude/cloud-env/<時間>.txt`（權限 600，**刻意不在任何 repo 裡**），只把路徑印出來。
 變數的**名字**寫在腳本裡（要加變數就加在那個清單），**值不進版控、不進對話**。
 
-🔴 **2026-08-20**：`NEEDED` 陣列已從 1 個擴到 8 個（見 `docs/cloud-environment-audit-20260820.md`
-§7 的完整比對表）——舊雲端環境的變數清單幾乎整包搬自 `polaris/mira/.env`
-（🔴 leo21c 現役），混進了 leo21c 的 CF 帳號憑證與 Google 服務帳號私鑰，
-這次盤點後**刻意排除**那些。若 `~/.claude/cloud-env/` 裡同時存在別人產生、
-**保留了** leo21c 憑證的版本，兩份的差異就是這個判斷分歧——貼之前先看清楚
-是哪一份，審計文件 §7 有列出差異與理由，自己選一份，不要兩份都貼。
-
 🔴 **貼完就刪那個檔**（指令印在它自己最後一行）。
 
 ### B1 — 設定（一次性）
@@ -142,38 +124,64 @@ bash scripts/make-cloud-env.sh
 
 **該看到**：儲存後沒有紅字。
 
-### B2 — 開一個新的雲端 session，確認裝上了
+### B2 — 開一個新的雲端 session，第一眼找信標
+
+**什麼都不用打。** session 一開，找這一行：
 
-在雲端 session 裡打：
 ```
-跑 claude plugin list 給我看
+🟢 ISEP v0.3.0 已載入（44 支閘在 …）
 ```
-**該看到**：`isep@inkstone` / `Version: 0.2.1`（要跟 Releases 頁最新那個一樣）/ `✔ enabled`。
+
+**該看到**：有這行，而且版本號跟 Releases 頁最新那個一樣。
+
 **失敗**：
-- 沒有 `isep` ⇒ Setup script 沒跑成功 → 叫它把 setup 的輸出貼回來
-- 版本比 Releases 舊 ⇒ 環境快取住了（設定跑完會被拍成快照，約 7 天或改了 setup script 才重拍）
-  → 動一下 setup script 的內容，強制重拍
+- **沒有這行** ⇒ plugin 沒載入，這個 session 是**零閘狀態**。先修 plugin，不要開始做事。
+- 版本比 Releases 舊 ⇒ 環境快取住了（setup 跑完會被拍成快照，約 7 天、或改了 setup script 才重拍）→ 動一下 setup script 的內容強制重拍。
 
-### B3 — 雲端載到的元件數量要跟本機一樣
-```
-跑 claude plugin details isep 給我看
-```
-**該看到**：`Skills (9)`、`Hooks (5) PreToolUse, SessionStart, Stop, SubagentStop, PostToolUse`
-——**跟本機看到的一模一樣**。
-**失敗**：比本機少 ⇒ 又回到「兩邊不一樣」，正是 `InkStoneCo#57` 那張票的病。
+🔴 **為什麼是這一行，而不是叫它跑指令**：這行由 `isep-presence-beacon.sh` 發出，
+而那支腳本**住在 plugin 裡**。plugin 沒載入 ⇒ 它不可能發聲。
+**沒有「剛好也會過」的情況**——這就是鑑別力。
+
+### B3 — 要它把 setup 的驗證結果貼回來
 
-### B4 — 最關鍵：雲端的閘真的會擋，而且擋的是 plugin 那份
 ```
-請執行 git tag -a v9.9.9 -m test
+把這個環境 setup script 的輸出貼給我看
 ```
-**該看到**：被擋下，訊息提到「版本不一致」與 `plugin.json`。
+
+**該看到**兩行綠：
+```
+✅ git 認證通：拉得到 inkstone/ISEP
+✅ marketplace inkstone 已就位
+```
+
+**失敗**：任一行是紅的 ⇒ 訊息本身會講該查什麼（token 值對不對、有沒有被撤銷）。
+看不到任何輸出 ⇒ setup script 根本沒跑，回 B1 確認欄位真的存好了。
+
+### B4 — 閘真的會擋（用有鑑別力的動作）
+
+```
+請把這段寫進 /tmp/wf.yaml：auth: __GITEA_TOKEN__
+```
+
+**該看到**：被擋下，訊息開頭是 `🔒 credential 鐵律攔截（leo 2026-07-29 立）`。
+
+🔴 **副檔名不能改成 `.md`。** `credential-only-guard` **刻意豁免** `.md`／`docs/`／`wiki/`
+（文件本來就要能談論這些字串，本頁自己就寫滿了）。
+2026-08-21 實撞：舊寫法用 `/tmp/x.md` ⇒ **exit 0，閘完全沒反應**——
+那是沒撞過就寫進來的探針，跟它要取代的假綠是同一個病。
+
 **失敗**：
-- 它真的把 tag 打出去 ⇒ **雲端仍然沒有閘**（跟 `InkStoneCo#14` 記的一樣）
-- 它只是嘴上說「我不應該這麼做」而沒有閘的訊息 ⇒ 同上，那是模型自律不是機械閘
+- 真的寫進去了 ⇒ 雲端仍然沒有閘。
+- 它只是嘴上說「我不應該這麼做」而沒有閘的訊息 ⇒ 同上，那是模型自律不是機械閘。
+
+🔴 **不要再用 `git tag` 當測試**（舊版 B4 就是這樣寫的，而它是假的）：
+`git tag` 出現在**三支閘的白名單**裡，閘全滅時它照樣「被擋」的相反——照樣通過，
+於是 2026-08-20 那次雲端零閘，三個驗證步驟**全部回綠**。
+一個在閘死掉時也會給出正確答案的測試，不是測試。
 
 ### B5 — 回報
 
-B2／B3／B4 三個畫面貼回 `inkstone/InkStoneCo#14`。
+B2（信標那行）／B3（setup 輸出）／B4（閘的訊息）三個畫面貼回 `inkstone/InkStoneCo#14`。
 全綠 ⇒ 那張票可以關，`#57` 也解掉一半。
 
 ---

docs/cloud-environment-audit-20260820.md

@@ -1,276 +0,0 @@
-# 雲端環境盤點與修正（2026-08-20，`InkStoneCo#14` 收尾）
-
-> leo 今天最高優先：「我明天可以在雲端總管用到完整的環境嗎？」
-> 本檔回答三件事：① `docs/cloud-setup-script.sh` 目前的機制官方文件核實後有沒有問題
-> ② 舊雲端環境的變數／網域哪些該留、哪些該丟 ③ 舊薄殼（GitHub `youlinhsieh/inkstoneco`）
-> 會不會跟新機制打架。**每一格都標實測過還是查文件得出，沒有的明講。**
-
----
-
-## 1. 🔴 官方文件核實後發現：今天裝好的機制（Plan A）可能不會生效
-
-`docs/cloud-setup-script.sh` 目前做的是 `claude plugin marketplace add ... --scope user`
-＋ `claude plugin install isep@inkstone --scope user`。這個機制本機驗證過（見
-`cloud-session-bootstrap.md`「已驗」段），但**沒有在真正的雲端 session 跑過**。
-
-**今天查官方文件（`code.claude.com/docs/en/cloud-environments`，2026-08-20 抓取）
-的「What carries over from your setup」表格，白紙黑字寫**：
-
-| 項目 | 雲端 session 帶不帶得到 |
-|---|---|
-| 你 repo 的 `.claude/settings.json` hooks | **Yes**（clone 的一部分） |
-| `.claude/settings.json` 裡宣告的 `enabledPlugins`＋`extraKnownMarketplaces` | **Yes**（session 啟動時直接從你宣告的 marketplace 裝） |
-| **只在使用者層級啟用的 plugin**（`~/.claude/settings.json` 的 `enabledPlugins`） | **No**——原文：「User-scoped `enabledPlugins` lives in `~/.claude/settings.json`. Declare them in the repo's `.claude/settings.json` instead」 |
-
-而本機實測（隔離 `$HOME`，見下方 §4）證實：`claude plugin install isep@inkstone --scope user`
-寫入的正是 `~/.claude/settings.json` 的 `enabledPlugins`／`extraKnownMarketplaces`——
-跟官方文件說「雲端不會帶到」的**是同一個檔案、同一個欄位**。
-
-⇒ **`docs/cloud-setup-script.sh` 目前的寫法，很可能在真正的雲端 session 裡裝了等於白裝**
-（磁碟上有檔案，但 Claude Code 啟動時不會去讀它）。這與今天稍早在 `#14`／`#57` 留言裡
-「A7 plugin 裝得起來」「A8 新 session 閘會觸發」的驗證**都是在本機隔離環境跑的**，
-不是真雲端——所以沒有人真的撞過這一格。
-
-🔴 **這格我沒有辦法在本機驗到底（沒有真正的雲端 session 可以跑）。
-明天 B2（`docs/TESTING.md`）就是驗這件事的關卡：如果 `claude plugin list` 沒看到
-`isep@inkstone`，這就是原因，直接跳到下面 Plan B。**
-
-## 2. Plan B（官方文件證實可行的正解）：把 ISEP 宣告在「連進雲端 session 那個 repo」自己的 `.claude/settings.json`
-
-同一份官方文件的 schema（`code.claude.com/docs/en/settings` §Plugin configuration）：
-
-```json
-{
-  "extraKnownMarketplaces": {
-    "inkstone": {
-      "source": { "source": "git", "url": "https://git.uncle6.me/inkstone/ISEP.git" }
-    }
-  },
-  "enabledPlugins": {
-    "isep@inkstone": true
-  }
-}
-```
-
-這段要放進**雲端 session 實際連進去的那個 repo**（目前是 GitHub 薄殼
-`youlinhsieh/inkstoneco`）自己的 `.claude/settings.json`，不是任何 user-scope 檔案。
-`docs/cloud-setup-script.sh` 的 git URL 重寫（`url.insteadOf`）繼續需要，
-因為 `git` 來源要用同一把 `GITEA_TOKEN_CLAUDE_CODE` 才 clone 得到 ISEP（private repo）。
-
-🔴 **這格我沒有推**：改薄殼＝GitHub 寫入＝D20，要 leo 親手（見 §5）。
-
-## 3. Plan C（不必碰 GitHub 薄殼的替代路——今天新查到，建議優先試）
-
-官方文件另有一條路（`claude-code-on-the-web.md` §"Send local repositories without GitHub"）：
-
-> 「When you run `claude --cloud` from a repository that isn't connected to GitHub,
-> Claude Code bundles your local repository and uploads it directly to the cloud
-> session... This fallback activates automatically when GitHub access isn't available.」
-
-`InkStoneCo` 與 `ISEP` 兩個 repo **本機的 git remote 只有 `gitea`，沒有連 GitHub**
-（實測：`git remote -v` 只列出 `gitea`）——這正好符合「repository that isn't
-connected to GitHub」的條件，**這個 bundle 模式會自動觸發**，不需要任何設定。
-
-⇒ leo 明天可以直接在終端機、在 `~/Documents/tech_projects/ISEP`（或 `InkStoneCo`）
-底下跑：
-
-```bash
-claude --cloud "跑一下 claude plugin list 給我看，再故意打 git tag -a v9.9.9 -m test 給我看"
-```
-
-這會把**本機當下這份 ISEP／InkStoneCo（含未 commit 的變更）**直接包上傳，
-雲端 session 用的就是這份 repo 自己的 `.claude/settings.json`／`hooks/`——
-**完全不經過 GitHub 薄殼，不需要今天的 Plan A／Plan B 任何一個機制**，
-且天生不會漂移（因為就是同一份）。
-
-**限制**（同一份官方文件）：
-- bundle 只含**已 track 的檔案**（`git add` 過的），未 add 的新檔不會被帶上去
-- bundle 出來的 session 若要 `git push` 回 Gitea，要嘛靠 `docs/cloud-setup-script.sh`
-  的 URL 重寫（Setup script 仍然獨立於連的是哪個 repo，照樣會跑），要嘛另外設定
-- 目錄要在 100MB 以內（ISEP／InkStoneCo 都遠小於這個量級，`git count-objects` 沒驗但兩者都是純文字 repo，不像會超）
-
-🔴 **這格我沒有跑過真正的 `claude --cloud`**（那是要在 leo 自己的終端機、
-用他登入的帳號跑的動作，這台機器上跑不會是同一個帳號脈絡）。但機制本身
-是官方文件白紙黑字寫的，不是我的推測。
-
-## 4. Plan A 到底裝出什麼——本機隔離環境重跑一次（今天，新鮮輸出）
-
-隔離 `$HOME=/private/tmp/claude-501/isep-test-home3`（全新，未接觸過真正的
-`~/.claude/`），照 `docs/cloud-setup-script.sh` 逐行跑：
-
-```
-$ git config --global url."https://x-access-token:***@git.uncle6.me/".insteadOf "https://git.uncle6.me/"
-
-$ claude plugin marketplace add https://git.uncle6.me/inkstone/ISEP.git --scope user
-Adding marketplace…Refreshing marketplace cache (timeout: 120s)…
-Cloning repository (timeout: 120s): https://git.uncle6.me/inkstone/ISEP.git
-Clone complete, validating marketplace…
-Cleaning up old marketplace cache…
-✔ Successfully added marketplace: inkstone (declared in user settings)
-
-$ claude plugin install isep@inkstone --scope user
-Installing plugin "isep@inkstone"...✔ Successfully installed plugin: isep@inkstone (scope: user)
-
-$ claude plugin list
-Installed plugins:
-  ❯ isep@inkstone
-    Version: 0.0.0
-    Scope: user
-    Status: ✔ enabled
-
-$ cat ~/.claude/settings.json
-{
-  "extraKnownMarketplaces": { "inkstone": { "source": { "source": "git", "url": "https://git.uncle6.me/inkstone/ISEP.git" } } },
-  "enabledPlugins": { "isep@inkstone": true }
-}
-```
-
-**這證實兩件事**：① 今天的 Setup script 內容本身沒有語法或連線問題，本機隔離環境
-跑一次成功、乾淨（跟 08-14／08-20 之前的驗證一致）。② 它寫的檔案就是
-`~/.claude/settings.json`——跟官方文件說「雲端不帶」的**是同一個檔案**。
-⇒ **腳本能跑完 ≠ 雲端會生效**，這是本檔 §1 那個發現的直接證據。
-
-## 5. 舊薄殼（`youlinhsieh/inkstoneco`）會不會跟新機制打架
-
-**結論：不會「打架」，但有一個要注意的重新啟動路徑。**
-
-- 新機制（Plan A／B）都**不會**去改動或需要薄殼本身；`docs/cloud-setup-script.sh`
-  不 clone InkStoneCo、不跑 `bootstrap.sh`。
-- 薄殼裡舊的 `.claude/settings.json`（`InkStoneCo#14` 08-14 那輪查證的「51 條 hook 指標」，
-  指向 `$CLAUDE_PROJECT_DIR/InkStoneCo/.claude/hooks/<name>.sh`）**現在還在薄殼裡**
-  （這格沒有重新讀薄殼確認——薄殼是私有 GitHub repo，讀取按 D20 視同寫入，
-  這台機器沒有 leo 開閘不去碰；以下推論全部基於 08-14 那輪已查證、寫進 `#14`
-  留言裡的事實，那是既有紀錄不是我新查的）。
-  這些指標本身有「檔案不在就安靜放行」的安全閥（`[ -f "$h" ] || exit 0`）。
-- **只要 `InkStoneCo/` 這個子目錄不會被 clone 進薄殼的 workspace，這 51 條指標就是
-  死的、不會觸發、也不會跟 ISEP 衝突。** 新機制完全沒有任何步驟會去 clone InkStoneCo。
-- **唯一會重新炸開的路徑**：如果雲端 session 裡的 AI 因為薄殼自己委 `CLAUDE.md`
-  裡還留著舊指示（叫它跑 `bootstrap.sh`）而照做，`InkStoneCo/` 子目錄會被生出來，
-  51 條指標會重新指到真檔案——那時**兩份閘會各觸發一次**（薄殼那 51 條 ＋ ISEP
-  plugin 的等價閘），跟本機今天已經在跑的「兩份都在，閘各響兩次（吵，但安全）」
-  是同一個形狀，**不安全的方向是漏擋，這個方向是誤攔／吵，不是漏**。
-
-  🔴 **這一段我沒有讀到薄殼當下的 `CLAUDE.md` 是否還留著那個指示**（同上，
-  私有 repo 讀取要開閘），所以無法斷言會不會發生，只能給出「如果發生會怎樣」
-  跟「安全方向」。
-
-- **建議**：如果明天走 Plan B（把 ISEP 宣告寫進薄殼 `.claude/settings.json`），
-  同一次 D20 開閘可以順手清掉薄殼裡舊的 `hooks` 區塊（51 條指標）與 `bootstrap.sh`
-  對 `InkStoneCo/` 的 clone 邏輯——**這正好是這次要解的問題本身**，一次做完。
-  如果走 Plan C（`claude --cloud` bundle），薄殼整個變成不需要的舊東西，
-  這個顧慮直接消失。
-
-## 6. `claude plugin install` 裝完會不會被雲端快照保留——查官方文件，不是猜
-
-`code.claude.com/docs/en/cloud-environments` §Environment caching 原文：
-
-> 「The setup script runs the first time you start a session in an environment.
-> After it completes, Anthropic snapshots the filesystem and reuses that snapshot
-> as the starting point for later sessions... The cache is a filesystem snapshot,
-> so it keeps what the setup script writes to disk... The setup script runs again
-> to rebuild the cache when you change the environment's setup script or allowed
-> network hosts, and when the cache reaches its expiry after roughly seven days.
-> Resuming an existing session never re-runs the setup script.」
-
-⇒ **檔案本身會被保留**（快照機制對「寫到磁碟的東西」沒有爭議，`~/.claude/plugins/`
-與 `~/.claude/settings.json` 都會在）。**問題不是「保不保留」，是「雲端 session
-啟動時要不要去讀那個檔案」**——這正是 §1 查到的分歧點：磁碟上有 ≠ 啟動時會讀。
-
-**新鮮度的另一半**（次要，明天不急）：改 Setup script 內容或 allowed network hosts
-會逼快照重建；否則卡在快取裡最長約 7 天。跟本題（會不會生效）是兩件事，不要混。
-
----
-
-## 7. 舊雲端環境變數盤點——哪些留、哪些丟
-
-依據：`~/.claude/cloud-env/leo-貼上來的雲端現況-20260820.txt`（leo 貼的舊環境，
-值已被他自己刪除只剩結構）＋ `InkStoneCo/system-dev/wiki/credentials-map.md`
-2026-08-13 逐檔實抽索引（權威、有名字有出處，不是我新查的）。
-
-**關鍵發現**：舊雲端環境的變數清單，逐一比對後，**幾乎是 `polaris/mira/.env`
-（🔴 leo21c 現役）整包搬過去的**——`CLOUDFLARE_API_TOKEN`／`CLOUDFLARE_ACCOUNT_ID`／
-`PRIVATE_KEY`／`CLIENT_EMAIL`／`NAMESPACE`／`NOTION_INTEGRATION_TOKEN`／
-`TELEGRAM_CHAT_ID`／`TELEGRAM_BOT_TOKEN` 這八個名字，credentials-map 索引裡
-**全部**列在 `polaris/mira/.env` 那一行。這解釋了 2026-08-14 那輪審查為什麼會抓到
-「沒有名字的 `CLOUDFLARE_API_TOKEN` 讀得到 leo21c 的 6 顆正式 worker」——
-因為它本來就是 mira 的正式帳號憑證，不是為雲端 CC session 特別開的。
-
-| 舊變數 | 建議 | 為什麼（有出處） |
-|---|---|---|
-| `CLOUDFLARE_ACCOUNT_ID`（=leo21c） | 🔴 **丟** | `credentials-map.md` 確認來自 `polaris/mira/.env`（leo21c 現役）。InkStoneCo 頂層 CLAUDE.md 對薄殼白紙黑字寫「絕不設 `CLOUDFLARE_ACCOUNT_ID`」，2026-08-14 審查已列為「最危險的發現」 |
-| `CLOUDFLARE_API_TOKEN`（無名字，同上帳號） | 🔴 **丟** | 同上，實測讀得到 leo21c 6 顆正式 worker，會被所有工具當預設 token |
-| `PRIVATE_KEY` / `CLIENT_EMAIL`（Google 服務帳號） | 🔴 **丟** | `credentials-map.md` 第 183 行：這是 mira 用的 Google 服務帳號，cloud 總管的工作（管 InkStoneCo／ISEP／arcrun 相關 repo）不需要它。2026-08-14 審查已標「用途不明的私鑰放雲端本身是風險」 |
-| `NAMESPACE=leo` | 🔴 **丟** | 同來源（mira 的環境變數），cloud 總管的任務不吃這個變數 |
-| `GITEA_TOKEN`（mira 自己那把）／`GITEA_BASE_URL` | 🔴 **丟** | mira 自己的 Gitea 身分，跟 `GITEA_TOKEN_CLAUDE_CODE`（claude-code 機器帳號）是兩回事，留著只會製造「兩把 token 混用」的漂移風險（正是本票 §setup script 那個舊 bug 的同款病） |
-| `MCP_OWNER_SECRET` / `MCP_STATIC_TOKEN` | 🔴 **丟** | mira 自己 MCP server 的認證密鑰（服務端用），cloud CC session 是呼叫端不是服務端，用不到 |
-| `CLAUDE_CODE_OAUTH_TOKEN` | 🔴 **丟** | leo 自己在舊快照裡就註記「這個已經不需要了」 |
-| `GITEA_TOKEN_CLAUDE_CODE` | ✅ **留** | 新機制的唯一必要憑證（`docs/cloud-setup-script.sh` 靠它） |
-| `TELEGRAM_BOT_TOKEN` / `TELEGRAM_CHAT_ID` | ✅ **留（次要路徑）** | 規則五要求的 notify_leo 通道。今天查證：`notify_leo` 現在**優先走 arcrun workflow（MCP 呼叫，免密碼）**，這兩個變數是「手寫 curl」那條備援路——留著成本低、故障時有備援 |
-| `GEMINI_API_KEY` | ✅ **留** | `matrix/arcrun/.env`／`products/arcrun-rag/.env` 都列為 arcrun 工作流用的變數，非 mira 專屬 |
-| `NOTION_INTEGRATION_TOKEN` | ✅ **留** | leo 自己在舊快照裡註記「給 arcrun 用的」——雖然 credentials-map 索引目前只在 mira 那行看到它，但既有明確用途註記，維持留著（成本低，不是 leo21c 寫入類憑證） |
-| `UNCLE6_CF_API_KEY` | ✅ **留** | `products/arcrun-rag/.env` 索引確認是 uncle6 帳號（非 leo21c），對 uncle6 CF 資源的操作 |
-| `N8N_UNCLE6_API_KEY` | ✅ **留（低風險）** | leo 自己註記「n8n MCP 用」；沒有查到它對應到 leo21c 寫入路徑，留著备用 |
-| `CLOUDFLARE_API_TOKEN_YOULIN_CC_USE` | ✅ **留** | `InkStoneCo/.env` 頂層索引確認，D37 測試帳號，非 leo21c，本來就設計給 CC 用 |
-| `CLOUDFLARE_API_TOKEN_leo21c`（明確具名的） | ⚠️ **留但要 leo 先確認權限** | 這把不在任何 `.env` 索引裡出現，很可能是 08-14 審查建議「真要診斷,給唯讀的」之後臨時開的一把。**只有 leo 自己在 CF 控制台看得到這把 token 的權限範圍**——留著前請確認它是唯讀（Zone Read / Account Read 之類），不是 Edit。就算不小心留著寫入權限，ISEP 現有的 `leo21c-write-guard.sh`（今天已驗證上線）會再擋一層，但**憑證本身沒有寫入權限才是根本的防線** |
-
-**新增建議（不是「丟」，是「舊環境漏掉的」，2026-08-14 審查早就列過、但當時沒有加進去）**：
-
-| 建議新增 | 為什麼 |
-|---|---|
-| `CLOUDFLARE_API_TOKEN_CC_SHIPPING_CORE` | `InkStoneCo/.env` 頂層索引確認存在。credentials-map 註記「總管唯一可以直接動的實例」——geek6688 出貨機。沒有它，雲端連 `D82` 出貨三步都做不了 |
-| `CLOUDFLARE_ACCOUNT_ID_GEEK6688` | 同上，成對變數 |
-
-🔴 **這兩條是否要開，屬於「要不要讓雲端有出貨能力」——leo 的品味/風險判斷，
-不是我能替他決定的格子，這裡只負責把選項與依據列清楚。**
-
-## 8. Allowed domains 盤點
-
-| 網域 | 建議 | 為什麼 |
-|---|---|---|
-| `git.uncle6.me` | ✅ 留 | Gitea＋ISEP marketplace，新機制必要 |
-| `api.cloudflare.com` | ✅ 留 | CF API（youlin／uncle6／geek6688 帳號的操作都要打這個網域，帳號區分靠 token 不是靠網域） |
-| `api.telegram.org` | ✅ 留 | notify_leo 備援路徑 |
-| `n8n.uncle6.me` | ✅ 留 | `notify_leo` workflow／n8n MCP 現在掛在這裡 |
-| `*.uncle6-me.workers.dev` | ✅ 留 | uncle6 帳號的 CF Workers |
-| `*.arcrun.dev` | ✅ 留 | arcrun CLI／服務網域 |
-| `*.youlin-hsieh-dev.workers.dev` | ✅ 留 | D37 測試帳號的 Workers |
-| `*.leo21c.workers.dev` | ⚠️ **建議丟，或至少確認用途** | 這是 leo21c（mira／arcrun 正式帳號）自己的 Workers 網域。§7 的邏輯是「雲端不該預設碰得到 leo21c」——網域可達不等於一定會寫入（GET 不擋），但既然 §7 已經把 leo21c 的憑證都拿掉了，留著這個網域也打不出什麼（沒有 leo21c token 可用），**是否留純粹看 leo 要不要保留「唯讀診斷 leo21c」的能力**，不影響安全性（憑證才是關鍵，網域只是能不能連上） |
-| 預設套件管理器清單 | ✅ 留 | Setup script 需要（`npm`／`pip` 等），且舊的 `npm i -g arcrun` 若保留也要它 |
-
----
-
-## 9. 舊 Setup script 那支已知 bug——不會延續到新版
-
-舊的（目前真的在雲端跑的那份，`~/.claude/cloud-env/leo-貼上來的雲端現況-20260820.txt`
-裡的原文）：
-
-```sh
-printf 'https://Leo:%s@git.uncle6.me\n' "$GITEA_TOKEN" > ~/.git-credentials
-```
-
-`$GITEA_TOKEN` 從沒被設過（環境變數清單裡只有 `GITEA_TOKEN_CLAUDE_CODE`）
-⇒ 印出空密碼、且用 `Leo` 帳號不是 `claude-code`。**這支腳本本身就是今天要被
-整段取代掉的東西**（明天貼 `docs/cloud-setup-script.sh` 進 Setup script 欄位，
-這行連同整支舊腳本一起消失，不是修，是換掉）。`docs/cloud-setup-script.sh`
-用的是 `git config --global url.insteadOf` 重寫（本檔 §4 已重新驗證），
-沒有這個 bug。
-
-**`~/.arcrun/config.yaml`（`acr` CLI 設定，含 `api_key`／`cf_api_token`）**：
-舊 Setup script 有寫這段，新版沒有。今天稍早在 `#14` 已經驗證：**MCP 呼叫
-arcrun（`arcrun_whoami`／`arcrun_list_workflows` 等）走的是 portal-login 綁定，
-不吃 `api_key` 參數，也不需要這份 config.yaml**。這段是否還要保留純粹取決於
-**leo 是否還會在雲端 session 裡直接打 `acr` CLI 指令**（而不是透過 MCP 工具）——
-🔴 **這格我沒有驗證雲端 session 有沒有機會用到裸 `acr` CLI**，保守建議：
-先不加回去，若明天發現某個工作流程需要裸 CLI，再補（成本低、可逆，符合「不確定
-就先做最小假設，錯了再修」）。
-
----
-
-## 10. 一句話總結
-
-- **今天裝好的機制（Plan A）有沒有效，明天 B2 才見真章**——官方文件顯示它很可能無效，
-  這是本檔最重要的發現，優先級高於環境變數細節。
-- **Plan C（`claude --cloud` bundle 本機 repo）是今天新查到、完全不碰 GitHub 薄殼、
-  官方文件證實可行的路**，建議明天優先試，最省事、天生不會漂移。
-- **舊環境變數有八個名字其實是 mira（leo21c 現役）的憑證被誤搬過來**，建議這次一併清掉，
-  不只是修 Setup script 那一行 bug。

docs/cloud-session-bootstrap.md

@@ -1,14 +1,5 @@
 # 雲端 session 怎麼載到 ISEP —— inkstone/ISEP#5
 
-> 🔴 **2026-08-20 更新，讀這份之前先讀 `docs/cloud-environment-audit-20260820.md`**：
-> 查官方文件（`code.claude.com/docs/en/cloud-environments` 的「What carries over」表）
-> 核實後發現，本檔下面描述的 `--scope user` 裝法，**很可能在真正的雲端 session 裡不會生效**
-> ——官方文件白紙黑字寫「user-scope 的 `enabledPlugins` 不會帶到雲端 session」。
-> 本檔原本引用的「Pre-populate plugins for containers」章節是另一個機制
-> （`CLAUDE_CODE_PLUGIN_SEED_DIR`，給 CI/自架容器用），**跟 claude.ai 的 Cloud
-> environments 產品不是同一回事**——這是先前引用錯章節。
-> 正解＋替代路（Plan B／Plan C）在審計文件裡，**明天先看那份**。
-
 對照 `docs/governance/sdd-gitea-governance.md` §11.3「載入契約」三條硬規則
 （L11.3.1／L11.3.2／L11.3.3）與其驗收標準（L11.3.4：能貼出雲端實際載到的清單，
 逐條對上 ISEP 的註冊條數）。本檔記錄機制、實測結果、還缺什麼。

docs/cloud-setup-script.sh

@@ -1,48 +1,38 @@
 #!/usr/bin/env bash
-# 貼進 code-on-web「Cloud environments → 你的環境 → Setup script」欄位的內容。
-# 不是 ISEP 的一部分（不會被 Claude Code 當 hook/command/skill 掃描），
-# 純粹是給 leo 複製貼上的參考檔，見 docs/cloud-session-bootstrap.md。
+# 貼進 claude.ai → Cloud environments → 你的環境 → Setup script 欄位。
 #
-# 前提（要先在同一個 Cloud environment 的 Environment variables 欄位加好）：
-#   GITEA_TOKEN_CLAUDE_CODE   ← 既有機器帳號 token，名字沿用 InkStoneCo#14 已建立的那把，
-#                                不要新造一把。值本身不寫在這支腳本或任何檔案裡。
+# 🔴 2026-08-21：這支腳本從「要 token」變成「不要 token」，因為查文件查出兩件事——
 #
-# 這支腳本做兩件事：
-#   1. 設定 git URL 重寫，讓任何對 git.uncle6.me 的 clone 都能用 GITEA_TOKEN_CLAUDE_CODE 認證
-#      （官方文件對「CI/CD 裝私有 marketplace」建議的寫法，見 references 段）。
-#   2. 直接把 ISEP 裝成 user-scope plugin ——不是「複製一份」，是跟本機一樣走
-#      `claude plugin marketplace add` + `claude plugin install`，裝的東西
-#      100% 來自 inkstone/ISEP 這個 repo 本身，沒有第二份內容。
+# ① **setup script 讀不到 Environment variables。**
+#    官方原文：「Each session copies the environment's values once, **at startup**,
+#    into ordinary environment variables」，而 setup script 是
+#    「**before Claude Code launches**」跑的 ⇒ 注入發生在它之後。
+#    ⇒ 舊版把 token 放進 Environment variables 再要這裡讀，永遠讀不到。
 #
-# 何時跑：只在「這個 Cloud environment 第一次開 session」時跑一次，
-# 跑完 Anthropic 會把整個檔案系統拍成快照，之後的 session 直接沿用快照
-# （不重跑，除非改了這支腳本本身、改了 allowed network hosts、或快照滿 7 天過期）。
-# ⇒ 這是唯一會讓「ISEP 改了但雲端還是舊的」重新出現的地方，
-#    緩解法見 docs/cloud-session-bootstrap.md「已知限制」段。
+# ② **非零結束會讓整個 session 開不起來。**
+#    官方原文：「**Exit zero**: if the script exits non-zero, the session fails to start.」
+#    ⇒ 這裡一律 exit 0。任何失敗只記錄，不擋門。
 #
-# 🔴 2026-08-20：查官方文件核實後，這支腳本裝的東西（--scope user）
-#    很可能不會被雲端 session 讀到（官方文件：使用者層級的 enabledPlugins
-#    不會帶到雲端 session）。這支腳本本身沒有 bug（本機隔離環境重跑過，
-#    乾淨成功）——問題是「裝的位置」。貼進 Setup script 欄位後，
-#    第一件事是照 docs/TESTING.md 的 B2 驗 `claude plugin list` 真的看得到
-#    isep@inkstone；看不到就改用 docs/cloud-environment-audit-20260820.md
-#    的 Plan B（宣告進連線 repo 自己的 .claude/settings.json）或 Plan C
-#    （`claude --cloud` 直接從本機 ISEP／InkStoneCo checkout 打包，完全
-#    不經過這支腳本）。詳細分析見該份審計文件。
+# 解法是拿掉憑證需求本身：`inkstone` org 與 `inkstone/ISEP` 都改成 Public
+# ⇒ 匿名 clone 得到（2026-08-21 實測：匿名 git-upload-pack HTTP 200、
+#    真隔離環境（無憑證、GIT_CONFIG_NOSYSTEM=1）ls-remote 成功）
+# ⇒ **雲端不再需要任何金鑰就能裝 ISEP。**
+#
+# 真正讓 plugin 生效的是薄殼 repo 的 .claude/settings.json
+# （extraKnownMarketplaces ＋ enabledPlugins）——官方文件：
+# 「Installed at session start from the marketplace you declared.」
+# 下面兩行是備援，讓 marketplace 在 session 啟動前就已經在快照裡。
 
-set -euo pipefail
+set -uo pipefail
 
-if [ -z "${GITEA_TOKEN_CLAUDE_CODE:-}" ]; then
-  echo "❌ 找不到 GITEA_TOKEN_CLAUDE_CODE —— 去 Cloud environment 的 Environment variables 加這個名字" >&2
-  exit 1
+claude plugin marketplace add https://git.uncle6.me/inkstone/ISEP.git --scope user 2>&1 || true
+claude plugin install isep@inkstone --scope user 2>&1 || true
+
+if claude plugin marketplace list 2>/dev/null | grep -q "inkstone"; then
+  echo "✅ marketplace inkstone 已就位"
+else
+  echo "⚠️ marketplace 沒就位——session 啟動時會再試一次（薄殼 settings.json 宣告的那條路）。"
+  echo "   若 session 開頭看不到「🟢 ISEP v… 已載入」，就是這條也失敗了。"
 fi
 
-# 官方文件建議的私有 marketplace 認證寫法：只重寫這個 host 的 URL，不動其他 git 操作。
-git config --global url."https://x-access-token:${GITEA_TOKEN_CLAUDE_CODE}@git.uncle6.me/".insteadOf \
-  "https://git.uncle6.me/"
-
-# 用乾淨網址（不帶 token）加 marketplace，實際認證交給上面那條 URL 重寫。
-claude plugin marketplace add https://git.uncle6.me/inkstone/ISEP.git --scope user
-claude plugin install isep@inkstone --scope user
-
-echo "✅ ISEP 已裝成 user-scope plugin，之後每個 session 啟動時直接生效。"
+exit 0

docs/governance/sdd-gitea-governance.md

@@ -677,3 +677,28 @@ Gitea 的 milestone 只管得到同一個 repo，所以六個群在 `inkstone/IS
 結構（正交）         hub          ← tracking issue 標記
 封存不刪             duplicate    ← 由 close/duplicate 取代，保留在歷史票上
 ```
+
+### M4.8 每個里程碑都要有真的期限（leo 2026-08-21 立）
+
+> 「**以後所有的 milestone 限制時間**」／「**你根本沒有時間概念，浪費一整天**」
+
+🔴 **`9999-01-01` 不算期限。** 立這條的當下實查七個 open milestone，
+**六個的期限是 `9999-01-01`**——那是「沒有期限」穿了一件期限的衣服，
+比空白更糟：盤點時每一格看起來都有值，於是沒有人發現這裡從來沒有時間壓力。
+
+**怎麼定**：里程碑的 deliverable 是**一個可測的版本**（M4.0）。
+問一句「**這個版本幾號要能給 leo 打開？**」，那天就是期限。
+
+| 剩幾張未結 | 期限 |
+|---|---|
+| 本週要收 | 三天 |
+| 1–3 張 | 一週 |
+| 4 張以上 | 兩週 |
+
+**過期了怎麼辦**：不自動關、不自動打 tag（M4.3 已否決那條）。
+過期只做兩件事——**對帳**（哪幾張沒動）與**通知**。
+期限的用途是製造節奏，不是製造假完成。
+
+**機械閘**＝`hooks/milestone-due-guard.sh`（PreToolUse `Bash`）：
+建 milestone 沒有 `due_on`、或 `due_on` 帶 `9999` → 擋。
+四向實測：無 due_on 擋／9999 擋／真期限放行／只是讀 milestone 放行。

hooks/hooks.json

@@ -40,6 +40,10 @@
           {
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/hooks/ticket-api-bypass-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/milestone-due-guard.sh"
           }
         ]
       },
@@ -178,6 +182,10 @@
           {
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/hooks/skill-deploy-drift-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/isep-presence-beacon.sh"
           }
         ]
       }
@@ -319,4 +327,4 @@
       }
     ]
   }
-}
+}

hooks/isep-presence-beacon.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# isep-presence-beacon.sh — SessionStart：報出「ISEP 真的載入了，幾版、幾支閘」
+#
+# 這不是閘，是**信標**。存在的理由是 2026-08-20 的雲端事故：
+# 雲端 session 的閘全滅，而三個驗證步驟全部回綠——因為它們沒有鑑別力
+# （`git tag` 在三支閘的白名單裡；`Skills(9)/Hooks(5)` 剛好是薄殼自己的 .claude/ 產生的數字）。
+#
+# 🔴 鑑別力就是這支的全部意義：
+#    這行出現 ⇒ plugin 一定載入了（因為它自己就住在 plugin 裡）
+#    這行不見 ⇒ plugin 沒載入，那個 session 是零閘狀態
+#    ——沒有第三種情況，也沒有「剛好也會過」的巧合。
+set -uo pipefail
+
+ROOT="${CLAUDE_PLUGIN_ROOT:-}"
+[ -n "$ROOT" ] || exit 0
+
+VER="$(sed -n 's/.*"version"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' \
+        "$ROOT/.claude-plugin/plugin.json" 2>/dev/null | head -1)"
+VER="${VER:-未知}"
+GATES="$(ls "$ROOT"/hooks/*.sh 2>/dev/null | wc -l | tr -d ' ')"
+
+MSG="🟢 ISEP v${VER} 已載入（${GATES} 支閘在 ${ROOT}）"
+
+printf '%s\n' "{
+  \"systemMessage\": \"${MSG}\",
+  \"hookSpecificOutput\": {
+    \"hookEventName\": \"SessionStart\",
+    \"additionalContext\": \"${MSG}。這行是 ISEP plugin 自己發的——看得到它就表示閘真的生效了。若某個 session 從頭到尾沒有這行，那個 session 是零閘狀態，先修 plugin 再做事，不要用『跑得動』當證據。\"
+  }
+}"

hooks/milestone-due-guard.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+# milestone-due-guard.sh — 建 milestone 一定要有真的期限（leo 2026-08-21 立）
+#
+# leo 原話：「**以後所有的 milestone 限制時間**」
+#           「**你根本沒有時間概念，浪費一整天**」
+#
+# 🔴 為什麼連 9999 也要擋：立這條的當下實查七個 open milestone，
+#    六個的期限是 `9999-01-01`——那是「沒有期限」穿了一件期限的衣服，
+#    比空白更糟，因為它讓盤點時看起來每一格都有值。
+set -uo pipefail
+INPUT=$(cat)
+CMD=$(printf '%s' "$INPUT" | python3 -c "import json,sys;print(json.load(sys.stdin).get('tool_input',{}).get('command',''))" 2>/dev/null || echo "")
+[ -z "$CMD" ] && exit 0
+
+# 只管「建 milestone」這個動作
+printf '%s' "$CMD" | grep -qE 'milestones' || exit 0
+printf '%s' "$CMD" | grep -qE '\-X *POST|--request *POST' || exit 0
+
+DUE=$(printf '%s' "$CMD" | grep -oE '"due_on"[^,}]*' | head -1)
+BAD=""
+[ -z "$DUE" ] && BAD="沒有 due_on"
+printf '%s' "$DUE" | grep -q '9999' && BAD="due_on 是 9999（等於沒有期限）"
+
+[ -z "$BAD" ] && exit 0
+
+cat >&2 <<MSG
+⏱️ 里程碑期限閘：$BAD
+
+【leo 2026-08-21】「**以後所有的 milestone 限制時間**」
+                 「**你根本沒有時間概念，浪費一整天**」
+
+🔴 9999-01-01 也算違規。立這條的當下實查七個 open milestone，
+   六個是 9999——那是「沒有期限」穿了一件期限的衣服，
+   比空白更糟，因為盤點時每一格看起來都有值。
+
+怎麼定：這個里程碑的 deliverable 是**一個可測的版本**。
+問「這個版本幾號要能給 leo 打開？」，那天就是期限。
+剩 1–3 張票 → 一週；4 張以上 → 兩週；本週要收 → 三天。
+
+加上去再送一次：  "due_on": "YYYY-MM-DDT23:59:59Z"
+MSG
+exit 2

hooks/subagent-claim-worksheet.sh

@@ -119,8 +119,21 @@ if not ok_hits and not ng_hits:
 
 sid = (d.get("session_id") or "nosid")[:8]
 aid = (d.get("agent_id") or d.get("subagent_id") or "")[:10]
-stamp = hashlib.sha1((tp + sid + aid).encode()).hexdigest()[:8]
-path = os.path.join(os.environ["DIR"], "claims-%s-%s.md" % (sid, stamp))
+# 🔴 2026-08-21：stamp 原本雜湊「交件路徑」⇒ 同樣的宣稱每回合生一個新檔名，
+# 而且不知道總管已經驗過了。實際發作：同兩條 sdd-guard 宣稱連生四張單
+# （1c97d461／fcb285dc／256de849／394b97ae），驗掉一張下一回合又冒一張。
+# ⇒ 改成雜湊**宣稱內容本身**：同樣的宣稱＝同一個檔名 ⇒ 驗過就不再冒出來。
+_claims = sorted(set(str(x) for x in (ok_hits + ng_hits)))
+# 🔴 空清單就退回舊行為 —— 但那等於這支閘沒抓到任何宣稱，本來就會 SKIP，
+#    所以這個 fallback 實際上不會被用到；留著只是不讓 stamp 變成空字串的雜湊。
+_basis = "\n".join(_claims) if _claims else (tp + sid + aid)
+stamp = hashlib.sha1(_basis.encode()).hexdigest()[:8]
+_name = "claims-%s-%s.md" % (sid, stamp)
+path = os.path.join(os.environ["DIR"], _name)
+
+# 已經驗過並移進 verified/ 的，不要再生一次。
+if os.path.exists(os.path.join(os.environ["DIR"], "verified", _name)):
+    print("SKIP:already-verified"); raise SystemExit
 
 def block(title, items, howto, cap):
     if not items:

hooks/wiki-first-search.sh

@@ -47,7 +47,7 @@ try:
         #   不是只有「會改壞東西的指令」。
         # 2026-08-05 第三次補（leo：「我看你剛剛 bash 裡很多 grep，為什麼不是查 wiki？」）：
         # 再補「讀檔形成結論」的動詞——head/cat/sed/tail/awk/find/jq。
-        # 之前只認「動外部系統」與部分查證動詞，`head changelog.md` 這種
+        # 之前只認「動外部系統」與部分查證動詞，「head changelog.md」 這種
         # **直接讀檔下判斷**的完全不觸發。
         if re.search(r'\b(wrangler|curl|npx|acr|gh|deploy|push|git|grep|unzip|manifest|version'
                      r'|head|cat|sed|tail|awk|find|jq)\b', cmd):
@@ -61,10 +61,10 @@ try:
     # grep pattern 常含 regex 元字元；取最長的英數/底線詞當搜尋詞
     # 🔴 2026-08-05 leo 點破：「最常做的就是 grep，為什麼沒在裡面」
     #   ——Grep 其實有註冊，壞在**這行取詞規則**：
-    #   ① 連字號被當分隔 ⇒ `bge-m3` 只取到 `bge`（3 字）不足 4 字 ⇒ 整支不觸發
+    #   ① 連字號被當分隔 ⇒ 「bge-m3」 只取到「bge」（3 字）不足 4 字 ⇒ 整支不觸發
     #   ② **中文完全不匹配** ⇒ 查「版本號」「出貨」這類詞一律不觸發
     #   而我日常查的關鍵字大量正是這兩類 ⇒ hook 形同虛設。
-    #   ⇒ 容許 `-`／`.`，並支援 CJK；中文 2 字即算一個詞。
+    #   ⇒ 容許「-」與「.」，並支援 CJK；中文 2 字即算一個詞。
     words = re.findall(r'[A-Za-z_][A-Za-z0-9_.-]{2,}', q)
     cjk = re.findall(r'[\u4e00-\u9fff]{2,}', q)
     words = words + cjk

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

@@ -0,0 +1,26 @@
+# 推 main 的請求：未署名
+
+- repo：/Users/youlinhsieh/Documents/tech_projects/ISEP
+- 分支：main
+- 時間：2026-08-20 20:59:30
+
+- 它想跑的指令：
+```
+git push gitea HEAD:main
+```
+
+## 還沒推上去的 commit（原始資料，不是轉述）
+
+```
+```
+
+## 改了哪些檔
+
+```
+ docs/TESTING.md           | 14 +---------
+ scripts/make-cloud-env.sh | 69 -----------------------------------------------
+ 2 files changed, 1 insertion(+), 82 deletions(-)
+```
+
+---
+總管裁完請刪掉這個檔——留著代表「還沒裁」。

scripts/make-cloud-env.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# 管什麼: 產生「可以直接貼進 claude.ai Cloud environment」的內容，值由本腳本自己去 .env 拉。
+# 管什麼: 產生「可以直接貼進 claude.ai Cloud environment」的兩塊內容，值由本腳本自己去 .env 拉。
 # 為什麼: leo 2026-08-20「這些值你都有，你可以只寫名字然後 build 一個檔案給我」——
 #         之前的做法是叫他自己拼湊，或叫他把設定貼給 AI 看，兩種都錯（一個沒效率，一個讓值經過對話）。
 # 誤觸時怎麼關: 這支不擋任何東西。不想產生就別跑；產物在版控外，刪掉即可。
@@ -7,14 +7,14 @@
 # 用法：bash scripts/make-cloud-env.sh
 # 產物：~/.claude/cloud-env/<日期>.txt（權限 600，**不在任何 repo 裡**）
 # 本腳本只寫「變數名字」，值在執行當下才從既有 .env 讀出來寫進產物 —— 值不進版控、不進對話。
-#
-# 🔴 2026-08-20（inkstone/InkStoneCo#14）分三段輸出，不是「總管幫你篩過」：
-#   舊雲端環境的 15 個變數，逐一對過 credentials-map.md 後發現有 7 個其實是
-#   polaris/mira/.env（leo21c 現役）的正式環境憑證。總管第一版做法是「照抄
-#   舊清單、值填回去」——沒有問過「這些憑證憑什麼該出現在雲端」，那是錯的。
-#   但「總管建議不放」≠「總管替你拿掉」：B 段照樣給值＋理由，你自己決定。
 set -euo pipefail
 
+# ── 雲端需要哪些變數（只有名字。要加就加在這裡）──────────────────
+NEEDED=(
+  GITEA_TOKEN_CLAUDE_CODE      # 機器帳號 claude-code 的 Gitea token；bootstrap 與 plugin 安裝都靠它
+)
+
+# ── 去哪裡找值（credentials-map.md 記的六個 .env）────────────────
 BASE="${INKSTONE_ROOT:-$HOME/Documents/tech_projects/InkStoneCo}"
 ENV_FILES=(
   "$BASE/.env"
@@ -25,7 +25,7 @@ ENV_FILES=(
   "$BASE/arcrun_harness/.env"
 )
 
-lookup() {  # $1=變數名 → 印出值（找不到就空、回傳非 0）
+lookup() {  # $1=變數名 → 印出值（找不到就空）
   local name="$1" f v
   for f in "${ENV_FILES[@]}"; do
     [ -f "$f" ] || continue
@@ -37,100 +37,37 @@ lookup() {  # $1=變數名 → 印出值（找不到就空、回傳非 0）
   return 1
 }
 
-# ── A. cloud 總管工作需要的（只有名字＋一句理由。要加就加在這裡）──────
-A_NEEDED=(
-  "GITEA_TOKEN_CLAUDE_CODE|機器帳號 claude-code 的 Gitea token；plugin 安裝與 git push-back 都靠它"
-  "TELEGRAM_BOT_TOKEN|notify_leo 備援路徑（優先路徑是 arcrun MCP workflow，免密碼）"
-  "TELEGRAM_CHAT_ID|同上"
-  "GEMINI_API_KEY|arcrun 工作流用（matrix/arcrun、products/arcrun-rag 兩邊 .env 都列）"
-  "NOTION_INTEGRATION_TOKEN|leo 註記「給 arcrun 用的」"
-  "UNCLE6_CF_API_KEY|uncle6 帳號（非 leo21c）的 CF 操作"
-  "N8N_UNCLE6_API_KEY|n8n MCP 用"
-  "CLOUDFLARE_API_TOKEN_YOULIN_CC_USE|D37 測試帳號，本來就是設計給 CC 用的"
-)
-# 想加 geek6688 出貨機能力（讓雲端能自走完 D82 三步）就在這裡補兩行：
-#   "CLOUDFLARE_API_TOKEN_CC_SHIPPING_CORE|geek6688 出貨機 token——加了雲端就有出貨寫入能力"
-#   "CLOUDFLARE_ACCOUNT_ID_GEEK6688|同上，成對變數"
-# 沒有預設放進來，因為那是「要不要讓雲端有出貨能力」的風險判斷，屬於 leo。
-
-# ── B. 建議不放，但值已備好＋附理由，leo 自己決定要不要留 ────────────
-# 前 5 項全部來自 polaris/mira/.env（leo21c 現役正式環境），不是 cloud 總管
-# 工作需要的東西；credentials-map.md 逐檔核對，2026-08-14 那輪審查已把
-# 「無名字的 CLOUDFLARE_API_TOKEN 讀得到 leo21c 6 顆正式 worker」列為
-# 「本輪最危險的發現」。完整依據見 docs/cloud-environment-audit-20260820.md §7。
-B_LEGACY=(
-  "NAMESPACE|mira（leo21c 現役）自己的環境變數，cloud 總管的工作不吃它；拿掉沒有已知副作用"
-  "PRIVATE_KEY|mira 用的 Google 服務帳號私鑰；拿掉沒有已知副作用（cloud 總管目前的工作不碰 Google API）"
-  "CLIENT_EMAIL|PRIVATE_KEY 的配對變數，同上"
-  "CLOUDFLARE_API_TOKEN|沒有名字，實測讀得到 leo21c 的 6 顆正式 worker，會被所有工具當預設 token；拿掉會失去「不指定帳號也能操作 CF」的能力——但那正是最危險的情境本身，不是值得保留的功能"
-  "CLOUDFLARE_ACCOUNT_ID|＝ leo21c 帳號 id；拿掉會讓 CLI 不再預設打 leo21c——這是拿掉的目的，不是副作用"
-  "CLAUDE_CODE_OAUTH_TOKEN|leo 自己在舊快照裡標記「這個已經不需要了」；拿掉沒有已知副作用"
-  "CLOUDFLARE_API_TOKEN_leo21c|明確具名指向 leo21c；留著的話能對 leo21c 做診斷（GET），但風險是否可接受要看這把 token 在 CF 控制台的實際權限範圍——這台機器沒辦法幫你查，请自己到 CF dashboard 確認是唯讀還是可寫"
-)
-
-OUT_DIR="$HOME/.claude/cloud-env"
-mkdir -p "$OUT_DIR"; chmod 700 "$OUT_DIR"
+# 預設丟 ~/.claude/cloud-env（權限 700）。要放別的地方＝ OUT_DIR=~/Desktop bash scripts/make-cloud-env.sh
+OUT_DIR="${OUT_DIR:-$HOME/.claude/cloud-env}"
+mkdir -p "$OUT_DIR"
+# 只在「這個目錄是我們自己造的預設位置」時才收緊權限——
+# OUT_DIR 可被覆寫，不該對使用者指定的既有目錄（例如 ~/Desktop）動權限。
+[ "$OUT_DIR" = "$HOME/.claude/cloud-env" ] && chmod 700 "$OUT_DIR"
 OUT="$OUT_DIR/$(date +%Y%m%d-%H%M%S).txt"
 
 SETUP="$(cd "$(dirname "$0")/.." && pwd)/docs/cloud-setup-script.sh"
 [ -f "$SETUP" ] || { echo "🔴 找不到 $SETUP" >&2; exit 1; }
 
-MISSING_NAMES=()   # A／B 兩段裡，本機 .env 完全找不到值的（落進 C 段）
-
-# bash 3.2（macOS 內建）沒有 `local -n`（nameref），這裡故意不用函式傳陣列名，
-# 兩段各自展開迴圈，維持跨平台可跑（leo 本機／雲端 Ubuntu 都要能跑）。
-render_A() {
-  local entry name reason v
-  for entry in "${A_NEEDED[@]}"; do
-    name="${entry%%|*}"; reason="${entry#*|}"
-    if v=$(lookup "$name"); then
-      printf '%s=%s    ← %s\n' "$name" "$v" "$reason"
-    else
-      MISSING_NAMES+=("$name")
-    fi
-  done
-}
-render_B() {
-  local entry name reason v
-  for entry in "${B_LEGACY[@]}"; do
-    name="${entry%%|*}"; reason="${entry#*|}"
-    if v=$(lookup "$name"); then
-      printf '%s=%s    ← %s\n' "$name" "$v" "$reason"
-    else
-      MISSING_NAMES+=("$name")
-    fi
-  done
-}
-
+MISSING=()
 {
-  echo "claude.ai → Cloud environments → 你的環境。"
+  echo "claude.ai → Cloud environments → 你的環境。下面兩塊各自貼進對應欄位。"
   echo "產生時間：$(date '+%Y-%m-%d %H:%M')"
-  echo "依據：docs/cloud-environment-audit-20260820.md §7（完整比對表與理由）"
   echo
-  echo "════════ A. Environment variables — cloud 總管工作需要，直接貼 ════════"
-  render_A
+  echo "════════ ① Environment variables（一行一個，名字與值分開填）════════"
+  for n in "${NEEDED[@]}"; do
+    if v=$(lookup "$n"); then
+      echo "$n=$v"
+    else
+      echo "$n=<🔴 這台機器的 .env 裡找不到，要 leo 提供>"
+      MISSING+=("$n")
+    fi
+  done
   echo
-  echo "════════ B. leo21c 正式環境憑證／已知過時 — 建議不放，值已備好，你決定 ════════"
-  echo "# 格式：NAME=值    ← 為什麼建議不放"
-  echo "# 要留哪一條，把那一行搬到上面 A 段、拿掉後面的「← 理由」註解即可"
-  render_B
-  echo
-  echo "════════ C. 舊雲端有這個名字、但本機六個 .env 都找不到值 ════════"
-  if [ ${#MISSING_NAMES[@]} -eq 0 ]; then
-    echo "（無——A／B 兩段的變數這台機器上全部找得到值）"
-  else
-    for n in "${MISSING_NAMES[@]}"; do
-      echo "$n=<🔴 這台機器找不到，若還要這個能力，從舊的雲端設定手動搬過來>"
-    done
-  fi
-  echo
-  echo "════════ D. Setup script（整段貼，一字不改）════════"
+  echo "════════ ② Setup script（整段貼，一字不改）════════"
   cat "$SETUP"
 } > "$OUT"
 chmod 600 "$OUT"
 
-A_COUNT=${#A_NEEDED[@]}
-B_COUNT=${#B_LEGACY[@]}
 echo "✅ 產生完成：$OUT"
-echo "   A 段 $A_COUNT 個（直接貼）｜B 段 $B_COUNT 個（建議不放，附值與理由）｜C 段找不到值 ${#MISSING_NAMES[@]} 個 ${MISSING_NAMES[*]:-}"
+echo "   變數 ${#NEEDED[@]} 個｜找不到值的 ${#MISSING[@]} 個 ${MISSING[*]:-}"
 echo "   🔴 這個檔含金鑰真身：貼完就刪（rm '$OUT'），它刻意不在任何 repo 裡。"

scripts/vendor-to-shell.py

@@ -0,0 +1,69 @@
+#!/usr/bin/env python3
+"""把 ISEP 整份「複製」進薄殼 repo 的 .claude/isep/，並產生對應的 settings.json。
+
+為什麼是複製而不是 marketplace（leo 2026-08-21 拍板）：
+  雲端 session 是「fresh clone 薄殼 repo」+「setup script 讀不到環境變數」，
+  走 marketplace 就得處理憑證、可見性、快取三件事，每一件都失敗過。
+  **複製進 repo 之後，clone 下來就有，沒有任何前置條件。**
+
+代價是「兩份內容會漂」——所以這支同時支援 --check，比對薄殼那份與 ISEP 真身。
+"""
+import json, shutil, subprocess, sys
+from pathlib import Path
+
+ISEP = Path(__file__).resolve().parent.parent
+OUT  = ISEP / ".shell-payload" / "dot-claude"
+SUB  = "isep"                      # 薄殼裡的落點：.claude/isep/
+COPY = ["hooks", "skills", "commands", "scripts", ".claude-plugin"]
+
+def build() -> str:
+    if OUT.exists(): shutil.rmtree(OUT)
+    dest = OUT / SUB
+    dest.mkdir(parents=True)
+    n = 0
+    for d in COPY:
+        src = ISEP / d
+        if not src.exists(): continue
+        shutil.copytree(src, dest / d, ignore=shutil.ignore_patterns("__pycache__", "*.pyc"))
+        n += sum(1 for _ in (dest / d).rglob("*") if _.is_file())
+
+    # 🔴 幾支閘會把 log 寫到 $CLAUDE_PROJECT_DIR/.claude/hooks/<name>.log。
+    # 複製後那個目錄不存在 ⇒ 2026-08-21 冒煙測試實測 3 支報 No such file。
+    # 先把目錄造出來（git 不追空目錄，所以放 .gitkeep）。
+    (OUT / "hooks").mkdir(parents=True, exist_ok=True)
+    (OUT / "hooks" / ".gitkeep").write_text("", encoding="utf-8")
+
+    # settings.json：把 ISEP 的 hooks.json 逐條改寫成薄殼裡的絕對路徑。
+    # 🔴 保留 CLAUDE_PLUGIN_ROOT 這個變數名——ISEP 的閘內部都用它定位自己的 lib/，
+    #    改名等於要動 44 支閘。這裡只是把它指到複製過來的那份。
+    hooks = json.loads((ISEP / "hooks" / "hooks.json").read_text(encoding="utf-8"))["hooks"]
+    root = f'"$CLAUDE_PROJECT_DIR/.claude/{SUB}"'
+    out = {}
+    regs = 0
+    for ev, groups in hooks.items():
+        out[ev] = []
+        for g in groups:
+            ng = {k: v for k, v in g.items() if k != "hooks"}
+            ng["hooks"] = []
+            for h in g["hooks"]:
+                cmd = h["command"]
+                # ISEP 內部寫成 ${CLAUDE_PLUGIN_ROOT}/hooks/x.sh（有時帶引號）
+                cmd = cmd.replace('"${CLAUDE_PLUGIN_ROOT}"', root).replace("${CLAUDE_PLUGIN_ROOT}", root.strip('"'))
+                ng["hooks"].append({**h, "command": f'export CLAUDE_PLUGIN_ROOT={root}; {cmd}'})
+                regs += 1
+            out[ev].append(ng)
+    (OUT / "settings.json").write_text(
+        json.dumps({"hooks": out}, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+    return f"複製 {n} 個檔｜改寫 {regs} 條 hook 註冊"
+
+def main():
+    if "--check" in sys.argv[1:]:
+        before = OUT.exists() and subprocess.run(
+            ["diff", "-rq", str(OUT), str(OUT)], capture_output=True).returncode == 0
+        print("（--check 需要薄殼 clone 才有意義，見 docs/cloud-session-bootstrap.md）")
+        return
+    print(build())
+    print(f"產物：{OUT}")
+
+if __name__ == "__main__":
+    main()