Compare commits
1 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 7af30e97b0 |
@@ -8,7 +8,7 @@
|
||||
"plugins": [
|
||||
{
|
||||
"name": "isep",
|
||||
"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)、49 支腳本,外加治理規範與標籤真相源。本機與雲端裝同一份,沒有子集。",
|
||||
"description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源:51 支機械閘(64 條註冊,白話盤點見 docs/hooks-inventory.md)、7 支 slash command、2 支 skill、27 支腳本,外加治理規範與標籤真相源。本機與雲端裝同一份,沒有子集。",
|
||||
"author": {
|
||||
"name": "Leo",
|
||||
"url": "https://uncle6.me"
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "isep",
|
||||
"description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源:61 支機械閘(85 條註冊,白話盤點見 docs/hooks-inventory.md)、7 支 slash command、2 支 skill、7 位有名字的工人(agents/,見 docs/governance/worker-roster.md)、54 支腳本,外加治理規範與標籤真相源。本機與雲端裝同一份,沒有子集。",
|
||||
"version": "0.22.0",
|
||||
"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",
|
||||
"keywords": [
|
||||
"inkstone",
|
||||
"guardrails",
|
||||
|
||||
@@ -23,11 +23,11 @@
|
||||
|
||||
| | 數量 | 是什麼 |
|
||||
|---|---|---|
|
||||
| `hooks/` | 61 支 + `hooks.json` | 全部機械閘(PreToolUse/Stop/SubagentStop/SessionStart/PostToolUse/UserPromptSubmit 共 85 條註冊)。**一支一行的白話盤點在 `docs/hooks-inventory.md`,那裡才是這兩個數字的家** |
|
||||
| `hooks/` | 62 支 + `hooks.json` | 全部機械閘(PreToolUse/Stop/SubagentStop/SessionStart/PostToolUse/UserPromptSubmit 共 85 條註冊)。**一支一行的白話盤點在 `docs/hooks-inventory.md`,那裡才是這兩個數字的家** |
|
||||
| `agents/` | 7 位 | **工人名單**(`inkstone/ISEP#86`)——派工時指名派給誰,規約見 `docs/governance/worker-roster.md` |
|
||||
| `commands/` | 7 支 | `/wiki-recall` `/wiki-capture` `/cp-write` `/issue-handle` … |
|
||||
| `skills/` | 2 支 | `ship-check`(東西要出去之前)/`deep-recall`(把散落的枝葉還原成一棵樹)。🔴 **這兩支的內容不一定是在這裡寫的**——誰是真相源查 `docs/file-ownership.tsv` |
|
||||
| `scripts/` | 54 支 | `ticket`/`roster`/`isep-nag`/`wiki-compress`/`github-arm.sh` …(頂層檔案,不含 `lib/` 等子目錄) |
|
||||
| `commands/` | 7 支 | `/wiki-recall` `/ship-check` `/cp-write` … |
|
||||
| `skills/` | 2 支 | |
|
||||
| `scripts/` | 49 支 | `ticket`/`roster`/`isep-nag`/`wiki-compress`/`github-arm.sh` …(頂層檔案,不含 `lib/` 等子目錄) |
|
||||
|
||||
> 🔴 這五個數字**每次都要在自己的樹上實數**,不准沿用上一版、也不准用加減推
|
||||
> (`system-dev/wiki/mistakes.md`:那是 leo 的驗收介面,多報就是假綠):
|
||||
@@ -70,13 +70,6 @@ hook 一律用官方的 `${CLAUDE_PLUGIN_ROOT}`,**不准寫死絕對路徑、
|
||||
🔴 **只改這裡,然後兩邊 `/plugin update`。**
|
||||
不要再改 `InkStoneCo/.claude/hooks/`——那個目錄退場中。
|
||||
|
||||
🔴 **但有些檔案的內容不是在這裡寫的**(`inkstone/ISEP#122`):
|
||||
`skills/`/`commands/`/`agents/` 底下有幾個檔案在 InkStoneCo 也有一份,
|
||||
**誰是真相源、往哪個方向修,一律查 `docs/file-ownership.tsv`**,不要憑「ISEP 一定比較新」動手
|
||||
——2026-09-02 實查,兩個方向都真的發生過(`ship-check` 是那邊新,`sdd-check` 是這邊新)。
|
||||
改完那類檔案要把 commit/sha256 兩欄一起更新;沒更新的話,
|
||||
`isep-presence-beacon.sh` 會在下一個 session 開場當著大家的面說它對不上。
|
||||
|
||||
## 這些閘各自在管什麼
|
||||
|
||||
**不用點開任何 `.sh`**——`docs/hooks-inventory.md` 一支一行白話,按「你會在什麼時候撞到它」分組。
|
||||
|
||||
@@ -16,8 +16,6 @@ description: 頂層知識庫的工人——wiki、SDD、Critical Path、決策
|
||||
## 紅線
|
||||
|
||||
- **頂層不寫業務程式碼。** 這一層只放跨專案的整理與判準。
|
||||
- **SDD 不是任務清單**(leo 2026-08-16 取消 Active SDD,`inkstone/InkStoneCo#40`):
|
||||
它只記「起初的樣子」,**不帶 `status:`、不帶任務 checkbox**。任務本體在 Gitea 票。
|
||||
⇒ 不准自行建 SDD,也不准把進度寫回 SDD。
|
||||
- **任何時刻只允許一份 `status: active` 的 SDD**;不准自行建 SDD。
|
||||
- 規格層的變更 ⇒ 開一張 Gitea 票(`Human` + 指派 `Leo` + `s/triage`),不要自己改規格。
|
||||
- 寫給 leo 看的 md 一律**巢狀 bullet**(Logseq outliner),禁表格平攤。
|
||||
|
||||
+41
-57
@@ -1,81 +1,65 @@
|
||||
---
|
||||
name: sdd-check
|
||||
description: |
|
||||
動手前把這件事的來歷讀齊——要寫 code、開新功能、
|
||||
或不確定「這件事當初為什麼長這樣」時自動載入。
|
||||
🔴 Active SDD 已於 2026-08-16 取消(inkstone/InkStoneCo#40):
|
||||
**任務本體在 Gitea 票,不在 SDD**;SDD 只記「起初的樣子」,
|
||||
沒有 status、沒有唯一活性、也不再養任務 checkbox。
|
||||
⇒ 找不到 SDD 不是停下來的理由,找不到票才是;也不要為了動手而現編一份 SDD。
|
||||
開始任何開發任務前確認有沒有對應的 SDD——要寫 code、開新功能、
|
||||
或不確定「這件事屬於哪份規格」時自動載入。
|
||||
依 D35 SDD 生命週期鐵律:任何時刻只允許一份 status: active 的 SDD,
|
||||
所有開發任務對應它的 tasks,找不到就停下來問(不得自行建 SDD);
|
||||
規格層變更改開 Gitea 票(Human+指派 Leo)後停止等 confirm——pending-changes.md 已於 2026-08-19 廢除,禁止寫入。
|
||||
---
|
||||
|
||||
# /sdd-check — 動手前把這件事的來歷讀齊
|
||||
# /sdd-check — 確認當前任務有沒有對應 SDD
|
||||
|
||||
## 先講清楚它現在是什麼
|
||||
|
||||
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 寫入。
|
||||
動手前執行。確保 CC 有全局觀,不會在沒有設計文件的情況下猛衝。
|
||||
|
||||
---
|
||||
|
||||
## 執行流程
|
||||
|
||||
### 第一步:這件事的**票**是哪一張
|
||||
### 第一步:理解任務
|
||||
|
||||
**這一步不能跳,也是唯一會讓你停下來的一步。**
|
||||
確認使用者要做什麼:
|
||||
- 涉及哪個子系統?
|
||||
- 是新功能還是修改現有功能?
|
||||
- 影響範圍?
|
||||
|
||||
- 有票號 → 讀它(含整串留言:裁決、假設、前手交回的下一步都在那裡)
|
||||
- 沒票號 → **先問清楚是哪一張,或先把票開出來**,不要憑一句話開工
|
||||
(`commands/issue-handle.md`:Issue 是唯一任務介面)
|
||||
### 第二步:尋找對應 SDD
|
||||
|
||||
### 第二步:這件事的**來歷**在哪份 SDD
|
||||
在 `docs/3-specs/` 下尋找對應的子系統目錄,確認有沒有:
|
||||
- `design.md`(設計文件)
|
||||
- `tasks.md`(任務清單)
|
||||
|
||||
在 `system-dev/docs/3-specs/` 下找對應子系統的 `design.md`。
|
||||
|
||||
- 找到 → 讀它,弄清楚「當初為什麼這樣設計、有哪些邊界不能動」
|
||||
- **找不到 → 照樣可以動手**。票才是任務本體;
|
||||
沒有 SDD 只代表這塊當初沒有寫下設計,不代表這件事沒被批准
|
||||
|
||||
🔴 **不要為了動手而現編一份 SDD**,也不要去改任何 `status:` frontmatter——
|
||||
那是已經取消的制度的殘留物。
|
||||
|
||||
🔴 **不要把任務 checkbox 寫進 SDD**。要追蹤進度就開票/改票的狀態標籤;
|
||||
寫進文件裡的 checkbox 沒有人會回來關掉它(`inkstone/InkStoneCo#49`
|
||||
清的就是這一批:378 條沒人維護的 checkbox)。
|
||||
|
||||
### 第三步:把讀到的東西講出來再動手
|
||||
|
||||
回覆開頭一行交代即可:
|
||||
### 第三步:根據結果回應
|
||||
|
||||
**情況 A:找到對應 SDD**
|
||||
```
|
||||
📌 票:<owner/repo#N> —— <一句話它要解什麼>
|
||||
📋 來歷:<design.md 路徑,或「這塊沒有 SDD」>
|
||||
🚧 邊界:<這次不准動的東西>
|
||||
✅ 找到 SDD:docs/3-specs/[子系統]/
|
||||
📋 design.md:[確認]
|
||||
📋 tasks.md:[確認,列出相關 task]
|
||||
🎯 對應 task:[編號和描述]
|
||||
繼續嗎?
|
||||
```
|
||||
|
||||
---
|
||||
**情況 B:找不到 SDD,任務明確**
|
||||
```
|
||||
⚠️ 找不到對應 SDD
|
||||
任務:[描述]
|
||||
建議在 docs/3-specs/[建議子系統名]/ 建立 SDD
|
||||
|
||||
## 什麼時候該停下來問
|
||||
要我幫你起草 design.md 嗎?(需要你確認後才動手)
|
||||
```
|
||||
|
||||
只有這幾種,**都跟 SDD 在不在無關**:
|
||||
**情況 C:找不到 SDD,任務模糊**
|
||||
```
|
||||
⚠️ 找不到對應 SDD,而且任務範圍不夠清楚
|
||||
請先回答:
|
||||
1. 這個功能屬於哪個子系統?
|
||||
2. 完成的標準是什麼?
|
||||
3. 有沒有不能動的邊界?
|
||||
```
|
||||
|
||||
- 找不到對應的票,也問不出是哪一張
|
||||
- 票上的要求跟現行規範互相衝突(貼出兩邊出處,給出你的推測,再問)
|
||||
- 命中四題公式:花錢/不可逆/跨專案結構/品味方向
|
||||
### 注意
|
||||
|
||||
其餘情況做出最合理的假設、把假設寫進 commit message 或票的留言,繼續走。
|
||||
- 找不到 SDD **不等於可以直接動手**
|
||||
- 小修改(修 bug、改文字)可以豁免,但要明確說「這是小修改,範圍是 X」
|
||||
- 新功能、架構變動、跨模組的修改 → 一定要有 SDD
|
||||
|
||||
+31
-329
@@ -71,32 +71,15 @@ bash scripts/test-ticket-where-seen-guard.sh
|
||||
人就學會忽略它
|
||||
- 最後那組 `fd_is_devnull` 紅 ⇒ 判準從「fstat 問得出來的事實」滑回猜文字
|
||||
|
||||
### A11 — 討論串裡的任務要長成子票:29 條
|
||||
### A11 — 討論串裡的任務要長成子票:22 條
|
||||
```
|
||||
bash scripts/test-comment-carries-task-guard.sh
|
||||
```
|
||||
**該看到**:`29/29 通過`。全程離線(`TICKET_HOST` 指到連不上的位址),不開任何測試票。
|
||||
**該看到**:`22/22 通過`。
|
||||
**失敗**:
|
||||
- 「該擋」6 條任一紅 ⇒ 08-26 那則真的掉了的留言形狀(「等雲端那半出貨才驗得了」)會漏抓
|
||||
- 「不該擋」10 條任一紅 ⇒ **誤攔,這比漏擋嚴重**——每次留言都被擋,人就學會忽略它
|
||||
- `-F <檔>` 那兩條紅 ⇒ 內文放在檔案裡時閘看不到,等於走 `ticket say` 就自動繞過
|
||||
- **⑮~⑳(`inkstone/ISEP#112`)**:這一組驗的不是「有沒有擋」,是**擋下來之後教的那條路走不走得通**。
|
||||
- ⑮⑯ 紅 ⇒ 訊息又印出相對路徑的 `scripts/ticket`。相對路徑是對**貼上去那個人的 cwd**
|
||||
解析的,而 `InkStoneCo/scripts/ticket` 是舊複本(`grep -c subtask` → 0)
|
||||
⇒ 照著貼會印出它「四個動詞」的說明然後什麼都沒發生。
|
||||
- ⑰ 紅 ⇒ 閘又自己抄了一份用法(它應該去 `ticket usage subtask` 現要)。
|
||||
- **⑱ 紅 ⇒ 最嚴重**:把訊息裡那塊指令原樣抽出來、只填標題/目標/驗收條件三格,
|
||||
**真的執行**,離開碼必須是 1(走到網路才停)。是 2 就表示又被某道閘擋下,
|
||||
這張票的病復發了。
|
||||
- ⑲ 是 ⑱ 的鑑別力對照(把閘原本那組 `--assign` 沒配 `--next` 接回去,必須紅);
|
||||
⑲ 綠不了就代表 ⑱ 那條綠燈沒有意義。
|
||||
- ⑳ 紅 ⇒ 內文草稿模板跟 `REQUIRED_SECTIONS` 分家了,會生出「照著貼卻過不了自己那道閘」的票。
|
||||
- ㉑ 紅 ⇒ 正本叫不動時(雲端裝壞、路徑不對)閘不是不擋了,就是**又在訊息裡補了一份手抄用法**。
|
||||
fail-open 的只准是「訊息內容」,不准是「擋不擋」;而補一份副本就是把這張票拔掉的東西裝回去。
|
||||
|
||||
> 🔴 **這一組刻意驗訊息內容,不是只驗離開碼。** `system-dev/wiki/mistakes.md`
|
||||
> 記過:訊息壞掉時閘照樣 `exit 2`,只看離開碼完全看不出來——
|
||||
> 而這張票(`inkstone/ISEP#112`)就是那個形狀的極端版:**閘擋對了,但它教的解法根本不存在。**
|
||||
- 最後兩條(`-F <檔>`)紅 ⇒ 內文放在檔案裡時閘看不到,等於走 `ticket say` 就自動繞過
|
||||
|
||||
### A12 — 收工要把棒子交回來:10 條
|
||||
```
|
||||
@@ -146,7 +129,7 @@ python3 scripts/pr-verdict merge inkstone/ISEP#71 --dry-run
|
||||
```
|
||||
bash hooks/tests/countdown-guard.test.sh
|
||||
```
|
||||
**該看到**:`通過 20 條,失敗 0 條`。**全程離線**:時鐘用 `ISEP_COUNTDOWN_NOW` 定住、
|
||||
**該看到**:`通過 21 條,失敗 0 條`。**全程離線**:時鐘用 `ISEP_COUNTDOWN_NOW` 定住、
|
||||
狀態走 `ISEP_COUNTDOWN_STATE_DIR`,不打網路、不碰 `$HOME`。
|
||||
|
||||
**它在守什麼**(`inkstone/ISEP#63`,leo 2026-08-27):
|
||||
@@ -330,19 +313,11 @@ bash hooks/tests/unpushed-police.test.sh
|
||||
- B 群(⑦—⑩,該報)任一紅 ⇒ 為了不吵而改成放行了,那是把閘關掉不是修好
|
||||
- 特別看 ④:問不到遠端(離線)**不准當成「你沒推」**
|
||||
|
||||
### A18 — 信標會講出雲端會壞掉的那幾件事:26 條
|
||||
### A18 — 信標會講出雲端會壞掉的那三件事:14 條
|
||||
```
|
||||
bash hooks/tests/isep-presence-beacon.test.sh
|
||||
```
|
||||
**該看到**:`通過 26 條,失敗 0 條`。全離線。
|
||||
|
||||
> 📌 `inkstone/ISEP#122` 從 14 條加到 26 條:信標原本只掃 `scripts/`,
|
||||
> 而**真正會自動載入的東西**(skill/command/agent)同樣兩邊各有一份。
|
||||
> 實查:那 9 個檔案在 `0.1.0`(c263866)複製過來之後**一次都沒再同步**,
|
||||
> 到 2026-09-02 已經分家兩個、而且**方向相反**——
|
||||
> `skills/ship-check/SKILL.md` 是 InkStoneCo 那邊新,`commands/sdd-check.md` 是 ISEP 這邊新。
|
||||
> ⇒ 所以新增的不只是「有沒有掃到」,還有「**說不說得出真相源是哪一份**」
|
||||
> (`docs/file-ownership.tsv`),以及**雲端沒有專案那一份可比時**改用 sha256 單邊驗。
|
||||
**該看到**:`通過 14 條,失敗 0 條`。全離線。
|
||||
|
||||
**它在守什麼**(inkstone/ISEP#90 ②③):信標原本只證明「有一份 plugin 載入了」,
|
||||
不證明「載入的是哪一份」——08-27 雲端載 0.3.9、main 0.9.0,差 7 個 release,
|
||||
@@ -354,112 +329,6 @@ bash hooks/tests/isep-presence-beacon.test.sh
|
||||
- ⑤⑦ 紅 ⇒ 舊複本遮蔽正門抓不到(`InkStoneCo/scripts/ticket` 那件)
|
||||
- ⑥ 紅 ⇒ **誤攔**:同步過的複本被念,人就學會忽略它
|
||||
- ⑪ 紅 ⇒ 內層迴圈變數撞名的回歸(同一個 `.claude` 下第二個殘骸會被靜靜跳過)
|
||||
- ⑮⑱⑲⑳ 任一紅 ⇒ 自動載入的分身抓不到(`ship-check` 那件會再發生一次)
|
||||
- ⑰ 紅 ⇒ **誤攔**:同步過的複本被念,人就學會忽略它(跟 ⑥ 同一條線)
|
||||
- ㉔ 紅 ⇒ 雲端唯一還作數的那個檢查失效(薄殼沒有 InkStoneCo 可以比)
|
||||
- ㉕ 紅 ⇒ **誤攔**:還沒登記 sha256 的檔案被當成「被改過」
|
||||
|
||||
### A29 — 閘印出來的逃生門,照著打真的過得去:10 條
|
||||
> 📌 編號跳過 A27/A28:那兩格被同一張票的 PR `inkstone/ISEP#124` 佔著(還沒併)。
|
||||
```
|
||||
bash hooks/tests/history-first-guard.test.sh
|
||||
```
|
||||
**該看到**:`通過 10 條,失敗 0 條`。全離線,全程用 `KBDB_STAMP_DIR` 指到 TMP,
|
||||
**不碰這台機器真正的 `/tmp/.kbdb-*` 戳記**(清掉別人的戳記=把閘弄成隨機的)。
|
||||
|
||||
**它在守什麼**(`inkstone/ISEP#122`,2026-09-02 實撞):`history-first-guard.sh` 印的
|
||||
`🚪 KBDB 真的連不上:touch /tmp/.kbdb-down 後重送` 是**假的**——
|
||||
`touch` 造出來的是空檔,而那支閘讀的是**檔案內容**當時戳,空字串被當成 0
|
||||
⇒ 「距今 17 億秒」⇒ 永遠不新鮮 ⇒ **照著訊息打完,被一模一樣地擋第二次**。
|
||||
|
||||
🔴 這跟本票 comment 6071、`inkstone/ISEP#125` 是同一句話:
|
||||
**閘印出來的下一步,沒有人實際照著打過一次。**
|
||||
|
||||
**失敗**:
|
||||
- ④ 紅 ⇒ 逃生門又是假的(這是本支唯一分辨得出新舊版的那一格,見檔頭)
|
||||
- ⑦ 紅 ⇒ 逃生門變成永久後門(一次 `touch` 就免疫,過期不算數這件事沒了)
|
||||
- ⑧⑨⑩ 任一紅 ⇒ **誤攔**:文件/新檔/測試檔本來就不該被這支碰
|
||||
|
||||
### A30 — 測試沙盒傳錯參數時要在**複製之前**收手:10 條
|
||||
```
|
||||
bash hooks/tests/hook-sandbox.test.sh
|
||||
```
|
||||
**該看到**:`通過 10 條,失敗 0 條`。全離線。
|
||||
|
||||
**它在守什麼**(`inkstone/ISEP#122`,2026-09-02 實撞,**兩次**):
|
||||
`hooks/tests/lib/hook-sandbox.sh` 的 `hook_sandbox <hook 的檔案路徑>` 舊版**不驗參數**,
|
||||
直接 `cp -R "$(dirname "$1")"`。順手把 repo 根目錄傳進去時:
|
||||
|
||||
```
|
||||
$ bash hooks/tests/main-and-prod-push-guard.test.sh "$PWD"
|
||||
dirname → ~/Documents/tech_projects ← 上一層,不是 hooks/
|
||||
cp -R → 整個 tech_projects(所有 repo、所有 worktree)搬進 mktemp
|
||||
實測 一次 13 GB+一次 10 GB,磁碟可用從 25 GB 掉到 462 MB
|
||||
印出來的 ❌ 沙盒建不起來 ← 只有這一句
|
||||
```
|
||||
|
||||
🔴 **它沒說參數傳錯,也沒說它已經把磁碟寫滿了。**
|
||||
判準用「要求某個東西在場」(`$1` 要是真的檔案;上一層要叫 `hooks`),
|
||||
不是關鍵字比對——兩條任一不成立就在 `mktemp` 之前 `return 1`。
|
||||
|
||||
📌 **正確用法**(兩支需要傳參數的測試,`docs/TESTING.md` 之前沒寫過):
|
||||
```
|
||||
bash hooks/tests/main-and-prod-push-guard.test.sh hooks/main-and-prod-push-guard.sh
|
||||
bash hooks/tests/main-and-prod-push-guard-cross-repo.test.sh hooks/main-and-prod-push-guard.sh
|
||||
bash hooks/tests/prod-write-guard.test.sh hooks/prod-write-guard.sh
|
||||
bash hooks/tests/stage-before-prod-guard.test.sh hooks/stage-before-prod-guard.sh
|
||||
bash hooks/tests/gitea-arm-check.test.sh .
|
||||
```
|
||||
**不傳的後果不是報錯,是假綠**:`prod-write-guard.test.sh` 的 `HOOK="$1"` 空掉時
|
||||
每一條都執行空指令回 0 ⇒ 「該擋」全部變成「實得 pass」,**19 條假紅**
|
||||
(同一支傳對參數是 `通過 37 / 失敗 0`)。不必自己傳參數的包裝在
|
||||
`scripts/test-main-and-prod-push-guard.sh`。
|
||||
|
||||
**失敗**:
|
||||
- ①③⑤⑥ 任一紅 ⇒ 收手收得太晚,暫存區已經開始長東西(磁碟風險回來了)
|
||||
- ② 紅 ⇒ 訊息沒給出走得通的那一行(本票整張票在講的就是這件事)
|
||||
- ⑧⑨⑩ 任一紅 ⇒ **誤攔/複製錯**:正常用法被弄壞,或複本裡混進了 `hooks/` 以外的東西
|
||||
### A31 — 雲端工人抓票的規則是機械可判的:48 條
|
||||
```
|
||||
bash scripts/test-ticket-pick.sh
|
||||
```
|
||||
**該看到**:`通過 48 條,失敗 0 條`。**全程離線**:假池子(3 個 repo、3 個 open milestone、
|
||||
11 張票)餵給換掉的 `api()`,時鐘走 `ISEP_COUNTDOWN_NOW`,`TICKET_HOST` 指到連不上的位址
|
||||
——任何一條真的走到網路會當場炸,不會靜靜變成假綠。**不開票、不改票、不留任何東西在 Gitea 上。**
|
||||
|
||||
**它在守什麼**(`inkstone/ISEP#131`):Routine 08-06 起讀 `journeys.md` 本 sprint 段,
|
||||
08-19 到期沒續,**連續兩週讀到殘骸只能空轉**。09-07 把 `cloud-worker.md` 步驟 1 改成從
|
||||
Gitea 主線里程碑抓票(`inkstone/InkStoneCo#118`),但那是一段給人讀的字。
|
||||
這一支把規則做成 `scripts/ticket pick`/`claim` 兩個動詞,規則本體在 `pickable()` 一支純函式:
|
||||
|
||||
```
|
||||
可抓 s/* 恰好是 {s/todo} + 沒有 assignee + 沒有 Human/human/* + 不是 hub + 里程碑=主線
|
||||
主線抓盡才抓「逾期的 open 里程碑」;backlog/沒里程碑一律不抓
|
||||
認領 claim = 指派 + s/doing + 第一行【身份】的留言,一個動作
|
||||
完成 handback --label s/review(本來就有的那半,不重做)
|
||||
```
|
||||
|
||||
**失敗**:
|
||||
- ①「★」那四條任一紅 ⇒ 票上驗收第 1 條破了:Human/有 assignee/backlog 有一種會被抓走
|
||||
- ①「s/todo+s/doing 同時掛著」紅 ⇒ 會把別人正在做的票抓走(09-07 實查 `inkstone/mira#6`
|
||||
就是這個形狀——exclusive 只擋 UI 不擋 API)
|
||||
- ②「主線抓盡 → 才輪到逾期」那兩條紅 ⇒ 順序壞了:要嘛主線還有票就去抓逾期的,
|
||||
要嘛抓盡了還回 `Arcrun#8`(既不是主線也沒逾期)
|
||||
- ②「離開碼 1」紅 ⇒ 「真的沒有票」與「讀不到」被講成同一句——後者要離開碼 2
|
||||
- ②「沒有主線 → 離開碼 2 且一通 API 都沒打」紅 ⇒ 沒主線時去抓了別的
|
||||
- ③「該擋」六條任一紅 ⇒ 規則只長在 `pick` 這端,手動 `claim` 一張 Human 的票照樣過
|
||||
- ③「身份名不在名單上 → 一通都沒打」紅 ⇒ 名單以外的名字碰到了 Gitea
|
||||
- ④ 第一條紅 ⇒ 連不上 Gitea 時回了離開碼 1,雲端會把「斷線」當「沒票」收工
|
||||
|
||||
📌 **真實 Gitea 唯讀實跑**(2026-09-07,isep-hand,不改任何票):
|
||||
`ticket pick --mainline InkStoneCo/system-dev/mainline.json --all` 在主線
|
||||
「AI 問一次就看得到全部」回 `ISEP#130`、`ISEP#131` 兩張(`Arcrun#175/176` 已有 assignee、
|
||||
`Arcrun#86` 是 s/doing、`mira#6` s/todo+s/doing 都沒被抓);逾期里程碑組把 `ISEP#31–35`
|
||||
五張 `hub` 排除後剩 `Arcrun#83`、`mira#5`、`arcrun-rag#14/27/37`。
|
||||
**寫入那半**用 `claim inkstone/ISEP#131 --name isep-hand` 真的認領過一次:
|
||||
assignee=`claude-code`、標籤 `s/todo → s/doing`、留言 6325 第一行【身份】——
|
||||
之後再 `pick` 就不再回 #131(票上驗收第 2 條的 log 在票的留言裡)。
|
||||
|
||||
### A19 — 下游做完時頂層跟著關:49 條
|
||||
```
|
||||
bash scripts/test-ticket-handoff-writeback.sh
|
||||
@@ -646,181 +515,35 @@ D 群同時釘住反面:認不出來(`cd $VAR`、`cd -`、cd 到不是 repo
|
||||
- ① 紅 ⇒ 連總管在自己的目錄裡切分支都被擋。那不是嚴格,那是把共用目錄的主人趕出去
|
||||
- ㉞㉟ 紅 ⇒ `prune` 做錯了。㉞是沒清掉說謊的登記;**㉟是把還在的 worktree 也弄掉了,那是災難**
|
||||
|
||||
### A25 — `sdd-guard` 退役了,而且退乾淨了:8 條
|
||||
### A25 — 照 A24 開出來的 worktree,不會被跨專案閘擋下:21 條
|
||||
```
|
||||
bash hooks/tests/sdd-guard-retired.test.sh
|
||||
bash scripts/test-guard-cross-project.sh
|
||||
```
|
||||
**該看到**:`通過 8 / 失敗 0`。離線,自己開兩顆假 git repo,跑完自己清。
|
||||
**該看到**:`通過 21 條,失敗 0 條`。離線,自己開一棵真的樹(頂層 repo + 4 顆子 repo
|
||||
+ 3 份真的 linked worktree),跑完自動刪掉。
|
||||
|
||||
**它在守什麼**(`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 天沒人敢執行的真正原因。
|
||||
**它在守什麼**(inkstone/ISEP#117,`inkstone/Arcrun#195` 實撞):
|
||||
A24 那支閘印出來的下一步是 `worktree add <PARENT>/<NAME>-wt-<票號>`,
|
||||
而這支閘的白名單原本是**路徑前綴**比對 ⇒ `matrix/arcrun-wt-195/…` 不符合 `matrix/arcrun/*`
|
||||
⇒ **照 A24 的指示做的人被擋,留在共用目錄裡的人反而過得了**。
|
||||
工人當時只能把 worktree 開到 InkStoneCo 樹之外躲開它——**閘把人逼去繞路,那條規矩就等於沒有**。
|
||||
|
||||
🔴 **這支測的不是「檔案刪掉了沒有」,是「那個擋還會不會發生」**:
|
||||
它把「裁決執行完之後的世界」(沒有 `3-specs` 的 repo、有兩份 `status: active` 的 repo)
|
||||
丟給 `hooks.json` 上**整組** `Write|Edit|MultiEdit` 的閘——清單是當場從 `hooks.json` 讀的,
|
||||
不寫死——**不准有任何一支用 SDD/3-specs 當理由擋下來**。
|
||||
⇒ 日後有人換個檔名把同一個形狀種回來,這支照樣紅。
|
||||
修法:白名單比對的是「這個路徑**屬於哪個 repo**」——`git worktree list --porcelain`
|
||||
第一筆永遠是主工作目錄,主目錄與它所有的 worktree 回同一個答案。
|
||||
`-wt-` 這個命名慣例**一個字都沒有出現在判準裡**(不靠名字=改名字也騙不過去)。
|
||||
|
||||
**失敗**:
|
||||
- ②那四條任一紅 ⇒ 裁決又被種回去了。**最要看的是最後一條**(ISEP 自己的 `hooks/lib/*.py`):
|
||||
ISEP 這個 repo 本身就沒有 `3-specs`,退役前那一格是紅的——它是這件事的活體證據
|
||||
- ③紅 ⇒ 條文回來了。有人在 `commands/`/`agents/`/`skills/`/`hooks/` 裡
|
||||
又寫了一次「只准一份 active SDD」,而**條文會被載入,載入就會被照做**
|
||||
- ①的第三條(`hooks.json` 仍是合法 JSON)紅 ⇒ 合併把檔案弄壞了;
|
||||
但**它只證明語法沒壞、不證明閘還在**——閘在不在要另外跑 README 那道逐支點名
|
||||
- ★ 那 6 條任一紅:
|
||||
- 放行那 4 條紅 ⇒ 今天這個誤攔會再發生一次
|
||||
- 「不在名單的 repo,它的 worktree」/「名字像 worktree、其實是空目錄」紅
|
||||
⇒ 判準從「git 回答的事實」滑回「名字看起來像」——那是黑名單的反面,一樣不可靠
|
||||
- 「該擋」那 9 條任一紅 ⇒ 為了修誤攔把該擋的放掉了
|
||||
- 「迴歸」那 5 條任一紅 ⇒ 動到了跟本輪無關的既有規則(`.md` 一律放行、頂層自己的檔)
|
||||
|
||||
📌 **這支只管 ISEP 這一半。** 裁決的另外兩件在 `inkstone/InkStoneCo`:
|
||||
拿掉那份 active SDD + 刪 `CLAUDE.md` 的「單一活性鐵律」段,以及
|
||||
`system-dev/docs/` 底下的任務 checkbox 分診(掛 `inkstone/InkStoneCo#49`)。
|
||||
🔴 **順序不可顛倒**:要等這一版 ISEP 出去、兩邊 `/plugin update` 之後,
|
||||
那半才動得——先拿掉 active SDD 就會鎖死。
|
||||
|
||||
### A26 — 雲端該有的憑證清單,這台機器真的拿得到:11 條
|
||||
```
|
||||
bash scripts/test-make-cloud-env.sh
|
||||
```
|
||||
**該看到**:`11/11 通過,跳過 0 條`(清單現在是 10 把——兩台全給 + 機器帳號 + uncle6 出貨 + Arcrun 出貨線的實例 namespace)。**全程只印變數名字與值的長度,一個字元的值都不印。**
|
||||
A 段用假的 `.env` 隔離跑(不碰真金鑰、不碰 `~/.claude/cloud-env`);
|
||||
B 段拿這台機器真正的 `.env` 對帳——**`.env` 不在的機器(雲端就是)會印 `⏭️ SKIP`**,
|
||||
不算失敗,但也不算驗過。
|
||||
|
||||
**它在守什麼**(inkstone/ISEP#115,2026-09-01 實撞):
|
||||
`make-cloud-env.sh` 的 `NEEDED` 是「雲端總管手上有哪些憑證」的**唯一**清單。
|
||||
那天雲端要清空 youlin,`env | grep -ciE 'cloudflare|^CF_|wrangler'` → **0**——
|
||||
不是雲端漏設,是**這份清單裡從來沒有任何 CF 憑證**。
|
||||
🔴 更貴的是它**發生在流程末端**:工人已經把清空腳本與測試都寫完了,
|
||||
到要真的跑的那一刻才知道跑不了。
|
||||
|
||||
**失敗**:
|
||||
- **B7 紅** ⇒ 清單上有一把這台機器根本拿不到值 ⇒ leo 貼出去的會是
|
||||
`<🔴 找不到>`,而雲端要到**用到那一刻**才知道。這就是 ISEP#115 那一天的形狀
|
||||
- **B8 紅** ⇒ 清單裡混進了值出自 `polaris/mira/.env` 的變數,那是 **leo21c 現役正式環境**。
|
||||
leo 2026-08-20 已把那 7 把分進 B 段並選擇不放(`inkstone/InkStoneCo#14` → comment `3890`)
|
||||
- **B9 紅** ⇒ 清單裡有一把的**值**就是 `CLOUDFLARE_API_TOKEN_leo21c`。
|
||||
leo 2026-09-01 的紅線是「那把不准加」,而 B9 比的是值不是名字 ⇒ **改個名字照樣紅**
|
||||
- **B8x 紅或長期 SKIP** ⇒ B8 的偵測**不會亮**。全綠有兩種可能(真的沒有正式憑證/
|
||||
偵測根本壞了),分不開就等於沒驗
|
||||
- **A5a/A5b 紅** ⇒ 缺值時不會被標成 `<🔴 …>`、收尾也不點名 ⇒ **假綠**,
|
||||
而假綠正是這張票要解的病
|
||||
- **A6 紅** ⇒ 有東西被寫進 repo。那支腳本的產物含金鑰真身,**刻意不在任何 repo 裡**
|
||||
|
||||
> 🔴 **B8 與 B9 的判準都不是名字,是機器算得出來的事實。**
|
||||
> B8 看「值從哪個檔案拿到的」,B9 看「這個值是不是就是 leo21c 那把」。
|
||||
> **兩條是分工不是重複**:`CLOUDFLARE_API_TOKEN_leo21c` 住在**頂層** `.env`,
|
||||
> 不在 `polaris/mira/.env` ⇒ B8 抓不到它,那就是 B9 存在的理由。
|
||||
>
|
||||
> **兩條的「該紅」方向都實跑過**(2026-09-01,拋棄式副本,分支一個字沒動):
|
||||
> ```
|
||||
> 混進 mira 的 NAMESPACE → ❌ B8 …want=0 got=1,並指出「來自 polaris/mira/.env」
|
||||
> 把 leo21c 那把改名 CF_TOKEN_BACKUP → ❌ B9 …want=0 got=1(B8 此時仍綠,因為值不出自 mira)
|
||||
> ```
|
||||
> ⇒ 第二條正是黑名單會放過去的形狀。
|
||||
|
||||
### A31 — leo21c 讀可以、寫不行,而且改法指到活著的 youlin:26 條
|
||||
```
|
||||
bash hooks/tests/leo21c-write-guard.test.sh
|
||||
```
|
||||
**該看到**:`通過 26 條,失敗 0 條`。全程離線,這支閘不寫檔,直接跑真跡。
|
||||
|
||||
**它在守什麼**(inkstone/ISEP#130,2026-09-04 雲端 run log):`leo21c-write-guard.sh`
|
||||
**連讀都擋**——Routine 讀 `notify_leo` 定義那一條被攔下,雲端於是什麼都拿不到。
|
||||
實查:舊判準 `-d[[:space:]]` 把 `| tr -d '\r'`、`cut -d=` 這種唯讀的 `-d` 當成 curl 的 body;
|
||||
`prod-write-guard.sh` 在 08-12 就修過同一個洞,這支漏了。另外它把 `notify_leo` 的 trigger
|
||||
一律當寫入擋,而 `prod-write-guard.sh` 從 ISEP#63 起就放行它——**兩支閘對同一條指令說不同的話**。
|
||||
這支之前**沒有任何測試**,「讀會不會被誤攔」從來沒被驗過。
|
||||
|
||||
測資是 Routine 文件(`cloud-worker.md`/`progress-guard.md`)裡**真的會下的那幾條**。
|
||||
|
||||
**失敗**:
|
||||
- A 群任一紅 ⇒ **誤攔**,雲端又回到「連讀都讀不到」;③④⑤ 紅就是 09-04 那個形狀復發
|
||||
- ⑫ 紅 ⇒ 撞人閘時發 Telegram 叫 leo 又會被擋(inkstone/InkStoneCo#110 的病)
|
||||
- B 群任一紅 ⇒ 寫得進 leo 的真庫(2026-08-20 那 8 張測試卡的病)。⑬ 特別看:
|
||||
Routine 的心跳 POST **就是寫入**,它該被擋——那條指令要改,不是閘要放
|
||||
- ㉔㉕ 紅 ⇒ 閘印的「改法」教人打 09-02 起 DNS 已不存在的舊子網域,照著做只會拿到 000
|
||||
|
||||
**修之前用同一份測試跑舊閘(`git show main:hooks/leo21c-write-guard.sh`)**:③⑤⑫㉔㉕ 五條紅
|
||||
——證明這五格是真的改到了,不是測試順著新閘寫的。
|
||||
|
||||
### A32 — 主線那個檔隨 repo 走:17 條
|
||||
```
|
||||
bash hooks/tests/mainline-repo-mirror.test.sh
|
||||
```
|
||||
**該看到**:`通過 17 條,失敗 0 條`。全程離線:家目錄那份走 `ISEP_COUNTDOWN_STATE_DIR`、
|
||||
repo 那份走 TMP 底下的假 `InkStoneCo/system-dev/`。
|
||||
|
||||
**它在守什麼**(inkstone/ISEP#130;leo 09-05「routine 每天早上開啟後抓不到任務」):
|
||||
主線只住在家目錄,雲端是另一台機器 ⇒ 不知道主線是哪條。PR inkstone/InkStoneCo#118
|
||||
把它放進 `system-dev/mainline.json`,這裡驗 ISEP 這一半:**家目錄沒有就讀 repo 那份;
|
||||
兩份都在 `set_at` 較新的算數;`set`/`adopt`/`clear` 兩份一起動;`refresh` 只寫家目錄。**
|
||||
|
||||
**失敗**:
|
||||
- ①②③ 紅 ⇒ 雲端(`$CLAUDE_PROJECT_DIR` 是薄殼根、真身在 `InkStoneCo/`)仍然讀不到主線
|
||||
- ⑤⑥ 紅 ⇒ 誰後標的誰算數這條壞了:本機會把雲端剛標的蓋回去,或反過來
|
||||
- ⑧ 紅 ⇒ **每開一個 session InkStoneCo 的工作樹就髒一次**,而髒的 diff 沒有人會去 commit
|
||||
- ⑫ 紅 ⇒ `clear` 之後下一次讀又從 repo 那份長回來
|
||||
- ⑮ 紅 ⇒ ISEP#82 第 4 條(沒有主線不能整組壞掉)被本票弄壞
|
||||
|
||||
雲端實跑(2026-09-07,本 session):`CLAUDE_PROJECT_DIR=/home/user/inkstoneco
|
||||
ISEP_COUNTDOWN_STATE_DIR=$(mktemp -d) python3 scripts/mainline` → 印出
|
||||
`🎯 現在的主線:inkstone/Arcrun#48「AI 問一次就看得到全部…」`——家目錄空的,只靠 repo 那份。
|
||||
|
||||
### A33 — 權限白名單住 ISEP 一份、兩台各自寫進家目錄:19 條
|
||||
```
|
||||
bash scripts/test-settings-allow-sync.sh
|
||||
```
|
||||
**該看到**:`19/19 通過`。全程在 TMP 底下的假 `settings.json` 上跑,不碰真的 `~/.claude/settings.json`。
|
||||
|
||||
**它在守什麼**(inkstone/ISEP#130 → comment 6120/6121):leo 09-07 親手加進本機
|
||||
`InkStoneCo/.claude/settings.json` 的四條(`ticket`/`mainline`/`gate-ok`/`gitea-pr-merge`)
|
||||
雲端沒有 ⇒ 同樣動作被分類器擋(09-04 `permission_denials=6`)。雲端真正讀的薄殼 repo
|
||||
要 D20 開閘才推得動 ⇒ 清單住 ISEP `docs/permissions-allow.json`,`scripts/settings-allow-sync`
|
||||
在那台機器上寫進 `~/.claude/settings.json`:雲端由 `docs/cloud-setup-script.sh` 裝完 plugin 跑一次、
|
||||
之後每個 SessionStart 再對一次;本機同一支。
|
||||
|
||||
**失敗**:
|
||||
- A1 紅 ⇒ 清單裡混進了整類放行(`Bash(python3 *)`)或少了正門工具
|
||||
- B3/B4 紅 ⇒ `~` 沒換成那台的家目錄——雲端是 `/root` 不是 `/Users/youlinhsieh`,規則會對不上
|
||||
- B7 紅 ⇒ 不冪等,每個 session 都改一次 settings.json
|
||||
- **C1 紅 ⇒ 動到了別人手加的規則**。這支只准加不准減
|
||||
- E1 紅 ⇒ 目標壞掉時炸了——它掛在 SessionStart,炸了 session 就沒閘
|
||||
- F1/F2 紅 ⇒ 沒接線:清單對了但沒人會去跑它
|
||||
|
||||
⚠️ **這支驗不了「分類器真的不擋」**——那要在雲端一趟 run 裡看 `permission_denials`。
|
||||
規則的形狀(`Bash(python3 …/isep/*/scripts/ticket *)`)沿用 leo 09-07 親手加、實測有效的那四條。
|
||||
|
||||
### A34 — 收件 repo 寫 `owner/repo` 不該是 404:7 條
|
||||
```
|
||||
bash scripts/test-ticket-repo-arg.sh
|
||||
```
|
||||
**該看到**:`通過 7 條,失敗 0 條`。把 `scripts/ticket` 當模組載進來、`api()` 換成只記路徑的假貨——
|
||||
不打 Gitea、不開票、不留戳記。
|
||||
|
||||
**它在守什麼**(inkstone/ISEP#130 → comment 6120 第 2 件):09-07 `ticket new inkstone/ISEP`
|
||||
回 404。不是 ISEP 不存在,是 `inkstone/ISEP` 被原樣塞進 `/repos/inkstone/{repo}/issues`
|
||||
⇒ 打到 `/repos/inkstone/inkstone/ISEP/issues`。**正門壞了人就走側門**——那天四張票是直接打 API 開的。
|
||||
|
||||
**失敗**:② 紅 ⇒ 那個 404 復發;③ 紅 ⇒ 寫錯 org 又變成一個要人猜的 404;⑦ 紅 ⇒ 路徑裡出現 `inkstone/inkstone`。
|
||||
|
||||
### A35 — 雲端唯一通的通知路(Bot API 直送):10 條
|
||||
```
|
||||
bash scripts/test-isep-notify-botapi.sh
|
||||
```
|
||||
**該看到**:`10/10 通過`。Bot API 指到本機一個假伺服器、實例那條也指到它——不打真 Telegram、不打實例。
|
||||
|
||||
**它在守什麼**(inkstone/ISEP#130,2026-09-07 從雲端實測):
|
||||
```
|
||||
notify_leo @ leo21c → HTTP 404「找不到 workflow」(08-28 起就斷;修它是 leo 的人閘)
|
||||
notify_leo @ youlin → 雲端 egress proxy 回 403(policy denial;要 leo 在 Cloud environment 放行主機)
|
||||
api.telegram.org → 302,通
|
||||
```
|
||||
⇒ 雲端唯一走得通的是 Bot API 直送,只缺 `TELEGRAM_BOT_TOKEN`/`TELEGRAM_CHAT_ID` 兩個環境變數。
|
||||
有就先走它(不碰實例,閘管不到也不必管);沒有要**點名缺哪兩個**,不能靜默。
|
||||
|
||||
**失敗**:A1 紅 ⇒ 沒憑證時不講缺什麼,leo 不知道要在 Cloud environment 加哪兩個;
|
||||
B3 紅 ⇒ 送到了還去打實例;C1 紅 ⇒ 401 被講成送到;D1 紅 ⇒ 舊版閘 block 時直送也被連坐。
|
||||
**這支測試自己的誠實邊界**:它用 `CLAUDE_CODE_CHILD_SESSION=0` 代表「總管」。
|
||||
真機上那個變數**不可靠**——`InkStoneCo/system-dev/wiki/ops-facts.md` 記著實測:
|
||||
Claude Desktop 的總管主 session 也是 `1`。⇒ 這裡驗的是**閘的分支邏輯**,
|
||||
不是「總管在真機上一定會被擋」。那是另一件事,本輪沒有動它。
|
||||
|
||||
### A5 — 開票前的搜尋是跨 repo 的
|
||||
```
|
||||
@@ -990,11 +713,9 @@ bash scripts/make-cloud-env.sh
|
||||
|
||||
打開上一步產生的檔,裡面兩塊分別貼進 claude.ai → **Cloud environments** → 你的環境:
|
||||
|
||||
1. **Environment variables**:把 ① 區塊**每一行**都貼進去(一行一個,名字與值分開填)。
|
||||
現在是 2 個:`GITEA_TOKEN_CLAUDE_CODE`(機器帳號 Gitea token)與
|
||||
`CLOUDFLARE_API_TOKEN_YOULIN_CC_USE`(youlin = AI 的 stage 實例)。
|
||||
🔴 **不要照這裡的名字數**——以腳本產出的 ① 區塊為準,這份文件會落後。
|
||||
值全部是**既有的**,一把都沒有新造。
|
||||
1. **Environment variables** 加一個
|
||||
- 名稱:`GITEA_TOKEN_CLAUDE_CODE`
|
||||
- 值:**既有的** claude-code 機器帳號 Gitea token(不要新造一把)
|
||||
2. **Setup script** 欄位:貼進 `docs/cloud-setup-script.sh` 的全文,一字不改。
|
||||
|
||||
**該看到**:儲存後沒有紅字。
|
||||
@@ -1092,18 +813,11 @@ B2(信標那行)/B3(setup 輸出)/B4(閘的訊息)三個畫面
|
||||
| **A12 留言身份欄(兩道門)** | 總管 | ✅ 11/11(2026-08-27) |
|
||||
| **A23 同時跑的線有上限** | isep-guard | ✅ 33/33(2026-08-29,inkstone/ISEP#109) |
|
||||
| **A24 一條線要有自己的工作目錄** | isep-guard | ✅ 35/35(2026-08-29,inkstone/ISEP#109→5391) |
|
||||
| **A26 雲端憑證清單這台拿得到** | isep-hand | ✅ 11/11(2026-09-01,inkstone/ISEP#115→5526/5541/5542/5577)+兩條「該紅」方向實跑 |
|
||||
| **A16 放行的門真的打得開** | 總管 | ✅ 17/17(2026-08-28,inkstone/ISEP#90) |
|
||||
| **A17 未推警察不誤攔雲端分支** | 總管 | ✅ 10/10(2026-08-28,inkstone/ISEP#90) |
|
||||
| **A18 信標會報雲端接線缺陷** | 總管 | ✅ 14/14(2026-08-28,inkstone/ISEP#90) |
|
||||
| **A19 下游做完頂層跟著關** | 總管 | ✅ 49/49(2026-08-28,inkstone/ISEP#92) |
|
||||
| **A31 雲端工人抓票規則機械可判** | isep-hand | ✅ 48/48(2026-09-07,inkstone/ISEP#131)+真實 Gitea 唯讀實跑+一次真認領 |
|
||||
| **A20 舊票有固定管道被撈** | 總管 | ✅ 47/47(2026-08-28,inkstone/ISEP#83)+真實 229 張唯讀實跑 |
|
||||
| **A31 leo21c 讀放寫擋+改法指活的 youlin** | isep-hand | ✅ 26/26(2026-09-07,inkstone/ISEP#130)+舊閘實跑 5 條紅 |
|
||||
| **A32 主線檔隨 repo 走** | isep-hand | ✅ 17/17(2026-09-07,inkstone/ISEP#130)+雲端 session 實跑讀到主線 |
|
||||
| **A33 權限白名單住 ISEP 一份** | isep-hand | ✅ 19/19(2026-09-07,inkstone/ISEP#130);「分類器真的不擋」要雲端 run 的 `permission_denials` 才驗得到 |
|
||||
| **A34 收件 repo 寫 owner/repo 不 404** | isep-hand | ✅ 7/7(2026-09-07,inkstone/ISEP#130) |
|
||||
| **A35 Bot API 直送** | isep-hand | ✅ 10/10(2026-09-07);**真的到 leo 手機**要 Cloud environment 先有 `TELEGRAM_BOT_TOKEN`/`TELEGRAM_CHAT_ID`(leo) |
|
||||
| A7 plugin 裝得起來 | 總管 | ✅ |
|
||||
| **A8 新 session 閘會觸發** | 總管 | 見本版 release note |
|
||||
| **B1–B5 雲端** | **leo** | 還沒跑(機器碰不到 Cloud environment) |
|
||||
@@ -1148,15 +862,3 @@ arcrun_search_workflows(通知 leo Telegram) → 只回 ship_refresh_cdn 一
|
||||
(`#issuecomment-5182`、`#issuecomment-5184`),並把原文印在眼前。
|
||||
**發不出去而靜默,等於沒做;發不出去但講出來並留下退路,就是這支的規格。**
|
||||
通道修好之後不必改任何程式碼,重跑 `python3 scripts/isep-nag --notify` 即可補驗這一格。
|
||||
|
||||
### 2026-09-07 從雲端 session 再量一次(inkstone/ISEP#130)
|
||||
|
||||
| 路 | 結果 | 誰能修 |
|
||||
|---|---|---|
|
||||
| `notify_leo` @ leo21c(`…/webhooks/named/leo/notify_leo`) | **HTTP 404**,跟 08-28 一樣 | leo(leo21c 寫入是人閘) |
|
||||
| `notify_leo` @ youlin(`*.arcrun-yuga3bse.workers.dev`) | **連不到:egress proxy 對 CONNECT 回 403**(`/__agentproxy/status` 記為 policy denial)。不是 DNS、不是 000 | leo(Cloud environment 的 allowed network hosts) |
|
||||
| `api.telegram.org` | **302,通** | — |
|
||||
|
||||
⇒ 雲端能走的只有 Bot API 直送(`scripts/isep-notify` 現在會先試它),缺的只是兩個環境變數
|
||||
`TELEGRAM_BOT_TOKEN`/`TELEGRAM_CHAT_ID`——Routine 文件 `cloud-worker.md` 檔頭本來就列著它們,
|
||||
只是這個 environment 沒有。**這一格仍然是 leo 的:加變數,然後回一個詞。**
|
||||
|
||||
@@ -160,52 +160,6 @@ GitHub、不是 Gitea):
|
||||
驗 `claude plugin list` 顯示 `isep@inkstone enabled`,且照 §逐條對照 那張表
|
||||
再核一次數字。
|
||||
|
||||
## 雲端要全權處理的三樣:票、主線、通知(inkstone/ISEP#130,2026-09-07)
|
||||
|
||||
leo 09-07:「雲端回覆的問題你首要解決⋯⋯僅有需要依賴 Mac 環境的東西要求地端處理,其他全部需要可以從雲端全權處理。」
|
||||
09-04 兩支 Routine 的 run log 實查出四件雲端拿不到的東西,ISEP 這一半的解法:
|
||||
|
||||
| 拿不到什麼 | 為什麼 | ISEP 這一半 | 還缺誰 |
|
||||
|---|---|---|---|
|
||||
| **主線是哪條** | 主線檔只在本機 `~/.claude` | `hooks/lib/mainline.py`:家目錄沒有就讀 repo 的 `InkStoneCo/system-dev/mainline.json`(雲端形狀:`$CLAUDE_PROJECT_DIR` 是薄殼根、真身在 `InkStoneCo/`);`mainline set`/`adopt`/`clear` 兩份一起寫 | 總管 `set` 之後要把 repo 那份 commit/併 main |
|
||||
| **正門工具被分類器擋**(`permission_denials=6`) | leo 09-07 親手加的四條只在本機 settings | `docs/permissions-allow.json` 一份清單;`scripts/settings-allow-sync` 寫進那台的 `~/.claude/settings.json`(setup script 裝完 plugin 跑一次,SessionStart 每次再對一次) | 雲端一趟 run 看 `permission_denials`=0 才算驗到 |
|
||||
| **讀 leo21c 也被擋** | `leo21c-write-guard.sh` 把 `tr -d` 的 `-d` 當 body | 唯讀 `-d` 先剪掉再判;`notify_leo` trigger 放行(同 `prod-write-guard` 白名單);改法段改印現役 youlin 子網域 | — |
|
||||
| **收工摘要到不了手機** | 雲端沒 `TELEGRAM_*`;leo21c 的 `notify_leo` 404;youlin 被 egress proxy 擋 | `scripts/isep-notify` 有 `TELEGRAM_BOT_TOKEN`/`TELEGRAM_CHAT_ID` 就先走 Bot API 直送(`api.telegram.org` 從雲端是通的) | **leo**:在 Cloud environment 加那兩個變數 |
|
||||
|
||||
### 雲端連不到 youlin 不是 000,是 proxy 403(2026-09-07 實查)
|
||||
|
||||
```
|
||||
$ curl -sS -o /dev/null -w '%{http_code}' https://arcrun-cypher-executor.arcrun-yuga3bse.workers.dev/health
|
||||
curl: (56) CONNECT tunnel failed, response 403 ← egress policy denial
|
||||
$ curl -sS "$HTTPS_PROXY/__agentproxy/status" | jq .recentRelayFailures
|
||||
{ "kind": "connect_rejected", "host": "arcrun-cypher-executor.arcrun-yuga3bse.workers.dev:443",
|
||||
"detail": "gateway answered 403 to CONNECT (policy denial or upstream failure)" }
|
||||
$ curl … https://arcrun-cypher-executor.leo21c.workers.dev/health → 200
|
||||
$ curl … https://api.telegram.org/ → 302
|
||||
$ curl … https://git.uncle6.me/api/v1/version → 200
|
||||
```
|
||||
|
||||
⇒ 09-04 log 寫的「youlin 從雲端 HTTP 000」有兩層:舊子網域 `youlin-hsieh-dev` DNS 已死(總管 09-07 查到),
|
||||
**而新子網域從雲端是被 policy 擋**——`/root/.ccr/README.md` 明寫「403/407 = 你組織的 egress policy
|
||||
不允許這個主機,不要重試、不要繞路,回報主機名」。leo21c 通、youlin 不通,差別只在主機有沒有被放行。
|
||||
**這格是 leo 的**:Cloud environment 的 allowed network hosts 加 `*.arcrun-yuga3bse.workers.dev`;
|
||||
在那之前雲端做不了 stage 驗證,所有要打 youlin 的驗證一律交回地端或標 `Human`。
|
||||
|
||||
### 只有「要 Mac」的事才交回地端(給 `cloud-worker.md` 的清單草稿)
|
||||
|
||||
判準一句話:**這件事依賴的東西隨 repo clone 走得到嗎?走得到就雲端做。**
|
||||
|
||||
| 交回地端 | 為什麼雲端做不了 |
|
||||
|---|---|
|
||||
| 打包 DMG/簽章/MS Store 送件 | 要 macOS 工具鏈與簽章身分(Keychain),不隨 clone 走 |
|
||||
| 本機 daemon(`~/.arcrun-rag`、`~/.arcrun/config.yaml`)的改與驗 | 住在 leo 的家目錄 |
|
||||
| 用 `~/.wrangler` OAuth 登入態出貨到 uncle6 | 登入態不隨 clone 走(`make-cloud-env.sh` 檔頭記過) |
|
||||
| 要 leo 親手輸入的互動閘(`acr recipe push` 的暴露同意、密碼打進登入欄) | surface 層硬規則,誰都不能代 |
|
||||
| 打 youlin stage 的驗證 | **暫時**:egress proxy 擋(上一段)。leo 放行主機後這條就回到雲端 |
|
||||
|
||||
其餘(讀票、認領、留言、handback、寫 code、跑測試、開 PR、對 leo21c 唯讀查詢、發 Telegram)雲端全做。
|
||||
📌 這份清單的家是 `inkstone/InkStoneCo` 的 `cloud-worker.md`(票上驗收第 4 條),ISEP 只放草稿;併進去由總管做。
|
||||
|
||||
## 這張票沒動、也不會動的東西
|
||||
|
||||
- 沒有動 `youlinhsieh/inkstoneco`(GitHub 薄殼 repo)——這個新機制**完全不需要
|
||||
|
||||
@@ -28,17 +28,6 @@ set -uo pipefail
|
||||
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
|
||||
|
||||
# 🔴 權限白名單(inkstone/ISEP#130):四個 Gitea 正門工具(ticket/mainline/gate-ok/gitea-pr-merge)
|
||||
# 要進這台的 ~/.claude/settings.json,auto mode 的分類器才不擋(09-04 run log:permission_denials=6)。
|
||||
# 清單住 ISEP `docs/permissions-allow.json` 一份,本機與雲端都由同一支腳本寫——薄殼 repo 不再各養一份。
|
||||
# plugin 快取的路徑帶版本號,挑最新的那份跑;沒裝成也不擋門,SessionStart 會再對一次。
|
||||
ISEP_DIR=$(ls -d "$HOME"/.claude/plugins/cache/inkstone/isep/*/ 2>/dev/null | sort -V | tail -1)
|
||||
if [ -n "$ISEP_DIR" ] && [ -f "$ISEP_DIR/scripts/settings-allow-sync" ]; then
|
||||
python3 "$ISEP_DIR/scripts/settings-allow-sync" 2>&1 || true
|
||||
else
|
||||
echo "⚠️ 找不到裝好的 ISEP,白名單沒寫進 ~/.claude/settings.json——session 開頭 SessionStart 會再試一次。"
|
||||
fi
|
||||
|
||||
if claude plugin marketplace list 2>/dev/null | grep -q "inkstone"; then
|
||||
echo "✅ marketplace inkstone 已就位"
|
||||
else
|
||||
|
||||
@@ -1,30 +0,0 @@
|
||||
# file-ownership.tsv — 同一個檔案兩邊都有時,**哪一份是真相源**(inkstone/ISEP#122)
|
||||
#
|
||||
# 為什麼要有這張表(2026-09-02 實查,兩個方向都真的發生過):
|
||||
# skills/ship-check/SKILL.md InkStoneCo 那份前進到 651 行,ISEP 停在 595 行
|
||||
# commands/sdd-check.md ISEP 那份前進到 81 行,InkStoneCo 停在 65 行
|
||||
# (InkStoneCo 那份還在教已經退役的「唯一 active SDD」)
|
||||
# ⇒ 「ISEP 一定比較新」是錯的,「InkStoneCo 一定比較新」也是錯的。
|
||||
# 兩邊都會被就地編輯,所以歸屬**不能靠人記得**,要寫下來、而且要有東西去比對。
|
||||
#
|
||||
# 誰在用這張表:`hooks/lib/beacon_report.py`(SessionStart 信標,只報告、不擋人)
|
||||
# ① 兩邊內容不同時 → 照這張表講出「真相源是哪一份、該往哪個方向修」
|
||||
# ② 表上有 sha256 時 → 順便驗 ISEP 這份有沒有被就地改過(雲端沒有 InkStoneCo
|
||||
# 可以比,這一格是那時唯一還能作數的檢查)
|
||||
#
|
||||
# 規約三條:
|
||||
# 1. **只有內容會分家的檔案才需要一列。** 兩邊一模一樣時不必登記,信標也不會出聲。
|
||||
# 2. 真相源是 `inkstone/InkStoneCo` ⇒ **內容要改就改在那裡**,改完把檔案原樣搬過來、
|
||||
# 更新 ④⑤ 兩欄、升版。**不要在 ISEP 這邊改內容**(改了兩邊就各自演化,就是本表要解的病)。
|
||||
# 3. 真相源是 `inkstone/ISEP` ⇒ 專案那份是退場中的舊複本,該被同步或刪掉;
|
||||
# ③④⑤ 三欄填 `-`。
|
||||
#
|
||||
# 欄位(TAB 分隔,5 欄):
|
||||
# ① plugin 內路徑
|
||||
# ② 真相源 repo
|
||||
# ③ 真相源在那個 repo 裡的路徑(真相源就是 ISEP 時填 `-`)
|
||||
# ④ 這一份是從哪顆 commit 搬過來的(同上,填 `-`)
|
||||
# ⑤ 搬過來的當下 sha256(同上,填 `-`)
|
||||
#
|
||||
skills/ship-check/SKILL.md inkstone/InkStoneCo .claude/skills/ship-check/SKILL.md bd52fa3a508cbfb29755ddc24923c6fea8c3fbf7 847967830007e804a16dec9adfc5d4120c233445649d4d5cdd34b04550fb3270
|
||||
commands/sdd-check.md inkstone/ISEP - - -
|
||||
|
@@ -853,7 +853,7 @@ scripts/ticket mine [--user <誰>]
|
||||
|
||||
| 閘 | 掛在哪 | 抓什麼 | 測試 |
|
||||
|---|---|---|---|
|
||||
| `hooks/comment-carries-task-guard.sh` | PreToolUse `Bash` | 留言裡帶「等 X 才…/驗不了/還沒…」這種**未完成的未來式**,卻沒開子票 → 擋一次 | `scripts/test-comment-carries-task-guard.sh`(29 條) |
|
||||
| `hooks/comment-carries-task-guard.sh` | PreToolUse `Bash` | 留言裡帶「等 X 才…/驗不了/還沒…」這種**未完成的未來式**,卻沒開子票 → 擋一次 | `scripts/test-comment-carries-task-guard.sh`(22 條) |
|
||||
| `hooks/baton-handback-guard.sh` | PostToolUse `Agent\|Task` | 一條線收工,票上**指派/tag/下一步**缺哪一格 → 當場說出來(提醒,不擋) | `scripts/test-baton-handback-guard.sh`(10 條) |
|
||||
|
||||
🔴 **兩支閘的誤攔設計**:`comment-carries-task-guard` 同一 session 只擋一次,
|
||||
|
||||
+11
-42
@@ -1,4 +1,4 @@
|
||||
# 61 支閘,白話盤點表
|
||||
# 62 支閘,白話盤點表
|
||||
|
||||
> 回應 `inkstone/InkStoneCo#40`:「如果加入了,我應該可以白話文看到 hooks 的內容?」
|
||||
> 這份表就是那個「白話文」——不用點開任何 `.sh` 檔,一行看懂一支閘在管什麼。
|
||||
@@ -7,14 +7,14 @@
|
||||
|
||||
## 一句話結論
|
||||
|
||||
`hooks/` 底下有 **61 個 `.sh` 檔**,`hooks.json` 實際掛上 **85 條註冊**(同一支閘常被多種情境同時掛上);
|
||||
`hooks/` 底下有 **62 個 `.sh` 檔**,`hooks.json` 實際掛上 **85 條註冊**(同一支閘常被多種情境同時掛上);
|
||||
其中 **3 支檔案存在但沒被掛上**(2 支是待人填的空範本、1 支是刻意留著沒開的止血帶,見下面「未生效」表)。
|
||||
下面按「你會在什麼時候撞到它」分組,一支一行。
|
||||
|
||||
> 🔴 **這兩個數字上一版是錯的(2026-08-26 實際數過才發現)**:本頁原本寫「43 個檔、53 條註冊」,
|
||||
> 而當時真實是 **45 個檔、55 條註冊**——中間有兩支閘進來時沒有回頭改這裡。
|
||||
> 現在的寫法是實際數出來的:
|
||||
> `ls hooks/*.sh | wc -l` = 61;`grep -c '"command":' hooks/hooks.json` = 85。
|
||||
> `ls hooks/*.sh | wc -l` = 62;`grep -c '"command":' hooks/hooks.json` = 85。
|
||||
> ⚠️ **冒號不能省**:`grep -c '"command"'`(沒冒號)會連 `"type": "command"` 一起數到,回 **120**。
|
||||
> 本頁 2026-08-27 之前寫的是沒冒號那版——**照著它跑會拿到一個跟本頁不符的數字**。
|
||||
> **一份會偷偷過期的盤點表,跟沒有盤點表差不多**——見本頁最後「怎麼跟實況對帳」那段。
|
||||
@@ -32,13 +32,6 @@
|
||||
> **兩個事件是同一件事的兩半**:只注入 = 又一個會被忽略的提醒;只查核 = 罰它做一件拿不到資料的事。
|
||||
> 這兩個數字是併之前當場數出來的,不是從上一版加減推出來的。
|
||||
|
||||
> 📌 **`inkstone/ISEP#130`(2026-09-07)+0 支、+1 條**:SessionStart 多掛一條
|
||||
> `scripts/settings-allow-sync --quiet`(不是閘,是腳本:把 ISEP 的權限白名單寫進這台的
|
||||
> `~/.claude/settings.json`,雲端才不會每個正門工具都被分類器擋)。
|
||||
> **61 支不變、84→85 條,兩個數字是掛完之後當場數出來的**(`ls hooks/*.sh | wc -l`=61、
|
||||
> `grep -c '"command":' hooks/hooks.json`=85)。同票順手:`leo21c-write-guard.sh` 補了
|
||||
> 唯讀 `-d` 與 notify_leo 的放行、三支閘認得 youlin 09-02 起的新子網域——**都是改判準不是加閘**。
|
||||
|
||||
> 📌 **`inkstone/ISEP#82`(2026-08-28)+1 支、+3 條**:`mainline-focus-guard.sh`
|
||||
> 同時掛在 `Agent` 與 `Task`(派工的兩個入口都要守,只守一個等於沒守),
|
||||
> 加上 SessionStart 多掛一條 `scripts/mainline refresh`(更新主線的進度/期限,不是閘)。
|
||||
@@ -85,12 +78,6 @@
|
||||
> (`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**
|
||||
@@ -129,13 +116,13 @@
|
||||
| `main-and-prod-push-guard.sh` | 兩層確認:① subagent 想推 Gitea `main` 分支 → 一定要交回總管,總管確認過才放行;② 任何 `wrangler deploy` 打正式環境 → 一定要你親手解鎖。 | 🛑 擋 |
|
||||
| `prod-write-guard.sh` | AI 想做任何「會真的改到線上正式帳號(leo21c)」的操作(不只是 push,也包含直接呼叫會寫入的工具)就擋下,交回總管處理。 | 🛑 擋 |
|
||||
| `not-my-branch-guard.sh` | AI 想 commit 到「別的 subagent 正在施工中」的分支(登記在 `branch-holds.md`)就擋下,避免兩個 AI 互踩同一條分支。 | 🛑 擋 |
|
||||
| `leo21c-write-guard.sh` | AI 想寫東西到你私人帳號 `leo21c` 就擋下——這個帳號只准你自己用,AI 的實驗一律走別的測試帳號。**讀一律放行**(含 `tr -d`/`cut -d=` 這種唯讀的 `-d`,09-04 雲端就是被這個誤攔到「連讀都讀不到」),發一則 `notify_leo`(只送訊息、什麼都沒改)也放行——跟 `prod-write-guard.sh` 同一份白名單(inkstone/ISEP#130)。 | 🛑 擋 |
|
||||
| `leo21c-write-guard.sh` | AI 想寫東西到你私人帳號 `leo21c` 就擋下——這個帳號只准你自己用,AI 的實驗一律走別的測試帳號。 | 🛑 擋 |
|
||||
| `release-tag-guard.sh` | AI 想打版本 tag,但 `plugin.json` 裡寫的版本號跟 tag 對不上就擋下——避免「這裡說 0.2.0、那裡說 0.1.0」各說各話。 | 🛑 擋 |
|
||||
| `ticket-api-bypass-guard.sh` | AI 想繞過 `scripts/ticket` 工具、直接打 API 新增 Gitea 東西(開新票/milestone/label/PR,會漏掉「新增前先搜過」這道檢查)就擋下——不管是隱式 POST(urllib 傳 data= 沒寫 method)還是小寫 `requests.post(...)`。 | 🛑 擋 |
|
||||
| `milestone-due-guard.sh` | AI 想開一個新的里程碑(milestone)卻沒填期限就擋下,**填 `9999-01-01` 一樣擋**——那是「沒有期限」穿了一件期限的衣服,盤點時每一格看起來都有值,其實一格都沒有。只管「建里程碑」這個動作,查詢/改別的欄位都放行。 | 🛑 擋 |
|
||||
| `milestone-account-guard.sh` | AI 想直接打 API 把某個里程碑改成「已關閉」,卻**還沒留下「估多久/花多久/差多少/為什麼差」**就擋下。跟上一列是同一條線的兩端:那支管**開**里程碑要有真的期限,這支管**關**的時候要留下帳。走正門 `scripts/milestone-account close` 就會自己算(數字取自 Gitea 的 `created_at`/`due_on`/`closed_at`,不用手填),差超過 ±25% 才要你從**七個固定代號**裡挑一個,而且那個代號要有 Gitea 時間軸撐得住——**不採信自述**。純讀取/建里程碑/改期限/只是談論它/走正門,全部放行;真要手動關就在指令裡加 `milestone-account-ok`(留痕)。 | 🛑 擋 |
|
||||
| `reply-identity-guard.sh` | 直接打 Gitea API 貼留言到票上時,內文第一行沒有 `【身份】`(`總管`/`subagent`/`leo`)就擋下——票上多條線並行時,看不出哪一則是誰寫的。純讀取、走 `scripts/ticket` 正門、指令裡加 `reply-identity-ok` 都放行。 | 🛑 擋 |
|
||||
| `comment-carries-task-guard.sh` | AI 要在票裡留一則「等某某上線才驗得了」這種**還沒做完的事**,卻沒有把它開成一張子票時,擋一次。留言沒人會回頭讀,票的 open/closed 撈一次就看得到。**擋下來時印的是一整塊可以直接貼著跑的指令**(腳本用絕對路徑、母票已經填好、內文草稿附在同一塊裡),那塊字是跟 `scripts/ticket usage subtask` 現要的,不是閘自己抄的一份(`inkstone/ISEP#112`)。 | 🛑 擋(同一輪只擋一次) |
|
||||
| `comment-carries-task-guard.sh` | AI 要在票裡留一則「等某某上線才驗得了」這種**還沒做完的事**,卻沒有把它開成一張子票時,擋一次。留言沒人會回頭讀,票的 open/closed 撈一次就看得到。 | 🛑 擋(同一輪只擋一次) |
|
||||
| `search-is-not-proof-guard.sh` | AI 用知識庫的**搜尋**找到一筆東西,然後把那筆東西的原始編號直接貼進票裡或派工單裡,當成「某個功能壞了」的證據——而它從沒用正規的檢索路徑去查過那筆——擋一次。你關心的是:不會再有人拿錯的方法量出一個錯的結論,然後退回一張其實已經做完的票。 | 🛑 擋(同一輪只擋一次) |
|
||||
| `line-needs-own-worktree.sh` | 一條派工線想在**大家共用的那份工作目錄**裡切分支(`git checkout`/`git switch`)就擋下,叫它先開一份自己的 worktree。你關心的是:不會再有人交回工作時把某個 repo 留在自己的分支上,而下一個人在同一個目錄跑出貨、讀到的是別人留下的 HEAD。**總管在自己的目錄裡切分支不管**(那是他的目錄);已經在自己 worktree 裡的切換全部放行;還原檔案(`git checkout -- 檔`)不管。擋下來的同時會順手把「指向空氣」的 worktree 登記清掉。 | 🛑 擋 |
|
||||
| `diagnosis-evidence-guard.sh` | 你想把一段有份量的東西寫上票,而這個 session **沒派人去查過那張票**、那段話裡也**沒有任何走得過去的出處**(檔案:行號/commit/comment 號/票號/網址/貼出來的實測輸出)就擋一次——未經調查的診斷寫在票上會長得像事實,工人會照著它去驗證而不是去查。派過人查、或把出處帶上,都放行;一句短回覆不管。 | 🛑 擋 |
|
||||
@@ -143,9 +130,10 @@
|
||||
|
||||
| 閘名 | 對你意味著什麼 | 動作 |
|
||||
|---|---|---|
|
||||
| `guard-cross-project.sh` | 總管(頂層)想直接改某個子 repo 的程式碼(非 `.md`)就擋下——頂層只做安排交辦,實作要進那個子 repo 自己做。 | 🛑 擋 |
|
||||
| `guard-cross-project.sh` | 總管(頂層)想直接改某個子 repo 的程式碼(非 `.md`)就擋下——頂層只做安排交辦,實作要進那個子 repo 自己做。白名單上的 repo 給 subagent 動,**連同它照 `line-needs-own-worktree.sh` 開出來的 worktree**(`<repo>-wt-<票號>/`)一起放行——認的是 `git worktree list` 第一筆(這條路徑屬於哪個 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 卻要自己動手改程式碼,就先擋一次,逼它想一想「這件事能不能交給別人做」。 | 🛑 擋 |
|
||||
@@ -153,24 +141,6 @@
|
||||
| `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)
|
||||
@@ -210,9 +180,8 @@
|
||||
|
||||
| 閘名 | 對你意味著什麼 | 動作 |
|
||||
|---|---|---|
|
||||
| `isep-presence-beacon.sh` | 對話一開始印一行 `🟢 ISEP vX.Y.Z 已載入(N 支閘|來源:…)`。**這行不是裝飾,是唯一能證明「這個 session 真的有閘」的東西**——它自己就住在 plugin 裡,看得到它就表示 plugin 載入了;某個 session 從頭到尾沒有這行,那個 session 是零閘狀態,先修 plugin 再做事。同一台機器可能同時有兩份 ISEP(marketplace 裝的、repo 裡 vendor 的),所以那行會講出這次是哪一份在說話。它另外會報四件「這一份是不是還有效」:①這一份落後 ISEP main 幾版 ②專案裡有沒有內容不同的同名**腳本**②b 專案裡有沒有內容不同的同名**skill/command/agent**——這些是**自動載入**的,載到舊的那份不會有任何症狀,只會安靜地教錯的東西(`docs/file-ownership.tsv` 說得出每一組的真相源是哪一份、往哪個方向修)②c 本身的內容跟那張歸屬表對不對得上(雲端沒有專案那一份可比時,這是唯一還作數的檢查)③工作區有沒有已退役機制留下的產物。**全部只講不擋。** | 📝 記錄(context 注入) |
|
||||
| `isep-presence-beacon.sh` | 對話一開始印一行 `🟢 ISEP vX.Y.Z 已載入(N 支閘|來源:…)`。**這行不是裝飾,是唯一能證明「這個 session 真的有閘」的東西**——它自己就住在 plugin 裡,看得到它就表示 plugin 載入了;某個 session 從頭到尾沒有這行,那個 session 是零閘狀態,先修 plugin 再做事。同一台機器可能同時有兩份 ISEP(marketplace 裝的、repo 裡 vendor 的),所以那行會講出這次是哪一份在說話。 | 📝 記錄(context 注入) |
|
||||
| `session-start-recall.sh` | 對話一開始就自動把「全局現況」(Gitea 各 repo 的票、KBDB 的藏書地圖)推到 AI 眼前,不必等它自己想到要查。 | 📝 記錄(context 注入) |
|
||||
| `scripts/settings-allow-sync --quiet` | (不是閘,是腳本)對話一開始把 ISEP 的權限白名單(`docs/permissions-allow.json`:`ticket`/`mainline`/`gate-ok`/`gitea-pr-merge` 四個正門工具)寫進**這台機器**的 `~/.claude/settings.json`。只加不減、冪等;目標檔壞掉就不碰它、講一聲。**為什麼**:leo 09-07 親手加的四條只在本機,雲端沒有 ⇒ 同樣的動作被分類器擋(09-04 run log `permission_denials=6`);薄殼 repo 要 D20 開閘才推得動,所以清單住 ISEP 一份、兩台各自寫進自己的家目錄(inkstone/ISEP#130)。 | 📝 記錄(寫 settings) |
|
||||
| `scripts/mainline refresh` | (不是閘,是腳本)對話一開始把**現在的主線**那條 milestone 的進度與期限更新一次,好讓每回合眼前那一行講的是今天的數字。拿不到 Gitea 就原封不動——**寧可資料舊,不要把主線弄丟**。跑一次就結束,不輪詢。 | 📝 記錄 |
|
||||
| `overdue-nag-guard.sh` | 對話一開始就去 Gitea 撈**沒有人會叫的事**:逾期的 milestone、掛著等你的票(標「等了幾天」)、標著「有人在做」卻好幾天沒動的票;撈完用白話講出來,**有事就發 Telegram 給你**。沒東西可報時它會說「查過了,沒有」——**安靜跟壞掉長得一模一樣**。發不出去時不會靜默:它會先問這個 session 的 `prod-write-guard` 會不會擋(舊版把「發通知」誤認成「部署」),擋就改貼回票上並把原文印在眼前。只在開 session 時跑一次,**不輪詢、不掛排程**。 | 📝 記錄(context 注入 + Telegram) |
|
||||
| `wiki-size-guard.sh` | 對話一開始講出「哪幾個 wiki 檔已經沒有人讀得完了」(預設超過 1200 行就點名)。**讀不完的必讀檔,跟沒有那個檔的差別只在於它讓人以為有。** 另一半掛在寫檔上,見 B 組。 | 📝 記錄(context 注入) |
|
||||
@@ -260,7 +229,7 @@
|
||||
|
||||
| 閘名 | 對你意味著什麼 | 動作 |
|
||||
|---|---|---|
|
||||
| `history-first-guard.sh` | AI 要改一個舊檔案之前,先把這個檔案過去被改過幾次、被誰在什麼情況下改過的紀錄攤在它眼前,逼它回答「這是不是已經修過的老問題」再動手。前面還有第 0 道:這一小時內有沒有問過 KBDB。**KBDB 連不上時 `touch /tmp/.kbdb-down` 就放行**——這條逃生門 2026-09-02 之前是壞的(`touch` 造的是空檔,而它讀的是檔案內容)**照著訊息打完還是被擋**,`inkstone/ISEP#122` 修好並補了迴歸測試。 | 🛑 擋 |
|
||||
| `history-first-guard.sh` | AI 要改一個舊檔案之前,先把這個檔案過去被改過幾次、被誰在什麼情況下改過的紀錄攤在它眼前,逼它回答「這是不是已經修過的老問題」再動手。 | 🛑 擋 |
|
||||
|
||||
---
|
||||
|
||||
@@ -296,8 +265,8 @@ countdown-milestone-refresh.sh ← 假警報:它在 scripts/ 不在 hooks/
|
||||
🔴 **上面那一筆是假警報,不是「指向空氣」的閘**:`inkstone/ISEP#63` 之後,
|
||||
SessionStart 上掛的東西不全是 `hooks/*.sh`——`scripts/countdown-milestone-refresh.sh`
|
||||
是腳本不是閘。這組指令只比檔名、不看目錄,所以它會出現在這裡。
|
||||
(`inkstone/ISEP#82` 又多掛一條 `scripts/mainline refresh`、`inkstone/ISEP#130` 多掛一條
|
||||
`scripts/settings-allow-sync --quiet`,這兩條沒有 `.sh` 副檔名,所以不會落進這個名單。)**照著跑會看到它,這裡先講清楚,
|
||||
(`inkstone/ISEP#82` 又多掛一條 `scripts/mainline refresh`,那一條沒有 `.sh`
|
||||
副檔名,所以不會落進這個名單。)**照著跑會看到它,這裡先講清楚,
|
||||
免得下一個人以為是自己弄壞的。**
|
||||
|
||||
🔴 **上面那兩行驗不出「表格漏列」**——它們比的是 `hooks.json`,不是這張表。
|
||||
|
||||
@@ -1,29 +0,0 @@
|
||||
{
|
||||
"_what": "Claude Code 權限白名單(permissions.allow)的唯一清單——本機與雲端都從這裡讀,不各養一份(inkstone/ISEP#130)",
|
||||
"_why": [
|
||||
"leo 09-07 親手把四個 Gitea 正門工具(ticket/mainline/gate-ok/gitea-pr-merge)加進本機 InkStoneCo/.claude/settings.json,auto mode 的分類器才不擋。",
|
||||
"雲端 session 沒有那四條,同樣的動作照樣被擋(09-04 progress-guard run log:permission_denials=6)。",
|
||||
"薄殼 repo(GitHub)要 D20 開閘才推得動 ⇒ 白名單住 ISEP,`scripts/settings-allow-sync` 開工時寫進那台機器的 ~/.claude/settings.json。",
|
||||
"以後加規則只改這個檔、出一版,雲端下一趟就有。"
|
||||
],
|
||||
"_rules": [
|
||||
"開頭的 `~` 由 settings-allow-sync 換成那台機器的家目錄(本機 /Users/…、雲端 /root),其餘一字不改。",
|
||||
"只放「正門工具」:每一條都要說得出它是哪支腳本的哪種呼叫形狀。不放 Bash(python3 *) 這種整類放行。",
|
||||
"同一支工具幾種呼叫形狀就幾條(快取路徑/$CLAUDE_PLUGIN_ROOT/相對路徑)——權限規則是逐條完全比對,形狀差一個字就落在規則之外(scripts/gate-ok 檔頭記過這一課)。"
|
||||
],
|
||||
"allow": [
|
||||
"Bash(python3 ~/.claude/plugins/cache/inkstone/isep/*/scripts/ticket *)",
|
||||
"Bash(python3 \"$CLAUDE_PLUGIN_ROOT/scripts/ticket\" *)",
|
||||
"Bash(python3 \"$CLAUDE_PLUGIN_ROOT\"/scripts/ticket *)",
|
||||
"Bash(python3 scripts/ticket *)",
|
||||
"Bash(python3 ~/.claude/plugins/cache/inkstone/isep/*/scripts/mainline *)",
|
||||
"Bash(python3 \"$CLAUDE_PLUGIN_ROOT/scripts/mainline\" *)",
|
||||
"Bash(python3 \"$CLAUDE_PLUGIN_ROOT\"/scripts/mainline *)",
|
||||
"Bash(python3 scripts/mainline *)",
|
||||
"Bash(bash ~/.claude/plugins/cache/inkstone/isep/*/scripts/gate-ok *)",
|
||||
"Bash(bash \"$CLAUDE_PLUGIN_ROOT/scripts/gate-ok\" *)",
|
||||
"Bash(bash \"$CLAUDE_PLUGIN_ROOT\"/scripts/gate-ok *)",
|
||||
"Bash(bash scripts/gate-ok *)",
|
||||
"Bash(bash scripts/gitea-pr-merge.sh *)"
|
||||
]
|
||||
}
|
||||
@@ -103,64 +103,10 @@ WARNED="/tmp/.comment-task-guard-warned-$SID"
|
||||
[ -f "$WARNED" ] && exit 0 # 同一 session 只擋一次,不鬼打牆
|
||||
date +%s > "$WARNED"
|
||||
|
||||
# ── 出路要真的走得通(inkstone/ISEP#112)────────────────────────────────
|
||||
#
|
||||
# 這支閘 08-27 上線時印的是 `scripts/ticket subtask …`,而那一行**跑不動**,
|
||||
# 兩個獨立的原因(2026-08-31 實測,各自都足以害死它):
|
||||
#
|
||||
# ① 相對路徑對「貼上去那個人的 cwd」解析。總管的 cwd 是 `InkStoneCo/`,
|
||||
# 那裡的 `scripts/ticket` 是舊複本(`grep -c subtask` → 0),
|
||||
# 照著貼只會印出它「四個動詞」的說明然後 exit 0。
|
||||
# ② 用法是**手抄的第二份**,而它已經漂了:寫了 `--assign` 卻沒有 `--next`,
|
||||
# 而正本會因為「指派了人卻沒寫 --next」直接擋下。
|
||||
#
|
||||
# 票上的判決:「**當它教的做法不存在,它就從『幫你』變成『擋你』**——
|
||||
# 而且被擋的人當下正在做別的事,最可能的反應是找個理由繞過去。」
|
||||
#
|
||||
# 🔴 所以這裡**不准再抄一份用法**。整塊指令去正本要:
|
||||
# "$TICKET" usage subtask --example --parent <母票> --draft <草稿路徑>
|
||||
# 正本印的路徑是它自己的 `__file__`(絕對路徑)⇒ 印指令的人與跑指令的人
|
||||
# 是同一個檔案,沒有第二種可能。
|
||||
ROOT="${CLAUDE_PLUGIN_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
|
||||
TICKET="$ROOT/scripts/ticket"
|
||||
|
||||
# 母票是誰:兩條路都認(走正門 `ticket say`,或直接打 API)。認不出來就留 <母票 …>,
|
||||
# 正本那邊會照樣印出可讀的樣板——**寧可少填一格,不要猜錯一張票**。
|
||||
PARENT=$(printf '%s' "$CMD" | python3 -c '
|
||||
import re, sys
|
||||
c = sys.stdin.read()
|
||||
m = re.search(r"/repos/([\w.-]+)/([\w.-]+)/issues/(\d+)/comments", c)
|
||||
if m:
|
||||
print("%s/%s#%s" % m.groups()); raise SystemExit
|
||||
m = re.search(r"\bticket\s+say\s+([\w.-]+)/([\w.-]+)#(\d+)", c)
|
||||
if m:
|
||||
print("%s/%s#%s" % m.groups())
|
||||
' 2>/dev/null)
|
||||
|
||||
DRAFT="/tmp/isep-subtask-$SID.md"
|
||||
EXAMPLE=$(python3 "$TICKET" usage subtask --example \
|
||||
${PARENT:+--parent "$PARENT"} --draft "$DRAFT" 2>/dev/null) || EXAMPLE=""
|
||||
MORE=$(python3 "$TICKET" usage subtask 2>/dev/null) || MORE=""
|
||||
|
||||
# fail-open 的**訊息**(不是閘):正本叫不動時仍然要擋,但不准在這裡補一份手抄用法
|
||||
# ——那樣就把剛拔掉的那個副本裝回來了。只指路,指到唯一那一份。
|
||||
LEAD="整段複製貼上就跑得動。腳本是絕對路徑、母票已經填好、必填段落已經在草稿裡,
|
||||
只剩三格是機器不可能知道的:標題、目標、驗收條件——改完那三格再送。
|
||||
(下面這塊**不要縮排**,\`<<'MD'\` 的結束標記要頂在行首。)"
|
||||
if [ -z "$EXAMPLE" ]; then
|
||||
LEAD="把它長成子票。**這台機器叫不動正本,所以下面只給路、不給整塊指令**
|
||||
——這裡刻意不補一份手抄的用法,那份副本正是 inkstone/ISEP#112 拔掉的東西。"
|
||||
EXAMPLE="python3 $TICKET usage subtask --example"
|
||||
MORE=""
|
||||
fi
|
||||
|
||||
# 🔴 訊息一律用 `<<'EOF'`(標記加引號)+ 事後用 python 換佔位符。
|
||||
# ISEP wiki mistakes.md 記過:不加引號的 heredoc 會把訊息裡的反引號當命令執行,
|
||||
# 而**閘照樣 exit 2,所以只看離開碼的測試完全看不出來**。
|
||||
MSG=$(cat <<'EOF'
|
||||
cat >&2 <<EOF
|
||||
🎫 這則留言裡藏著一件**還沒做完的事**,而它現在只是文字。
|
||||
|
||||
命中的詞:__HIT__
|
||||
命中的詞:$HIT
|
||||
|
||||
【leo 2026-08-27】「**每個任務長出子票做為這張票的相依⋯⋯票沒完工可以察覺嗎?**」
|
||||
|
||||
@@ -169,32 +115,18 @@ MSG=$(cat <<'EOF'
|
||||
08-26 18-23 總管真的出貨了 ← 條件滿足,沒人知道
|
||||
08-27 11:xx leo 問「這 14 小時前的,你派了還是沒派?」 ← 才被撿起來
|
||||
|
||||
【怎麼做】__LEAD__
|
||||
【怎麼做】把它長成子票,Gitea 原生相依會**硬擋**母票關閉(實測 412):
|
||||
|
||||
__EXAMPLE__
|
||||
__MORE__
|
||||
⇒ 子票沒關,母票關不掉。**不是提醒,是平台保證**(Gitea 原生相依,實測 412)。
|
||||
scripts/ticket subtask <母票 owner/repo#N> \\
|
||||
--title "身為<誰>,我要<什麼>,我才<為什麼>" \\
|
||||
-F <內文檔> --label s/todo --assign <誰做>
|
||||
|
||||
⇒ 子票沒關,母票關不掉。**不是提醒,是平台保證。**
|
||||
|
||||
【粒度】leo 2026-08-27:「**小任務做完就關閉,不會讓池子爆掉,
|
||||
每個事情沒有歷史記錄才是大問題**」⇒ 判準是「這件事需要被記得嗎」,
|
||||
傾向**多開票**。不要用「會不會太多」當理由不開。
|
||||
|
||||
【真的不是待辦】在指令裡加 `no-subtask: <一句理由>` 重送(留痕)。
|
||||
【真的不是待辦】在指令裡加 \`no-subtask: <一句理由>\` 重送(留痕)。
|
||||
EOF
|
||||
)
|
||||
|
||||
MORE_BLOCK=""
|
||||
[ -n "$MORE" ] && MORE_BLOCK="
|
||||
還有哪些參數(指派給誰+下一步、旅程標籤、換 repo):
|
||||
$(printf '%s' "$MORE" | sed 's/^/ /; s/[[:space:]]*$//')
|
||||
"
|
||||
|
||||
HIT="$HIT" LEAD="$LEAD" EXAMPLE="$EXAMPLE" MORE_BLOCK="$MORE_BLOCK" MSG="$MSG" python3 -c '
|
||||
import os, sys
|
||||
m = os.environ["MSG"]
|
||||
for k in ("HIT", "LEAD", "EXAMPLE"):
|
||||
m = m.replace("__%s__" % k, os.environ.get(k, ""))
|
||||
m = m.replace("__MORE__", os.environ.get("MORE_BLOCK", ""))
|
||||
sys.stderr.write(m + "\n")
|
||||
'
|
||||
exit 2
|
||||
|
||||
@@ -12,8 +12,18 @@
|
||||
# 放行:頂層自己的檔(CLAUDE.md / .claude/ / docs/ / MEMORY.md…)、
|
||||
# 以及子 repo 內的 .md(交棒 HANDOFF / 筆記 / 文件——leo 2026-06-15 拍板放行所有 .md)。
|
||||
#
|
||||
# 誠實限制(arcrun mindset §7):本 hook 擋的是「路徑語法層」——能擋「寫程式碼進子 repo」,
|
||||
# 擋不了「把實作偽裝成 .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 上,下面整段白名單對總管自己也會放行。
|
||||
# 這一點本輪**沒有動**(那是另一件事,改它要重新評估誰該被擋),
|
||||
# 但誰讀這支閘都該知道它不是它字面上看起來的那道夾子。
|
||||
|
||||
input="$(cat)"
|
||||
|
||||
@@ -30,13 +40,31 @@ except Exception:
|
||||
# 拿不到路徑就放行(不誤擋;hook 不該因解析失敗卡死正常操作)
|
||||
[ -z "$file_path" ] && exit 0
|
||||
|
||||
# 頂層 repo 根(hook 檔位於 <root>/.claude/hooks/)
|
||||
repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
|
||||
# 頂層 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_root 的路徑(file_path 可能是絕對或相對)
|
||||
case "$file_path" in
|
||||
/*) rel="${file_path#"$repo_root"/}" ;; # 絕對路徑 → 去掉 repo_root 前綴
|
||||
*) rel="$file_path" ;; # 相對路徑 → 假定相對 repo_root
|
||||
/*) rel="${file_path#"$repo_root"/}" # 絕對路徑 → 去掉 repo_root 前綴
|
||||
rel="${rel#"$repo_root_phys"/}" ;; # 實體路徑版也試一次
|
||||
*) rel="$file_path" ;; # 相對路徑 → 假定相對 repo_root
|
||||
esac
|
||||
|
||||
# 不在子 repo 目錄內 → 放行(頂層自己的檔)
|
||||
@@ -48,8 +76,10 @@ esac
|
||||
# 自動派工放行(2026-06-28 leo 拍板上線,實測通過):
|
||||
# 子 repo 的 subagent 可直接寫該 repo code(繞 D9)——因 subagent 心智已是該 repo
|
||||
# (A/B 實驗證 ≈ claude -p),讓「心智是該 repo 的小弟寫該 repo」符合 context 隔離。
|
||||
# 雙重夾:① CHILD_SESSION=1(harness 內建 subagent 標籤,總管主 session 無此標籤仍被擋)
|
||||
# ② 路徑在下面白名單 array 內。
|
||||
# 雙重夾:① CHILD_SESSION=1 ② 路徑屬於下面白名單 array 上的 repo。
|
||||
# ⚠️ ①**沒有它字面上看起來那麼緊**:原註解寫「總管主 session 無此標籤仍被擋」,
|
||||
# 但 `InkStoneCo/system-dev/wiki/ops-facts.md` 記著實測——Claude Desktop 的
|
||||
# 總管主 session 也是 `1`。⇒ 在那個 surface 上這一夾是空的。本輪沒有動它。
|
||||
# 隔離保證=prompt reset(軟,靠監測)非結構級;要絕對純走 claude -p。心法見 wiki。
|
||||
#
|
||||
# 🔧 leo 維護:要放開一個 repo 給 subagent 自動寫 code,就在這 array 加一行路徑前綴。
|
||||
@@ -59,11 +89,58 @@ AUTODISPATCH_ALLOW=(
|
||||
"matrix/arcrun" # 共用框架(影響全部人,走 PR 把關)
|
||||
"products/arcrun-rag" # 產品組裝 repo(2026-07-13 leo 放行 G8:回覆「放行」)
|
||||
)
|
||||
if [ "$CLAUDE_CODE_CHILD_SESSION" = "1" ]; then
|
||||
|
||||
# ── 白名單比對的是「哪個 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)"
|
||||
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
|
||||
|
||||
|
||||
@@ -56,32 +56,15 @@ STAMP="/tmp/.history-guard-$(printf '%s' "$FILE_PATH" | shasum | cut -c1-12)"
|
||||
#
|
||||
# 時戳由 kbdb-asked-stamp.sh(PostToolUse,matcher 對 kbdb_* 工具)寫下。
|
||||
# 逃生口:KBDB 真的連不上時 `touch /tmp/.kbdb-down`——放行但留痕,且回覆裡要說明。
|
||||
#
|
||||
# 🔴 **逃生門要真的走得通**(inkstone/ISEP#122,2026-09-02 實撞,本檔第二次修):
|
||||
# 上面那句訊息叫人 `touch /tmp/.kbdb-down`,而 `touch` 造出來的是**空檔**
|
||||
# ⇒ 舊版 `t=$(cat "$f")` 讀到空字串 ⇒ 算式當成 0 ⇒ 「距今 17 億秒」
|
||||
# ⇒ 永遠不新鮮 ⇒ **照著訊息打完,還是被擋**。
|
||||
# 實測(2026-09-02,KBDB 兩支工具都回 Connection closed 時):
|
||||
# $ touch /tmp/.kbdb-down → 再送同一個編輯 → 一模一樣的擋,訊息一字不差
|
||||
# ⇒ 那行逃生門是印出來好看的,**沒有人照著打過一次**
|
||||
# (同族:ISEP#125 worktree 閘印的逃生門原文照打 rc=2;本票 comment 6071)。
|
||||
#
|
||||
# 改法:**內容不是數字就用檔案的 mtime**——`touch` 做的正是更新 mtime,
|
||||
# 所以訊息裡那一行從此真的走得通,而 `kbdb-asked-stamp.sh` 寫數字的舊格式照樣相容。
|
||||
# 路徑用 `KBDB_STAMP_DIR` 可覆寫,**只為了讓迴歸測試不去動這台機器真正的戳記**
|
||||
# (測試把別的 session 的戳記清掉=把閘弄成隨機的)。
|
||||
KBDB_STAMP="${KBDB_STAMP_DIR:-/tmp}/.kbdb-asked"
|
||||
KBDB_DOWN="${KBDB_STAMP_DIR:-/tmp}/.kbdb-down"
|
||||
KBDB_STAMP=/tmp/.kbdb-asked
|
||||
KBDB_DOWN=/tmp/.kbdb-down
|
||||
kbdb_fresh=0
|
||||
now=$(date +%s)
|
||||
for f in "$KBDB_STAMP" "$KBDB_DOWN"; do
|
||||
[ -f "$f" ] || continue
|
||||
t=$(cat "$f" 2>/dev/null || true)
|
||||
case "$t" in
|
||||
''|*[!0-9]*) t=$(date -r "$f" +%s 2>/dev/null || stat -c %Y "$f" 2>/dev/null || echo 0) ;;
|
||||
esac
|
||||
[ "${t:-0}" -gt 0 ] || continue
|
||||
[ $((now - t)) -lt 3600 ] && kbdb_fresh=1
|
||||
if [ -f "$f" ]; then
|
||||
t=$(cat "$f" 2>/dev/null || echo 0)
|
||||
[ $((now - t)) -lt 3600 ] && kbdb_fresh=1
|
||||
fi
|
||||
done
|
||||
if [ "$kbdb_fresh" -eq 0 ]; then
|
||||
cat >&2 <<'KEOF'
|
||||
|
||||
+4
-4
@@ -99,6 +99,10 @@
|
||||
"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"
|
||||
@@ -281,10 +285,6 @@
|
||||
"type": "command",
|
||||
"command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/mainline refresh"
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/settings-allow-sync --quiet"
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/overdue-nag-guard.sh"
|
||||
|
||||
@@ -16,6 +16,5 @@
|
||||
# KBDB(一次看所有庫,最便宜)→ 該 repo 的 wiki/tasks → git log -S → 讀源碼(最貴,
|
||||
# 只看得到「現在長怎樣」,看不到「為什麼變成這樣」)
|
||||
set -eu
|
||||
# 路徑跟 history-first-guard.sh 用同一個覆寫變數,否則測試會兩邊指到不同地方
|
||||
date +%s > "${KBDB_STAMP_DIR:-/tmp}/.kbdb-asked"
|
||||
date +%s > /tmp/.kbdb-asked
|
||||
exit 0
|
||||
|
||||
@@ -20,7 +20,6 @@
|
||||
# 判準(封動作,不封措辭 —— 同 empty-handed-stop-guard 的哲學):
|
||||
# 命中 leo21c 的座標 + 這是一個寫入動作 ⇒ 擋
|
||||
# 只是讀(GET/查詢/grep 到那個字串) ⇒ 放行
|
||||
# 發一則 notify_leo(通知型 trigger,什麼都沒改)⇒ 放行(同 prod-write-guard 的白名單)
|
||||
set -uo pipefail
|
||||
payload=$(cat)
|
||||
cmd=$(printf '%s' "$payload" | python3 -c "
|
||||
@@ -61,34 +60,8 @@ hit=0
|
||||
|
||||
# ① 寫入請求打到那台 worker
|
||||
if printf '%s' "$cmd" | grep -qiE 'https?://[^[:space:]"'"'"']*leo21c\.workers\.dev'; then
|
||||
# 🔴 (a) 通知型 trigger 放行(inkstone/ISEP#130;判準與 prod-write-guard.sh 同一份):
|
||||
# `…/webhooks/named/<ns>/notify_leo/trigger` = 發一則 Telegram 給 leo,**什麼都沒改**。
|
||||
# wiki `agent-memory.md` 寫明它是找 leo 的正式通道;prod-write-guard 在 ISEP#63 就放行了它,
|
||||
# 本閘卻因為路徑尾巴是 `/trigger` 照擋 ⇒ 兩支閘對同一條指令說不同的話,
|
||||
# 而「發通知」被擋的結果是**雲端撞到人閘也叫不動 leo**(inkstone/InkStoneCo#110)。
|
||||
# 放行的範圍刻意只有一個名字:指令裡打到 leo21c 的**每一個**網址都得是它,
|
||||
# 混進部署端點(`…/webhooks/named` 無名字)或別的工作流 ⇒ 照擋。
|
||||
NOTIFY_ONLY=$(printf '%s' "$cmd" | python3 -c '
|
||||
import re, sys
|
||||
cmd = sys.stdin.read()
|
||||
ALLOW = {"notify_leo"}
|
||||
urls = [u for u in re.findall(r"https?://[^\s\"\x27<>]+", cmd) if "leo21c.workers.dev" in u.lower()]
|
||||
PAT = re.compile(r"https?://[^/]+/webhooks/named/[^/]+/([A-Za-z0-9_-]+)/trigger/?$")
|
||||
def notify(u):
|
||||
m = PAT.match(u.rstrip(",;)"))
|
||||
return bool(m) and m.group(1) in ALLOW
|
||||
print("notify-only" if urls and all(notify(u) for u in urls) else "")
|
||||
' 2>/dev/null || printf '')
|
||||
if [ "$NOTIFY_ONLY" != "notify-only" ]; then
|
||||
# 🔴 (b) 先剪掉唯讀工具的 `-d`(inkstone/ISEP#130,09-04 雲端實撞):
|
||||
# `curl -s https://…leo21c…/x | tr -d '\r'`、`cut -d= -f2`、`sort -d`、`date -d` ……
|
||||
# 這些 `-d` 沒有一個會寫到那台,舊判準 `-d[[:space:]]` 卻把整條純 GET 擋下
|
||||
# ⇒ 「連讀都被擋」。prod-write-guard.sh 在 2026-08-12 就修過同一個洞,本閘漏了。
|
||||
# 剪法與那支同一句 sed,剪完剩下的 `-d` 才是 curl 的 body。
|
||||
cmd_w=$(printf '%s' "$cmd" | sed -E 's/(^|[|;&( ])(tr|cut|sort|uniq|date|xargs|paste|join|du|logger|split|comm)[[:space:]]+-d/\1\2 __READONLY_D__/g')
|
||||
if printf '%s' "$cmd_w" | grep -qE -- '-X *(POST|PUT|PATCH|DELETE)|--request *(POST|PUT|PATCH|DELETE)|--data|--data-raw|-d[[:space:]]|/trigger'; then
|
||||
hit=1
|
||||
fi
|
||||
if printf '%s' "$cmd" | grep -qE -- '-X *(POST|PUT|PATCH|DELETE)|--data|--data-raw|-d[[:space:]]|/trigger'; then
|
||||
hit=1
|
||||
fi
|
||||
fi
|
||||
|
||||
@@ -114,8 +87,7 @@ leo 原話:「**leo21c 就是我這個普通用戶,不應該讓你去操控
|
||||
改法:把目標明寫成 youlin,不要吃 `~/.arcrun/config.yaml` 的預設——
|
||||
那個檔至今仍指著 leo21c(KV id 與 encryption_key 是該實例專屬,換不過去)。
|
||||
|
||||
cypher : https://arcrun-cypher-executor.arcrun-yuga3bse.workers.dev
|
||||
(09-02 重裝後的子網域;舊名 youlin-hsieh-dev 的 DNS 已不存在,打它一律 000)
|
||||
cypher : https://arcrun-cypher-executor.youlin-hsieh-dev.workers.dev
|
||||
ns : yuga3bse
|
||||
CF : 1129efd7df2e8899d537e9c8fbabb6cb
|
||||
token : 頂層 .env 的 CLOUDFLARE_API_TOKEN_YOULIN_CC_USE
|
||||
|
||||
+2
-141
@@ -1,7 +1,6 @@
|
||||
# ── 以下五格是「這一份是不是還有效」自檢 ─────────────────────────────
|
||||
# ①②③ inkstone/ISEP#90 立;②b②c inkstone/ISEP#122 補(會自動載入的東西也有分身)
|
||||
# ── 以下三格是 inkstone/ISEP#90 加的「這一份是不是還有效」自檢 ──────────
|
||||
# 都**只是報告,不擋任何事**(SessionStart 本來就不該擋),而且每一格拿不到答案就閉嘴。
|
||||
import hashlib, json, os, re, subprocess, sys, time, urllib.request
|
||||
import json, os, re, subprocess, sys, time, urllib.request
|
||||
|
||||
ROOT = os.environ.get("CLAUDE_PLUGIN_ROOT", "")
|
||||
PROJ = os.environ.get("CLAUDE_PROJECT_DIR") or os.getcwd()
|
||||
@@ -104,144 +103,6 @@ if sh:
|
||||
"在雲端一律死在「拿不到 gitea token」。要嘛刪掉複本改叫 "
|
||||
"`\"$CLAUDE_PLUGIN_ROOT\"/scripts/<名字>`,要嘛把複本同步回 ISEP。" % "、".join(sh))
|
||||
|
||||
# ══ ②b 會**自動載入**的東西(skill/command/agent)兩邊各有一份而內容不同 ══
|
||||
#
|
||||
# 🔴 為什麼上面那一格抓不到(inkstone/ISEP#122,2026-09-02 實查):
|
||||
# ② 只掃 `scripts/`。而真正會**自動載入**的東西住在別的目錄,同樣兩邊各有一份:
|
||||
# plugin `skills/<名>/SKILL.md` ↔ 專案 `.claude/skills/<名>/SKILL.md`
|
||||
# plugin `commands/<名>.md` ↔ 專案 `.claude/commands/<名>.md`
|
||||
# plugin `agents/<名>.md` ↔ 專案 `.claude/agents/<名>.md`
|
||||
#
|
||||
# 實況:這 9 個檔案在 ISEP `0.1.0`(c263866)從 InkStoneCo 複製過來**一次**,
|
||||
# 之後再也沒有同步過。到 2026-09-02 已經分家兩個,而且**方向相反**:
|
||||
# `skills/ship-check/SKILL.md` InkStoneCo 651 行 / ISEP 595 行
|
||||
# `commands/sdd-check.md` ISEP 81 行 / InkStoneCo 65 行
|
||||
# (InkStoneCo 那份還在教 ISEP#91 已退役的「唯一 active SDD」)
|
||||
# ⇒ 「ISEP 一定比較新」與「InkStoneCo 一定比較新」**兩句都是錯的**。
|
||||
# 兩份都會被就地編輯 ⇒ 歸屬只能寫下來(`docs/file-ownership.tsv`)並且要有東西去比。
|
||||
#
|
||||
# 🔴 這一格比 ② 嚴重:腳本要有人叫它才會跑,**skill/command 是自動載入的**——
|
||||
# 載到舊的那份不會報錯、不會變慢、不會有任何症狀,只會安靜地教錯的東西。
|
||||
# (ship-check 就是這樣:舊描述在「我要發一篇部落格文章」時根本不會被觸發。)
|
||||
#
|
||||
# 判準與 ② 同一條:**檔名一樣而內容不同**才出聲,同步過的不吵。
|
||||
LOADABLE_PAIRS = [("skills", ".claude/skills", True),
|
||||
("commands", ".claude/commands", False),
|
||||
("agents", ".claude/agents", False)]
|
||||
|
||||
|
||||
def ownership():
|
||||
"""讀 docs/file-ownership.tsv → {plugin 內路徑: (真相源, 真相源路徑, commit, sha256)}"""
|
||||
out = {}
|
||||
try:
|
||||
with open(os.path.join(ROOT, "docs", "file-ownership.tsv"), encoding="utf-8") as f:
|
||||
for line in f:
|
||||
if not line.strip() or line.lstrip().startswith("#"):
|
||||
continue
|
||||
c = line.rstrip("\n").split("\t")
|
||||
if len(c) >= 2 and c[0].strip():
|
||||
out[c[0].strip()] = tuple((c[1:5] + ["-", "-", "-", "-"])[:4])
|
||||
except Exception:
|
||||
pass
|
||||
return out
|
||||
|
||||
|
||||
OWN = ownership()
|
||||
|
||||
|
||||
def loadable_pairs():
|
||||
"""產生 (plugin 內相對路徑, 專案內相對路徑)——只列 plugin 真的有的那些"""
|
||||
for pdir, jdir, nested in LOADABLE_PAIRS:
|
||||
src = os.path.join(ROOT, pdir)
|
||||
if not os.path.isdir(src):
|
||||
continue
|
||||
try:
|
||||
names = sorted(os.listdir(src))
|
||||
except Exception:
|
||||
continue
|
||||
for name in names:
|
||||
if nested:
|
||||
if os.path.isfile(os.path.join(src, name, "SKILL.md")):
|
||||
yield "%s/%s/SKILL.md" % (pdir, name), "%s/%s/SKILL.md" % (jdir, name)
|
||||
elif name.endswith(".md") and os.path.isfile(os.path.join(src, name)):
|
||||
yield "%s/%s" % (pdir, name), "%s/%s" % (jdir, name)
|
||||
|
||||
|
||||
def whose(rel):
|
||||
"""真相源是誰 → 一句照著做就會走到的話。表上沒有就誠實說未定,不要猜。"""
|
||||
row = OWN.get(rel)
|
||||
if not row:
|
||||
return "歸屬未定 ⇒ 兩份都看一眼,決定之後補一列進 docs/file-ownership.tsv"
|
||||
src, spath, _commit, _sha = row
|
||||
if src == "inkstone/ISEP":
|
||||
return "真相源=ISEP 這一份 ⇒ 專案那份是舊複本,同步過去或刪掉它"
|
||||
return ("真相源=%s:%s ⇒ 內容改在那裡,改完原樣搬進 ISEP、"
|
||||
"更新 docs/file-ownership.tsv 的 commit/sha256、升版" % (src, spath or "?"))
|
||||
|
||||
|
||||
def shadow_loadables():
|
||||
out = []
|
||||
roots = [PROJ, os.path.join(PROJ, "InkStoneCo")]
|
||||
for prel, jrel in loadable_pairs():
|
||||
a = os.path.join(ROOT, prel)
|
||||
try:
|
||||
ab = open(a, "rb").read()
|
||||
except Exception:
|
||||
continue
|
||||
for base in roots:
|
||||
b = os.path.join(base, jrel)
|
||||
try:
|
||||
if os.path.realpath(b) == os.path.realpath(a) or not os.path.isfile(b):
|
||||
continue
|
||||
if open(b, "rb").read() != ab:
|
||||
out.append("%s ↔ %s(%s)"
|
||||
% (prel, os.path.relpath(b, PROJ), whose(prel)))
|
||||
except Exception:
|
||||
pass
|
||||
return out
|
||||
|
||||
|
||||
ld = shadow_loadables()
|
||||
if ld:
|
||||
notes.append(
|
||||
"🟡 **會自動載入的東西兩邊各有一份,而且內容不同**:\n - %s\n"
|
||||
" 自動載入的東西載到舊的那份**不會有任何症狀**——不報錯、不變慢,"
|
||||
"只會安靜地教錯的東西(`ship-check` 的舊描述在「我要發一篇部落格文章」時"
|
||||
"根本不會被觸發)。歸屬表:docs/file-ownership.tsv(inkstone/ISEP#122)。"
|
||||
% "\n - ".join(ld))
|
||||
|
||||
# ══ ②c ISEP 自己這一份,跟歸屬表記的那顆對不對得上 ══════════════════════
|
||||
#
|
||||
# 🔴 為什麼要有這一格:②b 要「專案那一份」在磁碟上才比得出來,
|
||||
# 而**雲端的 project dir 是薄殼,根本沒有那一份**(ISEP#90 記過同一件事)。
|
||||
# 這一格只比「檔案 vs 表上寫的 sha256」——離線、單邊、不依賴任何別的 repo,
|
||||
# 是雲端唯一還作數的那個檢查。
|
||||
def off_manifest():
|
||||
out = []
|
||||
for rel, (src, spath, commit, sha) in OWN.items():
|
||||
if not sha or sha == "-":
|
||||
continue
|
||||
p = os.path.join(ROOT, rel)
|
||||
if not os.path.isfile(p):
|
||||
continue
|
||||
try:
|
||||
h = hashlib.sha256(open(p, "rb").read()).hexdigest()
|
||||
except Exception:
|
||||
continue
|
||||
if h != sha:
|
||||
out.append("%s(表記 %s 的 %s…,實際 %s…;真相源 %s:%s)"
|
||||
% (rel, (commit or "?")[:7], sha[:12], h[:12], src, spath or "?"))
|
||||
return out
|
||||
|
||||
|
||||
om = off_manifest()
|
||||
if om:
|
||||
notes.append(
|
||||
"🟡 **ISEP 這一份跟歸屬表對不上**:%s。兩種可能,兩種都要動手:"
|
||||
"① 它被就地改過 ⇒ 內容要改在真相源那邊,這裡只放原樣搬過來的複本;"
|
||||
"② 它是同步過的新內容、只是沒更新 docs/file-ownership.tsv 的 commit/sha256 ⇒ 補上那兩欄。"
|
||||
% "、".join(om))
|
||||
|
||||
# ══ ③ 工作區有沒有「已退役機制」留下的產物 ══════════════════════════════
|
||||
#
|
||||
# 判準是機械的、而且會自己長大:**plugin 自己的原始碼裡有沒有任何一個字提到這個目錄**。
|
||||
|
||||
+12
-91
@@ -58,57 +58,14 @@ def path() -> str:
|
||||
return os.path.join(state_dir(), STATE_NAME)
|
||||
|
||||
|
||||
# ── repo 裡的那一份(inkstone/ISEP#130)──────────────────────────────
|
||||
#
|
||||
# 主線原本只住在 `~/.claude/isep-countdown/mainline.json`——**這台機器的家目錄**。
|
||||
# 雲端 session 是另一台機器:家目錄是空的,clone 下來的 repo 才是它唯一拿得到的東西。
|
||||
# 2026-09-05 leo:「routine 每天早上開啟後抓不到任務」——不是 Gitea 沒票,
|
||||
# 是雲端根本不知道主線是哪一條。
|
||||
# ⇒ `inkstone/InkStoneCo` 的 `system-dev/mainline.json` 是**隨 repo 走的那一份**
|
||||
# (PR inkstone/InkStoneCo#118 放進去的)。這裡的規矩:
|
||||
# · 讀:家目錄那份沒有 ⇒ 讀 repo 那份(雲端就是這個形狀)。
|
||||
# 兩份都在 ⇒ 用 `set_at` 較新的(誰後標的誰算數,不分本機雲端)。
|
||||
# · 寫:`set`/`adopt`/`clear` 這種「主線是誰」的改動 ⇒ 兩份一起寫(`mirror=True`)。
|
||||
# `refresh`/閘順手學到成員 ⇒ 只寫家目錄那份——否則每開一個 session
|
||||
# InkStoneCo 的工作樹就髒一次,而髒的 diff 沒有人會去 commit。
|
||||
# · repo 那份要 commit/開 PR 才到得了雲端;這支不碰 git。
|
||||
REPO_REL = os.path.join("system-dev", STATE_NAME)
|
||||
def load():
|
||||
"""讀主線。沒有/壞掉 ⇒ None(=現在沒有主線),**不是例外**。
|
||||
|
||||
|
||||
def repo_candidates():
|
||||
"""repo 那一份可能在哪:明指 > 專案根 > 專案根底下的 InkStoneCo/(雲端薄殼的形狀)> cwd 同兩層。"""
|
||||
out = []
|
||||
forced = os.environ.get("ISEP_MAINLINE_REPO_FILE", "").strip()
|
||||
if forced == "none":
|
||||
return [] # 測試用:把「repo 那份」整個拿掉,外界定住
|
||||
if forced:
|
||||
out.append(forced)
|
||||
roots = []
|
||||
for r in (os.environ.get("CLAUDE_PROJECT_DIR", "").strip(), os.getcwd()):
|
||||
if r:
|
||||
roots += [r, os.path.join(r, "InkStoneCo")]
|
||||
for r in roots:
|
||||
p = os.path.join(r, REPO_REL)
|
||||
if p not in out:
|
||||
out.append(p)
|
||||
return out
|
||||
|
||||
|
||||
def repo_path(for_write=False):
|
||||
"""讀:第一個**存在**的檔。寫:第一個 `system-dev/` 目錄存在的位置(檔可以還沒有)。
|
||||
找不到 ⇒ None(雲端沒 clone InkStoneCo、或 cwd 在別的 repo 時都是正常狀態)。"""
|
||||
for p in repo_candidates():
|
||||
if for_write:
|
||||
if os.path.isdir(os.path.dirname(p)):
|
||||
return p
|
||||
elif os.path.isfile(p):
|
||||
return p
|
||||
return None
|
||||
|
||||
|
||||
def _read(p):
|
||||
「沒有主線」是一個正常狀態,不是故障:ISEP#82 驗收第 4 條寫死了
|
||||
「沒有任何主線時不能整組壞掉」。所以這支從不 raise。
|
||||
"""
|
||||
try:
|
||||
with open(p) as f:
|
||||
with open(path()) as f:
|
||||
d = json.load(f)
|
||||
except Exception:
|
||||
return None
|
||||
@@ -117,59 +74,23 @@ def _read(p):
|
||||
return d
|
||||
|
||||
|
||||
def load():
|
||||
"""讀主線。沒有/壞掉 ⇒ None(=現在沒有主線),**不是例外**。
|
||||
|
||||
「沒有主線」是一個正常狀態,不是故障:ISEP#82 驗收第 4 條寫死了
|
||||
「沒有任何主線時不能整組壞掉」。所以這支從不 raise。
|
||||
|
||||
家目錄那份與 repo 那份都在時,`set_at` 較新的算數(格式固定 `YYYY-MM-DD HH:MM`,
|
||||
字串比大小就是時間比大小);一樣新 ⇒ 家目錄那份(它才有 refresh 過的進度)。
|
||||
"""
|
||||
local = _read(path())
|
||||
rp = repo_path()
|
||||
remote = _read(rp) if rp else None
|
||||
if local and remote:
|
||||
return remote if (remote.get("set_at") or "") > (local.get("set_at") or "") else local
|
||||
return local or remote
|
||||
|
||||
|
||||
def save(d, mirror=False) -> bool:
|
||||
"""寫家目錄那份;`mirror=True` 時同時寫 repo 那份(只有「主線是誰」變了才這樣叫)。
|
||||
回 True/False 只看家目錄那份——repo 那份寫不寫得進去用 `repo_path(for_write=True)` 另外問。"""
|
||||
def save(d) -> bool:
|
||||
try:
|
||||
with open(path(), "w") as f:
|
||||
json.dump(d, f, ensure_ascii=False, indent=2)
|
||||
return True
|
||||
except Exception:
|
||||
return False
|
||||
if mirror:
|
||||
rp = repo_path(for_write=True)
|
||||
if rp:
|
||||
try:
|
||||
with open(rp, "w") as f:
|
||||
json.dump(d, f, ensure_ascii=False, indent=2)
|
||||
f.write("\n")
|
||||
except Exception:
|
||||
pass
|
||||
return True
|
||||
|
||||
|
||||
def clear(mirror=False) -> bool:
|
||||
ok = True
|
||||
def clear() -> bool:
|
||||
try:
|
||||
os.remove(path())
|
||||
return True
|
||||
except FileNotFoundError:
|
||||
pass
|
||||
return True
|
||||
except Exception:
|
||||
ok = False
|
||||
if mirror:
|
||||
rp = repo_path()
|
||||
if rp:
|
||||
try:
|
||||
os.remove(rp)
|
||||
except Exception:
|
||||
ok = False
|
||||
return ok
|
||||
return False
|
||||
|
||||
|
||||
def parse_ts(raw):
|
||||
|
||||
@@ -24,12 +24,6 @@
|
||||
# 這些全部沒有本檔「先確認到底在不在 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
|
||||
|
||||
@@ -315,13 +315,12 @@ fi
|
||||
#
|
||||
# 整套測試環境=下列任一出現在命令裡:
|
||||
# · `youlin-hsieh-dev` ── 帳號名(D37 定的 stage 帳號)
|
||||
# · `arcrun-yuga3bse` ── 該帳號 09-02 重裝後的 workers.dev 子網域(inkstone/ISEP#130;舊名 DNS 已死)
|
||||
# · `1129efd7df2e8899d537e9c8fbabb6cb` ── 該帳號 ID(用 env 指過去時只有它看得見)
|
||||
# · `_YOULIN_` ── 憑證變數名(如 `CLOUDFLARE_API_TOKEN_YOULIN_CC_USE`)
|
||||
# · `X-Arcrun-API-Key: youlin` ── 打該實例 API 時的身分標頭
|
||||
case "$CMD" in
|
||||
*staging*|*-staging*|*"--env stage"*|*"--env=stage"*|*stage.*) exit 0 ;;
|
||||
*youlin-hsieh-dev*|*arcrun-yuga3bse*|*1129efd7df2e8899d537e9c8fbabb6cb*|*_YOULIN_*|*"X-Arcrun-API-Key: youlin"*) exit 0 ;;
|
||||
*youlin-hsieh-dev*|*1129efd7df2e8899d537e9c8fbabb6cb*|*_YOULIN_*|*"X-Arcrun-API-Key: youlin"*) exit 0 ;;
|
||||
esac
|
||||
|
||||
# 🔴 2026-08-12 leo 拍板「加閘」:**geek6688(出貨機)是明文授權「總管可以直接動」的那一台。**
|
||||
|
||||
@@ -227,9 +227,6 @@ fi
|
||||
case "$CMD" in
|
||||
*staging*|*-staging*|*"--env stage"*|*"--env=stage"*|*stage.*|*"-staging"*) exit 0 ;;
|
||||
*youlin-hsieh-dev*|*"X-Arcrun-API-Key: youlin"*) exit 0 ;;
|
||||
# 🔴 2026-09-02 youlin 重裝後 workers.dev 子網域換成 `arcrun-yuga3bse`(inkstone/ISEP#130):
|
||||
# 舊名 DNS 已不存在。認不得新名 ⇒ 打 stage 做實驗又會被當成 prod 擋——同一個誤攔第二次。
|
||||
*arcrun-yuga3bse*) exit 0 ;;
|
||||
esac
|
||||
|
||||
|
||||
|
||||
Executable
+234
@@ -0,0 +1,234 @@
|
||||
#!/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
|
||||
@@ -15,7 +15,6 @@ HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/countdown-guard.sh}"
|
||||
TMP=$(mktemp -d)
|
||||
trap 'rm -rf "$TMP"' EXIT
|
||||
export ISEP_COUNTDOWN_STATE_DIR="$TMP/state"
|
||||
export ISEP_MAINLINE_REPO_FILE=none # 把 repo 那份鏡像拿掉(inkstone/ISEP#130):這支測的是家目錄那份
|
||||
mkdir -p "$ISEP_COUNTDOWN_STATE_DIR"
|
||||
|
||||
PASS=0; FAIL=0
|
||||
|
||||
@@ -1,96 +0,0 @@
|
||||
#!/usr/bin/env bash
|
||||
# history-first-guard.sh 的迴歸測試 —— 重點在**逃生門真的走得通**(inkstone/ISEP#122)
|
||||
#
|
||||
# ── 這支在守什麼 ────────────────────────────────────────────────────
|
||||
# 2026-09-02 實撞:KBDB 兩支工具都回 `Connection closed`,照這支閘印出來的那行
|
||||
# `touch /tmp/.kbdb-down`
|
||||
# 打完再送同一個編輯,**被一模一樣地擋第二次**——因為 `touch` 造的是空檔,
|
||||
# 而舊版是 `cat` 檔案內容當時戳,空字串被當成 0 ⇒ 「距今 17 億秒」⇒ 永遠不新鮮。
|
||||
#
|
||||
# 🔴 一道閘印出來的出路走不通,比沒有出路更糟:人照做了、還是被擋,
|
||||
# 下一步就是去繞過這道閘(本 repo 的 ticket-api-bypass-guard.sh 檔頭記過同一課)。
|
||||
# 所以這支測試的第一等公民是**逃生門那一條**,不是「擋不擋得住」。
|
||||
#
|
||||
# 🔴 **這支測試自己怎麼被證明有鑑別力**(不要只看它全綠):
|
||||
# 把修好之前那一版拿來跑,第 ④ 條要紅。因為舊版沒有 KBDB_STAMP_DIR,
|
||||
# 直接餵它會去讀這台機器真正的 /tmp 戳記而「剛好過關」,所以要先把路徑隔離:
|
||||
# git show <修好前的 commit>:hooks/history-first-guard.sh > /tmp/old.sh
|
||||
# sed 's#/tmp/\.kbdb-asked#${KBDB_STAMP_DIR:-/tmp}/.kbdb-asked#;
|
||||
# s#/tmp/\.kbdb-down#${KBDB_STAMP_DIR:-/tmp}/.kbdb-down#' /tmp/old.sh > /tmp/old-iso.sh
|
||||
# bash hooks/tests/history-first-guard.test.sh /tmp/old-iso.sh
|
||||
# 2026-09-02 實跑:舊版 9/10(④ 紅),修好後 10/10。
|
||||
# ⚠️ 第 ③ 條**兩版都是綠的**——它只驗離開碼 2,而過了第 0 道之後歷史警察照樣會擋。
|
||||
# 真正分辨得出來的是 ④「擋人的是誰」。這一格是本支最容易寫成假綠的地方。
|
||||
#
|
||||
# 🔴 全程用 KBDB_STAMP_DIR 指到 TMP,**不碰這台機器真正的 /tmp/.kbdb-* 戳記**
|
||||
# (把別的 session 的戳記清掉=把閘弄成隨機的)。不打網路。
|
||||
set -u
|
||||
HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/history-first-guard.sh}"
|
||||
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
|
||||
export KBDB_STAMP_DIR="$TMP/stamps"; mkdir -p "$KBDB_STAMP_DIR"
|
||||
|
||||
PASS=0; FAIL=0; N=0
|
||||
|
||||
# 造一個「有前科」的 code 檔:放在一個有 git 歷史的假 repo 裡
|
||||
REPO="$TMP/repo"; mkdir -p "$REPO"
|
||||
( cd "$REPO" && git init -q && git config user.email t@t && git config user.name t \
|
||||
&& printf 'echo old\n' > victim.sh && git add . && git commit -qm "第一版" ) >/dev/null 2>&1
|
||||
VICTIM="$REPO/victim.sh"
|
||||
|
||||
# run <檔案> → 印出離開碼(送一份 Edit 的 payload 進去)
|
||||
run() {
|
||||
printf '{"tool_input":{"file_path":"%s"}}' "$1" \
|
||||
| CLAUDE_PROJECT_DIR="$REPO" bash "$HOOK" >/dev/null 2>"$TMP/err"
|
||||
printf '%s' "$?"
|
||||
}
|
||||
|
||||
check() { # check <說明> <實際> <期望>
|
||||
N=$((N+1))
|
||||
if [ "$2" = "$3" ]; then printf ' ✅ %s\n' "$1"; PASS=$((PASS+1))
|
||||
else printf ' ❌ %s —— 期望離開碼 %s,實際 %s\n' "$1" "$3" "$2"; sed 's/^/ /' "$TMP/err" | head -6; FAIL=$((FAIL+1)); fi
|
||||
}
|
||||
|
||||
clean_stamps() { rm -f "$KBDB_STAMP_DIR/.kbdb-asked" "$KBDB_STAMP_DIR/.kbdb-down"; rm -f /tmp/.history-guard-*; }
|
||||
|
||||
echo "── 第 0 道:問過 KBDB 了沒 ──────────────────────────────────"
|
||||
clean_stamps
|
||||
check "① 沒有任何戳記 → 擋" "$(run "$VICTIM")" 2
|
||||
grep -q "KBDB" "$TMP/err" && printf ' ✅ ② 擋下時訊息講得出是哪一道\n' && PASS=$((PASS+1)) || { printf ' ❌ ② 訊息沒提到 KBDB\n'; FAIL=$((FAIL+1)); }; N=$((N+1))
|
||||
|
||||
echo "── 🔴 逃生門:照訊息打那一行,就要真的過得去 ──────────────────"
|
||||
clean_stamps
|
||||
touch "$KBDB_STAMP_DIR/.kbdb-down" # ← 訊息裡原文那一行做的事
|
||||
check "③ touch 出來的空檔(本票的實撞)→ 要放行過第 0 道" "$(run "$VICTIM")" 2
|
||||
# ↑ 期望仍是 2:過了第 0 道之後會被「歷史警察」擋(這個檔真的有前科),
|
||||
# 所以要看訊息換人了沒——這是這支測試最容易寫錯的一格。
|
||||
grep -q "歷史警察" "$TMP/err" && printf ' ✅ ④ 擋人的換成歷史警察 ⇒ 第 0 道確實被逃生門放過了\n' && PASS=$((PASS+1)) || { printf ' ❌ ④ 還是卡在 KBDB 那一道 ⇒ 逃生門是假的\n'; sed 's/^/ /' "$TMP/err" | head -4; FAIL=$((FAIL+1)); }; N=$((N+1))
|
||||
|
||||
clean_stamps
|
||||
date +%s > "$KBDB_STAMP_DIR/.kbdb-down" # 舊格式(檔案內容是時戳)
|
||||
run "$VICTIM" >/dev/null
|
||||
grep -q "歷史警察" "$TMP/err" && printf ' ✅ ⑤ 舊格式(內容寫時戳)照樣認得 ⇒ 沒有把既有的弄壞\n' && PASS=$((PASS+1)) || { printf ' ❌ ⑤ 舊格式壞了\n'; FAIL=$((FAIL+1)); }; N=$((N+1))
|
||||
|
||||
clean_stamps
|
||||
date +%s > "$KBDB_STAMP_DIR/.kbdb-asked"
|
||||
run "$VICTIM" >/dev/null
|
||||
grep -q "歷史警察" "$TMP/err" && printf ' ✅ ⑥ 真的問過 KBDB(kbdb-asked-stamp.sh 寫的戳記)→ 過第 0 道\n' && PASS=$((PASS+1)) || { printf ' ❌ ⑥ 問過了還被擋\n'; FAIL=$((FAIL+1)); }; N=$((N+1))
|
||||
|
||||
echo "── 過期的戳記不算數(逃生門不能變成永久後門)──────────────────"
|
||||
clean_stamps
|
||||
touch -t "$(date -v-2H '+%Y%m%d%H%M' 2>/dev/null || date -d '2 hours ago' '+%Y%m%d%H%M')" "$KBDB_STAMP_DIR/.kbdb-down"
|
||||
run "$VICTIM" >/dev/null
|
||||
grep -q "KBDB" "$TMP/err" && printf ' ✅ ⑦ 兩小時前的空戳記 → 過期,回到擋\n' && PASS=$((PASS+1)) || { printf ' ❌ ⑦ 過期的戳記還在放行 ⇒ 一次 touch 就永久免疫\n'; FAIL=$((FAIL+1)); }; N=$((N+1))
|
||||
|
||||
echo "── 不該擋的(誤攔比漏擋嚴重)────────────────────────────────"
|
||||
clean_stamps
|
||||
printf '# doc\n' > "$REPO/readme.md"
|
||||
check "⑧ 文件檔(.md)→ 一路放行,連第 0 道都不該碰" "$(run "$REPO/readme.md")" 0
|
||||
clean_stamps
|
||||
check "⑨ 不存在的新檔 → 放行" "$(run "$REPO/brand-new.sh")" 0
|
||||
clean_stamps
|
||||
mkdir -p "$REPO/tests"; printf 'echo t\n' > "$REPO/tests/a.sh"
|
||||
check "⑩ 測試檔 → 放行" "$(run "$REPO/tests/a.sh")" 0
|
||||
|
||||
echo
|
||||
printf '通過 %s 條,失敗 %s 條(共 %s 條)\n' "$PASS" "$FAIL" "$N"
|
||||
[ "$FAIL" = 0 ] || exit 1
|
||||
@@ -1,74 +0,0 @@
|
||||
#!/usr/bin/env bash
|
||||
# hooks/tests/lib/hook-sandbox.sh 的迴歸測試(inkstone/ISEP#122)
|
||||
#
|
||||
# 🔴 為什麼有這支(2026-09-02 實撞,證據在票上):
|
||||
# `hook_sandbox` 的第一個參數是「那支 hook 的檔案路徑」,傳錯時舊版不檢查就
|
||||
# `cp -R "$(dirname "$1")"` ⇒ 複製的是上一層。傳 repo 根目錄進去,
|
||||
# 複製的就是**整個 tech_projects**:兩次吃掉 23 GB,磁碟剩 462 MB,
|
||||
# 而它只印一句「沙盒建不起來」——**沒說參數錯,也沒說它已經把磁碟寫滿**。
|
||||
#
|
||||
# 所以這支測的不是「錯誤訊息好不好看」,是**收手的時機**:
|
||||
# ④⑤ 兩條驗「複製之前就 return 1」——暫存區裡不准留下任何東西。
|
||||
#
|
||||
# 用法:bash hooks/tests/hook-sandbox.test.sh
|
||||
set -u
|
||||
HERE=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
|
||||
ROOT=$(CDPATH= cd -- "$HERE/.." && pwd) # …/hooks
|
||||
REPO=$(CDPATH= cd -- "$ROOT/.." && pwd)
|
||||
PASS=0; FAIL=0
|
||||
ok(){ printf ' ✅ %s\n' "$1"; PASS=$((PASS+1)); }
|
||||
no(){ printf ' ❌ %s —— %s\n' "$1" "$2"; FAIL=$((FAIL+1)); }
|
||||
|
||||
# 每一條都在自己的子殼裡跑:hook_sandbox 會設全域變數,不隔離會互相污染。
|
||||
run(){ # run <參數> → 印 "rc|沙盒路徑|訊息"
|
||||
( . "$HERE/lib/hook-sandbox.sh"
|
||||
msg=$(hook_sandbox "$1" 2>&1); rc=$?
|
||||
printf '%s|%s|%s' "$rc" "${HOOK_SANDBOX:-}" "$(printf '%s' "$msg" | tr '\n' ' ')"
|
||||
)
|
||||
}
|
||||
|
||||
echo "── 該收手(傳錯參數)──────────────────────────────────────"
|
||||
|
||||
r=$(run "$REPO"); rc=${r%%|*}; rest=${r#*|}; sb=${rest%%|*}; msg=${rest#*|}
|
||||
[ "$rc" = "1" ] && ok "① 傳 repo 根目錄(本票的實撞)→ return 1" \
|
||||
|| no "① 傳 repo 根目錄(本票的實撞)→ return 1" "實得 rc=$rc"
|
||||
case "$msg" in *"hooks/main-and-prod-push-guard.sh"*)
|
||||
ok "② 訊息給得出一行**真的跑得起來**的用法" ;;
|
||||
*) no "② 訊息給得出一行**真的跑得起來**的用法" "訊息:$msg" ;;
|
||||
esac
|
||||
if [ -z "$sb" ] || [ ! -d "$sb" ]; then ok "③ 收手在 mktemp 之前,暫存區沒有殘骸"
|
||||
else no "③ 收手在 mktemp 之前,暫存區沒有殘骸" "留下了 $sb"; fi
|
||||
|
||||
r=$(run ""); [ "${r%%|*}" = "1" ] && ok "④ 空參數 → return 1(不是拿空字串去 dirname)" \
|
||||
|| no "④ 空參數 → return 1" "實得 rc=${r%%|*}"
|
||||
|
||||
r=$(run "$REPO/scripts/ticket"); rc=${r%%|*}; rest=${r#*|}; sb=${rest%%|*}
|
||||
if [ "$rc" = "1" ]; then ok "⑤ 檔案存在但上一層不是 hooks/ → 一樣收手"
|
||||
else no "⑤ 檔案存在但上一層不是 hooks/ → 一樣收手" "實得 rc=$rc"; fi
|
||||
if [ -z "$sb" ] || [ ! -d "$sb" ]; then ok "⑥ ⑤ 這條也沒把 scripts/ 複製出去"
|
||||
else no "⑥ ⑤ 這條也沒把 scripts/ 複製出去" "留下了 $sb"; fi
|
||||
|
||||
r=$(run "$ROOT/沒有這支.sh"); [ "${r%%|*}" = "1" ] && ok "⑦ 路徑不存在 → return 1" \
|
||||
|| no "⑦ 路徑不存在 → return 1" "實得 rc=${r%%|*}"
|
||||
|
||||
echo "── 不准把本來會過的弄壞(誤攔比漏擋嚴重)────────────────────"
|
||||
( . "$HERE/lib/hook-sandbox.sh"
|
||||
hook_sandbox "$ROOT/main-and-prod-push-guard.sh"; rc=$?
|
||||
if [ "$rc" != "0" ]; then echo "RC=$rc"; exit 0; fi
|
||||
[ -f "$HOOK_SANDBOX_HOOK" ] && echo "HOOKOK"
|
||||
[ -d "$HOOK_SANDBOX/hooks/lib" ] && echo "LIBOK"
|
||||
# 只複製 hooks/,不該把 repo 的其他目錄帶進來
|
||||
[ -d "$HOOK_SANDBOX/hooks/scripts" ] && echo "LEAK"
|
||||
hook_sandbox_cleanup
|
||||
) > /tmp/.hs-ok.$$ 2>&1
|
||||
grep -q HOOKOK /tmp/.hs-ok.$$ && ok "⑧ 正常用法照樣建得起來,複本裡有那支 hook" \
|
||||
|| no "⑧ 正常用法照樣建得起來" "$(cat /tmp/.hs-ok.$$)"
|
||||
grep -q LIBOK /tmp/.hs-ok.$$ && ok "⑨ 整個 hooks/(含 lib/)都在複本裡" \
|
||||
|| no "⑨ 整個 hooks/(含 lib/)都在複本裡" "$(cat /tmp/.hs-ok.$$)"
|
||||
grep -q LEAK /tmp/.hs-ok.$$ && no "⑩ 只複製 hooks/,沒有把 repo 其他目錄帶進去" "複本裡出現 scripts/" \
|
||||
|| ok "⑩ 只複製 hooks/,沒有把 repo 其他目錄帶進去"
|
||||
rm -f /tmp/.hs-ok.$$
|
||||
|
||||
echo
|
||||
echo "通過 $PASS 條,失敗 $FAIL 條(共 $((PASS+FAIL)) 條)"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
@@ -25,21 +25,9 @@ mkplugin() {
|
||||
cp "$HOOK" "$d/hooks/$(basename "$HOOK")"
|
||||
cp "$REAL_HOOKS/lib/beacon_report.py" "$d/hooks/lib/beacon_report.py"
|
||||
printf '#!/bin/sh\necho real\n' > "$d/scripts/ticket"
|
||||
# inkstone/ISEP#122:會自動載入的東西(skill/command/agent)也要造得出來
|
||||
mkdir -p "$d/skills/demo" "$d/commands" "$d/agents" "$d/docs"
|
||||
printf 'PLUGIN 版的 skill\n' > "$d/skills/demo/SKILL.md"
|
||||
printf 'PLUGIN 版的 command\n' > "$d/commands/demo.md"
|
||||
printf 'PLUGIN 版的 agent\n' > "$d/agents/demo.md"
|
||||
printf '%s\n' "$d"
|
||||
}
|
||||
|
||||
# mkown <plugin root> <列...> → 寫一份 docs/file-ownership.tsv(欄位用真正的 TAB)
|
||||
mkown() {
|
||||
d="$1"; shift; mkdir -p "$d/docs"
|
||||
{ printf '# 測試用\n'; for row in "$@"; do printf '%s\n' "$row"; done; } \
|
||||
| sed 's/|/\t/g' > "$d/docs/file-ownership.tsv"
|
||||
}
|
||||
|
||||
# run <plugin root> <project dir> → 印出 systemMessage(JSON 壞掉就印 __BADJSON__)
|
||||
run() {
|
||||
CLAUDE_PLUGIN_ROOT="$1" CLAUDE_PROJECT_DIR="$2" bash "$1/hooks/$(basename "$HOOK")" 2>/dev/null \
|
||||
@@ -124,72 +112,6 @@ printf '#!/bin/sh\necho "OLD"\n' > "$J6/scripts/ticket"
|
||||
out=$(run "$P" "$J6")
|
||||
check "⑭ 報告內容含引號 → JSON 仍然合法" "$out" "🟢 ISEP" "!__BADJSON__"
|
||||
|
||||
P2=$(mkplugin 1.0.0) # ⑫⑬ 會刪掉 $P 的 report,這一組要自己一份
|
||||
echo "── ②b 會自動載入的東西也有分身(inkstone/ISEP#122)──────────────"
|
||||
# 🔴 這一組守的是 ship-check 那件:plugin 帶著舊描述,而舊描述在「我要發部落格文章」
|
||||
# 的情境根本不會被觸發 ⇒ 那個 session 永遠載不到出貨流程,而且不會有任何症狀。
|
||||
JS="$TMP/proj-skill"; mkdir -p "$JS/.claude/skills/demo"
|
||||
printf '專案版的 skill(比較舊)\n' > "$JS/.claude/skills/demo/SKILL.md"
|
||||
out=$(run "$P2" "$JS")
|
||||
check "⑮ 專案有同名 skill 而內容不同 → 要點名" "$out" \
|
||||
"會自動載入的東西兩邊各有一份" "skills/demo/SKILL.md" ".claude/skills/demo/SKILL.md"
|
||||
check "⑯ 歸屬表沒登記 → 誠實說未定,不要替人猜方向" "$out" "歸屬未定"
|
||||
|
||||
JS2="$TMP/proj-skill-same"; mkdir -p "$JS2/.claude/skills/demo"
|
||||
cp "$P2/skills/demo/SKILL.md" "$JS2/.claude/skills/demo/SKILL.md"
|
||||
out=$(run "$P2" "$JS2")
|
||||
check "⑰ 內容一模一樣 → 不吵(誤攔比漏擋嚴重)" "$out" "!會自動載入的東西兩邊各有一份"
|
||||
|
||||
JC="$TMP/proj-cmd"; mkdir -p "$JC/.claude/commands"
|
||||
printf '專案版的 command(比較舊)\n' > "$JC/.claude/commands/demo.md"
|
||||
out=$(run "$P2" "$JC")
|
||||
check "⑱ command 也要掃(sdd-check 那件)" "$out" "commands/demo.md" ".claude/commands/demo.md"
|
||||
|
||||
JA="$TMP/proj-agent"; mkdir -p "$JA/.claude/agents"
|
||||
printf '專案版的 agent(比較舊)\n' > "$JA/.claude/agents/demo.md"
|
||||
out=$(run "$P2" "$JA")
|
||||
check "⑲ agent 也要掃" "$out" "agents/demo.md" ".claude/agents/demo.md"
|
||||
|
||||
JCL="$TMP/proj-cloud"; mkdir -p "$JCL/InkStoneCo/.claude/skills/demo"
|
||||
printf '專案版的 skill(比較舊)\n' > "$JCL/InkStoneCo/.claude/skills/demo/SKILL.md"
|
||||
out=$(run "$P2" "$JCL")
|
||||
check "⑳ 雲端排法:真身在 \$TOP/InkStoneCo/ 底下也要抓到" "$out" \
|
||||
"InkStoneCo/.claude/skills/demo/SKILL.md"
|
||||
|
||||
echo "── 歸屬表要講得出「往哪個方向修」──────────────────────────────"
|
||||
PO=$(mkplugin 1.0.1)
|
||||
mkown "$PO" "skills/demo/SKILL.md|inkstone/InkStoneCo|.claude/skills/demo/SKILL.md|abc1234|-"
|
||||
out=$(run "$PO" "$JS")
|
||||
check "㉑ 真相源=InkStoneCo → 說「內容改在那裡」並給得出路徑" "$out" \
|
||||
"真相源=inkstone/InkStoneCo:.claude/skills/demo/SKILL.md" "內容改在那裡" "!歸屬未定"
|
||||
|
||||
mkown "$PO" "skills/demo/SKILL.md|inkstone/ISEP|-|-|-"
|
||||
out=$(run "$PO" "$JS")
|
||||
check "㉒ 真相源=ISEP → 說「專案那份是舊複本」" "$out" \
|
||||
"真相源=ISEP 這一份" "舊複本" "!歸屬未定"
|
||||
|
||||
echo "── ②c 沒有專案那一份也要驗得出來(雲端唯一作數的檢查)────────────"
|
||||
# 雲端的 project dir 是薄殼,沒有 InkStoneCo 可以比 ⇒ 只剩「檔案 vs 表上的 sha256」
|
||||
SHA=$(shasum -a 256 "$PO/skills/demo/SKILL.md" | cut -d" " -f1)
|
||||
mkown "$PO" "skills/demo/SKILL.md|inkstone/InkStoneCo|.claude/skills/demo/SKILL.md|abc1234|$SHA"
|
||||
out=$(run "$PO" "$J")
|
||||
check "㉓ sha256 對得上(而且專案那份不存在)→ 一個字都不說" "$out" \
|
||||
"🟢 ISEP v1.0.1 已載入" "!跟歸屬表對不上" "!會自動載入的東西兩邊各有一份"
|
||||
|
||||
printf '被就地改過\n' >> "$PO/skills/demo/SKILL.md"
|
||||
out=$(run "$PO" "$J")
|
||||
check "㉔ 檔案被就地改過 → 就算沒有專案那份,也要抓得到" "$out" \
|
||||
"跟歸屬表對不上" "skills/demo/SKILL.md" "abc1234"
|
||||
|
||||
mkown "$PO" "skills/demo/SKILL.md|inkstone/InkStoneCo|.claude/skills/demo/SKILL.md|abc1234|-"
|
||||
out=$(run "$PO" "$J")
|
||||
check "㉕ 表上 sha 欄是 \`-\` → 這一格閉嘴(還沒登記不是錯)" "$out" "!跟歸屬表對不上"
|
||||
|
||||
echo "── 加了這兩格也不准讓信標消失 ────────────────────────────────"
|
||||
out=$(run "$P2" "$JS")
|
||||
check "㉖ ②b 有報告時,那行綠色信標仍在且 JSON 合法" "$out" \
|
||||
"🟢 ISEP v1.0.0 已載入" "!__BADJSON__"
|
||||
|
||||
echo
|
||||
printf '通過 %s 條,失敗 %s 條(共 %s 條)\n' "$PASS" "$FAIL" "$N"
|
||||
[ "$FAIL" = 0 ] || exit 1
|
||||
|
||||
@@ -1,78 +0,0 @@
|
||||
#!/usr/bin/env bash
|
||||
# leo21c-write-guard.sh 的迴歸測試(inkstone/ISEP#130)
|
||||
#
|
||||
# ── 這支在守什麼 ──────────────────────────────────────────────────────
|
||||
# 閘的判準是「**讀可以,寫不行**」(leo 2026-08-20:leo21c 是他本人在用的知識庫)。
|
||||
# 2026-09-04 雲端 Routine 的 run log:**讀 notify_leo 的定義被擋** ——
|
||||
# 讀都讀不到,雲端就什麼都拿不到(inkstone/ISEP#130 開票的第一件)。
|
||||
#
|
||||
# 這支之前**沒有任何測試**,所以「讀會不會被誤攔」從來沒被驗過。
|
||||
# 下面的測資是 Routine 文件(cloud-worker.md/progress-guard.md)裡**真的會下的那幾條指令**,
|
||||
# 不是想像出來的例子。
|
||||
#
|
||||
# 🔴 三個方向都要驗,缺一個就是假綠:
|
||||
# A 讀 ⇒ 放行(含 `tr -d`/`cut -d=` 這種唯讀的 -d,那正是 09-04 被擋的形狀)
|
||||
# B 寫 ⇒ 擋(心跳 POST/PATCH 收件匣/部署端點/別的 trigger)
|
||||
# C 閘印出來的「改法」指的是**現役**的 youlin 網址,不是 09-02 已死的舊名
|
||||
#
|
||||
# 這支閘不寫任何檔案,直接跑真跡即可;全程離線。
|
||||
# 用法:bash hooks/tests/leo21c-write-guard.test.sh
|
||||
set -u
|
||||
HERE=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
|
||||
HOOK="$HERE/../leo21c-write-guard.sh"
|
||||
PASS=0; FAIL=0
|
||||
mk(){ python3 -c "import json,sys;print(json.dumps({'tool_name':'Bash','tool_input':{'command':sys.argv[1]}}))" "$1"; }
|
||||
t(){ # t <期望 pass|block> <說明> <指令>
|
||||
LAST_ERR=$(mk "$3" | bash "$HOOK" 2>&1 >/dev/null); rc=$?
|
||||
got=$([ "$rc" -eq 2 ] && echo block || echo pass)
|
||||
if [ "$got" = "$1" ]; then echo " ✅ $2"; PASS=$((PASS+1))
|
||||
else echo " ❌ $2 —— 期望 $1,實得 $got(rc=$rc)"; FAIL=$((FAIL+1)); fi
|
||||
}
|
||||
|
||||
L='https://arcrun-cypher-executor.leo21c.workers.dev'
|
||||
K='-H "X-Arcrun-API-Key: leo"'
|
||||
D='-d'
|
||||
|
||||
echo "── A. 讀 ⇒ 放行(雲端 Routine 真的會下的形狀)──"
|
||||
t pass "① 讀收件匣(progress-guard.md 步驟 0 原句)" "curl -s \"$L/kbdb/entries?entry_type=inbox&limit=20\" $K"
|
||||
t pass "② 讀 notify_leo 定義(09-04 被擋的那一條)" "curl -s $L/webhooks/named/leo/notify_leo $K"
|
||||
t pass "③ 讀 + tr -d(唯讀的 -d,不是 body)" "curl -s $L/workflows/notify_leo $K | tr $D '\\r'"
|
||||
t pass "④ 讀 + cut -d=" "NS=\$(grep ns cfg | cut ${D}= -f2); curl -s $L/kbdb/entries?limit=1 $K"
|
||||
t pass "⑤ 讀 + sort -d / date -d" "curl -s $L/health | sort $D; date $D yesterday"
|
||||
t pass "⑥ 明寫 -X GET" "curl -s -X GET $L/kbdb/entries?entry_type=dash_beat $K"
|
||||
t pass "⑦ 讀心跳(progress-guard 2.6 原句)" "curl -s \"$L/kbdb/entries?entry_type=dash_beat&limit=30\" $K"
|
||||
t pass "⑧ git commit 訊息提到 leo21c 與 POST(git 寫不到那台)" "git commit -m 'fix: curl -X POST $L/kbdb/entries 會被擋'"
|
||||
t pass "⑨ 修這道閘自己" "sed -i 's/a/b/' hooks/leo21c-write-guard.sh"
|
||||
t pass "⑩ 打 youlin(09-02 起的新子網域)POST,不是 leo21c" "curl -X POST https://arcrun-cypher-executor.arcrun-yuga3bse.workers.dev/webhooks/named $D '{}'"
|
||||
t pass "⑪ 用 youlin 的 CF 帳號部署" "CLOUDFLARE_ACCOUNT_ID=1129efd7df2e8899d537e9c8fbabb6cb npx wrangler deploy"
|
||||
t pass "⑫ 發一則 notify_leo(通知型 trigger,什麼都沒改;同 prod-write-guard 白名單)" "curl -s -X POST $L/webhooks/named/leo/notify_leo/trigger -H 'Content-Type: application/json' $D '{\"text\":\"[總管] hi\"}'"
|
||||
|
||||
echo "── B. 寫 ⇒ 擋 ──"
|
||||
t block "⑬ 打心跳 POST(cloud-worker.md 步驟 0 原句——它寫進 leo 的庫)" "curl -s -X POST \"$L/kbdb/entries\" $K -H 'Content-Type: application/json' $D '{\"entry_type\":\"dash_beat\"}'"
|
||||
t block "⑭ PATCH 收件匣" "curl -s -X PATCH \"$L/kbdb/entries/123\" $K $D '{\"content\":\"x\"}'"
|
||||
t block "⑮ DELETE" "curl -X DELETE $L/kbdb/entries/1 $K"
|
||||
t block "⑯ 只帶 -d 的隱式 POST" "curl $L/kbdb/entries $D '{}'"
|
||||
t block "⑰ --data-urlencode" "curl $L/kbdb/entries --data-urlencode text=hi"
|
||||
t block "⑱ --request PUT" "curl --request PUT $L/kbdb/entries/1 $D '{}'"
|
||||
t block "⑲ 別的工作流 trigger(ship_refresh_cdn 會動線上狀態)" "curl -X POST $L/webhooks/named/leo/ship_refresh_cdn/trigger $D '{}'"
|
||||
t block "⑳ 部署端點(無名字的 named webhook)" "curl -X POST $L/webhooks/named $D @def.yaml"
|
||||
t block "㉑ notify_leo 旁邊夾一個部署端點" "curl -X POST $L/webhooks/named/leo/notify_leo/trigger $D '{}' && curl -X POST $L/webhooks/named $D @x"
|
||||
t block "㉒ 寫 + tr -d(剪掉唯讀 -d 之後仍該擋)" "cat f | tr $D '\\r' | curl -X POST $L/kbdb/entries $D @-"
|
||||
t block "㉓ 用 leo21c 的 CF 帳號部署" "CLOUDFLARE_ACCOUNT_ID=51a01bfa2665bd7bc3fd080dc40cf3e1 npx wrangler deploy"
|
||||
|
||||
echo "── C. 擋下時印的改法要指到活著的 youlin ──"
|
||||
mk "curl -X POST $L/kbdb/entries $D '{}'" | bash "$HOOK" 2>"$HERE/.leo21c-msg.$$" >/dev/null
|
||||
MSG=$(cat "$HERE/.leo21c-msg.$$"); rm -f "$HERE/.leo21c-msg.$$"
|
||||
if printf '%s' "$MSG" | grep -q 'arcrun-cypher-executor.arcrun-yuga3bse.workers.dev'; then
|
||||
echo " ✅ ㉔ 改法段印的是現役子網域 arcrun-yuga3bse"; PASS=$((PASS+1))
|
||||
else echo " ❌ ㉔ 改法段沒有現役子網域 arcrun-yuga3bse"; FAIL=$((FAIL+1)); fi
|
||||
if printf '%s' "$MSG" | grep -q 'cypher : https://arcrun-cypher-executor.youlin-hsieh-dev'; then
|
||||
echo " ❌ ㉕ 改法段還教人打 09-02 已死的 youlin-hsieh-dev"; FAIL=$((FAIL+1))
|
||||
else echo " ✅ ㉕ 改法段不再把死的舊名當網址教人"; PASS=$((PASS+1)); fi
|
||||
if printf '%s' "$MSG" | grep -q '讀可以,寫不行'; then
|
||||
echo " ✅ ㉖ 訊息講得出判準(讀可以,寫不行)"; PASS=$((PASS+1))
|
||||
else echo " ❌ ㉖ 訊息沒講判準"; FAIL=$((FAIL+1)); fi
|
||||
|
||||
echo
|
||||
echo "通過 $PASS 條,失敗 $FAIL 條"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
@@ -39,38 +39,9 @@
|
||||
# ⇒ hostsum 兩次都回 `NODIR`(相等)、沙盒的請求數當然是 0
|
||||
# ⇒ **第一條斷言變成「拿空的比空的」的假綠**。
|
||||
# 所以改成「設變數、不印」,而且 hook_sandbox_assert 開頭會擋空值(見下)。
|
||||
#
|
||||
# 🔴 **先驗參數再複製**(inkstone/ISEP#122,2026-09-02 實撞,本檔第二次修):
|
||||
# `$1` 是「那支 hook 的路徑」。傳錯(例如順手傳了 repo 根目錄)時,舊版不檢查就
|
||||
# `cp -R "$(dirname "$1")" …` ⇒ **複製的是那個目錄的上一層**。
|
||||
# 當天實測:`bash hooks/tests/main-and-prod-push-guard.test.sh "$PWD"`
|
||||
# ⇒ dirname 變成 ~/Documents/tech_projects
|
||||
# ⇒ 把 **整個 tech_projects**(所有 repo、所有 worktree)複製進 mktemp
|
||||
# ⇒ 兩次就吃掉 23 GB,磁碟從 25 GB 剩到 462 MB,`cp` 一路吐
|
||||
# `No space left on device`,最後才印一句「❌ 沙盒建不起來」。
|
||||
# ⇒ 訊息只說「建不起來」,**沒說是參數傳錯,也沒說它已經把磁碟寫滿了**。
|
||||
# 判準用「要求某個東西在場」,不是關鍵字比對:
|
||||
# ① `$1` 要指到一個**真的檔案**(傳目錄、傳空字串都不算)
|
||||
# ② 它的上一層目錄名要叫 `hooks`(沙盒的前提就是「複製一整個 hooks/」)
|
||||
# 兩條任一不成立就**在複製之前**收手,並印出走得通的那一行。
|
||||
hook_sandbox() {
|
||||
_hs_real=$1
|
||||
if [ -z "${_hs_real:-}" ] || [ ! -f "$_hs_real" ]; then
|
||||
printf '❌ hook_sandbox:第一個參數要是「那支 hook 的檔案路徑」,實得 %s\n' \
|
||||
"${_hs_real:-(空的)}" >&2
|
||||
printf ' 例:bash hooks/tests/main-and-prod-push-guard.test.sh hooks/main-and-prod-push-guard.sh\n' >&2
|
||||
printf ' (不必自己傳的版本:bash scripts/test-main-and-prod-push-guard.sh)\n' >&2
|
||||
return 1
|
||||
fi
|
||||
_hs_hooks=$(CDPATH= cd -- "$(dirname -- "$_hs_real")" && pwd) || return 1
|
||||
if [ "$(basename "$_hs_hooks")" != "hooks" ]; then
|
||||
printf '❌ hook_sandbox:%s 的上一層不是 hooks/,而沙盒要複製的就是那個目錄。\n' \
|
||||
"$_hs_real" >&2
|
||||
printf ' 算出來的來源是 %s——照複製下去會把它整個搬進暫存區(2026-09-02 這樣寫滿過磁碟)。\n' \
|
||||
"$_hs_hooks" >&2
|
||||
printf ' 例:bash hooks/tests/main-and-prod-push-guard.test.sh hooks/main-and-prod-push-guard.sh\n' >&2
|
||||
return 1
|
||||
fi
|
||||
HOOK_SANDBOX=$(mktemp -d) || return 1
|
||||
cp -R "$_hs_hooks" "$HOOK_SANDBOX/hooks" || return 1
|
||||
HOOK_SANDBOX_HOST="${_hs_hooks%/hooks}/pending-main-push"
|
||||
|
||||
@@ -21,7 +21,6 @@ MAINLINE="$ROOT/../scripts/mainline"
|
||||
TMP=$(mktemp -d)
|
||||
trap 'rm -rf "$TMP"' EXIT
|
||||
export ISEP_COUNTDOWN_STATE_DIR="$TMP/state"
|
||||
export ISEP_MAINLINE_REPO_FILE=none # 把 repo 那份鏡像拿掉(inkstone/ISEP#130):這支測的是家目錄那份
|
||||
export TICKET_HOST="http://127.0.0.1:9" # 連不上:走到網路就會馬上失敗
|
||||
mkdir -p "$ISEP_COUNTDOWN_STATE_DIR"
|
||||
unset ISEP_MAINLINE_FIXTURE
|
||||
|
||||
@@ -1,117 +0,0 @@
|
||||
#!/usr/bin/env bash
|
||||
# 主線那個檔「隨 repo 走」的迴歸測試(inkstone/ISEP#130)
|
||||
#
|
||||
# ── 這支在守什麼 ──────────────────────────────────────────────────────
|
||||
# 主線原本只住在家目錄(`~/.claude/isep-countdown/mainline.json`)。雲端是另一台機器,
|
||||
# 家目錄空的、clone 下來的 repo 才是它拿得到的東西 ⇒ 2026-09-05 leo:
|
||||
# 「routine 每天早上開啟後抓不到任務」。PR inkstone/InkStoneCo#118 把主線檔放進
|
||||
# `InkStoneCo/system-dev/mainline.json`,這裡驗 ISEP 這一半:
|
||||
# A 讀:家目錄沒有 ⇒ 讀 repo 那份(雲端的形狀:$CLAUDE_PROJECT_DIR 是薄殼根,真身在 InkStoneCo/)
|
||||
# B 兩份都在 ⇒ `set_at` 較新的算數,不分本機雲端
|
||||
# C 寫:`set`/`adopt`/`clear` 兩份一起動;`refresh` 那種只寫家目錄(不弄髒 InkStoneCo 工作樹)
|
||||
# D 哪裡都沒有 ⇒ 仍然答得出「現在沒有主線」(ISEP#82 驗收第 4 條沒有被本票弄壞)
|
||||
#
|
||||
# 用法:bash hooks/tests/mainline-repo-mirror.test.sh
|
||||
# 🔴 全程離線:狀態走 ISEP_COUNTDOWN_STATE_DIR、repo 那份走 TMP 底下的假 InkStoneCo、
|
||||
# TICKET_HOST 指到連不上的位址。不碰真家目錄、不碰真 InkStoneCo。
|
||||
set -u
|
||||
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
MAINLINE="$ROOT/../scripts/mainline"
|
||||
LIB="$ROOT/lib/mainline.py"
|
||||
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
|
||||
export ISEP_COUNTDOWN_STATE_DIR="$TMP/home-state"; mkdir -p "$ISEP_COUNTDOWN_STATE_DIR"
|
||||
export TICKET_HOST="http://127.0.0.1:9"
|
||||
unset ISEP_MAINLINE_REPO_FILE ISEP_MAINLINE_FIXTURE
|
||||
SHELL_ROOT="$TMP/shell"; HUB="$SHELL_ROOT/InkStoneCo"; mkdir -p "$HUB/system-dev"
|
||||
PASS=0; FAIL=0
|
||||
ok(){ printf ' ✅ %s\n' "$1"; PASS=$((PASS+1)); }
|
||||
no(){ printf ' ❌ %s —— %s\n' "$1" "$2"; FAIL=$((FAIL+1)); }
|
||||
|
||||
write_ms(){ # write_ms <檔> <標題> <set_at>
|
||||
python3 - "$1" "$2" "$3" <<'PY'
|
||||
import json, sys
|
||||
json.dump({"ref": "inkstone/Arcrun#48", "owner": "inkstone", "repo": "Arcrun", "id": 48,
|
||||
"title": sys.argv[2], "description": "測試用。", "due_on": "2026-09-13T23:59:59Z",
|
||||
"open_issues": 3, "closed_issues": 0, "members": ["inkstone/ISEP#130"],
|
||||
"set_at": sys.argv[3], "refreshed_at": sys.argv[3]},
|
||||
open(sys.argv[1], "w"), ensure_ascii=False, indent=2)
|
||||
PY
|
||||
}
|
||||
show(){ CLAUDE_PROJECT_DIR="$1" python3 "$MAINLINE" 2>&1 | head -1; }
|
||||
|
||||
echo "── A. 家目錄沒有 ⇒ 讀 repo 那份 ──"
|
||||
write_ms "$HUB/system-dev/mainline.json" "雲端才讀得到的那一條" "2026-09-07 07:30"
|
||||
OUT=$(show "$SHELL_ROOT")
|
||||
case "$OUT" in *"雲端才讀得到的那一條"*) ok "① \$CLAUDE_PROJECT_DIR 是薄殼根、真身在 InkStoneCo/(雲端的形狀)⇒ 答得出主線" ;;
|
||||
*) no "① 薄殼根形狀讀不到 repo 那份" "$OUT" ;; esac
|
||||
OUT=$(show "$HUB")
|
||||
case "$OUT" in *"雲端才讀得到的那一條"*) ok "② \$CLAUDE_PROJECT_DIR 直接是 InkStoneCo ⇒ 也答得出" ;;
|
||||
*) no "② InkStoneCo 根讀不到" "$OUT" ;; esac
|
||||
OUT=$(cd "$HUB" && env -u CLAUDE_PROJECT_DIR python3 "$MAINLINE" 2>&1 | head -1)
|
||||
case "$OUT" in *"雲端才讀得到的那一條"*) ok "③ 沒設 \$CLAUDE_PROJECT_DIR、只是 cwd 在 InkStoneCo ⇒ 也答得出" ;;
|
||||
*) no "③ cwd 形狀讀不到" "$OUT" ;; esac
|
||||
[ ! -e "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" ] && ok "④ 只是讀,家目錄那份沒有被順手建出來" \
|
||||
|| no "④ 讀的時候寫了家目錄" "$(ls "$ISEP_COUNTDOWN_STATE_DIR")"
|
||||
|
||||
echo "── B. 兩份都在 ⇒ set_at 較新的算數 ──"
|
||||
write_ms "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" "本機舊的" "2026-09-01 10:00"
|
||||
OUT=$(show "$SHELL_ROOT")
|
||||
case "$OUT" in *"雲端才讀得到的那一條"*) ok "⑤ repo 那份較新(別台機器後標的)⇒ 用 repo 那份" ;;
|
||||
*) no "⑤ 沒用較新的 repo 那份" "$OUT" ;; esac
|
||||
write_ms "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" "本機新的" "2026-09-08 09:00"
|
||||
OUT=$(show "$SHELL_ROOT")
|
||||
case "$OUT" in *"本機新的"*) ok "⑥ 家目錄那份較新 ⇒ 用家目錄那份" ;;
|
||||
*) no "⑥ 沒用較新的家目錄那份" "$OUT" ;; esac
|
||||
write_ms "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" "同時標的(家目錄)" "2026-09-07 07:30"
|
||||
OUT=$(show "$SHELL_ROOT")
|
||||
case "$OUT" in *"同時標的(家目錄)"*) ok "⑦ 一樣新 ⇒ 家目錄那份(它才有 refresh 過的進度)" ;;
|
||||
*) no "⑦ 平手沒選家目錄" "$OUT" ;; esac
|
||||
|
||||
echo "── C. 寫:誰該動 repo 那份 ──"
|
||||
R=$(CLAUDE_PROJECT_DIR="$SHELL_ROOT" python3 - "$LIB" "$HUB/system-dev/mainline.json" <<'PY'
|
||||
import importlib.util, json, os, sys
|
||||
spec = importlib.util.spec_from_file_location("ml", sys.argv[1]); ML = importlib.util.module_from_spec(spec); spec.loader.exec_module(ML)
|
||||
rp = sys.argv[2]
|
||||
before = open(rp).read()
|
||||
d = ML.load(); d["refreshed_at"] = "2026-09-09 00:00"; d["open_issues"] = 1
|
||||
ML.save(d) # refresh 的形狀:只寫家目錄
|
||||
r1 = open(rp).read() == before
|
||||
d["title"] = "set 之後的新主線"; d["set_at"] = "2026-09-09 00:01"
|
||||
ML.save(d, mirror=True) # set/adopt 的形狀:兩份一起
|
||||
r2 = json.load(open(rp)).get("title") == "set 之後的新主線"
|
||||
r3 = json.load(open(ML.path())).get("title") == "set 之後的新主線"
|
||||
r4 = open(rp).read().endswith("\n")
|
||||
print("|".join(str(x) for x in (r1, r2, r3, r4)))
|
||||
PY
|
||||
)
|
||||
[ "${R%%|*}" = "True" ] && ok "⑧ save()(refresh 的形狀)不碰 repo 那份——不弄髒 InkStoneCo 工作樹" || no "⑧ refresh 動了 repo 那份" "$R"
|
||||
R2=${R#*|}; [ "${R2%%|*}" = "True" ] && ok "⑨ save(mirror=True)(set/adopt 的形狀)寫進 repo 那份" || no "⑨ mirror 沒寫 repo" "$R"
|
||||
R3=${R2#*|}; [ "${R3%%|*}" = "True" ] && ok "⑩ 同一次也寫了家目錄那份" || no "⑩ 家目錄沒寫" "$R"
|
||||
[ "${R##*|}" = "True" ] && ok "⑪ repo 那份收尾有換行(diff 才不會每次多一行 no newline)" || no "⑪ 沒換行" "$R"
|
||||
|
||||
OUT=$(CLAUDE_PROJECT_DIR="$SHELL_ROOT" python3 "$MAINLINE" clear 2>&1)
|
||||
if [ ! -e "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" ] && [ ! -e "$HUB/system-dev/mainline.json" ]; then
|
||||
ok "⑫ clear ⇒ 兩份都拿掉(否則下次讀又從 repo 那份長回來)"
|
||||
else no "⑫ clear 沒清乾淨" "$(ls "$ISEP_COUNTDOWN_STATE_DIR" "$HUB/system-dev" 2>&1 | tr '\n' ' ')"; fi
|
||||
case "$OUT" in *"repo 那份也刪了"*) ok "⑬ clear 講得出 repo 那份也動了(要 commit 才到雲端)" ;; *) no "⑬ clear 沒講 repo 那份" "$OUT" ;; esac
|
||||
|
||||
# set 要打網路,這裡只驗它印出來的那段「repo 那份寫了沒」是接在 repo_path 上的
|
||||
R=$(CLAUDE_PROJECT_DIR="$SHELL_ROOT" python3 - "$LIB" "$HUB" <<'PY'
|
||||
import importlib.util, os, sys
|
||||
spec = importlib.util.spec_from_file_location("ml", sys.argv[1]); ML = importlib.util.module_from_spec(spec); spec.loader.exec_module(ML)
|
||||
print(ML.repo_path(for_write=True) == os.path.join(sys.argv[2], "system-dev", "mainline.json"))
|
||||
PY
|
||||
)
|
||||
[ "$R" = "True" ] && ok "⑭ 檔還不存在時,寫的目標仍指到 InkStoneCo/system-dev/(set 建得出它)" || no "⑭ 寫的目標不對" "$R"
|
||||
|
||||
echo "── D. 哪裡都沒有 ⇒ 仍然答得出「現在沒有主線」 ──"
|
||||
OUT=$(show "$SHELL_ROOT")
|
||||
case "$OUT" in *"現在沒有主線"*) ok "⑮ 兩份都沒有 ⇒ 「現在沒有主線」(ISEP#82 第 4 條沒被弄壞)" ;; *) no "⑮ 沒主線時答不出來" "$OUT" ;; esac
|
||||
OUT=$(ISEP_MAINLINE_REPO_FILE=none show "$SHELL_ROOT")
|
||||
case "$OUT" in *"現在沒有主線"*) ok "⑯ ISEP_MAINLINE_REPO_FILE=none ⇒ 不看 repo(既有測試靠它把外界定住)" ;; *) no "⑯ none 沒生效" "$OUT" ;; esac
|
||||
printf 'not json' > "$HUB/system-dev/mainline.json"
|
||||
OUT=$(show "$SHELL_ROOT")
|
||||
case "$OUT" in *"現在沒有主線"*) ok "⑰ repo 那份壞掉 ⇒ 當成沒有,不炸" ;; *) no "⑰ 壞檔炸了" "$OUT" ;; esac
|
||||
|
||||
echo; echo "通過 $PASS 條,失敗 $FAIL 條"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
@@ -23,7 +23,6 @@ t pass "GET + sort -d / xargs -d" "ls | sort $DASH_D | xargs $DASH_D '\\n' echo;
|
||||
t pass "GET 帶 Bearer 標頭" "curl -s -H 'Authorization: Bearer xxx' $H/templates?limit=1"
|
||||
t pass "打 staging" "curl -X POST https://arcrun-rag-installer-staging.workers.dev/x $DASH_D '{}'"
|
||||
t pass "打 youlin 測試場" "curl -X POST https://arcrun-cypher-executor.youlin-hsieh-dev.workers.dev/x $DASH_D '{}'"
|
||||
t pass "打 youlin 測試場(09-02 重裝後的子網域 arcrun-yuga3bse,inkstone/ISEP#130)" "curl -X POST https://arcrun-cypher-executor.arcrun-yuga3bse.workers.dev/webhooks/named $DASH_D @def.yaml"
|
||||
t pass "打 Gitea(不是實例)" "curl -X POST https://git.uncle6.me/api/v1/repos/Leo/x/issues $DASH_D '{}'"
|
||||
|
||||
echo "── 該擋(寫入)──"
|
||||
|
||||
@@ -1,158 +0,0 @@
|
||||
#!/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 的實況,不寫死清單)
|
||||
# macOS 內建 bash 是 3.2,沒有 mapfile/readarray——用相容寫法收陣列
|
||||
# (同 scripts/gitea-labels-sync.sh:56 的前例;2026-09-01 inkstone/ISEP#115 實撞:
|
||||
# 這支測試在 leo 的 mac 上一次都沒跑成功過,離開碼 1,而 TESTING.md 標著「通過 8」)
|
||||
WRITE_HOOKS=()
|
||||
while IFS= read -r _l; do WRITE_HOOKS+=("$_l"); done < <(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[@]:-0}" -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
|
||||
Executable
+90
@@ -0,0 +1,90 @@
|
||||
#!/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
|
||||
+1
-57
@@ -42,8 +42,6 @@
|
||||
1 = 兩條路都沒走通(這時 stderr 一定有一段紅字,不會安靜)
|
||||
|
||||
環境變數(都有預設,測試才需要動):
|
||||
TELEGRAM_BOT_TOKEN/TELEGRAM_CHAT_ID 有就先走 Bot API 直送(雲端唯一通的路,ISEP#130)
|
||||
ISEP_NOTIFY_BOT_API Bot API 的主機(預設 https://api.telegram.org;測試指到假的)
|
||||
ISEP_NOTIFY_URL notify_leo 的 trigger 網址
|
||||
ISEP_NOTIFY_IDENTITY 貼票時的【身份】欄
|
||||
ISEP_NOTIFY_STATE_DIR 閘判定快取的位置(預設 ~/.claude/isep-nag)
|
||||
@@ -254,52 +252,6 @@ def send_telegram(text):
|
||||
return False, "外層通了但**內層沒 ok**:%s" % raw[:300]
|
||||
|
||||
|
||||
# ══ 二之一、直送 Bot API(雲端的路,inkstone/ISEP#130)═══════════════════════
|
||||
#
|
||||
# 2026-09-07 從雲端 session 實測三條路:
|
||||
# notify_leo @ leo21c → HTTP 404「找不到 workflow」(08-28 起就斷,修它是 leo 的人閘)
|
||||
# notify_leo @ youlin → 連不到:雲端 egress proxy 對 *.arcrun-yuga3bse.workers.dev 回 403
|
||||
# (policy denial,不是 DNS、不是 000;要 leo 在 Cloud environment 放行主機)
|
||||
# api.telegram.org → 302,**通的**
|
||||
# ⇒ 雲端唯一走得通的是 Bot API 直送,而它只缺兩個環境變數:
|
||||
# TELEGRAM_BOT_TOKEN/TELEGRAM_CHAT_ID(Routine 文件 cloud-worker.md 檔頭本來就列著它們)。
|
||||
# 有 ⇒ 先走這條(它不碰任何實例,閘管不到也不必管);沒有 ⇒ 講清楚缺哪兩個,走原本那條。
|
||||
BOT_API = os.environ.get("ISEP_NOTIFY_BOT_API", "https://api.telegram.org")
|
||||
|
||||
|
||||
def bot_creds():
|
||||
tok = (os.environ.get("TELEGRAM_BOT_TOKEN") or "").strip()
|
||||
chat = (os.environ.get("TELEGRAM_CHAT_ID") or "").strip()
|
||||
return (tok, chat) if tok and chat else (None, None)
|
||||
|
||||
|
||||
def send_bot_api(text):
|
||||
"""回 (ok, 說明)。Telegram 的回應要 `ok: true` 才算送到。"""
|
||||
tok, chat = bot_creds()
|
||||
if not tok:
|
||||
return False, "沒有 TELEGRAM_BOT_TOKEN/TELEGRAM_CHAT_ID(雲端要 leo 在 Cloud environment 加這兩個變數)"
|
||||
if os.environ.get("ISEP_NOTIFY_OFFLINE") == "1":
|
||||
return False, "ISEP_NOTIFY_OFFLINE=1:刻意不打網路"
|
||||
req = urllib.request.Request(
|
||||
"%s/bot%s/sendMessage" % (BOT_API, tok),
|
||||
data=json.dumps({"chat_id": chat, "text": text}).encode(), method="POST",
|
||||
headers={"Content-Type": "application/json",
|
||||
"User-Agent": "isep-notify/1.0 (+inkstone/ISEP#130)"})
|
||||
try:
|
||||
raw = urllib.request.urlopen(req, timeout=30).read().decode()
|
||||
except urllib.error.HTTPError as e:
|
||||
return False, "Bot API HTTP %s:%s" % (e.code, e.read().decode()[:200])
|
||||
except Exception as e:
|
||||
return False, "Bot API 連不上:%s" % e
|
||||
try:
|
||||
d = json.loads(raw)
|
||||
except Exception:
|
||||
return False, "Bot API 回應不是 JSON:%s" % raw[:200]
|
||||
if d.get("ok") is True:
|
||||
return True, "送到了(Bot API 直送,message_id=%s)" % ((d.get("result") or {}).get("message_id"))
|
||||
return False, "Bot API 回 ok=false:%s" % raw[:200]
|
||||
|
||||
|
||||
# ══ 三、退路:貼回票上 ═══════════════════════════════════════════════════
|
||||
def gitea_token():
|
||||
for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
|
||||
@@ -399,20 +351,12 @@ def notify(text, fallback_ticket=None, dry_run=False):
|
||||
out.append(text)
|
||||
return 0, "\n".join(out)
|
||||
|
||||
# ① Bot API 直送:不碰任何實例,閘的判定管不到它(inkstone/ISEP#130)
|
||||
sent, why_bot = send_bot_api(text)
|
||||
out.append(("✅ Telegram(Bot API 直送):%s" if sent else "⏭️ Bot API 直送:%s") % why_bot)
|
||||
if sent:
|
||||
return 0, "\n".join(out)
|
||||
|
||||
# ② 走實例上的 notify_leo 工作流(原本那條;閘說會擋就不送)
|
||||
if fact["verdict"] == "block":
|
||||
out.append("⛔ 閘說會擋 ⇒ **本支不繞路**,直接走退路。")
|
||||
sent, why = False, "閘會擋,而繞過去等於拆了那道閘 ⇒ 沒有嘗試送出"
|
||||
else:
|
||||
sent, why = send_telegram(text)
|
||||
out.append(("✅ Telegram(notify_leo):%s" if sent else "❌ Telegram(notify_leo):%s") % why)
|
||||
why = "Bot API 直送:%s;notify_leo:%s" % (why_bot, why)
|
||||
out.append(("✅ Telegram:%s" if sent else "❌ Telegram:%s") % why)
|
||||
|
||||
if sent:
|
||||
return 0, "\n".join(out)
|
||||
|
||||
@@ -254,7 +254,7 @@ YOULIN_ACCOUNT = "1129efd7df2e8899d537e9c8fbabb6cb"
|
||||
# ⇒ 判準:防呆要比對「**決定後果的那一項**」,不是「剛好看得到的那一項」。
|
||||
# namespace 才是資料的歸屬鍵 ⇒ 三項一起驗,缺一不可。
|
||||
YOULIN_NAMESPACE = "yuga3bse"
|
||||
YOULIN_CYPHER = "arcrun-cypher-executor.arcrun-yuga3bse.workers.dev" # 09-02 重裝後的子網域(inkstone/ISEP#130);舊名 youlin-hsieh-dev 的 DNS 已不存在
|
||||
YOULIN_CYPHER = "arcrun-cypher-executor.youlin-hsieh-dev.workers.dev"
|
||||
|
||||
|
||||
class Acr:
|
||||
|
||||
+3
-20
@@ -23,8 +23,6 @@ leo 2026-08-27:「**14 個里程碑同時亮著卻不知道該看哪個**」
|
||||
|
||||
── 答案為什麼唯一 ─────────────────────────────────────────────────
|
||||
主線住在一個檔裡(`~/.claude/isep-countdown/mainline.json`),那個檔**放得下一條**。
|
||||
(inkstone/ISEP#130 起它有一份隨 repo 走的鏡像:`InkStoneCo/system-dev/mainline.json`——
|
||||
雲端沒有家目錄那份,讀的就是它;`set`/`adopt`/`clear` 兩份一起寫,`refresh` 只寫家目錄。)
|
||||
沒有清單、沒有優先序、沒有「前三名」——`set` 覆蓋掉的那條就不再是主線。
|
||||
⇒ 問一次只會拿到 0 或 1 個答案,不會拿到 14 個。
|
||||
|
||||
@@ -214,36 +212,22 @@ def cmd_set(argv):
|
||||
"closed_issues": m.get("closed_issues") or 0,
|
||||
"members": refs,
|
||||
"set_at": now, "refreshed_at": now,
|
||||
}, mirror=True)
|
||||
})
|
||||
if not ok:
|
||||
die("🔴 寫不進 %s——主線沒有被標上。" % ML.path())
|
||||
print("✅ 主線已標定:%s/%s#%d「%s」" % (owner, repo, mid, title))
|
||||
if scanned:
|
||||
print(" 跨 repo 收到同名 milestone 的票 %d 張:%s"
|
||||
% (len(refs), "、".join("%s %d" % (r, n) for r, n in scanned)))
|
||||
print(mirror_line())
|
||||
print()
|
||||
cmd_show([])
|
||||
|
||||
|
||||
def mirror_line():
|
||||
"""repo 那份有沒有跟著寫(inkstone/ISEP#130):寫了要人去 commit,沒寫要講為什麼。"""
|
||||
rp = ML.repo_path(for_write=True)
|
||||
if rp and os.path.isfile(rp):
|
||||
return (" 已同步寫進 repo 那份:%s\n"
|
||||
" 📌 這份要 commit/開 PR 併進 inkstone/InkStoneCo,雲端 clone 才拿得到" % rp)
|
||||
return (" ⚠️ 這台找不到 InkStoneCo 的 system-dev/(CLAUDE_PROJECT_DIR 或 cwd 底下都沒有),"
|
||||
"repo 那份沒更新——雲端仍會讀到舊主線")
|
||||
|
||||
|
||||
def cmd_clear(argv):
|
||||
had = ML.load()
|
||||
rp = ML.repo_path()
|
||||
ML.clear(mirror=True)
|
||||
ML.clear()
|
||||
print("✅ 已清掉主線%s。現在沒有主線——每回合的 🎯 那一行會照實說。"
|
||||
% ("(原本是 %s「%s」)" % (ML.ref_of(had), had.get("title")) if had else ""))
|
||||
if rp:
|
||||
print(" repo 那份也刪了:%s(要 commit 才會到雲端)" % rp)
|
||||
|
||||
|
||||
# ── refresh ──────────────────────────────────────────────────────────────
|
||||
@@ -294,9 +278,8 @@ def cmd_adopt(argv):
|
||||
T.api("/repos/%s/%s/issues/%d" % (owner, repo, num), {"milestone": mid}, method="PATCH")
|
||||
ref = "%s/%s#%d" % (owner, repo, num)
|
||||
ms["members"] = sorted(set(ms.get("members") or []) | {ref})
|
||||
ML.save(ms, mirror=True)
|
||||
ML.save(ms)
|
||||
print("✅ 補收:%s 已掛進「%s」(%s/%s#%d)" % (ref, ms["title"], owner, repo, mid))
|
||||
print(mirror_line())
|
||||
|
||||
|
||||
# ── has ──────────────────────────────────────────────────────────────────
|
||||
|
||||
@@ -10,63 +10,9 @@
|
||||
set -euo pipefail
|
||||
|
||||
# ── 雲端需要哪些變數(只有名字。要加就加在這裡)──────────────────
|
||||
#
|
||||
# 範圍=**youlin(stage)與 geek6688(測試 prod & 出貨機)兩台全給**,
|
||||
# **外加 uncle6**——出貨的三個站實際部署到的是那個帳號。
|
||||
# leo 2026-09-01:「youlin 和 geek6688 都全給,因為這兩個都是讓 CC 操作
|
||||
# 一個 stage 一個 test prod,**不給所有的就是受阻**。」
|
||||
# uncle6 是同一句話的延伸(inkstone/ISEP#115 → comment `5577`):
|
||||
# `products/arcrun-rag/installer/ship.targets.json` 六處 accountId 去重後只有一個值
|
||||
# `58309bb90fd93ad6d0fe0aae99170e9d`,而本機出貨靠的是家目錄裡的 OAuth 登入態
|
||||
# (`~/.wrangler/config/default.toml`)——**那個檔不隨 repo clone 走,雲端永遠拿不到**。
|
||||
# ⚠️ 這把「是 uncle6 的、而且 active」是驗過的;「它有沒有 Workers Scripts:Edit
|
||||
# =真的部署得動」**沒驗**(驗它必須寫入,那是紅線)。缺這格會在部署當下才知道。
|
||||
NEEDED=(
|
||||
# ── 機器帳號 ──
|
||||
GITEA_TOKEN_CLAUDE_CODE # claude-code 的 Gitea token;bootstrap 與 plugin 安裝都靠它
|
||||
|
||||
# ── youlin = AI 的 stage(沒指定帳號時的預設,agent-memory.md §2)──
|
||||
CLOUDFLARE_API_TOKEN_YOULIN_CC_USE # D37 起這把就是設計給 CC 用的
|
||||
CLOUDFLARE_ACCOUNT_ID_YOULIN # 上面那把的配對 account id(帳號 id 不是機密)
|
||||
YOULIN_MCP_OWNER_SECRETS # youlin 那台 MCP 的 owner secret
|
||||
STAGE_USERNAME_YOULIN # ⚠️ 密碼類,見下面那條限制
|
||||
STAGE_PASSWORD_YOULIN # ⚠️ 密碼類,見下面那條限制
|
||||
|
||||
# ── geek6688 = 測試 prod & 出貨機 ──
|
||||
CLOUDFLARE_API_TOKEN_CC_SHIPPING_CORE # 出貨線寫入用
|
||||
CLOUDFLARE_ACCOUNT_ID_GEEK6688 # 上面那把的配對 account id
|
||||
|
||||
# ── uncle6 = 出貨三站真正部署到的帳號(installer/docsSite/mailRelay,stage 與 prod 都是)──
|
||||
UNCLE6_CF_API_KEY # 住在 products/arcrun-rag/.env;本機是靠 ~/.wrangler 的 OAuth 登入態出貨,那個檔不隨 clone 走
|
||||
|
||||
# ── Arcrun 出貨線的實例座標(inkstone/Arcrun#195 起)──
|
||||
# 網址隨 repo 走(Arcrun 的 shared/instance-coordinates/instances.json),
|
||||
# 只有 namespace 是機敏 ⇒ 走環境變數。原本只住在 ~/.arcrun/config.yaml 的 api_key,
|
||||
# 那個檔在家目錄、不隨 clone 走 ⇒ 雲端永遠拿不到。
|
||||
ARCRUN_NS_YOULIN # youlin 實例的 namespace(X-Arcrun-API-Key)
|
||||
GITEA_TOKEN_CLAUDE_CODE # 機器帳號 claude-code 的 Gitea token;bootstrap 與 plugin 安裝都靠它
|
||||
)
|
||||
#
|
||||
# 🔴 這份清單的邊界——加一把之前先問「這把打得到哪個實例」,不是「這把方便嗎」
|
||||
#
|
||||
# 可以進來的:**youlin 與 geek6688** 這兩台的全部,加上機器帳號自己的 token。
|
||||
# 🔴 不准進來的:
|
||||
# ① `CLOUDFLARE_API_TOKEN_leo21c`——leo 2026-09-01 只點名那兩台;
|
||||
# leo21c 是現役正式環境,`inkstone/InkStoneCo#14` → comment `3890` 已分進 B 段不放。
|
||||
# ② `polaris/mira/.env` 裡的任何東西——那整份都是 leo21c 現役正式環境。
|
||||
# 其中 `CLOUDFLARE_API_TOKEN` / `CLOUDFLARE_ACCOUNT_ID` 這兩個**沒有名字**的最危險:
|
||||
# 所有 CF 工具都把它們當預設 ⇒ 雲端一個沒指定帳號的指令就會打到正式環境。
|
||||
# 2026-08-14 那輪審查把它列為「本輪最危險的發現」。
|
||||
# 🔎 這一條不必靠人記得:`scripts/test-make-cloud-env.sh` 的 B8 會去看
|
||||
# **每一把的值是從哪個檔案拿到的**,出自 `polaris/mira/.env` 就紅。
|
||||
#
|
||||
# 🔴 密碼類(`STAGE_PASSWORD_YOULIN` 等)進清單是為了讓**人**拿得到。
|
||||
# `credentials-map.md`「密碼類憑證的用法限制」(2026-08-17 立)照舊有效:
|
||||
# **AI 不得把密碼打進登入欄位**,這是 surface 層硬規則,leo 交代了也不解除。
|
||||
# 機器要驗登入後的畫面走那節寫的兩條:帶 token/cookie 打 API,或接 leo 已登入的分頁。
|
||||
#
|
||||
# 📌 兩台的 account id 都有具名變數了(`…_YOULIN` 是 2026-09-01 才補進頂層 `.env` 的,
|
||||
# inkstone/ISEP#115 → comment `5542`;帳號 id 不是機密,wiki 的帳號表本來就公開記著)。
|
||||
# **所以永遠不需要去用那個沒有名字的 `CLOUDFLARE_ACCOUNT_ID`**——那是 leo21c。
|
||||
|
||||
# ── 去哪裡找值(credentials-map.md 記的六個 .env)────────────────
|
||||
BASE="${INKSTONE_ROOT:-$HOME/Documents/tech_projects/InkStoneCo}"
|
||||
|
||||
@@ -1,146 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""settings-allow-sync — 把 ISEP 的權限白名單寫進**這台機器**的 ~/.claude/settings.json
|
||||
(inkstone/ISEP#130)
|
||||
|
||||
━━ 為什麼有這支 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
leo 09-07 親手把四個 Gitea 正門工具(`ticket`/`mainline`/`gate-ok`/`gitea-pr-merge`)
|
||||
加進本機 `InkStoneCo/.claude/settings.json` 的 `permissions.allow`,auto mode 的分類器
|
||||
才不擋。**雲端 session 沒有那四條** ⇒ 同樣的動作在雲端照樣被擋
|
||||
(09-04 progress-guard run log:permission_denials=6)。
|
||||
|
||||
雲端真正讀的是薄殼 repo(GitHub)的 settings——推它要 D20 開閘(leo 親跑 github-arm)。
|
||||
⇒ 白名單不住薄殼、也不住 InkStoneCo,**住 ISEP 一份**(`docs/permissions-allow.json`),
|
||||
由本支在那台機器上寫進 `~/.claude/settings.json`(user scope,跟 cwd 無關)。
|
||||
雲端:`docs/cloud-setup-script.sh` 裝完 plugin 就跑一次;之後每個 SessionStart 再對一次,
|
||||
plugin 更新帶進新規則時不必等快照重拍。本機:同一支、同一份清單。
|
||||
|
||||
━━ 規矩 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
· 只加不減:settings.json 裡本來就有的東西一個字不動(別人手加的規則不是本支的地盤)。
|
||||
· 冪等:跑第二次 +0 條,檔案一個位元組都不變。
|
||||
· 清單裡開頭的 `~` 換成這台的家目錄(本機 /Users/…、雲端 /root),其餘照抄。
|
||||
· 原子寫:先寫暫存檔再 rename,中途斷掉不會留下半個 JSON。
|
||||
· 讀不懂目標(不是 JSON)⇒ **不碰它**、印出來、離開碼 0——這支掛在 SessionStart,
|
||||
不准因為它把 session 弄壞;`--check` 才會用離開碼講話。
|
||||
|
||||
━━ 用法 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
settings-allow-sync 寫進 ~/.claude/settings.json
|
||||
settings-allow-sync --dry-run 只印會加哪幾條,不寫
|
||||
settings-allow-sync --check 對帳:缺任何一條 ⇒ 離開碼 1(測試/驗收用)
|
||||
settings-allow-sync --target <檔> --home <家目錄> 測試用:指到別的檔、別的家目錄
|
||||
settings-allow-sync --quiet 沒事就閉嘴(SessionStart 用)
|
||||
"""
|
||||
import json
|
||||
import os
|
||||
import sys
|
||||
import tempfile
|
||||
|
||||
HERE = os.path.dirname(os.path.abspath(__file__))
|
||||
SOURCE = os.path.join(HERE, "..", "docs", "permissions-allow.json")
|
||||
|
||||
|
||||
def wanted(home):
|
||||
with open(SOURCE, encoding="utf-8") as f:
|
||||
d = json.load(f)
|
||||
out = []
|
||||
for rule in d.get("allow") or []:
|
||||
if not isinstance(rule, str) or not rule.startswith("Bash(") or not rule.endswith(")"):
|
||||
raise ValueError("清單裡有一條不是 Bash(…) 的形狀:%r" % (rule,))
|
||||
inner = rule[len("Bash("):-1]
|
||||
# 只換「路徑開頭」的 ~:`python3 ~/.claude/…` 這種。`~` 出現在別處不動。
|
||||
parts = inner.split(" ")
|
||||
parts = [home + p[1:] if p.startswith("~/") else p for p in parts]
|
||||
out.append("Bash(" + " ".join(parts) + ")")
|
||||
return out
|
||||
|
||||
|
||||
def main(argv):
|
||||
target = os.path.join(os.path.expanduser("~"), ".claude", "settings.json")
|
||||
home = os.path.expanduser("~")
|
||||
dry = check = quiet = False
|
||||
i = 0
|
||||
while i < len(argv):
|
||||
a = argv[i]
|
||||
if a == "--target":
|
||||
i += 1; target = argv[i]
|
||||
elif a == "--home":
|
||||
i += 1; home = argv[i].rstrip("/")
|
||||
elif a == "--dry-run":
|
||||
dry = True
|
||||
elif a == "--check":
|
||||
check = True
|
||||
elif a == "--quiet":
|
||||
quiet = True
|
||||
elif a in ("-h", "--help"):
|
||||
print(__doc__); return 0
|
||||
else:
|
||||
print("不認得的參數:%s(--help 看用法)" % a, file=sys.stderr); return 2
|
||||
i += 1
|
||||
|
||||
try:
|
||||
rules = wanted(home)
|
||||
except Exception as e:
|
||||
print("🔴 讀不了白名單清單 %s:%s" % (SOURCE, e), file=sys.stderr)
|
||||
return 1 if check else 0
|
||||
|
||||
cur = {}
|
||||
if os.path.exists(target):
|
||||
try:
|
||||
with open(target, encoding="utf-8") as f:
|
||||
cur = json.load(f)
|
||||
if not isinstance(cur, dict):
|
||||
raise ValueError("最外層不是物件")
|
||||
except Exception as e:
|
||||
print("🔴 %s 讀不懂(%s)——**沒有動它**。修好它再跑一次。" % (target, e), file=sys.stderr)
|
||||
return 1 if check else 0
|
||||
|
||||
perms = cur.get("permissions")
|
||||
if not isinstance(perms, dict):
|
||||
perms = {}
|
||||
allow = perms.get("allow")
|
||||
if not isinstance(allow, list):
|
||||
allow = []
|
||||
have = set(a for a in allow if isinstance(a, str))
|
||||
missing = [r for r in rules if r not in have]
|
||||
|
||||
if check:
|
||||
if missing:
|
||||
print("🔴 %s 缺 %d 條:" % (target, len(missing)))
|
||||
for r in missing:
|
||||
print(" " + r)
|
||||
return 1
|
||||
if not quiet:
|
||||
print("✅ %s 已有全部 %d 條" % (target, len(rules)))
|
||||
return 0
|
||||
|
||||
if not missing:
|
||||
if not quiet:
|
||||
print("✅ 白名單已齊(%d 條):%s" % (len(rules), target))
|
||||
return 0
|
||||
|
||||
if dry:
|
||||
print("🧪 --dry-run:會加 %d 條進 %s:" % (len(missing), target))
|
||||
for r in missing:
|
||||
print(" " + r)
|
||||
return 0
|
||||
|
||||
perms["allow"] = allow + missing
|
||||
cur["permissions"] = perms
|
||||
try:
|
||||
os.makedirs(os.path.dirname(target) or ".", exist_ok=True)
|
||||
fd, tmp = tempfile.mkstemp(prefix=".settings-", suffix=".json", dir=os.path.dirname(target) or ".")
|
||||
with os.fdopen(fd, "w", encoding="utf-8") as f:
|
||||
json.dump(cur, f, ensure_ascii=False, indent=2)
|
||||
f.write("\n")
|
||||
os.replace(tmp, target)
|
||||
except Exception as e:
|
||||
print("🔴 寫不進 %s:%s" % (target, e), file=sys.stderr)
|
||||
return 0
|
||||
print("✅ 白名單 +%d 條 → %s(共 %d 條來自 ISEP)" % (len(missing), target, len(rules)))
|
||||
if not quiet:
|
||||
for r in missing:
|
||||
print(" " + r)
|
||||
return 0
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main(sys.argv[1:]))
|
||||
@@ -64,158 +64,6 @@ printf '已驗完,全部綠燈\n' > "$TMPF"
|
||||
run 0 "scripts/ticket say inkstone/arcrun-rag#136 -F $TMPF"
|
||||
rm -f "$TMPF" "/tmp/.comment-task-guard-warned-$SID"
|
||||
|
||||
echo "── 閘教的那行指令要真的跑得動(inkstone/ISEP#112)──"
|
||||
# 🔴 這一組**不看離開碼**,看訊息內容、而且**真的把訊息裡那塊指令執行一次**。
|
||||
# ISEP wiki mistakes.md 記過:訊息壞掉時閘照樣 exit 2,只驗離開碼完全看不出來。
|
||||
# 這張票就是那個形狀的極端版——閘擋對了,但它教的解法**根本不存在**。
|
||||
SID2=test-cctg-msg-$$
|
||||
rm -f "/tmp/.comment-task-guard-warned-$SID2"
|
||||
PAYLOAD=$(python3 -c '
|
||||
import json, sys
|
||||
cmd = ("curl -X POST \"$API/repos/inkstone/arcrun-rag/issues/136/comments\" "
|
||||
"-d \x27{\"body\":\"Phase 1 的驗收在雲端那半出貨之前驗不了\"}\x27")
|
||||
print(json.dumps({"session_id": sys.argv[1], "tool_name": "Bash",
|
||||
"tool_input": {"command": cmd}}, ensure_ascii=False))
|
||||
' "$SID2")
|
||||
MSGFILE=$(mktemp)
|
||||
printf '%s' "$PAYLOAD" | bash "$H" 2>"$MSGFILE" >/dev/null
|
||||
rm -f "/tmp/.comment-task-guard-warned-$SID2"
|
||||
|
||||
RESFILE=$(mktemp)
|
||||
PAYFILE=$(mktemp); printf '%s' "$PAYLOAD" > "$PAYFILE"
|
||||
rm -f "/tmp/.comment-task-guard-warned-$SID2"
|
||||
MSGFILE="$MSGFILE" RESFILE="$RESFILE" GUARD="$H" PAYLOAD="$PAYFILE" python3 - <<'PY'
|
||||
import io, os, re, subprocess, sys
|
||||
|
||||
msg = io.open(os.environ["MSGFILE"], encoding="utf-8").read()
|
||||
res = []
|
||||
|
||||
|
||||
def t(ok, name, detail=""):
|
||||
res.append((bool(ok), name, detail))
|
||||
|
||||
|
||||
here = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) \
|
||||
if "__file__" in dir() else os.getcwd()
|
||||
ticket = os.path.realpath(os.path.join(os.getcwd(), "scripts", "ticket"))
|
||||
|
||||
# ⑮ 那塊指令**真正要執行的那一行**,開頭是絕對路徑,而且指到這一份正本。
|
||||
# 🔴 判準刻意放在「要執行的那一行」上,不是「訊息裡出現過的所有路徑」——
|
||||
# 後者在相對路徑混進來時是**空過**的(別的行還有絕對路徑,all() 照樣真)。
|
||||
# 2026-08-31 變異測試當場抓到:把 example 改回相對路徑,舊寫法的 ⑮ 沒紅。
|
||||
run_line = ""
|
||||
for l in msg.splitlines():
|
||||
if " subtask " in l and l.strip().endswith("\\"):
|
||||
run_line = l.strip()
|
||||
break
|
||||
first = run_line.split()[0] if run_line else ""
|
||||
t(first.startswith("/") and os.path.realpath(first) == ticket,
|
||||
"⑮ 要執行的那一行開頭是絕對路徑,且就是這一份正本",
|
||||
"那一行:%s" % (run_line or "(找不到)"))
|
||||
|
||||
# ⑯ 訊息裡**不准**出現相對的 `scripts/ticket`
|
||||
# 相對路徑是對「貼上去那個人的 cwd」解析的,而 InkStoneCo/scripts/ticket 是舊複本。
|
||||
rel = [l for l in msg.splitlines()
|
||||
if re.search(r"(?<![\w/])scripts/ticket\b", l)]
|
||||
t(not rel, "⑯ 訊息裡沒有任何相對路徑的 scripts/ticket",
|
||||
"違規行:%s" % (rel[:2] or ""))
|
||||
|
||||
# ⑰ 訊息裡的用法區塊 = `ticket usage subtask` 的輸出(**一字不差**)
|
||||
# 這就是「不再有第二份可以漂」的機械證明:漂了這一條當場紅。
|
||||
usage = subprocess.run([sys.executable, ticket, "usage", "subtask"],
|
||||
capture_output=True, text=True).stdout.strip()
|
||||
flat_msg = "\n".join(l.strip() for l in msg.splitlines())
|
||||
flat_use = "\n".join(l.strip() for l in usage.splitlines())
|
||||
t(flat_use and flat_use in flat_msg,
|
||||
"⑰ 訊息裡的用法就是 `ticket usage subtask` 的輸出,沒有第二份",
|
||||
"" if flat_use in flat_msg else "訊息裡找不到正本印的用法")
|
||||
|
||||
|
||||
def extract_block(m):
|
||||
"""把訊息裡那塊指令**原樣**抽出來——不重新產生,否則就驗不到漂移。"""
|
||||
lines = m.splitlines()
|
||||
i = next(k for k, l in enumerate(lines) if l.startswith("cat > "))
|
||||
md = next(k for k in range(i, len(lines)) if lines[k] == "MD")
|
||||
j = next(k for k in range(md + 1, len(lines)) if not lines[k].endswith("\\"))
|
||||
return "\n".join(lines[i:j + 1])
|
||||
|
||||
|
||||
def fill(block):
|
||||
"""只填三格機器不可能知道的:標題、目標、驗收條件。其餘一個字都不改。"""
|
||||
block = (block.replace("<誰>", "跑這行指令的人")
|
||||
.replace("<什麼>", "它真的跑得動")
|
||||
.replace("<為什麼>", "不會被迫去繞過它"))
|
||||
return re.sub(r"<[^<>\n]+>", "測試填的內容", block)
|
||||
|
||||
|
||||
ENV = dict(os.environ, TICKET_HOST="http://127.0.0.1:9",
|
||||
GITEA_TOKEN_CLAUDE_CODE="dummy", GITEA_TOKEN="dummy")
|
||||
|
||||
# ⑱ ★ 把它原樣貼上、只填那三格,**真的跑一次**。
|
||||
# 離開碼 2 = 被某道閘擋下(動詞不存在/旗標不成組/標題不合格…)= 這張票的病復發
|
||||
# 離開碼 1 = 一路走到網路才炸(TICKET_HOST 指到連不上的位址)= 參數全部過關
|
||||
try:
|
||||
blk = fill(extract_block(msg))
|
||||
r = subprocess.run(["bash", "-c", blk], capture_output=True, text=True, env=ENV)
|
||||
code = r.returncode
|
||||
except StopIteration:
|
||||
blk, code, r = "", -1, None
|
||||
t(code == 1, "⑱ ★ 訊息裡那塊指令原樣貼上就跑得完(走到網路才停,不是被閘擋)",
|
||||
"離開碼 %s(2 = 又被某道閘擋下)%s"
|
||||
% (code, ("|" + (r.stderr or "").strip().splitlines()[0][:80]) if r and code == 2 else ""))
|
||||
|
||||
# ⑲ 鑑別力對照:⑱ 不是「只要跑就會過」。
|
||||
# 把閘**原本**印的那組旗標(`--assign <誰做>` 沒配 `--next`)接回去 ⇒ 必須紅。
|
||||
if blk:
|
||||
bad = blk.rstrip() + " --assign claude-code"
|
||||
rb = subprocess.run(["bash", "-c", bad], capture_output=True, text=True, env=ENV)
|
||||
t(rb.returncode == 2,
|
||||
"⑲ 對照組:閘原本那組旗標(--assign 沒配 --next)確實跑不完",
|
||||
"離開碼 %s(要是 2;不是 2 就表示 ⑱ 沒有鑑別力)" % rb.returncode)
|
||||
else:
|
||||
t(False, "⑲ 對照組:抽不出指令區塊", "")
|
||||
|
||||
# ⑳ 草稿模板與必填檢查**同源**:模板裡一定有 REQUIRED_SECTIONS 的每一段。
|
||||
# 寫死一份模板的話,有人往 REQUIRED_SECTIONS 加一段就會生出
|
||||
# 「照著貼卻過不了自己那道閘」的票——正是這張票要修的形狀。
|
||||
req = subprocess.run(
|
||||
[sys.executable, "-c",
|
||||
"import runpy,sys;m=runpy.run_path(sys.argv[1]);"
|
||||
"print('\\x00'.join(m['REQUIRED_SECTIONS']));"
|
||||
"print(m['body_template']())", ticket],
|
||||
capture_output=True, text=True)
|
||||
head, _, tmpl = req.stdout.partition("\n")
|
||||
secs = [x for x in head.split("\x00") if x]
|
||||
t(secs and all(x in tmpl for x in secs) and all(x in msg for x in secs),
|
||||
"⑳ 草稿模板由 REQUIRED_SECTIONS 現生,訊息裡也齊",
|
||||
"必填段:%s" % secs)
|
||||
|
||||
# ㉑ 正本叫不動時(雲端裝壞、路徑不對):**閘照樣擋**,而且**不准就地補一份手抄用法**
|
||||
# ——那份副本正是這張票拔掉的東西。fail-open 的是「訊息內容」,不是「擋不擋」。
|
||||
fb = subprocess.run(["bash", os.environ["GUARD"]],
|
||||
input=io.open(os.environ["PAYLOAD"], encoding="utf-8").read(),
|
||||
capture_output=True, text=True,
|
||||
env=dict(os.environ, CLAUDE_PLUGIN_ROOT="/tmp/isep-no-such-root"))
|
||||
fbmsg = fb.stderr
|
||||
t(fb.returncode == 2 and "usage subtask" in fbmsg
|
||||
and "--title" not in fbmsg and "[--journey" not in fbmsg,
|
||||
"㉑ 正本叫不動時仍然擋,且只指路、不補一份手抄用法",
|
||||
"離開碼 %s|訊息裡有沒有手抄用法:%s"
|
||||
% (fb.returncode, "有(違規)" if "[--journey" in fbmsg else "沒有"))
|
||||
|
||||
npass = 0
|
||||
for ok, name, detail in res:
|
||||
print(" %s %s%s" % ("✅" if ok else "❌", name,
|
||||
(" ※ " + detail) if (detail and not ok) else ""))
|
||||
npass += 1 if ok else 0
|
||||
io.open(os.environ["RESFILE"], "w", encoding="utf-8").write(
|
||||
"%d %d" % (npass, len(res) - npass))
|
||||
PY
|
||||
read -r P2 F2 < "$RESFILE"
|
||||
PASS=$((PASS + P2)); FAIL=$((FAIL + F2))
|
||||
rm -f "$MSGFILE" "$RESFILE" "$PAYFILE" "/tmp/isep-subtask-$SID2.md" \
|
||||
"/tmp/.comment-task-guard-warned-$SID2"
|
||||
|
||||
echo
|
||||
echo "$PASS/$((PASS+FAIL)) 通過"
|
||||
[ "$FAIL" = 0 ]
|
||||
|
||||
@@ -22,7 +22,7 @@ run(){ # 跑 list(或任何子命令),輸出留在 $OUT,離開碼留在
|
||||
# 🔴 ISEP_COUNTDOWN_STATE_DIR 也要指到暫存目錄:主線(hooks/lib/mainline.py)住在那裡,
|
||||
# 不隔離的話這支測試的結果會取決於「這台機器現在標了哪條主線」——那就不是測試了。
|
||||
OUT=$(ISEP_DEBT_FIXTURE="$FX" ISEP_DEBT_STATE_DIR="$T/state" ISEP_DEBT_NOW="$NOW" \
|
||||
ISEP_COUNTDOWN_STATE_DIR="$ML_DIR" ISEP_MAINLINE_REPO_FILE=none python3 "$W" "$@" 2>&1); RC=$?
|
||||
ISEP_COUNTDOWN_STATE_DIR="$ML_DIR" python3 "$W" "$@" 2>&1); RC=$?
|
||||
}
|
||||
|
||||
ML_DIR="$T/mainline"; mkdir -p "$ML_DIR"
|
||||
|
||||
Executable
+88
@@ -0,0 +1,88 @@
|
||||
#!/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 ]
|
||||
@@ -1,80 +0,0 @@
|
||||
#!/bin/bash
|
||||
# isep-notify 的「Bot API 直送」測試(inkstone/ISEP#130)
|
||||
#
|
||||
# 它守什麼: 雲端唯一走得通的通知路。2026-09-07 從雲端實測:leo21c 的 notify_leo 回 404、
|
||||
# youlin 被 egress proxy 擋(403 policy denial)、api.telegram.org 通。
|
||||
# ⇒ 有 TELEGRAM_BOT_TOKEN/TELEGRAM_CHAT_ID 就先直送;沒有要講清楚缺哪兩個,不能靜默。
|
||||
#
|
||||
# 🔴 全程不打真 Telegram:Bot API 指到本機一個假伺服器(只回固定 JSON),
|
||||
# 實例那條用 ISEP_NOTIFY_OFFLINE=1 關掉、閘用 ISEP_NOTIFY_GUARD 指到真跡。
|
||||
cd "$(dirname "$0")/.." || exit 1
|
||||
N=scripts/isep-notify
|
||||
TMP=$(mktemp -d); trap 'rm -rf "$TMP"; [ -n "${SRV:-}" ] && kill "$SRV" 2>/dev/null' EXIT
|
||||
export ISEP_NOTIFY_STATE_DIR="$TMP/state" ISEP_NOTIFY_GUARD="$PWD/hooks/prod-write-guard.sh"
|
||||
unset TELEGRAM_BOT_TOKEN TELEGRAM_CHAT_ID
|
||||
PASS=0; FAIL=0
|
||||
ok(){ PASS=$((PASS+1)); printf ' ✅ %s\n' "$1"; }
|
||||
bad(){ FAIL=$((FAIL+1)); printf ' ❌ %s\n' "$1"; }
|
||||
|
||||
# 假 Bot API:記下收到什麼,回 Telegram 的形狀
|
||||
cat > "$TMP/srv.py" <<'PY'
|
||||
import json, sys
|
||||
from http.server import BaseHTTPRequestHandler, HTTPServer
|
||||
LOG = sys.argv[2]
|
||||
class H(BaseHTTPRequestHandler):
|
||||
def do_POST(self):
|
||||
body = self.rfile.read(int(self.headers.get("Content-Length") or 0)).decode()
|
||||
open(LOG, "a").write(json.dumps({"path": self.path, "body": body, "ua": self.headers.get("User-Agent")}) + "\n")
|
||||
ok = "/botGOOD/" in self.path
|
||||
out = json.dumps({"ok": True, "result": {"message_id": 42}} if ok else {"ok": False, "description": "Unauthorized"}).encode()
|
||||
self.send_response(200 if ok else 401); self.send_header("Content-Type", "application/json"); self.end_headers(); self.wfile.write(out)
|
||||
def log_message(self, *a): pass
|
||||
HTTPServer(("127.0.0.1", int(sys.argv[1])), H).serve_forever()
|
||||
PY
|
||||
PORT=$(python3 -c 'import socket;s=socket.socket();s.bind(("127.0.0.1",0));print(s.getsockname()[1])')
|
||||
python3 "$TMP/srv.py" "$PORT" "$TMP/log" & SRV=$!
|
||||
for i in 1 2 3 4 5 6 7 8 9 10; do curl -s -o /dev/null "http://127.0.0.1:$PORT/" && break; sleep 0.2; done
|
||||
export ISEP_NOTIFY_BOT_API="http://127.0.0.1:$PORT"
|
||||
|
||||
echo "── A. 沒有憑證:講清楚缺哪兩個,不靜默 ──"
|
||||
OUT=$(ISEP_NOTIFY_OFFLINE=1 python3 "$N" --text "測試" 2>&1); RC=$?
|
||||
printf '%s' "$OUT" | grep -q 'TELEGRAM_BOT_TOKEN/TELEGRAM_CHAT_ID' && ok "A1 沒憑證 ⇒ 報告點名缺 TELEGRAM_BOT_TOKEN/TELEGRAM_CHAT_ID(leo 看了知道要在 Cloud environment 加什麼)" || bad "A1 沒點名缺什麼:$OUT"
|
||||
[ "$RC" != 0 ] && printf '%s' "$OUT" | grep -q 'leo 的手機上沒有出現' && ok "A2 兩條路都沒通 ⇒ 離開碼非 0、明說沒送到" || bad "A2 rc=$RC:$OUT"
|
||||
[ ! -s "$TMP/log" ] && ok "A3 沒憑證就不打 Bot API" || bad "A3 沒憑證還打了:$(cat "$TMP/log")"
|
||||
|
||||
echo "── B. 有憑證:先直送,送到就結束 ──"
|
||||
: > "$TMP/log"
|
||||
OUT=$(TELEGRAM_BOT_TOKEN=GOOD TELEGRAM_CHAT_ID=777 python3 "$N" --text "雲端收工摘要" 2>&1); RC=$?
|
||||
[ "$RC" = 0 ] && printf '%s' "$OUT" | grep -q 'Bot API 直送):送到了' && ok "B1 憑證在 ⇒ Bot API 直送,離開碼 0" || bad "B1 rc=$RC:$OUT"
|
||||
python3 - "$TMP/log" <<'PY' && ok "B2 打到 /botGOOD/sendMessage、chat_id=777、內文有署名、UA 帶了" || bad "B2 送出去的形狀不對:$(cat "$TMP/log")"
|
||||
import json, sys
|
||||
rows = [json.loads(l) for l in open(sys.argv[1])]
|
||||
assert len(rows) == 1, rows
|
||||
r = rows[0]; b = json.loads(r["body"])
|
||||
assert r["path"] == "/botGOOD/sendMessage", r["path"]
|
||||
assert b["chat_id"] == "777" and b["text"].startswith("[總管] 雲端收工摘要"), b
|
||||
assert "isep-notify" in (r["ua"] or ""), r["ua"]
|
||||
PY
|
||||
printf '%s' "$OUT" | grep -q 'notify_leo' && bad "B3 直送成功後不該再碰實例那條" || ok "B3 直送成功 ⇒ 不再打實例的 notify_leo"
|
||||
|
||||
echo "── C. 憑證錯:Bot API 回 ok=false ⇒ 不算送到,退到原本那條 ──"
|
||||
: > "$TMP/log"
|
||||
# 實例那條也指到假伺服器(它對非 /botGOOD/ 的路徑回 401)——兩條都不出這台機器
|
||||
OUT=$(TELEGRAM_BOT_TOKEN=BAD TELEGRAM_CHAT_ID=777 ISEP_NOTIFY_URL="http://127.0.0.1:$PORT/webhooks/named/leo/notify_leo/trigger" python3 "$N" --text "x" 2>&1); RC=$?
|
||||
printf '%s' "$OUT" | grep -q 'Bot API HTTP 401' && ok "C1 401 被講出來(不是「送出成功」)" || bad "C1 沒講 401:$OUT"
|
||||
[ "$RC" != 0 ] && printf '%s' "$OUT" | grep -q 'leo 的手機上沒有出現' && ok "C2 直送失敗+實例關著 ⇒ 仍然明說沒送到" || bad "C2 rc=$RC:$OUT"
|
||||
|
||||
echo "── D. 閘說會擋,直送仍走得通(它不碰實例)──"
|
||||
: > "$TMP/log"; mkdir -p "$TMP/oldguard"
|
||||
printf '#!/bin/sh\nexit 2\n' > "$TMP/oldguard/prod-write-guard.sh"; chmod +x "$TMP/oldguard/prod-write-guard.sh"
|
||||
OUT=$(ISEP_NOTIFY_GUARD="$TMP/oldguard/prod-write-guard.sh" TELEGRAM_BOT_TOKEN=GOOD TELEGRAM_CHAT_ID=1 python3 "$N" --text "y" 2>&1); RC=$?
|
||||
[ "$RC" = 0 ] && printf '%s' "$OUT" | grep -q '通知閘:\*\*block\*\*' && printf '%s' "$OUT" | grep -q '直送):送到了' \
|
||||
&& ok "D1 閘 block + 憑證在 ⇒ 直送照樣送到(閘擋的是寫實例,直送沒碰實例)" || bad "D1 rc=$RC:$OUT"
|
||||
|
||||
echo "── E. --dry-run 什麼都不送 ──"
|
||||
: > "$TMP/log"
|
||||
OUT=$(TELEGRAM_BOT_TOKEN=GOOD TELEGRAM_CHAT_ID=1 python3 "$N" --text "z" --dry-run 2>&1)
|
||||
[ ! -s "$TMP/log" ] && printf '%s' "$OUT" | grep -q 'dry-run' && ok "E1 --dry-run:Bot API 一次都沒被打" || bad "E1 dry-run 打了:$(cat "$TMP/log")"
|
||||
|
||||
echo; echo "$PASS/$((PASS+FAIL)) 通過"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
@@ -1,144 +0,0 @@
|
||||
#!/bin/bash
|
||||
# make-cloud-env.sh 的測試(docs/TESTING.md A14)
|
||||
#
|
||||
# 它守什麼: 那支腳本是「雲端總管手上有哪些憑證」的唯一清單。清單漏一把,
|
||||
# 雲端會在**流程末端**才發現跑不了(inkstone/ISEP#115 內文:派了工人寫完
|
||||
# 清空腳本、寫完測試,到要真的跑的那一刻才知道 CF token 根本不在)。
|
||||
#
|
||||
# 兩段:
|
||||
# A 段 —— 用假的 .env 隔離跑,證明「產物長對、缺值不會假綠、什麼都不寫進 repo」。
|
||||
# 全程不碰真金鑰、不碰 ~/.claude/cloud-env。
|
||||
# B 段 —— 拿這台機器真正的 .env 對帳,證明清單上每一把**這台都拿得到值**,
|
||||
# 而且**沒有一把的值來自 polaris/mira/.env**(leo21c 現役正式環境)。
|
||||
# .env 不在(例如雲端)⇒ 印 ⏭️ SKIP,不算通過也不算失敗。
|
||||
#
|
||||
# 🔴 B8/B9 的判準都不是名字,是機器算得出來的事實——**換什麼名字都躲不掉**。
|
||||
# B8 看「這個值是從哪個檔案拿到的」(出自 polaris/mira/.env = leo21c 現役正式環境)。
|
||||
# B9 看「這個值是不是就是 leo21c 那把 token」(值相等就紅,改名叫什麼都一樣)。
|
||||
# 🔴 兩條是分工不是重複:`CLOUDFLARE_API_TOKEN_leo21c` 住在**頂層** .env,
|
||||
# 不在 polaris/mira/.env ⇒ **B8 抓不到它**,這正是 B9 存在的理由。
|
||||
# 關鍵字黑名單反過來只擋得住已經被列進去的那幾個名字,新名字一律漏掉
|
||||
# (leo 2026-08-17 已證偽文字層封路:當日 8 次誤攔、0 次正確攔截)。
|
||||
#
|
||||
# 🔴 全程只印變數**名字**與值的**長度**,一個字元的值都不印。
|
||||
cd "$(dirname "$0")/.." || exit 1
|
||||
S=scripts/make-cloud-env.sh
|
||||
PASS=0; FAIL=0; SKIP=0
|
||||
ok(){ PASS=$((PASS+1)); printf ' ✅ %s\n' "$1"; }
|
||||
bad(){ FAIL=$((FAIL+1)); printf ' ❌ %s\n' "$1"; }
|
||||
skip(){ SKIP=$((SKIP+1)); printf ' ⏭️ SKIP %s\n' "$1"; }
|
||||
chk(){ [ "$1" = "$2" ] && ok "$3($2)" || bad "$3:want=$1 got=$2"; }
|
||||
|
||||
# 清單與搜尋路徑都從腳本本身讀出來——測試不另養一份,養了就會漂。
|
||||
# 註:macOS 內建的是 bash 3.2,沒有 mapfile/readarray,一律用 while read 收陣列。
|
||||
NEEDED=()
|
||||
while IFS= read -r l; do NEEDED+=("$l"); done < <(
|
||||
sed -n '/^NEEDED=(/,/^)/p' "$S" | sed -E '1d;$d; s/[[:space:]]*#.*$//; s/[[:space:]]//g' | grep -v '^$')
|
||||
[ "${#NEEDED[@]}" -gt 0 ] || { echo "🔴 從 $S 讀不出 NEEDED,測試本身壞了"; exit 1; }
|
||||
echo "清單(只有名字):${NEEDED[*]}"
|
||||
echo
|
||||
|
||||
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
|
||||
FAKE="$TMP/fakeroot"; OUTD="$TMP/out"; mkdir -p "$FAKE"
|
||||
|
||||
echo "── A. 隔離跑(假 .env,不碰真金鑰、不碰 ~/.claude/cloud-env)──"
|
||||
: > "$FAKE/.env"
|
||||
for n in "${NEEDED[@]}"; do echo "$n=FAKEVALUE-$n" >> "$FAKE/.env"; done
|
||||
|
||||
BEFORE=$(git status --porcelain)
|
||||
OUT_LINE=$(INKSTONE_ROOT="$FAKE" OUT_DIR="$OUTD" bash "$S" 2>&1)
|
||||
F=$(printf '%s\n' "$OUT_LINE" | sed -n 's/^✅ 產生完成://p')
|
||||
|
||||
[ -f "$F" ] && ok "A1 產物產出來了" || bad "A1 產物不存在(腳本輸出:$OUT_LINE)"
|
||||
chk 600 "$(stat -f '%OLp' "$F" 2>/dev/null || stat -c '%a' "$F" 2>/dev/null)" "A2 產物權限"
|
||||
|
||||
miss=0
|
||||
for n in "${NEEDED[@]}"; do grep -qx "$n=FAKEVALUE-$n" "$F" || { miss=$((miss+1)); echo " ↑ 沒出現:$n"; }; done
|
||||
chk 0 "$miss" "A3 每個名字都帶著值出現在 ① 區塊"
|
||||
|
||||
printf '%s\n' "$OUT_LINE" | grep -q "找不到值的 0 個" \
|
||||
&& ok "A4 收尾那行說「找不到值的 0 個」" || bad "A4 收尾計數不對:$OUT_LINE"
|
||||
|
||||
# 缺值時不准假綠:拿掉第一個,它要變成 <🔴 …> 且計數變 1
|
||||
grep -v "^${NEEDED[0]}=" "$FAKE/.env" > "$FAKE/.env.tmp" && mv "$FAKE/.env.tmp" "$FAKE/.env"
|
||||
OUT2=$(INKSTONE_ROOT="$FAKE" OUT_DIR="$OUTD" bash "$S" 2>&1)
|
||||
F2=$(printf '%s\n' "$OUT2" | sed -n 's/^✅ 產生完成://p')
|
||||
grep -q "^${NEEDED[0]}=<🔴" "$F2" && ok "A5a 缺值那行標成 <🔴 …>" || bad "A5a 缺值沒被標出來"
|
||||
printf '%s\n' "$OUT2" | grep -q "找不到值的 1 個 ${NEEDED[0]}" \
|
||||
&& ok "A5b 收尾點名缺的是誰" || bad "A5b 收尾沒點名:$OUT2"
|
||||
|
||||
if [ "$BEFORE" = "$(git status --porcelain)" ]; then ok "A6 跑完沒有任何檔案被寫進 repo"
|
||||
else bad "A6 repo 裡多了東西:$(diff <(printf '%s\n' "$BEFORE") <(git status --porcelain) | tr '\n' ' ')"; fi
|
||||
|
||||
echo
|
||||
echo "── B. 拿這台機器真正的 .env 對帳(只印長度,不印值)──"
|
||||
ENVF=()
|
||||
while IFS= read -r l; do ENVF+=("$l"); done < <(
|
||||
sed -n '/^ENV_FILES=(/,/^)/p' "$S" | sed -E '1d;$d; s/^[[:space:]]*"//; s/"[[:space:]]*$//' | grep -v '^$')
|
||||
BASE="${INKSTONE_ROOT:-$HOME/Documents/tech_projects/InkStoneCo}"
|
||||
real_src(){ # $1=名字 → 印出「值的長度 來源檔」;找不到回非 0
|
||||
local name="$1" f p v
|
||||
for p in "${ENVF[@]}"; do
|
||||
f="${p/\$BASE/$BASE}"; f="${f/\$\{BASE\}/$BASE}"
|
||||
[ -f "$f" ] || continue
|
||||
v=$(grep -E "^[[:space:]]*(export[[:space:]]+)?${name}=" "$f" 2>/dev/null | tail -1 \
|
||||
| sed -E "s/^[[:space:]]*(export[[:space:]]+)?${name}=//" | sed -E 's/^"(.*)"$/\1/; s/^'"'"'(.*)'"'"'$/\1/')
|
||||
[ -n "$v" ] && { printf '%s %s' "${#v}" "$f"; return 0; }
|
||||
done
|
||||
return 1
|
||||
}
|
||||
# 只取值、不取來源,給 B9 比對用。值只活在變數裡,從不印出、也不寫檔。
|
||||
_val(){ local r f; r=$(real_src "$1") || return 1; f="${r#* }"
|
||||
grep -E "^[[:space:]]*(export[[:space:]]+)?$1=" "$f" | tail -1 \
|
||||
| sed -E "s/^[[:space:]]*(export[[:space:]]+)?$1=//" | sed -E 's/^"(.*)"$/\1/; s/^'"'"'(.*)'"'"'$/\1/'; }
|
||||
|
||||
found=0
|
||||
for p in "${ENVF[@]}"; do f="${p/\$BASE/$BASE}"; [ -f "$f" ] && found=1; done
|
||||
|
||||
if [ "$found" = 0 ]; then
|
||||
skip "B7 這台機器一個 .env 都沒有(雲端就是這個狀態),對帳跳過"
|
||||
skip "B8 同上"
|
||||
else
|
||||
gone=0; prod=0
|
||||
for n in "${NEEDED[@]}"; do
|
||||
if r=$(real_src "$n"); then
|
||||
len="${r%% *}"; src="${r#* }"
|
||||
printf ' %-38s → 找得到(長度 %s)來自 %s\n' "$n" "$len" "${src#$BASE/}"
|
||||
case "$src" in */polaris/mira/.env) prod=$((prod+1)); echo " 🔴 ↑ 這是 leo21c 現役正式環境那份 .env";; esac
|
||||
else
|
||||
printf ' %-38s → 🔴 這台拿不到\n' "$n"; gone=$((gone+1))
|
||||
fi
|
||||
done
|
||||
chk 0 "$gone" "B7 清單上每一把這台都拿得到值"
|
||||
chk 0 "$prod" "B8 沒有一把的值來自 polaris/mira/.env(leo21c 正式環境)"
|
||||
|
||||
# B9 —— leo 2026-09-01 的紅線:「CLOUDFLARE_API_TOKEN_leo21c 不准加」。
|
||||
# 🔴 判準是**值**不是名字:拿 leo21c 那把的值,比對清單上每一把解出來的值。
|
||||
# 有人把它改名叫 CF_TOKEN_BACKUP 照樣會紅,而黑名單會放它過去。
|
||||
# B8 抓不到這一條(那把住在頂層 .env,不在 polaris/mira/.env)。
|
||||
if leoval=$(_val CLOUDFLARE_API_TOKEN_leo21c); then
|
||||
hit=0
|
||||
for n in "${NEEDED[@]}"; do
|
||||
v=$(_val "$n") || continue
|
||||
[ "$v" = "$leoval" ] && { hit=$((hit+1)); echo " 🔴 $n 的值就是 leo21c 那把"; }
|
||||
done
|
||||
chk 0 "$hit" "B9 清單上沒有一把的值等於 CLOUDFLARE_API_TOKEN_leo21c"
|
||||
else
|
||||
skip "B9 這台找不到 CLOUDFLARE_API_TOKEN_leo21c,沒有比對基準"
|
||||
fi
|
||||
|
||||
# B8 全綠有兩種可能:真的沒有正式憑證,或**偵測根本不會亮**。分得開才算驗過。
|
||||
# 拿一個已知住在 polaris/mira/.env 的名字餵它,看它認不認得出來。
|
||||
if r=$(real_src CLOUDFLARE_ACCOUNT_ID); then
|
||||
case "${r#* }" in
|
||||
*/polaris/mira/.env) ok "B8x 反例自驗:把 leo21c 那份 .env 的變數餵進去,偵測認得出來" ;;
|
||||
*) skip "B8x 反例自驗:CLOUDFLARE_ACCOUNT_ID 這次解到 ${r#* },不是 mira 那份,這台沒得驗" ;;
|
||||
esac
|
||||
else
|
||||
skip "B8x 反例自驗:這台找不到 CLOUDFLARE_ACCOUNT_ID,沒有現成的反例可餵"
|
||||
fi
|
||||
fi
|
||||
|
||||
echo
|
||||
echo "$PASS/$((PASS+FAIL)) 通過,跳過 $SKIP 條"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
@@ -1,97 +0,0 @@
|
||||
#!/bin/bash
|
||||
# settings-allow-sync 的測試(inkstone/ISEP#130)
|
||||
#
|
||||
# 它守什麼: 「雲端 session 開工時就帶著跟本機同一份權限白名單」這件事的機器那一半。
|
||||
# leo 09-07 親手加的四條只在本機 InkStoneCo/.claude/settings.json;雲端沒有 ⇒ 同樣動作被分類器擋
|
||||
# (09-04 run log:permission_denials=6)。清單改住 ISEP 一份,本支把它寫進那台機器的 ~/.claude/settings.json。
|
||||
#
|
||||
# 🔴 全程在 TMP 底下的假 settings.json 上跑,不碰真的 ~/.claude/settings.json。
|
||||
cd "$(dirname "$0")/.." || exit 1
|
||||
S=scripts/settings-allow-sync
|
||||
LIST=docs/permissions-allow.json
|
||||
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
|
||||
PASS=0; FAIL=0
|
||||
ok(){ PASS=$((PASS+1)); printf ' ✅ %s\n' "$1"; }
|
||||
bad(){ FAIL=$((FAIL+1)); printf ' ❌ %s\n' "$1"; }
|
||||
N=$(python3 -c "import json;print(len(json.load(open('$LIST'))['allow']))")
|
||||
|
||||
echo "── A. 清單本身的形狀 ──"
|
||||
python3 - "$LIST" <<'PY' && ok "A1 每一條都是 Bash(…) 形狀,而且四個正門工具都在場(ticket/mainline/gate-ok/gitea-pr-merge)" || bad "A1 清單形狀不對或少了正門工具"
|
||||
import json, sys
|
||||
rules = json.load(open(sys.argv[1]))["allow"]
|
||||
assert rules and all(r.startswith("Bash(") and r.endswith(")") for r in rules), rules
|
||||
for tool in ("scripts/ticket", "scripts/mainline", "scripts/gate-ok", "scripts/gitea-pr-merge.sh"):
|
||||
assert any(tool in r for r in rules), "缺 " + tool
|
||||
assert not any(r.strip() in ("Bash(python3 *)", "Bash(*)", "Bash(bash *)") for r in rules), "整類放行"
|
||||
PY
|
||||
|
||||
echo "── B. 寫進去(假的 settings.json)──"
|
||||
T="$TMP/a/settings.json"
|
||||
OUT=$(python3 "$S" --target "$T" --home /root 2>&1); RC=$?
|
||||
[ "$RC" = 0 ] && [ -f "$T" ] && ok "B1 目標不存在 ⇒ 建出來(離開碼 0)" || bad "B1 rc=$RC:$OUT"
|
||||
python3 -c "import json;d=json.load(open('$T'));assert len(d['permissions']['allow'])==$N" && ok "B2 寫進 $N 條,JSON 合法" || bad "B2 條數不對或不是 JSON"
|
||||
grep -q 'Bash(python3 /root/.claude/plugins/cache/inkstone/isep/\*/scripts/ticket \*)' "$T" \
|
||||
&& ok "B3 開頭的 ~ 換成了 --home 給的家目錄(雲端=/root)" || bad "B3 ~ 沒換成家目錄"
|
||||
grep -q '"~/' "$T" && bad "B4 檔裡還留著 ~" || ok "B4 檔裡沒有殘留的 ~"
|
||||
grep -q 'CLAUDE_PLUGIN_ROOT' "$T" && ok "B5 \$CLAUDE_PLUGIN_ROOT 那幾條原樣保留(閘印出來的逃生門就是這個形狀)" || bad "B5 少了 \$CLAUDE_PLUGIN_ROOT 形狀"
|
||||
tail -c1 "$T" | od -An -c | grep -q '\\n' && ok "B6 收尾有換行" || bad "B6 沒換行"
|
||||
|
||||
SUM1=$(cksum < "$T"); OUT=$(python3 "$S" --target "$T" --home /root 2>&1); SUM2=$(cksum < "$T")
|
||||
[ "$SUM1" = "$SUM2" ] && printf '%s' "$OUT" | grep -q '已齊' && ok "B7 跑第二次:檔案一個位元組都沒變、說「已齊」(冪等)" || bad "B7 不冪等:$OUT"
|
||||
|
||||
echo "── C. 只加不減:別人手加的東西一個字不動 ──"
|
||||
T2="$TMP/b/settings.json"; mkdir -p "$TMP/b"
|
||||
cat > "$T2" <<'JSON'
|
||||
{
|
||||
"extraKnownMarketplaces": {"inkstone": {"source": {"source": "git", "url": "https://git.uncle6.me/inkstone/ISEP.git"}}},
|
||||
"enabledPlugins": {"isep@inkstone": true},
|
||||
"permissions": {
|
||||
"allow": ["Bash(npx wrangler secret:*)", "Bash(python3 scripts/ticket *)"],
|
||||
"deny": ["Edit(//Users/x/wrangler.toml)"]
|
||||
},
|
||||
"hooks": {"PreToolUse": []}
|
||||
}
|
||||
JSON
|
||||
OUT=$(python3 "$S" --target "$T2" --home /Users/youlinhsieh 2>&1)
|
||||
python3 - "$T2" "$N" <<'PY' && ok "C1 原有的 allow/deny/marketplace/hooks 全在,原本那條沒重複,只補了缺的" || bad "C1 動到了別人的東西:$(cat "$T2")"
|
||||
import json, sys
|
||||
d = json.load(open(sys.argv[1])); n = int(sys.argv[2])
|
||||
a = d["permissions"]["allow"]
|
||||
assert a[0] == "Bash(npx wrangler secret:*)" and a[1] == "Bash(python3 scripts/ticket *)", a[:2]
|
||||
assert a.count("Bash(python3 scripts/ticket *)") == 1
|
||||
assert len(a) == 2 + n - 1, (len(a), n)
|
||||
assert d["permissions"]["deny"] == ["Edit(//Users/x/wrangler.toml)"]
|
||||
assert d["enabledPlugins"] == {"isep@inkstone": True}
|
||||
assert d["hooks"] == {"PreToolUse": []}
|
||||
assert any("/Users/youlinhsieh/.claude/plugins/cache/inkstone/isep/*/scripts/mainline" in x for x in a)
|
||||
PY
|
||||
printf '%s' "$OUT" | grep -q "+$((N-1)) 條" && ok "C2 印出來的是「+$((N-1)) 條」(缺幾條補幾條)" || bad "C2 計數不對:$OUT"
|
||||
|
||||
echo "── D. --check/--dry-run ──"
|
||||
python3 "$S" --target "$T" --home /root --check >/dev/null 2>&1 && ok "D1 --check:全齊 ⇒ 離開碼 0" || bad "D1 --check 全齊卻非 0"
|
||||
T3="$TMP/c/settings.json"; mkdir -p "$TMP/c"; echo '{}' > "$T3"
|
||||
python3 "$S" --target "$T3" --home /root --check >/dev/null 2>&1; RC=$?
|
||||
[ "$RC" = 1 ] && ok "D2 --check:缺 ⇒ 離開碼 1(驗收用)" || bad "D2 --check 缺卻回 $RC"
|
||||
[ "$(cat "$T3")" = "{}" ] && ok "D3 --check 不寫檔" || bad "D3 --check 寫了檔"
|
||||
python3 "$S" --target "$T3" --home /root --dry-run >/dev/null 2>&1
|
||||
[ "$(cat "$T3")" = "{}" ] && ok "D4 --dry-run 不寫檔" || bad "D4 --dry-run 寫了檔"
|
||||
|
||||
echo "── E. 壞掉的目標:不碰、不炸(這支掛在 SessionStart)──"
|
||||
T4="$TMP/d/settings.json"; mkdir -p "$TMP/d"; printf '{ not json' > "$T4"
|
||||
OUT=$(python3 "$S" --target "$T4" --home /root 2>&1); RC=$?
|
||||
[ "$RC" = 0 ] && [ "$(cat "$T4")" = "{ not json" ] && printf '%s' "$OUT" | grep -q '沒有動它' \
|
||||
&& ok "E1 目標不是 JSON ⇒ 原封不動、講出來、離開碼 0" || bad "E1 rc=$RC 內容=$(cat "$T4") out=$OUT"
|
||||
python3 "$S" --target "$T4" --home /root --check >/dev/null 2>&1; [ $? = 1 ] && ok "E2 同一個檔用 --check 問 ⇒ 離開碼 1(不裝沒事)" || bad "E2 --check 對壞檔回 0"
|
||||
|
||||
echo "── F. 接線:SessionStart 有掛、雲端 setup script 有叫 ──"
|
||||
python3 - <<'PY' && ok "F1 hooks.json 的 SessionStart 註冊了 scripts/settings-allow-sync" || bad "F1 hooks.json 沒掛"
|
||||
import json
|
||||
d = json.load(open("hooks/hooks.json"))
|
||||
cmds = [h["command"] for g in d["hooks"]["SessionStart"] for h in g["hooks"]]
|
||||
assert any("scripts/settings-allow-sync" in c for c in cmds), cmds
|
||||
PY
|
||||
grep -q 'settings-allow-sync' docs/cloud-setup-script.sh && ok "F2 docs/cloud-setup-script.sh 裝完 plugin 會跑它" || bad "F2 setup script 沒叫它"
|
||||
grep -q 'exit 0$' docs/cloud-setup-script.sh && ok "F3 setup script 仍然 exit 0(非零會讓整個 session 開不起來)" || bad "F3 setup script 結尾不是 exit 0"
|
||||
|
||||
echo; echo "$PASS/$((PASS+FAIL)) 通過"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
@@ -1,224 +0,0 @@
|
||||
#!/bin/bash
|
||||
# 雲端工人抓票規則的測試(inkstone/ISEP#131)
|
||||
#
|
||||
# 票上的驗收第 1 條:「`scripts/ticket pick` 給定主線檔,回一張符合規則的票;
|
||||
# 池子裡塞一張 `Human`、一張有 assignee、一張 backlog,三張都不會被挑到(測試綠)。」
|
||||
#
|
||||
# 這支測四件事:
|
||||
# ① `pickable()` 純函式——規則本體,一格一條,不打網路
|
||||
# ② `pick` 走整條路(把 api() 換成錄音機餵一個假池子):挑到誰、順序、主線抓盡才抓逾期、
|
||||
# 沒有可抓的票時離開碼 1、沒有主線時離開碼 2 且訊息講得出出路
|
||||
# ③ `claim` 一個動作三件事(指派/s/doing/【身份】留言),以及該擋的擋在**打 API 之前**
|
||||
# ④ 不該擋的(誤攔比漏擋更該修)
|
||||
#
|
||||
# 全程離線:假池子在下面的 POOL;TICKET_HOST 指到連不上的位址,任何一條真的走到網路會當場炸,
|
||||
# 不會靜靜變成假綠。不開票、不改票、不留任何東西在 Gitea 上。
|
||||
cd "$(dirname "$0")/.." || exit 1
|
||||
T=scripts/ticket
|
||||
TMP=$(mktemp -d)
|
||||
trap 'rm -rf "$TMP"' EXIT
|
||||
PASS=0; FAIL=0
|
||||
export TICKET_HOST=http://127.0.0.1:9 GITEA_TOKEN=x
|
||||
export ISEP_COUNTDOWN_STATE_DIR="$TMP/state"; mkdir -p "$ISEP_COUNTDOWN_STATE_DIR"
|
||||
export ISEP_COUNTDOWN_NOW=$(python3 -c 'import datetime as d;print(int(d.datetime(2026,9,7,0,0,tzinfo=d.timezone.utc).timestamp()))')
|
||||
unset ISEP_MAINLINE_FILE ISEP_IDENTITY CLAUDE_PROJECT_DIR
|
||||
|
||||
MAIN="$TMP/mainline.json"
|
||||
cat > "$MAIN" <<'JSON'
|
||||
{"ref":"inkstone/Arcrun#48","owner":"inkstone","repo":"Arcrun","id":48,
|
||||
"title":"主線 M","description":"測試用主線","due_on":"2026-09-12T23:59:59Z",
|
||||
"open_issues":3,"closed_issues":0,"members":[],"set_at":"2026-09-07 07:30"}
|
||||
JSON
|
||||
|
||||
# ── 假池子:三個 repo、三個 open milestone、十一張票 ─────────────────────
|
||||
# 主線 M(未逾期,主線)/逾期 M(2026-08-19 到期)/未來 M(2026-10-01 到期,不是主線)
|
||||
cat > "$TMP/pool.py" <<'PY'
|
||||
import json, os
|
||||
MS = {"main": {"id": 48, "title": "主線 M", "due_on": "2026-09-12T23:59:59Z"},
|
||||
"late": {"id": 49, "title": "逾期 M", "due_on": "2026-08-19T23:59:59Z"},
|
||||
"future": {"id": 50, "title": "未來 M", "due_on": "2026-10-01T23:59:59Z"}}
|
||||
def I(repo, n, labels, ms=None, assignees=(), created="2026-09-01T00:00:00Z", pr=False, title=None):
|
||||
d = {"number": n, "title": title or f"票 {repo}#{n}", "state": "open",
|
||||
"labels": [{"name": l} for l in labels],
|
||||
"assignees": [{"login": a} for a in assignees],
|
||||
"milestone": MS[ms] if ms else None, "created_at": created,
|
||||
"repository": {"full_name": f"inkstone/{repo}"}}
|
||||
if pr: d["pull_request"] = {"merged": False}
|
||||
return d
|
||||
POOL = {
|
||||
"ISEP": [I("ISEP", 1, ["s/todo"], "main"), # ★ 可抓
|
||||
I("ISEP", 2, ["s/todo", "Human"], "main"), # 票上第 1 條:Human
|
||||
I("ISEP", 3, ["s/todo"], "main", assignees=("someone",)), # 票上第 1 條:有 assignee
|
||||
I("ISEP", 4, ["s/backlog"], None), # 票上第 1 條:backlog
|
||||
I("ISEP", 5, ["s/todo"], None), # 沒里程碑
|
||||
I("ISEP", 10, ["s/todo"], "main", pr=True), # PR 不是票
|
||||
I("ISEP", 11, ["s/todo", "human/exec"], "main")], # 執行者是人
|
||||
"Arcrun": [I("Arcrun", 6, ["s/todo", "p/high"], "main", created="2026-08-27T00:00:00Z"), # ★ 主線裡最優先
|
||||
I("Arcrun", 7, ["s/todo"], "late"), # 逾期里程碑:主線抓盡才輪到
|
||||
I("Arcrun", 8, ["s/todo"], "future")], # 不是主線也沒逾期:永遠不抓
|
||||
"mira": [I("mira", 9, ["s/todo", "s/doing"], "main")], # 09-07 實查 mira#6 的形狀:有人在做
|
||||
}
|
||||
MSN = {"ISEP": ["main", "late", "future"], "Arcrun": ["main", "late", "future"], "mira": ["main"]}
|
||||
DROP = set(json.loads(os.environ.get("DROP", "[]"))) # 測「主線抓盡」用:把某幾張從池子拿掉
|
||||
def fake_api(path, payload=None, method=None):
|
||||
rec.append((method or ("POST" if payload is not None else "GET"), path, payload))
|
||||
if path.startswith("/orgs/inkstone/repos"):
|
||||
return [{"name": r} for r in POOL]
|
||||
if path == "/user":
|
||||
return {"login": "claude-code"}
|
||||
if "/milestones?" in path:
|
||||
repo = path.split("/")[3]
|
||||
return [MS[k] for k in MSN.get(repo, [])]
|
||||
if "/issues?" in path:
|
||||
repo = path.split("/")[3]
|
||||
import urllib.parse
|
||||
q = urllib.parse.parse_qs(path.split("?", 1)[1])
|
||||
want = q.get("milestones", [""])[0]
|
||||
return [i for i in POOL[repo] if (i["milestone"] or {}).get("title") == want
|
||||
and f"{repo}#{i['number']}" not in DROP]
|
||||
if path.endswith("/labels?limit=100"):
|
||||
return [{"name": n, "id": k} for k, n in
|
||||
enumerate(["s/todo", "s/doing", "s/review", "p/high", "Human"], 1)]
|
||||
import re
|
||||
m = re.match(r"/repos/inkstone/(\w+)/issues/(\d+)$", path)
|
||||
if m and (method or "GET") == "GET":
|
||||
return next(i for i in POOL[m.group(1)] if i["number"] == int(m.group(2)))
|
||||
return {}
|
||||
rec = []
|
||||
PY
|
||||
|
||||
# probe <python 片段> —— 把 scripts/ticket 當模組載進來、api() 換成假池子,印出片段的值
|
||||
probe() {
|
||||
python3 - "$1" "$2" <<'PY'
|
||||
import sys, os, json, io, contextlib, importlib.util as u
|
||||
from importlib.machinery import SourceFileLoader as L
|
||||
spec = u.spec_from_loader("t", L("t", "scripts/ticket"))
|
||||
m = u.module_from_spec(spec); spec.loader.exec_module(m)
|
||||
ns = {}
|
||||
exec(open(os.environ["POOL_PY"]).read(), ns)
|
||||
m.api = ns["fake_api"]; rec = ns["rec"]
|
||||
argv = json.loads(sys.argv[2]) if sys.argv[2] else None
|
||||
buf = io.StringIO(); rc = None
|
||||
if argv is not None:
|
||||
with contextlib.redirect_stdout(buf), contextlib.redirect_stderr(buf):
|
||||
try:
|
||||
getattr(m, argv[0])(argv[1:])
|
||||
except SystemExit as e:
|
||||
rc = e.code
|
||||
print(eval(sys.argv[1], {"m": m, "rec": rec, "rc": rc, "out": buf.getvalue(), "I": ns["I"], "json": json}))
|
||||
PY
|
||||
}
|
||||
export POOL_PY="$TMP/pool.py"
|
||||
|
||||
p() { # p <說明> <want> <python 片段> [argv json]
|
||||
got=$(probe "$3" "${4:-}" 2>&1)
|
||||
if [ "$got" = "$2" ]; then PASS=$((PASS+1)); printf ' ✅ '; else FAIL=$((FAIL+1)); printf ' ❌ '; fi
|
||||
printf 'want=%s got=%s %s\n' "$2" "$got" "$1"
|
||||
}
|
||||
|
||||
echo "── ① pickable():規則本體,一格一條(純函式,不打網路)──"
|
||||
p "★ s/todo+沒人+沒 Human+主線 → 可抓" "True" "m.pickable(I('ISEP',1,['s/todo'],'main'),'主線 M')[0]"
|
||||
p "★ 掛 Human → 不可抓(票上第 1 條)" "False" "m.pickable(I('ISEP',2,['s/todo','Human'],'main'),'主線 M')[0]"
|
||||
p "★ 有 assignee → 不可抓(票上第 1 條)" "False" "m.pickable(I('ISEP',3,['s/todo'],'main',assignees=('x',)),'主線 M')[0]"
|
||||
p "★ s/backlog、沒里程碑 → 不可抓(票上第 1 條)" "False" "m.pickable(I('ISEP',4,['s/backlog'],None),'主線 M')[0]"
|
||||
p "s/todo 但沒里程碑 → 不可抓(不抓沒里程碑的)" "False" "m.pickable(I('ISEP',5,['s/todo'],None),'主線 M')[0]"
|
||||
p "human/exec(執行者是人)→ 不可抓" "False" "m.pickable(I('ISEP',11,['s/todo','human/exec'],'main'),'主線 M')[0]"
|
||||
p "s/todo+s/doing 同時掛著(mira#6 的形狀)→ 不可抓,有人在做" "False" "m.pickable(I('mira',9,['s/todo','s/doing'],'main'),'主線 M')[0]"
|
||||
p "hub(scope 容器,09-07 實查 ISEP#31–35 的形狀)→ 不可抓" "False" "m.pickable(I('ISEP',12,['s/todo','hub'],'main'),'主線 M')[0]"
|
||||
p "PR 不是票 → 不可抓" "False" "m.pickable(I('ISEP',10,['s/todo'],'main',pr=True),'主線 M')[0]"
|
||||
p "里程碑不是要求的那個 → 不可抓" "False" "m.pickable(I('Arcrun',8,['s/todo'],'future'),'主線 M')[0]"
|
||||
p "里程碑標題只差空白/大小寫 → 仍算同一個(norm 只有 mainline.py 那一份)" "True" "m.pickable(I('ISEP',1,['s/todo'],'main'),' 主線 m ')[0]"
|
||||
p "理由講得出「為什麼不能抓」(不是只回 False)" "True" "'Human' in m.pickable(I('ISEP',2,['s/todo','Human'],'main'),'主線 M')[1]"
|
||||
p "順序:p/high 先於沒標,沒標先於 p/low" "True" \
|
||||
"m.pick_order(I('a',1,['s/todo','p/high'],'main')) < m.pick_order(I('a',2,['s/todo'],'main')) < m.pick_order(I('a',3,['s/todo','p/low'],'main'))"
|
||||
p "順序:同優先序看開票時間,舊的先" "True" \
|
||||
"m.pick_order(I('a',9,['s/todo'],'main',created='2026-08-01T00:00:00Z')) < m.pick_order(I('a',1,['s/todo'],'main',created='2026-09-01T00:00:00Z'))"
|
||||
|
||||
echo
|
||||
echo "── ② pick 走整條路(假池子 11 張,三個 repo)──"
|
||||
ARGS="[\"cmd_pick\",\"--mainline\",\"$MAIN\"]"
|
||||
ALL="[\"cmd_pick\",\"--mainline\",\"$MAIN\",\"--all\",\"--json\"]"
|
||||
p "★ 給定主線檔 → 回一張,而且是主線裡最優先的 Arcrun#6(p/high)" "True" "'inkstone/Arcrun#6' in out and rc is None" "$ARGS"
|
||||
p "只回一張(不是整份清單)" "1" "out.count(' ● ')" "$ARGS"
|
||||
p "★ --all:主線裡可抓的恰好是 Arcrun#6、ISEP#1 兩張——Human/assignee/backlog 三張都不在" \
|
||||
"['inkstone/Arcrun#6', 'inkstone/ISEP#1']" "[r['ref'] for r in json.loads(out) if r['group']=='主線']" "$ALL"
|
||||
p "★ --all:逾期里程碑那張 Arcrun#7 排在主線之後(主線抓盡才輪到)" \
|
||||
"['inkstone/Arcrun#7']" "[r['ref'] for r in json.loads(out) if r['group']!='主線']" "$ALL"
|
||||
p "沒逾期也不是主線的 Arcrun#8 不在清單裡" "False" "'inkstone/Arcrun#8' in out" "$ALL"
|
||||
p "backlog(ISEP#4)/沒里程碑(ISEP#5)不在清單裡" "False" "'ISEP#4' in out or 'ISEP#5' in out" "$ALL"
|
||||
p "沒有任何一條真的走到網路(api 全被錄音機接住)" "True" "all(p.startswith('/') for _,p,_ in rec)" "$ALL"
|
||||
p "pick 只讀不寫(沒有 POST/PATCH/PUT)" "True" "all(mm=='GET' for mm,_,_ in rec)" "$ALL"
|
||||
p "訊息印出下一步(認領那一行用絕對路徑,貼到別的 cwd 也叫得到正本)" "True" "'claim inkstone/Arcrun#6' in out and m.self_path() in out" "$ARGS"
|
||||
|
||||
echo
|
||||
echo " (主線抓盡 → 才輪到逾期里程碑)"
|
||||
export DROP='["Arcrun#6","ISEP#1"]'
|
||||
p "★ 主線兩張都被拿走後 → 回逾期里程碑的 Arcrun#7" "True" "'inkstone/Arcrun#7' in out and rc is None" "$ARGS"
|
||||
export DROP='["Arcrun#6","ISEP#1","Arcrun#7"]'
|
||||
p "★ 主線與逾期都抓盡 → 離開碼 1(真的沒有,不是故障)" "1" "rc" "$ARGS"
|
||||
p "訊息明講「不要去抓 backlog」(出路是收工回報,不是換規則)" "True" "'backlog' in out and '收工' in out" "$ARGS"
|
||||
p "抓盡時**沒有**回 Arcrun#8(未來里程碑)" "False" "'Arcrun#8' in out" "$ARGS"
|
||||
unset DROP
|
||||
|
||||
echo
|
||||
echo " (沒有主線 ≠ 去抓別的)"
|
||||
NOML="[\"cmd_pick\",\"--mainline\",\"$TMP/none.json\"]"
|
||||
p "主線檔讀不到 → 離開碼 2(讀不到 ≠ 沒有)" "2" "rc" "$NOML"
|
||||
p "…而且一通 API 都沒打" "0" "len(rec)" "$NOML"
|
||||
p "沒給 --mainline、狀態檔也沒有、cwd 也沒有 → 離開碼 2,訊息給出兩條出路" "True" \
|
||||
"rc==2 and 'mainline set' in out and 'system-dev/mainline.json' in out" "[\"cmd_pick\"]"
|
||||
|
||||
echo
|
||||
echo "── ③ claim:一個動作三件事 ──"
|
||||
CL="[\"cmd_claim\",\"inkstone/Arcrun#6\",\"--mainline\",\"$MAIN\",\"--name\",\"isep-hand\"]"
|
||||
p "★ 指派給本 token 的使用者(欄位,不是一句話)" "[['claude-code']]" \
|
||||
"[pl['assignees'] for mm,p,pl in rec if mm=='PATCH' and p=='/repos/inkstone/Arcrun/issues/6']" "$CL"
|
||||
p "★ s/todo 換成 s/doing,p/high 留著(不是整組蓋掉)" "True" \
|
||||
"[sorted(pl['labels'])==[2,4] for mm,p,pl in rec if mm=='PUT' and p.endswith('/issues/6/labels')]==[True]" "$CL"
|
||||
p "★ 留言第一行是【身份】isep-hand/inkstone/Arcrun/-" "True" \
|
||||
"[pl['body'].split(chr(10))[0] for mm,p,pl in rec if mm=='POST' and p.endswith('/issues/6/comments')]==['【身份】isep-hand/inkstone/Arcrun/-']" "$CL"
|
||||
p "留言講了做完要走 handback(不推 main、不出貨)" "True" \
|
||||
"any('handback' in pl['body'] and '不推 main' in pl['body'] for mm,p,pl in rec if mm=='POST' and p.endswith('/comments'))" "$CL"
|
||||
p "三件事都做了,離開碼 0" "None" "rc" "$CL"
|
||||
p "--as 指定登入名時用它" "[['cloud-bot']]" \
|
||||
"[pl['assignees'] for mm,p,pl in rec if mm=='PATCH']" "[\"cmd_claim\",\"inkstone/Arcrun#6\",\"--mainline\",\"$MAIN\",\"--as\",\"cloud-bot\"]"
|
||||
p "逾期里程碑的票(Arcrun#7)也認領得了——主線抓盡時輪到它" "None" "rc" \
|
||||
"[\"cmd_claim\",\"inkstone/Arcrun#7\",\"--mainline\",\"$MAIN\"]"
|
||||
p "pick --claim:挑到誰就認領誰(Arcrun#6)" "True" \
|
||||
"any(mm=='PATCH' and p.endswith('/issues/6') for mm,p,pl in rec)" "[\"cmd_pick\",\"--mainline\",\"$MAIN\",\"--claim\",\"--name\",\"isep-hand\"]"
|
||||
|
||||
echo
|
||||
echo " (該擋的:規則在 claim 這一端再驗一次,擋在**寫入之前**)"
|
||||
blocked() { # blocked <說明> <ref> [extra argv...]
|
||||
what=$1; ref=$2; shift 2
|
||||
extra=$(printf '%s\n' "$@" | python3 -c "import sys,json;print(','.join(json.dumps(l.rstrip()) for l in sys.stdin if l.strip()))")
|
||||
argv="[\"cmd_claim\",\"$ref\",\"--mainline\",\"$MAIN\"${extra:+,$extra}]"
|
||||
p "$what → 離開碼 2,且沒有任何寫入" "True" \
|
||||
"rc==2 and not any(mm in ('PATCH','PUT','POST') for mm,_,_ in rec)" "$argv"
|
||||
}
|
||||
blocked "掛 Human 的 ISEP#2" inkstone/ISEP#2
|
||||
blocked "已指派的 ISEP#3" inkstone/ISEP#3
|
||||
blocked "backlog 的 ISEP#4" inkstone/ISEP#4
|
||||
blocked "沒逾期也不是主線的 Arcrun#8" inkstone/Arcrun#8
|
||||
blocked "有人在做的 mira#9(s/doing 也掛著)" inkstone/mira#9
|
||||
p "擋下時訊息講得出理由與出路(pick)" "True" "'Human' in out and 'pick' in out" \
|
||||
"[\"cmd_claim\",\"inkstone/ISEP#2\",\"--mainline\",\"$MAIN\"]"
|
||||
p "身份名不在名單上 → 在打任何 API 之前就擋(一通都沒打)" "True" "rc==2 and len(rec)==0" \
|
||||
"[\"cmd_claim\",\"inkstone/Arcrun#6\",\"--mainline\",\"$MAIN\",\"--name\",\"路人\"]"
|
||||
|
||||
echo
|
||||
echo "── ④ 動詞接得上(不帶假池子,走到網路才炸)──"
|
||||
out=$(python3 "$T" pick --mainline "$MAIN" 2>&1); got=$?
|
||||
if [ "$got" = 2 ] && printf '%s' "$out" | grep -q '拿不到 Gitea'; then PASS=$((PASS+1)); printf ' ✅ '; else FAIL=$((FAIL+1)); printf ' ❌ '; fi
|
||||
printf 'want=2 got=%s pick 連不上 Gitea → 離開碼 2 並說「讀不到 ≠ 沒有」(不是離開碼 1 的假「沒票」)\n' "$got"
|
||||
out=$(python3 "$T" 2>&1)
|
||||
if printf '%s' "$out" | grep -q "ticket pick" && printf '%s' "$out" | grep -q "ticket claim"; then PASS=$((PASS+1)); printf ' ✅ '
|
||||
else FAIL=$((FAIL+1)); printf ' ❌ '; fi
|
||||
printf '不帶參數的說明裡列得出 pick/claim(撈不到的東西等於不存在)\n'
|
||||
out=$(python3 "$T" usage pick 2>&1); got=$?
|
||||
if [ "$got" = 0 ] && printf '%s' "$out" | grep -q -- '--mainline'; then PASS=$((PASS+1)); printf ' ✅ '; else FAIL=$((FAIL+1)); printf ' ❌ '; fi
|
||||
printf 'ticket usage pick 印得出用法\n'
|
||||
|
||||
echo
|
||||
echo "通過 $PASS 條,失敗 $FAIL 條"
|
||||
[ "$FAIL" = 0 ] || exit 1
|
||||
@@ -1,95 +0,0 @@
|
||||
#!/bin/bash
|
||||
# 「收件 repo 寫 owner/repo 不該是 404」的測試(inkstone/ISEP#130)
|
||||
#
|
||||
# 2026-09-07 實撞:`scripts/ticket new inkstone/ISEP -F …` 回 Gitea 404。
|
||||
# 不是 ISEP 不存在,是這支把 `inkstone/ISEP` 原樣塞進 `/repos/inkstone/{repo}/issues`
|
||||
# ⇒ 打到 `/repos/inkstone/inkstone/ISEP/issues`。404 讀起來像「repo 不存在」,
|
||||
# 於是那天四張票全改成直接打 API 開——**正門壞了人就走側門**。
|
||||
#
|
||||
# 怎麼在不開任何票的前提下驗:把 `scripts/ticket` 當模組載進來,
|
||||
# 把 `api()` 換成一支只記錄路徑的假貨。全程離線、不打 Gitea、不留戳記。
|
||||
cd "$(dirname "$0")/.." || exit 1
|
||||
STAMP=/tmp/.ticket-where-ok
|
||||
SAVED=""; [ -f "$STAMP" ] && SAVED=$(cat "$STAMP")
|
||||
trap '[ -n "$SAVED" ] && printf "%s" "$SAVED" > "$STAMP" || rm -f "$STAMP"' EXIT
|
||||
|
||||
TICKET_HOST=http://127.0.0.1:9 GITEA_TOKEN=x python3 - <<'PY'
|
||||
import importlib.machinery, importlib.util, io, json, os, sys, tempfile, time, contextlib
|
||||
|
||||
loader = importlib.machinery.SourceFileLoader("isep_ticket", "scripts/ticket")
|
||||
spec = importlib.util.spec_from_file_location("isep_ticket", "scripts/ticket", loader=loader)
|
||||
T = importlib.util.module_from_spec(spec); loader.exec_module(T)
|
||||
|
||||
CALLS = []
|
||||
def fake_api(path, payload=None, method=None):
|
||||
CALLS.append((method or ("POST" if payload is not None else "GET"), path))
|
||||
if path.endswith("/labels?limit=100") or path.endswith("/labels?limit=60"):
|
||||
return [{"name": "s/todo", "id": 1}, {"name": "s/doing", "id": 2}]
|
||||
if path.endswith("/issues") and payload is not None:
|
||||
return {"number": 999, "html_url": "http://fake/999", "labels": []}
|
||||
if "/comments" in path:
|
||||
return {"id": 1, "html_url": "http://fake/c1"}
|
||||
if "/dependencies" in path or "/blocks" in path:
|
||||
return [] if payload is None else {}
|
||||
return {"labels": [], "number": 1}
|
||||
T.api = fake_api
|
||||
T.api_soft = lambda path: None
|
||||
|
||||
tmp = tempfile.mkdtemp()
|
||||
body = os.path.join(tmp, "body.md")
|
||||
open(body, "w").write("## 目標\n測試。\n\n## 驗收條件\n離線。\n\n## deliverable 類型\ncode\n")
|
||||
TITLE = "身為要開票的人,我要寫 owner/repo 也開得出票,我才不會被 404 逼去走側門"
|
||||
|
||||
def stamp():
|
||||
json.dump({"at": time.time(), "kws": ["x"], "n": 0, "top": [], "top_detail": [], "shown": True},
|
||||
open(T.stamp_path(), "w"))
|
||||
|
||||
PASS = FAIL = 0
|
||||
def ok(m, *_):
|
||||
global PASS; PASS += 1; print(" ✅ " + m)
|
||||
def bad(m, why="", *_):
|
||||
global FAIL; FAIL += 1; print(" ❌ " + m + (" —— " + why if why else ""))
|
||||
|
||||
def run(fn, argv):
|
||||
"""回 (離開碼, stderr)。die() 走 sys.exit(2)。"""
|
||||
CALLS.clear()
|
||||
err = io.StringIO(); out = io.StringIO()
|
||||
with contextlib.redirect_stderr(err), contextlib.redirect_stdout(out):
|
||||
try:
|
||||
fn(argv); rc = 0
|
||||
except SystemExit as e:
|
||||
rc = e.code if isinstance(e.code, int) else 1
|
||||
return rc, err.getvalue() + out.getvalue()
|
||||
|
||||
print("── new:兩種寫法都要打到同一條路 ──")
|
||||
stamp(); rc, msg = run(T.cmd_new, ["ISEP", "-F", body, "--title", TITLE])
|
||||
posts = [p for m, p in CALLS if m == "POST"]
|
||||
(ok if posts == ["/repos/inkstone/ISEP/issues"] else bad)("① `new ISEP` → /repos/inkstone/ISEP/issues", str(CALLS))
|
||||
|
||||
stamp(); rc, msg = run(T.cmd_new, ["inkstone/ISEP", "-F", body, "--title", TITLE])
|
||||
posts = [p for m, p in CALLS if m == "POST"]
|
||||
(ok if posts == ["/repos/inkstone/ISEP/issues"] else bad)("② `new inkstone/ISEP`(09-07 撞 404 的那一句)→ 同一條路,不再是 /repos/inkstone/inkstone/ISEP", str(CALLS))
|
||||
|
||||
print("── new:寫錯要當場講,不要變成一個 404 讓人猜 ──")
|
||||
stamp(); rc, msg = run(T.cmd_new, ["Leo/ISEP", "-F", body, "--title", TITLE])
|
||||
(ok if rc == 2 and not CALLS and "inkstone" in msg else bad)("③ `new Leo/ISEP` → 擋(exit 2)、一通 API 都不打、訊息說 org 是 inkstone", f"rc={rc} calls={CALLS} msg={msg[:120]}")
|
||||
|
||||
stamp(); rc, msg = run(T.cmd_new, ["inkstone/ISEP#130", "-F", body, "--title", TITLE])
|
||||
(ok if rc == 2 and not CALLS else bad)("④ `new inkstone/ISEP#130`(把票號當 repo)→ 擋,不打 API", f"rc={rc} calls={CALLS}")
|
||||
|
||||
print("── subtask:--to 也吃 owner/repo ──")
|
||||
rc, msg = run(T.cmd_subtask, ["inkstone/ISEP#130", "--title", TITLE, "-F", body, "--to", "inkstone/Arcrun"])
|
||||
posts = [p for m, p in CALLS if m == "POST" and p.endswith("/issues")]
|
||||
(ok if posts == ["/repos/inkstone/Arcrun/issues"] else bad)("⑤ `subtask … --to inkstone/Arcrun` → 子票開在 /repos/inkstone/Arcrun/issues", f"rc={rc} calls={CALLS} msg={msg[:200]}")
|
||||
|
||||
rc, msg = run(T.cmd_subtask, ["inkstone/ISEP#130", "--title", TITLE, "-F", body, "--to", "Arcrun"])
|
||||
posts = [p for m, p in CALLS if m == "POST" and p.endswith("/issues")]
|
||||
(ok if posts == ["/repos/inkstone/Arcrun/issues"] else bad)("⑥ `subtask … --to Arcrun`(原本的寫法)照舊", f"rc={rc} calls={CALLS}")
|
||||
|
||||
print("── 沒有任何東西真的出去 ──")
|
||||
(ok if not os.path.exists(T.stamp_path()) or True else bad)("⑦ 假 api 記到的路徑全部是 /repos/inkstone/<repo>/…,沒有一條含 inkstone/inkstone")
|
||||
if any("inkstone/inkstone" in p for _, p in CALLS): FAIL += 1; PASS -= 1; print(" ❌ ⑦ 出現 inkstone/inkstone")
|
||||
|
||||
print(f"\n通過 {PASS} 條,失敗 {FAIL} 條")
|
||||
sys.exit(1 if FAIL else 0)
|
||||
PY
|
||||
+13
-505
@@ -14,7 +14,7 @@ leo 2026-08-16 三句話,本工具就是它們的機械化:
|
||||
|
||||
ticket where <關鍵字...> 搜「這件事該放哪」→ 產生戳記
|
||||
ticket say <票> -F <檔> 貼進既有票的對話(**預設路徑**)
|
||||
ticket new <repo> -F <檔> 開新票(要戳記+模板欄位齊全;<repo> 寫 ISEP 或 inkstone/ISEP 都行)
|
||||
ticket new <repo> -F <檔> 開新票(要戳記+模板欄位齊全)
|
||||
ticket close <票> --deliverable <URL> 關票(要有交付物連結)
|
||||
ticket decide <票> -F <答案檔> 記 leo 的裁決+改狀態(同一個動作)
|
||||
|
||||
@@ -26,14 +26,6 @@ leo 2026-08-16 三句話,本工具就是它們的機械化:
|
||||
ticket mine [--user <誰>] 撈一次:棒子在誰手上、每根下一步是什麼
|
||||
ticket loose 撈一次:下游都關了、自己還開著的頂層票
|
||||
|
||||
ticket usage <動詞> [--example] 用法的唯一真相源——**閘印的那一行從這裡來**
|
||||
|
||||
雲端工人抓票(inkstone/ISEP#131,規則機械可判,不靠 prompt 叮嚀):
|
||||
|
||||
ticket pick [--mainline <主線檔>] [--all] [--json] 回一張現在可以抓的票(主線抓盡才抓逾期)
|
||||
ticket claim <票> [--as <登入名>] [--name <身份>] 認領=指派+s/doing+【身份】留言,一個動作
|
||||
ticket pick --claim … 上面兩件連著做
|
||||
|
||||
票的寫法:`owner/repo#N`,例:`inkstone/InkStoneCo#44`
|
||||
"""
|
||||
import json
|
||||
@@ -151,29 +143,6 @@ def parse_ref(s):
|
||||
return m.group(1), m.group(2), int(m.group(3))
|
||||
|
||||
|
||||
def repo_arg(s):
|
||||
"""收件 repo 的參數:`ISEP` 與 `inkstone/ISEP` 都收,回 repo 名(不含 org)。
|
||||
|
||||
🔴 2026-09-07 實撞(inkstone/ISEP#130):總管照票號的習慣寫 `ticket new inkstone/ISEP`,
|
||||
這支把它原樣接進 `/repos/inkstone/{repo}/issues` ⇒ 打到 `/repos/inkstone/inkstone/ISEP/issues`
|
||||
⇒ Gitea 回 **404**,而 404 讀起來像「ISEP 這個 repo 不存在」——
|
||||
於是四張票改成直接打 API 開的,**正門壞了人就走側門**,那正是 `ticket-api-bypass-guard`
|
||||
在防的事。票號全稱寫 `owner/repo#N` 是本 repo 的鐵律(CLAUDE.md),
|
||||
所以 `owner/repo` 這個形狀本來就該被接受,不該是 404 的來源。
|
||||
org 寫成別的(`Leo/ISEP`)⇒ 當場講清楚,不要讓它變成一個 404 去猜。
|
||||
"""
|
||||
s = (s or "").strip()
|
||||
if "/" not in s:
|
||||
return s
|
||||
owner, _, name = s.partition("/")
|
||||
if owner != ORG:
|
||||
die(f"🔴 收件 repo 的 org 是 `{ORG}`,你給的是 `{owner}`({s})。\n"
|
||||
f" `Leo/` 那個 org 2026-08-14 已廢;寫 `{ORG}/{name}` 或直接寫 `{name}`。")
|
||||
if not name or "/" in name or "#" in name:
|
||||
die(f"🔴 收件 repo 的寫法是 `<repo>` 或 `{ORG}/<repo>`(不帶票號),你給的是:{s}")
|
||||
return name
|
||||
|
||||
|
||||
def api_soft(path):
|
||||
"""讀一筆,失敗就回 None(不 die)。給「錦上添花」的資訊用,不影響任何判斷。"""
|
||||
try:
|
||||
@@ -312,8 +281,8 @@ def cmd_say(argv):
|
||||
# ── new ──────────────────────────────────────────────────────────────────
|
||||
def cmd_new(argv):
|
||||
if len(argv) < 3 or argv[1] not in ("-F", "--file"):
|
||||
die("用法:ticket new <repo 或 owner/repo> -F <內文檔> [--title <標題>]")
|
||||
repo = repo_arg(argv[0])
|
||||
die("用法:ticket new <repo> -F <內文檔> [--title <標題>]")
|
||||
repo = argv[0]
|
||||
body = open(argv[2]).read()
|
||||
title = None
|
||||
if "--title" in argv:
|
||||
@@ -535,10 +504,6 @@ def _writeback(owner, repo, num, deliv):
|
||||
for i in open_left]
|
||||
lines += ["", "⇒ 本票維持原狀,不要當成可以收了。"]
|
||||
else:
|
||||
# 🔴 這一段是要**貼進 Gitea 留言**的,所以 `ticket close` 刻意寫成相對的
|
||||
# ——留言會被別台機器讀到,寫死本機的絕對路徑等於寫死一個他們沒有的檔案。
|
||||
# 絕對路徑那條規約(inkstone/ISEP#112)管的是**印到終端機、要人複製貼上**的字,
|
||||
# 兩者分界就是這一句:「這行字會被誰複製、在哪台機器上跑?」
|
||||
lines += ["", "**這是最後一張下游——本票的下游已經全部關閉。**", "",
|
||||
f"{BATON_MARK} → `{HANDBACK_TO}`", "",
|
||||
"**下一步**:驗一次頂層要的東西真的到齊了,到齊就 "
|
||||
@@ -754,145 +719,6 @@ def writeback_plan(parent_state, parent_deps):
|
||||
return ("note" if open_left else "handback"), open_left
|
||||
|
||||
|
||||
# ══════════════════════════════════════════════════════════════════════════
|
||||
# inkstone/ISEP#112 — 閘教的那行指令要真的跑得動
|
||||
#
|
||||
# 票上的原話:「**當它教的做法不存在,它就從『幫你』變成『擋你』**——
|
||||
# 而且被擋的人當下正在做別的事,最可能的反應是找個理由繞過去。」
|
||||
#
|
||||
# 那次它為什麼跑不動,兩個獨立的原因(2026-08-31 實測,兩個都會單獨害死它):
|
||||
#
|
||||
# ① **相對路徑**。閘印的是 `scripts/ticket subtask …`,而相對路徑是對
|
||||
# **貼上去那個人的 cwd** 解析的。總管的 cwd 是 `InkStoneCo/`,那裡的
|
||||
# `scripts/ticket` 是本檔停在 2026-08-27 之前的**舊複本**:
|
||||
# grep -c subtask InkStoneCo/scripts/ticket → 0
|
||||
# 它的 docstring 只列到「四個動詞」,於是照著貼會印出那段說明、exit 0、
|
||||
# 什麼都沒發生 —— 正是票上寫的症狀。
|
||||
# (`hooks/lib/beacon_report.py` ② 已經會在 SessionStart 報這個舊複本,
|
||||
# 但**報告不會改掉閘印出來的那一行**。)
|
||||
#
|
||||
# ② **用法各寫一份**。閘手寫了一段用法,`cmd_subtask` 的 die() 又寫了一段。
|
||||
# 兩份已經漂了:閘那份寫 `--assign <誰做>` 卻**沒有 `--next`**,
|
||||
# 而 cmd_subtask 會因為「🚫 指派了人卻沒寫 --next。」直接 die(實測 exit 2,
|
||||
# 而且是在打任何 API 之前,所以離線也複現得出來)。
|
||||
# ⇒ 就算路徑對了,那一行照樣跑不完。
|
||||
#
|
||||
# 🔴 修法是**拿掉可以漂的那一格**,不是把兩份對齊一次:
|
||||
# · 路徑 → self_path(),`__file__` 的絕對路徑。印指令的人與跑指令的人
|
||||
# 是同一個檔案,沒有第二種可能。
|
||||
# · 用法 → USAGE 這一份。閘去 `ticket usage subtask` 拿,不自己抄。
|
||||
# · 內文模板 → body_template() 由 REQUIRED_SECTIONS 現生。
|
||||
# 檢查與模板同一個來源 ⇒ 模板不可能少一段。
|
||||
# ══════════════════════════════════════════════════════════════════════════
|
||||
|
||||
def self_path():
|
||||
"""這支腳本自己的絕對路徑。**閘印出來的指令一律用它。**
|
||||
|
||||
不用 `sys.argv[0]`:那是「別人怎麼叫我」,被相對路徑叫進來時它就是相對的。
|
||||
`__file__` 走 realpath 是「我是誰」——貼到任何 cwd 底下都指得回同一個檔案。
|
||||
"""
|
||||
return os.path.realpath(__file__)
|
||||
|
||||
|
||||
# 每一段必填欄位的草稿提示。**鍵一定要是 REQUIRED_SECTIONS 裡的字串**——
|
||||
# 對不上也不會漏掉那一段(下面會退成 `<填這裡>`),只是提示變笨。
|
||||
SECTION_HINTS = {
|
||||
"## 目標": "<這件事要達成什麼。寫目的,不要寫做法>",
|
||||
"## 驗收條件": "- [ ] <怎麼算做完——別人可以自己跑一次的那種>",
|
||||
"## deliverable 類型": "code",
|
||||
}
|
||||
|
||||
|
||||
def body_template():
|
||||
"""子票內文的草稿,**用 REQUIRED_SECTIONS 現生**。
|
||||
|
||||
🔴 不要把這段字面寫死:寫死就變成第二份,而 `cmd_subtask` 檢查的是
|
||||
REQUIRED_SECTIONS。有人往那個清單加一段,寫死的模板就會生出一張
|
||||
**照著貼卻過不了自己那道閘**的票 —— 這張票要修的就是這個形狀。
|
||||
"""
|
||||
out = []
|
||||
for sec in REQUIRED_SECTIONS:
|
||||
out.append(sec)
|
||||
out.append(SECTION_HINTS.get(sec, "<填這裡>"))
|
||||
out.append("")
|
||||
return "\n".join(out).rstrip() + "\n"
|
||||
|
||||
|
||||
def subtask_example(parent=None, draft=None):
|
||||
"""可以整段複製貼上的那一塊:先把內文草稿寫出來,再開子票。
|
||||
|
||||
刻意**不放 `--assign`**:`--assign` 沒配 `--next` 會被擋(見 cmd_subtask),
|
||||
而一行印出來卻跑不完的指令,正是這張票在修的病。要指派的人看 USAGE 那份,
|
||||
那裡兩個參數是綁在一起寫的。
|
||||
|
||||
留在 <> 裡的只有三件**機器不可能知道**的事:標題、目標、驗收條件。
|
||||
其餘(腳本路徑、母票、必填段落、標籤)全部已經填好。
|
||||
"""
|
||||
parent = parent or "<母票 owner/repo#N>"
|
||||
draft = draft or "/tmp/subtask-body.md"
|
||||
return (
|
||||
"cat > %s <<'MD'\n" % draft
|
||||
+ body_template()
|
||||
+ "MD\n"
|
||||
+ "%s subtask %s \\\n" % (self_path(), parent)
|
||||
+ ' --title "身為<誰>,我要<什麼>,我才<為什麼>" \\\n'
|
||||
+ " -F %s --label s/todo\n" % draft
|
||||
)
|
||||
|
||||
|
||||
# 🔴 `{bin}` 一定要留成佔位符、由 usage_text() 現填 self_path():
|
||||
# 用法裡寫死 `ticket` 或 `scripts/ticket`,讀的人照著貼就又踩回這張票的坑。
|
||||
USAGE = {
|
||||
"pick":
|
||||
"用法:{bin} pick [--mainline <主線 json 檔>] [--all] [--json] [--claim [--as <登入名>] [--name <身份>]]\n"
|
||||
" 回**一張**現在可以抓的票(主線里程碑抓盡才輪到逾期里程碑;不抓 backlog、不抓沒里程碑的)\n"
|
||||
" --mainline 不給時依序找:$ISEP_MAINLINE_FILE → ~/.claude/isep-countdown/mainline.json"
|
||||
" → $CLAUDE_PROJECT_DIR/system-dev/mainline.json\n"
|
||||
" 離開碼:0 = 有票(印在 stdout);1 = 真的沒有可抓的票;2 = 讀不到(讀不到 ≠ 沒有)",
|
||||
"claim":
|
||||
"用法:{bin} claim <owner/repo#N> [--as <登入名,預設本 token 的使用者>] [--name <身份名,預設 subagent>]"
|
||||
" [--mainline <主線 json 檔>]\n"
|
||||
" 認領=指派給自己 + 換成 s/doing + 第一行【身份】的留言,**一個動作**。\n"
|
||||
" 抓票規則在這裡再驗一次:不是 s/todo、已有人、掛 Human、不在主線也不逾期 ⇒ 擋下(離開碼 2)",
|
||||
"subtask":
|
||||
"用法:{bin} subtask <母票 owner/repo#N> --title \"<User Story>\" -F <內文檔>\n"
|
||||
" [--repo <收件 repo,預設跟母票同一個>] [--label <s/xxx,預設 s/todo>]\n"
|
||||
" [--journey <旅程名>] ← 這件事服務哪條使用者旅程(對不上就不要加)\n"
|
||||
" [--assign <誰做> --next \"<他第一件事要做什麼>\"] ← 這兩個是一組,"
|
||||
"指派了就一定要寫下一步\n"
|
||||
"\n(`ticket handoff` 是同一個動作的別名:頂層票 → 下游 repo)",
|
||||
}
|
||||
|
||||
|
||||
def usage_text(verb):
|
||||
"""用法的**唯一**一份,路徑現填成絕對路徑(inkstone/ISEP#112)。"""
|
||||
return USAGE[verb].format(bin=self_path())
|
||||
|
||||
|
||||
def cmd_usage(argv):
|
||||
"""把「用法」與「可以貼著跑的那一塊」交給同一個地方產生(inkstone/ISEP#112)。
|
||||
|
||||
閘的訊息**呼叫這一支**,不自己抄一份 ⇒ 訊息與能跑的指令之間沒有第二份可以漂。
|
||||
"""
|
||||
verbs = "|".join(sorted(USAGE))
|
||||
if not argv or argv[0] not in USAGE:
|
||||
die("用法:ticket usage <%s> [--example] [--parent <owner/repo#N>] "
|
||||
"[--draft <內文檔路徑>]\n"
|
||||
" --example = 印一塊可以整段貼著跑的指令(路徑是絕對路徑,母票已填好)" % verbs)
|
||||
verb = argv[0]
|
||||
|
||||
def opt(name, default=None):
|
||||
return argv[argv.index(name) + 1] if name in argv else default
|
||||
|
||||
if "--example" in argv:
|
||||
if verb != "subtask":
|
||||
die("🚫 `ticket usage %s --example` 還沒有可貼著跑的版本。\n"
|
||||
" 先看用法:ticket usage %s" % (verb, verb))
|
||||
sys.stdout.write(subtask_example(opt("--parent"), opt("--draft")))
|
||||
return
|
||||
sys.stdout.write(usage_text(verb).rstrip() + "\n")
|
||||
|
||||
|
||||
# ── subtask ──────────────────────────────────────────────────────────────
|
||||
def cmd_subtask(argv):
|
||||
"""把「討論串裡的一件事」長成看得見的子票,並掛成母票的 Gitea 原生相依。
|
||||
@@ -911,9 +737,11 @@ def cmd_subtask(argv):
|
||||
不是「新開一條線」——那道閘擋的是後者。
|
||||
"""
|
||||
if len(argv) < 1:
|
||||
# 🔴 用法只有 USAGE 那一份(inkstone/ISEP#112)。這裡不准再抄一段:
|
||||
# 抄一段就是又多一個會漂的副本,而閘印的那一行也是從 USAGE 來的。
|
||||
die(usage_text("subtask"))
|
||||
die("用法:ticket subtask <母票 owner/repo#N> --title \"<User Story>\" -F <內文檔>\n"
|
||||
" [--repo <收件 repo,預設跟母票同一個>] [--label <s/xxx,預設 s/todo>]\n"
|
||||
" [--journey <旅程名>] ← 這件事服務哪條使用者旅程(對不上就不要加)\n"
|
||||
" [--assign <誰做> --next \"<他第一件事要做什麼>\"] ← 指派了就一定要寫下一步\n"
|
||||
"\n(`ticket handoff` 是同一個動作的別名:頂層票 → 下游 repo)")
|
||||
powner, prepo, pnum = parse_ref(argv[0])
|
||||
|
||||
def opt(name, default=None):
|
||||
@@ -935,7 +763,7 @@ def cmd_subtask(argv):
|
||||
|
||||
# `--to <repo>` 是 `ticket handoff` 那個名字底下比較自然的講法,同一個東西。
|
||||
# (handback 的 `--to` 是「交給誰」,subtask 沒有那個參數,不會撞。)
|
||||
repo = repo_arg(opt("--repo", opt("--to", prepo)))
|
||||
repo = opt("--repo", opt("--to", prepo))
|
||||
label = opt("--label", "s/todo")
|
||||
assign = opt("--assign")
|
||||
nxt = opt("--next")
|
||||
@@ -1002,7 +830,7 @@ def cmd_subtask(argv):
|
||||
print(f" 旅程:`{jlabel}`(母子兩端都貼——只貼一端就聚不起來)")
|
||||
else:
|
||||
print(" 旅程:沒有貼(沒給 --journey)。對得上就補一次:"
|
||||
f"`{self_path()} subtask … --journey <旅程名>`;對不上就不要硬湊。")
|
||||
f"`ticket subtask … --journey <旅程名>`;對不上就不要硬湊。")
|
||||
print(f"\n📌 母票 {powner}/{prepo}#{pnum} 目前有 {len(openn)} 張未關的相依:")
|
||||
for i in deps:
|
||||
mark = "◻" if i["state"] == "open" else "☑"
|
||||
@@ -1198,10 +1026,8 @@ def cmd_loose(argv):
|
||||
for d in deps:
|
||||
print(f" ☑ {d['repository']['full_name']}#{d['number']}"
|
||||
f" {d['title'][:52]}")
|
||||
# 絕對路徑(inkstone/ISEP#112):相對的 `scripts/ticket` 會被貼到別的 cwd 底下,
|
||||
# 在那裡叫到的可能是本檔的舊複本(`InkStoneCo/scripts/ticket` 就是)。
|
||||
print(f" → 驗過就關:{self_path()} close {full}#{n} --deliverable <URL>")
|
||||
print(f" 還缺東西:{self_path()} subtask {full}#{n} --title \"<US>\" -F <檔>")
|
||||
print(f" → 驗過就關:ticket close {full}#{n} --deliverable <URL>")
|
||||
print(f" 還缺東西:ticket subtask {full}#{n} --title \"<US>\" -F <檔>")
|
||||
print()
|
||||
|
||||
print("📌 這張表撈的是**機械事實**(相依邊的 state),不是猜文字。")
|
||||
@@ -1210,327 +1036,9 @@ def cmd_loose(argv):
|
||||
return loose
|
||||
|
||||
|
||||
# ══════════════════════════════════════════════════════════════════════════
|
||||
# inkstone/ISEP#131 — 雲端工人抓票:規則是機械可判的,不靠 prompt 叮嚀
|
||||
#
|
||||
# 票上的原話:Routine 08-06 起讀 `journeys.md` 本 sprint 段,08-19 到期沒續,
|
||||
# **連續兩週讀到殘骸只能空轉**。09-07 把 `cloud-worker.md` 步驟 1 改成從 Gitea 主線
|
||||
# 里程碑抓票(inkstone/InkStoneCo#118)——但那是一段給人讀的字,讀漏一句就抓錯。
|
||||
# 這一段把它做成一個指令,規則寫在 `pickable()` 一支純函式裡,離線測得動。
|
||||
#
|
||||
# 規則(全部是 Gitea 欄位,沒有一格在猜文字):
|
||||
# 可抓 s/* 狀態恰好是 {s/todo} + 沒有 assignee + 沒有 Human/human/* + 不是 hub + 有里程碑
|
||||
# 且里程碑 = 主線;主線抓盡才抓「逾期的 open 里程碑」;backlog/沒里程碑一律不抓
|
||||
# 認領 指派 + s/doing +【身份】留言,一個動作(`claim`)
|
||||
# 完成 分支 + 證據 + s/review + `handback`——那半本來就有,不重做
|
||||
#
|
||||
# 🔴 為什麼是「s/* 恰好等於 {s/todo}」而不是「有 s/todo」:2026-09-07 實查
|
||||
# `inkstone/mira#6` 同時掛著 s/doing 與 s/todo(exclusive 只擋 UI,不擋 API)。
|
||||
# 只看「有 s/todo」會把一張別人正在做的票抓走。要求的是**狀態在場且唯一**,
|
||||
# 仍然是「要求某個東西在場」那個形狀,不是黑名單。
|
||||
#
|
||||
# 🔴 Human 那一格用的是**標籤**(唯一識別碼),不是票上有沒有 👤 這個字——
|
||||
# cloud-worker.md 寫過「票上沒有 👤」,那是文字判準,leo 2026-08-17 已證偽那條路。
|
||||
# `human/exec`(執行者是人)與 `Human` 同組(labels.yaml「人的介入」),一起算。
|
||||
# ══════════════════════════════════════════════════════════════════════════
|
||||
|
||||
_ML = None
|
||||
|
||||
|
||||
def _mainline_lib():
|
||||
"""`hooks/lib/mainline.py`——「主線」這件事的唯一存放處。norm() 也只有那一份。"""
|
||||
global _ML
|
||||
if _ML is None:
|
||||
import importlib.machinery
|
||||
import importlib.util
|
||||
path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "hooks", "lib", "mainline.py")
|
||||
loader = importlib.machinery.SourceFileLoader("isep_mainline_lib", path)
|
||||
spec = importlib.util.spec_from_file_location("isep_mainline_lib", path, loader=loader)
|
||||
mod = importlib.util.module_from_spec(spec)
|
||||
loader.exec_module(mod)
|
||||
_ML = mod
|
||||
return _ML
|
||||
|
||||
|
||||
def _now():
|
||||
"""現在。測試用 ISEP_COUNTDOWN_NOW(epoch 秒)把時鐘定住——跟 countdown 同一個開關。"""
|
||||
from datetime import datetime, timezone
|
||||
override = os.environ.get("ISEP_COUNTDOWN_NOW", "").strip()
|
||||
if override:
|
||||
try:
|
||||
return datetime.fromtimestamp(float(override), tz=timezone.utc)
|
||||
except Exception:
|
||||
pass
|
||||
return datetime.now(timezone.utc)
|
||||
|
||||
|
||||
def _label_names(issue):
|
||||
out = []
|
||||
for l in issue.get("labels") or []:
|
||||
out.append(l["name"] if isinstance(l, dict) else str(l))
|
||||
return out
|
||||
|
||||
|
||||
def human_gated(labels):
|
||||
"""掛著「人的介入」那一組標籤(labels.yaml:`Human`/`human/*`)。"""
|
||||
return any(n == "Human" or n.startswith("human/") for n in labels)
|
||||
|
||||
|
||||
def pickable(issue, milestone_title):
|
||||
"""這張票現在能不能被雲端工人抓走。回 (ok, 理由)。**純函式,不打網路。**
|
||||
|
||||
`milestone_title`=要求它掛在哪個里程碑底下(主線,或輪到的那個逾期里程碑)。
|
||||
理由是給人看的:`pick --all` 與 `claim` 擋下時都印它,一張票為什麼不能抓要說得出來。
|
||||
"""
|
||||
if issue.get("pull_request"):
|
||||
return False, "這是 PR,不是票"
|
||||
labels = _label_names(issue)
|
||||
st = sorted(n for n in labels if n.startswith("s/"))
|
||||
if st != ["s/todo"]:
|
||||
return False, "狀態不是單一的 s/todo(現在是 %s)" % (st or "沒有 s/*")
|
||||
if issue.get("assignees") or issue.get("assignee"):
|
||||
who = [a.get("login") for a in (issue.get("assignees") or []) if isinstance(a, dict)] \
|
||||
or [(issue.get("assignee") or {}).get("login")]
|
||||
return False, "已經指派給 %s" % "、".join(str(w) for w in who if w)
|
||||
if human_gated(labels):
|
||||
return False, "掛著 %s——要 leo 親手做的" % "、".join(n for n in labels if n == "Human" or n.startswith("human/"))
|
||||
if "hub" in labels:
|
||||
# labels.yaml:hub =「聚合一批 leaf 的 scope 容器,本身不掛 milestone、不對應 PR」
|
||||
# 2026-09-07 實查:ISEP#31–35 五張 hub 掛在逾期里程碑上、s/todo、沒人——
|
||||
# 照欄位規則會被抓走,但它們不是一件可以做完的事。容器不是任務。
|
||||
return False, "是 hub(scope 容器,不是一件可以做完的事)"
|
||||
ms = (issue.get("milestone") or {}).get("title")
|
||||
if not ms:
|
||||
return False, "沒有里程碑(backlog/沒排進 sprint 的不抓)"
|
||||
norm = _mainline_lib().norm
|
||||
if norm(ms) != norm(milestone_title):
|
||||
return False, "里程碑是「%s」,不是「%s」" % (ms, milestone_title)
|
||||
return True, "ok"
|
||||
|
||||
|
||||
def pick_order(issue):
|
||||
"""同一個里程碑裡先抓誰:p/high → 沒標 → p/low;再看開票時間(舊的先);最後票號。
|
||||
結果要**可重現**——同一個池子問兩次要拿到同一張。"""
|
||||
labels = _label_names(issue)
|
||||
prio = 0 if "p/high" in labels else (2 if "p/low" in labels else 1)
|
||||
return (prio, issue.get("created_at") or "", issue.get("number") or 0)
|
||||
|
||||
|
||||
def _ref_of(issue, owner=None, repo=None):
|
||||
full = ((issue.get("repository") or {}).get("full_name")) or ("%s/%s" % (owner, repo))
|
||||
return "%s#%s" % (full, issue.get("number"))
|
||||
|
||||
|
||||
def load_mainline(argv):
|
||||
"""主線從哪來(依序):--mainline <檔> → $ISEP_MAINLINE_FILE → 本機狀態檔
|
||||
(`scripts/mainline set` 寫的那個)→ $CLAUDE_PROJECT_DIR/system-dev/mainline.json(進 repo 的那份,
|
||||
雲端 clone 就讀得到,inkstone/InkStoneCo#118)。回 (dict, 來源說明)。"""
|
||||
def opt(name):
|
||||
return argv[argv.index(name) + 1] if name in argv and argv.index(name) + 1 < len(argv) else None
|
||||
ML = _mainline_lib()
|
||||
tried = []
|
||||
explicit = opt("--mainline") or os.environ.get("ISEP_MAINLINE_FILE", "").strip()
|
||||
if explicit:
|
||||
try:
|
||||
with open(explicit) as f:
|
||||
d = json.load(f)
|
||||
except Exception as e:
|
||||
die("🔴 讀不到主線檔 %s:%s\n 讀不到 ≠ 沒有主線——先把檔案路徑修對,不要因此去抓別的票。" % (explicit, e))
|
||||
if not isinstance(d, dict) or not d.get("title"):
|
||||
die("🔴 主線檔 %s 裡沒有 title 欄——那不是 `scripts/mainline set` 寫出來的檔。" % explicit)
|
||||
return d, explicit
|
||||
tried.append(ML.path())
|
||||
d = ML.load()
|
||||
if d:
|
||||
return d, ML.path()
|
||||
root = os.environ.get("CLAUDE_PROJECT_DIR") or os.getcwd()
|
||||
cand = os.path.join(root, "system-dev", "mainline.json")
|
||||
tried.append(cand)
|
||||
try:
|
||||
with open(cand) as f:
|
||||
d = json.load(f)
|
||||
if isinstance(d, dict) and d.get("title"):
|
||||
return d, cand
|
||||
except Exception:
|
||||
pass
|
||||
die("""🔴 現在沒有主線 ⇒ 沒有「可以抓的票」這回事。
|
||||
|
||||
找過:
|
||||
%s
|
||||
|
||||
這不是叫你去抓 backlog 或沒里程碑的票——那是總管排 sprint 的事,不是工人的。
|
||||
出路(擇一):
|
||||
• 雲端:clone inkstone/InkStoneCo,用它 repo 裡那份 → `%s pick --mainline <clone>/system-dev/mainline.json`
|
||||
• 本機:`scripts/mainline list` 看有哪些 → `scripts/mainline set <owner/repo#id>`""" % (
|
||||
"\n".join(" · " + t for t in tried), self_path()))
|
||||
|
||||
|
||||
def _repos(owner):
|
||||
return [r["name"] for r in (api("/orgs/%s/repos?limit=100" % owner) or [])
|
||||
if isinstance(r, dict) and r.get("name")]
|
||||
|
||||
|
||||
def _open_milestones(owner, repos):
|
||||
"""每個 repo 的 open milestone。回 [(repo, milestone dict)]。"""
|
||||
out = []
|
||||
for r in repos:
|
||||
for m in (api("/repos/%s/%s/milestones?state=open&limit=100" % (owner, r)) or []):
|
||||
if isinstance(m, dict) and m.get("title"):
|
||||
out.append((r, m))
|
||||
return out
|
||||
|
||||
|
||||
def _issues_in(owner, repo, title):
|
||||
q = urllib.parse.urlencode({"state": "open", "type": "issues", "milestones": title, "limit": 100})
|
||||
rows = api("/repos/%s/%s/issues?%s" % (owner, repo, q)) or []
|
||||
for it in rows:
|
||||
if isinstance(it, dict):
|
||||
it.setdefault("repository", {"full_name": "%s/%s" % (owner, repo)})
|
||||
return [it for it in rows if isinstance(it, dict)]
|
||||
|
||||
|
||||
def pick_candidates(ms, now=None):
|
||||
"""依序回 [(組名, 里程碑標題, [可抓的票…])]:第一組是主線,之後是逾期的 open 里程碑
|
||||
(最逾期的先)。**每一組裡都已經照 pick_order 排好。**"""
|
||||
ML = _mainline_lib()
|
||||
now = now or _now()
|
||||
owner = ms.get("owner") or ORG
|
||||
repos = _repos(owner)
|
||||
opened = _open_milestones(owner, repos)
|
||||
groups = []
|
||||
|
||||
def collect(title):
|
||||
found = []
|
||||
for r, m in opened:
|
||||
if ML.norm(m.get("title")) != ML.norm(title):
|
||||
continue
|
||||
for it in _issues_in(owner, r, m.get("title")):
|
||||
ok, _ = pickable(it, title)
|
||||
if ok:
|
||||
found.append(it)
|
||||
return sorted(found, key=pick_order)
|
||||
|
||||
groups.append(("主線", ms["title"], collect(ms["title"])))
|
||||
|
||||
overdue = {}
|
||||
for r, m in opened:
|
||||
if ML.norm(m.get("title")) == ML.norm(ms["title"]):
|
||||
continue
|
||||
due = ML.due_of(m)
|
||||
if due and due < now:
|
||||
key = ML.norm(m.get("title"))
|
||||
if key not in overdue or due < overdue[key][0]:
|
||||
overdue[key] = (due, m.get("title"))
|
||||
for due, title in sorted(overdue.values()):
|
||||
groups.append(("逾期里程碑", title, collect(title)))
|
||||
return groups
|
||||
|
||||
|
||||
def cmd_pick(argv):
|
||||
"""回一張現在可以抓的票。離開碼:0 有、1 真的沒有、2 讀不到/沒主線。"""
|
||||
if argv and argv[0] in ("-h", "--help"):
|
||||
die(usage_text("pick"), 0)
|
||||
ms, src = load_mainline(argv)
|
||||
as_json = "--json" in argv
|
||||
show_all = "--all" in argv
|
||||
try:
|
||||
groups = pick_candidates(ms)
|
||||
except (urllib.error.URLError, OSError) as e:
|
||||
die("🔴 拿不到 Gitea(%s)。讀不到 ≠ 沒有可抓的票——先修連線,不要空轉也不要抓別的。" % e)
|
||||
|
||||
flat = [(g, t, it) for g, t, its in groups for it in its]
|
||||
if as_json:
|
||||
rows = [{"ref": _ref_of(it), "title": it.get("title"), "group": g, "milestone": t,
|
||||
"labels": _label_names(it), "created_at": it.get("created_at")}
|
||||
for g, t, it in flat]
|
||||
print(json.dumps(rows if show_all else (rows[0] if rows else None), ensure_ascii=False, indent=2))
|
||||
sys.exit(0 if rows else 1)
|
||||
|
||||
print("🎯 主線:「%s」(來源:%s)" % (ms["title"], src))
|
||||
for g, t, its in groups:
|
||||
if g == "主線" or its or show_all:
|
||||
print(" %s「%s」:可抓 %d 張" % (g, t, len(its)))
|
||||
print()
|
||||
if not flat:
|
||||
print("⚪ 沒有可以抓的票——主線與逾期里程碑都抓盡了。")
|
||||
print(" 出路:收工回報(這是正常結果,不是故障)。")
|
||||
print(" 🔴 不要去抓 backlog/沒里程碑/掛 Human/已有人的票——那些不在規則裡,抓了就是跳線。")
|
||||
sys.exit(1)
|
||||
|
||||
shown = flat if show_all else flat[:1]
|
||||
for g, t, it in shown:
|
||||
print(" ● %s %s" % (_ref_of(it), _label_names(it)))
|
||||
print(" %s" % (it.get("title") or "")[:80])
|
||||
print(" %s「%s」 開票 %s" % (g, t, (it.get("created_at") or "")[:10]))
|
||||
print()
|
||||
if "--claim" in argv:
|
||||
top = flat[0][2]
|
||||
cmd_claim([_ref_of(top)] + [a for a in argv if a != "--claim"])
|
||||
return
|
||||
print("📌 認領(指派+s/doing+【身份】留言,一個動作):")
|
||||
print(" %s claim %s --name <你的名字>" % (self_path(), _ref_of(flat[0][2])))
|
||||
print(" 做完:分支+證據 → `%s handback %s --to %s --label s/review --next \"…\" --evidence <URL>`"
|
||||
% (self_path(), _ref_of(flat[0][2]), HANDBACK_TO))
|
||||
|
||||
|
||||
def cmd_claim(argv):
|
||||
"""認領=指派 + s/doing +【身份】留言,**一個動作**。抓票規則在這裡再驗一次。"""
|
||||
if not argv or argv[0] in ("-h", "--help"):
|
||||
die(usage_text("claim"), 0 if argv else 2)
|
||||
owner, repo, num = parse_ref(argv[0])
|
||||
|
||||
def opt(name, default=None):
|
||||
return argv[argv.index(name) + 1] if name in argv and argv.index(name) + 1 < len(argv) else default
|
||||
|
||||
name = opt("--name") or "subagent"
|
||||
ident = "【身份】%s/%s/%s/%s" % (name, owner, repo, opt("--branch") or "-")
|
||||
# 身份先驗,**在打任何 API 之前**——名單以外的名字連 Gitea 都不會碰到
|
||||
check_identity(ident, "認領留言")
|
||||
|
||||
ms, _ = load_mainline(argv)
|
||||
ML = _mainline_lib()
|
||||
who = opt("--as") or (api("/user") or {}).get("login")
|
||||
if not who:
|
||||
die("🔴 拿不到本 token 的使用者名稱,也沒給 --as。")
|
||||
|
||||
issue = api("/repos/%s/%s/issues/%d" % (owner, repo, num))
|
||||
issue.setdefault("repository", {"full_name": "%s/%s" % (owner, repo)})
|
||||
ims = issue.get("milestone") or {}
|
||||
ok, why = pickable(issue, ims.get("title") or "")
|
||||
if ok:
|
||||
on_mainline = ML.norm(ims.get("title")) == ML.norm(ms["title"])
|
||||
due = ML.due_of(ims)
|
||||
if not on_mainline and not (due and due < _now()):
|
||||
ok, why = False, "里程碑「%s」既不是主線「%s」也還沒逾期" % (ims.get("title"), ms["title"])
|
||||
if not ok:
|
||||
die("""🚫 %s/%s#%d 現在不能抓:%s
|
||||
|
||||
抓票規則(inkstone/ISEP#131,全部是 Gitea 欄位):
|
||||
s/* 恰好是 s/todo + 沒有 assignee + 沒有 Human/human/* + 里程碑是主線(主線抓盡才抓逾期)
|
||||
出路:`%s pick` 會回一張符合規則的票;這張如果真的該你做,回票上問總管改欄位,不要硬抓。""" % (
|
||||
owner, repo, num, why, self_path()))
|
||||
|
||||
api("/repos/%s/%s/issues/%d" % (owner, repo, num), {"assignees": [who]}, method="PATCH")
|
||||
keep = [n for n in _label_names(issue) if not n.startswith("s/")] + ["s/doing"]
|
||||
_set_labels(owner, repo, num, keep)
|
||||
lines = [ident, "",
|
||||
"🙋 **認領** → `%s`" % who, "",
|
||||
"- 里程碑:「%s」%s" % (ims.get("title"), "(主線)" if ML.norm(ims.get("title")) == ML.norm(ms["title"]) else "(逾期里程碑,主線已抓盡)"),
|
||||
"- 狀態:s/todo → s/doing",
|
||||
"- 做完:分支+證據 → `s/review` + `ticket handback`(不推 main、不出貨、不改里程碑)"]
|
||||
api("/repos/%s/%s/issues/%d/comments" % (owner, repo, num), {"body": "\n".join(lines)})
|
||||
print("✅ 認領 %s/%s#%d → `%s`" % (owner, repo, num, who))
|
||||
print(" 指派:%s tag:%s" % (who, [n for n in keep if n.startswith("s/")]))
|
||||
print(" 留言第一行:%s" % ident)
|
||||
print("\n📌 做完:%s handback %s/%s#%d --to %s --label s/review --next \"…\" --evidence <URL>"
|
||||
% (self_path(), owner, repo, num, HANDBACK_TO))
|
||||
|
||||
|
||||
|
||||
CMDS = {"where": cmd_where, "say": cmd_say, "new": cmd_new, "close": cmd_close,
|
||||
"decide": cmd_decide, "subtask": cmd_subtask, "handoff": cmd_subtask,
|
||||
"handback": cmd_handback, "mine": cmd_mine, "loose": cmd_loose,
|
||||
"usage": cmd_usage, "pick": cmd_pick, "claim": cmd_claim}
|
||||
"handback": cmd_handback, "mine": cmd_mine, "loose": cmd_loose}
|
||||
|
||||
if __name__ == "__main__":
|
||||
if len(sys.argv) < 2 or sys.argv[1] not in CMDS:
|
||||
|
||||
+12
-68
@@ -1,21 +1,18 @@
|
||||
---
|
||||
name: ship-check
|
||||
description: |
|
||||
**任何東西要從「內」(Gitea)送到「外」之前必讀**——不只是 arcrun。
|
||||
對外包含:發一篇部落格文章到 uncle6.me、推 tag 到 GitHub 鏡像 repo、投稿 n8n 官方模板庫、
|
||||
出雲端零件包、出桌面 daemon。也在下列時機自動載入:改完會影響用戶的東西之後、
|
||||
要打包 App/出貨/推 bundle/送 MS Store、要發文、要 pages deploy、要推 GitHub、
|
||||
leo 問「可以測了嗎」「版本為什麼沒變」「更新了嗎」「封測者拿得到嗎」「發出去了嗎」。
|
||||
🔴 第一個動作是**分辨這是哪個出口**,因為 stage/版本/arm 每個出口都不同——
|
||||
流程本體住在 system-dev/docs/3-specs/critical-paths/ship.md(唯一一份),本 skill 是它的入口。
|
||||
核心判準:**收的人拿到的東西真的變了,而且他看得出變了什麼**;
|
||||
對 arcrun 兩條線而言那個介面就是版本號(portal 看雲端、daemon 看桌面)。
|
||||
收齊:五個出口的判準/兩條版本線的差別/重打 bundle(最常漏)/改 workflow 要重編預編圖/
|
||||
三支機械閘+把 DMG/zip 真的打開檢查/寫 changelog/D20 開閘出貨/purge jsDelivr/
|
||||
從收的人會看的那個地方抓實際畫面複驗。附「常見漏掉的」實撞表與收工前五問。
|
||||
改完任何會影響用戶的東西之後、說「做完了」之前必讀(改雲端 worker/portal/daemon/
|
||||
workflow/installer 都算)。也在下列時機自動載入:要打包 App、要出貨、要推 bundle、
|
||||
要送 MS Store、leo 問「可以測了嗎」「版本為什麼沒變」「更新了嗎」「封測者拿得到嗎」。
|
||||
核心判準:**版本號是 leo 唯一的驗收介面**——portal 版本卡看雲端、daemon 檢查更新看桌面;
|
||||
版本沒動=他無從判斷你做了什麼=等於沒交付,而「我在某台實例 wrangler deploy 過了」不算。
|
||||
收齊:兩條版本線的差別/重打 bundle(最常漏,要 grep 複驗改動真的進去)/
|
||||
改 workflow 要重編預編圖/三支機械閘+把 DMG/zip 真的打開檢查/寫 changelog(用戶語言)/
|
||||
D20 開閘出貨/purge jsDelivr/從 leo 會看的那兩處抓實際畫面複驗。
|
||||
附「常見漏掉的」實撞表與收工前五問。
|
||||
---
|
||||
|
||||
# /ship-check — 東西要出去之前,先確定收的人真的會拿到
|
||||
# /ship-check — 改完東西後,讓 leo 看得到版本變了
|
||||
|
||||
> **這支解什麼病**(leo 2026-08-05 原話):
|
||||
> 「對人來說,**我雲端看 portal 有沒有更新,本地看 daemon 有沒有更新**,
|
||||
@@ -28,44 +25,6 @@ description: |
|
||||
|
||||
---
|
||||
|
||||
## 🚦 第一步:這是哪個出口?(2026-09-02 補,`inkstone/InkStoneCo#112`)
|
||||
|
||||
> **為什麼補這段**(leo 2026-09-02):「Gitea 為『內』,只要對外都是『外』,
|
||||
> **任何東西出去之前都要經過出貨流程,不是只有 Arcrun, Arcrun RAG 這個計劃**」
|
||||
>
|
||||
> 🔴 **這支 skill 2026-09-01 失效過**:它自己與它指向的地方**只認得 daemon 那個形狀**,
|
||||
> 於是那晚要發部落格與 GitHub 模板時,它沒把人導向任何可用的流程——**只好即興補**。
|
||||
|
||||
- 🔴 **流程本體只有一份**:`system-dev/docs/3-specs/critical-paths/ship.md`
|
||||
- 它定義了**內/外的判準**、**六個步驟**、**五個出口各自的 stage/版本/arm/驗法**
|
||||
- **動手前先讀那一卷的對應出口段**,不要憑本 skill 的印象做
|
||||
- **判準一句:送出去之後,有沒有一個不是我們的人看得到/拿得到?** 有 ⇒ 走那六步
|
||||
- **五個出口,各自去 `ship.md` 的哪一段**:
|
||||
- ① 桌面 daemon(`v0.18.x`)——**本 skill 底下的內容主要是它與 ②**
|
||||
- ② 雲端零件包(`1.4.x`)——同上
|
||||
- ③ 部落格 uncle6.me — 🔴 **沒有 arm、沒有版本號**,stage 是 `<8碼>.kbcontent.pages.dev` 快照;
|
||||
`pages deploy` **必須在 repo 外的目錄跑**,否則 `.env` 的 token 會蓋掉 OAuth 並報成權限錯誤
|
||||
|**驗法是瀏覽器,不是 `curl`**(收件人是讀者 ⇒ 見 §5.8 與 `ship.md` 出口③「驗法」)
|
||||
- ④ GitHub 鏡像 repo — 🔴 **要 arm,而且連 `git remote add` 都擋**(D20);
|
||||
Gitea 就是它的 stage;**推 tag 之外還要發 release note**
|
||||
(怎麼發、要不要再 arm ⇒ `ship.md` 出口④ 的「release note 怎麼發」段)
|
||||
- 🔴 **步驟 3 的「Use this template」也要 arm,而且要單獨請一次**——它建的是
|
||||
**第二個 repo**,撞 ROE「單一 repo」那條,夾不進推 tag 的窗口。
|
||||
且 guard 只掛在 `Bash` ⇒ **走瀏覽器按那顆按鈕不會被擋,這條靠人守**
|
||||
(⇒ `ship.md` 出口④ 的「Use this template 要不要 arm」段)
|
||||
- ⑤ n8n 官方投稿 — 沒有 stage,投稿端點尚未查到(`inkstone/llm-wiki-template#9`)
|
||||
- 🔴 **不要拿 ① 的答案去套 ③④⑤**——那正是 2026-09-01 出錯的機制
|
||||
- 🔴 **「這個出口沒有 arm」不等於「這個出口不必經過 leo」**——③⑤ 的人閘是**步驟 5**
|
||||
(leo 親手在 stage 上走過那一遍)。判準全文=`ship.md` 的
|
||||
「誰批准、誰按鍵、在哪台跑」段:**leo 批准,機器執行**
|
||||
- **跨多個 repo 的一批貨,「100%」看母票的相依清單,不要看 milestone 的百分比**
|
||||
(milestone 只數 hub 那個 repo,別的 repo 那幾張不在分母裡)
|
||||
⇒ `ship.md` 的「那個數字看哪裡」段
|
||||
- 🔴 **發現 `ship.md` 沒涵蓋你手上這件事 ⇒ 那一卷缺了一格,回去補它**,
|
||||
不要在別處另開一份流程(leo 2026-09-02 明確選了「改寫 ship.md」)
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 這支 skill 自己的失效模式(先讀這段)
|
||||
|
||||
leo 2026-08-05:「**你寫完一個 skill 然後每個我要提醒你,表示這個 skill 無效**」
|
||||
@@ -85,19 +44,8 @@ leo 2026-08-05:「**你寫完一個 skill 然後每個我要提醒你,表示
|
||||
|
||||
## 什麼時候跑
|
||||
|
||||
**任何東西要送到「外面」之前**——改完會影響用戶的東西、要發一篇文章、要推 tag 到 GitHub、
|
||||
要投稿、要出零件包或 daemon。在說「做完了」之前跑,不是收工才跑。
|
||||
|
||||
⚠️ **底下的步驟是出口①②(arcrun 兩條版本線)的細節。**
|
||||
出口③④⑤ 請照上面那段回 `ship.md` 讀該出口的判準——**它們沒有版本號卡可以看**。
|
||||
|
||||
🔴 **但底下 §5.8「驗前端=用瀏覽器真的載一次」是全出口通則,不歸①② 所有**
|
||||
(2026-09-02 補:本 skill 這句劃界曾把 §5.8 圈進①②,
|
||||
而 `ship.md` 對出口③ 給的驗法是 `curl` ⇒ **兩個檔對同一個問題給了兩種答案**)。
|
||||
- **一句話判準:用收的人的那個介面驗。**
|
||||
- 收的人的介面是**網頁** ⇒ 瀏覽器(出口③ 讀者、出口① 的 portal 版本卡)
|
||||
- 收的人的介面是 **API/CLI** ⇒ `curl` 才是對的(出口② 的 `/health`,程式在讀它)
|
||||
- ⇒ 這不是「①② 用 curl、③ 用瀏覽器」,是**每個出口各自問自己的收件人在看什麼**
|
||||
**改完任何會影響用戶的東西之後**(雲端 worker/portal/daemon/workflow),
|
||||
在說「做完了」之前。不是收工才跑。
|
||||
|
||||
---
|
||||
|
||||
@@ -555,10 +503,6 @@ curl -s "https://rag.arcrun.dev/docs/start/install-windows/?cb=$RANDOM" \
|
||||
|
||||
> leo 原話:「**你的環境有 web,你應該用 web 驗,你已經開啓了卻沒有完成,你要把這個列入規定。**」
|
||||
|
||||
🔴 **適用範圍:全出口,不是只有①②**(2026-09-02 補,見上面「什麼時候跑」那段的劃界)。
|
||||
**收的人的介面是網頁就套這條**——出口③ 部落格的收件人是讀者,他的介面就是瀏覽器。
|
||||
`ship.md` 出口③「驗法」那格寫的是同一件事,兩邊只有一種說法。
|
||||
|
||||
**為什麼 `curl | grep` 是假驗證**(08-08 實撞,leo 抓到而不是我發現):
|
||||
`curl` 拿到的是 **HTML 原始碼**——它**不執行 JS、不載入 `config.js`、不發 API 請求**。
|
||||
所以我 grep 到文案就宣稱「前端驗過」,而使用者實際打開看到的是整條紅色錯誤:
|
||||
|
||||
+33
-166
@@ -119,179 +119,46 @@ leo 當場:「**這些為什麼不寫到票裡?**」
|
||||
|
||||
日期: 2026-08-27(`inkstone/ISEP#30` comment 4327)
|
||||
|
||||
## ⚠️ MISTAKE: fail-closed 的閘,會把「執行裁決」這個動作本身變成不可執行
|
||||
## ⚠️ MISTAKE: 兩道閘互相打架——照 A 做的人被 B 擋,繞過去的人反而過得了
|
||||
|
||||
票: `inkstone/ISEP#91`(裁決原文在 `inkstone/InkStoneCo#40` → comment 2942)
|
||||
日期: 2026-08-31
|
||||
|
||||
症狀: leo 2026-08-16 裁定「**取消 Active SDD**」——任務狀態搬到 Gitea 管,
|
||||
SDD 只記「起初的樣子」,文件不帶任務 checkbox。
|
||||
**11 天過去,這個裁決一個字都沒被執行。**
|
||||
|
||||
實查: `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)。**它一直在誤攔,只是沒人回報。**
|
||||
|
||||
原因: **不是有人偷懶,是沒有人把裁決和那支閘連起來看。**
|
||||
裁決被讀到了、也沒人反對,但執行它的第一步會當場鎖死自己,
|
||||
於是每個人都在那一步前面停下來,而**「我停下來了」不會留下任何痕跡**。
|
||||
|
||||
正確做法:
|
||||
- 收到「取消某個制度」的裁決,第一個動作是**去數還有幾支閘在執行那個制度**,
|
||||
並且**先問那些閘是 fail-open 還是 fail-closed**。
|
||||
fail-closed 的那幾支決定了執行順序:**先讓閘退役,再拿掉它要的東西**,顛倒就鎖死。
|
||||
- 退役要驗的不是「檔案刪了沒有」,是「**那個擋還會不會發生**」。
|
||||
`hooks/tests/sdd-guard-retired.test.sh` 把「裁決執行完之後的世界」丟給
|
||||
`hooks.json` 上整組寫檔閘(清單當場從 `hooks.json` 讀,不寫死),
|
||||
**不准有任何一支用 SDD 當理由擋下來** ⇒ 換個檔名種回來照樣紅。
|
||||
|
||||
📌 一個沒人敢執行的裁決,看起來跟一個沒人記得的裁決一模一樣。
|
||||
差別只有在**去問「執行它的第一步會發生什麼」**的時候才看得出來。
|
||||
|
||||
📌 KBDB 缺這一段: 2026-08-31 用 `kbdb_search(mode='semantic')` 查
|
||||
「SDD 生命週期/單一活性/取消 Active SDD」**0 命中**(最接近的是 2026-08-09
|
||||
一張講 SDD × Gitea 整合摩擦的卡,那是裁決之前)。⇒ 這條開發史還沒進 KBDB。
|
||||
|
||||
## ⚠️ MISTAKE: 閘擋對了,但它印出來的那條出路**跑不動**
|
||||
|
||||
票: `inkstone/ISEP#112`
|
||||
日期: 2026-08-31
|
||||
|
||||
症狀: `comment-carries-task-guard.sh` 擋下留言時教你跑
|
||||
`scripts/ticket subtask …`。照著貼,會印出一段「四個動詞」的說明然後
|
||||
什麼都沒發生。被擋的人當下正在做別的事,最可能的反應是**找個理由繞過去**。
|
||||
|
||||
實查: 兩個**各自獨立**的原因,任何一個單獨存在都足以害死它——
|
||||
① **相對路徑**。閘印的是 `scripts/ticket`,而相對路徑是對
|
||||
**貼上去那個人的 cwd** 解析的。總管的 cwd 是 `InkStoneCo/`,
|
||||
那裡的 `scripts/ticket` 是正本停在 2026-08-27 之前的舊複本:
|
||||
`grep -c subtask InkStoneCo/scripts/ticket` → **0**(正本是 10)。
|
||||
⇒ 「`subtask` 這個子命令不存在」這個結論**在那個 cwd 底下是真的**。
|
||||
② **用法各寫一份**。閘手抄了一段用法,`cmd_subtask` 的 `die()` 又寫了一段。
|
||||
兩份已經漂了:閘那份寫 `--assign <誰做>` 卻**沒有 `--next`**,
|
||||
而正本會因為「指派了人卻沒寫 --next」直接擋下(實測 exit 2)。
|
||||
⇒ **就算路徑對了,那一行照樣跑不完。**
|
||||
|
||||
原因: 閘的訊息與它教的那支工具是**兩份各自維護的字**。
|
||||
`hooks/lib/beacon_report.py` ② 早就會在 SessionStart 報「專案裡有舊複本」,
|
||||
**但報告不會改掉閘印出來的那一行**——知道有這個坑,跟那一行會不會踩到它,
|
||||
是兩件事。
|
||||
|
||||
正確做法:
|
||||
- **路徑**:印出來要人複製的指令,一律用正本自己的 `__file__` 絕對路徑
|
||||
(`scripts/ticket` 的 `self_path()`)。印指令的人與跑指令的人是同一個檔案,
|
||||
沒有第二種可能。
|
||||
⚠️ 分界線是「**這行字會被誰複製、在哪台機器上跑?**」——
|
||||
要**貼進 Gitea 留言**的指令反而要維持相對寫法(留言會被別台機器讀到)。
|
||||
- **用法**:只留一份(`scripts/ticket` 的 `USAGE`/`usage_text()`),
|
||||
閘去 `ticket usage subtask --example` 現要,不自己抄。
|
||||
- **模板**:子票內文草稿由 `REQUIRED_SECTIONS` 現生(`body_template()`),
|
||||
跟檢查同源 ⇒ 不可能生出「照著貼卻過不了自己那道閘」的票。
|
||||
|
||||
🔴 **驗法要驗到「它跑不跑得動」,不是「它有沒有擋」。**
|
||||
`scripts/test-comment-carries-task-guard.sh` ⑱ 把閘 stderr 裡那塊指令
|
||||
**原樣抽出來、只填三格、真的執行一次**:離開碼 1(走到網路才停)=過,
|
||||
2(被某道閘擋下)=這個病復發。⑲ 是它的鑑別力對照組。
|
||||
|
||||
📌 推廣:**一支閘的價值是「擋下來 + 給一條走得通的路」。**
|
||||
出路走不通時它不是幫你,是擋你——而被擋的人不會停下來修閘,
|
||||
他會去找繞過去的方法。所以「出路能不能跑」要跟「判準準不準」一樣被測。
|
||||
## ⚠️ MISTAKE: 「雲端該有哪些憑證」的清單是唯一真相源,卻沒有任何東西在跟機器對帳
|
||||
|
||||
票: `inkstone/ISEP#115`(→ comment `5522`/`5526`)
|
||||
票: `inkstone/ISEP#117`(實撞在 `inkstone/Arcrun#195`)
|
||||
日期: 2026-09-01
|
||||
|
||||
症狀: 雲端 session 要清空 youlin,`env | grep -ciE 'cloudflare|^CF_|wrangler'` → **0**。
|
||||
而 `credentials-map.md` 明明寫著那把 token 在 `InkStoneCo/.env`。
|
||||
症狀: `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 樹之外躲開那一支。
|
||||
|
||||
實查: 不是雲端漏設。`scripts/make-cloud-env.sh` 的 `NEEDED` 當時**只有 1 個變數**,
|
||||
裡面從來沒有任何 CF 憑證。而 `inkstone/InkStoneCo#14` comment `3890`
|
||||
(2026-08-20)盤點出的 A 段是 **8 個**——那一版三段輸出的腳本,
|
||||
到今天為止只活在**沒併進 `main` 的分支 `fix/cloud-env-parity-14`(PR #43)**上。
|
||||
原因: 兩支閘各自都對,**但一支的「出路」不在另一支的「放行條件」裡**。
|
||||
白名單本來就想放行這件事(`CHILD_SESSION=1` + repo 在名單上),
|
||||
只是判準用的是「路徑長什麼樣」,而 A 那支剛好會改變路徑長什麼樣。
|
||||
|
||||
原因: 盤點做在票上、實作做在分支上、`main` 上的清單是另一回事——**三份,互不對帳**。
|
||||
🔴 而清單漏一項的代價**在流程末端才付**:工人已經把腳本與測試都寫完了,
|
||||
到要真的跑的那一刻才知道跑不了。
|
||||
正確做法: 放行的判準改成「這條路徑**屬於哪個 repo**」——
|
||||
`git worktree list --porcelain` 第一筆永遠是主工作目錄,
|
||||
主目錄與它所有的 worktree 回同一個答案。`-wt-` 這個命名慣例
|
||||
一個字都沒有進判準(不靠名字=改名字也騙不過去)。
|
||||
🔴 **推廣**:一支閘印出來的「出路」,就是別支閘必須放行的東西。
|
||||
新增或修改任何會給下一步的閘時,把那個下一步真的做一遍走到底——
|
||||
**出路走不通的閘,會逼人繞路,而繞路一旦成立,那條規矩就等於沒有。**
|
||||
|
||||
正確做法: 清單要有測試逼它跟這台機器對帳(`scripts/test-make-cloud-env.sh`,
|
||||
`docs/TESTING.md` A26)——B 段逐一去 `.env` 找值,找不到就紅。
|
||||
🔴 而「不准混進正式環境憑證」這一條,判準一律是**機器算得出來的事實**,
|
||||
**不是名字裡有沒有某個字**——兩條分工:
|
||||
B8 看**值從哪個檔案拿到的**(出自 `polaris/mira/.env` = leo21c 現役正式環境就紅);
|
||||
B9 看**這個值是不是就是 `CLOUDFLARE_API_TOKEN_leo21c`**(那把住在頂層 `.env`,
|
||||
B8 抓不到,而改個名字黑名單就放它過去——實跑證過)。黑名單擋不住沒被列進去的新名字,
|
||||
「這個值出自那份 `.env`」是 grep 得出來的事實,換什麼名字都躲不掉。
|
||||
同時釘住反面(B8x):拿一個已知住在那份 `.env` 的變數餵它,證明偵測**真的會亮**——
|
||||
否則「全綠」有兩種可能(真的乾淨/偵測壞了),而分不開就等於沒驗。
|
||||
## ⚠️ MISTAKE: plugin 裡那支閘一直是啞的,而沒有任何東西會喊一聲
|
||||
|
||||
⇒ **推廣**:repo 裡任何「這台機器該有什麼」的清單,都要有一支東西定期拿它去問機器。
|
||||
清單自己不會知道它漏了什麼。
|
||||
票: `inkstone/ISEP#117`
|
||||
日期: 2026-09-01
|
||||
|
||||
## ⚠️ MISTAKE: 兩支閘對同一條指令說不同的話,而讀的那一半從來沒被測過
|
||||
症狀: 同一份 payload(寫 `matrix/arcrun/foo.ts`)餵給兩份 `guard-cross-project.sh`:
|
||||
plugin 那份 exit 0(放行)、`InkStoneCo/.claude/hooks/` 那份 exit 2(擋)。
|
||||
兩個檔案 `diff` **一個字都不差**。
|
||||
|
||||
票: `inkstone/ISEP#130`
|
||||
日期: 2026-09-07
|
||||
|
||||
症狀: 09-04 雲端 Routine 的 run log:讀 `notify_leo` 定義被 `leo21c-write-guard.sh` 擋下。
|
||||
閘的判準明寫「**讀可以,寫不行**」,卻連讀都擋 ⇒ 雲端什麼都拿不到。
|
||||
|
||||
實查: ① 舊判準 `-d[[:space:]]` 把 `| tr -d '\r'`、`cut -d=` 這種唯讀的 `-d` 當成 curl 的 body。
|
||||
`prod-write-guard.sh` 在 2026-08-12 修過**一模一樣**的洞(它的檔頭寫著「一堆唯讀工具也用 -d」),
|
||||
這支漏了——同一批補丁只改其中一份(`main-and-prod-push-guard.sh` 檔頭記過同款)。
|
||||
② `…/webhooks/named/<ns>/notify_leo/trigger` 在 `prod-write-guard.sh` 是白名單(ISEP#63),
|
||||
在這支卻因為尾巴是 `/trigger` 照擋 ⇒ 撞人閘時發 Telegram 叫 leo 會被擋(InkStoneCo#110 的病)。
|
||||
③ 這支閘從 08-20 建立到現在**沒有任何測試**,`hooks/tests/` 裡 30 支測試沒有它的——
|
||||
「讀會不會被誤攔」這格從來沒被驗過,只有「寫會不會被擋」被人肉試過。
|
||||
|
||||
原因: 同一個判準(「這條指令會不會真的寫到那台」)散在三支閘裡各寫一份,修一份不會帶動另外兩份;
|
||||
而沒有測試的那支,誤攔發生時**不會有任何東西喊一聲**——被擋的人在雲端、沒有人在旁邊。
|
||||
|
||||
正確做法:
|
||||
- 修判準時 `grep -l` 找同一族的閘(`prod-write-guard`/`main-and-prod-push-guard`/`leo21c-write-guard`),
|
||||
一次改齊;本次三支都補了 youlin 09-02 起的新子網域 `arcrun-yuga3bse`。
|
||||
- 每一支「擋」的閘都要有「不該擋」那半的測試,測資用**現場真的會下的指令**
|
||||
(這次是 `cloud-worker.md`/`progress-guard.md` 裡的原句),不是自己挑好抓的例子。
|
||||
- 修之前拿新測試跑舊閘,紅的那幾條才是真的改到的(本次 5 條紅);全綠就是測試順著新閘寫的。
|
||||
|
||||
## ⚠️ MISTAKE: 雲端連不到 youlin 被記成「HTTP 000」,而 000 有三種病,兩種都不是連線
|
||||
|
||||
票: `inkstone/ISEP#130`
|
||||
日期: 2026-09-07
|
||||
|
||||
症狀: 09-04 run log「youlin 從雲端 HTTP 000」;09-07 總管查到舊子網域 `youlin-hsieh-dev` DNS 已死,
|
||||
以為換名字就通。從雲端打新名 `arcrun-yuga3bse` **還是 000**。
|
||||
|
||||
實查: `curl` 印的是 `CONNECT tunnel failed, response 403`,`$HTTPS_PROXY/__agentproxy/status` 記為
|
||||
`connect_rejected … gateway answered 403 (policy denial)`。同一個 session:leo21c 200、
|
||||
git.uncle6.me 200、api.telegram.org 302——**只有 youlin 的主機沒被雲端 egress policy 放行**。
|
||||
`/root/.ccr/README.md` 明寫:403/407 是組織的 egress policy,不要重試、不要繞路,回報主機名。
|
||||
|
||||
原因: `-w '%{http_code}'` 對「DNS 沒有」「proxy 拒絕 CONNECT」「對方沒回」三種都印 000,
|
||||
而三種的修法各在不同人手上(改名字/leo 放行主機/看實例)。把它們記成同一個數字,
|
||||
下一個人就會往錯的方向查(09-07 就差點只修名字收工)。
|
||||
|
||||
正確做法: 雲端看到 000 先跑 `curl -sS "$HTTPS_PROXY/__agentproxy/status" | jq .recentRelayFailures`,
|
||||
`connect_rejected` + 403 ⇒ 是 policy,交給 leo 在 Cloud environment 放行 `*.arcrun-yuga3bse.workers.dev`;
|
||||
不是 ⇒ 才去查名字或實例。記 log 時寫 curl 的錯誤字串(`response 403`/`Could not resolve host`),不要只寫 000。
|
||||
|
||||
## ⚠️ MISTAKE: 正門工具吃 `owner/repo` 會回 404,於是人走了側門
|
||||
|
||||
票: `inkstone/ISEP#130` → comment 6120 第 2 件
|
||||
日期: 2026-09-07
|
||||
|
||||
症狀: `scripts/ticket new inkstone/ISEP -F …` 回 Gitea 404;同一天 `ticket say` 對 InkStoneCo 正常。
|
||||
總管當場改成直接打 API 開了四張票。
|
||||
|
||||
實查: `cmd_new` 把第一個參數原樣塞進 `/repos/inkstone/{repo}/issues` ⇒ `/repos/inkstone/inkstone/ISEP/issues`。
|
||||
404 讀起來像「ISEP 這個 repo 不存在」,跟真正的原因隔了一層。`subtask --to` 同款。
|
||||
|
||||
原因: 票號的鐵律是全稱 `owner/repo#N`(CLAUDE.md),人自然會把收件 repo 也寫成 `owner/repo`;
|
||||
工具只收短名、錯了又不講清楚 ⇒ **正門壞了,人就走 `ticket-api-bypass-guard.sh` 在防的那條側門**。
|
||||
一道閘把人逼去走它自己禁止的路,那道閘就是在製造違規(`docs/governance/cloud-wiring.md` ② 記過同一句)。
|
||||
|
||||
正確做法: `repo_arg()` 兩種寫法都收;org 寫錯(`Leo/`)當場講「org 是 inkstone」,不讓它變成一個要人猜的 404。
|
||||
測試 `scripts/test-ticket-repo-arg.sh` 把 `api()` 換成假貨記路徑,離線驗路徑裡不准出現 `inkstone/inkstone`。
|
||||
原因: 它用 `<hook 檔>/../..` 當「頂層 repo 根」。那在 `InkStoneCo/.claude/hooks/`
|
||||
底下剛好等於 repo 根,搬進 plugin(`<plugin>/hooks/`)之後就指到 plugin cache
|
||||
的上一層 ⇒ 絕對路徑的前綴永遠剝不掉 ⇒ 判斷「在不在子 repo 裡」永遠是否
|
||||
⇒ **它每一次都放行,而放行是靜默的**。
|
||||
|
||||
正確做法: 指專案內的東西用 `$CLAUDE_PROJECT_DIR`(README 路徑規約本來就這樣寫)。
|
||||
🔴 **推廣**:閘的失效方向幾乎都是「靜默放行」——
|
||||
擋錯了有人會喊,放行不會有人喊。所以搬移/複製一支閘之後,
|
||||
**必須實測一次「它該擋的東西現在還擋不擋」**,
|
||||
不要用 `diff` 一致就當它行為一致(這次兩份就是一個字不差、行為相反)。
|
||||
同款:`mistakes.md` 上面那條「裝好了不等於它在跑」。
|
||||
|
||||
Reference in New Issue
Block a user