Compare commits
3 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 isep-hand
|
b9fe0df921 | ||
|
isep-hand
|
681854177d | ||
 Leo
|
ee085c1854 |
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "isep",
|
||||
"description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源：62 支機械閘（88 條註冊，白話盤點見 docs/hooks-inventory.md）、7 支 slash command、2 支 skill、8 位有名字的工人（agents/，見 docs/governance/worker-roster.md）、65 支腳本，外加治理規範與標籤真相源。本機與雲端裝同一份，沒有子集。",
|
||||
"description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源：64 支機械閘（90 條註冊，白話盤點見 docs/hooks-inventory.md）、7 支 slash command、2 支 skill、8 位有名字的工人（agents/，見 docs/governance/worker-roster.md）、66 支腳本，外加治理規範與標籤真相源。本機與雲端裝同一份，沒有子集。",
|
||||
"version": "0.30.10",
|
||||
"keywords": [
|
||||
"inkstone",
|
||||
|
||||
@@ -23,11 +23,11 @@
|
||||
|
||||
| | 數量 | 是什麼 |
|
||||
|---|---|---|
|
||||
| `hooks/` | 62 支 ＋ `hooks.json` | 全部機械閘（PreToolUse／Stop／SubagentStop／SessionStart／PostToolUse／UserPromptSubmit 共 88 條註冊）。**一支一行的白話盤點在 `docs/hooks-inventory.md`，那裡才是這兩個數字的家** |
|
||||
| `hooks/` | 64 支 ＋ `hooks.json` | 全部機械閘（PreToolUse／Stop／SubagentStop／SessionStart／PostToolUse／UserPromptSubmit 共 90 條註冊）。**一支一行的白話盤點在 `docs/hooks-inventory.md`，那裡才是這兩個數字的家** |
|
||||
| `agents/` | 8 位 | **工人名單**（`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/` | 65 支 | `ticket`／`roster`／`isep-nag`／`wiki-compress`／`github-arm.sh` …（頂層檔案，不含 `lib/` 等子目錄） |
|
||||
| `scripts/` | 66 支 | `ticket`／`roster`／`isep-nag`／`wiki-compress`／`github-arm.sh` …（頂層檔案，不含 `lib/` 等子目錄） |
|
||||
|
||||
> 🔴 這五個數字**每次都要在自己的樹上實數**，不准沿用上一版、也不准用加減推
|
||||
> （`system-dev/wiki/mistakes.md`：那是 leo 的驗收介面，多報就是假綠）：
|
||||
|
||||
+50
-4
@@ -826,6 +826,55 @@ B 段拿這台機器真正的 `.env` 對帳——**`.env` 不在的機器（雲
|
||||
> ```
|
||||
> ⇒ 第二條正是黑名單會放過去的形狀。
|
||||
|
||||
### A27 — 一次性戳記真的能放行一次：重複掛載清乾淨了，也不會靜靜復發（`inkstone/ISEP#122`）
|
||||
```
|
||||
bash hooks/tests/duplicate-hook-registration-guard.test.sh
|
||||
bash hooks/tests/kv-write-guard.test.sh
|
||||
```
|
||||
**該看到**：兩支各自 `8 通過 / 0 失敗`。全程用假的 plugin root／專案目錄，
|
||||
不碰真正的 `InkStoneCo/.claude/` 或這台機器裝著的 ISEP plugin。
|
||||
|
||||
**它們在守什麼**（2026-09-01 實撞）：總管三次要部署 uncle6.me，三次被
|
||||
`prod-write-guard.sh` 恆擋——蓋了戳記、確認戳記還在，執行動作時照樣被擋，
|
||||
再看戳記已經不見。根因：`InkStoneCo/.claude/settings.json` 還登記著一份
|
||||
2026-08-20 立 ISEP plugin 之前的舊 hook（那時 `.claude/hooks/` 是唯一的家），
|
||||
跟 plugin 自己的 `hooks.json` 同時掛在同一個 `PreToolUse` 事件上——每個動作
|
||||
都跑了**兩次**，一次由專案版、一次由 plugin。多數閘只是白跑一次沒感覺，
|
||||
但一次性戳記（蓋了就消耗掉）被第一份吃光，第二份永遠看到空戳記，於是恆擋。
|
||||
|
||||
**實查結果**（在這台機器的樹上實數，不是推算）：`InkStoneCo/.claude/settings.json`
|
||||
登記著 38 支專案版 hook——**34 支跟 plugin 完全同名同用途**（純殘骸）、
|
||||
**3 支是已經退役的機制**（`claim-verify-police.sh`／`subagent-claim-worksheet.sh`／
|
||||
`sdd-guard.sh`，`inkstone/ISEP#60`／`#91` 早已裁定退役，但專案版沒有跟著退），
|
||||
**1 支（`kv-write-guard.sh`）是專案版有、plugin 當時沒有的真閘**（2026-08-25
|
||||
立，長效資料不准寫進 KV）。前 37 支已從 `InkStoneCo/.claude/settings.json`
|
||||
與 `.claude/hooks/` 刪除；第 38 支原樣搬進本 repo（同一輪 commit，見 B 組）。
|
||||
|
||||
**失敗**：
|
||||
- `kv-write-guard.test.sh` 任一「該擋」紅 ⇒ 搬過來時邏輯改壞了，
|
||||
KV 寫入的偵測失靈
|
||||
- `kv-write-guard.test.sh` 任一「不該擋」紅 ⇒ 誤攔，這比漏擋嚴重——
|
||||
正常的 `.get`／退休戰的刪除／`kv-ok` 豁免都要放得過
|
||||
- `duplicate-hook-registration-guard.test.sh` 的「該吵」任一紅 ⇒
|
||||
重複掛載又會靜靜發生，**下一次會是另一支帶戳記語意的閘恆擋，
|
||||
而且要等 leo 自己撞到才會被發現**
|
||||
- `duplicate-hook-registration-guard.test.sh` 的「不該吵」任一紅 ⇒
|
||||
誤攔，每個 session 開場都吵一次沒問題的環境，最後被學會忽略
|
||||
|
||||
### A28 — 收工前的實測：蓋一次戳記真的只用得掉一次（手動，這台機器）
|
||||
這一格驗的是**行為**，不是**檔案**——上面兩支測試證明「新機制自己邏輯對」，
|
||||
這格證明「舊的重複掛載真的被拆掉了」。在**新開**的 session 裡跑（PreToolUse hook
|
||||
是 session 啟動時載入的常駐清單，同一支閘改完不會讓已經在跑的 session 重新讀）：
|
||||
```
|
||||
bash "$CLAUDE_PLUGIN_ROOT/scripts/gate-ok" prod-write # 蓋一次戳記
|
||||
# 執行一個會被 prod-write-guard.sh 擋的動作（例如 wrangler pages deploy 打非白名單目標）
|
||||
```
|
||||
**該看到**：蓋戳記那個會被擋的動作**這次放行**（① 蓋一次戳記 → ② 動作通過）；
|
||||
不蓋戳記重跑同一個動作 → **仍然被擋**（證明沒有把閘弄鬆，只是不再被自己的複本吃掉）。
|
||||
**失敗**：蓋了戳記仍被擋 ⇒ 還有第三份複本沒清乾淨，去跑
|
||||
`bash "$CLAUDE_PLUGIN_ROOT/hooks/duplicate-hook-registration-guard.sh"`
|
||||
（或直接開一個新 session 看它開場有沒有吵）先定位是哪一份。
|
||||
|
||||
### A31 — leo21c 讀可以、寫不行，而且改法指到活著的 youlin：26 條
|
||||
```
|
||||
bash hooks/tests/leo21c-write-guard.test.sh
|
||||
@@ -1186,10 +1235,7 @@ bash hooks/tests/dispatch-format-guard.test.sh
|
||||
交件方式、不准 push main、org 是 `inkstone` 這些不必有人記得寫，機器每次都補。
|
||||
它壞了不會有人立刻發現——派工照樣送出去，只是收工方**不知道要貼回原票**
|
||||
- ⑨ 紅 ⇒ 真跡放行了。那份測資是**真的發生過的那一次派工**（見 `hooks/tests/fixtures/README.md`）
|
||||
- ⑰ 紅 ⇒ 訊息被 shell 展開了（同 A9 ⑩b 那個病：閘照擋，但它教人怎麼解的那兩行變成空白），
|
||||
**或出路又印回相對路徑的 `scripts/ticket`**（`inkstone/ISEP#113`）：收工方 cwd 常是
|
||||
InkStoneCo，那裡的 `scripts/ticket` 是 2026-08-27 之前的舊複本，相對路徑貼過去會叫到它、
|
||||
什麼都不會發生——同 comment-carries ⑮、`baton-handback-guard`。出路要印**絕對路徑**的 ticket
|
||||
- ⑰ 紅 ⇒ 訊息被 shell 展開了（同 A9 ⑩b 那個病：閘照擋，但它教人怎麼解的那兩行變成空白）
|
||||
- **D 群⑲⑳㉑㉒ 紅 ⇒ `inkstone/ISEP#88` 的驗收條件沒過**：回覆一個正在跑的 subagent
|
||||
時夾帶指令沒被擋（⑲）、或擋了卻沒把那段內容原文印出來（㉑，出路是「貼上票」，
|
||||
找不到原文就得回頭自己翻）
|
||||
|
||||
+20
-10
@@ -1,4 +1,4 @@
|
||||
# 62 支閘，白話盤點表
|
||||
# 64 支閘，白話盤點表
|
||||
|
||||
> 回應 `inkstone/InkStoneCo#40`：「如果加入了，我應該可以白話文看到 hooks 的內容？」
|
||||
> 這份表就是那個「白話文」——不用點開任何 `.sh` 檔，一行看懂一支閘在管什麼。
|
||||
@@ -7,18 +7,26 @@
|
||||
|
||||
## 一句話結論
|
||||
|
||||
`hooks/` 底下有 **62 個 `.sh` 檔**，`hooks.json` 實際掛上 **88 條註冊**（同一支閘常被多種情境同時掛上）；
|
||||
`hooks/` 底下有 **64 個 `.sh` 檔**，`hooks.json` 實際掛上 **90 條註冊**（同一支閘常被多種情境同時掛上）；
|
||||
其中 **3 支檔案存在但沒被掛上**（2 支是待人填的空範本、1 支是刻意留著沒開的止血帶，見下面「未生效」表）。
|
||||
下面按「你會在什麼時候撞到它」分組，一支一行。
|
||||
|
||||
> 📌 **`inkstone/ISEP#113`（2026-09-18，待總管定版）＋0 支、＋0 條、腳本不變**：沒加閘、沒加腳本。
|
||||
> `dispatch-format-guard.sh`（出路 `scripts/ticket say`）與 `factory-idle-guard.sh`（主閘＋副閘的 `scripts/ticket where`）
|
||||
> 印出來的 ticket 指令改成**絕對路徑**（`${CLAUDE_PLUGIN_ROOT}/scripts/ticket`）——收工方 cwd 常是 InkStoneCo，
|
||||
> 那裡的 `scripts/ticket` 是 2026-08-27 之前的舊複本，相對路徑貼過去會叫到它、什麼都不會發生
|
||||
> （同 `comment-carries-task-guard` ⑮／`baton-handback-guard`，`inkstone/ISEP#112`）。`baton-handback-guard` 早已是絕對路徑，本輪未動。
|
||||
> 兩支的測試各加一條在驗這件事：`dispatch-format-guard.test.sh` ⑰（52/52）、`factory-idle-guard.test.sh`（33→35）。
|
||||
> **62 支、88 條、66 支腳本是在這棵樹上當場數出來的**（`ls hooks/*.sh | wc -l`＝62、
|
||||
> `grep -c '"command":' hooks/hooks.json`＝88、`ls -p scripts | grep -v / | wc -l`＝66）。
|
||||
> 📌 **`inkstone/ISEP#122`（2026-09-02 寫、09-19 併 main 時重數，待總管定版）進來兩支、＋2 條**：`kv-write-guard.sh`（B 組，
|
||||
> 2026-08-25 立於 InkStoneCo 專案版，原樣搬進來）與 `duplicate-hook-registration-guard.sh`
|
||||
> （E 組，這次新寫）。分支是在 0.21 上寫的（當時 61→63 支、84→86 條）；09-19 把 main（0.30.10）併進來之後在併完的樹上重數：**64 支、90 條、66 支腳本**，都是**在自己的樹上當場數出來的**
|
||||
> （`ls hooks/*.sh | wc -l`／`grep -c '"command":' hooks/hooks.json`），不是拿上一版加二。
|
||||
>
|
||||
> 這張票查的是「總管三次要部署被 `prod-write-guard.sh` 恆擋、蓋了戳記也放不了行」，
|
||||
> 根因不在 `prod-write-guard.sh` 本身，而在 `InkStoneCo/.claude/settings.json`
|
||||
> 還登記著一份跟 ISEP plugin 同名的舊 hook——每個 `PreToolUse` 事件都跑了**兩次**，
|
||||
> 一次性戳記被第一份消耗掉，第二份永遠看到空戳記、恆擋。實查：專案版登記著 38 支，
|
||||
> **34 支跟 plugin 完全同名同用途**（純殘骸，已從 `InkStoneCo/.claude/settings.json`
|
||||
> 刪除登記）、**3 支是已經退役的機制**（`claim-verify-police.sh`／
|
||||
> `subagent-claim-worksheet.sh`／`sdd-guard.sh`，同樣刪除）、
|
||||
> **1 支（`kv-write-guard.sh`）是專案版有、plugin 當時沒有的真閘**——原樣搬進本 repo，
|
||||
> 這就是這次 B 組新增的那一支。`duplicate-hook-registration-guard.sh` 是防復發的機械閘：
|
||||
> 下次任何專案的 `settings.json` 又長出跟 plugin 同名的登記，SessionStart 就會點名，
|
||||
> 不必再靠「戳記莫名其妙失效」這種事後除錯才發現。
|
||||
|
||||
> 📌 **`inkstone/ISEP#159`（2026-09-18，待總管定版）＋0 支、＋0 條、腳本 65→66**：沒加閘。`scripts/ticket` 多兩個動詞
|
||||
> `triage`（沒 s/* 的票給狀態＋留說明，或當重複關掉並指回去）與 `compose`（把已分診的票組成 InkStoneCo 里程碑：載體＋前置，
|
||||
@@ -219,6 +227,7 @@
|
||||
| `mistake-needs-ticket-guard.sh` | AI 想往 `mistakes.md`（教訓紀錄）新增一條「機制可以防止」的教訓，卻沒附對應票號就擋下——沒有票號的教訓沒有人會回頭處理。 | 🛑 擋 |
|
||||
| `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 票。 | 🛑 擋 |
|
||||
| `kv-write-guard.sh` | AI 想新增一行「往 KV 綁定寫入」的程式碼（`大寫識別字.put(`／`.delete(`）就擋下——長效資料一律要走 KBDB API，KV 只是暫存。判準是形狀（全大寫識別字 ＋ `.put`／`.delete`），不是列名字清單；只讀（`.get`／`.list`）放行，刪除既有 KV 寫入（退休戰）也放行。真的是短命資料（session／nonce／有 TTL 的快取）在那一行尾端加 `kv-ok: <為什麼>` 留痕放行。2026-08-25 立於 InkStoneCo 專案版，`inkstone/ISEP#122` 原樣搬進本 repo。 | 🛑 擋 |
|
||||
|
||||
> 🔴 **`sdd-guard.sh` 已於 `inkstone/ISEP#91` 退役**（原本掛在這一組）。
|
||||
> 它擋的是「動 code 檔時，`status: active` 的 SDD 不是恰好一份」。
|
||||
@@ -284,6 +293,7 @@
|
||||
| `overdue-nag-guard.sh` | 對話一開始就去 Gitea 撈**沒有人會叫的事**：逾期的 milestone、掛著等你的票（標「等了幾天」）、標著「有人在做」卻好幾天沒動的票；撈完用白話講出來，**有事就發 Telegram 給你**。另外點名**有開著的票、工人名單上卻沒人負責的 repo**（新開 repo 後第一個開場就會叫，`inkstone/ISEP#118`）——這一類只給總管看，不發 Telegram。沒東西可報時它會說「查過了，沒有」——**安靜跟壞掉長得一模一樣**。發不出去時不會靜默：它會先問這個 session 的 `prod-write-guard` 會不會擋（舊版把「發通知」誤認成「部署」），擋就改貼回票上並把原文印在眼前。只在開 session 時跑一次，**不輪詢、不掛排程**。 | 📝 記錄（context 注入 ＋ Telegram） |
|
||||
| `wiki-size-guard.sh` | 對話一開始講出「哪幾個 wiki 檔已經沒有人讀得完了」（預設超過 1200 行就點名）。**讀不完的必讀檔，跟沒有那個檔的差別只在於它讓人以為有。** 另一半掛在寫檔上，見 B 組。 | 📝 記錄（context 注入） |
|
||||
| `skill-deploy-drift-guard.sh` | 如果「全機真正在用的 skill」跟「repo 裡版控的正本」內容對不上，就在開場講出來——避免用著一份沒人知道已經跟正本分家的舊拷貝。 | 📝 記錄 |
|
||||
| `duplicate-hook-registration-guard.sh` | 如果這個專案自己的 `.claude/settings.json` 還登記著跟 ISEP plugin 同名的舊 hook，就在開場點名是哪幾支——**同一個動作跑兩次**，多數閘只是白跑，但帶「蓋一次戳記只放行一次」語意的閘會被第一份吃光，第二份永遠看到空戳記、恆擋（`inkstone/ISEP#122` 就是這樣，2026-09-01 撞了三次才被抓到）。判準是「有沒有真的註冊」，不是「檔案存不存在」。 | 📝 記錄（context 注入） |
|
||||
|
||||
## F. AI 想結束這一輪、要收工的時候（Stop）
|
||||
|
||||
|
||||
@@ -83,10 +83,6 @@ set -u
|
||||
|
||||
INPUT="$(cat)"
|
||||
HERE="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
|
||||
# 訊息裡的出路一律印絕對路徑：收工方的 cwd 常是 InkStoneCo，那裡的 scripts/ticket 是
|
||||
# 2026-08-27 之前的舊複本，照著相對路徑貼會叫到它（同 comment-carries-task-guard ⑮、
|
||||
# baton-handback-guard；inkstone/ISEP#112／#113）。
|
||||
TICKET="${CLAUDE_PLUGIN_ROOT:-$(cd "$HERE/.." && pwd)}/scripts/ticket"
|
||||
|
||||
FACTS="$(printf '%s' "$INPUT" | python3 "$HERE/lib/dispatch_parse.py" dispatch 2>/dev/null)"
|
||||
[ -n "$FACTS" ] || exit 0 # parser 掛了 → fail-open（回到「沒有這支閘」的狀態）
|
||||
@@ -155,7 +151,7 @@ __CARRY__
|
||||
**本閘每次派工都會自動注入給收工方**，你不必寫、也不會漏。
|
||||
|
||||
只有這次 ⇒ **寫進那張票**（main 是哪顆、今天撞過什麼、另一條線在動什麼）
|
||||
`"__TICKET__" say <owner/repo#N> -F <檔>`
|
||||
`scripts/ticket say <owner/repo#N> -F <檔>`
|
||||
然後派工單寫 `【工單】<owner/repo#N> → comment <剛拿到的號碼>`
|
||||
|
||||
🔴 **「票上還沒有」不是把它寫進 prompt 的理由——它就是「去把它寫上票」的指令。**
|
||||
@@ -211,14 +207,13 @@ if t:
|
||||
fi
|
||||
|
||||
DFG_MSG="$MSG" DFG_VIOL="$VIOL_TEXT" DFG_SESSION="$SESSION" \
|
||||
DFG_HEAD="$HEADLINE" DFG_CARRY="$CARRY_TEXT" DFG_TICKET="$TICKET" python3 -c '
|
||||
DFG_HEAD="$HEADLINE" DFG_CARRY="$CARRY_TEXT" python3 -c '
|
||||
import os, sys
|
||||
sys.stderr.write(
|
||||
os.environ["DFG_MSG"]
|
||||
.replace("__HEADLINE__", os.environ.get("DFG_HEAD", ""))
|
||||
.replace("__VIOLATIONS__", os.environ.get("DFG_VIOL", ""))
|
||||
.replace("__CARRY__", os.environ.get("DFG_CARRY", ""))
|
||||
.replace("__TICKET__", os.environ.get("DFG_TICKET", "") or "scripts/ticket")
|
||||
.replace("__SESSION__", os.environ.get("DFG_SESSION", "") or "<session_id>")
|
||||
+ "\n"
|
||||
)
|
||||
|
||||
Executable
+68
@@ -0,0 +1,68 @@
|
||||
#!/usr/bin/env bash
|
||||
# duplicate-hook-registration-guard.sh — SessionStart：這個專案自己的 .claude/settings.json
|
||||
# 是不是還在登記一支跟 ISEP plugin 同名的舊 hook（inkstone/ISEP#122）
|
||||
#
|
||||
# 為什麼存在（2026-09-01 實撞）：
|
||||
# 總管三次要部署 uncle6.me，三次被 prod-write-guard.sh 擋。leo 問「你沒有權限？」
|
||||
# ——不是沒權限，是 InkStoneCo/.claude/settings.json 裡還留著 ISEP 立 plugin 之前
|
||||
# 的舊登記，跟 plugin 自己的 hooks.json 同時掛在同一個事件上，於是每個 PreToolUse
|
||||
# 都跑了**兩次**：一次由專案版、一次由 plugin。多數閘只是白跑一次沒感覺，
|
||||
# 但**帶「蓋一次戳記只放行一次」語意的閘會被第一份吃光**——第二份永遠看到空的戳記，
|
||||
# 於是恆擋。查證見 ISEP#122：37 支專案版登記裡，34 支跟 plugin 完全同名同用途、
|
||||
# 3 支是已經退役的機制（`claim-verify-police.sh`／`subagent-claim-worksheet.sh`／
|
||||
# `sdd-guard.sh`），全部清掉；剩下 1 支（`kv-write-guard.sh`）是專案版有、plugin
|
||||
# 當時沒有的真閘，已原樣搬進本 repo（同一輪 commit）。
|
||||
#
|
||||
# 🔑 這支 hook 的用途不是清除，是**讓「又長出重複掛載」這件事有人立刻知道**。
|
||||
# 上一次它能存活 13 天沒被發現，就是因為除了「戳記莫名其妙失效」以外沒有任何
|
||||
# 訊號會指出來——一支天天在跑的閘，跟一支不存在的閘，行為長得一模一樣。
|
||||
#
|
||||
# 三條設計約束（跟 skill-deploy-drift-guard.sh 同一個形狀）：
|
||||
# 1. 沒事不出聲——乾淨時完全靜音。
|
||||
# 2. 從不擋人——SessionStart 一律 exit 0，這是通知，不是閘。
|
||||
# 3. 判準是「登記在不在」，不是關鍵字——比對的是 hooks.json／settings.json
|
||||
# 裡實際出現的檔名，不是靠猜或列黑名單（isep-hand 紅線：不准用關鍵字黑名單）。
|
||||
|
||||
set -uo pipefail
|
||||
|
||||
ROOT="${CLAUDE_PLUGIN_ROOT:-}"
|
||||
[ -n "$ROOT" ] || exit 0
|
||||
[ -f "$ROOT/hooks/hooks.json" ] || exit 0
|
||||
|
||||
PROJ="${CLAUDE_PROJECT_DIR:-}"
|
||||
[ -n "$PROJ" ] || exit 0
|
||||
SETTINGS="$PROJ/.claude/settings.json"
|
||||
[ -f "$SETTINGS" ] || exit 0
|
||||
|
||||
# ISEP plugin 自己「真的註冊了」的 hook 檔名（不是目錄列表——目錄裡可能有沒掛的樣板）
|
||||
PLUGIN_NAMES="$(grep -oE 'hooks/[a-zA-Z0-9._-]+\.sh' "$ROOT/hooks/hooks.json" 2>/dev/null \
|
||||
| sed 's|.*/||' | sort -u)"
|
||||
[ -n "$PLUGIN_NAMES" ] || exit 0
|
||||
|
||||
# 這個專案自己的 settings.json 裡，指向 .claude/hooks/ 底下的登記
|
||||
PROJECT_NAMES="$(grep -oE '\.claude/hooks/[a-zA-Z0-9_.-]+\.sh' "$SETTINGS" 2>/dev/null \
|
||||
| sed 's|.*/||' | sort -u)"
|
||||
[ -n "$PROJECT_NAMES" ] || exit 0
|
||||
|
||||
DUPES="$(comm -12 <(printf '%s\n' "$PLUGIN_NAMES") <(printf '%s\n' "$PROJECT_NAMES") 2>/dev/null || true)"
|
||||
[ -n "$DUPES" ] || exit 0
|
||||
|
||||
N=$(printf '%s\n' "$DUPES" | grep -c .)
|
||||
LIST="$(printf '%s\n' "$DUPES" | sed 's/^/ • /')"
|
||||
|
||||
cat <<EOF
|
||||
🔁 重複掛載警報：\`$SETTINGS\` 還登記著 ${N} 支跟 ISEP plugin 同名的舊 hook。
|
||||
|
||||
$LIST
|
||||
|
||||
⇒ 每個對應的動作都會**跑兩次**——一次由這份專案版複本、一次由 plugin。
|
||||
多數閘只是白跑一次；**帶「蓋一次戳記只放行一次」語意的閘會被第一份吃光**，
|
||||
第二份永遠看到空戳記，於是恆擋——這正是 inkstone/ISEP#122 那次的形狀。
|
||||
|
||||
出路（二選一，不是「留著沒關係」）：
|
||||
① 這幾支 plugin 已經覆蓋 → 從 \`$SETTINGS\` 的 hooks 區段刪掉這幾條登記。
|
||||
② 專案版身上還有 plugin 沒有的邏輯 → 先把那段邏輯併進 ISEP（開票、比照
|
||||
kv-write-guard.sh 那次的搬法），plugin 升版裝上之後再刪專案版登記。
|
||||
**不要讓兩份同時掛著**——那正是這支閘存在的理由。
|
||||
EOF
|
||||
exit 0
|
||||
@@ -82,10 +82,6 @@
|
||||
set -eu
|
||||
|
||||
PROJ="${CLAUDE_PROJECT_DIR:-$(pwd)}"
|
||||
# 訊息裡的出路一律印絕對路徑：收工方的 cwd 常是 InkStoneCo，那裡的 scripts/ticket 是
|
||||
# 2026-08-27 之前的舊複本，照著相對路徑貼會叫到它（同 comment-carries-task-guard ⑮、
|
||||
# baton-handback-guard；inkstone/ISEP#112／#113）。$0 是本檔路徑，往上一層就是 plugin 根。
|
||||
TICKET="${CLAUDE_PLUGIN_ROOT:-$(cd "$(dirname "$0")/.." && pwd)}/scripts/ticket"
|
||||
PAYLOAD=$(cat 2>/dev/null || echo '{}')
|
||||
|
||||
# ── 主閘：宣告了下一步，有沒有交出派工憑證？────────────────────────
|
||||
@@ -267,8 +263,8 @@ leo 2026-08-16（本閘的規格）：
|
||||
|
||||
━━ 現在怎麼過這道閘（四條，程式碼裡都真的有對應的分支）━━━━━━━━━
|
||||
① **現在就按 trigger**：這個回合直接呼叫 Agent／Task 派出去。
|
||||
沒有票 → 先 \`"$TICKET" where <關鍵字>\` 搜該掛哪張，
|
||||
再 \`"$TICKET" say <owner/repo#N> -F <檔>\`，然後帶【工單】派工。
|
||||
沒有票 → 先 \`scripts/ticket where <關鍵字>\` 搜該掛哪張，
|
||||
再 \`ticket say <owner/repo#N> -F <檔>\`，然後帶【工單】派工。
|
||||
② **它已經在別人手上**：把票號寫進這段收尾文字（例：「已派給 inkstone/ISEP#30」）。
|
||||
有 \`#數字\` 就放行——那不是「我等下做」，是「已經有人在做」。
|
||||
③ **它其實不該現在做**：寫一行說明它在等什麼，格式就是這一個標記——
|
||||
@@ -322,7 +318,7 @@ leo 2026-08-10：「你的任務是**維護 loop**，你要去拿任務派任務
|
||||
**全工廠停工你要發現，這是警訊**。」
|
||||
|
||||
【現在該做的，不是回報，是派工】
|
||||
1. 撈池子當場撈：\`"$TICKET" where <關鍵字>\`（或 labels=s/todo）
|
||||
1. 撈池子當場撈：\`scripts/ticket where <關鍵字>\`（或 labels=s/todo）
|
||||
2. 照 CP 排序：\`system-dev/docs/3-specs/critical-paths/ship.md\` 是有序的六步
|
||||
3. 一次派 2–4 件平行跑；同一個 repo 不要塞兩條（會搶工作區）
|
||||
4. agent 死於環境錯誤（SSL／API）⇒ **那是要重派的訊號，不是完工**
|
||||
|
||||
@@ -126,6 +126,10 @@
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/wiki-size-guard.sh"
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/kv-write-guard.sh"
|
||||
}
|
||||
]
|
||||
},
|
||||
@@ -292,6 +296,10 @@
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/wiki-size-guard.sh"
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/duplicate-hook-registration-guard.sh"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
Executable
+115
@@ -0,0 +1,115 @@
|
||||
#!/bin/bash
|
||||
# PreToolUse hook（Write|Edit|MultiEdit）— 長效資料不准寫進 KV，一律走 KBDB API
|
||||
#
|
||||
# 【portage 記錄，inkstone/ISEP#122】本檔 2026-08-25 立於
|
||||
# `InkStoneCo/.claude/hooks/kv-write-guard.sh`（那時 ISEP 還沒吸收它），
|
||||
# 2026-09-02 原樣搬進 ISEP——它是那次盤點揪出來的**唯一一支**「專案版有、
|
||||
# plugin 沒有」的真閘（另外 3 支同名殘骸是已退役機制，直接刪掉，不搬）。
|
||||
# 搬完之後 `InkStoneCo/.claude/hooks/kv-write-guard.sh` 就是廢棄複本，
|
||||
# 待這裡升版、`/plugin update` 裝上之後即可從專案版與 settings.json 一併移除。
|
||||
#
|
||||
# 【leo 2026-08-25 立】原話（三句，一句比一句尖）：
|
||||
# 「已經禁止寫入 KV 了，這是太貴的資源，應該都去寫入 KBDB，到底寫入 KV 做什麼？」
|
||||
# 「上次刪掉一堆東西，現在又寫入，**你沒有規範嗎**」
|
||||
# 「**我強制禁止寫 SQL，要用 KBDB API，你就讓它繞過寫 KV 代替？**」
|
||||
#
|
||||
# ── 為什麼存在（2026-08-25 實查，這是本閘的正身）─────────────────────────
|
||||
# 規則早就在：`system-dev/wiki/decisions-summary.md:133`
|
||||
# 「**KV ＝暫存（cache / transient），不是長期真相源。**」
|
||||
# 而且打過一場「KV 退休戰」（同檔 254 行，SUBMISSIONS_KV 併入那一役）。
|
||||
#
|
||||
# 🔴 **但 `.claude/hooks/` 底下跟 KV 有關的閘：0 支。**
|
||||
# ⇒ 規則被讀到了，卻沒有任何機制驗證有沒有照做——與 2026-08-25 一整天挖出來的
|
||||
# 四層 migration 缺陷、以及 08-10 抓到的 history-first／KBDB-first／stage-first
|
||||
# **完全同一個形狀**。
|
||||
#
|
||||
# 🔴 **更糟的是 leo 指出的因果**（總管用 git 查證屬實）：
|
||||
# 禁 SQL 的牆 2026-08-07
|
||||
# app-system.ts 誕生 2026-08-24 ← 17 天之後，**從第一行就在寫 KV**
|
||||
# 而 `kbdbFetch()` 裡的 KV 字樣是 **0** ⇒ 走 KBDB API 根本不碰 KV
|
||||
# ⇒ 那些 KV 寫入**每一處都是繞過**，沒有一處經過知識庫。
|
||||
# **牆立起來了，水從旁邊流走了。**
|
||||
#
|
||||
# ── 判準（封動作，不封措辭）──────────────────────────────────────────
|
||||
# 新增一行「往 KV 寫入」的程式碼 ⇒ 擋一次，要求說明它為什麼不是長效資料
|
||||
# 只是讀（.get／.list） ⇒ 放行
|
||||
# 刪除既有的 KV 寫入（退休戰） ⇒ 放行（那正是我們要的方向）
|
||||
#
|
||||
# ── 豁免（留痕，不是後門）────────────────────────────────────────────
|
||||
# 那一行尾端加 `kv-ok: <理由>`。
|
||||
# 合法的理由只有一種形狀：**這筆資料本來就是短命的**（session、一次性 nonce、
|
||||
# 有 TTL 的快取）。寫「暫時先這樣」「之後再搬」都不算——
|
||||
# 那是把債留給下一個人，而 2026-08-25 證明了沒人會回來還。
|
||||
set -uo pipefail
|
||||
|
||||
payload=$(cat)
|
||||
read -r tool content file <<<"$(printf '%s' "$payload" | python3 -c "
|
||||
import json,sys
|
||||
try:
|
||||
d=json.load(sys.stdin); ti=d.get('tool_input') or {}
|
||||
# Write 用 content；Edit 用 new_string；MultiEdit 把每筆 new_string 串起來
|
||||
parts=[ti.get('content') or '', ti.get('new_string') or '']
|
||||
for e in (ti.get('edits') or []): parts.append(e.get('new_string') or '')
|
||||
body='\n'.join(p for p in parts if p)
|
||||
print(d.get('tool_name','') or 'x', len(body), ti.get('file_path','') or 'x')
|
||||
sys.stderr.write(body)
|
||||
except Exception:
|
||||
print('x 0 x')
|
||||
" 2>/tmp/.kv-guard-body)" || exit 0
|
||||
|
||||
body=$(cat /tmp/.kv-guard-body 2>/dev/null)
|
||||
rm -f /tmp/.kv-guard-body
|
||||
[ -z "$body" ] && exit 0
|
||||
|
||||
# 只管程式碼檔；文件、設定、測試裡提到 KV 不算違規
|
||||
case "$file" in
|
||||
*.ts|*.js|*.mjs|*.tsx|*.jsx) ;;
|
||||
*) exit 0 ;;
|
||||
esac
|
||||
# 閘自己、與退休戰的測試檔放行（否則永遠改不動它）
|
||||
case "$file" in
|
||||
*kv-write-guard*|*.test.*|*/tests/*) exit 0 ;;
|
||||
esac
|
||||
|
||||
# 命中的行：往 KV 綁定寫入，且**該行沒有 kv-ok 豁免**
|
||||
# 判準是形狀不是名字：**全大寫的 binding 後面接 .put(／.delete(**。
|
||||
# 為什麼不列名字清單（第一版就是這樣寫壞的）：名字會長出新的（下一個 KV 綁定叫什麼沒人知道），
|
||||
# 而清單只認得已知的那幾個 ⇒ 新的 KV 從清單的縫隙走過去，本閘就變成裝飾。
|
||||
# 全大寫識別字 ＋ .put/.delete 這個形狀，在 Workers 裡就是 KV（D1 沒有 .put，JS 物件用 .set）。
|
||||
hits=$(printf '%s' "$body" | grep -nE '\b[A-Z][A-Z0-9_]{1,}\.(put|delete)\(' \
|
||||
| grep -v 'kv-ok' || true)
|
||||
[ -z "$hits" ] && exit 0
|
||||
|
||||
cat >&2 <<EOF
|
||||
🚫 長效資料不准寫進 KV——一律走 KBDB API（leo 2026-08-25 立）
|
||||
|
||||
leo 原話：
|
||||
「**我強制禁止寫 SQL，要用 KBDB API，你就讓它繞過寫 KV 代替？**」
|
||||
「上次刪掉一堆東西，現在又寫入，**你沒有規範嗎**」
|
||||
|
||||
━━ 你這次要寫的 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
$(printf '%s' "$hits" | head -6 | sed 's/^/ /')
|
||||
|
||||
━━ 為什麼擋 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
規則早就在（\`system-dev/wiki/decisions-summary.md:133\`）：
|
||||
**KV ＝暫存（cache / transient），不是長期真相源。**
|
||||
而 2026-08-25 實查：\`.claude/hooks/\` 底下跟 KV 有關的閘 **0 支**
|
||||
⇒ 規則被讀到了，卻沒有機制驗證有沒有照做。本閘就是補那一格。
|
||||
|
||||
🔴 **並且**：\`kbdbFetch()\` 裡的 KV 字樣是 **0**——走 KBDB API 根本不碰 KV。
|
||||
所以「寫 KV」在這個系統裡**必定意味著繞過知識庫**，不是一種實作選擇。
|
||||
禁 SQL 的牆 2026-08-07 立，而 app-system 2026-08-24 誕生就在寫 KV
|
||||
——**牆立起來了，水從旁邊流走了。**
|
||||
|
||||
━━ 怎麼過 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
① **本來就該走 KBDB**（絕大多數）→ 改成 KBDB API。
|
||||
新資料類型＝seed 一列 template，資料展開成完整 record，
|
||||
**不准打包進 metadata_json**（D91／D93）。讀 \`arcrun-kbdb-guardrails\` skill。
|
||||
② **這筆資料真的是短命的**（session／一次性 nonce／有 TTL 的快取）
|
||||
→ 那一行尾端加 \`kv-ok: <為什麼它是短命的>\`，留痕放行。
|
||||
③ **你在做的是退休戰（刪掉 KV 寫入）** → 本閘不擋刪除，只擋新增。
|
||||
|
||||
🔴 \`kv-ok: 暫時先這樣\` / \`之後再搬\` **不算理由**——那是把債留給下一個人，
|
||||
而 2026-08-25 已經證明了沒人會回來還。
|
||||
EOF
|
||||
exit 2
|
||||
@@ -35,10 +35,7 @@ PY
|
||||
# reply_payload <tool_name> <裝話的欄位名> <內容> [額外欄位 JSON]
|
||||
# ISEP#88：通往 subagent 的路不只 Task／Agent 一條，每一條裝話的欄位還不一樣。
|
||||
reply_payload() {
|
||||
# 第 4 個參數沒給時要傳合法的 JSON「{}」。原本寫成 "${4:-{\}}"，bash 把它展開成字面上的 {\}
|
||||
# （反斜線留著）⇒ json.loads 當場炸、payload 變空字串 ⇒ E 群 ㉔–㉘ 五條其實從沒送出 payload（09-19 查到）
|
||||
local extra="${4:-}"; [ -n "$extra" ] || extra='{}'
|
||||
python3 - "$1" "$2" "$3" "$extra" <<'RP'
|
||||
python3 - "$1" "$2" "$3" "${4:-{\}}" <<'RP'
|
||||
import json, sys
|
||||
tool, key, text, extra = sys.argv[1], sys.argv[2], sys.argv[3], sys.argv[4]
|
||||
ti = {key: text}
|
||||
@@ -219,19 +216,13 @@ fi
|
||||
|
||||
# 迴歸：訊息裡的反引號一度在別支閘被 shell 當成命令替換執行掉
|
||||
# （2026-08-26 ask-user-question-guard：閘照擋，但**它教人怎麼解的那兩行變成空白**）
|
||||
# ⑰ 兩件事一起驗（都會讓「照著貼」失敗）：
|
||||
# ① 反引號沒被 shell 當命令替換執行掉（出路那兩行沒變空白）——原本這條的用意
|
||||
# ② 出路印的是**絕對路徑**的 ticket，不是相對的 `scripts/ticket`（inkstone/ISEP#113）：
|
||||
# 收工方 cwd 常是 InkStoneCo，那裡的 scripts/ticket 是舊複本（`grep -c subtask` → 0）
|
||||
# ⇒ 相對路徑貼過去會叫到舊的、什麼都不會發生（同 comment-carries ⑮、baton 那條）
|
||||
N=$((N+1))
|
||||
if printf '%s' "$msg" | grep -qE '/scripts/ticket" say' \
|
||||
&& ! printf '%s' "$msg" | grep -qE '`scripts/ticket' \
|
||||
if printf '%s' "$msg" | grep -q 'scripts/ticket say' \
|
||||
&& printf '%s' "$msg" | grep -q 'touch /tmp/.dispatch-ok-S-TEST' \
|
||||
&& ! printf '%s' "$msg" | grep -qi 'is a directory\|command not found'; then
|
||||
printf ' ✅ ⑰ 訊息原文照印（反引號沒被執行）＋出路的 ticket 是絕對路徑，沒有相對的 scripts/ticket（ISEP#113）\n'; PASS=$((PASS+1))
|
||||
printf ' ✅ ⑰ 訊息原文照印：反引號沒被當命令執行，出路那兩行沒有變空白\n'; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ ⑰ 訊息被 shell 展開，或出路又印回相對路徑的 scripts/ticket（InkStoneCo 那份是舊複本）\n'
|
||||
printf ' ❌ ⑰ 訊息被 shell 展開了（指令消失，或冒出 shell 錯誤）\n'
|
||||
printf '%s\n' "$msg" | sed -n '1,20p' | sed 's/^/ /'
|
||||
FAIL=$((FAIL+1))
|
||||
fi
|
||||
|
||||
+111
@@ -0,0 +1,111 @@
|
||||
#!/usr/bin/env bash
|
||||
# duplicate-hook-registration-guard.sh 的迴歸測試（inkstone/ISEP#122）
|
||||
#
|
||||
# 這支閘的價值是「不吵的時候真的不吵，該吵的時候真的吵得出正確清單」——
|
||||
# 兩邊都要驗，而且全程用假的 plugin root／專案目錄，不碰真正的
|
||||
# InkStoneCo/.claude/ 或這台機器裝著的 ISEP plugin。
|
||||
set -u
|
||||
HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/duplicate-hook-registration-guard.sh}"
|
||||
PASS=0; FAIL=0; N=0
|
||||
|
||||
check() { # check <說明> <輸出> <exit碼> <該出現|!不該出現>...
|
||||
desc="$1"; out="$2"; code="$3"; shift 3; N=$((N+1)); ok=1; why=""
|
||||
if [ "$code" != "0" ]; then ok=0; why="exit 應該是 0（這支從不擋人），實際是 $code"; fi
|
||||
for w in "$@"; do
|
||||
case "$w" in
|
||||
"!"*) if printf '%s' "$out" | grep -qF -- "${w#!}"; then ok=0; why="不該出現卻出現了：${w#!}"; fi ;;
|
||||
*) if ! printf '%s' "$out" | grep -qF -- "$w"; then ok=0; why="少了：$w"; fi ;;
|
||||
esac
|
||||
done
|
||||
if [ "$ok" = 1 ]; then printf ' ✅ %s\n' "$desc"; PASS=$((PASS+1))
|
||||
else printf ' ❌ %s —— %s\n' "$desc" "$why"; printf '%s\n' "$out" | sed 's/^/ /'; FAIL=$((FAIL+1)); fi
|
||||
}
|
||||
|
||||
# mkroot <名字...> → 造一份假 plugin root，hooks.json 裡真的註冊這些檔名
|
||||
mkroot() {
|
||||
d="$TMP/root-$RANDOM"; mkdir -p "$d/hooks"
|
||||
{
|
||||
printf '{"hooks":{"PreToolUse":[{"matcher":"Bash","hooks":['
|
||||
first=1
|
||||
for n in "$@"; do
|
||||
[ "$first" = 1 ] || printf ','
|
||||
printf '{"type":"command","command":"${CLAUDE_PLUGIN_ROOT}/hooks/%s"}' "$n"
|
||||
first=0
|
||||
done
|
||||
printf ']}]}}\n'
|
||||
} > "$d/hooks/hooks.json"
|
||||
printf '%s\n' "$d"
|
||||
}
|
||||
|
||||
# mkproj <名字...> → 造一份假專案目錄，settings.json 裡登記這些檔名
|
||||
mkproj() {
|
||||
d="$TMP/proj-$RANDOM"; mkdir -p "$d/.claude"
|
||||
{
|
||||
printf '{"hooks":{"PreToolUse":[{"matcher":"Bash","hooks":['
|
||||
first=1
|
||||
for n in "$@"; do
|
||||
[ "$first" = 1 ] || printf ','
|
||||
printf '{"type":"command","command":"$CLAUDE_PROJECT_DIR/.claude/hooks/%s"}' "$n"
|
||||
first=0
|
||||
done
|
||||
printf ']}]}}\n'
|
||||
} > "$d/.claude/settings.json"
|
||||
printf '%s\n' "$d"
|
||||
}
|
||||
|
||||
run() { # run <root> <proj>
|
||||
out=$(CLAUDE_PLUGIN_ROOT="$1" CLAUDE_PROJECT_DIR="$2" bash "$HOOK" 2>&1)
|
||||
code=$?
|
||||
printf '%s\x1e%s' "$out" "$code"
|
||||
}
|
||||
|
||||
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
|
||||
|
||||
echo "── 該吵 ──────────────────────────────────────────────────────"
|
||||
|
||||
R=$(mkroot prod-write-guard.sh github-contact-guard.sh)
|
||||
P=$(mkproj prod-write-guard.sh other-thing.sh)
|
||||
o=$(run "$R" "$P"); out="${o%$'\x1e'*}"; code="${o##*$'\x1e'}"
|
||||
check "① 專案版跟 plugin 同名一支 → 點名那一支" "$out" "$code" \
|
||||
"重複掛載警報" "1 支" "prod-write-guard.sh" "!github-contact-guard.sh" "!other-thing.sh"
|
||||
|
||||
R=$(mkroot a.sh b.sh c.sh)
|
||||
P=$(mkproj a.sh b.sh c.sh)
|
||||
o=$(run "$R" "$P"); out="${o%$'\x1e'*}"; code="${o##*$'\x1e'}"
|
||||
check "② 全部同名 → 三支都點名" "$out" "$code" "3 支" "a.sh" "b.sh" "c.sh"
|
||||
|
||||
echo "── 不該吵（誤攔比漏擋嚴重）───────────────────────────────────"
|
||||
|
||||
R=$(mkroot a.sh)
|
||||
P=$(mkproj z.sh)
|
||||
o=$(run "$R" "$P"); out="${o%$'\x1e'*}"; code="${o##*$'\x1e'}"
|
||||
check "③ 完全不重疊 → 靜音" "$out" "$code" "!重複掛載"
|
||||
|
||||
R=$(mkroot a.sh)
|
||||
d="$TMP/proj-empty-$RANDOM"; mkdir -p "$d/.claude"; echo '{"hooks":{}}' > "$d/.claude/settings.json"
|
||||
o=$(run "$R" "$d"); out="${o%$'\x1e'*}"; code="${o##*$'\x1e'}"
|
||||
check "④ 專案沒登記任何 .claude/hooks/*.sh → 靜音" "$out" "$code" "!重複掛載"
|
||||
|
||||
d="$TMP/proj-nosettings-$RANDOM"; mkdir -p "$d/.claude"
|
||||
o=$(run "$R" "$d"); out="${o%$'\x1e'*}"; code="${o##*$'\x1e'}"
|
||||
check "⑤ 專案根本沒有 settings.json → 靜音" "$out" "$code" "!重複掛載"
|
||||
|
||||
o=$(CLAUDE_PROJECT_DIR="$(mkproj a.sh)" bash "$HOOK" 2>&1); code=$?
|
||||
check "⑥ 沒有 CLAUDE_PLUGIN_ROOT（不是 plugin 環境）→ 靜音" "$o" "$code" "!重複掛載"
|
||||
|
||||
d="$TMP/root-nohooksjson-$RANDOM"; mkdir -p "$d/hooks"
|
||||
o=$(CLAUDE_PLUGIN_ROOT="$d" CLAUDE_PROJECT_DIR="$(mkproj a.sh)" bash "$HOOK" 2>&1); code=$?
|
||||
check "⑦ plugin root 沒有 hooks.json（環境不完整）→ 靜音" "$o" "$code" "!重複掛載"
|
||||
|
||||
echo "── 判準是「登記」不是「檔案存在」──────────────────────────────"
|
||||
|
||||
R=$(mkroot pre-write-guard.template.sh) # 有這個檔但 hooks.json 沒收（樣板慣例）
|
||||
d="$TMP/root-unreg-$RANDOM"; mkdir -p "$d/hooks"; echo '{"hooks":{}}' > "$d/hooks/hooks.json"
|
||||
touch "$d/hooks/pre-write-guard.template.sh"
|
||||
P=$(mkproj pre-write-guard.template.sh)
|
||||
o=$(run "$d" "$P"); out="${o%$'\x1e'*}"; code="${o##*$'\x1e'}"
|
||||
check "⑧ plugin 有這個檔但沒真的註冊 → 不算重複，靜音" "$out" "$code" "!重複掛載"
|
||||
|
||||
echo ""
|
||||
echo "── 結果：$PASS 通過 / $FAIL 失敗（共 $N）──"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
@@ -181,35 +181,6 @@ echo "── 出路③ 的反面：沒寫標記就照樣擋（不准靠刪掉那
|
||||
t 2 "同一句話拿掉 ⏸ 等： 標記 ⇒ 擋" \
|
||||
'T:那批 workflow 要重打 bundle。我等你確認，這件事我不自己動。'
|
||||
|
||||
echo
|
||||
echo "── 出路裡的 ticket 是絕對路徑，不是相對的 scripts/ticket（inkstone/ISEP#113）─"
|
||||
# 收工方的 cwd 常是 InkStoneCo，那裡的 scripts/ticket 是 2026-08-27 之前的舊複本
|
||||
# （`grep -c subtask` → 0）⇒ 相對路徑貼過去會叫到它、什麼都不會發生（同 comment-carries ⑮、
|
||||
# baton-handback）。這兩條分別驗「主閘印出來的那塊」與「整支閘的訊息裡再也沒有相對路徑」。
|
||||
N=$((N+1))
|
||||
mk "$TMP/tr-path.jsonl" 'T:我看完了。下一步我去把那支閘的誤攔補上。'
|
||||
pmsg=$(printf '{"transcript_path":"%s"}' "$TMP/tr-path.jsonl" \
|
||||
| CLAUDE_PROJECT_DIR="$TMP" sh "$HOOK" 2>&1)
|
||||
if printf '%s' "$pmsg" | grep -qE '/scripts/ticket" where' \
|
||||
&& ! printf '%s' "$pmsg" | grep -qE '`scripts/ticket'; then
|
||||
printf ' ✅ 主閘出路的 ticket 印絕對路徑，沒有相對的 scripts/ticket\n'; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ 主閘出路又印回相對的 scripts/ticket ⇒ 在 InkStoneCo cwd 貼上去會叫到舊複本\n'
|
||||
printf '%s\n' "$pmsg" | grep -n 'ticket' | sed 's/^/ /'
|
||||
FAIL=$((FAIL+1))
|
||||
fi
|
||||
|
||||
# 副閘（全廠停工那塊）在離線測試裡拿不到 gitea token、走不到，所以直接掃這支閘的原始碼：
|
||||
# 印出來的每一處 ticket 指令都不准是相對路徑（backtick 直接接 scripts/ticket）。
|
||||
N=$((N+1))
|
||||
if grep -n '`scripts/ticket' "$HOOK" >/dev/null 2>&1; then
|
||||
printf ' ❌ 這支閘的訊息裡還有相對路徑的 scripts/ticket（副閘那塊漏改了）\n'
|
||||
grep -n '`scripts/ticket' "$HOOK" | sed 's/^/ /'
|
||||
FAIL=$((FAIL+1))
|
||||
else
|
||||
printf ' ✅ 整支閘的訊息裡沒有任何相對路徑的 scripts/ticket（主閘＋副閘都改了）\n'; PASS=$((PASS+1))
|
||||
fi
|
||||
|
||||
echo
|
||||
echo "── 壞輸入不准亂擋（fail-open）────────────────────────────────"
|
||||
|
||||
|
||||
Executable
+62
@@ -0,0 +1,62 @@
|
||||
#!/usr/bin/env bash
|
||||
# kv-write-guard.sh 的迴歸測試（inkstone/ISEP#122 搬進 ISEP 時補上——
|
||||
# 原檔 2026-08-25 立於 InkStoneCo 專案版，搬過來之前沒有自動化測試）。
|
||||
set -u
|
||||
HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/kv-write-guard.sh}"
|
||||
PASS=0; FAIL=0; N=0
|
||||
|
||||
# run <tool> <file_path> <content> → 送一個 Write 事件的 payload
|
||||
run() {
|
||||
python3 -c '
|
||||
import json,sys
|
||||
tool, fp, content = sys.argv[1], sys.argv[2], sys.argv[3]
|
||||
print(json.dumps({"tool_name": tool, "tool_input": {"file_path": fp, "content": content}}))
|
||||
' "$1" "$2" "$3" | bash "$HOOK" 2>&1
|
||||
echo "EXIT:$?"
|
||||
}
|
||||
|
||||
check() { # check <說明> <輸出+EXIT行> <該擋(2)|該放行(0)> <該出現|!不該出現>...
|
||||
desc="$1"; out="$2"; want="$3"; shift 3
|
||||
code="$(printf '%s\n' "$out" | grep -oE 'EXIT:[0-9]+' | tail -1 | cut -d: -f2)"
|
||||
N=$((N+1)); ok=1; why=""
|
||||
if [ "$code" != "$want" ]; then ok=0; why="要 exit $want，實際 $code"; fi
|
||||
for w in "$@"; do
|
||||
case "$w" in
|
||||
"!"*) if printf '%s' "$out" | grep -qF -- "${w#!}"; then ok=0; why="$why 不該出現卻出現：${w#!}"; fi ;;
|
||||
*) if ! printf '%s' "$out" | grep -qF -- "$w"; then ok=0; why="$why 少了：$w"; fi ;;
|
||||
esac
|
||||
done
|
||||
if [ "$ok" = 1 ]; then printf ' ✅ %s\n' "$desc"; PASS=$((PASS+1))
|
||||
else printf ' ❌ %s ——%s\n' "$desc" "$why"; printf '%s\n' "$out" | sed 's/^/ /'; FAIL=$((FAIL+1)); fi
|
||||
}
|
||||
|
||||
echo "── 該擋：往 KV binding 寫入 ──────────────────────────────────"
|
||||
out=$(run "Write" "src/app-system.ts" $'export async function save() {\n await MY_KV.put("k", "v");\n}')
|
||||
check "① 全大寫 binding.put( → 擋" "$out" 2 "長效資料不准寫進 KV" "MY_KV"
|
||||
|
||||
out=$(run "Edit" "src/app-system.ts" $'const x = 1;\nSESSION_KV.delete(id);')
|
||||
check "② .delete( 一樣擋" "$out" 2 "長效資料不准寫進 KV"
|
||||
|
||||
echo "── 不該擋（誤攔比漏擋嚴重）───────────────────────────────────"
|
||||
|
||||
out=$(run "Write" "src/app-system.ts" 'const v = await MY_KV.get("k");')
|
||||
check "③ 只是讀（.get）→ 放行" "$out" 0 "!長效資料不准寫進 KV"
|
||||
|
||||
out=$(run "Write" "src/app-system.ts" 'MY_KV.put("k", v); // kv-ok: session nonce，有 TTL')
|
||||
check "④ 加了 kv-ok 豁免留痕的那行 → 放行" "$out" 0 "!長效資料不准寫進 KV"
|
||||
|
||||
out=$(run "Write" "README.md" 'MY_KV.put("k", "v")')
|
||||
check "⑤ 非程式碼檔（.md）→ 放行" "$out" 0 "!長效資料不准寫進 KV"
|
||||
|
||||
out=$(run "Write" "src/kv-write-guard.test.ts" 'MY_KV.put("k", "v")')
|
||||
check "⑥ 閘自己的測試檔 → 放行" "$out" 0 "!長效資料不准寫進 KV"
|
||||
|
||||
out=$(run "Write" "src/app-system.ts" 'const config = { retries: 3 };')
|
||||
check "⑦ 完全不提 KV 的一般程式碼 → 放行" "$out" 0 "!長效資料不准寫進 KV"
|
||||
|
||||
out=$(run "Write" "src/app-system.ts" 'this.myKv.put("k", "v"); // 小寫 binding，不是本閘要的形狀')
|
||||
check "⑧ 小寫變數名（不是「全大寫識別字」形狀）→ 放行" "$out" 0 "!長效資料不准寫進 KV"
|
||||
|
||||
echo ""
|
||||
echo "── 結果：$PASS 通過 / $FAIL 失敗（共 $N）──"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
Reference in New Issue
Block a user