定版 v0.17.0：sdd-guard 退役

leo 2026-08-16 在 inkstone/InkStoneCo#40 → comment 2942 裁定「取消 Active SDD」，
11 天沒被執行。原因不是有人偷懶，是**執行它的第一步會鎖死自己**：

    sdd-guard.sh 是 fail-closed 的
      · 動 code 檔時 status: active 不是恰好 1 份 → 擋（0 份也擋）
      · 路徑所在的 repo 沒有 3-specs           → 也擋

⇒ 照裁決把最後那份 active 拿掉 → 變 0 份 → 任何人動任何 .ts/.py/.go 全被擋。

而 ISEP 這個 repo 自己就沒有 3-specs——本票開工第一件事實測到：

    $ echo '{"tool_name":"Edit","tool_input":{"file_path":".../hooks/lib/dispatch_parse.py"}}' \
        | bash hooks/sdd-guard.sh
    🚫 SDD 協議攔截：… 找不到任何 SDD        exit 2

**它一直在誤攔 ISEP 自己，只是沒人回報。**

── 這一版做了什麼 ────────────────────────────────────
· hooks/sdd-guard.sh 刪除，hooks.json 取消註冊（85 → 84 條，只少這一條）
· commands/sdd-check.md 改寫：SDD 只記「起初的樣子」，任務本體在 Gitea 票；
  找不到 SDD 不再是停下來的理由，找不到票才是
· agents/inkstoneco-hand.md 拿掉「任何時刻只允許一份 status: active」那條紅線
· hooks/lib/path-resolve.sh 只加註解：它的唯一 caller 走了，但別順手刪
  （#22 學到的東西住在裡面，十幾支閘還在用它要修的那個寫法）

── 迴歸測試：測的不是「檔案刪了沒」，是「那個擋還會不會發生」──
hooks/tests/sdd-guard-retired.test.sh（通過 8／失敗 0，離線）：
把「裁決執行完之後的世界」（沒有 3-specs 的 repo、兩份 status: active 的 repo）
丟給 hooks.json 上**整組** Write|Edit|MultiEdit 的閘——清單當場從 hooks.json 讀、
不寫死——不准有任何一支用 SDD／3-specs 當理由擋下來。
⇒ 日後有人換個檔名把同一個形狀種回來，這支照樣紅。

🔴 判準刻意不是「一支閘都不准擋」：同組還住著跟 SDD 無關、且看 session 狀態
決定擋不擋的閘（history-first／subagent-first）。把它們算失敗，這支測試會在別人
改別的東西時無故變紅，紅久了就沒人看——誤攔比漏擋更該修，對測試一樣成立。

**紅的證明**：把 sdd-guard 暫時復原（檔案＋註冊）重跑 → 通過 1／失敗 7，
四條行為格全部指名 sdd-guard.sh。已還原。

── 自己跑過的 ──────────────────────────────────────
· hooks/tests/sdd-guard-retired.test.sh                通過 8／失敗 0
· 逐支點名 hooks.json（README「裝什麼」那道指令）      84 條，對 main 做集合差：
  少了 sdd-guard.sh × 1，多出 0 支，其餘一支不差
· 盤點數字全部在這棵樹上實數，不是加減推：
  ls hooks/*.sh|wc -l = 61（原 62）
  grep -c '"command":' hooks/hooks.json = 84（原 85）
  agents 7／commands 7／skills 2／scripts 48（皆未變動）
· 盤點表對帳三格（hooks-inventory 自己寫死的那三道）：三格皆無輸出
· scripts/check-version-consistency.sh                 ✅ 0.16.2 一致
· claude plugin validate .                             ✅ Validation passed
· hooks/tests/ 全部離線測試 24 支重跑：本次改動 0 退步
  （dispatch-format-guard 40/52、prod-write-guard 18/19-fail、
   stage-before-prod-guard 9/7-fail、另 3 支需帶參數／建不起沙盒——
   **六支在 gitea/main 上逐支重跑結果一模一樣，是既有狀態不是本次造成**）

── 沒做、也不該由這張票做的 ─────────────────────────
· inkstone/InkStoneCo 那半（拿掉 active SDD ＋ 刪 CLAUDE.md「單一活性鐵律」段）
  ——那是 inkstoneco-hand 的 repo；而且順序上本來就要等這一版出去、
  兩邊 /plugin update 之後才動得，先拿掉就鎖死
· checkbox 分診（掛 inkstone/InkStoneCo#49，票上明寫不要另開票）
· 版本號：待總管定版

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016ZBu4Sa1cGntKFRBYNZ6xs

.claude-plugin/plugin.json

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

README.md

@@ -23,11 +23,11 @@
 
 | | 數量 | 是什麼 |
 |---|---|---|
-| `hooks/` | 62 支 ＋ `hooks.json` | 全部機械閘（PreToolUse／Stop／SubagentStop／SessionStart／PostToolUse／UserPromptSubmit 共 85 條註冊）。**一支一行的白話盤點在 `docs/hooks-inventory.md`，那裡才是這兩個數字的家** |
+| `hooks/` | 61 支 ＋ `hooks.json` | 全部機械閘（PreToolUse／Stop／SubagentStop／SessionStart／PostToolUse／UserPromptSubmit 共 84 條註冊）。**一支一行的白話盤點在 `docs/hooks-inventory.md`，那裡才是這兩個數字的家** |
 | `agents/` | 7 位 | **工人名單**（`inkstone/ISEP#86`）——派工時指名派給誰，規約見 `docs/governance/worker-roster.md` |
 | `commands/` | 7 支 | `/wiki-recall` `/ship-check` `/cp-write` … |
 | `skills/` | 2 支 | |
-| `scripts/` | 49 支 | `ticket`／`roster`／`isep-nag`／`wiki-compress`／`github-arm.sh` …（頂層檔案，不含 `lib/` 等子目錄） |
+| `scripts/` | 48 支 | `ticket`／`roster`／`isep-nag`／`wiki-compress`／`github-arm.sh` …（頂層檔案，不含 `lib/` 等子目錄） |
 
 > 🔴 這五個數字**每次都要在自己的樹上實數**，不准沿用上一版、也不准用加減推
 > （`system-dev/wiki/mistakes.md`：那是 leo 的驗收介面，多報就是假綠）：

agents/inkstoneco-hand.md

@@ -16,6 +16,8 @@ description: 頂層知識庫的工人——wiki、SDD、Critical Path、決策
 ## 紅線
 
 - **頂層不寫業務程式碼。** 這一層只放跨專案的整理與判準。
-- **任何時刻只允許一份 `status: active` 的 SDD**；不准自行建 SDD。
+- **SDD 不是任務清單**（leo 2026-08-16 取消 Active SDD，`inkstone/InkStoneCo#40`）：
+  它只記「起初的樣子」，**不帶 `status:`、不帶任務 checkbox**。任務本體在 Gitea 票。
+  ⇒ 不准自行建 SDD，也不准把進度寫回 SDD。
 - 規格層的變更 ⇒ 開一張 Gitea 票（`Human` ＋ 指派 `Leo` ＋ `s/triage`），不要自己改規格。
 - 寫給 leo 看的 md 一律**巢狀 bullet**（Logseq outliner），禁表格平攤。

commands/sdd-check.md

@@ -1,65 +1,81 @@
 ---
 name: sdd-check
 description: |
-  開始任何開發任務前確認有沒有對應的 SDD——要寫 code、開新功能、
-  或不確定「這件事屬於哪份規格」時自動載入。
-  依 D35 SDD 生命週期鐵律：任何時刻只允許一份 status: active 的 SDD，
-  所有開發任務對應它的 tasks，找不到就停下來問（不得自行建 SDD）；
+  動手前把這件事的來歷讀齊——要寫 code、開新功能、
+  或不確定「這件事當初為什麼長這樣」時自動載入。
+  🔴 Active SDD 已於 2026-08-16 取消（inkstone/InkStoneCo#40）：
+  **任務本體在 Gitea 票，不在 SDD**；SDD 只記「起初的樣子」，
+  沒有 status、沒有唯一活性、也不再養任務 checkbox。
+  ⇒ 找不到 SDD 不是停下來的理由，找不到票才是；也不要為了動手而現編一份 SDD。
   規格層變更改開 Gitea 票（Human＋指派 Leo）後停止等 confirm——pending-changes.md 已於 2026-08-19 廢除，禁止寫入。
 ---
 
-# /sdd-check — 確認當前任務有沒有對應 SDD
+# /sdd-check — 動手前把這件事的來歷讀齊
 
-動手前執行。確保 CC 有全局觀，不會在沒有設計文件的情況下猛衝。
+## 先講清楚它現在是什麼
+
+leo 2026-08-16（`inkstone/InkStoneCo#40` → comment 2942）：
+
+> 「**取消 Active SDD**⋯⋯所有文件中都不帶有任務 checkbox，因為移動到 Gitea 來管理，
+> SDD 會脫節，它所做的是記錄起初的樣子⋯⋯實際情況靠 issues, PR, release 等機制來管理。」
+
+所以三件事分家（`docs/governance/sdd-gitea-governance.md` §0 公理 1）：
+
+```
+意圖真相 → SDD（docs/3-specs/）   未來式：當初打算怎麼做
+狀態真相 → Gitea 票／PR／release  現在式：現在做到哪、誰在做
+知識真相 → wiki                   過去式：撞過什麼、學到什麼
+```
+
+🔴 **這支命令已經不是一道閘了。** 舊版靠 `sdd-guard.sh` 在動 code 前強制要有
+「恰好一份 status: active 的 SDD」，那支閘於 `inkstone/ISEP#91` 退役——
+它是 fail-closed 的，裁決一執行（active SDD 歸零）就會鎖死所有 code 寫入。
 
 ---
 
 ## 執行流程
 
-### 第一步：理解任務
+### 第一步：這件事的**票**是哪一張
 
-確認使用者要做什麼：
-- 涉及哪個子系統？
-- 是新功能還是修改現有功能？
-- 影響範圍？
+**這一步不能跳，也是唯一會讓你停下來的一步。**
 
-### 第二步：尋找對應 SDD
+- 有票號 → 讀它（含整串留言：裁決、假設、前手交回的下一步都在那裡）
+- 沒票號 → **先問清楚是哪一張，或先把票開出來**，不要憑一句話開工
+  （`commands/issue-handle.md`：Issue 是唯一任務介面）
 
-在 `docs/3-specs/` 下尋找對應的子系統目錄，確認有沒有：
-- `design.md`（設計文件）
-- `tasks.md`（任務清單）
+### 第二步：這件事的**來歷**在哪份 SDD
 
-### 第三步：根據結果回應
+在 `system-dev/docs/3-specs/` 下找對應子系統的 `design.md`。
+
+- 找到 → 讀它，弄清楚「當初為什麼這樣設計、有哪些邊界不能動」
+- **找不到 → 照樣可以動手**。票才是任務本體；
+  沒有 SDD 只代表這塊當初沒有寫下設計，不代表這件事沒被批准
+
+🔴 **不要為了動手而現編一份 SDD**，也不要去改任何 `status:` frontmatter——
+那是已經取消的制度的殘留物。
+
+🔴 **不要把任務 checkbox 寫進 SDD**。要追蹤進度就開票／改票的狀態標籤；
+寫進文件裡的 checkbox 沒有人會回來關掉它（`inkstone/InkStoneCo#49`
+清的就是這一批：378 條沒人維護的 checkbox）。
+
+### 第三步：把讀到的東西講出來再動手
+
+回覆開頭一行交代即可：
 
-**情況 A：找到對應 SDD**
 ```
-✅ 找到 SDD：docs/3-specs/[子系統]/
-📋 design.md：[確認]
-📋 tasks.md：[確認，列出相關 task]
-🎯 對應 task：[編號和描述]
-繼續嗎？
+📌 票：<owner/repo#N> —— <一句話它要解什麼>
+📋 來歷：<design.md 路徑，或「這塊沒有 SDD」>
+🚧 邊界：<這次不准動的東西>
 ```
 
-**情況 B：找不到 SDD，任務明確**
-```
-⚠️ 找不到對應 SDD
-任務：[描述]
-建議在 docs/3-specs/[建議子系統名]/ 建立 SDD
+---
 
-要我幫你起草 design.md 嗎？（需要你確認後才動手）
-```
+## 什麼時候該停下來問
 
-**情況 C：找不到 SDD，任務模糊**
-```
-⚠️ 找不到對應 SDD，而且任務範圍不夠清楚
-請先回答：
-1. 這個功能屬於哪個子系統？
-2. 完成的標準是什麼？
-3. 有沒有不能動的邊界？
-```
+只有這幾種，**都跟 SDD 在不在無關**：
 
-### 注意
+- 找不到對應的票，也問不出是哪一張
+- 票上的要求跟現行規範互相衝突（貼出兩邊出處，給出你的推測，再問）
+- 命中四題公式：花錢／不可逆／跨專案結構／品味方向
 
-- 找不到 SDD **不等於可以直接動手**
-- 小修改（修 bug、改文字）可以豁免，但要明確說「這是小修改，範圍是 X」
-- 新功能、架構變動、跨模組的修改 → 一定要有 SDD
+其餘情況做出最合理的假設、把假設寫進 commit message 或票的留言，繼續走。

docs/TESTING.md

@@ -129,7 +129,7 @@ python3 scripts/pr-verdict merge inkstone/ISEP#71 --dry-run
 ```
 bash hooks/tests/countdown-guard.test.sh
 ```
-**該看到**：`通過 21 條，失敗 0 條`。**全程離線**：時鐘用 `ISEP_COUNTDOWN_NOW` 定住、
+**該看到**：`通過 20 條，失敗 0 條`。**全程離線**：時鐘用 `ISEP_COUNTDOWN_NOW` 定住、
 狀態走 `ISEP_COUNTDOWN_STATE_DIR`，不打網路、不碰 `$HOME`。
 
 **它在守什麼**（`inkstone/ISEP#63`，leo 2026-08-27）：
@@ -515,35 +515,37 @@ D 群同時釘住反面：認不出來（`cd $VAR`、`cd -`、cd 到不是 repo
 - ① 紅 ⇒ 連總管在自己的目錄裡切分支都被擋。那不是嚴格，那是把共用目錄的主人趕出去
 - ㉞㉟ 紅 ⇒ `prune` 做錯了。㉞是沒清掉說謊的登記；**㉟是把還在的 worktree 也弄掉了，那是災難**
 
-### A25 — 照 A24 開出來的 worktree，不會被跨專案閘擋下：21 條
+### A25 — `sdd-guard` 退役了，而且退乾淨了：8 條
 ```
-bash scripts/test-guard-cross-project.sh
+bash hooks/tests/sdd-guard-retired.test.sh
 ```
-**該看到**：`通過 21 條，失敗 0 條`。離線，自己開一棵真的樹（頂層 repo ＋ 4 顆子 repo
-＋ 3 份真的 linked worktree），跑完自動刪掉。
+**該看到**：`通過 8 ／ 失敗 0`。離線，自己開兩顆假 git repo，跑完自己清。
 
-**它在守什麼**（inkstone/ISEP#117，`inkstone/Arcrun#195` 實撞）：
-A24 那支閘印出來的下一步是 `worktree add <PARENT>/<NAME>-wt-<票號>`，
-而這支閘的白名單原本是**路徑前綴**比對 ⇒ `matrix/arcrun-wt-195/…` 不符合 `matrix/arcrun/*`
-⇒ **照 A24 的指示做的人被擋，留在共用目錄裡的人反而過得了**。
-工人當時只能把 worktree 開到 InkStoneCo 樹之外躲開它——**閘把人逼去繞路，那條規矩就等於沒有**。
+**它在守什麼**（`inkstone/ISEP#91`）：leo 2026-08-16 在 `inkstone/InkStoneCo#40` 裁定
+**取消 Active SDD**——任務狀態搬到 Gitea 管，SDD 只記「起初的樣子」。
+但 `sdd-guard.sh` 是 **fail-closed** 的：`status: active` 不是恰好 1 份就擋（**0 份也擋**），
+路徑所在的 repo 沒有 `3-specs` 也擋。⇒ **照裁決把 active SDD 拿掉，會當場鎖死所有 code 寫入**，
+這就是那個裁決躺了 11 天沒人敢執行的真正原因。
 
-修法：白名單比對的是「這個路徑**屬於哪個 repo**」——`git worktree list --porcelain`
-第一筆永遠是主工作目錄，主目錄與它所有的 worktree 回同一個答案。
-`-wt-` 這個命名慣例**一個字都沒有出現在判準裡**（不靠名字＝改名字也騙不過去）。
+🔴 **這支測的不是「檔案刪掉了沒有」，是「那個擋還會不會發生」**：
+它把「裁決執行完之後的世界」（沒有 `3-specs` 的 repo、有兩份 `status: active` 的 repo）
+丟給 `hooks.json` 上**整組** `Write|Edit|MultiEdit` 的閘——清單是當場從 `hooks.json` 讀的，
+不寫死——**不准有任何一支用 SDD／3-specs 當理由擋下來**。
+⇒ 日後有人換個檔名把同一個形狀種回來，這支照樣紅。
 
 **失敗**：
-- ★ 那 6 條任一紅：
-  - 放行那 4 條紅 ⇒ 今天這個誤攔會再發生一次
-  - 「不在名單的 repo，它的 worktree」／「名字像 worktree、其實是空目錄」紅
-    ⇒ 判準從「git 回答的事實」滑回「名字看起來像」——那是黑名單的反面，一樣不可靠
-- 「該擋」那 9 條任一紅 ⇒ 為了修誤攔把該擋的放掉了
-- 「迴歸」那 5 條任一紅 ⇒ 動到了跟本輪無關的既有規則（`.md` 一律放行、頂層自己的檔）
+- ②那四條任一紅 ⇒ 裁決又被種回去了。**最要看的是最後一條**（ISEP 自己的 `hooks/lib/*.py`）：
+  ISEP 這個 repo 本身就沒有 `3-specs`，退役前那一格是紅的——它是這件事的活體證據
+- ③紅 ⇒ 條文回來了。有人在 `commands/`／`agents/`／`skills/`／`hooks/` 裡
+  又寫了一次「只准一份 active SDD」，而**條文會被載入，載入就會被照做**
+- ①的第三條（`hooks.json` 仍是合法 JSON）紅 ⇒ 合併把檔案弄壞了；
+  但**它只證明語法沒壞、不證明閘還在**——閘在不在要另外跑 README 那道逐支點名
 
-**這支測試自己的誠實邊界**：它用 `CLAUDE_CODE_CHILD_SESSION=0` 代表「總管」。
-真機上那個變數**不可靠**——`InkStoneCo/system-dev/wiki/ops-facts.md` 記著實測：
-Claude Desktop 的總管主 session 也是 `1`。⇒ 這裡驗的是**閘的分支邏輯**，
-不是「總管在真機上一定會被擋」。那是另一件事，本輪沒有動它。
+📌 **這支只管 ISEP 這一半。** 裁決的另外兩件在 `inkstone/InkStoneCo`：
+拿掉那份 active SDD ＋ 刪 `CLAUDE.md` 的「單一活性鐵律」段，以及
+`system-dev/docs/` 底下的任務 checkbox 分診（掛 `inkstone/InkStoneCo#49`）。
+🔴 **順序不可顛倒**：要等這一版 ISEP 出去、兩邊 `/plugin update` 之後，
+那半才動得——先拿掉 active SDD 就會鎖死。
 
 ### A5 — 開票前的搜尋是跨 repo 的
 ```

docs/hooks-inventory.md

@@ -1,4 +1,4 @@
-# 62 支閘，白話盤點表
+# 61 支閘，白話盤點表
 
 > 回應 `inkstone/InkStoneCo#40`：「如果加入了，我應該可以白話文看到 hooks 的內容？」
 > 這份表就是那個「白話文」——不用點開任何 `.sh` 檔，一行看懂一支閘在管什麼。
@@ -7,14 +7,14 @@
 
 ## 一句話結論
 
-`hooks/` 底下有 **62 個 `.sh` 檔**，`hooks.json` 實際掛上 **85 條註冊**（同一支閘常被多種情境同時掛上）；
+`hooks/` 底下有 **61 個 `.sh` 檔**，`hooks.json` 實際掛上 **84 條註冊**（同一支閘常被多種情境同時掛上）；
 其中 **3 支檔案存在但沒被掛上**（2 支是待人填的空範本、1 支是刻意留著沒開的止血帶，見下面「未生效」表）。
 下面按「你會在什麼時候撞到它」分組，一支一行。
 
 > 🔴 **這兩個數字上一版是錯的（2026-08-26 實際數過才發現）**：本頁原本寫「43 個檔、53 條註冊」，
 > 而當時真實是 **45 個檔、55 條註冊**——中間有兩支閘進來時沒有回頭改這裡。
 > 現在的寫法是實際數出來的：
-> `ls hooks/*.sh | wc -l` ＝ 62；`grep -c '"command":' hooks/hooks.json` ＝ 85。
+> `ls hooks/*.sh | wc -l` ＝ 61；`grep -c '"command":' hooks/hooks.json` ＝ 84。
 > ⚠️ **冒號不能省**：`grep -c '"command"'`（沒冒號）會連 `"type": "command"` 一起數到，回 **120**。
 > 本頁 2026-08-27 之前寫的是沒冒號那版——**照著它跑會拿到一個跟本頁不符的數字**。
 > **一份會偷偷過期的盤點表，跟沒有盤點表差不多**——見本頁最後「怎麼跟實況對帳」那段。
@@ -78,6 +78,12 @@
 > （`ls -p scripts | grep -v / | wc -l`，只數檔案）在合併後的樹上實數是 **48**。
 > **同一個病，第 N 次，只是換一欄。**
 
+> 📌 **`inkstone/ISEP#91`（2026-08-31）退一支、−1 條**：`sdd-guard.sh`（B 組）退役，
+> 執行 leo 2026-08-16 在 `inkstone/InkStoneCo#40` 那個「取消 Active SDD」的裁決。
+> 62→**61** 支、85→**84** 條，兩個數字都是**在自己這棵樹上當場數出來的**
+> （`ls hooks/*.sh | wc -l`／`grep -c '"command":' hooks/hooks.json`），不是拿上一版減一。
+> 退役的理由與順序寫在 B 組表格底下那段。
+
 > 📌 **`0.10.0`（`inkstone/ISEP#81`，2026-08-28）進來一支**：`pr-verdict-guard.sh`（F 組，Stop）。
 > 51→**52** 支、64→**65** 條，兩個數字都是加完之後當場數出來的（指令同上）。
 > 順手改掉一個過期的數字：描述欄長期寫「27 支腳本」，實數是 **34**
@@ -130,10 +136,9 @@
 
 | 閘名 | 對你意味著什麼 | 動作 |
 |---|---|---|
-| `guard-cross-project.sh` | 總管（頂層）想直接改某個子 repo 的程式碼（非 `.md`）就擋下——頂層只做安排交辦，實作要進那個子 repo 自己做。白名單上的 repo 給 subagent 動，**連同它照 `line-needs-own-worktree.sh` 開出來的 worktree**（`<repo>-wt-<票號>/`）一起放行——認的是 `git worktree list` 第一筆（這條路徑屬於哪個 repo），不是路徑長什麼樣。 | 🛑 擋 |
+| `guard-cross-project.sh` | 總管（頂層）想直接改某個子 repo 的程式碼（非 `.md`）就擋下——頂層只做安排交辦，實作要進那個子 repo 自己做。 | 🛑 擋 |
 | `wiki-secret-scan.sh` | 要寫進 `system-dev/wiki/` 的內容裡出現密碼／金鑰／身分證／信用卡等特徵就擋下，防止機敏資料意外留在會被反覆讀取的記憶空間裡。 | 🛑 擋 |
 | `component-guard.sh` | AI 想自己新建一個零件（component）或亂接 service binding 就擋下——逼它先想「現成零件夠不夠用」，真要建要你解鎖。 | 🛑 擋 |
-| `sdd-guard.sh` | AI 想直接動程式碼檔案，但找不到「唯一一份 active 規格文件（SDD）」對應這件事，或同時有一份以上 active 規格就擋下。 | 🛑 擋 |
 | `credential-only-guard.sh` | AI 想把金鑰真身或自製佔位符（例如 `__XXX_TOKEN__`）寫進設定檔就擋下——金鑰只准放在統一的 credential 中心。 | 🛑 擋 |
 | `arcrun-intent-guard.sh` | AI 寫的 Arcrun workflow 語法不對就擋下，而且**直接把正確寫法回貼給它**（不是只罵它錯，是教它怎麼改）。 | 🛑 擋（教學型） |
 | `subagent-first-guard.sh` | 這個對話**從頭到尾都沒有派過任何 subagent**，AI 卻要自己動手改程式碼，就先擋一次，逼它想一想「這件事能不能交給別人做」。 | 🛑 擋 |
@@ -141,6 +146,24 @@
 | `wiki-size-guard.sh` | AI 想**一口氣砍掉 wiki 檔一大半內容**（淨縮水超過 800 字且超過原本 45%）就擋一次——那不是一次編輯，那是一次壓縮，而**壓縮會弄丟東西，弄丟的當下沒有人會發現**。出路是走 `scripts/wiki-compress`：它逼你附票號、把壓掉了什麼寫進 `.compress-log.md`，並用內文雜湊**逐條對帳**證明沒弄丟。只是改字、加字、小修一律不碰；真要手改就在內容裡放 `wiki-compress-ok` 留痕。 | 🛑 擋（至多攔一次） |
 | `pending-changes-retired.sh` | AI 想寫東西進已經廢除的 `pending-changes.md` 檔案就擋下——這個檔案已停用，規格變更一律改開 Gitea 票。 | 🛑 擋 |
 
+> 🔴 **`sdd-guard.sh` 已於 `inkstone/ISEP#91` 退役**（原本掛在這一組）。
+> 它擋的是「動 code 檔時，`status: active` 的 SDD 不是恰好一份」。
+> leo 2026-08-16（`inkstone/InkStoneCo#40` → comment 2942）已裁定**取消 Active SDD**：
+> 任務狀態搬到 Gitea 管，SDD 只記「起初的樣子」，不帶任務 checkbox。
+> ⇒ 那支閘要的東西，制度上已經不會再有人生產。
+>
+> **它為什麼非退不可，而不是放著沒關係**：它是 fail-closed 的——
+> `active` 不是恰好 1 份就擋，**0 份也擋**；路徑所在的 repo 沒有 `3-specs` 也擋。
+> 所以「照裁決把 active SDD 拿掉」這個動作本身，會把所有人動任何
+> `.ts`／`.py`／`.go` 的路一起鎖死。這就是那個裁決躺了 11 天沒人敢執行的真正原因。
+> 而 **ISEP 這個 repo 自己就沒有 `3-specs`**：退役之前，改自己的 `hooks/lib/*.py`
+> 當場被這支閘擋下——那不是假設，是這張票開工第一件事實測到的。
+> ⇒ 退役的順序是「**先讓閘退役，再拿掉 active SDD**」，顛倒過來就鎖死。
+>
+> 迴歸測試在 `hooks/tests/sdd-guard-retired.test.sh`：它測的不是「檔案刪了沒有」，
+> 而是把「裁決執行完之後的世界」丟給整組寫檔閘，**不准有任何閘用 SDD 當理由擋下來**
+> ——有人日後換個檔名把同一個形狀種回來，那支測試照樣會紅。
+
 > `kbdb-api-wall-guard.sh` 在這裡也重複掛了一次（見 A 組）——它同時守著「下指令」跟「寫檔案」兩種情境，詳見下方「重複掛載」一節。
 
 ## C. AI 要去翻程式碼／查資料之前（PreToolUse / Grep·Glob·Read·Bash）

hooks/guard-cross-project.sh

@@ -12,18 +12,8 @@
 # 放行：頂層自己的檔（CLAUDE.md / .claude/ / docs/ / MEMORY.md…）、
 #       以及子 repo 內的 .md（交棒 HANDOFF / 筆記 / 文件——leo 2026-06-15 拍板放行所有 .md）。
 #
-# 白名單放行的判準是「**這個路徑屬於哪個 repo**」（git 回答），不是路徑前綴——
-# 所以 `matrix/arcrun` 的 worktree（`matrix/arcrun-wt-<票號>/`）跟主工作目錄一樣放行。
-# 理由與實撞見下面 `owning_repo_rel()` 上方那段（inkstone/ISEP#117）。
-#
-# 誠實限制（arcrun mindset §7）：
-#   1. 本 hook 擋的是「路徑語法層」——能擋「寫程式碼進子 repo」，擋不了「把實作偽裝成 .md」
-#      或「該交棒卻判斷成可直改」這種語意層越界。它是底線，不是萬能。
-#   2. 🔴 `CLAUDE_CODE_CHILD_SESSION` **不是可靠的「我是 subagent」標記**——
-#      `InkStoneCo/system-dev/wiki/ops-facts.md` 記著實測：Claude Desktop 的總管主 session
-#      也是 `1`。⇒ 在那個 surface 上，下面整段白名單對總管自己也會放行。
-#      這一點本輪**沒有動**（那是另一件事，改它要重新評估誰該被擋），
-#      但誰讀這支閘都該知道它不是它字面上看起來的那道夾子。
+# 誠實限制（arcrun mindset §7）：本 hook 擋的是「路徑語法層」——能擋「寫程式碼進子 repo」，
+# 擋不了「把實作偽裝成 .md」或「該交棒卻判斷成可直改」這種語意層越界。它是底線，不是萬能。
 
 input="$(cat)"
 
@@ -40,31 +30,13 @@ except Exception:
 # 拿不到路徑就放行（不誤擋；hook 不該因解析失敗卡死正常操作）
 [ -z "$file_path" ] && exit 0
 
-# 頂層 repo 根 ＝「現在在操作哪個專案」，那正是 $CLAUDE_PROJECT_DIR 的定義。
-#
-# 🔴 舊版拿 `<hook 檔>/../..` 當答案。那在 `InkStoneCo/.claude/hooks/` 底下剛好對，
-#    但這支閘搬進 plugin 之後路徑變成 `<plugin>/hooks/`，`../..` 指到 plugin cache 的
-#    上一層 ⇒ 絕對路徑的前綴永遠剝不掉 ⇒ rel 永遠留著 `/Users/…` ⇒ 永遠不符合
-#    `matrix/*` ⇒ **這支閘在 plugin 裡從來沒生效過**。
-#    2026-09-01 實測（inkstone/ISEP#117），同一份 payload（寫 matrix/arcrun/foo.ts）：
-#        plugin 那份     → exit 0（放行）
-#        InkStoneCo 那份 → exit 2（擋）
-#    ⇒ 真正在擋的一直是 InkStoneCo 的副本。這也是 README「路徑規約」寫的那條：
-#      指專案內的檔案要用 `$CLAUDE_PROJECT_DIR`，不要拿 hook 自己的位置去推。
-# 後面那個 `../..` 只留作 fallback（沒有這個環境變數時，例如手動 pipe 進來測）。
-repo_root="${CLAUDE_PROJECT_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
-
-# 同一個目錄的**實體路徑**（symlink 解開）。macOS 的 `/tmp`→`/private/tmp`、
-# `/var`→`/private/var` 就是這個形狀，而 `git worktree list` 回的一律是實體路徑
-# ⇒ 兩個版本都要留著比，不然「明明是同一個目錄」會比不出來。
-repo_root_phys="$(cd "$repo_root" 2>/dev/null && pwd -P)"
-[ -n "${repo_root_phys:-}" ] || repo_root_phys="$repo_root"
+# 頂層 repo 根（hook 檔位於 <root>/.claude/hooks/）
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
 
 # 轉成相對 repo_root 的路徑（file_path 可能是絕對或相對）
 case "$file_path" in
-  /*) rel="${file_path#"$repo_root"/}"                # 絕對路徑 → 去掉 repo_root 前綴
-      rel="${rel#"$repo_root_phys"/}" ;;              #            實體路徑版也試一次
-  *)  rel="$file_path" ;;                             # 相對路徑 → 假定相對 repo_root
+  /*) rel="${file_path#"$repo_root"/}" ;;   # 絕對路徑 → 去掉 repo_root 前綴
+  *)  rel="$file_path" ;;                    # 相對路徑 → 假定相對 repo_root
 esac
 
 # 不在子 repo 目錄內 → 放行（頂層自己的檔）
@@ -76,10 +48,8 @@ esac
 # 自動派工放行（2026-06-28 leo 拍板上線，實測通過）：
 # 子 repo 的 subagent 可直接寫該 repo code（繞 D9）——因 subagent 心智已是該 repo
 # （A/B 實驗證 ≈ claude -p），讓「心智是該 repo 的小弟寫該 repo」符合 context 隔離。
-# 雙重夾：① CHILD_SESSION=1 ② 路徑屬於下面白名單 array 上的 repo。
-# ⚠️ ①**沒有它字面上看起來那麼緊**：原註解寫「總管主 session 無此標籤仍被擋」，
-#    但 `InkStoneCo/system-dev/wiki/ops-facts.md` 記著實測——Claude Desktop 的
-#    總管主 session 也是 `1`。⇒ 在那個 surface 上這一夾是空的。本輪沒有動它。
+# 雙重夾：① CHILD_SESSION=1（harness 內建 subagent 標籤，總管主 session 無此標籤仍被擋）
+#        ② 路徑在下面白名單 array 內。
 # 隔離保證＝prompt reset（軟，靠監測）非結構級；要絕對純走 claude -p。心法見 wiki。
 #
 # 🔧 leo 維護：要放開一個 repo 給 subagent 自動寫 code，就在這 array 加一行路徑前綴。
@@ -89,58 +59,11 @@ AUTODISPATCH_ALLOW=(
   "matrix/arcrun"          # 共用框架（影響全部人，走 PR 把關）
   "products/arcrun-rag"    # 產品組裝 repo（2026-07-13 leo 放行 G8：回覆「放行」）
 )
-
-# ── 白名單比對的是「哪個 repo」，不是「哪個路徑前綴」（inkstone/ISEP#117）─────────
-#
-# 為什麼改：`line-needs-own-worktree.sh` 印出來的下一步是
-#     git -C <TOP> worktree add <PARENT>/<NAME>-wt-<票號> -b <分支>
-# 照做之後，`matrix/arcrun` 的線會在 `matrix/arcrun-wt-195/` 裡動工——
-# 而舊版這裡是純前綴比對，`matrix/arcrun-wt-195/…` 不符合 `matrix/arcrun/*` ⇒ **擋**。
-# ⇒ 兩道閘互相打架：**照規矩開 worktree 的人被擋，留在共用目錄裡的人反而過得了**。
-# 2026-08-31 `inkstone/Arcrun#195` 實撞（見票上原文），工人只好把 worktree 開到
-# InkStoneCo 樹之外躲開這一支——閘把人逼去繞路，那條規矩就等於沒有。
-#
-# 判準用的是 git 自己算出來的事實，跟 `line-needs-own-worktree.sh` 同一個形狀：
-#   `git worktree list --porcelain` **第一筆永遠是主工作目錄**（不管你從哪一份問）。
-#   ⇒ 那一筆就是這個路徑「屬於哪個 repo」的唯一識別碼。
-#   ⇒ 主工作目錄與它所有的 worktree 都會回同一個答案，`-wt-` 這個命名慣例
-#     一個字都不用出現在判準裡（不靠名字＝改名字也騙不過去）。
-#
-# 🔴 這是「拿唯一識別碼往**放行**的方向比對」，不是關鍵字比對：
-#    名單上沒有的 repo、它的 worktree、以及根本不是 repo 的目錄，全部照舊被擋。
-owning_repo_rel() {
-  local d="$1" main
-  # 檔案還不存在也要答得出來（Write 新檔）⇒ 往上走到第一個真的存在的目錄
-  while [ -n "$d" ] && [ "$d" != "/" ] && [ ! -d "$d" ]; do d="$(dirname "$d")"; done
-  [ -d "$d" ] || return 1
-  main="$(git -C "$d" worktree list --porcelain 2>/dev/null | sed -n '1s/^worktree //p')"
-  [ -n "$main" ] || return 1
-  # 🔴 `git worktree list` 回的一律是**實體路徑**（symlink 都解開了）。
-  #    macOS 的 `/tmp`→`/private/tmp`、`/var`→`/private/var` 就是這個形狀，
-  #    所以兩邊都要用實體路徑比，不然「明明是同一個目錄」會比不出來。
-  case "$main" in
-    # 只認「頂層樹底下的子 repo」。走到這裡若答案是頂層樹自己（＝那個目錄根本
-    # 不是獨立的 repo，git 一路往上找到了頂層），就回 1 ⇒ 照舊擋，不放寬。
-    "$repo_root"/*)      printf '%s' "${main#"$repo_root"/}" ;;
-    "$repo_root_phys"/*) printf '%s' "${main#"$repo_root_phys"/}" ;;
-    *) return 1 ;;
-  esac
-}
-
-if [ "${CLAUDE_CODE_CHILD_SESSION:-}" = "1" ]; then
-  case "$file_path" in
-    /*) abs="$file_path" ;;
-    *)  abs="$repo_root/$file_path" ;;
-  esac
-  owner="$(owning_repo_rel "$(dirname "$abs")" 2>/dev/null || true)"
+if [ "$CLAUDE_CODE_CHILD_SESSION" = "1" ]; then
   for allowed in "${AUTODISPATCH_ALLOW[@]}"; do
     case "$rel" in
       "$allowed"/*) echo "🤝 [guard] subagent 放行：$allowed（自動派工）" >&2; exit 0 ;;
     esac
-    if [ -n "${owner:-}" ] && [ "$owner" = "$allowed" ]; then
-      echo "🤝 [guard] subagent 放行：$rel 屬於 $allowed 的 worktree（git worktree list 第一筆＝$allowed）" >&2
-      exit 0
-    fi
   done
 fi
 

hooks/hooks.json

@@ -99,10 +99,6 @@
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/hooks/component-guard.sh"
           },
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/sdd-guard.sh"
-          },
           {
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/hooks/credential-only-guard.sh"

hooks/lib/path-resolve.sh

@@ -24,6 +24,12 @@
 # 這些全部沒有本檔「先確認到底在不在 repo 裡」的判斷；本檔先在 sdd-guard.sh 落地，
 # 其餘要不要跟進、要不要改用這支共用函式，另案處理，不在本票（#22）範圍內一次改完。
 #
+# ⚠️ **`sdd-guard.sh` 已於 `inkstone/ISEP#91` 退役**（執行 leo「取消 Active SDD」的裁決），
+# 所以本檔目前**沒有任何 caller**——但它不是死 code：上面那份清單裡的十幾支閘全都還在用
+# 「猜專案根」那個寫法，本檔就是要給它們用的解法。**不要因為沒人 source 就順手刪掉**，
+# 刪掉等於把 #22 學到的東西一起丟了。
+# （本段只加註解，不動下面任何一行邏輯——`8718658` 那輪修的判定行為原封不動。）
+#
 # 用法：
 #   source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/lib/path-resolve.sh"
 #   if ! path_in_git_worktree "$FILE_PATH"; then

hooks/sdd-guard.sh

@@ -1,234 +0,0 @@
-#!/bin/bash
-# 管什麼: Write/Edit 動 code 檔（.ts/.py/.go…）前，要不要有對應的一份 status: active SDD（design.md）。
-# 為什麼: SDD 生命週期鐵律——動 code 前必須有規格可對，且整個 repo 同一時刻只准一份 active。
-#         把「動手前先讀 SDD」從只能靠人記，升級成機器擋（system-dev/docs/3-specs/SDD-LIFECYCLE.md）。
-# 誤觸時怎麼關: 改文件／測試檔／3-specs 自己一律放行（下方 case 已排除）；不在任何 git repo
-#              裡的路徑（scratchpad、/tmp 暫存檔）一律放行，SDD 管不到它們。真的要臨時豁免
-#              一次小改動，說明範圍後由人手動放行——這支閘不設「一行關掉」的旗標。
-#
-# PreToolUse hook — 動 code 前檢查 SDD ＋ 單一活性 SDD 鐵律（issue #6）
-# wishlist §2：把 /sdd-check 從「命令要人打」升級成「hook 自動攔」。
-# 生命週期規則全文：system-dev/docs/3-specs/SDD-LIFECYCLE.md
-#
-# 掛在 settings.json 的 PreToolUse（matcher: Write|Edit）。
-# stdin 收到 JSON：{ tool_name, tool_input: { file_path, ... } }
-# 行為：
-#   1. status: active 的 SDD > 1 份 → 單一活性鐵律已被違反，**不論寫什麼檔**一律擋（exit 2），
-#      先收斂到一份再說。
-#   2. 動 code 檔（.ts/.go/...）→ 需要「恰好 1 份」active SDD；0 份 → 擋。
-#   3. 向下相容：3-specs 下完全沒有任何 design.md 帶 frontmatter（老 repo 尚未遷移生命週期制度）
-#      → 退回舊行為：有 design.md 就放行＋提醒，沒有才擋。避免 template update 後老 repo 立刻全紅。
-#
-# 誠實限制（抄 arcrun）：只擋語法層明顯違規（直接寫 code 檔）。
-# 藏在 helper 裡、用 bash 繞道的改動擋不到。
-# 價值是「想跳過會被抓到 + 留痕可審」，不是技術防偽。絕不聲稱「不可能繞過」。
-
-set -euo pipefail
-
-source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/lib/path-resolve.sh"
-
-INPUT=$(cat)
-
-# 解析 file_path。優先用 jq，沒有 jq 退回 grep（容錯）。
-if command -v jq >/dev/null 2>&1; then
-  FILE_PATH=$(printf '%s' "$INPUT" | jq -r '.tool_input.file_path // empty')
-else
-  FILE_PATH=$(printf '%s' "$INPUT" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"file_path"[[:space:]]*:[[:space:]]*"//;s/"$//')
-fi
-
-# 拿不到路徑 → 不擋（容錯，寧可放過也不誤殺）
-[ -z "$FILE_PATH" ] && exit 0
-
-# 🔴 2026-08-02 修：原本寫死相對路徑 `system-dev/docs/3-specs`，
-#    但 hook 的工作目錄是**頂層 InkStoneCo**，改子 repo 的 code 時就去頂層找 SDD
-#    ⇒ 看不到子 repo 自己那份 ⇒ **一律誤報「找不到任何 SDD」**。
-#    實撞：改 products/arcrun-rag/collector/... 被擋，但該 repo 明明有
-#    system-dev/docs/3-specs/daemon-beta/design.md（status: active）。
-#    ⇒ 改成從被改檔案往上找最近的 system-dev/docs/3-specs（子 repo 優先，找不到才用頂層）。
-#    ⚠️ 只往上找到「頂層 InkStoneCo」為止——不可讓任意路徑（如 /private/tmp/…）
-#    退回頂層 SDD 而被放行，那會把原本擋得住的情況變成擋不住。
-#
-# 🔴 2026-08-20 修（inkstone/InkStoneCo#22）：上面這套邏輯有兩個洞，都是總管 08-12 實撞的：
-#
-#   洞 A — scratchpad 暫存檔被當成「code 變動」：
-#     `/private/tmp/.../scratchpad/foo.py` 不在 `$_root` 底下、往上找不到 3-specs，
-#     於是走到「找不到 SDD」擋下路徑——但 scratchpad 是 session 專用暫存區，從不進版控，
-#     SDD 管的是 repo 裡的產品程式碼，管不到它。**先問「這條路徑到底在不在某個 git repo
-#     裡」（`path_in_git_worktree`，見 lib/path-resolve.sh），不在 ⇒ 這道閘天生管不到
-#     ⇒ 直接放行**，不必先繞去猜專案根、再證明找不到才擋。
-#     用「有沒有 .git 可尋」判斷，比列舉路徑關鍵字（/tmp、scratchpad…）更穩：
-#     不必窮舉每一種暫存區的命名法，任何真的不在 repo 裡的路徑都一視同仁。
-#
-#   洞 B — 訊息裡印出字面的 `/nonexistent`：
-#     舊版用 `/nonexistent/3-specs` 當內部 sentinel，讓「找不到 SDD」的既有擋下路徑可以
-#     重用；但這個 sentinel 值被直接印進使用者看到的訊息，讀起來像是「這支腳本認真去
-#     /nonexistent 這個地方找過」——具體、卻是假的。改成用 RESOLVED 旗標記「解析成不成功」，
-#     擋下訊息另外用人話描述「為什麼找不到」，不洩漏內部實作用的假路徑。
-#
-#   ⚠️ 洞 A／B 都不改變「真的解析失敗時」的判定方向：路徑確實落在某個 git repo 裡，
-#   但那個 repo 沒有 3-specs（或裡面沒有 active SDD）→ 仍然 **fail-closed**（擋，不放行）。
-#   為什麼是 fail-closed、不是 fail-open：這道閘存在的目的就是防止「沒有 SDD 卻能動
-#   code」，若把「判斷不出來」直接放行，等於把一次環境跑歪（cwd 被切走、
-#   `$CLAUDE_PROJECT_DIR` 沒設、worktree 缺 3-specs…）悄悄變成「這道閘關掉了，而且沒有
-#   任何人被告知」——silent bypass 的代價遠高於「多打一次確認」。#22 的紅線也明寫
-#   「不要把閘改成『解析失敗就放行』——那是把誤判換成漏判」。
-# 洞 A 的修法，套用在 case 分岔**之前**：不管 `$_root` 猜不猜得對，
-# 先問「這條路徑到底在不在某個 git repo 裡」。不在 ⇒ SDD 這道閘天生管不到，直接放行。
-# 🔴 這個檢查故意放在 `$FILE_PATH` 是否落在 `$_root` 底下的判斷之前、且對兩邊都適用
-# （不是只套用在「專案外」那個分支）：第一版只把它放進「專案外」分支，結果測試
-# （hooks/tests/sdd-guard.test.sh）就抓到一個不對稱漏洞——當 `$_root` 剛好等於
-# scratchpad 的某層祖先目錄（例如 hook 被叫用時 cwd 已經跑到 /private/tmp 底下、
-# `$CLAUDE_PROJECT_DIR` 也沒設），scratchpad 路徑會被判成「在 `$_root` 底下」而
-# 走進另一條完全沒做 git-repo 檢查的路徑，同一個誤判换個路徑重新出現。
-# 改成「先問是不是在 git repo 裡，不管路徑跟 `$_root` 的關係」就沒有這個不對稱。
-if ! path_in_git_worktree "$FILE_PATH"; then
-  exit 0
-fi
-
-_root="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-# 預設值一律絕對路徑（不留相對路徑「system-dev/docs/3-specs」退回目前 cwd 的洞——
-# 舊版這裡曾經是相對路徑，若專案內迴圈找不到就會被拿去跟 hook 執行當下的 cwd 兜，
-# cwd 湊巧有同名目錄就會判斷到不相干的資料）。
-SPECS_DIR="$_root/system-dev/docs/3-specs"
-RESOLVED=1   # 1＝SPECS_DIR 是有意義的答案；0＝真的解析失敗，SPECS_DIR 留空，訊息另外講原因
-
-case "$FILE_PATH" in
-  "$_root"/*)
-    _d=$(dirname "$FILE_PATH")
-    while [ "$_d" != "/" ] && [ -n "$_d" ]; do
-      if [ -d "$_d/system-dev/docs/3-specs" ]; then
-        SPECS_DIR="$_d/system-dev/docs/3-specs"
-        break
-      fi
-      [ "$_d" = "$_root" ] && break
-      _d=$(dirname "$_d")
-    done
-    ;;
-  *)
-    # 專案外的路徑：`$_root` 猜錯，或這條路徑本來就不屬於目前的 `$_root`。
-    # 已知落在某個 git repo 裡（上面剛確認過）：往上找它自己的 3-specs。
-    # **不可退回 `$_root` 的 3-specs 就放行**——那會把「這個 repo 沒有 SDD」
-    # 誤判成「用別的 repo 的 SDD 蒙混過關」，原本擋得住的會變成擋不住。
-    SPECS_DIR=""
-    RESOLVED=0
-    _d=$(dirname "$FILE_PATH")
-    while [ "$_d" != "/" ] && [ -n "$_d" ]; do
-      if [ -d "$_d/system-dev/docs/3-specs" ]; then
-        SPECS_DIR="$_d/system-dev/docs/3-specs"
-        RESOLVED=1
-        break
-      fi
-      _d=$(dirname "$_d")
-    done
-    ;;
-esac
-
-# 給訊息用的人話描述：解析成功就印真路徑，失敗就誠實講「為什麼」，不印假路徑
-# （洞 B 的修法——舊版這裡印的是內部 sentinel `/nonexistent/3-specs`）。
-if [ "$RESOLVED" -eq 1 ]; then
-  SPECS_DIR_DESC="${SPECS_DIR}/"
-  SPECS_NOT_FOUND_MSG="${SPECS_DIR}/ 下找不到任何 SDD"
-  SPECS_NOT_ACTIVE_MSG="${SPECS_DIR}/ 下沒有任何 status: active 的 SDD"
-else
-  SPECS_DIR_DESC=""
-  SPECS_NOT_FOUND_MSG="這條路徑所在的 git repo 裡找不到 system-dev/docs/3-specs，也就沒有任何 SDD 可對（或這支閘沒能定位到正確的專案根——這是 fail-closed：寧可誤擋也不悄悄放行，見檔頭註解）"
-  SPECS_NOT_ACTIVE_MSG="$SPECS_NOT_FOUND_MSG"
-fi
-
-# ── 統計 active / frontmatter ──────────────────────
-# 排除 archive/（已封存）與 TEMPLATE（範本自帶 status: draft frontmatter，不算數——
-# 否則 update 一鋪新版 TEMPLATE-sdd，老 repo 就被誤判「已遷移」而全紅，向下相容破功）。
-# frontmatter 判定＝design.md 前 10 行有 ^status: 行（機器可查，見 SDD-LIFECYCLE.md）。
-ACTIVE_COUNT=0
-FM_COUNT=0
-ACTIVE_LIST=""
-if [ -n "$SPECS_DIR" ] && [ -d "$SPECS_DIR" ]; then
-  while IFS= read -r f; do
-    [ -n "$f" ] || continue
-    HEAD10=$(head -10 "$f" 2>/dev/null || true)
-    if printf '%s\n' "$HEAD10" | grep -q '^status:[[:space:]]*'; then
-      FM_COUNT=$((FM_COUNT + 1))
-      if printf '%s\n' "$HEAD10" | grep -q '^status:[[:space:]]*active'; then
-        ACTIVE_COUNT=$((ACTIVE_COUNT + 1))
-        ACTIVE_LIST="${ACTIVE_LIST}   • ${f}
-"
-      fi
-    fi
-  done < <(find "$SPECS_DIR" -name 'design.md' -not -path '*TEMPLATE*' -not -path '*/archive/*' 2>/dev/null)
-fi
-
-# ── 鐵律 1：單一活性被違反（active > 1）→ 不論寫什麼檔一律擋 ──
-if [ "$ACTIVE_COUNT" -gt 1 ]; then
-  cat >&2 <<EOF
-🚫 SDD 單一活性鐵律違反：偵測到 ${ACTIVE_COUNT} 份 status: active 的 SDD（任何時刻整個 repo 最多一份）：
-${ACTIVE_LIST}
-請先收斂到一份：其餘改 status: paused / closed（closed 且被取代者填 superseded_by 並移入 3-specs/archive/）。
-規則全文見 system-dev/docs/3-specs/SDD-LIFECYCLE.md。收斂前擋下所有寫檔。
-（本 hook 攔 Write/Edit；修 frontmatter 可用 bash 直改，或由人裁決哪份是現行。）
-EOF
-  exit 2
-fi
-
-# 只管 code 檔。docs/markdown/設定檔等放行。
-case "$FILE_PATH" in
-  *.ts|*.tsx|*.js|*.jsx|*.go|*.py|*.rs|*.java|*.rb|*.php|*.c|*.cpp|*.h|*.hpp|*.swift|*.kt) ;;
-  *) exit 0 ;;
-esac
-
-# 改 SDD 自己 / 測試檔 → 放行
-case "$FILE_PATH" in
-  *system-dev/docs/3-specs/*) exit 0 ;;
-  *_test.*|*.test.*|*.spec.*|*/tests/*|*/test/*) exit 0 ;;
-esac
-
-# ── 向下相容：整個 3-specs 沒有任何帶 frontmatter 的 design.md ──
-# ＝老 repo 還沒遷移生命週期制度 → 退回舊行為（有 design.md 就放行＋提醒），
-# 避免 template update 一裝新 hook，老 repo 所有 code 寫入立刻全紅。
-if [ "$FM_COUNT" -eq 0 ]; then
-  SDD_COUNT=0
-  if [ -n "$SPECS_DIR" ] && [ -d "$SPECS_DIR" ]; then
-    SDD_COUNT=$(find "$SPECS_DIR" -name 'design.md' -not -path '*TEMPLATE*' -not -path '*/archive/*' 2>/dev/null | wc -l | tr -d ' ')
-  fi
-
-  if [ "$SDD_COUNT" -eq 0 ]; then
-    cat >&2 <<EOF
-🚫 SDD 協議攔截：要動 code 檔 ($FILE_PATH)，但 ${SPECS_NOT_FOUND_MSG}。
-
-絕對鐵律：任何 code 變動前必須有對應 SDD（design.md），且遵守單一活性生命週期
-（system-dev/docs/3-specs/SDD-LIFECYCLE.md）。
-
-請先：
-  1. 確認這個改動屬於哪個子系統
-  2. 在 [子系統的] system-dev/docs/3-specs/[子系統]/ 建立 design.md（可用 /sdd-check 協助），frontmatter 標 status: active
-  3. 在回覆開頭宣告已讀 SDD + 對應 task
-
-小修改（修 bug、改文字）若確定豁免，請明確說明範圍後由人放行。
-EOF
-    exit 2
-  fi
-
-  # 舊行為放行 + 提醒遷移（stderr 警告，不擋）
-  echo "📋 提醒：${SPECS_DIR_DESC} 有 SDD 但尚未掛生命週期 frontmatter（老結構）。動手前確認已讀對應 design.md；建議依 SDD-LIFECYCLE.md 補 status 標記（現行那份標 active）。" >&2
-  exit 0
-fi
-
-# ── 新行為：寫 code 檔需「恰好 1 份」active SDD ──
-if [ "$ACTIVE_COUNT" -eq 0 ]; then
-  cat >&2 <<EOF
-🚫 SDD 協議攔截：要動 code 檔 ($FILE_PATH)，但 ${SPECS_NOT_ACTIVE_MSG}。
-
-單一活性鐵律：所有開發任務唯一對應源＝那份 active SDD（規則見 system-dev/docs/3-specs/SDD-LIFECYCLE.md）。
-
-請先（擇一，都是人的決定，CC 不得自行建 SDD）：
-  1. 把現行規格的 design.md frontmatter 標成 status: active（一份、只能一份）
-  2. 或依 SDD-LIFECYCLE.md 第 3、4 條：proposal 進 pending-changes.md → 使用者 confirm → 開新 SDD 標 active
-然後在回覆開頭宣告已讀 active SDD + 對應 task。
-
-小修改（修 bug、改文字）若確定豁免，請明確說明範圍後由人放行。
-EOF
-  exit 2
-fi
-
-# 恰好 1 份 active：放行，留痕提醒要宣告（stderr 警告，不擋）
-printf '📋 提醒：現行 active SDD＝\n%s動手前請確認已讀它的 design.md、對應到 tasks，並在回覆宣告。\n' "$ACTIVE_LIST" >&2
-exit 0

hooks/tests/sdd-guard-retired.test.sh

@@ -0,0 +1,154 @@
+#!/usr/bin/env bash
+# sdd-guard 退役的迴歸測試（inkstone/ISEP#91）
+#
+# ── 這支在守什麼 ────────────────────────────────────────────────────
+# leo 2026-08-16 在 inkstone/InkStoneCo#40 裁定「**取消 Active SDD**」：
+# 任務狀態搬到 Gitea 管，SDD 只記「起初的樣子」。
+# 但 `sdd-guard.sh` 是 **fail-closed** 的——
+#     動 code 檔時，active SDD 不是「恰好 1 份」→ 擋（0 份也擋）
+#     路徑所在的 repo 沒有 3-specs                → 也擋
+# ⇒ 照裁決把 active SDD 拿掉，會把「動任何 .ts/.py/.go」整個鎖死。
+# 這就是那個裁決 11 天沒人敢執行的真正原因。
+#
+# 所以退役的順序是「**先讓閘退役，再拿掉 active SDD**」，而這支測的是第一步做完了沒有。
+#
+# 🔴 它測的不是「檔案刪掉了沒有」，而是**那個擋還會不會發生**：
+#    把整組 `Write|Edit|MultiEdit` 的 PreToolUse 閘，拿去撞「裁決執行完之後的世界」
+#    （一個沒有 3-specs 的 repo、以及一個有兩份 active SDD 的 repo），一支都不准擋。
+#    ⇒ 有人日後用別的檔名把同一個形狀種回來，這支照樣會紅。
+#
+# 用法：hooks/tests/sdd-guard-retired.test.sh
+# 🔴 全程在 TMP 底下建假 repo，跑完自己清；不動任何真 repo、不打網路。
+
+set -u
+HOOKS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+REPO_ROOT="$(cd "$HOOKS_DIR/.." && pwd)"
+TMP=$(mktemp -d)
+trap 'rm -rf "$TMP"' EXIT
+
+PASS=0; FAIL=0
+ok()   { echo "  ✅ $1"; PASS=$((PASS+1)); }
+bad()  { echo "  ❌ $1"; FAIL=$((FAIL+1)); }
+
+# ── ① 閘本體與它的註冊都不在了 ────────────────────────────────────
+echo "── ① 退役：檔案與註冊 ──"
+
+if [ -e "$HOOKS_DIR/sdd-guard.sh" ]; then
+  bad "hooks/sdd-guard.sh 還在（應已刪除）"
+else
+  ok "hooks/sdd-guard.sh 已刪除"
+fi
+
+if grep -q 'sdd-guard' "$HOOKS_DIR/hooks.json"; then
+  bad "hooks.json 還註冊著 sdd-guard（照裁決做會鎖死所有 code 寫入）"
+else
+  ok "hooks.json 已無 sdd-guard 註冊"
+fi
+
+# hooks.json 要仍然是合法 JSON，而且別的閘一支都沒被順手弄掉
+# （README：合錯的時候「語法合法、閘卻不見了」，不會有任何東西喊一聲）
+REGISTERED=$(python3 - "$HOOKS_DIR/hooks.json" <<'PY'
+import json, sys
+d = json.load(open(sys.argv[1]))
+print(sum(len(g.get("hooks", [])) for ev in d["hooks"].values() for g in ev))
+PY
+) || REGISTERED=""
+if [ -n "$REGISTERED" ]; then
+  ok "hooks.json 仍是合法 JSON（註冊 $REGISTERED 條）"
+else
+  bad "hooks.json 解析失敗"
+fi
+
+# ── ② 真正的驗收：裁決執行完之後，動 code 檔不能被擋 ──────────────
+echo "── ② 行為：把「拿掉 active SDD 之後的世界」丟給整組寫檔閘，一支都不准擋 ──"
+
+# 這兩個假 repo 就是舊 sdd-guard 一定會擋下的兩種狀態：
+#   A. 完全沒有 3-specs（＝裁決執行完的樣子，也是 ISEP 自己現在的樣子）
+#   B. 兩份 status: active（＝舊的「單一活性鐵律」違反）
+REPO_NO_SDD="$TMP/repo-no-sdd"
+mkdir -p "$REPO_NO_SDD/src"
+git init -q "$REPO_NO_SDD"
+
+REPO_MULTI="$TMP/repo-multi-active"
+mkdir -p "$REPO_MULTI/system-dev/docs/3-specs/a" "$REPO_MULTI/system-dev/docs/3-specs/b" "$REPO_MULTI/src"
+git init -q "$REPO_MULTI"
+printf -- '---\nstatus: active\n---\n# A\n' > "$REPO_MULTI/system-dev/docs/3-specs/a/design.md"
+printf -- '---\nstatus: active\n---\n# B\n' > "$REPO_MULTI/system-dev/docs/3-specs/b/design.md"
+
+# 撈出所有掛在 Write|Edit|MultiEdit 上的 PreToolUse 閘（照 hooks.json 的實況，不寫死清單）
+mapfile -t WRITE_HOOKS < <(python3 - "$HOOKS_DIR/hooks.json" <<'PY'
+import json, sys
+d = json.load(open(sys.argv[1]))
+for g in d["hooks"].get("PreToolUse", []):
+    m = g.get("matcher", "") or ""
+    if "Write" in m or "Edit" in m:
+        for h in g.get("hooks", []):
+            print(h["command"].split("/")[-1])
+PY
+)
+
+if [ "${#WRITE_HOOKS[@]}" -eq 0 ]; then
+  bad "撈不到任何 Write|Edit 的 PreToolUse 閘——測試本身失效了，先修這裡"
+fi
+
+# 判準：擋下來的理由**是不是 SDD**。
+#
+# 🔴 這裡刻意不寫成「一支閘都不准擋」——同一組 matcher 上還住著好幾支跟 SDD 無關、
+#    而且看 session 狀態決定擋不擋的閘（`subagent-first-guard`／`history-first-guard`…）。
+#    把它們算成失敗，這支測試就會在別人改別的東西時無故變紅，
+#    紅久了就沒人看——`docs/TESTING.md` 開頭那句「誤攔比漏擋更該修」對測試一樣成立。
+#    所以失敗的定義是：**有閘擋下來，而且它擋的理由指向 SDD／3-specs**。
+#    其餘的擋只印出來給人看，不判失敗。
+probe() { # probe <說明> <file_path>
+  local desc="$1" path="$2" sdd_blocked="" other_blocked=""
+  local payload out rc
+  payload=$(python3 -c "import json,sys;print(json.dumps({'tool_name':'Write','tool_input':{'file_path':sys.argv[1],'content':'export const x = 1;\n'}}))" "$path")
+  for name in "${WRITE_HOOKS[@]}"; do
+    [ -x "$HOOKS_DIR/$name" ] || continue
+    out=$(printf '%s' "$payload" | "$HOOKS_DIR/$name" 2>&1)
+    rc=$?
+    [ "$rc" -eq 2 ] || continue
+    if printf '%s' "$out" | grep -qE 'SDD|3-specs'; then
+      sdd_blocked="$sdd_blocked $name"
+    else
+      other_blocked="$other_blocked $name"
+    fi
+  done
+  if [ -n "$sdd_blocked" ]; then
+    bad "$desc —— 仍被 SDD 理由擋下：$sdd_blocked"
+  else
+    ok "$desc"
+    [ -n "$other_blocked" ] && echo "       （另有與 SDD 無關的閘擋下，不算失敗：$other_blocked）"
+  fi
+}
+
+# 刻意讓 $_root（CLAUDE_PROJECT_DIR／pwd）跟這些假 repo 對不上——
+# 舊 sdd-guard 在這個情境下走的正是 fail-closed 那條分支。
+unset CLAUDE_PROJECT_DIR
+cd "$TMP" || exit 1
+
+probe "repo 沒有 3-specs（裁決執行完的樣子）→ 寫 .ts 不被擋" "$REPO_NO_SDD/src/x.ts"
+probe "repo 沒有 3-specs → 寫 .py 不被擋" "$REPO_NO_SDD/src/x.py"
+probe "兩份 status: active（舊「單一活性」違反）→ 寫 .ts 不被擋" "$REPO_MULTI/src/x.ts"
+
+# ISEP 自己就是「沒有 3-specs 的 repo」——退役前，改自己的 .py 當場被擋。
+probe "ISEP 自己的 hooks/lib/*.py → 不被擋（退役前這一格是紅的）" "$REPO_ROOT/hooks/lib/dispatch_parse.py"
+
+# ── ③ 會被載入的那幾份，不能再有人讀到「只准一份 active SDD」 ──────
+echo "── ③ 條文：載入面不再宣告單一活性鐵律 ──"
+# 只查**會被載入**的那幾份（commands / agents / skills / hooks 腳本）。
+# docs/ 與 wiki/ 不查——它們得說得出「退役了什麼」，不然這件事沒有歷史。
+STALE=""
+while IFS= read -r f; do
+  grep -qE '只(准|允許)一份|單一活性' "$f" && STALE="$STALE $f"
+done < <(find "$REPO_ROOT/commands" "$REPO_ROOT/agents" "$REPO_ROOT/skills" -name '*.md' 2>/dev/null
+         find "$REPO_ROOT/hooks" -maxdepth 1 -name '*.sh' 2>/dev/null)
+if [ -n "$STALE" ]; then
+  bad "這些載入面還在宣告「只准一份 active SDD」：$STALE"
+else
+  ok "commands／agents／skills／hooks 都不再宣告單一活性鐵律"
+fi
+
+echo
+echo "結果：通過 $PASS ／ 失敗 $FAIL"
+[ "$FAIL" -eq 0 ] || exit 1

hooks/tests/sdd-guard.test.sh

@@ -1,90 +0,0 @@
-#!/usr/bin/env bash
-# sdd-guard.sh 的迴歸測試（inkstone/InkStoneCo#22）。
-#
-# 涵蓋兩個洞：
-#   洞 A — scratchpad／任何不在 git repo 裡的暫存檔被誤判成「code 變動」而擋下。
-#   洞 B — 真的解析失敗（fail-closed）時，訊息裡印出內部 sentinel `/nonexistent`。
-# 以及既有行為不能退步：單一活性違反仍擋、恰好 1 份 active 仍放行、
-# 「dirname 還沒建立」不可被誤判成「不在 repo 裡」（新邏輯自己可能引入的 fail-open 陷阱）。
-#
-# 用法：hooks/tests/sdd-guard.test.sh [hooks/sdd-guard.sh 的路徑]
-# 🔴 全程在一個乾淨的 TMP 底下建假 repo，跑完自己清；不動任何真 repo。
-
-set -u
-HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/sdd-guard.sh}"
-TMP=$(mktemp -d)
-trap 'rm -rf "$TMP"' EXIT
-
-PASS=0; FAIL=0
-
-mk() { # mk <file_path> -> JSON on stdout
-  python3 -c "import json,sys;print(json.dumps({'tool_name':'Write','tool_input':{'file_path':sys.argv[1],'content':'x'}}))" "$1"
-}
-
-t() { # t <期望 exit code> <說明> <file_path> [額外檢查關鍵字]
-  local want="$1" desc="$2" path="$3" must_not_contain="${4:-}"
-  local out rc
-  out=$(mk "$path" | "$HOOK" 2>&1)
-  rc=$?
-  local ok=1
-  [ "$rc" -eq "$want" ] || ok=0
-  if [ -n "$must_not_contain" ] && printf '%s' "$out" | grep -qF "$must_not_contain"; then
-    ok=0
-  fi
-  if [ "$ok" -eq 1 ]; then
-    echo "  ✅ $desc"; PASS=$((PASS+1))
-  else
-    echo "  ❌ $desc —— 期望 exit=$want，實得 exit=$rc"
-    [ -n "$must_not_contain" ] && echo "     （且訊息不該含「$must_not_contain」）"
-    echo "     輸出：$out" | head -3
-    FAIL=$((FAIL+1))
-  fi
-}
-
-# ── 準備：一個真的沒有 3-specs 的 git repo（模擬「真的解析失敗」）──
-REPO_NO_SDD="$TMP/repo-no-sdd"
-mkdir -p "$REPO_NO_SDD/src"
-git init -q "$REPO_NO_SDD"
-
-# ── 準備：一個有 1 份 active SDD 的 git repo ──
-REPO_ONE_ACTIVE="$TMP/repo-one-active"
-mkdir -p "$REPO_ONE_ACTIVE/system-dev/docs/3-specs/x" "$REPO_ONE_ACTIVE/src"
-git init -q "$REPO_ONE_ACTIVE"
-printf -- '---\nstatus: active\n---\n# X\n' > "$REPO_ONE_ACTIVE/system-dev/docs/3-specs/x/design.md"
-
-# ── 準備：一個有 2 份 active SDD 的 git repo（單一活性違反）──
-REPO_MULTI="$TMP/repo-multi-active"
-mkdir -p "$REPO_MULTI/system-dev/docs/3-specs/a" "$REPO_MULTI/system-dev/docs/3-specs/b" "$REPO_MULTI/src"
-git init -q "$REPO_MULTI"
-printf -- '---\nstatus: active\n---\n# A\n' > "$REPO_MULTI/system-dev/docs/3-specs/a/design.md"
-printf -- '---\nstatus: active\n---\n# B\n' > "$REPO_MULTI/system-dev/docs/3-specs/b/design.md"
-
-# ── 準備：scratchpad 風格的暫存區（不在任何 git repo 裡）──
-SCRATCH="$TMP/private/tmp/claude-fake-session/scratchpad"
-mkdir -p "$SCRATCH"
-
-# 讓 $_root（CLAUDE_PROJECT_DIR 或 pwd）刻意跟這些假 repo 對不上，
-# 逼所有案例都走「專案外的路徑」那個分支——這正是 #22 實撞的情境（cwd 跑歪／
-# CLAUDE_PROJECT_DIR 沒設，路徑不落在 $_root 底下）。
-unset CLAUDE_PROJECT_DIR
-cd "$TMP"
-
-echo "── 洞 A：不在任何 git repo 裡的路徑，SDD 管不到，該放行 ──"
-t 0 "scratchpad 暫存 .py（本票原始事故）" "$SCRATCH/fix-project-settings.py"
-t 0 "scratchpad 巢狀更深" "$SCRATCH/nested/deep/tmp.js"
-
-echo "── 洞 B：真的解析失敗（repo 存在但沒有 3-specs）仍要 fail-closed，但訊息不准洩漏內部假路徑 ──"
-t 2 "真 repo 沒有 3-specs → 仍擋" "$REPO_NO_SDD/src/foo.py"
-t 2 "上面那筆的訊息不准出現 /nonexistent" "$REPO_NO_SDD/src/foo.py" "/nonexistent"
-
-echo "── fail-open 陷阱：新檔案要建在還沒建立的子目錄下，不可被誤判成「不在 repo 裡」──"
-t 2 "真 repo、目標子目錄還沒建立 → 仍擋（不能因為 dirname 不存在就放行）" "$REPO_NO_SDD/brand-new/not-yet/bar.py"
-
-echo "── 既有行為不能退步 ──"
-t 0 "只有 1 份 active SDD，改 code 檔 → 放行" "$REPO_ONE_ACTIVE/src/x.py"
-t 2 "2 份 active SDD（單一活性違反）→ 擋" "$REPO_MULTI/src/x.py"
-t 0 "改 .md 文件（非 code 檔）→ 放行，即使找不到 3-specs" "$REPO_NO_SDD/README.md"
-
-echo
-echo "結果：通過 $PASS ／ 失敗 $FAIL"
-[ "$FAIL" -eq 0 ] || exit 1

scripts/test-guard-cross-project.sh

@@ -1,88 +0,0 @@
-#!/bin/bash
-# 跨專案越界閘的測試（docs/TESTING.md A25）— inkstone/ISEP#117
-#
-# 判準：白名單放行的是「**哪個 repo**」，不是「哪個路徑前綴」。
-#   ⇒ `matrix/arcrun` 的 worktree（照 line-needs-own-worktree.sh 印的那行開出來的
-#      `matrix/arcrun-wt-<票號>/`）要跟主工作目錄一樣放行；
-#   ⇒ 名單上沒有的子 repo、它的 worktree、根本不是 repo 的目錄，全部照舊擋。
-#
-# 這支測試用**真的 git repo ＋ 真的 worktree**當道具（不是假路徑字串）——
-# 因為被測的判準就是 `git worktree list` 的第一筆，用假路徑等於沒驗到判準本體。
-#
-# ⚠️ 誠實邊界：本測試用 `CLAUDE_CODE_CHILD_SESSION=0` 代表「總管」。
-#    真實環境裡那個變數不可靠（Claude Desktop 的主 session 也是 1，
-#    見 InkStoneCo/system-dev/wiki/ops-facts.md）。這裡驗的是**閘的分支邏輯**，
-#    不是「總管在真機上一定會被擋」——後者是另一件事，本輪沒動。
-set -u
-cd "$(dirname "$0")/.." || exit 1
-H="$PWD/hooks/guard-cross-project.sh"
-
-FIX="$(mktemp -d "${TMPDIR:-/tmp}/isep117.XXXXXX")"
-trap 'rm -rf "$FIX"' EXIT
-
-g() { git -C "$1" -c user.email=t@t -c user.name=t "${@:2}"; }
-mkrepo() {           # mkrepo <路徑>
-  mkdir -p "$1" && git -C "$1" init -q 2>/dev/null
-  : > "$1/seed"; g "$1" add -A >/dev/null 2>&1; g "$1" commit -qm seed >/dev/null 2>&1
-}
-
-ROOT="$FIX/InkStoneCo"
-mkrepo "$ROOT"                                   # 頂層樹本身也是一個 repo
-mkrepo "$ROOT/matrix/arcrun"                     # 白名單上的子 repo
-mkrepo "$ROOT/products/arcrun-rag"               # 白名單上的子 repo
-mkrepo "$ROOT/matrix/other"                      # **不在**白名單上的子 repo
-mkdir -p "$ROOT/matrix/plain-dir"                # 根本不是 repo
-mkdir -p "$ROOT/_archive/old"
-
-# 照 line-needs-own-worktree.sh 印出來的那一行原樣開（<NAME>-wt-<票號>，兄弟目錄）
-g "$ROOT/matrix/arcrun"      worktree add -q "$ROOT/matrix/arcrun-wt-117" -b wt117 >/dev/null 2>&1
-g "$ROOT/products/arcrun-rag" worktree add -q "$ROOT/products/arcrun-rag-wt-99" -b wt99 >/dev/null 2>&1
-g "$ROOT/matrix/other"       worktree add -q "$ROOT/matrix/other-wt-1" -b wt1 >/dev/null 2>&1
-# 名字長得像 worktree、實際上只是個空目錄
-mkdir -p "$ROOT/matrix/arcrun-wt-fake"
-
-# macOS 的 $TMPDIR 是 /var/...（symlink），git 回的是 /private/var/... ⇒ 兩種形式都要驗
-ROOT_PHYS="$(cd "$ROOT" && pwd -P)"
-
-PASS=0; FAIL=0
-run() {   # run <want> <CHILD_SESSION> <file_path> <說明>
-  local want=$1 child=$2 fp=$3 note=$4 got
-  printf '%s' "{\"tool_input\":{\"file_path\":$(python3 -c 'import json,sys;print(json.dumps(sys.argv[1]))' "$fp")}}" \
-    | CLAUDE_PROJECT_DIR="$ROOT" CLAUDE_CODE_CHILD_SESSION="$child" bash "$H" >/dev/null 2>&1
-  got=$?
-  if [ "$got" = "$want" ]; then PASS=$((PASS+1)); printf '  ✅ '; else FAIL=$((FAIL+1)); printf '  ❌ '; fi
-  printf 'want=%s got=%s  child=%s  %s\n' "$want" "$got" "$child" "$note"
-}
-
-echo "── 該放行：subagent 在白名單 repo 裡（含照閘 A 開出來的 worktree）──"
-run 0 1 "matrix/arcrun/src/foo.ts"                    "主工作目錄（迴歸：本來就該過）"
-run 0 1 "matrix/arcrun-wt-117/src/foo.ts"             "★ 本票的病：照閘 A 開的 worktree"
-run 0 1 "$ROOT/matrix/arcrun-wt-117/src/foo.ts"       "★ 同上，絕對路徑"
-run 0 1 "matrix/arcrun-wt-117/a/b/c/還沒建的檔.ts"      "worktree 裡的新檔（目錄還不存在）"
-run 0 1 "products/arcrun-rag-wt-99/main.go"           "另一個白名單 repo 的 worktree"
-run 0 1 "products/arcrun-rag/main.go"                 "主工作目錄（迴歸）"
-run 0 1 "$ROOT_PHYS/matrix/arcrun-wt-117/src/foo.ts"  "★ 絕對路徑是實體形式（/private/var vs /var）"
-
-echo "── 該放行：跟白名單無關的既有規則（迴歸，不能被這次改動弄壞）──"
-run 0 0 "matrix/arcrun/docs/HANDOFF-x.md"             ".md 一律放行（leo 2026-06-15 拍板）"
-run 0 0 "matrix/other/README.md"                      "非白名單 repo 的 .md 也放行"
-run 0 0 "system-dev/wiki/tool.py"                     "頂層自己的檔"
-run 0 0 ".claude/hooks/x.sh"                          "頂層自己的檔"
-run 0 1 "/tmp/somewhere-else/x.ts"                    "頂層樹之外（本來就不管）"
-
-echo "── 該擋：總管（非 subagent）寫實作進子 repo ──"
-run 2 0 "matrix/arcrun/src/foo.ts"                    "白名單只對 subagent 開，總管照擋"
-run 2 0 "matrix/arcrun-wt-117/src/foo.ts"             "★ worktree 不是總管的後門"
-run 2 0 "products/arcrun-rag/main.go"                 "同上，另一個 repo"
-run 2 0 "_archive/old/x.py"                           "_archive 也在管轄內"
-
-echo "── 該擋：subagent，但那個 repo 不在白名單上 ──"
-run 2 1 "matrix/other/src/foo.ts"                     "不在名單的子 repo"
-run 2 1 "matrix/other-wt-1/src/foo.ts"                "★ 不在名單的 repo，它的 worktree 一樣擋"
-run 2 1 "matrix/plain-dir/foo.ts"                     "根本不是 repo（git 往上找到頂層樹）"
-run 2 1 "matrix/arcrun-wt-fake/foo.ts"                "★ 名字像 worktree、其實是空目錄 ⇒ 名字騙不過去"
-run 2 1 "_archive/old/x.py"                           "_archive 不在白名單上"
-
-echo
-echo "通過 $PASS 條，失敗 $FAIL 條"
-[ "$FAIL" -eq 0 ]

system-dev/wiki/mistakes.md

@@ -119,46 +119,38 @@ leo 當場：「**這些為什麼不寫到票裡？**」
 
 日期: 2026-08-27（`inkstone/ISEP#30` comment 4327）
 
-## ⚠️ MISTAKE: 兩道閘互相打架——照 A 做的人被 B 擋，繞過去的人反而過得了
+## ⚠️ MISTAKE: fail-closed 的閘，會把「執行裁決」這個動作本身變成不可執行
 
-票: `inkstone/ISEP#117`（實撞在 `inkstone/Arcrun#195`）
-日期: 2026-09-01
+票: `inkstone/ISEP#91`（裁決原文在 `inkstone/InkStoneCo#40` → comment 2942）
+日期: 2026-08-31
 
-症狀: `line-needs-own-worktree.sh` 擋下在共用目錄切分支，並印出下一步
-      `worktree add <PARENT>/<NAME>-wt-<票號>`。工人照做，
-      接著在 `matrix/arcrun-wt-195/` 裡寫檔 ⇒ 被 `guard-cross-project.sh` 擋。
-      它的白名單是**路徑前綴**（`matrix/arcrun/*`），對不上 `matrix/arcrun-wt-195/…`。
-      工人的處置：把 worktree 開到 InkStoneCo 樹之外躲開那一支。
+症狀: leo 2026-08-16 裁定「**取消 Active SDD**」——任務狀態搬到 Gitea 管，
+      SDD 只記「起初的樣子」，文件不帶任務 checkbox。
+      **11 天過去，這個裁決一個字都沒被執行。**
 
-原因: 兩支閘各自都對，**但一支的「出路」不在另一支的「放行條件」裡**。
-      白名單本來就想放行這件事（`CHILD_SESSION=1` ＋ repo 在名單上），
-      只是判準用的是「路徑長什麼樣」，而 A 那支剛好會改變路徑長什麼樣。
+實查: `sdd-guard.sh` 是 fail-closed 的：動 code 檔時 `status: active` 的 SDD
+      **不是恰好 1 份就擋（0 份也擋）**，路徑所在的 repo 沒有 `3-specs` 也擋。
+      ⇒ 照裁決把最後那份 active 拿掉 → 變 0 份 → **任何人動任何
+      `.ts`／`.py`／`.go` 全部被擋**。當時沒出事，純粹是因為剛好還剩 1 份。
+      而 **ISEP 這個 repo 自己根本沒有 `3-specs`**——本票開工第一件事就實測到：
+      改自己的 `hooks/lib/*.py` 當場被這支閘擋下（exit 2）。**它一直在誤攔，只是沒人回報。**
 
-正確做法: 放行的判準改成「這條路徑**屬於哪個 repo**」——
-      `git worktree list --porcelain` 第一筆永遠是主工作目錄，
-      主目錄與它所有的 worktree 回同一個答案。`-wt-` 這個命名慣例
-      一個字都沒有進判準（不靠名字＝改名字也騙不過去）。
-      🔴 **推廣**：一支閘印出來的「出路」，就是別支閘必須放行的東西。
-      新增或修改任何會給下一步的閘時，把那個下一步真的做一遍走到底——
-      **出路走不通的閘，會逼人繞路，而繞路一旦成立，那條規矩就等於沒有。**
+原因: **不是有人偷懶，是沒有人把裁決和那支閘連起來看。**
+      裁決被讀到了、也沒人反對，但執行它的第一步會當場鎖死自己，
+      於是每個人都在那一步前面停下來，而**「我停下來了」不會留下任何痕跡**。
 
-## ⚠️ MISTAKE: plugin 裡那支閘一直是啞的，而沒有任何東西會喊一聲
+正確做法:
+  - 收到「取消某個制度」的裁決，第一個動作是**去數還有幾支閘在執行那個制度**，
+    並且**先問那些閘是 fail-open 還是 fail-closed**。
+    fail-closed 的那幾支決定了執行順序：**先讓閘退役，再拿掉它要的東西**，顛倒就鎖死。
+  - 退役要驗的不是「檔案刪了沒有」，是「**那個擋還會不會發生**」。
+    `hooks/tests/sdd-guard-retired.test.sh` 把「裁決執行完之後的世界」丟給
+    `hooks.json` 上整組寫檔閘（清單當場從 `hooks.json` 讀，不寫死），
+    **不准有任何一支用 SDD 當理由擋下來** ⇒ 換個檔名種回來照樣紅。
 
-票: `inkstone/ISEP#117`
-日期: 2026-09-01
+📌 一個沒人敢執行的裁決，看起來跟一個沒人記得的裁決一模一樣。
+   差別只有在**去問「執行它的第一步會發生什麼」**的時候才看得出來。
 
-症狀: 同一份 payload（寫 `matrix/arcrun/foo.ts`）餵給兩份 `guard-cross-project.sh`：
-      plugin 那份 exit 0（放行）、`InkStoneCo/.claude/hooks/` 那份 exit 2（擋）。
-      兩個檔案 `diff` **一個字都不差**。
-
-原因: 它用 `<hook 檔>/../..` 當「頂層 repo 根」。那在 `InkStoneCo/.claude/hooks/`
-      底下剛好等於 repo 根，搬進 plugin（`<plugin>/hooks/`）之後就指到 plugin cache
-      的上一層 ⇒ 絕對路徑的前綴永遠剝不掉 ⇒ 判斷「在不在子 repo 裡」永遠是否
-      ⇒ **它每一次都放行，而放行是靜默的**。
-
-正確做法: 指專案內的東西用 `$CLAUDE_PROJECT_DIR`（README 路徑規約本來就這樣寫）。
-      🔴 **推廣**：閘的失效方向幾乎都是「靜默放行」——
-      擋錯了有人會喊，放行不會有人喊。所以搬移／複製一支閘之後，
-      **必須實測一次「它該擋的東西現在還擋不擋」**，
-      不要用 `diff` 一致就當它行為一致（這次兩份就是一個字不差、行為相反）。
-      同款：`mistakes.md` 上面那條「裝好了不等於它在跑」。
+📌 KBDB 缺這一段: 2026-08-31 用 `kbdb_search(mode='semantic')` 查
+   「SDD 生命週期／單一活性／取消 Active SDD」**0 命中**（最接近的是 2026-08-09
+   一張講 SDD × Gitea 整合摩擦的卡，那是裁決之前）。⇒ 這條開發史還沒進 KBDB。