Compare commits
13 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 isep-hand
|
95c6fee199 | ||
|
isep-hand
|
49a7145e70 | ||
 claude-code
|
bcf7c05a7b | ||
|
claude-code
|
e9492e5d7c | ||
|
claude-code
|
5b0267112f | ||
 Leo
|
48befe8906 | ||
|
claude-code
|
1c0012107f | ||
|
claude-code
|
56ae38d8d4 | ||
|
claude-code
|
b4d47e94c9 | ||
|
claude-code
|
fef35ed03a | ||
|
Claude
|
1fa45cd539 | ||
|
claude-code
|
f2ebeb441e | ||
|
Claude
|
49dedbbb15 |
@@ -8,7 +8,7 @@
|
||||
"plugins": [
|
||||
{
|
||||
"name": "isep",
|
||||
"description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源：61 支機械閘（85 條註冊，白話盤點見 docs/hooks-inventory.md）、7 支 slash command、2 支 skill、7 位有名字的工人（agents/，見 docs/governance/worker-roster.md）、56 支腳本，外加治理規範與標籤真相源。本機與雲端裝同一份，沒有子集。",
|
||||
"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）、60 支腳本，外加治理規範與標籤真相源。本機與雲端裝同一份，沒有子集。",
|
||||
"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）、56 支腳本，外加治理規範與標籤真相源。本機與雲端裝同一份，沒有子集。",
|
||||
"version": "0.24.0",
|
||||
"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）、60 支腳本，外加治理規範與標籤真相源。本機與雲端裝同一份，沒有子集。",
|
||||
"version": "0.26.0",
|
||||
"keywords": [
|
||||
"inkstone",
|
||||
"guardrails",
|
||||
|
||||
@@ -27,7 +27,7 @@
|
||||
| `agents/` | 7 位 | **工人名單**（`inkstone/ISEP#86`）——派工時指名派給誰，規約見 `docs/governance/worker-roster.md` |
|
||||
| `commands/` | 7 支 | `/wiki-recall` `/wiki-capture` `/cp-write` `/issue-handle` … |
|
||||
| `skills/` | 2 支 | `ship-check`（東西要出去之前）／`deep-recall`（把散落的枝葉還原成一棵樹）。🔴 **這兩支的內容不一定是在這裡寫的**——誰是真相源查 `docs/file-ownership.tsv` |
|
||||
| `scripts/` | 56 支 | `ticket`／`roster`／`isep-nag`／`wiki-compress`／`github-arm.sh` …（頂層檔案，不含 `lib/` 等子目錄） |
|
||||
| `scripts/` | 60 支 | `ticket`／`roster`／`isep-nag`／`wiki-compress`／`github-arm.sh` …（頂層檔案，不含 `lib/` 等子目錄） |
|
||||
|
||||
> 🔴 這五個數字**每次都要在自己的樹上實數**，不准沿用上一版、也不准用加減推
|
||||
> （`system-dev/wiki/mistakes.md`：那是 leo 的驗收介面，多報就是假綠）：
|
||||
|
||||
+131
-4
@@ -330,12 +330,13 @@ bash hooks/tests/unpushed-police.test.sh
|
||||
- B 群（⑦—⑩，該報）任一紅 ⇒ 為了不吵而改成放行了，那是把閘關掉不是修好
|
||||
- 特別看 ④：問不到遠端（離線）**不准當成「你沒推」**
|
||||
|
||||
### A18 — 信標會講出雲端會壞掉的那幾件事：26 條
|
||||
### A18 — 信標會講出雲端會壞掉的那幾件事：33 條
|
||||
```
|
||||
bash hooks/tests/isep-presence-beacon.test.sh
|
||||
```
|
||||
**該看到**：`通過 26 條，失敗 0 條`。全離線。
|
||||
**該看到**：`通過 33 條，失敗 0 條`。全離線。
|
||||
|
||||
> 📌 `inkstone/ISEP#67`（2026-09-07）從 26 條加到 33 條：信標 ④ 開場報「打了 tag 卻沒 release」，見 A38。
|
||||
> 📌 `inkstone/ISEP#122` 從 14 條加到 26 條：信標原本只掃 `scripts/`，
|
||||
> 而**真正會自動載入的東西**（skill／command／agent）同樣兩邊各有一份。
|
||||
> 實查：那 9 個檔案在 `0.1.0`（c263866）複製過來之後**一次都沒再同步**，
|
||||
@@ -623,11 +624,24 @@ bash hooks/tests/parallel-lines-cap-guard.test.sh
|
||||
`PostToolUse:Agent` 在**送出後 5 秒**就觸發（不是收工）；
|
||||
subagent **不是獨立行程**（`ps` 只有一個 claude-code 行程，所以數行程數不到線）。
|
||||
|
||||
### A24 — 一條線要有自己的工作目錄：59 條
|
||||
### A24 — 一條線要有自己的工作目錄：77 條
|
||||
```
|
||||
bash hooks/tests/line-needs-own-worktree.test.sh
|
||||
```
|
||||
**該看到**：`59/59 通過`。離線，每個案例自己開**兩顆**真的 git repo ＋一份真的 linked worktree。
|
||||
**該看到**：`77/77 通過`。離線，每個案例自己開**兩顆**真的 git repo ＋一份真的 linked worktree。
|
||||
|
||||
**E 群在守什麼**（comment 6587，2026-09-07 補）：**閘印出來的那條出路要真的走得通。**
|
||||
閘訊息教的是 `WORKTREE_OK=1 git -C … checkout …`，舊版讀的卻是 hook 自己的環境變數——PreToolUse hook
|
||||
跟指令不是同一個行程，指令前綴的賦值到不了它 ⇒ 總管三次照貼三次被擋。E 群的測資是**閘自己印出來的那一行**
|
||||
（(61) 先擋一次、(62) 抽出那行、(63) 原樣餵回去要放行）；(64)–(67) 釘住判準是**位置不是字**：
|
||||
`echo WORKTREE_OK=1; git checkout`、前綴掛在別的指令上、值不是 1、寫在 commit 訊息裡，四種都照擋。
|
||||
修之前拿新測試跑舊閘：(60)(63)(68) 三條紅，其餘全綠——紅的那三條就是真的改到的。
|
||||
|
||||
**F 群**是 `inkstone/ISEP#125` 票上原文的驗收表 A–F（(70)–(75)，期望值照票：A–E 要 0、**F 要 2**）。
|
||||
D／E 是「用 heredoc 寫一份內含 `cd <目錄> && git checkout X` 示範的文件」被當成在切分支（09-02 兩次實地命中），
|
||||
現在先用 `lib/strip_heredoc.py` 剝掉 body 再解析（跟 D20 閘同一支 helper）。(76) 是寫成測試的已知邊界：
|
||||
tokenize 層把換行當空白吞掉，`…EOF⏎git checkout main` 從第一版起就看不到（漏擋不是誤攔，與 (53) 同層，另報）；
|
||||
(77) 是它的對照組（換成分號就擋）。
|
||||
|
||||
**D 群在守什麼**（comment 5398，2026-08-29 補）：不只要擋對，還要**說得出是哪一個 repo**。
|
||||
舊版一律拿 payload 的 `cwd` 當答案，於是 `cd <別的 repo> && git checkout` 擋是擋對了，
|
||||
@@ -645,6 +659,10 @@ D 群同時釘住反面：認不出來（`cd $VAR`、`cd -`、cd 到不是 repo
|
||||
擋掉它們等於線動不了工
|
||||
- ① 紅 ⇒ 連總管在自己的目錄裡切分支都被擋。那不是嚴格，那是把共用目錄的主人趕出去
|
||||
- ㉞㉟ 紅 ⇒ `prune` 做錯了。㉞是沒清掉說謊的登記；**㉟是把還在的 worktree 也弄掉了，那是災難**
|
||||
- (63) 紅 ⇒ 閘印的出路又走不通了——被擋的人不會停下來修閘，他會去找繞過去的方法（6587 當天就是）
|
||||
- (64)–(67) 任一紅 ⇒ 出路退化成關鍵字：印個字就能過，閘等於沒有
|
||||
- (75) 紅 ⇒ **閘廢了**（#125 原話）：剝 heredoc 剝過頭，真的切也放行
|
||||
- (76) 紅 ⇒ tokenize 那層被改了，回頭跑 (53) 與推 main 的 10＋19 條
|
||||
|
||||
### A25 — `sdd-guard` 退役了，而且退乾淨了：8 條
|
||||
```
|
||||
@@ -859,6 +877,110 @@ Arcrun 的 `stage-deploy-artifacts.py` 自己已寫死只認 youlin 帳號 ID、
|
||||
`CF_SECRETS_API_TOKEN` 的真值是主線 B-3（Arcrun#86）的東西，由總管用 `stage secret put` 種，本票不編一個假的塞進去。
|
||||
⚠️ 「分類器真的不擋」與 A33 同款：要下一版裝進雲端之後，看一趟 run 的 `permission_denials`。
|
||||
|
||||
### A37 — 打了 tag 之後那一站：把 tag 建成 leo 看得到的 release：14 條
|
||||
```
|
||||
bash scripts/test-release-ship.sh
|
||||
```
|
||||
**該看到**：`共 14 項：✅ 14 ／ ❌ 0`。全程離線（`RELEASE_SHIP_FIXTURE`＋`RELEASE_SHIP_SINK`），
|
||||
**不打 Gitea、不建任何真 release**。fixture 的形狀見 `hooks/lib/release_chain.py`。
|
||||
|
||||
**它在守什麼**（`inkstone/ISEP#67`）：ISEP 全樹沒有任何東西會建 release，於是 tag 推了、
|
||||
Releases 頁停在舊版——08-27（v0.4.0／v0.5.0）、09-02（v0.22.0）、09-07（v0.23.0／v0.24.0）
|
||||
同一站斷了三輪；09-07 那次交棒給 leo 的「測試位置」打開是一頁空 tag。
|
||||
三個前置**必須在場**才放行：① **那個 tag 的樹**裡 `plugin.json` ＝ tag 號碼（問 Gitea `contents?ref=<tag>`，
|
||||
**不是工作樹**）② tag 真的在 Gitea ③ note 有內容（沒給就從 Gitea compare 生事實清單）。
|
||||
建完回頭跑 `release-check <那個 tag>` 拿收貨端覆核——送的人說成功不算數。
|
||||
|
||||
**失敗**：
|
||||
- A1 紅 ⇒ tag 的樹自己講錯版本也建得了，leo 裝到的會各說各話
|
||||
- B4 那三條任一紅 ⇒ **前置①又回去比「最新的 tag」或工作樹了**——總管 09-07 在 v0.23.0 的 checkout
|
||||
跑 `release-ship v0.23.0` 就是這樣被擋的（訊息說最新是 v0.24.0），這一組工作樹故意擺 `9.9.9`
|
||||
- B2 第二條紅 ⇒ 已存在的 release 被說成「已建立」（09-05 comment 6207 那句假綠，scout 6213 抓到的）
|
||||
- B3 第二條紅 ⇒ `--dry-run` 真的寫了東西
|
||||
|
||||
**真實跑（2026-09-07，isep-hand，全部唯讀）**：工作樹在本分支（plugin.json 0.24.0）跑
|
||||
`release-ship v0.23.0 --dry-run` → 前置②✅、前置①「tag v0.23.0 的樹裡 plugin.json ＝ 0.23.0」✅、
|
||||
「本來就在了——不重複建、不動它」、覆核 `v0.23.0 ✅✅✅ ←`、exit 0（09-05 那版在同一情境是 exit 2）；
|
||||
`release-ship v0.3.4 --dry-run`（現存唯一沒 release 的 tag）走到「要建」那條路：note 從 Gitea compare 生 8 行、不 POST、exit 0。
|
||||
|
||||
### A38 — 回頭問收貨端「到了嗎」，而且開場就會問：14 條＋信標 7 條
|
||||
```
|
||||
bash scripts/test-release-check.sh
|
||||
bash hooks/tests/isep-presence-beacon.test.sh # ㉗–㉝ 那七條
|
||||
```
|
||||
**該看到**：`共 14 項：✅ 14 ／ ❌ 0`；信標 `通過 33 條，失敗 0 條`。全離線。
|
||||
|
||||
**它在守什麼**（`inkstone/ISEP#67` → comment 6574，總管 09-07 裁定②）：「打了 tag 卻沒 release」
|
||||
要在**下一個 session 開場**就被報出來（一行：缺哪一站＋怎麼補），不靠人記得；兩者都在時安靜。
|
||||
`release-check` 逐版問 Gitea（匿名，D20），現行版本缺站 ⇒ exit 2 ＋指名缺哪一站＋補法（正本絕對路徑）；
|
||||
更舊版本缺件只黃字；**v0.19／0.20／0.21 已裁定不補**（同一則 comment 裁定①），表上標出處、不再黃字。
|
||||
信標 ④ 用同一份判準（`hooks/lib/release_chain.py`）：最新 tag 沒 release ⇒ 報；main 定版比最新 tag 新 ⇒ 報缺 tag；
|
||||
只快取「都在」6 小時，缺件不快取——補完的下一個 session 就該安靜。
|
||||
|
||||
**失敗**：
|
||||
- A1／A2 紅 ⇒ 驗收 4 沒過：故意漏一站，管線說不出缺哪一站
|
||||
- A3 紅 ⇒ `release-check <版本>` 沒看你指定的那一版（release-ship 送完覆核會覆核到錯的版本）
|
||||
- B2 紅 ⇒ **誤攔**：現行版本好好的，舊版缺件卻擋下來（懲罰謹慎）
|
||||
- B4 紅 ⇒ 裁定過不補的三版又天天黃字（會被學會忽略）；或裁決把事實也改掉了（指定它來問應該照擋）
|
||||
- 信標 ㉗ 紅 ⇒ 開場報不出來，斷點又回到靠人記得；㉙ 紅 ⇒ **誤攔**：都在還念；
|
||||
㉚ 紅 ⇒ 問不到收貨端時亂猜；㉜ 紅 ⇒ 印了一條在這一份裡不存在的路徑當出路；㉝ 紅 ⇒ 補完還要念 6 小時
|
||||
|
||||
**真實跑（2026-09-07）**：信標不帶 fixture 打真 Gitea（匿名）→ 安靜（v0.24.0 tag＋release 都在），
|
||||
留下 `.isep-chain-ok-v0.24.0` 快取；`release-check` 在本分支 → `v0.24.0 ✅✅✅ ←`、三個裁定不補的版本標 ⏭、exit 0。
|
||||
|
||||
### A39 — D20 閘判「push 到哪」看的是指令實際會推的那個 repo：26 條
|
||||
```
|
||||
bash scripts/test-github-contact-guard.sh
|
||||
```
|
||||
**該看到**：`26/26 通過`。離線；後 12 條自己開兩顆 git repo（`shell` 的 origin＝github.com、
|
||||
`body` 的 origin 是 Gitea 的形狀），payload 帶 `cwd`，跟 hook 真的會收到的一樣。
|
||||
|
||||
**它在守什麼**（`inkstone/ISEP#109` → comment 6629，2026-09-07 實撞）：雲端薄殼的 cwd 是 GitHub 那份，
|
||||
總管站在那裡 `git -C <InkStoneCo> push origin x`（InkStoneCo 的 origin＝Gitea），舊版拿 **hook 收到的 cwd**
|
||||
解 `origin` ⇒ 判成「指向 GitHub」擋下，`-C` 看都沒看；arcrun-hand 同日在 `Arcrun#176` comment 6614 撞到同一支。
|
||||
現在 remote 名在**這條指令實際會推的那個 repo** 裡解（沿用 `hooks/lib/push_target_dir.py`：cd 鏈、`-C`、
|
||||
子殼不外洩，推 main 那道閘 08-23 就為同一個病接的它）；判準仍是 remote 解出來的 URL 主機，**不是「有 -C 就放行」**。
|
||||
修之前拿新測試跑舊閘：**7 條紅**——4 條是誤攔（推 Gitea 被擋），**3 條是漏擋**（站在 Gitea 那份 `-C` 到薄殼推 GitHub，舊版放行）。
|
||||
|
||||
**失敗**：
|
||||
- 「不該擋」6 條任一紅 ⇒ **誤攔**：雲端推 Gitea 分支又得改用完整網址繞路，久了整道閘沒人當真
|
||||
- 「該擋」5 條任一紅 ⇒ D20 有洞：`-C`／`cd` 指到 GitHub 那份的 push 沒被攔
|
||||
- `(cd body && true); git push` 那條紅 ⇒ 子殼的 cd 外洩了（08-11 穿透的形狀）
|
||||
- 前 14 條紅 ⇒ 舊有判準（heredoc／引號裡的散文／讀取放行）被改壞
|
||||
|
||||
### A37 — 雲端第一則 prompt 的主線就是現在這條，不是兩週前的舊線：31 條
|
||||
```
|
||||
bash hooks/tests/mainline-gitea-fallback.test.sh
|
||||
```
|
||||
**該看到**：`通過 31 條，失敗 0 條`。全程離線：Gitea 是本機一個假伺服器（`TICKET_HOST` 指過去），
|
||||
它照真 Gitea 回——public 時 raw 端點匿名 200；**private 時匿名 404、帶 token 200**（真 `inkstone/InkStoneCo`
|
||||
就是 private，2026-09-07 實測匿名打 raw／contents／repo API 都 404）。狀態走 `ISEP_COUNTDOWN_STATE_DIR`、
|
||||
repo 那份走 TMP 底下的假薄殼。
|
||||
|
||||
**它在守什麼**（inkstone/ISEP#140；母票 #130）：薄殼 `youlinhsieh/inkstoneco` 的 SessionStart 跑在 `bootstrap.sh`
|
||||
之前——`InkStoneCo/` 還沒 clone、家目錄又是空的 ⇒ 兩份主線檔都不在 ⇒ `countdown.py` 退到「期限最近的 milestone」
|
||||
⇒ 第一則 prompt 印 `🔴 主線 把管理這條線做對 已逾期 341 小時`＋`🎯 現在沒有主線`。機制沒壞，是順序。
|
||||
⇒ `scripts/mainline refresh`（SessionStart）在兩份都不在時去 Gitea 讀 `inkstone/InkStoneCo` main 的
|
||||
`system-dev/mainline.json` **一次**、寫進家目錄；之後每一則 UserPromptSubmit 讀家目錄，路徑上照舊零網路。
|
||||
優先序寫死在 `hooks/lib/mainline.py` 檔頭：**家目錄 ＞ repo 那份 ＞ Gitea 那份**，不是第二套來源。
|
||||
|
||||
**失敗**：
|
||||
- ①② 紅 ⇒ 前置狀態測不到（票上撞到的那個畫面重現不了，後面全是假綠）
|
||||
- ⑥⑦⑧ 紅 ⇒ 第一則 prompt 仍是「沒有主線」或那條逾期的舊線——本票要解的就是這一格
|
||||
- ⑨⑲ 紅 ⇒ 一上來就實名（讀的形狀是匿名優先，被拒才帶 token）
|
||||
- ⑬ 紅 ⇒ **每一則訊息的路徑上打了網路**（`load()`／`line()` 從不打網路這條被弄壞）
|
||||
- ⑭⑳㉒ 紅 ⇒ 家目錄或 repo 那份在場還去問 Gitea，或讀 repo 那份時順手寫了家目錄（A32 ④）
|
||||
- ⑮⑯⑰㉓㉔㉕㉖㉗ 紅 ⇒ 讀不到時不是安靜退回：炸、掛住、或往 stderr 抱怨（SessionStart 每次都會看到）
|
||||
- ㉘㉙ 紅 ⇒ bootstrap 之後 repo 那份出現時，`set_at` 規則（A32 ⑤⑦）被本票弄壞
|
||||
|
||||
**真實跑（2026-09-07，雲端 session，isep-hand）**：薄殼形狀（空家目錄、`$CLAUDE_PROJECT_DIR` 是沒有 `InkStoneCo/`
|
||||
的空目錄）——環境有 `GITEA_TOKEN_CLAUDE_CODE`：`mainline refresh` 2.06 秒、rc 0，`mainline` 印
|
||||
`inkstone/Arcrun#48「AI 問一次就看得到全部…」`，UserPromptSubmit 餵 `countdown-guard.sh` 印
|
||||
`⏱ …｜主線 AI 問一次就看得到全部… 剩 137 小時 41 分` 與 `🎯 主線：inkstone/Arcrun#48…`；
|
||||
拔掉 token：rc 0、家目錄零檔案、印「現在沒有主線」、薄殼目錄仍是空的。
|
||||
⚠️ **「新開一個雲端 session、不跑任何指令、第一眼就是它」**這格要下一版裝進雲端才驗得到——
|
||||
前提是 Cloud environment 有 `GITEA_TOKEN_CLAUDE_CODE`（本 session 有），沒有就跟 0.25.0 一樣退到舊線。
|
||||
|
||||
### A5 — 開票前的搜尋是跨 repo 的
|
||||
```
|
||||
python3 scripts/ticket where 標籤 模組化
|
||||
@@ -1129,6 +1251,8 @@ 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） |
|
||||
| **A24 出路那一行原樣餵回去走得通＋#125 A–F** | isep-hand | ✅ 77/77（2026-09-07，inkstone/ISEP#109→6587、#125）＋真路徑實跑（薄殼 cwd、`-C ISEP`：擋→印的那行→放行）＋舊閘實跑 3 條紅 |
|
||||
| **A39 D20 閘看 push 實際會推的 repo** | isep-hand | ✅ 26/26（2026-09-07，inkstone/ISEP#109→6629）＋真路徑實跑（薄殼 cwd：`-C InkStoneCo` 放行、裸 `git push origin` 擋）＋舊閘實跑 7 條紅（4 誤攔＋3 漏擋） |
|
||||
| **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） |
|
||||
@@ -1142,6 +1266,9 @@ B2（信標那行）／B3（setup 輸出）／B4（閘的訊息）三個畫面
|
||||
| **A34 收件 repo 寫 owner/repo 不 404** | isep-hand | ✅ 7/7（2026-09-07，inkstone/ISEP#130） |
|
||||
| **A35 Bot API 直送** | isep-hand | ✅ 10/10（2026-09-07）；**真的到 leo 手機**要 Cloud environment 先有 `TELEGRAM_BOT_TOKEN`／`TELEGRAM_CHAT_ID`（leo） |
|
||||
| **A36 雲端對 stage 的寫入有正門、只寫得進 stage** | isep-hand | ✅ 45/45（2026-09-07，inkstone/ISEP#137）＋真實種進 youlin 一把探針再刪掉、真打 stage GET 200／無 Bearer POST 401；「帶 Bearer 真寫 KBDB」缺 `KBDB_INTERNAL_TOKEN` 沒跑 |
|
||||
| **A37 雲端第一則 prompt 的主線是現在這條** | isep-hand | ✅ 31/31（2026-09-07，inkstone/ISEP#140）＋真 Gitea 薄殼形狀實跑（帶 token 讀到 Arcrun#48；匿名退回）；「新 session 不跑指令第一眼就是它」要下一版裝進雲端 |
|
||||
| **A37 tag → release 那一站** | isep-hand | ✅ 14/14（2026-09-07，inkstone/ISEP#67→6574）＋真 Gitea 唯讀 dry-run 兩次（v0.23.0 總管被擋的情境、v0.3.4 走到建那條路） |
|
||||
| **A38 回頭問收貨端＋開場會問** | isep-hand | ✅ 14/14＋信標 33/33（2026-09-07，inkstone/ISEP#67→6574）＋信標真 Gitea 匿名實跑一次安靜 |
|
||||
| A7 plugin 裝得起來 | 總管 | ✅ |
|
||||
| **A8 新 session 閘會觸發** | 總管 | 見本版 release note |
|
||||
| **B1–B5 雲端** | **leo** | 還沒跑（機器碰不到 Cloud environment） |
|
||||
|
||||
@@ -167,7 +167,7 @@ leo 09-07：「雲端回覆的問題你首要解決⋯⋯僅有需要依賴 Mac
|
||||
|
||||
| 拿不到什麼 | 為什麼 | ISEP 這一半 | 還缺誰 |
|
||||
|---|---|---|---|
|
||||
| **主線是哪條** | 主線檔只在本機 `~/.claude` | `hooks/lib/mainline.py`：家目錄沒有就讀 repo 的 `InkStoneCo/system-dev/mainline.json`（雲端形狀：`$CLAUDE_PROJECT_DIR` 是薄殼根、真身在 `InkStoneCo/`）；`mainline set`／`adopt`／`clear` 兩份一起寫 | 總管 `set` 之後要把 repo 那份 commit／併 main |
|
||||
| **主線是哪條** | 主線檔只在本機 `~/.claude` | `hooks/lib/mainline.py`：家目錄沒有就讀 repo 的 `InkStoneCo/system-dev/mainline.json`（雲端形狀：`$CLAUDE_PROJECT_DIR` 是薄殼根、真身在 `InkStoneCo/`）；`mainline set`／`adopt`／`clear` 兩份一起寫。**兩份都不在**（SessionStart 跑在 `bootstrap.sh` 之前，`InkStoneCo/` 還沒 clone）⇒ `mainline refresh` 去 Gitea 讀 InkStoneCo main 那份一次寫進家目錄（`inkstone/ISEP#140`）——第一則 prompt 的 ⏱／🎯 就是現在這條，不再退到逾期的舊線 | 總管 `set` 之後要把 repo 那份 commit／併 main；Cloud environment 要有 `GITEA_TOKEN_CLAUDE_CODE`（InkStoneCo 是 private，匿名讀不到） |
|
||||
| **正門工具被分類器擋**（`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 加那兩個變數 |
|
||||
|
||||
+16
-4
@@ -32,6 +32,18 @@
|
||||
> **兩個事件是同一件事的兩半**：只注入 ＝ 又一個會被忽略的提醒；只查核 ＝ 罰它做一件拿不到資料的事。
|
||||
> 這兩個數字是併之前當場數出來的，不是從上一版加減推出來的。
|
||||
|
||||
> 📌 **`inkstone/ISEP#67`（2026-09-07）＋0 支、＋0 條、腳本 56→60**：沒加閘。`isep-presence-beacon.sh`
|
||||
> 多報一格 ④「打了 tag 卻沒 release」（改判準不加閘）；`scripts/` 多了運送鏈的兩站 `release-ship`／`release-check`
|
||||
> 與各自的測試，判準收在 `hooks/lib/release_chain.py` 一份三處用。
|
||||
> **61 支、85 條、60 支腳本是在這棵樹上當場數出來的**（`ls hooks/*.sh | wc -l`＝61、
|
||||
> `grep -c '"command":' hooks/hooks.json`＝85、`ls -p scripts | grep -v / | wc -l`＝60）。
|
||||
|
||||
> 📌 **`inkstone/ISEP#109` → comment 6629（2026-09-07）＋0 支、＋0 條**：兩支閘改判準不加閘——
|
||||
> `line-needs-own-worktree.sh` 的出路改認指令字串裡的 `WORKTREE_OK=1` 前綴（舊版讀 hook 自己的環境，
|
||||
> 出路永遠走不通）；`github-contact-guard.sh` 判 push 目標改在「這條指令實際會推的那個 repo」裡解 remote
|
||||
> （舊版在 hook 的 cwd 解，薄殼站 GitHub、推 Gitea 會誤擋，反向會漏）。
|
||||
> 數字是改完當場數的：`ls hooks/*.sh | wc -l`＝61、`grep -c '"command":' hooks/hooks.json`＝85。
|
||||
|
||||
> 📌 **`inkstone/ISEP#130`（2026-09-07）＋0 支、＋1 條**：SessionStart 多掛一條
|
||||
> `scripts/settings-allow-sync --quiet`（不是閘，是腳本：把 ISEP 的權限白名單寫進這台的
|
||||
> `~/.claude/settings.json`，雲端才不會每個正門工具都被分類器擋）。
|
||||
@@ -123,7 +135,7 @@
|
||||
|
||||
| 閘名 | 對你意味著什麼 | 動作 |
|
||||
|---|---|---|
|
||||
| `github-contact-guard.sh` | AI 想碰 GitHub（`git push`、`gh api` 等）就先擋下——兩個帳號曾經因為機器人式高頻寫入被永久 flag 過。**只有讀取（clone/fetch）自由，寫入一律要你在終端機跑 `github-arm.sh` 解鎖**。 | 🛑 擋 |
|
||||
| `github-contact-guard.sh` | AI 想碰 GitHub（`git push`、`gh api` 等）就先擋下——兩個帳號曾經因為機器人式高頻寫入被永久 flag 過。**只有讀取（clone/fetch）自由，寫入一律要你在終端機跑 `github-arm.sh` 解鎖**。判「這次 push 到哪」看的是**這條指令實際會推的那個 repo**（含 `cd …&&`、`git -C …`、cwd 在子目錄），不是 hook 站的 cwd——雲端薄殼站在 GitHub 那份、推的是 Gitea 那份時不會誤擋，反過來也不會漏（`inkstone/ISEP#109`→6629）。 | 🛑 擋 |
|
||||
| `kbdb-api-wall-guard.sh` | AI 想繞過 KBDB 的 API、直接對資料庫下 SQL 或建新表就擋下——KBDB 的鐵律是「只能用 API、永遠只有三張表」。 | 🛑 擋 |
|
||||
| `stage-before-prod-guard.sh` | AI 想動「出貨鏈」相關指令（含 `arcrun-rag-bundles`／`github-arm`／`publish-github` 字樣）卻沒先在 stage 環境驗過就擋下。 | 🛑 擋 |
|
||||
| `main-and-prod-push-guard.sh` | 兩層確認：① subagent 想推 Gitea `main` 分支 → 一定要交回總管，總管確認過才放行；② 任何 `wrangler deploy` 打正式環境 → 一定要你親手解鎖。 | 🛑 擋 |
|
||||
@@ -137,7 +149,7 @@
|
||||
| `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`）。 | 🛑 擋（同一輪只擋一次） |
|
||||
| `search-is-not-proof-guard.sh` | AI 用知識庫的**搜尋**找到一筆東西，然後把那筆東西的原始編號直接貼進票裡或派工單裡，當成「某個功能壞了」的證據——而它從沒用正規的檢索路徑去查過那筆——擋一次。你關心的是：不會再有人拿錯的方法量出一個錯的結論，然後退回一張其實已經做完的票。 | 🛑 擋（同一輪只擋一次） |
|
||||
| `line-needs-own-worktree.sh` | 一條派工線想在**大家共用的那份工作目錄**裡切分支（`git checkout`／`git switch`）就擋下，叫它先開一份自己的 worktree。你關心的是：不會再有人交回工作時把某個 repo 留在自己的分支上，而下一個人在同一個目錄跑出貨、讀到的是別人留下的 HEAD。**總管在自己的目錄裡切分支不管**（那是他的目錄）；已經在自己 worktree 裡的切換全部放行；還原檔案（`git checkout -- 檔`）不管。擋下來的同時會順手把「指向空氣」的 worktree 登記清掉。 | 🛑 擋 |
|
||||
| `line-needs-own-worktree.sh` | 一條派工線想在**大家共用的那份工作目錄**裡切分支（`git checkout`／`git switch`）就擋下，叫它先開一份自己的 worktree。你關心的是：不會再有人交回工作時把某個 repo 留在自己的分支上，而下一個人在同一個目錄跑出貨、讀到的是別人留下的 HEAD。**總管在自己的目錄裡切分支不管**（那是他的目錄）；已經在自己 worktree 裡的切換全部放行；還原檔案（`git checkout -- 檔`）不管。擋下來的同時會順手把「指向空氣」的 worktree 登記清掉。出路是閘訊息印的那一行 `WORKTREE_OK=1 git -C … checkout …`——認的是**指令字串裡**的這個前綴，原樣貼回去就過（`inkstone/ISEP#109`→6587：舊版讀 hook 自己的環境變數，那行在 Claude Code 底下永遠走不通）。 | 🛑 擋 |
|
||||
| `diagnosis-evidence-guard.sh` | 你想把一段有份量的東西寫上票，而這個 session **沒派人去查過那張票**、那段話裡也**沒有任何走得過去的出處**（檔案:行號／commit／comment 號／票號／網址／貼出來的實測輸出）就擋一次——未經調查的診斷寫在票上會長得像事實，工人會照著它去驗證而不是去查。派過人查、或把出處帶上，都放行；一句短回覆不管。 | 🛑 擋 |
|
||||
## B. AI 想寫檔案／改程式碼的當下（PreToolUse / Write·Edit·MultiEdit）
|
||||
|
||||
@@ -210,10 +222,10 @@
|
||||
|
||||
| 閘名 | 對你意味著什麼 | 動作 |
|
||||
|---|---|---|
|
||||
| `isep-presence-beacon.sh` | 對話一開始印一行 `🟢 ISEP vX.Y.Z 已載入（N 支閘｜來源：…）`。**這行不是裝飾，是唯一能證明「這個 session 真的有閘」的東西**——它自己就住在 plugin 裡，看得到它就表示 plugin 載入了；某個 session 從頭到尾沒有這行，那個 session 是零閘狀態，先修 plugin 再做事。同一台機器可能同時有兩份 ISEP（marketplace 裝的、repo 裡 vendor 的），所以那行會講出這次是哪一份在說話。它另外會報四件「這一份是不是還有效」：①這一份落後 ISEP main 幾版 ②專案裡有沒有內容不同的同名**腳本**②b 專案裡有沒有內容不同的同名**skill／command／agent**——這些是**自動載入**的，載到舊的那份不會有任何症狀，只會安靜地教錯的東西（`docs/file-ownership.tsv` 說得出每一組的真相源是哪一份、往哪個方向修）②c 本身的內容跟那張歸屬表對不對得上（雲端沒有專案那一份可比時，這是唯一還作數的檢查）③工作區有沒有已退役機制留下的產物。**全部只講不擋。** | 📝 記錄（context 注入） |
|
||||
| `isep-presence-beacon.sh` | 對話一開始印一行 `🟢 ISEP vX.Y.Z 已載入（N 支閘｜來源：…）`。**這行不是裝飾，是唯一能證明「這個 session 真的有閘」的東西**——它自己就住在 plugin 裡，看得到它就表示 plugin 載入了；某個 session 從頭到尾沒有這行，那個 session 是零閘狀態，先修 plugin 再做事。同一台機器可能同時有兩份 ISEP（marketplace 裝的、repo 裡 vendor 的），所以那行會講出這次是哪一份在說話。它另外會報四件「這一份是不是還有效」：①這一份落後 ISEP main 幾版 ②專案裡有沒有內容不同的同名**腳本**②b 專案裡有沒有內容不同的同名**skill／command／agent**——這些是**自動載入**的，載到舊的那份不會有任何症狀，只會安靜地教錯的東西（`docs/file-ownership.tsv` 說得出每一組的真相源是哪一份、往哪個方向修）②c 本身的內容跟那張歸屬表對不對得上（雲端沒有專案那一份可比時，這是唯一還作數的檢查）③工作區有沒有已退役機制留下的產物 ④**打了 tag 卻沒 release**（Gitea 最新 tag 沒有 release、或 main 定版了還沒打 tag）——一行說缺哪一站＋可以直接貼著跑的補法（`scripts/release-ship`），都在時一個字都不說；判準跟 `release-ship`／`release-check` 同一份（`hooks/lib/release_chain.py`），匿名讀、問不到就閉嘴（`inkstone/ISEP#67`）。**全部只講不擋。** | 📝 記錄（context 注入） |
|
||||
| `session-start-recall.sh` | 對話一開始就自動把「全局現況」（Gitea 各 repo 的票、KBDB 的藏書地圖）推到 AI 眼前，不必等它自己想到要查。 | 📝 記錄（context 注入） |
|
||||
| `scripts/settings-allow-sync --quiet` | （不是閘，是腳本）對話一開始把 ISEP 的權限白名單（`docs/permissions-allow.json`：`ticket`／`mainline`／`gate-ok`／`gitea-pr-merge`／`stage`（inkstone/ISEP#137 起，雲端對 stage 寫入的正門）五個正門工具，外加 Arcrun 的 `stage-deploy-artifacts.py`）寫進**這台機器**的 `~/.claude/settings.json`。只加不減、冪等；目標檔壞掉就不碰它、講一聲。**為什麼**：leo 09-07 親手加的四條只在本機，雲端沒有 ⇒ 同樣的動作被分類器擋（09-04 run log `permission_denials=6`）；薄殼 repo 要 D20 開閘才推得動，所以清單住 ISEP 一份、兩台各自寫進自己的家目錄（inkstone/ISEP#130）。 | 📝 記錄（寫 settings） |
|
||||
| `scripts/mainline refresh` | （不是閘，是腳本）對話一開始把**現在的主線**那條 milestone 的進度與期限更新一次，好讓每回合眼前那一行講的是今天的數字。拿不到 Gitea 就原封不動——**寧可資料舊，不要把主線弄丟**。跑一次就結束，不輪詢。 | 📝 記錄 |
|
||||
| `scripts/mainline refresh` | （不是閘，是腳本）對話一開始把**現在的主線**那條 milestone 的進度與期限更新一次，好讓每回合眼前那一行講的是今天的數字。拿不到 Gitea 就原封不動——**寧可資料舊，不要把主線弄丟**。跑一次就結束，不輪詢。**家目錄與 repo 那份都不在時**（雲端薄殼跑到這裡 `InkStoneCo/` 還沒 clone）先去 Gitea 讀 `inkstone/InkStoneCo` main 的 `system-dev/mainline.json` 一次寫進家目錄（`inkstone/ISEP#140`）：匿名優先、被拒才帶 token；讀不到就退回，不報錯、逾時有上限。優先序寫在 `hooks/lib/mainline.py` 檔頭。 | 📝 記錄 |
|
||||
| `overdue-nag-guard.sh` | 對話一開始就去 Gitea 撈**沒有人會叫的事**：逾期的 milestone、掛著等你的票（標「等了幾天」）、標著「有人在做」卻好幾天沒動的票；撈完用白話講出來，**有事就發 Telegram 給你**。沒東西可報時它會說「查過了，沒有」——**安靜跟壞掉長得一模一樣**。發不出去時不會靜默：它會先問這個 session 的 `prod-write-guard` 會不會擋（舊版把「發通知」誤認成「部署」），擋就改貼回票上並把原文印在眼前。只在開 session 時跑一次，**不輪詢、不掛排程**。 | 📝 記錄（context 注入 ＋ Telegram） |
|
||||
| `wiki-size-guard.sh` | 對話一開始講出「哪幾個 wiki 檔已經沒有人讀得完了」（預設超過 1200 行就點名）。**讀不完的必讀檔，跟沒有那個檔的差別只在於它讓人以為有。** 另一半掛在寫檔上，見 B 組。 | 📝 記錄（context 注入） |
|
||||
| `skill-deploy-drift-guard.sh` | 如果「全機真正在用的 skill」跟「repo 裡版控的正本」內容對不上，就在開場講出來——避免用著一份沒人知道已經跟正本分家的舊拷貝。 | 📝 記錄 |
|
||||
|
||||
@@ -5,7 +5,8 @@
|
||||
"雲端 session 沒有那四條，同樣的動作照樣被擋（09-04 progress-guard run log：permission_denials=6）。",
|
||||
"薄殼 repo（GitHub）要 D20 開閘才推得動 ⇒ 白名單住 ISEP，`scripts/settings-allow-sync` 開工時寫進那台機器的 ~/.claude/settings.json。",
|
||||
"以後加規則只改這個檔、出一版，雲端下一趟就有。",
|
||||
"inkstone/ISEP#137：09-07 雲端對 stage 的三種寫入（`npx wrangler secret put`／`stage-deploy-artifacts.py`／curl POST 到 arcrun-yuga3bse）全被分類器擋——複合指令與任意 curl 對不上任何一條前綴。收成 `scripts/stage`（secret／api 兩個子命令，只寫 stage、值只從環境變數名讀）四種形狀，外加 Arcrun 自己那支 `scripts/stage-deploy-artifacts.py`（它已寫死只認 youlin 帳號 ID、不收 --account／--token）從 Arcrun repo 根目錄的相對形狀。不放 `Bash(npx *)`／`Bash(wrangler *)`／`Bash(curl *)`。"
|
||||
"inkstone/ISEP#137：09-07 雲端對 stage 的三種寫入（`npx wrangler secret put`／`stage-deploy-artifacts.py`／curl POST 到 arcrun-yuga3bse）全被分類器擋——複合指令與任意 curl 對不上任何一條前綴。收成 `scripts/stage`（secret／api 兩個子命令，只寫 stage、值只從環境變數名讀）四種形狀，外加 Arcrun 自己那支 `scripts/stage-deploy-artifacts.py`（它已寫死只認 youlin 帳號 ID、不收 --account／--token）從 Arcrun repo 根目錄的相對形狀。不放 `Bash(npx *)`／`Bash(wrangler *)`／`Bash(curl *)`。",
|
||||
"inkstone/ISEP#67：SessionStart 信標印的補法是 `python3 <plugin root>/scripts/release-ship vX.Y.Z`——那一行在雲端要是被分類器擋，出路就走不通（閘的價值是「擋下來＋給一條走得通的路」）。release-ship 只 POST 一件事（建 release，tag 與 release 名寫死從 Gitea 讀）；release-check 純讀。"
|
||||
],
|
||||
"_rules": [
|
||||
"開頭的 `~` 由 settings-allow-sync 換成那台機器的家目錄（本機 /Users/…、雲端 /root），其餘一字不改。",
|
||||
@@ -31,6 +32,14 @@
|
||||
"Bash(python3 \"$CLAUDE_PLUGIN_ROOT/scripts/stage\" *)",
|
||||
"Bash(python3 \"$CLAUDE_PLUGIN_ROOT\"/scripts/stage *)",
|
||||
"Bash(python3 scripts/stage *)",
|
||||
"Bash(python3 scripts/stage-deploy-artifacts.py *)"
|
||||
"Bash(python3 scripts/stage-deploy-artifacts.py *)",
|
||||
"Bash(python3 ~/.claude/plugins/cache/inkstone/isep/*/scripts/release-ship *)",
|
||||
"Bash(python3 \"$CLAUDE_PLUGIN_ROOT/scripts/release-ship\" *)",
|
||||
"Bash(python3 \"$CLAUDE_PLUGIN_ROOT\"/scripts/release-ship *)",
|
||||
"Bash(python3 scripts/release-ship *)",
|
||||
"Bash(python3 ~/.claude/plugins/cache/inkstone/isep/*/scripts/release-check *)",
|
||||
"Bash(python3 \"$CLAUDE_PLUGIN_ROOT/scripts/release-check\" *)",
|
||||
"Bash(python3 \"$CLAUDE_PLUGIN_ROOT\"/scripts/release-check *)",
|
||||
"Bash(python3 scripts/release-check *)"
|
||||
]
|
||||
}
|
||||
|
||||
@@ -87,12 +87,29 @@ try: print(json.load(sys.stdin).get('cwd','') or '')
|
||||
except Exception: print('')
|
||||
" 2>/dev/null)
|
||||
[ -n "$CWD" ] || CWD=$(pwd)
|
||||
# 🔴 2026-09-07（inkstone/ISEP#109 → comment 6629）：remote 名要在**這條指令實際會推的
|
||||
# 那個 repo** 裡解，不是在 hook 收到的 cwd 裡解。雲端薄殼的 cwd 是 GitHub 那份
|
||||
# （origin＝github.com），總管站在那裡 `git -C <InkStoneCo> push origin x`
|
||||
# （InkStoneCo 的 origin＝Gitea）——舊版拿 cwd 解 origin ⇒ 判成「指向 GitHub」擋下，
|
||||
# `-C` 看都沒看；反過來，站在 Gitea 那份 `git -C <薄殼> push origin x` 則**漏擋**。
|
||||
# ⇒ 沿用 lib/push_target_dir.py（推 main 那道閘 08-23 就是為同一個病接的它）：
|
||||
# 純 tokenize 解出 cd 鏈／-C，解得出來就 cd 進去（唯讀）問 git；解不出來
|
||||
# （`cd $VAR`、目錄不存在）才退回 cwd——退回的方向是「照舊」，不是放寬。
|
||||
# 判準沒變：仍是 remote 解出來的 URL 主機（唯一識別碼），不是「有沒有 -C」。
|
||||
PUSHDIR="$CWD"
|
||||
_ptd="$(dirname "$0")/lib/push_target_dir.py"
|
||||
if [ -f "$_ptd" ]; then
|
||||
_expr=$(printf '%s' "$CMD" | python3 "$_ptd" 2>/dev/null || printf '')
|
||||
if [ -n "$_expr" ]; then
|
||||
PUSHDIR=$(cd "$CWD" 2>/dev/null && cd "$_expr" 2>/dev/null && pwd) || PUSHDIR="$CWD"
|
||||
fi
|
||||
fi
|
||||
# 取 push 後面第一個非 flag 的字當 remote 名；沒有就是 origin
|
||||
RNAME=$(printf '%s' "$CMD" | sed -nE 's/.*git[[:space:]]+([^|;&]*[[:space:]])?push[[:space:]]+(-[^[:space:]]+[[:space:]]+)*([A-Za-z0-9._／/-]+).*/\3/p' | head -1)
|
||||
[ -n "$RNAME" ] || RNAME="origin"
|
||||
RURL=$(git -C "$CWD" remote get-url "$RNAME" 2>/dev/null)
|
||||
RURL=$(git -C "$PUSHDIR" remote get-url "$RNAME" 2>/dev/null)
|
||||
if printf '%s' "$RURL" | grep -qi 'github\.com'; then
|
||||
HIT="git push → github（remote「$RNAME」指向 GitHub）"
|
||||
HIT="git push → github（$PUSHDIR 的 remote「$RNAME」指向 GitHub：$(printf '%s' "$RURL" | sed 's|//[^@]*@|//<憑證省略>@|g')）"
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
|
||||
@@ -59,6 +59,76 @@ if MAIN and VER != "未知" and MAIN != VER:
|
||||
else:
|
||||
notes.append("ℹ️ 這一份比 ISEP main 新（載入 %s ／ main %s）——沒發版的改動只在這台機器上。" % (VER, MAIN))
|
||||
|
||||
# ══ ④ 打了 tag 卻沒 release（運送鏈斷在 leo 看得到的那一站之前）═══════════
|
||||
#
|
||||
# 🔴 為什麼要在開場報（inkstone/ISEP#67 → comment 6574，總管 2026-09-07 裁定）：
|
||||
# v0.23.0／v0.24.0 的 tag 都推了，Gitea Releases 頁卻停在 v0.22.0——
|
||||
# 交棒給 leo 的「測試位置 releases/tag/v0.24.0」打開是一頁空 tag。
|
||||
# 建 release 的工具（scripts/release-ship）在 09-05 就寫好了，但**沒有任何東西在
|
||||
# 下一個 session 開場說「你上一版少了一站」**——於是斷點靠人記得，而人沒記得。
|
||||
# 判準（與 release-ship／release-check 同一份：hooks/lib/release_chain.py）：
|
||||
# · Gitea 上最新的 tag，它的 release 在不在 → 不在＝「打了 tag 沒 release」
|
||||
# · main 宣稱的版本（①已經拿到的 MAIN）比最新 tag 新 → 「定版了沒打 tag」
|
||||
# 兩者都在 ⇒ 一個字都不說（天天念的東西會被學會忽略）。
|
||||
# 匿名讀（D20）、逾時 6 秒、問不到就閉嘴；只快取「都在」的結果 6 小時，
|
||||
# 缺件不快取——補完的下一個 session 就該安靜，不該再念 6 小時。
|
||||
def chain_gap():
|
||||
"""回 (版本, [(站, 補法)]) 或 None（問不到／沒有 tag／都在）。"""
|
||||
fx = None
|
||||
if os.environ.get("ISEP_BEACON_SKIP_NET") == "1":
|
||||
fxp = os.environ.get("ISEP_BEACON_CHAIN_FIXTURE")
|
||||
if not fxp:
|
||||
return None
|
||||
try:
|
||||
fx = json.load(open(fxp, encoding="utf-8"))
|
||||
except Exception:
|
||||
return None
|
||||
try:
|
||||
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
|
||||
import release_chain as rc
|
||||
except Exception:
|
||||
return None
|
||||
ship = os.path.join(ROOT, "scripts", "release-ship")
|
||||
ship_cmd = ("python3 %s" % ship) if os.path.isfile(ship) else \
|
||||
"先 `claude plugin update isep@inkstone`（這一份 v%s 還沒有 scripts/release-ship）再跑 `python3 \"$CLAUDE_PLUGIN_ROOT\"/scripts/release-ship`" % VER
|
||||
chain = rc.Chain(fixture=fx, timeout=6)
|
||||
try:
|
||||
tags = chain.tags()
|
||||
if not tags:
|
||||
return None
|
||||
latest = max(tags, key=rc.vtuple)
|
||||
cache = os.path.join(os.environ.get("ISEP_BEACON_CACHE_DIR", "/tmp"), ".isep-chain-ok-" + latest)
|
||||
# main 定版了、tag 還沒打 ⇒ 缺的是 tag 那一站（MAIN 來自 ①，可能是 6 小時內的快取）
|
||||
if MAIN and rc.vtuple(MAIN) > rc.vtuple(latest):
|
||||
g = [(label, fix.format(v=MAIN, ship=ship_cmd)) for k, label, fix in rc.STATIONS if k == "tag"]
|
||||
return MAIN, g
|
||||
try:
|
||||
if fx is None and time.time() - os.path.getmtime(cache) < 6 * 3600:
|
||||
return None
|
||||
except Exception:
|
||||
pass
|
||||
rels = chain.releases()
|
||||
g = [(label, fix.format(v=latest.lstrip("v"), ship=ship_cmd))
|
||||
for k, label, fix in rc.gaps(latest, tags, rels) if k == "release"]
|
||||
if not g:
|
||||
try:
|
||||
open(cache, "w").write(latest)
|
||||
except Exception:
|
||||
pass
|
||||
return None
|
||||
return latest.lstrip("v"), g
|
||||
except Exception:
|
||||
return None
|
||||
|
||||
cg = chain_gap()
|
||||
if cg:
|
||||
ver_gap, stations = cg
|
||||
notes.append(
|
||||
"🔴 **v%s 送到一半：%s**——leo 那頁（Gitea Releases）看不到這一版，對他等於不存在。"
|
||||
"補：%s（inkstone/ISEP#67）"
|
||||
% (ver_gap, "、".join("缺 " + label for label, _f in stations),
|
||||
"；".join(fix for _l, fix in stations)))
|
||||
|
||||
# ══ ② 專案裡有沒有 ISEP 腳本的舊複本在遮蔽正門 ══════════════════════════
|
||||
#
|
||||
# 🔴 實例（inkstone/ISEP#90 ②）：`InkStoneCo/scripts/ticket` 是 ISEP `scripts/ticket`
|
||||
|
||||
@@ -30,13 +30,24 @@
|
||||
其他 目錄運算式，可能是相對的；呼叫端自己 `cd` 進去問 git（唯讀）。
|
||||
"." ＝「就是呼叫端自己的 cwd」（指令裡沒有 cd 也沒有 -C）。
|
||||
|
||||
用法：printf '%s' "$CMD" | python3 checkout_target_dir.py
|
||||
出路的判準也住在這裡（inkstone/ISEP#109 → comment 6587，2026-09-07）
|
||||
閘訊息教的出路是 `WORKTREE_OK=1 git -C … checkout …`。舊版讀的是 **hook 自己的
|
||||
環境變數**，而 PreToolUse hook 跑在指令之前、跟指令不是同一個行程——指令字串裡的
|
||||
`WORKTREE_OK=1` 是給 git 的前綴賦值，hook 的行程裡根本沒有它 ⇒ 總管三次照貼三次被擋。
|
||||
⇒ 改成認**指令字串裡的字面前綴**，而且判準是位置不是字：那個賦值必須是
|
||||
「會移動 HEAD 的那條 git 指令」自己的前綴（`echo WORKTREE_OK=1; git checkout` 不算、
|
||||
`WORKTREE_OK=1 echo hi && git checkout` 不算、寫在 commit 訊息裡不算）。
|
||||
留痕就是那個前綴本身——它在指令歷史上。
|
||||
|
||||
用法：printf '%s' "$CMD" | python3 checkout_target_dir.py → 目錄運算式（見上）
|
||||
printf '%s' "$CMD" | python3 checkout_target_dir.py --escape WORKTREE_OK=1
|
||||
→ 那條 checkout 帶著這個前綴就印 1，否則空
|
||||
"""
|
||||
import os
|
||||
import sys
|
||||
|
||||
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
|
||||
from push_target_dir import _events, _join # noqa: E402
|
||||
from push_target_dir import _ENV_ASSIGN, _events, _join # noqa: E402
|
||||
|
||||
VERBS = ("checkout", "switch")
|
||||
UNKNOWN = "?"
|
||||
@@ -52,14 +63,19 @@ def _step(base, path):
|
||||
|
||||
|
||||
def _moves_head(tokens):
|
||||
"""tokens 是整串 `git …`。回傳 (會不會動 HEAD, -C 指的路徑 or None)。
|
||||
"""tokens 是整串 `[NAME=value …] git …`。
|
||||
回傳 (會不會動 HEAD, -C 指的路徑 or None, 前綴賦值清單)。
|
||||
|
||||
判準只有「這個動作動不動 HEAD」，不看任何措辭：
|
||||
git checkout -- <檔>／git checkout HEAD -- <檔> ⇒ 還原檔案，不動
|
||||
git checkout -p ⇒ 挑 hunk，不動
|
||||
git checkout（沒有任何目標） ⇒ git 自己會報錯
|
||||
"""
|
||||
tok = list(tokens[1:]) # 去掉 "git"
|
||||
tok = list(tokens)
|
||||
env = []
|
||||
while tok and _ENV_ASSIGN.match(tok[0]):
|
||||
env.append(tok.pop(0)) # `WORKTREE_OK=1 git …` 的前綴——出路就認這個
|
||||
tok = tok[1:] # 去掉 "git"
|
||||
c_path = None
|
||||
while tok and tok[0].startswith("-"):
|
||||
if tok[0] == "-C" and len(tok) > 1:
|
||||
@@ -72,24 +88,25 @@ def _moves_head(tokens):
|
||||
tok.pop(0)
|
||||
continue
|
||||
if tok[0].startswith("--git-dir"):
|
||||
return (False, None) # 自己指 git-dir 的花式用法，不猜
|
||||
return (False, None, env) # 自己指 git-dir 的花式用法，不猜
|
||||
tok.pop(0)
|
||||
if not tok or tok[0] not in VERBS:
|
||||
return (False, None)
|
||||
return (False, None, env)
|
||||
|
||||
rest = tok[1:]
|
||||
if "--" in rest or "-p" in rest or "--patch" in rest:
|
||||
return (False, None)
|
||||
return (False, None, env)
|
||||
if not [a for a in rest if not a.startswith("-")] and \
|
||||
not any(a in ("-b", "-B", "-c", "-C") for a in rest):
|
||||
return (False, None)
|
||||
return (True, c_path)
|
||||
return (False, None, env)
|
||||
return (True, c_path, env)
|
||||
|
||||
|
||||
def find_checkout_target(cmd):
|
||||
def find_checkout(cmd):
|
||||
"""回 (目錄運算式, 那條 checkout 的前綴賦值清單)。目錄運算式的三種值見檔頭。"""
|
||||
events = _events(cmd, VERBS, strip_env=True)
|
||||
if not events:
|
||||
return "" # 引號壞掉之類——沿用「不擋在不確定上」
|
||||
return ("", []) # 引號壞掉之類——沿用「不擋在不確定上」
|
||||
|
||||
stack = [None] # 每層括號各自的 cwd；None ＝ 同呼叫端的 cwd
|
||||
for kind, val in events:
|
||||
@@ -101,7 +118,7 @@ def find_checkout_target(cmd):
|
||||
elif kind == "cd":
|
||||
stack[-1] = _step(stack[-1], val)
|
||||
elif kind == "verb":
|
||||
moves, c_path = _moves_head(val)
|
||||
moves, c_path, env = _moves_head(val)
|
||||
if not moves:
|
||||
continue
|
||||
where = stack[-1]
|
||||
@@ -110,13 +127,29 @@ def find_checkout_target(cmd):
|
||||
# （而且 -C 若是相對路徑，是接在 cd 之後算，不是接在 cwd）
|
||||
where = _step(where, c_path)
|
||||
if where == UNKNOWN:
|
||||
return UNKNOWN
|
||||
return where or "."
|
||||
return ""
|
||||
return (UNKNOWN, env)
|
||||
return (where or ".", env)
|
||||
return ("", [])
|
||||
|
||||
|
||||
def find_checkout_target(cmd):
|
||||
return find_checkout(cmd)[0]
|
||||
|
||||
|
||||
def has_escape(cmd, assignment):
|
||||
"""會移動 HEAD 的那條 git 指令，自己的前綴裡有沒有這個字面賦值（例 `WORKTREE_OK=1`）。
|
||||
只看**那條指令的前綴**：印在別處、掛在別的指令上、寫在引號裡都不算。"""
|
||||
_expr, env = find_checkout(cmd)
|
||||
return assignment in env
|
||||
|
||||
|
||||
def main():
|
||||
sys.stdout.write(find_checkout_target(sys.stdin.read()))
|
||||
argv = sys.argv[1:]
|
||||
cmd = sys.stdin.read()
|
||||
if len(argv) == 2 and argv[0] == "--escape":
|
||||
sys.stdout.write("1" if has_escape(cmd, argv[1]) else "")
|
||||
return
|
||||
sys.stdout.write(find_checkout_target(cmd))
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
|
||||
+101
-5
@@ -27,10 +27,21 @@ Gitea 的 milestone 不能跨 repo，而同一條線常常同時開在 5 個 rep
|
||||
· **成員判定**＝ 票所屬 milestone 的**標題**與主線標題相同（不分 repo）
|
||||
⇒ 「同名跨 repo」照舊能用，而「現在在做哪一條」仍然只有一個答案。
|
||||
|
||||
── 這支從不打網路 ────────────────────────────────────────────────
|
||||
它被 `UserPromptSubmit` 用（每一則訊息的關鍵路徑）。在那裡打 HTTP ＝ 每講一句話
|
||||
── `load()`／`line()` 從不打網路 ─────────────────────────────────
|
||||
它們被 `UserPromptSubmit` 用（每一則訊息的關鍵路徑）。在那裡打 HTTP ＝ 每講一句話
|
||||
都先等一次網路。網路那一半全部在 `scripts/mainline`（set／refresh／adopt），
|
||||
本支只讀寫 state 檔。讀不到 ⇒ 回「沒有主線」，**不編一條出來**。
|
||||
本支的讀寫只碰 state 檔。讀不到 ⇒ 回「沒有主線」，**不編一條出來**。
|
||||
唯一的例外是 `fetch_gitea()`（inkstone/ISEP#140，見下方第三個來源那段）：
|
||||
它會打一次 Gitea，但**只有 SessionStart 的 `scripts/mainline refresh` 叫它**，
|
||||
`load()`／`line()` 永遠不叫——所以每一則訊息的路徑上仍然沒有網路。
|
||||
|
||||
── 三個來源，優先序寫死：家目錄 ＞ repo 那份 ＞ Gitea main 那份 ───────
|
||||
① 家目錄 `~/.claude/isep-countdown/mainline.json`（這台機器上 refresh 過、有進度）
|
||||
② repo 那份 `InkStoneCo/system-dev/mainline.json`（隨 repo 走，inkstone/ISEP#130）
|
||||
③ Gitea 上 `inkstone/InkStoneCo` main 的同一個檔（inkstone/ISEP#140）
|
||||
①② 之間誰算數看 `set_at`（見 `load()`）；③ **只在 ①② 都不存在時**被問一次，
|
||||
抓到就寫進 ①，之後跟 ① 一樣對待。③ 讀的就是 ② 那個檔，只是從 Gitea 拿而不是從
|
||||
工作樹拿——它不是第二套主線來源。
|
||||
"""
|
||||
import json
|
||||
import os
|
||||
@@ -106,15 +117,100 @@ def repo_path(for_write=False):
|
||||
return None
|
||||
|
||||
|
||||
def _valid(d):
|
||||
"""一份主線檔長什麼樣才算數：dict、而且有 title。三個來源用同一把尺。"""
|
||||
return d if (isinstance(d, dict) and d.get("title")) else None
|
||||
|
||||
|
||||
def _read(p):
|
||||
try:
|
||||
with open(p) as f:
|
||||
d = json.load(f)
|
||||
except Exception:
|
||||
return None
|
||||
if not isinstance(d, dict) or not d.get("title"):
|
||||
return _valid(d)
|
||||
|
||||
|
||||
# ── Gitea main 上的那一份（inkstone/ISEP#140）────────────────────────
|
||||
#
|
||||
# 雲端薄殼 `youlinhsieh/inkstoneco` 的 SessionStart 跑在 `bootstrap.sh` 之前：那時
|
||||
# `InkStoneCo/` 還沒 clone，家目錄又是空的 ⇒ 上面兩份都不存在 ⇒ `countdown.py` 退到
|
||||
# 第二基準「期限最近的 milestone」⇒ 第一則 prompt 印出一條兩週前的舊線
|
||||
# （票上實測：`🔴 主線 把管理這條線做對 已逾期 341 小時`＋`🎯 現在沒有主線`）。
|
||||
# 機制沒壞，是順序。而「哪一條是主線」這個指標本來就在 Gitea 上讀得到。
|
||||
#
|
||||
# 規矩（跟上面「repo 裡的那一份」那段接起來，不另立一套）：
|
||||
# · 只在家目錄與 repo 那份**都不存在**時問 Gitea，問一次；任一份在場就不問。
|
||||
# · 只有 SessionStart 的 `scripts/mainline refresh` 會叫 `fetch_gitea()`；抓到就
|
||||
# `save()` 進家目錄（不 mirror：雲端沒有 InkStoneCo/ 可寫，本機也不弄髒工作樹）。
|
||||
# bootstrap 之後 repo 那份出現時，兩份 `set_at` 相同 ⇒ 家目錄那份算數（它有 refresh 過的進度）。
|
||||
# · 匿名優先。匿名被拒（401／403／404）且環境拿得到 Gitea token 才帶 token 再問一次
|
||||
# ——`inkstone/InkStoneCo` 在 Gitea 是 **private**（2026-09-07 實測：匿名打 raw／
|
||||
# contents／repo API 都 404），沒 token 就真的讀不到。
|
||||
# · 讀不到（斷網／5xx／不是 JSON／沒 title／逾時）⇒ 回 None，退回現行行為，不報錯。
|
||||
# 逾時有上限（`ISEP_MAINLINE_GITEA_TIMEOUT`，預設 4 秒，最多問兩次）。
|
||||
# · 測試用：`ISEP_MAINLINE_GITEA_URL=none` 把這個來源整個拿掉；`TICKET_HOST` 換主機
|
||||
# （既有測試都把它指到連不上的位址，所以它們照舊離線）。
|
||||
GITEA_HOST_DEFAULT = "https://git.uncle6.me"
|
||||
GITEA_REPO = "inkstone/InkStoneCo"
|
||||
GITEA_REF = "main"
|
||||
|
||||
|
||||
def gitea_url() -> str:
|
||||
forced = os.environ.get("ISEP_MAINLINE_GITEA_URL", "").strip()
|
||||
if forced == "none":
|
||||
return ""
|
||||
if forced:
|
||||
return forced
|
||||
host = (os.environ.get("TICKET_HOST", "").strip() or GITEA_HOST_DEFAULT).rstrip("/")
|
||||
return "%s/api/v1/repos/%s/raw/%s?ref=%s" % (
|
||||
host, GITEA_REPO, REPO_REL.replace(os.sep, "/"), GITEA_REF)
|
||||
|
||||
|
||||
def fetch_gitea(token="", timeout=None):
|
||||
"""去 Gitea 讀 `inkstone/InkStoneCo` main 上的 `system-dev/mainline.json`。
|
||||
|
||||
回一份跟 `_read()` 同樣通過 `_valid()` 的 dict，或 None。**永遠不 raise。**
|
||||
`token`：字串，或一個回字串的函式（只在匿名被拒時才會被叫）。
|
||||
🔴 這是本檔唯一會打網路的函式，只准 SessionStart 的 `scripts/mainline refresh` 叫；
|
||||
`load()`／`line()` 走的是每一則訊息的關鍵路徑，不准碰它。
|
||||
"""
|
||||
url = gitea_url()
|
||||
if not url:
|
||||
return None
|
||||
if timeout is None:
|
||||
try:
|
||||
timeout = float(os.environ.get("ISEP_MAINLINE_GITEA_TIMEOUT", "") or 4)
|
||||
except Exception:
|
||||
timeout = 4.0
|
||||
import urllib.error
|
||||
import urllib.request
|
||||
|
||||
def get(headers):
|
||||
req = urllib.request.Request(url, headers=headers)
|
||||
with urllib.request.urlopen(req, timeout=timeout) as r:
|
||||
return r.read().decode("utf-8", "replace")
|
||||
|
||||
try:
|
||||
text = get({}) # 匿名優先（D20 的形狀：讀不帶憑證）
|
||||
except urllib.error.HTTPError as e:
|
||||
if e.code not in (401, 403, 404):
|
||||
return None
|
||||
# `token` 可以是字串，也可以是「被拒了才去拿」的函式——拿 token 可能要掃 git remote、
|
||||
# 可能拿不到而想開口抱怨，匿名讀得到的時候根本不該走到那裡。
|
||||
tok = token() if callable(token) else token
|
||||
if not tok:
|
||||
return None
|
||||
try:
|
||||
text = get({"Authorization": "token " + tok}) # private repo：帶 token 再問一次
|
||||
except Exception:
|
||||
return None
|
||||
except Exception:
|
||||
return None
|
||||
try:
|
||||
return _valid(json.loads(text))
|
||||
except Exception:
|
||||
return None
|
||||
return d
|
||||
|
||||
|
||||
def load():
|
||||
|
||||
@@ -91,21 +91,31 @@ def _classify(tokens, verbs=("push",), strip_env=False):
|
||||
stays deliberately loose here (the verb may sit anywhere after `git`) --
|
||||
callers re-walk the returned token list to confirm command position, so
|
||||
a false positive at this layer costs nothing."""
|
||||
body = tokens
|
||||
if strip_env:
|
||||
# `FOO=1 git checkout …` -- an env prefix doesn't change which command
|
||||
# runs. Opt-in so find_push_target's behaviour stays byte-identical;
|
||||
# checkout_target_dir.py turns it on (its predecessor stripped these,
|
||||
# and dropping that would have been a silent regression -- caught by
|
||||
# the worktree gate's own case ㉒).
|
||||
#
|
||||
# 2026-09-07 (inkstone/ISEP#109 -> comment 6587): the prefix is skipped
|
||||
# for *classifying* the statement, but the "verb" event hands back the
|
||||
# full token list, prefix included. The worktree gate's escape hatch is
|
||||
# exactly that prefix (`WORKTREE_OK=1 git checkout …`), and a PreToolUse
|
||||
# hook can only see it in the command string -- it never reaches the
|
||||
# hook's own environment. Dropping it here made the printed way out
|
||||
# unwalkable. Callers that don't care simply skip leading NAME=value
|
||||
# tokens themselves (checkout_target_dir._moves_head does).
|
||||
i = 0
|
||||
while i < len(tokens) and _ENV_ASSIGN.match(tokens[i]):
|
||||
i += 1
|
||||
tokens = tokens[i:]
|
||||
if not tokens:
|
||||
body = tokens[i:]
|
||||
if not body:
|
||||
return ("other", None)
|
||||
if tokens[0] == "cd" and len(tokens) > 1:
|
||||
return ("cd", tokens[1])
|
||||
if tokens[0] == "git" and any(v in tokens[1:] for v in verbs):
|
||||
if body[0] == "cd" and len(body) > 1:
|
||||
return ("cd", body[1])
|
||||
if body[0] == "git" and any(v in body[1:] for v in verbs):
|
||||
return ("verb", tokens)
|
||||
return ("other", None)
|
||||
|
||||
|
||||
@@ -0,0 +1,220 @@
|
||||
"""release_chain — ISEP 運送鏈「tag → release」那兩站的**收貨端事實**，一份定義三處用
|
||||
（inkstone/ISEP#67）
|
||||
|
||||
誰在用：
|
||||
scripts/release-ship 送貨：把已推的 tag 建成 release（前置條件從這裡問）
|
||||
scripts/release-check 覆核：逐版問 Gitea「到了嗎」
|
||||
hooks/lib/beacon_report.py 開場：SessionStart 報「打了 tag 卻沒 release」
|
||||
|
||||
🔴 為什麼收成一份：09-05 那版 release-ship／release-check 各自抄了一套「問 Gitea」
|
||||
的程式碼；要再讓 SessionStart 也問一次，就是第三份。同一個判準散在三處，
|
||||
修一份不會帶動另外兩份——`leo21c-write-guard.sh` 那一族就是這樣漂掉的
|
||||
（system-dev/wiki/mistakes.md 2026-09-07）。
|
||||
|
||||
🔴 讀一律匿名（D20：讀不帶憑證＝自由、不計次）。inkstone/ISEP 是公開 repo，
|
||||
tags／releases／某個 tag 底下的檔案／兩個 tag 之間的 commit 都不需要 token。
|
||||
只有 401／403 才退回帶 token 再試一次；token 只有 POST（建 release）才是必要的。
|
||||
|
||||
判準是結構不是關鍵字：某一版「送到了沒」＝它的 tag 與 release **在不在** Gitea 上。
|
||||
|
||||
離線：每個入口各自把 fixture dict 傳進來（鍵：tags／releases／manifest／commits），
|
||||
不打網路。fixture 的形狀在 `Chain.__init__` 的註解。
|
||||
"""
|
||||
import base64
|
||||
import json
|
||||
import os
|
||||
import re
|
||||
import subprocess
|
||||
import urllib.error
|
||||
import urllib.request
|
||||
|
||||
DEFAULT_HOST = "https://git.uncle6.me"
|
||||
DEFAULT_REPO = "inkstone/ISEP"
|
||||
MANIFEST_PATH = ".claude-plugin/plugin.json"
|
||||
|
||||
# 運送鏈的三站：鍵、人話、怎麼補（補法的指令由呼叫端決定要不要換成絕對路徑）
|
||||
STATIONS = [
|
||||
("dingban", "定版 commit",
|
||||
"在 main 上 commit 一顆 `定版 v{v}`（＝ plugin.json 也改成那一版）"),
|
||||
("tag", "tag（Gitea）",
|
||||
"打並推 tag：`git tag v{v} && git push origin v{v}`"),
|
||||
("release", "release（Gitea）",
|
||||
"建 release：`{ship} v{v}`（這一站就是最常斷的那站）"),
|
||||
]
|
||||
|
||||
|
||||
class ChainError(Exception):
|
||||
"""問不到收貨端（網路／HTTP 非 404）。呼叫端自己決定要死還是要閉嘴。"""
|
||||
|
||||
|
||||
def vtuple(v):
|
||||
nums = re.findall(r"\d+", v or "")
|
||||
return tuple(int(x) for x in nums[:3]) if nums else (0,)
|
||||
|
||||
|
||||
def tagname(v):
|
||||
v = (v or "").strip()
|
||||
return v if v.startswith("v") else "v" + v
|
||||
|
||||
|
||||
def token_from_env_or_remote(host, root=None):
|
||||
"""建 release 才用得到。環境變數優先；沒有就從 remote URL 裡撈（bootstrap 會帶）。"""
|
||||
for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
|
||||
if os.environ.get(env):
|
||||
return os.environ[env]
|
||||
if not root:
|
||||
return ""
|
||||
h = host.split("//")[-1].rstrip("/")
|
||||
try:
|
||||
out = subprocess.run(["git", "-C", root, "remote", "-v"],
|
||||
capture_output=True, text=True, timeout=20).stdout
|
||||
except Exception:
|
||||
out = ""
|
||||
for line in out.splitlines():
|
||||
if h in line:
|
||||
m = re.search(r"//[^:/]+:([^@]+)@", line)
|
||||
if m:
|
||||
return m.group(1)
|
||||
return ""
|
||||
|
||||
|
||||
class Chain:
|
||||
"""一個 repo 的運送鏈收貨端。
|
||||
|
||||
fixture（離線用）的形狀：
|
||||
{"tags": ["v0.24.0", ...],
|
||||
"releases": ["v0.23.0", ...],
|
||||
"manifest": {"v0.24.0": "0.24.0", ...}, # 那個 tag 底下 plugin.json 的 version
|
||||
"commits": {"v0.23.0...v0.24.0": ["定版 v0.24.0（…）", "..."], # 兩 tag 之間的 commit 標題
|
||||
"v0.24.0": ["…"]}} # 沒有上一個 release 時
|
||||
"""
|
||||
|
||||
def __init__(self, host=None, repo=None, fixture=None, timeout=25, token=None):
|
||||
self.host = (host or DEFAULT_HOST).rstrip("/")
|
||||
self.repo = repo or DEFAULT_REPO
|
||||
self.fx = fixture
|
||||
self.timeout = timeout
|
||||
self.token = token
|
||||
|
||||
# ── HTTP：匿名優先 ───────────────────────────────────────────────────
|
||||
def _get(self, path, params=""):
|
||||
url = "%s/api/v1/repos/%s/%s%s" % (self.host, self.repo, path, params)
|
||||
headers = {"Cache-Control": "no-cache"} # 09-05 實撞：邊緣快取的舊值被當 live
|
||||
for attempt in (0, 1):
|
||||
if attempt == 1:
|
||||
if not self.token:
|
||||
raise ChainError("Gitea 對匿名讀回 401／403，而這裡沒有 token：%s" % url)
|
||||
headers["Authorization"] = "token " + self.token
|
||||
req = urllib.request.Request(url, headers=headers)
|
||||
try:
|
||||
with urllib.request.urlopen(req, timeout=self.timeout) as r:
|
||||
return json.load(r)
|
||||
except urllib.error.HTTPError as e:
|
||||
if e.code == 404:
|
||||
return None
|
||||
if e.code in (401, 403) and attempt == 0:
|
||||
continue
|
||||
raise ChainError("Gitea %s：%s %s" % (e.code, url, e.read().decode()[:200]))
|
||||
except Exception as e:
|
||||
raise ChainError("連不上 %s：%s" % (url, e))
|
||||
return None
|
||||
|
||||
def _names(self, path, key):
|
||||
names, page = set(), 1
|
||||
while True:
|
||||
rows = self._get(path, "?limit=50&page=%d" % page) or []
|
||||
for r in rows:
|
||||
n = r.get(key)
|
||||
if n:
|
||||
names.add(n)
|
||||
if len(rows) < 50:
|
||||
return names
|
||||
page += 1
|
||||
|
||||
# ── 收貨端事實 ───────────────────────────────────────────────────────
|
||||
def tags(self):
|
||||
if self.fx is not None:
|
||||
return set(self.fx.get("tags") or [])
|
||||
return self._names("tags", "name")
|
||||
|
||||
def releases(self):
|
||||
if self.fx is not None:
|
||||
return set(self.fx.get("releases") or [])
|
||||
return self._names("releases", "tag_name")
|
||||
|
||||
def release(self, tag):
|
||||
"""這個 tag 的 release（dict），沒有就 None。"""
|
||||
if self.fx is not None:
|
||||
return {"tag_name": tag, "html_url": "(fixture)"} if tag in self.releases() else None
|
||||
return self._get("releases/tags/%s" % tag)
|
||||
|
||||
def manifest_version_at(self, tag):
|
||||
"""那個 tag 的樹裡 plugin.json 宣稱的版本（None ＝ tag 不在或檔案不在）。
|
||||
|
||||
🔴 這是 release-ship 前置①的對象：**要建 release 的那個 tag 的樹**，
|
||||
不是「現在 checkout 出來的工作樹」——工作樹可能是任何分支，跟那個 tag 無關。
|
||||
"""
|
||||
if self.fx is not None:
|
||||
return (self.fx.get("manifest") or {}).get(tag)
|
||||
d = self._get("contents/%s" % MANIFEST_PATH, "?ref=%s" % tag)
|
||||
if not d:
|
||||
return None
|
||||
try:
|
||||
raw = base64.b64decode(d.get("content") or "").decode("utf-8")
|
||||
return (json.loads(raw) or {}).get("version")
|
||||
except Exception:
|
||||
return None
|
||||
|
||||
def commits_between(self, base, head):
|
||||
"""base（可 None）到 head 之間的 commit 標題，**不含 merge commit**，舊在前。"""
|
||||
key = ("%s...%s" % (base, head)) if base else head
|
||||
if self.fx is not None:
|
||||
return list((self.fx.get("commits") or {}).get(key) or [])
|
||||
if base:
|
||||
d = self._get("compare/%s...%s" % (base, head)) or {}
|
||||
rows = d.get("commits") or []
|
||||
else:
|
||||
rows = self._get("commits", "?sha=%s&limit=50&stat=false&verification=false&files=false" % head) or []
|
||||
rows = list(reversed(rows))
|
||||
out = []
|
||||
for c in rows:
|
||||
if len(c.get("parents") or []) > 1:
|
||||
continue
|
||||
msg = ((c.get("commit") or {}).get("message") or "").strip()
|
||||
if msg:
|
||||
out.append(msg.splitlines()[0])
|
||||
return out
|
||||
|
||||
def tag_commit_message(self, tag):
|
||||
"""tag 指到的那顆 commit 的完整訊息（取 `定版 vX（人話）` 用）。"""
|
||||
if self.fx is not None:
|
||||
for lines in (self.fx.get("commits") or {}).values():
|
||||
for line in lines:
|
||||
if "定版" in line and tag.lstrip("v") in line:
|
||||
return line
|
||||
return ""
|
||||
t = self._get("tags/%s" % tag)
|
||||
sha = ((t or {}).get("commit") or {}).get("sha")
|
||||
if not sha:
|
||||
return ""
|
||||
c = self._get("git/commits/%s" % sha) or {}
|
||||
return ((c.get("commit") or {}).get("message") or "")
|
||||
|
||||
# ── 判準 ─────────────────────────────────────────────────────────────
|
||||
def latest_release_before(self, ver, releases=None):
|
||||
rels = releases if releases is not None else self.releases()
|
||||
older = [t for t in rels if vtuple(t) < vtuple(ver)]
|
||||
return max(older, key=vtuple) if older else None
|
||||
|
||||
|
||||
def gaps(ver, tags, releases, dingban=True):
|
||||
"""某一版缺哪幾站 → [(key, label, fix_template)]，按運送順序。空 list ＝ 都在。"""
|
||||
t = tagname(ver)
|
||||
present = {"dingban": dingban, "tag": t in tags, "release": t in releases}
|
||||
return [(k, label, fix) for k, label, fix in STATIONS if not present[k]]
|
||||
|
||||
|
||||
def dingban_title(message, ver):
|
||||
"""從 `定版 vX.Y.Z（一句人話）` 抓括號那句——leo 既有 release 的命名慣例。"""
|
||||
m = re.search(r"定版\s+v?%s[（(]([^）)]+)[）)]" % re.escape(ver.lstrip("v")), message or "")
|
||||
return m.group(1).strip() if m else None
|
||||
@@ -1,7 +1,12 @@
|
||||
#!/usr/bin/env bash
|
||||
# 管什麼: 一條派工線要在「共用的工作目錄」裡切分支時擋下來，叫它去開一份自己的 worktree。
|
||||
# 為什麼: 2026-08-29 inkstone/ISEP#109 comment 5391——每個 repo 只有一份工作目錄，所有線共用。#163 切到自己的分支、交回時沒切回來，總管後來在同一個目錄跑 ship.mjs，讀到的是別人留下的 HEAD。票號說得出「這是哪個任務」，沒有任何東西說得出「這個目錄現在是誰留下的狀態」。
|
||||
# 誤觸時怎麼關: `WORKTREE_OK=1 git checkout …`（留痕，跟 NOT_MY_BRANCH_OK 同形狀）。
|
||||
# 誤觸時怎麼關: `WORKTREE_OK=1 git checkout …`——認的是**指令字串裡**這個字面前綴（留痕就在指令歷史上）。
|
||||
# 🔴 2026-09-07（inkstone/ISEP#109 → comment 6587）：舊版讀的是 hook 自己的環境變數 `$WORKTREE_OK`，
|
||||
# 而 PreToolUse hook 跟指令不是同一個行程——指令前綴的賦值到不了它 ⇒ 閘印出來的出路在 Claude Code
|
||||
# 底下永遠走不通（總管三次照貼三次被擋）。現在兩種都認：環境變數（本機 shell export 過）與字面前綴
|
||||
# （閘訊息教的那一行）。判準是位置不是字：前綴必須掛在會移動 HEAD 的那條 git 指令上，見
|
||||
# lib/checkout_target_dir.py 檔頭；測試 E 群把閘印出來的那一行原樣餵回去驗它走得通。
|
||||
#
|
||||
# line-needs-own-worktree.sh — 共用工作目錄裡不准切分支（PreToolUse: Bash）
|
||||
#
|
||||
@@ -74,6 +79,13 @@ sys.stdout.write((ti.get("command") or "") if isinstance(ti, dict) else "")
|
||||
' 2>/dev/null) || exit 0
|
||||
[ -n "${CMD:-}" ] || exit 0
|
||||
|
||||
# heredoc 的 body 是資料不是指令（inkstone/ISEP#125 缺陷 D／E，2026-09-02 兩次實地命中）：
|
||||
# 用 heredoc 寫一份「內含 `cd <目錄> && git checkout X` 示範」的說明文件，整條指令沒有任何
|
||||
# git 操作，卻被當成在切分支擋下——被擋的是「寫文件」這個動作。跟 github-contact-guard 一樣
|
||||
# 先把 body 剝掉再解析；剝不動就用原字串（fail-open 的是「這支 helper 有沒有跑」，不是判準）。
|
||||
CMD=$(printf '%s' "$CMD" | python3 "$(dirname "$0")/lib/strip_heredoc.py" 2>/dev/null || printf '%s' "$CMD")
|
||||
[ -n "${CMD:-}" ] || exit 0
|
||||
|
||||
CWD=$(printf '%s' "$PAYLOAD" | python3 -c '
|
||||
import json, sys
|
||||
try:
|
||||
@@ -96,6 +108,11 @@ EXPR=$(printf '%s' "$CMD" | python3 "$RESOLVER" 2>/dev/null) || exit 0
|
||||
[ -n "${EXPR:-}" ] || exit 0 # 沒有會移動 HEAD 的 checkout/switch
|
||||
[ "$EXPR" = "?" ] && exit 0 # 目錄解不出來（cd $VAR / cd -）⇒ 不猜，見該檔檔頭
|
||||
|
||||
# 出路：那條 checkout 自己帶著 `WORKTREE_OK=1` 前綴 ⇒ 放行（comment 6587）。
|
||||
# 看的是指令字串裡的位置，不是 hook 的環境——hook 的環境裡永遠不會有它。
|
||||
ESC=$(printf '%s' "$CMD" | python3 "$RESOLVER" --escape WORKTREE_OK=1 2>/dev/null) || ESC=""
|
||||
[ "${ESC:-}" = "1" ] && exit 0
|
||||
|
||||
TARGET=$(cd "$CWD" 2>/dev/null && cd "$EXPR" 2>/dev/null && pwd) || exit 0
|
||||
[ -n "${TARGET:-}" ] || exit 0
|
||||
|
||||
|
||||
@@ -24,6 +24,7 @@ mkplugin() {
|
||||
> "$d/hooks/hooks.json"
|
||||
cp "$HOOK" "$d/hooks/$(basename "$HOOK")"
|
||||
cp "$REAL_HOOKS/lib/beacon_report.py" "$d/hooks/lib/beacon_report.py"
|
||||
cp "$REAL_HOOKS/lib/release_chain.py" "$d/hooks/lib/release_chain.py"
|
||||
printf '#!/bin/sh\necho real\n' > "$d/scripts/ticket"
|
||||
# inkstone/ISEP#122：會自動載入的東西（skill／command／agent）也要造得出來
|
||||
mkdir -p "$d/skills/demo" "$d/commands" "$d/agents" "$d/docs"
|
||||
@@ -190,6 +191,43 @@ out=$(run "$P2" "$JS")
|
||||
check "㉖ ②b 有報告時，那行綠色信標仍在且 JSON 合法" "$out" \
|
||||
"🟢 ISEP v1.0.0 已載入" "!__BADJSON__"
|
||||
|
||||
echo "── ④打了 tag 卻沒 release（inkstone/ISEP#67 → 6574）──────────────────"
|
||||
# 🔴 這一組守的是 09-07 那件：v0.23.0／v0.24.0 tag 都推了、Releases 頁停在 v0.22.0，
|
||||
# 交棒給 leo 的測試位置打開是一頁空 tag。開場要說「缺哪一站＋怎麼補」，都在時安靜。
|
||||
P4=$(mkplugin 0.24.0); printf '#!/usr/bin/env python3\n' > "$P4/scripts/release-ship"
|
||||
FX4="$TMP/chain-gap.json"
|
||||
printf '{"tags":["v0.24.0","v0.23.0"],"releases":["v0.23.0"]}\n' > "$FX4"
|
||||
out=$(ISEP_BEACON_CHAIN_FIXTURE="$FX4" run "$P4" "$J")
|
||||
check "㉗ 最新 tag v0.24.0 沒有 release → 一行說缺哪一站＋怎麼補（正本絕對路徑）" "$out" \
|
||||
"v0.24.0 送到一半" "缺 release（Gitea）" "python3 $P4/scripts/release-ship v0.24.0" "inkstone/ISEP#67"
|
||||
check "㉘ 信標那一行仍在、JSON 合法" "$out" "🟢 ISEP v0.24.0 已載入" "!__BADJSON__"
|
||||
|
||||
FX4b="$TMP/chain-ok.json"
|
||||
printf '{"tags":["v0.24.0","v0.23.0"],"releases":["v0.24.0","v0.23.0"]}\n' > "$FX4b"
|
||||
out=$(ISEP_BEACON_CHAIN_FIXTURE="$FX4b" run "$P4" "$J")
|
||||
check "㉙ tag 與 release 都在 → 一個字都不說（天天念會被學會忽略）" "$out" "!送到一半" "!缺 release"
|
||||
|
||||
out=$(run "$P4" "$J")
|
||||
check "㉚ 問不到收貨端（沒網路、沒 fixture）→ 閉嘴，不猜" "$out" "!送到一半" "🟢 ISEP v0.24.0 已載入"
|
||||
|
||||
out=$(ISEP_FAKE_MAIN_VERSION=0.25.0 ISEP_BEACON_CHAIN_FIXTURE="$FX4b" run "$P4" "$J")
|
||||
check "㉛ main 定版到 0.25.0、Gitea 最新 tag 還是 v0.24.0 → 說缺 tag 站＋push tag 的補法" "$out" \
|
||||
"v0.25.0 送到一半" "缺 tag（Gitea）" "git push origin v0.25.0"
|
||||
|
||||
P4o=$(mkplugin 0.21.0) # 載入的這一份還沒有 scripts/release-ship（舊版）
|
||||
out=$(ISEP_BEACON_CHAIN_FIXTURE="$FX4" run "$P4o" "$J")
|
||||
check "㉜ 載入的這一份還沒有 release-ship → 補法先教 plugin update，不印一條不存在的路徑" "$out" \
|
||||
"v0.24.0 送到一半" "claude plugin update isep@inkstone" "!python3 $P4o/scripts/release-ship"
|
||||
|
||||
# 只快取「都在」：缺件那次不留快取，補完的下一個 session 立刻安靜；都在那次留快取
|
||||
rm -f "$TMP"/.isep-chain-ok-*
|
||||
out=$(ISEP_BEACON_CHAIN_FIXTURE="$FX4" run "$P4" "$J")
|
||||
[ ! -e "$TMP/.isep-chain-ok-v0.24.0" ] && r1=1 || r1=0
|
||||
out=$(ISEP_BEACON_CHAIN_FIXTURE="$FX4b" run "$P4" "$J")
|
||||
[ -e "$TMP/.isep-chain-ok-v0.24.0" ] && r2=1 || r2=0
|
||||
N=$((N+1)); if [ "$r1$r2" = "11" ]; then printf ' ✅ ㉝ 缺件不快取、都在才快取（補完下一個 session 就安靜）\n'; PASS=$((PASS+1))
|
||||
else printf ' ❌ ㉝ 快取方向錯了（缺件留了快取=%s／都在沒留=%s）\n' "$((1-r1))" "$((1-r2))"; FAIL=$((FAIL+1)); fi
|
||||
|
||||
echo
|
||||
printf '通過 %s 條，失敗 %s 條（共 %s 條）\n' "$PASS" "$FAIL" "$N"
|
||||
[ "$FAIL" = 0 ] || exit 1
|
||||
|
||||
@@ -213,6 +213,78 @@ else
|
||||
printf ' ❌ (59) lib/checkout_target_dir.py 不見了\n'; FAIL=$((FAIL+1))
|
||||
fi
|
||||
|
||||
echo
|
||||
echo "── E 群：出路要真的走得通（inkstone/ISEP#109 → comment 6587，2026-09-07 實撞）──"
|
||||
# 為什麼這群非有不可：閘訊息教的出路是 `WORKTREE_OK=1 git -C … checkout …`，
|
||||
# 而舊版讀的是 **hook 自己的環境變數**。PreToolUse hook 在指令執行之前跑，
|
||||
# 指令字串裡的 `WORKTREE_OK=1` 是給 git 的前綴賦值，hook 的行程裡根本沒有它
|
||||
# ⇒ 那條出路在 Claude Code 這個 harness 下永遠走不通（總管當天三次照貼三次被擋）。
|
||||
# 🔴 這群的測資是「閘自己印出來的那一行」，原樣餵回去——驗的是出路跑不跑得動，
|
||||
# 不是閘擋不擋（mistakes.md「閘擋對了，但它印出來的那條出路跑不動」）。
|
||||
# 判準是**位置**不是字：那個賦值必須是「會移動 HEAD 的那條 git 指令」自己的前綴。
|
||||
|
||||
t 0 "(60) 指令字串裡帶 WORKTREE_OK=1 前綴、hook 的環境裡**沒有**它 ⇒ 放行" \
|
||||
"WORKTREE_OK=1 git checkout -b feat/esc" "$REPO"
|
||||
t 2 "(61) 先擋一次，拿它印出來的出路當下一條的測資" "git checkout main" "$REPO"
|
||||
ESC_LINE=$(printf '%s' "$LAST_ERR" | grep -F 'WORKTREE_OK=1 git -C' | head -1 | sed 's/^[[:space:]]*//; s/<分支>/main/')
|
||||
N=$((N+1))
|
||||
if [ -n "$ESC_LINE" ]; then printf ' ✅ (62) 抽得出那一行：%s\n' "$ESC_LINE"; PASS=$((PASS+1))
|
||||
else printf ' ❌ (62) 訊息裡抽不出 WORKTREE_OK=1 git -C … 那一行\n'; FAIL=$((FAIL+1)); ESC_LINE="WORKTREE_OK=1 git -C $REPO checkout main"; fi
|
||||
t 0 "(63) 閘印出來的那一行**原樣餵回去**（只填分支、人站在別處）⇒ 放行——6587 那天走不通的就是這條" \
|
||||
"$ESC_LINE" "$PLAIN"
|
||||
t 2 "(64) 只是印了那個字：echo WORKTREE_OK=1; git checkout main ⇒ 照擋（看位置不看字）" \
|
||||
"echo WORKTREE_OK=1; git checkout main"
|
||||
t 2 "(65) 前綴掛在別的指令上：WORKTREE_OK=1 echo hi && git checkout main ⇒ 照擋" \
|
||||
"WORKTREE_OK=1 echo hi && git checkout main"
|
||||
t 2 "(66) 值不是 1：WORKTREE_OK=0 git checkout main ⇒ 照擋" \
|
||||
"WORKTREE_OK=0 git checkout main"
|
||||
t 2 "(67) 寫在 commit 訊息裡再切 ⇒ 照擋（引號裡的字不是前綴）" \
|
||||
"git commit -qm 'WORKTREE_OK=1 git checkout main' ; git checkout main"
|
||||
t 0 "(68) cd 進去再掛前綴：cd <repo> && WORKTREE_OK=1 git checkout main ⇒ 放行" \
|
||||
"cd $REPO && WORKTREE_OK=1 git checkout main" "$PLAIN"
|
||||
t 0 "(69) 在自己的 worktree 裡也掛了前綴 ⇒ 本來就放行，前綴不礙事" \
|
||||
"WORKTREE_OK=1 git checkout -b feat/x2" "$OWN"
|
||||
|
||||
echo
|
||||
echo "── F 群：inkstone/ISEP#125 驗收表 A–F（票上原文的六條，期望值照票）──"
|
||||
# A 逃生門原文照打→0 B 環境變數裡真的有→0 C 文件裡只寫 'git checkout X'→0
|
||||
# D 文件裡寫 'cd <目錄> && git checkout X'→0 E 同 D 角括號拿掉→0 F 真的要切→2（本體，退化成 0＝閘廢了）
|
||||
t 0 "(70) #125-A 逃生門原文照打：WORKTREE_OK=1 git -C <TOP> checkout main ⇒ 0" \
|
||||
"WORKTREE_OK=1 git -C $REPO checkout main" "$PLAIN"
|
||||
t 0 "(71) #125-B 同一句、WORKTREE_OK 真的在 hook 的環境裡 ⇒ 0（本來就是，不要弄壞）" \
|
||||
"git -C $REPO checkout main" "$PLAIN" "CLAUDE_CODE_CHILD_SESSION=1 WORKTREE_OK=1"
|
||||
DOC_C="cat > $ROOT/doc-c.md <<'EOF'
|
||||
把 repo 複製一份，然後 git checkout X
|
||||
EOF
|
||||
echo written"
|
||||
t 0 "(72) #125-C 文件裡只寫 'git checkout X' ⇒ 0" "$DOC_C"
|
||||
DOC_D="cat > $ROOT/doc-d.md <<'EOF'
|
||||
示範：cd <目錄> && git checkout X
|
||||
EOF
|
||||
echo written"
|
||||
t 0 "(73) #125-D 文件裡寫 'cd <目錄> && git checkout X' ⇒ 0（寫文件不是執行；09-02 兩次實地命中）" "$DOC_D"
|
||||
DOC_E="cat > $ROOT/doc-e.md <<'EOF'
|
||||
示範：cd $REPO && git checkout feat/x
|
||||
EOF
|
||||
echo written"
|
||||
t 0 "(74) #125-E 同 D、角括號拿掉、目錄是真的共用目錄 ⇒ 0" "$DOC_E"
|
||||
t 2 "(75) #125-F 真的要切（對照組）⇒ 2 🔴 本體，退化成 0＝閘廢了" "cd $REPO && git checkout feat/x" "$PLAIN"
|
||||
# 🔴 已知邊界，寫成測試而不是註解（跟 (53) 同一層、同一個病）：tokenize 層把**換行**當空白吞掉，
|
||||
# 多行指令被併成一句 ⇒ `echo hi⏎git checkout main` 從第一版起就看不到（舊閘實測 exit=0，
|
||||
# 同一句改成 `echo hi; git checkout main` 就擋）。剝 heredoc 沒有讓它變好也沒有變壞——
|
||||
# body 剝掉之後留下的仍是「換行分隔的兩句」。要修得動那層，會連帶改到推 main 那道閘的偵測範圍
|
||||
# ⇒ 不在本票裡動（另報）。這條紅了＝那層被改了，回頭看 (53) 與推 main 的 10＋19 條。
|
||||
t 0 "(76) 已知邊界：heredoc 之後**換行**再真的切 ⇒ 這道閘看不到（漏擋，不是誤攔；(53) 同層）" \
|
||||
"cat > $ROOT/doc-f.md <<'EOF'
|
||||
只是文件
|
||||
EOF
|
||||
git checkout main"
|
||||
t 2 "(77) 同一句換成分號：cat <<'EOF' … EOF; git checkout main ⇒ 照擋（剝掉的只有 body）" \
|
||||
"cat > $ROOT/doc-g.md <<'EOF'
|
||||
只是文件
|
||||
EOF
|
||||
; git checkout main"
|
||||
|
||||
clean
|
||||
echo
|
||||
echo "══ $PASS/$N 通過${FAIL:+，$FAIL 個失敗} ══"
|
||||
|
||||
Executable
+192
@@ -0,0 +1,192 @@
|
||||
#!/usr/bin/env bash
|
||||
# 主線第三個來源「Gitea main 上那份」的迴歸測試（inkstone/ISEP#140）
|
||||
#
|
||||
# ── 這支在守什麼 ──────────────────────────────────────────────────────
|
||||
# 雲端薄殼 `youlinhsieh/inkstoneco` 的 SessionStart 跑在 `bootstrap.sh` 之前：
|
||||
# `InkStoneCo/` 還沒 clone、家目錄又是空的 ⇒ 兩份主線檔都不存在 ⇒ `countdown.py` 退到
|
||||
# 「期限最近的 milestone」⇒ 第一則 prompt 印一條兩週前的舊線（票上實測：逾期 341 小時）。
|
||||
# 解法：`scripts/mainline refresh`（SessionStart）在兩份都不在時去 Gitea 讀
|
||||
# `inkstone/InkStoneCo` main 的 `system-dev/mainline.json` 一次、寫進家目錄。這裡驗：
|
||||
# A 薄殼形狀（兩份都沒有）＋ Gitea 讀得到 ⇒ refresh 之後第一則 prompt 的 ⏱／🎯 就是那條線
|
||||
# B 匿名優先；InkStoneCo 是 private ⇒ 匿名 404 後有 token 才帶 token 再問一次，沒 token 就退回
|
||||
# C 家目錄或 repo 那份任一在場 ⇒ 不問 Gitea（優先序：家目錄 ＞ repo ＞ Gitea）
|
||||
# D 讀不到（5xx／不是 JSON／沒 title／掛住／連不上／被關掉）⇒ 退回現行行為，不掛、逾時有上限
|
||||
# E 抓到之後 bootstrap 才出現的 repo 那份，跟 ISEP#130 的 set_at 規則接得起來
|
||||
# F `load()`／UserPromptSubmit 那條路照舊零網路
|
||||
#
|
||||
# 用法：bash hooks/tests/mainline-gitea-fallback.test.sh
|
||||
# 🔴 全程離線：Gitea 是本機一個假伺服器（TICKET_HOST 指過去），它照真 Gitea 回：
|
||||
# public 時 raw 端點匿名 200；private 時匿名 404、帶 token 200（真 InkStoneCo 就是 private）。
|
||||
# 狀態走 ISEP_COUNTDOWN_STATE_DIR、repo 那份走 TMP 底下的假薄殼。不碰真家目錄、不碰真 Gitea。
|
||||
set -u
|
||||
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
MAINLINE="$ROOT/../scripts/mainline"
|
||||
HOOK="$ROOT/countdown-guard.sh"
|
||||
TMP=$(mktemp -d)
|
||||
export ISEP_COUNTDOWN_STATE_DIR="$TMP/home-state"; mkdir -p "$ISEP_COUNTDOWN_STATE_DIR"
|
||||
export ISEP_COUNTDOWN_NOW=1757203200 # 2026-09-07 00:00 UTC，讓主線那段「剩 X」穩定
|
||||
export ISEP_MAINLINE_GITEA_TIMEOUT=1
|
||||
unset ISEP_MAINLINE_REPO_FILE ISEP_MAINLINE_FIXTURE ISEP_MAINLINE_GITEA_URL ISEP_MILESTONE_DUE ISEP_MILESTONE_NAME
|
||||
unset GITEA_TOKEN_CLAUDE_CODE GITEA_TOKEN
|
||||
SHELL_ROOT="$TMP/shell"; mkdir -p "$SHELL_ROOT" # 薄殼根：沒有 InkStoneCo/，也不是 git repo
|
||||
PASS=0; FAIL=0
|
||||
ok(){ printf ' ✅ %s\n' "$1"; PASS=$((PASS+1)); }
|
||||
no(){ printf ' ❌ %s —— %s\n' "$1" "$2"; FAIL=$((FAIL+1)); }
|
||||
|
||||
# ── 假 Gitea：模式從 $TMP/mode 讀，每個請求記一行 `path|auth` 到 $TMP/log ──
|
||||
cat > "$TMP/stub.py" <<'PY'
|
||||
import json, os, sys, time
|
||||
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
|
||||
TMP = sys.argv[1]; PORT = int(sys.argv[2])
|
||||
RAW = "/api/v1/repos/inkstone/InkStoneCo/raw/system-dev/mainline.json"
|
||||
DOC = {"ref": "inkstone/Arcrun#48", "owner": "inkstone", "repo": "Arcrun", "id": 48,
|
||||
"title": "Gitea 上那條現在的主線", "description": "測試用。", "due_on": "2026-09-12T23:59:59Z",
|
||||
"open_issues": 3, "closed_issues": 0, "members": ["inkstone/ISEP#140"],
|
||||
"set_at": "2026-09-07 07:30", "refreshed_at": "2026-09-07 08:18"}
|
||||
class H(BaseHTTPRequestHandler):
|
||||
def log_message(self, *a): pass
|
||||
def _send(self, code, body=b"", ctype="application/json"):
|
||||
self.send_response(code); self.send_header("Content-Type", ctype)
|
||||
self.send_header("Content-Length", str(len(body))); self.end_headers(); self.wfile.write(body)
|
||||
def do_GET(self):
|
||||
mode = open(os.path.join(TMP, "mode")).read().strip()
|
||||
auth = "auth" if self.headers.get("Authorization") else "anon"
|
||||
with open(os.path.join(TMP, "log"), "a") as f: f.write("%s|%s\n" % (self.path.split("?")[0], auth))
|
||||
if not self.path.startswith(RAW):
|
||||
return self._send(404, b'{"message":"Not found."}')
|
||||
if mode == "public": return self._send(200, json.dumps(DOC, ensure_ascii=False).encode())
|
||||
if mode == "private":
|
||||
if auth == "auth": return self._send(200, json.dumps(DOC, ensure_ascii=False).encode())
|
||||
return self._send(404, b"Not found.", "text/plain") # 真 Gitea 對 private repo 就回 404
|
||||
if mode == "500": return self._send(500, b"boom")
|
||||
if mode == "garbage": return self._send(200, b"<html>not json</html>", "text/html")
|
||||
if mode == "notitle": return self._send(200, b'{"ref":"x","set_at":"2026-09-07 07:30"}')
|
||||
if mode == "hang":
|
||||
time.sleep(8); return self._send(200, json.dumps(DOC).encode())
|
||||
return self._send(500, b"unknown mode")
|
||||
srv = ThreadingHTTPServer(("127.0.0.1", PORT), H); srv.daemon_threads = True; srv.serve_forever() # 掛住的那筆不准堵住後面的請求
|
||||
PY
|
||||
PORT=$(python3 -c "import socket;s=socket.socket();s.bind(('127.0.0.1',0));print(s.getsockname()[1])")
|
||||
echo public > "$TMP/mode"; : > "$TMP/log"
|
||||
python3 "$TMP/stub.py" "$TMP" "$PORT" & SRV=$!
|
||||
trap 'kill $SRV 2>/dev/null; rm -rf "$TMP"' EXIT
|
||||
for _ in $(seq 1 50); do python3 -c "import socket;socket.create_connection(('127.0.0.1',$PORT),1)" 2>/dev/null && break; sleep 0.1; done
|
||||
export TICKET_HOST="http://127.0.0.1:$PORT"
|
||||
|
||||
refresh(){ CLAUDE_PROJECT_DIR="$SHELL_ROOT" python3 "$MAINLINE" refresh >"$TMP/refresh.out" 2>"$TMP/refresh.err"; echo $?; }
|
||||
show(){ CLAUDE_PROJECT_DIR="$SHELL_ROOT" python3 "$MAINLINE" 2>&1 | head -1; }
|
||||
inject(){ # 第一則 prompt：UserPromptSubmit 給 countdown-guard.sh，回 additionalContext
|
||||
printf '{"hook_event_name":"UserPromptSubmit","session_id":"s140","transcript_path":""}' \
|
||||
| CLAUDE_PROJECT_DIR="$SHELL_ROOT" bash "$HOOK" 2>/dev/null \
|
||||
| python3 -c 'import json,sys
|
||||
try: print(json.load(sys.stdin)["hookSpecificOutput"]["additionalContext"])
|
||||
except Exception: print("")'
|
||||
}
|
||||
raw_hits(){ grep -c '/raw/system-dev/mainline.json|' "$TMP/log" 2>/dev/null || true; }
|
||||
reset(){ rm -f "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" "$ISEP_COUNTDOWN_STATE_DIR/milestone-due"; rm -rf "$SHELL_ROOT/InkStoneCo"; : > "$TMP/log"; }
|
||||
|
||||
echo "── A. 薄殼形狀（兩份都沒有）＋ Gitea 讀得到 ⇒ 第一則 prompt 就是現在的主線 ──"
|
||||
reset; echo public > "$TMP/mode"
|
||||
printf '2026-08-25|把管理這條線做對\n' > "$ISEP_COUNTDOWN_STATE_DIR/milestone-due" # 第二基準：那條逾期的舊線
|
||||
OUT=$(inject)
|
||||
case "$OUT" in *"現在沒有主線"*) ok "① refresh 之前：兩份都沒有 ⇒ 🎯「現在沒有主線」（票上撞到的那個畫面，先確認測得到）" ;;
|
||||
*) no "① 前置狀態不對" "$OUT" ;; esac
|
||||
case "$OUT" in *"把管理這條線做對"*) ok "② refresh 之前：⏱ 退到第二基準，印的是逾期的舊線（同上）" ;;
|
||||
*) no "② 前置狀態不對（第二基準沒生效）" "$OUT" ;; esac
|
||||
RC=$(refresh)
|
||||
[ "$RC" = "0" ] && ok "③ mainline refresh 離開碼 0" || no "③ refresh 離開碼 $RC" "$(cat "$TMP/refresh.err")"
|
||||
[ -f "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" ] && ok "④ 家目錄那份被建出來（之後每一則訊息讀它，不再打網路）" \
|
||||
|| no "④ 家目錄沒有檔" "$(ls "$ISEP_COUNTDOWN_STATE_DIR")"
|
||||
OUT=$(show)
|
||||
case "$OUT" in *"Gitea 上那條現在的主線"*) ok "⑤ \`mainline\` 答得出 Gitea 上那條" ;; *) no "⑤ show 沒讀到" "$OUT" ;; esac
|
||||
OUT=$(inject)
|
||||
case "$OUT" in *"🎯 主線：inkstone/Arcrun#48「Gitea 上那條現在的主線」"*) ok "⑥ 第一則 prompt 的 🎯 那行是 Gitea 上那條（不是「沒有主線」）" ;;
|
||||
*) no "⑥ 🎯 沒講對" "$OUT" ;; esac
|
||||
case "$OUT" in *"主線 Gitea 上那條現在的主線 剩"*) ok "⑦ ⏱ 那行掛的是它的名字與期限（被標定的主線蓋過第二基準）" ;;
|
||||
*) no "⑦ ⏱ 沒掛主線" "$OUT" ;; esac
|
||||
case "$OUT" in *"把管理這條線做對"*) no "⑧ 舊線還在畫面上" "$OUT" ;; *) ok "⑧ 那條逾期 341 小時的舊線不再出現" ;; esac
|
||||
FIRST=$(head -1 "$TMP/log")
|
||||
[ "$FIRST" = "/api/v1/repos/inkstone/InkStoneCo/raw/system-dev/mainline.json|anon" ] && ok "⑨ 第一個請求匿名、打的是 InkStoneCo main 的 raw 檔（讀不帶憑證）" \
|
||||
|| no "⑨ 第一個請求不對" "$FIRST"
|
||||
[ "$(raw_hits)" = "1" ] && ok "⑩ 只問了一次" || no "⑩ 問了 $(raw_hits) 次" "$(cat "$TMP/log")"
|
||||
[ ! -e "$SHELL_ROOT/InkStoneCo" ] && ok "⑪ 沒有建出 InkStoneCo/（不 clone、不弄髒任何工作樹）" || no "⑪ 動了薄殼底下的樹" "$(ls "$SHELL_ROOT")"
|
||||
grep -q '"refreshed_at"' "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" && ok "⑫ 寫進家目錄的是完整那份（有 set_at／refreshed_at，之後 set_at 規則照用）" \
|
||||
|| no "⑫ 家目錄那份殘缺" "$(cat "$ISEP_COUNTDOWN_STATE_DIR/mainline.json")"
|
||||
|
||||
echo "── F. load()／每一則訊息那條路：零網路 ──"
|
||||
: > "$TMP/log"; show >/dev/null; show >/dev/null; inject >/dev/null
|
||||
[ "$(wc -l < "$TMP/log" | tr -d ' ')" = "0" ] && ok "⑬ show 兩次＋UserPromptSubmit 一次，假 Gitea 零請求（關鍵路徑上沒有網路）" \
|
||||
|| no "⑬ 關鍵路徑打了網路" "$(cat "$TMP/log")"
|
||||
RC=$(refresh)
|
||||
[ "$(raw_hits)" = "0" ] && ok "⑭ 家目錄那份已在 ⇒ 再跑 refresh 也不問 Gitea 的檔（優先序：家目錄 ＞ Gitea）" \
|
||||
|| no "⑭ 家目錄在場還去問" "$(cat "$TMP/log")"
|
||||
|
||||
echo "── B. private：匿名優先，被拒才帶 token；沒 token 就退回 ──"
|
||||
reset; echo private > "$TMP/mode"
|
||||
RC=$(refresh); OUT=$(show)
|
||||
case "$OUT" in *"現在沒有主線"*) ok "⑮ 匿名 404、沒 token ⇒ 退回「現在沒有主線」（不編、不炸；離開碼 $RC）" ;;
|
||||
*) no "⑮ 沒 token 卻讀到了？" "$OUT" ;; esac
|
||||
[ "$RC" = "0" ] && ok "⑯ 沒 token 時離開碼仍是 0（SessionStart 不准炸）" || no "⑯ 離開碼 $RC" "$(cat "$TMP/refresh.err")"
|
||||
[ "$(raw_hits)" = "1" ] && ok "⑰ 沒 token 只問一次就收手" || no "⑰ 問了 $(raw_hits) 次" "$(cat "$TMP/log")"
|
||||
reset
|
||||
RC=$(GITEA_TOKEN_CLAUDE_CODE=fake-token-for-test refresh); OUT=$(show)
|
||||
case "$OUT" in *"Gitea 上那條現在的主線"*) ok "⑱ 匿名 404、環境有 token ⇒ 帶 token 再問一次 ⇒ 讀到（真 InkStoneCo 就是 private）" ;;
|
||||
*) no "⑱ 有 token 還是讀不到" "$OUT／$(cat "$TMP/log")" ;; esac
|
||||
[ "$(sed -n 1p "$TMP/log")" = "/api/v1/repos/inkstone/InkStoneCo/raw/system-dev/mainline.json|anon" ] \
|
||||
&& [ "$(sed -n 2p "$TMP/log")" = "/api/v1/repos/inkstone/InkStoneCo/raw/system-dev/mainline.json|auth" ] \
|
||||
&& ok "⑲ 順序：第一次匿名、第二次才帶 token（不是一上來就實名）" || no "⑲ 順序不對" "$(cat "$TMP/log")"
|
||||
|
||||
echo "── C. 家目錄或 repo 那份任一在場 ⇒ 不問 Gitea ──"
|
||||
reset; echo public > "$TMP/mode"
|
||||
mkdir -p "$SHELL_ROOT/InkStoneCo/system-dev"
|
||||
python3 - "$SHELL_ROOT/InkStoneCo/system-dev/mainline.json" <<'PY'
|
||||
import json, sys
|
||||
json.dump({"ref": "inkstone/ISEP#1", "owner": "inkstone", "repo": "ISEP", "id": 1, "title": "bootstrap 之後 repo 裡那條",
|
||||
"due_on": "2026-09-20T23:59:59Z", "open_issues": 1, "closed_issues": 0, "members": [],
|
||||
"set_at": "2026-09-06 10:00", "refreshed_at": "2026-09-06 10:00"}, open(sys.argv[1], "w"), ensure_ascii=False)
|
||||
PY
|
||||
RC=$(refresh); OUT=$(show)
|
||||
[ "$(raw_hits)" = "0" ] && ok "⑳ repo 那份在 ⇒ 不問 Gitea（優先序：repo ＞ Gitea）" || no "⑳ repo 在場還去問" "$(cat "$TMP/log")"
|
||||
case "$OUT" in *"bootstrap 之後 repo 裡那條"*) ok "㉑ 答的是 repo 那份（0.24.0 的行為一字不改）" ;; *) no "㉑ 沒答 repo 那份" "$OUT" ;; esac
|
||||
[ ! -e "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" ] && ok "㉒ 只是讀 repo 那份，家目錄沒有被順手建出來（A32 ④ 沒被弄壞）" \
|
||||
|| no "㉒ 家目錄被寫了" "$(ls "$ISEP_COUNTDOWN_STATE_DIR")"
|
||||
|
||||
echo "── D. 讀不到 ⇒ 退回現行行為，不掛、逾時有上限 ──"
|
||||
for mode in 500 garbage notitle; do
|
||||
reset; echo "$mode" > "$TMP/mode"
|
||||
RC=$(refresh); OUT=$(show)
|
||||
if [ "$RC" = "0" ] && [ ! -e "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" ]; then
|
||||
case "$OUT" in *"現在沒有主線"*) ok "㉓ Gitea 回 $mode ⇒ 什麼都不寫、「現在沒有主線」、離開碼 0" ;; *) no "㉓ $mode 之後答錯" "$OUT" ;; esac
|
||||
else no "㉓ $mode 之後狀態不對" "rc=$RC $(ls "$ISEP_COUNTDOWN_STATE_DIR")"; fi
|
||||
done
|
||||
reset; echo hang > "$TMP/mode"
|
||||
T0=$(date +%s); RC=$(GITEA_TOKEN_CLAUDE_CODE=fake refresh); T1=$(date +%s); OUT=$(show)
|
||||
if [ $((T1 - T0)) -le 5 ] && [ "$RC" = "0" ]; then
|
||||
case "$OUT" in *"現在沒有主線"*) ok "㉔ Gitea 掛住（8 秒不回）⇒ $((T1 - T0)) 秒內放棄、退回、離開碼 0（逾時 1 秒 × 最多兩次）" ;; *) no "㉔ 掛住之後答錯" "$OUT" ;; esac
|
||||
else no "㉔ 掛住時沒有在時限內放棄" "用了 $((T1 - T0)) 秒，rc=$RC"; fi
|
||||
reset; echo public > "$TMP/mode"
|
||||
RC=$(TICKET_HOST="http://127.0.0.1:9" refresh); OUT=$(show)
|
||||
case "$OUT" in *"現在沒有主線"*) [ "$RC" = "0" ] && ok "㉕ 連不上 Gitea（TICKET_HOST 指到死位址）⇒ 退回、離開碼 0" || no "㉕ 離開碼 $RC" "$(cat "$TMP/refresh.err")" ;;
|
||||
*) no "㉕ 連不上還答出主線" "$OUT" ;; esac
|
||||
reset
|
||||
RC=$(ISEP_MAINLINE_GITEA_URL=none refresh); OUT=$(show)
|
||||
[ "$(raw_hits)" = "0" ] && case "$OUT" in *"現在沒有主線"*) ok "㉖ ISEP_MAINLINE_GITEA_URL=none ⇒ 零請求（既有測試靠它把外界定住）" ;; *) no "㉖ none 之後答錯" "$OUT" ;; esac \
|
||||
|| no "㉖ none 沒生效" "$(cat "$TMP/log")"
|
||||
[ -z "$(cat "$TMP/refresh.err")" ] && ok "㉗ 以上每一種讀不到，stderr 都是空的（不報錯嚇人）" || no "㉗ stderr 有東西" "$(cat "$TMP/refresh.err")"
|
||||
|
||||
echo "── E. 抓到之後 bootstrap 才出現的 repo 那份：跟 ISEP#130 的 set_at 規則接得起來 ──"
|
||||
reset; echo public > "$TMP/mode"; RC=$(refresh)
|
||||
mkdir -p "$SHELL_ROOT/InkStoneCo/system-dev"
|
||||
cp "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" "$SHELL_ROOT/InkStoneCo/system-dev/mainline.json" # bootstrap clone 下來的同一份
|
||||
OUT=$(show)
|
||||
case "$OUT" in *"Gitea 上那條現在的主線"*) ok "㉘ bootstrap 之後 repo 那份出現、set_at 相同 ⇒ 仍是同一條（家目錄那份算數）" ;; *) no "㉘ 答錯" "$OUT" ;; esac
|
||||
python3 - "$SHELL_ROOT/InkStoneCo/system-dev/mainline.json" <<'PY'
|
||||
import json, sys
|
||||
d = json.load(open(sys.argv[1])); d["title"] = "後來在別台機器新標的"; d["set_at"] = "2026-09-08 09:00"
|
||||
json.dump(d, open(sys.argv[1], "w"), ensure_ascii=False)
|
||||
PY
|
||||
OUT=$(show)
|
||||
case "$OUT" in *"後來在別台機器新標的"*) ok "㉙ repo 那份 set_at 較新 ⇒ 用 repo 那份（A32 ⑤ 的規則沒被本票弄壞）" ;; *) no "㉙ 沒用較新的" "$OUT" ;; esac
|
||||
|
||||
echo; echo "通過 $PASS 條，失敗 $FAIL 條"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
+39
-4
@@ -24,7 +24,9 @@ leo 2026-08-27：「**14 個里程碑同時亮著卻不知道該看哪個**」
|
||||
── 答案為什麼唯一 ─────────────────────────────────────────────────
|
||||
主線住在一個檔裡（`~/.claude/isep-countdown/mainline.json`），那個檔**放得下一條**。
|
||||
（inkstone/ISEP#130 起它有一份隨 repo 走的鏡像：`InkStoneCo/system-dev/mainline.json`——
|
||||
雲端沒有家目錄那份，讀的就是它；`set`／`adopt`／`clear` 兩份一起寫，`refresh` 只寫家目錄。）
|
||||
雲端沒有家目錄那份，讀的就是它；`set`／`adopt`／`clear` 兩份一起寫，`refresh` 只寫家目錄。
|
||||
inkstone/ISEP#140 起：兩份都不在時（雲端薄殼 bootstrap 之前的形狀），`refresh` 會去 Gitea
|
||||
讀 `inkstone/InkStoneCo` main 上那份一次、寫進家目錄——優先序寫在 `hooks/lib/mainline.py` 檔頭。）
|
||||
沒有清單、沒有優先序、沒有「前三名」——`set` 覆蓋掉的那條就不再是主線。
|
||||
⇒ 問一次只會拿到 0 或 1 個答案，不會拿到 14 個。
|
||||
|
||||
@@ -144,6 +146,8 @@ def cmd_show(argv):
|
||||
print(" 要標一條：`scripts/mainline list` 看有哪些 → `scripts/mainline set <owner/repo#id>`")
|
||||
print()
|
||||
print("📌 在標之前，每回合的 🎯 那一行也會照樣講「現在沒有主線」，不會編一條出來。")
|
||||
print(" 雲端：SessionStart 的 `mainline refresh` 會先去 Gitea 讀 inkstone/InkStoneCo main 的")
|
||||
print(" system-dev/mainline.json；還是沒有 ⇒ 那份不存在，或這台拿不到 Gitea（inkstone/ISEP#140）。")
|
||||
return
|
||||
c, total, pct = ML.progress(ms)
|
||||
print("🎯 現在的主線：%s「%s」" % (ML.ref_of(ms), ms.get("title")))
|
||||
@@ -247,12 +251,43 @@ def cmd_clear(argv):
|
||||
|
||||
|
||||
# ── refresh ──────────────────────────────────────────────────────────────
|
||||
def soft_token():
|
||||
"""拿得到就給，拿不到回空字串。`refresh` 跑在 SessionStart，**不准因為沒 token 就整支炸**
|
||||
——雲端薄殼的 remote 是 GitHub、家目錄是空的，那正是它最需要活著的時候。"""
|
||||
if T is None:
|
||||
return ""
|
||||
import contextlib
|
||||
import io
|
||||
try:
|
||||
with contextlib.redirect_stderr(io.StringIO()): # token() 拿不到會先抱怨再 exit：兩個都吞掉
|
||||
return T.token() or ""
|
||||
except (SystemExit, Exception):
|
||||
return ""
|
||||
|
||||
|
||||
def cmd_refresh(argv):
|
||||
"""SessionStart 跑一次。**拿不到就原封不動**——寧可資料舊，不要把主線弄丟。"""
|
||||
"""SessionStart 跑一次。**拿不到就原封不動**——寧可資料舊，不要把主線弄丟。
|
||||
|
||||
inkstone/ISEP#140：家目錄與 repo 那份都不在（雲端薄殼跑 SessionStart 時 `InkStoneCo/`
|
||||
還沒 clone）⇒ 去 Gitea 讀 `inkstone/InkStoneCo` main 上那份**一次**，寫進家目錄。
|
||||
之後每一則 UserPromptSubmit 讀的是家目錄，路徑上照舊沒有網路。
|
||||
讀不到 ⇒ 什麼都不寫，退回現行行為（`countdown.py` 的第二基準）。
|
||||
"""
|
||||
ms = ML.load()
|
||||
if not ms:
|
||||
return # 沒有主線就沒有東西要更新，安靜結束
|
||||
d = T.api_soft("/repos/%s/%s/milestones/%s" % (ms["owner"], ms["repo"], ms["id"]))
|
||||
got = ML.fetch_gitea(token=soft_token) # 傳函式：匿名讀得到就不去碰 token
|
||||
if not got:
|
||||
return # 兩份都沒有、Gitea 也問不到 ⇒ 真的沒有主線，安靜結束
|
||||
ML.save(got) # 只寫家目錄：雲端沒有 InkStoneCo/ 可寫，本機不弄髒工作樹
|
||||
ms = ML.load()
|
||||
if not ms:
|
||||
return
|
||||
if T is None:
|
||||
return
|
||||
try:
|
||||
d = T.api_soft("/repos/%s/%s/milestones/%s" % (ms["owner"], ms["repo"], ms["id"]))
|
||||
except SystemExit:
|
||||
return # 拿不到 token：主線已經在了，進度晚點再更新，不炸
|
||||
if not isinstance(d, dict) or not d.get("title"):
|
||||
return # 讀不到 ≠ 主線不存在
|
||||
ms.update({
|
||||
|
||||
Executable
+255
@@ -0,0 +1,255 @@
|
||||
#!/usr/bin/env python3
|
||||
"""release-check — 回頭問「這一版真的送到了嗎」，而且**問的人不是送的人**
|
||||
（inkstone/ISEP#67）
|
||||
|
||||
leo 2026-08-27 的病（票上原文）：
|
||||
「版本只到 ISEP v0.3.9，你有新版為什麼不推？」
|
||||
v0.4.0／v0.5.0 的 tag 早就推了，但 Gitea Releases 頁停在 v0.3.9
|
||||
⇒ 對 leo 等於這兩版不存在；claude plugin list 也還顯示舊版。
|
||||
2026-09-07 又一次：v0.23.0／v0.24.0 打了 tag，Releases 頁停在 v0.22.0——
|
||||
交棒給 leo 的「測試位置 releases/tag/v0.24.0」打開是一頁空 tag。
|
||||
|
||||
ISEP 的運送鏈有這幾段，**每一段都要有人回頭問「到了嗎」**：
|
||||
|
||||
定版 commit → tag（Gitea） → release（Gitea） → main 的 plugin.json
|
||||
→ 這個 session 真的載入到的版本
|
||||
|
||||
🔴 這支的全部價值在一句話：**它不聽上一站說「我送了」，它自己去問收貨的那一端。**
|
||||
tag 在不在 → 問 Gitea 的 tags；release 在不在 → 問 Gitea 的 releases（leo 會看的那頁）；
|
||||
載入到了沒 → 看這個 session 真的掛著的那一份 plugin.json。
|
||||
問的方式全部匿名（D20：讀不帶憑證），判準與 release-ship／SessionStart 信標同一份
|
||||
（hooks/lib/release_chain.py）。
|
||||
|
||||
用法：
|
||||
release-check 現行版本 ＝ 這棵樹 plugin.json 宣稱的那一版
|
||||
release-check v0.23.0 現行版本 ＝ 你指定的那一版（release-ship 送完拿來覆核**那一版**，
|
||||
不管工作樹現在 checkout 在哪）
|
||||
|
||||
判準是**結構**，不是關鍵字（leo 2026-08-17 已證偽關鍵字黑名單：8 次誤攔、0 次正確）：
|
||||
· 哪些版本「應該」被送到 ＝ main 上有 `定版 vX.Y.Z` commit 的那些（git 說了算，不是猜）
|
||||
· 那個版本「送到了沒」＝ 去 Gitea 問它的 tag 與 release 在不在（在＝到了）
|
||||
|
||||
離開碼：
|
||||
0 現行版本 **tag 與 release 都在** ⇒ 送貨端完成
|
||||
2 現行版本缺 tag 或缺 release ⇒ **送貨端斷了**，stderr 講出缺哪一站＋怎麼補
|
||||
（這正是工單驗收 4：「故意漏一步 → 管線要擋下來並說出缺哪一站」）
|
||||
說明：比現行版本更舊的 `定版` 版本若缺 tag／release，只**黃字提醒**、不改離開碼——
|
||||
它們多半已被新版取代，硬擋等於「懲罰謹慎」（over-block 比 under-block 嚴重）。
|
||||
v0.19／0.20／0.21 就是總管 09-07 裁定「不補」的那三個。
|
||||
載入端落後（這個 session 跑的比 main 舊）也只提醒：那要 update＋重啟，
|
||||
是收貨端的動作，不是送貨端能修的，且 SessionStart 信標本來就一直在報。
|
||||
|
||||
離線測試：`scripts/test-release-check.sh`（走 `RELEASE_CHECK_FIXTURE`，不打 Gitea）。
|
||||
"""
|
||||
import json
|
||||
import os
|
||||
import re
|
||||
import subprocess
|
||||
import sys
|
||||
|
||||
HERE = os.path.dirname(os.path.abspath(__file__))
|
||||
sys.path.insert(0, os.path.join(HERE, "..", "hooks", "lib"))
|
||||
try:
|
||||
import release_chain as rc
|
||||
except Exception as e: # pragma: no cover
|
||||
print("🔴 讀不到 hooks/lib/release_chain.py：%s" % e, file=sys.stderr)
|
||||
sys.exit(2)
|
||||
|
||||
HOST = os.environ.get("RELEASE_CHECK_HOST", rc.DEFAULT_HOST)
|
||||
REPO = os.environ.get("RELEASE_CHECK_REPO", rc.DEFAULT_REPO)
|
||||
FIXTURE = os.environ.get("RELEASE_CHECK_FIXTURE", "")
|
||||
|
||||
|
||||
def die(msg, code=2):
|
||||
print(msg, file=sys.stderr)
|
||||
sys.exit(code)
|
||||
|
||||
|
||||
def proj_root():
|
||||
"""這支腳本操作的那個 ISEP repo 的根。"""
|
||||
v = os.environ.get("CLAUDE_PROJECT_DIR")
|
||||
if v and os.path.isfile(os.path.join(v, ".claude-plugin", "plugin.json")):
|
||||
return v
|
||||
return os.path.dirname(HERE)
|
||||
|
||||
|
||||
def load_fixture():
|
||||
if not FIXTURE:
|
||||
return None
|
||||
try:
|
||||
with open(FIXTURE) as f:
|
||||
return json.load(f)
|
||||
except Exception:
|
||||
die("🔴 讀不到 RELEASE_CHECK_FIXTURE：%s" % FIXTURE)
|
||||
|
||||
|
||||
FX = load_fixture()
|
||||
CHAIN = rc.Chain(HOST, REPO, fixture=FX)
|
||||
|
||||
# 🔴 裁定不補的歷史版本（唯一識別碼往放行方向比對，不是關鍵字）：
|
||||
# 總管 2026-09-07（inkstone/ISEP#67 → comment 6574）：「v0.19／0.20／0.21 不補——
|
||||
# 沒 tag，v0.22.0 的 note 已列到那三個定版。」這三個定版 commit 永遠在 main 上，
|
||||
# 不列在這裡它們就會每次都黃字——天天念的東西會被學會忽略，等於不存在。
|
||||
WAIVED = {"0.19.0": "inkstone/ISEP#67 → 6574", "0.20.0": "inkstone/ISEP#67 → 6574",
|
||||
"0.21.0": "inkstone/ISEP#67 → 6574"}
|
||||
|
||||
|
||||
# ══ 送貨端事實：main 上「定版」了哪些、現在宣稱哪一版、這個 session 載到哪一版 ══
|
||||
def dingban_versions():
|
||||
"""main 上有 `定版 vX.Y.Z` commit 的版本 —— 「應該被送到」的權威清單。"""
|
||||
if FX is not None:
|
||||
return list(FX.get("dingban") or [])
|
||||
root = proj_root()
|
||||
try:
|
||||
out = subprocess.run(
|
||||
["git", "-C", root, "log", "--format=%s", "--grep", "定版 v"],
|
||||
capture_output=True, text=True, timeout=30).stdout
|
||||
except Exception:
|
||||
out = ""
|
||||
seen, vers = set(), []
|
||||
for line in out.splitlines():
|
||||
m = re.search(r"定版\s+v?(\d+\.\d+\.\d+)", line)
|
||||
if m and m.group(1) not in seen:
|
||||
seen.add(m.group(1))
|
||||
vers.append(m.group(1))
|
||||
return vers
|
||||
|
||||
|
||||
def current_version():
|
||||
"""plugin.json 現在宣稱的那一版（＝ main 要送出去的那一版）。"""
|
||||
if FX is not None:
|
||||
return FX.get("current") or ""
|
||||
try:
|
||||
with open(os.path.join(proj_root(), ".claude-plugin", "plugin.json")) as f:
|
||||
return json.load(f).get("version") or ""
|
||||
except Exception:
|
||||
return ""
|
||||
|
||||
|
||||
def loaded_version():
|
||||
"""這個 session 真的掛著的那一份 plugin 是哪一版（收貨端最後一段）。
|
||||
|
||||
拿不到就回 None —— 不猜、不謊稱到了（house style：不知道就說不知道）。
|
||||
"""
|
||||
if FX is not None:
|
||||
return FX.get("loaded")
|
||||
root = os.environ.get("CLAUDE_PLUGIN_ROOT")
|
||||
if not root:
|
||||
return None
|
||||
try:
|
||||
with open(os.path.join(root, ".claude-plugin", "plugin.json")) as f:
|
||||
return json.load(f).get("version")
|
||||
except Exception:
|
||||
return None
|
||||
|
||||
|
||||
# ══ 覆核：逐版問「到了嗎」 ════════════════════════════════════════════════
|
||||
def audit(focus=None):
|
||||
cur = focus or current_version()
|
||||
if not cur:
|
||||
die("🔴 讀不到 .claude-plugin/plugin.json 的 version —— 這不是 ISEP repo，或檔案壞了。")
|
||||
dingban = dingban_versions()
|
||||
if cur not in dingban:
|
||||
# 現行版本連 `定版` commit 都沒有 ⇒ plugin.json 宣稱了一個沒被定版的號碼。
|
||||
# 這是 check-version-consistency 那條線的病，不是這支的守備範圍——但要講出來。
|
||||
dingban = [cur] + dingban
|
||||
try:
|
||||
tags = CHAIN.tags()
|
||||
rels = CHAIN.releases()
|
||||
except rc.ChainError as e:
|
||||
die("🔴 問不到收貨端，這一支不猜：%s" % e)
|
||||
|
||||
rows = []
|
||||
for v in sorted(set(dingban), key=rc.vtuple, reverse=True):
|
||||
rows.append({
|
||||
"ver": v,
|
||||
"dingban": True, # 這份清單本來就是從 定版 commit 來的
|
||||
"tag": rc.tagname(v) in tags,
|
||||
"release": rc.tagname(v) in rels,
|
||||
"current": v == cur,
|
||||
"gaps": rc.gaps(v, tags, rels),
|
||||
"waived": WAIVED.get(v) if v != cur else None,
|
||||
})
|
||||
return cur, rows
|
||||
|
||||
|
||||
def ship_cmd():
|
||||
"""補 release 的那一行要能直接貼著跑：印正本自己的絕對路徑（mistakes.md 2026-08-31）。"""
|
||||
return "python3 %s" % os.path.join(HERE, "release-ship")
|
||||
|
||||
|
||||
def report(focus=None):
|
||||
cur, rows = audit(focus)
|
||||
loaded = loaded_version()
|
||||
icon = {True: "✅", False: "❌"}
|
||||
lines = ["ISEP 運送鏈覆核（收貨端事實，不聽送的人說） repo=%s" % REPO, ""]
|
||||
lines.append(" 版本 定版 tag release （← ＝%s）"
|
||||
% ("你指定的版本" if focus else "現行 plugin.json 宣稱的版本"))
|
||||
for r in rows:
|
||||
mark = " ←" if r["current"] else ""
|
||||
if r["waived"] and r["gaps"]:
|
||||
mark = " ⏭ 裁定不補（%s）" % r["waived"]
|
||||
lines.append(" %-10s %s %s %s%s" % (
|
||||
"v" + r["ver"], icon[r["dingban"]], icon[r["tag"]], icon[r["release"]], mark))
|
||||
|
||||
# ── 載入端（這個 session）──────────────────────────────────────────
|
||||
lines.append("")
|
||||
if loaded is None:
|
||||
lines.append(" 載入端：這個 context 讀不到 CLAUDE_PLUGIN_ROOT ⇒ 說不出「這個 session 載到哪一版」"
|
||||
"（不是 session 裡跑的，或沒裝 plugin）。")
|
||||
elif rc.vtuple(loaded) < rc.vtuple(cur):
|
||||
lines.append(" 🟡 載入端落後：這個 session 掛的是 v%s，main 已到 v%s。" % (loaded, cur))
|
||||
lines.append(" 修：本機 `claude plugin update isep@inkstone` **並重啟 session**"
|
||||
"（升版與生效是兩件事）；雲端去動一下 Environment 的 setup script 逼它重拍快照。")
|
||||
lines.append(" 這一段 SessionStart 信標本來就一直在報（beacon_report.py ①）。")
|
||||
else:
|
||||
lines.append(" ✅ 載入端：這個 session 掛的是 v%s，跟 main 宣稱的一致。" % loaded)
|
||||
|
||||
# ── 判決 ────────────────────────────────────────────────────────────
|
||||
currow = next((r for r in rows if r["current"]), None)
|
||||
hard = currow["gaps"] if currow else []
|
||||
older_gaps = [r for r in rows if not r["current"] and r["gaps"] and not r["waived"]]
|
||||
|
||||
lines.append("")
|
||||
if hard:
|
||||
lines.append("🔴 **現行版本 v%s 的送貨端斷了** —— 對 leo 等於這一版不存在：" % cur)
|
||||
for _key, label, fix in hard:
|
||||
lines.append(" 缺這一站：%s" % label)
|
||||
lines.append(" 怎麼補：%s" % fix.format(v=cur, ship=ship_cmd()))
|
||||
if older_gaps:
|
||||
lines.append(" （另外還有更舊的版本也缺，見下方黃字，但那些不擋。）")
|
||||
else:
|
||||
lines.append("✅ 現行版本 v%s：定版、tag、release 都在 —— 送貨端完成，leo 那頁看得到。" % cur)
|
||||
|
||||
if older_gaps:
|
||||
lines.append("")
|
||||
lines.append("🟡 更舊的定版版本也缺件（多半已被新版取代，只提醒、不擋）：")
|
||||
for r in older_gaps:
|
||||
lines.append(" v%s 缺：%s" % (r["ver"], "＋".join(label for _k, label, _f in r["gaps"])))
|
||||
lines.append(" 要補歷史版本 ⇒ 逐版 `%s v<版本>`；"
|
||||
"確定不補 ⇒ 這是 leo／總管的決定，記一句在 inkstone/ISEP#67"
|
||||
"（v0.19／0.20／0.21 已於 2026-09-07 裁定不補）。" % ship_cmd())
|
||||
|
||||
out = "\n".join(lines)
|
||||
if hard:
|
||||
print(out, file=sys.stderr)
|
||||
return 2
|
||||
print(out)
|
||||
return 0
|
||||
|
||||
|
||||
def main(argv):
|
||||
focus = None
|
||||
for a in argv:
|
||||
if a in ("-h", "--help"):
|
||||
print(__doc__)
|
||||
return 0
|
||||
m = re.match(r"^v?(\d+\.\d+\.\d+)$", a.strip())
|
||||
if not m:
|
||||
die("用法：release-check [vX.Y.Z]（--help 看說明）；不認得：%s" % a)
|
||||
focus = m.group(1)
|
||||
return report(focus)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main(sys.argv[1:]))
|
||||
Executable
+290
@@ -0,0 +1,290 @@
|
||||
#!/usr/bin/env python3
|
||||
"""release-ship — 把「已經推上去的 tag」變成「leo 那頁看得到的 release」
|
||||
（inkstone/ISEP#67，對應 arcrun-rag 的 release-record 站）
|
||||
|
||||
工單抓到的斷點，一句話：**沒有任何東西會建 release。**
|
||||
ISEP repo 全樹 grep「建 release」的 API 呼叫 → 0 命中。
|
||||
後果：tag 早就推了，Gitea Releases 頁卻停在舊版
|
||||
⇒ 對 leo 等於這一版不存在（「ISEP 現在是哪一版」只有 Releases 答得出來）。
|
||||
08-27 v0.4.0／v0.5.0、09-02 v0.22.0、09-07 v0.23.0／v0.24.0——同一站斷了三輪。
|
||||
|
||||
這支就是補上那一站。它**只做 tag → release** 這一段，不打 tag、不改 plugin.json、
|
||||
不碰 main —— 打 tag 是 `release-tag-guard.sh` 在管的、總管驗過整個 milestone 之後的動作。
|
||||
|
||||
🔴 送之前，三件事「必須在場」才放行（require-something-present，不是關鍵字黑名單）：
|
||||
① **那個 tag 的樹**裡 `plugin.json` 的 version ＝ 這個 tag 的號碼。
|
||||
比對的對象是 tag 自己的樹（問 Gitea `contents/…?ref=<tag>`），**不是工作樹**。
|
||||
🔴 09-05 那版拿 `check-version-consistency.sh`（工作樹 plugin.json vs 本機最新 tag）
|
||||
當前置①，結果對「不是最新的那個 tag」永遠建不了：總管在 v0.23.0 的 checkout
|
||||
跑 `release-ship v0.23.0` 被擋，訊息說最新 tag 是 v0.24.0——而 v0.23.0 的樹
|
||||
明明就一致。**要送的東西是 tag，判它的就該看它的樹**；工作樹可能是任何分支
|
||||
（這支本身就是在一條 feature 分支上寫的），跟那個 tag 沒有關係。
|
||||
`check-version-consistency.sh` 守的是「main 上 plugin.json 跟最新 tag 一致」，
|
||||
那是打 tag 那一刻的事（release-tag-guard.sh），不是建 release 這一刻的事。
|
||||
② tag 真的在 Gitea 上：去問收貨端，不在就不給建 release（先去推 tag）。
|
||||
③ release note 有內容：沒給 `--notes-file` 就從 Gitea「上一個 release ⋯ 這個 tag」
|
||||
的 compare 自動生一份**事實**清單（哪幾顆 commit，不含 merge）——leo 可以再改，但不留白。
|
||||
問 Gitea 而不是本機 git log：這支從 plugin 快取目錄跑時**旁邊沒有 git repo**。
|
||||
|
||||
🔴 送完**自己不算數**：最後回頭跑一次 `release-check <這個 tag>`，拿收貨端（Gitea releases 頁）
|
||||
的事實覆核「真的建起來了」。送的人說成功不算，問收貨的那一端才算
|
||||
（工單：「問的人不能是送的人」）。
|
||||
|
||||
讀全部匿名（D20），只有 POST 建 release 才要 token
|
||||
（`GITEA_TOKEN_CLAUDE_CODE`／`GITEA_TOKEN`，或這個 repo remote URL 裡帶的那把）。
|
||||
|
||||
冪等：release 已經在了 ⇒ 報「本來就在」、離開碼 0，不重複建、不報錯、**不動它的內容**。
|
||||
|
||||
離開碼：0 ＝ release 在 Gitea 上了（新建的或本來就在）
|
||||
2 ＝ 某個前置條件沒滿足（stderr 講出是哪一個＋怎麼補）
|
||||
|
||||
離線測試：`scripts/test-release-ship.sh`（走 `RELEASE_SHIP_FIXTURE`，不打 Gitea、不建真 release）。
|
||||
"""
|
||||
import json
|
||||
import os
|
||||
import re
|
||||
import subprocess
|
||||
import sys
|
||||
import urllib.error
|
||||
import urllib.request
|
||||
|
||||
HERE = os.path.dirname(os.path.abspath(__file__))
|
||||
sys.path.insert(0, os.path.join(HERE, "..", "hooks", "lib"))
|
||||
try:
|
||||
import release_chain as rc
|
||||
except Exception as e: # pragma: no cover
|
||||
print("🔴 讀不到 hooks/lib/release_chain.py：%s" % e, file=sys.stderr)
|
||||
sys.exit(2)
|
||||
|
||||
HOST = os.environ.get("RELEASE_SHIP_HOST", rc.DEFAULT_HOST)
|
||||
REPO = os.environ.get("RELEASE_SHIP_REPO", rc.DEFAULT_REPO)
|
||||
FIXTURE = os.environ.get("RELEASE_SHIP_FIXTURE", "")
|
||||
VER_RE = re.compile(r"^v?(\d+\.\d+\.\d+)$")
|
||||
|
||||
|
||||
def die(msg, code=2):
|
||||
print(msg, file=sys.stderr)
|
||||
sys.exit(code)
|
||||
|
||||
|
||||
def proj_root():
|
||||
v = os.environ.get("CLAUDE_PROJECT_DIR")
|
||||
if v and os.path.isfile(os.path.join(v, ".claude-plugin", "plugin.json")):
|
||||
return v
|
||||
return os.path.dirname(HERE)
|
||||
|
||||
|
||||
def load_fixture():
|
||||
if not FIXTURE:
|
||||
return None
|
||||
try:
|
||||
with open(FIXTURE) as f:
|
||||
return json.load(f)
|
||||
except Exception:
|
||||
die("🔴 讀不到 RELEASE_SHIP_FIXTURE：%s" % FIXTURE)
|
||||
|
||||
|
||||
FX = load_fixture()
|
||||
CHAIN = rc.Chain(HOST, REPO, fixture=FX)
|
||||
|
||||
|
||||
def ask(fn, *a):
|
||||
"""問收貨端；問不到就死（不猜）。"""
|
||||
try:
|
||||
return fn(*a)
|
||||
except rc.ChainError as e:
|
||||
die("🔴 問不到收貨端 %s：%s" % (HOST, e))
|
||||
|
||||
|
||||
# ══ 前置條件 ③ release note ════════════════════════════════════════════
|
||||
def auto_notes(tagname, releases):
|
||||
"""從 Gitea compare 生一份事實 note：上一個 release 之後到這個 tag 之間的 commit。"""
|
||||
since = CHAIN.latest_release_before(tagname, releases)
|
||||
subjects = ask(CHAIN.commits_between, since, tagname)
|
||||
head = ("這一版收了以下改動（%s 之後）：" % since) if since else "這一版收了以下改動："
|
||||
body = "\n".join("- %s" % s for s in subjects)
|
||||
if not body:
|
||||
body = "-（Gitea 取不到 commit 清單，請手動補；release 已建起來，leo 可直接編輯。）"
|
||||
return ("%s\n\n%s\n\n---\n（本 note 由 scripts/release-ship 從 git log 自動生成，"
|
||||
"leo／總管可直接在 Gitea 上編輯。inkstone/ISEP#67）" % (head, body))
|
||||
|
||||
|
||||
def release_name(tagname):
|
||||
"""`vX.Y.Z — 定版 commit 括號那句人話`，對齊 leo 既有 release 的命名慣例；找不到就純 tag 名。"""
|
||||
ver = tagname.lstrip("v")
|
||||
msg = ask(CHAIN.tag_commit_message, tagname)
|
||||
title = rc.dingban_title(msg, ver)
|
||||
if not title:
|
||||
for s in ask(CHAIN.commits_between, None, tagname)[-20:]:
|
||||
title = rc.dingban_title(s, ver)
|
||||
if title:
|
||||
break
|
||||
return ("%s — %s" % (tagname, title)) if title else tagname
|
||||
|
||||
|
||||
# ══ 真的建 release（POST 收貨端）═══════════════════════════════════════════
|
||||
def create_release(tagname, notes, dry, name):
|
||||
payload = {"tag_name": tagname, "name": name, "body": notes,
|
||||
"draft": False, "prerelease": False}
|
||||
if dry:
|
||||
return None, "🧪 --dry-run：不 POST。要建的 release payload：\n%s" % \
|
||||
json.dumps({"tag_name": tagname, "name": name,
|
||||
"body_lines": notes.count("\n") + 1}, ensure_ascii=False)
|
||||
if FX is not None:
|
||||
sink = os.environ.get("RELEASE_SHIP_SINK")
|
||||
if sink:
|
||||
try:
|
||||
cur = json.load(open(sink)) if os.path.exists(sink) else []
|
||||
except Exception:
|
||||
cur = []
|
||||
cur.append(tagname)
|
||||
json.dump(cur, open(sink, "w"))
|
||||
return {"tag_name": tagname, "html_url": "(fixture-created)"}, "（fixture 模式，未打網路）"
|
||||
tk = rc.token_from_env_or_remote(HOST, proj_root())
|
||||
if not tk:
|
||||
die("🔴 拿不到 %s 的 token —— 建 release 是寫入，一定要憑證"
|
||||
"（GITEA_TOKEN_CLAUDE_CODE，或這個 repo 的 remote URL 帶憑證）。" % HOST)
|
||||
url = "%s/api/v1/repos/%s/releases" % (HOST, REPO)
|
||||
req = urllib.request.Request(
|
||||
url, data=json.dumps(payload).encode(), method="POST",
|
||||
headers={"Authorization": "token " + tk, "Content-Type": "application/json"})
|
||||
try:
|
||||
r = json.load(urllib.request.urlopen(req, timeout=40))
|
||||
return r, "已建立"
|
||||
except urllib.error.HTTPError as e:
|
||||
die("🔴 Gitea 建 release 失敗 %s：%s" % (e.code, e.read().decode()[:300]))
|
||||
except Exception as e:
|
||||
die("🔴 連不上 %s：%s" % (HOST, e))
|
||||
|
||||
|
||||
# ══ 送完覆核：回頭問收貨端（不是問自己）══════════════════════════════════
|
||||
def verify_via_check(tagname):
|
||||
"""跑 `release-check <tag>`，拿收貨端事實覆核**這一版**。回 (ok, 輸出)。"""
|
||||
check = os.path.join(HERE, "release-check")
|
||||
env = dict(os.environ)
|
||||
if FX is not None:
|
||||
# fixture 模式下，把剛「建」進 sink 的 release 併進 release-check 的 fixture 視圖
|
||||
sink = os.environ.get("RELEASE_SHIP_SINK")
|
||||
extra = []
|
||||
if sink and os.path.exists(sink):
|
||||
try:
|
||||
extra = json.load(open(sink))
|
||||
except Exception:
|
||||
extra = []
|
||||
merged = dict(FX)
|
||||
merged["releases"] = sorted(set((FX.get("releases") or []) + extra))
|
||||
cf = (sink or "/tmp/rs") + ".checkfx.json"
|
||||
json.dump(merged, open(cf, "w"))
|
||||
env["RELEASE_CHECK_FIXTURE"] = cf
|
||||
env.setdefault("RELEASE_CHECK_HOST", HOST)
|
||||
env.setdefault("RELEASE_CHECK_REPO", REPO)
|
||||
try:
|
||||
p = subprocess.run(["python3", check, tagname], capture_output=True, text=True,
|
||||
timeout=60, env=env)
|
||||
return p.returncode == 0, (p.stdout + p.stderr).strip()
|
||||
except Exception as e:
|
||||
return False, "跑不動 release-check：%s" % e
|
||||
|
||||
|
||||
# ══ 主流程 ════════════════════════════════════════════════════════════════
|
||||
def ship(arg, notes_file=None, dry=False, do_verify=True):
|
||||
m = VER_RE.match(arg.strip())
|
||||
if not m:
|
||||
die("🔴 版本寫法是 vX.Y.Z 或 X.Y.Z，你給的是：%s" % arg)
|
||||
ver = m.group(1)
|
||||
tagname = "v" + ver
|
||||
out = ["📦 release-ship %s（把 tag 變成 leo 看得到的 release）" % tagname, ""]
|
||||
|
||||
tags = ask(CHAIN.tags)
|
||||
# 前置 ②（先問 tag 在不在——①要讀它的樹，tag 不在就沒有樹可讀）
|
||||
if tagname not in tags:
|
||||
die("🚫 前置② Gitea 上沒有 tag %s —— 不給建 release。\n"
|
||||
" release 是「把已存在的 tag 公開成一頁」，tag 都還沒推，先推：\n"
|
||||
" git tag %s && git push origin %s\n"
|
||||
" （推 tag 那一刻 release-tag-guard.sh 會擋下版本對不上的 tag。）"
|
||||
% (tagname, tagname, tagname))
|
||||
# 前置 ①（看 tag 自己的樹，不看工作樹）
|
||||
at_tag = ask(CHAIN.manifest_version_at, tagname)
|
||||
if at_tag != ver:
|
||||
die("🚫 前置① tag %s 的樹裡 plugin.json 寫的是「%s」—— 不給建 release。\n"
|
||||
" 建 release 是把這個 tag 公開給 leo 裝；tag 的樹自己就講錯版本，裝了會各說各話。\n"
|
||||
" 這種 tag 不該存在（release-tag-guard.sh 在推 tag 那一刻就會擋），\n"
|
||||
" 修法：刪掉這個 tag、在 main 上把 plugin.json 改成 %s 重新定版、再打一次 tag。"
|
||||
% (tagname, at_tag or "（讀不到）", ver))
|
||||
out.append("✅ 前置② Gitea 上有 tag %s（問過收貨端）" % tagname)
|
||||
out.append("✅ 前置① tag %s 的樹裡 plugin.json ＝ %s（看的是 tag 的樹，不是工作樹）" % (tagname, ver))
|
||||
|
||||
# 冪等
|
||||
existing = ask(CHAIN.release, tagname)
|
||||
if existing:
|
||||
out.append("ℹ️ release %s 本來就在了（%s）—— 不重複建、不動它。"
|
||||
% (tagname, existing.get("html_url") or ""))
|
||||
code = 0
|
||||
if do_verify:
|
||||
vok, vout = verify_via_check(tagname)
|
||||
out.append("")
|
||||
out.append("── 覆核（release-check %s，問收貨端）──" % tagname)
|
||||
out.append(vout)
|
||||
code = 0 if vok else 2
|
||||
return code, "\n".join(out)
|
||||
|
||||
# 前置 ③
|
||||
releases = ask(CHAIN.releases)
|
||||
if notes_file:
|
||||
with open(notes_file) as f:
|
||||
notes = f.read()
|
||||
out.append("✅ 前置③ release note 來自 %s" % notes_file)
|
||||
else:
|
||||
notes = auto_notes(tagname, releases)
|
||||
out.append("✅ 前置③ release note 由 Gitea 的 commit 清單自動生成（leo 可再改）")
|
||||
|
||||
# 建（release 名對齊 leo 慣例：vX.Y.Z — 定版 commit 那句人話）
|
||||
relname = release_name(tagname)
|
||||
rel, how = create_release(tagname, notes, dry, relname)
|
||||
if dry:
|
||||
out.append(" release 名：%s" % relname)
|
||||
out.append("")
|
||||
out.append(how)
|
||||
return 0, "\n".join(out)
|
||||
out.append("✅ 已建立 release「%s」（%s）" % (relname, (rel or {}).get("html_url") or how))
|
||||
|
||||
# 覆核（送完問收貨端）
|
||||
code = 0
|
||||
if do_verify:
|
||||
vok, vout = verify_via_check(tagname)
|
||||
out.append("")
|
||||
out.append("── 覆核（release-check %s，問收貨端，不是問自己）──" % tagname)
|
||||
out.append(vout)
|
||||
code = 0 if vok else 2
|
||||
return code, "\n".join(out)
|
||||
|
||||
|
||||
def main(argv):
|
||||
arg, notes_file, dry, do_verify = None, None, False, True
|
||||
i = 0
|
||||
while i < len(argv):
|
||||
a = argv[i]
|
||||
if a in ("-h", "--help"):
|
||||
print(__doc__)
|
||||
return 0
|
||||
elif a == "--notes-file":
|
||||
i += 1
|
||||
notes_file = argv[i]
|
||||
elif a == "--dry-run":
|
||||
dry = True
|
||||
elif a == "--no-verify":
|
||||
do_verify = False
|
||||
elif a.startswith("-"):
|
||||
die("不認得的參數：%s（--help 看用法）" % a)
|
||||
else:
|
||||
arg = a
|
||||
i += 1
|
||||
if not arg:
|
||||
die("用法：release-ship <版本 vX.Y.Z> [--notes-file <檔>] [--dry-run] [--no-verify]")
|
||||
code, report = ship(arg, notes_file, dry, do_verify)
|
||||
print(report, file=(sys.stdout if code == 0 else sys.stderr))
|
||||
return code
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main(sys.argv[1:]))
|
||||
@@ -34,6 +34,43 @@ run 0 'python3 -c "requests.post(url, json={\"body\": \"quoting: git push origin
|
||||
run 0 'grep -n "gh api" hooks/github-contact-guard.sh'
|
||||
run 0 'grep -rn "git push" installer/scripts/line-source-repo.mjs'
|
||||
|
||||
echo "── 判「push 到哪」要看這條指令實際會推的那個 repo，不是 hook 站的 cwd（inkstone/ISEP#109 → comment 6629，2026-09-07 實撞）──"
|
||||
# 為什麼這群非有不可：雲端薄殼的 cwd 是 GitHub 那份（origin＝github.com），而總管在
|
||||
# `InkStoneCo/`（origin＝Gitea）推分支。舊版拿 **hook 收到的 cwd** 去解 `origin`，
|
||||
# 於是 `git -C <InkStoneCo> push origin x` 被判成「remote origin 指向 GitHub」擋下
|
||||
# ——連 `-C` 都沒看。arcrun-hand 同日在 Arcrun#176 comment 6614 撞到同一支。
|
||||
# 判準仍是唯一識別碼（remote 解出來的 URL 主機），不是名字；**不是「有 -C 就放行」**——
|
||||
# 下面「該擋」那組就是 -C／cd 指到 GitHub 那份時照擋的證據。
|
||||
W=$(mktemp -d "${TMPDIR:-/tmp}/isep-ghc.XXXXXX"); trap 'rm -rf "$W"' EXIT
|
||||
W=$(cd "$W" && pwd -P)
|
||||
mk(){ git init -q -b main "$1" && git -C "$1" remote add origin "$2"; }
|
||||
mk "$W/shell" https://github.com/example/shell.git # 薄殼：origin＝GitHub
|
||||
mk "$W/body" https://git.example.invalid/inkstone/body.git # 真身：origin＝Gitea 的形狀（主機不是 github.com）
|
||||
mkdir -p "$W/body/sub"
|
||||
runc(){ # $1=want $2=cwd $3=cmd —— 跟 run 一樣，只是 payload 帶 cwd（hook 真的會收到它）
|
||||
LAST_ERR=$(printf '%s' "{\"tool_name\":\"Bash\",\"cwd\":$(python3 -c 'import json,sys;print(json.dumps(sys.argv[1]))' "$2"),\"tool_input\":{\"command\":$(python3 -c 'import json,sys;print(json.dumps(sys.argv[1]))' "$3")}}" \
|
||||
| bash "$H" 2>&1 >/dev/null)
|
||||
got=$?
|
||||
if [ "$got" = "$1" ]; then PASS=$((PASS+1)); printf ' ✅ '; else FAIL=$((FAIL+1)); printf ' ❌ '; fi
|
||||
printf 'want=%s got=%s cwd=%s %.60s\n' "$1" "$got" "${2#$W/}" "$3"
|
||||
}
|
||||
has(){ if printf '%s' "$LAST_ERR" | grep -qF -- "$1"; then PASS=$((PASS+1)); printf ' ✅ '; else FAIL=$((FAIL+1)); printf ' ❌ '; fi; printf '%s\n' "$2"; }
|
||||
|
||||
echo " · 該擋：這條指令實際推的那個 repo 的 origin 是 github.com"
|
||||
runc 2 "$W/shell" 'git push origin x'
|
||||
runc 2 "$W/body" "git -C $W/shell push origin x"
|
||||
has "$W/shell" " 訊息說得出是哪個目錄的 remote 指向 GitHub（人才知道自己站錯地方還是推錯地方）"
|
||||
runc 2 "$W/body" "cd $W/shell && git push origin x"
|
||||
runc 2 "$W/shell" "(cd $W/body && true); git push origin x"
|
||||
runc 2 "$W/shell" 'cd $SOMEWHERE && git push origin x'
|
||||
echo " · 不該擋：這條指令實際推的那個 repo 的 origin 不是 github.com（★＝6629 那天被擋的形狀）"
|
||||
runc 0 "$W/shell" "git -C $W/body push origin x"
|
||||
runc 0 "$W/shell" "git -C $W/body push -u origin feat/x"
|
||||
runc 0 "$W/shell" "cd $W/body && git push origin x"
|
||||
runc 0 "$W/body/sub" 'git push origin x'
|
||||
runc 0 "$W/shell" "cd $W && git -C body push origin x"
|
||||
runc 0 "$W/body" "(cd $W/shell && true); git push origin x"
|
||||
|
||||
echo
|
||||
echo "$PASS/$((PASS+FAIL)) 通過"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
|
||||
Executable
+129
@@ -0,0 +1,129 @@
|
||||
#!/usr/bin/env bash
|
||||
# scripts/release-check 的迴歸測試（inkstone/ISEP#67）
|
||||
#
|
||||
# 兩個方向都要有證據：
|
||||
# A 群「該擋」（exit 2）——現行版本缺 tag 或缺 release，且**說得出缺哪一站＋怎麼補**
|
||||
# （這就是工單驗收 4：「故意漏一步 → 管線要擋下來並說出缺哪一站」）
|
||||
# B 群「該過」（exit 0）——現行版本 tag＋release 都在；更舊版本缺件只黃字提醒不擋；
|
||||
# 指定版本時看的是那一版；裁定不補的版本不再黃字
|
||||
#
|
||||
# 🔴 全程離線（RELEASE_CHECK_FIXTURE），不打 Gitea。fixture 直接給收貨端與送貨端的事實。
|
||||
set -u
|
||||
TOOL="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/release-check}"
|
||||
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
|
||||
PASS=0; FAIL=0; N=0
|
||||
|
||||
mkfx() { # $1=檔名 之後 heredoc
|
||||
cat > "$TMP/$1"
|
||||
}
|
||||
|
||||
# t <期望exit> <說明> <必須出現的字串> <fixture檔> [額外參數…]
|
||||
t() {
|
||||
want="$1"; desc="$2"; must="$3"; fx="$4"; shift 4
|
||||
N=$((N+1))
|
||||
out=$(RELEASE_CHECK_FIXTURE="$TMP/$fx" python3 "$TOOL" "$@" 2>&1); rc=$?
|
||||
ok=1
|
||||
[ "$rc" -eq "$want" ] || ok=0
|
||||
if [ -n "$must" ] && ! printf '%s' "$out" | grep -qF "$must"; then ok=0; fi
|
||||
if [ "$ok" -eq 1 ]; then printf ' ✅ %s\n' "$desc"; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ %s —— 期望 exit=%s%s，實得 exit=%s\n' "$desc" "$want" \
|
||||
"${must:+ 且輸出含「$must」}" "$rc"
|
||||
printf '%s\n' "$out" | sed -n '1,16p' | sed 's/^/ /'; FAIL=$((FAIL+1))
|
||||
fi
|
||||
}
|
||||
# not <說明> <不該出現的字串> <fixture檔> [額外參數…]
|
||||
not() {
|
||||
desc="$1"; bad="$2"; fx="$3"; shift 3
|
||||
N=$((N+1))
|
||||
out=$(RELEASE_CHECK_FIXTURE="$TMP/$fx" python3 "$TOOL" "$@" 2>&1)
|
||||
if printf '%s' "$out" | grep -qF "$bad"; then
|
||||
printf ' ❌ %s —— 不該出現卻出現了：%s\n' "$desc" "$bad"; FAIL=$((FAIL+1))
|
||||
else printf ' ✅ %s\n' "$desc"; PASS=$((PASS+1)); fi
|
||||
}
|
||||
|
||||
echo "── A 群：該擋（現行版本送貨端斷了，要說出缺哪一站）──"
|
||||
|
||||
# A1：這就是 2026-09-07 的真實狀態——v0.24.0 有 tag、沒 release
|
||||
mkfx a1.json <<'JSON'
|
||||
{"current":"0.24.0",
|
||||
"dingban":["0.24.0","0.23.0","0.22.0"],
|
||||
"tags":["v0.24.0","v0.23.0","v0.22.0"],
|
||||
"releases":["v0.22.0"],
|
||||
"loaded":"0.24.0"}
|
||||
JSON
|
||||
t 2 "現行 v0.24.0 有 tag 沒 release → 擋，且指名缺 release 站" "缺這一站：release（Gitea）" a1.json
|
||||
t 2 "缺 release 時給得出補法，而且是正本的絕對路徑（貼了就能跑）" "$(dirname "$TOOL")/release-ship v0.24.0" a1.json
|
||||
|
||||
# A2：連 tag 都沒有（定版了、tag 沒推）
|
||||
mkfx a2.json <<'JSON'
|
||||
{"current":"0.20.0",
|
||||
"dingban":["0.20.0","0.18.0"],
|
||||
"tags":["v0.18.0"],
|
||||
"releases":["v0.18.0"],
|
||||
"loaded":"0.20.0"}
|
||||
JSON
|
||||
t 2 "現行版本連 tag 都沒有 → 擋，且指名缺 tag 站" "缺這一站：tag（Gitea）" a2.json
|
||||
t 2 "缺 tag 時給得出補法（push tag）" "git push origin v0.20.0" a2.json
|
||||
|
||||
# A3：指定版本 → 判的是那一版
|
||||
mkfx a3.json <<'JSON'
|
||||
{"current":"0.24.0",
|
||||
"dingban":["0.24.0","0.23.0"],
|
||||
"tags":["v0.24.0","v0.23.0"],
|
||||
"releases":["v0.24.0"],
|
||||
"loaded":"0.24.0"}
|
||||
JSON
|
||||
t 2 "指定 v0.23.0 而它沒 release → 擋（就算工作樹宣稱的 v0.24.0 是好的）" "現行版本 v0.23.0 的送貨端斷了" a3.json v0.23.0
|
||||
t 0 "同一份事實不指定版本 → 看 v0.24.0，放行" "送貨端完成" a3.json
|
||||
|
||||
echo "── B 群：該過（現行版本 tag＋release 都在）──"
|
||||
|
||||
# B1：全部送到
|
||||
mkfx b1.json <<'JSON'
|
||||
{"current":"0.18.0",
|
||||
"dingban":["0.18.0","0.9.0"],
|
||||
"tags":["v0.18.0","v0.9.0"],
|
||||
"releases":["v0.18.0","v0.9.0"],
|
||||
"loaded":"0.18.0"}
|
||||
JSON
|
||||
t 0 "現行版本 tag＋release 都在 → 放行" "送貨端完成" b1.json
|
||||
|
||||
# B2：現行版本送到了，但更舊的 定版 版本缺件 → 仍放行，只黃字
|
||||
mkfx b2.json <<'JSON'
|
||||
{"current":"0.24.0",
|
||||
"dingban":["0.24.0","0.23.0","0.22.0"],
|
||||
"tags":["v0.24.0","v0.22.0"],
|
||||
"releases":["v0.24.0","v0.22.0"],
|
||||
"loaded":"0.24.0"}
|
||||
JSON
|
||||
t 0 "現行送到、舊版缺件 → 放行（不 over-block）" "送貨端完成" b2.json
|
||||
t 0 "舊版缺件會被黃字提醒出來" "v0.23.0 缺：tag（Gitea）＋release（Gitea）" b2.json
|
||||
|
||||
# B3：載入端落後（送貨端完成，但這個 session 掛的是舊版）→ 仍 exit 0，但要報出來
|
||||
mkfx b3.json <<'JSON'
|
||||
{"current":"0.22.0",
|
||||
"dingban":["0.22.0","0.18.0"],
|
||||
"tags":["v0.22.0","v0.18.0"],
|
||||
"releases":["v0.22.0","v0.18.0"],
|
||||
"loaded":"0.21.0"}
|
||||
JSON
|
||||
t 0 "載入端落後 → 送貨端仍算完成（exit 0）" "送貨端完成" b3.json
|
||||
t 0 "載入端落後會被明確報出＋給 update／重啟的修法" "載入端落後" b3.json
|
||||
|
||||
# B4：裁定不補的三版（總管 09-07）→ 不再黃字，表上標「裁定不補」
|
||||
mkfx b4.json <<'JSON'
|
||||
{"current":"0.24.0",
|
||||
"dingban":["0.24.0","0.22.0","0.21.0","0.20.0","0.19.0","0.18.0"],
|
||||
"tags":["v0.24.0","v0.22.0","v0.18.0"],
|
||||
"releases":["v0.24.0","v0.22.0","v0.18.0"],
|
||||
"loaded":"0.24.0"}
|
||||
JSON
|
||||
t 0 "v0.19／0.20／0.21 缺 tag＋release 但已裁定不補 → 表上標出裁決出處" "裁定不補（inkstone/ISEP#67 → 6574）" b4.json
|
||||
not "裁定不補的版本不再黃字念（天天念會被學會忽略）" "更舊的定版版本也缺件" b4.json
|
||||
t 2 "但指定 v0.21.0 來問，它就是現行、照擋（裁決只免黃字，不改事實）" "現行版本 v0.21.0 的送貨端斷了" b4.json v0.21.0
|
||||
|
||||
echo ""
|
||||
echo "──────────────────────────────"
|
||||
printf '共 %d 項：✅ %d ／ ❌ %d\n' "$N" "$PASS" "$FAIL"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
Executable
+116
@@ -0,0 +1,116 @@
|
||||
#!/usr/bin/env bash
|
||||
# scripts/release-ship 的迴歸測試（inkstone/ISEP#67）
|
||||
#
|
||||
# 兩個方向都要有證據：
|
||||
# A 群「該擋」（exit 2）——前置條件沒滿足就不給建 release，且說得出是哪一個前置
|
||||
# ① 那個 tag 的樹裡 plugin.json 跟 tag 號碼對不上 ② Gitea 上沒那個 tag ③ 版本寫法不對
|
||||
# B 群「該放行」（exit 0）——前置都在就建；release 已存在則冪等不重複建；--dry-run 不 POST；
|
||||
# 🔴 **不是最新的那個 tag 也建得了**（總管 09-07 在 v0.23.0 被擋的那個情境）
|
||||
#
|
||||
# 🔴 全程離線（RELEASE_SHIP_FIXTURE ＋ RELEASE_SHIP_SINK），不打 Gitea、不建任何真 release。
|
||||
# fixture 的形狀見 hooks/lib/release_chain.py `Chain` 的註解。
|
||||
set -u
|
||||
TOOL="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/release-ship}"
|
||||
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
|
||||
PASS=0; FAIL=0; N=0
|
||||
|
||||
# 🔴 工作樹故意擺一個跟任何 tag 都對不上的版本：前置①要是偷看工作樹，B 群會整組紅
|
||||
WT="$TMP/worktree"; mkdir -p "$WT/.claude-plugin"
|
||||
printf '{"name":"isep","version":"9.9.9"}\n' > "$WT/.claude-plugin/plugin.json"
|
||||
export CLAUDE_PROJECT_DIR="$WT"
|
||||
|
||||
# t <期望exit> <說明> <必須出現的字串> <fixture檔> [額外參數…]
|
||||
t() {
|
||||
want="$1"; desc="$2"; must="$3"; fx="$4"; shift 4
|
||||
N=$((N+1))
|
||||
rm -f "$TMP/sink.json" "$TMP/sink.json.checkfx.json"
|
||||
out=$(RELEASE_SHIP_FIXTURE="$TMP/$fx" RELEASE_SHIP_SINK="$TMP/sink.json" \
|
||||
python3 "$TOOL" "$@" 2>&1); rc=$?
|
||||
ok=1
|
||||
[ "$rc" -eq "$want" ] || ok=0
|
||||
if [ -n "$must" ] && ! printf '%s' "$out" | grep -qF "$must"; then ok=0; fi
|
||||
if [ "$ok" -eq 1 ]; then printf ' ✅ %s\n' "$desc"; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ %s —— 期望 exit=%s%s，實得 exit=%s\n' "$desc" "$want" \
|
||||
"${must:+ 且輸出含「$must」}" "$rc"
|
||||
printf '%s\n' "$out" | sed -n '1,14p' | sed 's/^/ /'; FAIL=$((FAIL+1))
|
||||
fi
|
||||
}
|
||||
# not <說明> <不該出現的字串> <fixture檔> [額外參數…]
|
||||
not() {
|
||||
desc="$1"; bad="$2"; fx="$3"; shift 3
|
||||
N=$((N+1))
|
||||
rm -f "$TMP/sink.json" "$TMP/sink.json.checkfx.json"
|
||||
out=$(RELEASE_SHIP_FIXTURE="$TMP/$fx" RELEASE_SHIP_SINK="$TMP/sink.json" \
|
||||
python3 "$TOOL" "$@" 2>&1)
|
||||
if printf '%s' "$out" | grep -qF "$bad"; then
|
||||
printf ' ❌ %s —— 不該出現卻出現了：%s\n' "$desc" "$bad"; FAIL=$((FAIL+1))
|
||||
else printf ' ✅ %s\n' "$desc"; PASS=$((PASS+1)); fi
|
||||
}
|
||||
|
||||
echo "── A 群：該擋（前置條件沒滿足）──"
|
||||
|
||||
# A1：tag 的樹裡 plugin.json 跟 tag 號碼對不上（這種 tag 本來就不該存在）
|
||||
cat > "$TMP/a1.json" <<'JSON'
|
||||
{"tags":["v0.22.0"],"manifest":{"v0.22.0":"0.21.0"},"releases":[]}
|
||||
JSON
|
||||
t 2 "tag 的樹裡 plugin.json 是 0.21.0、tag 是 v0.22.0 → 擋，指名前置①" "前置①" a1.json v0.22.0
|
||||
t 2 "前置①被擋時講得出修法（刪 tag、重新定版）" "重新定版" a1.json v0.22.0
|
||||
|
||||
# A2：Gitea 上沒有這個 tag
|
||||
cat > "$TMP/a2.json" <<'JSON'
|
||||
{"tags":["v0.18.0"],"manifest":{"v0.18.0":"0.18.0"},"releases":["v0.18.0"]}
|
||||
JSON
|
||||
t 2 "Gitea 沒有該 tag → 擋，指名前置②＋叫人先推 tag" "git push origin v0.22.0" a2.json v0.22.0
|
||||
|
||||
# A3：版本寫法不對
|
||||
cat > "$TMP/a3.json" <<'JSON'
|
||||
{"tags":[],"releases":[]}
|
||||
JSON
|
||||
t 2 "版本寫法不對 → 擋" "版本寫法" a3.json "0.22"
|
||||
|
||||
echo "── B 群：該放行 ──"
|
||||
|
||||
# B1：前置都在、release 還沒建 → 建（fixture sink），然後覆核通過
|
||||
cat > "$TMP/b1.json" <<'JSON'
|
||||
{"current":"0.22.0","dingban":["0.22.0","0.18.0"],"loaded":"0.22.0",
|
||||
"tags":["v0.22.0","v0.18.0"],"manifest":{"v0.22.0":"0.22.0","v0.18.0":"0.18.0"},
|
||||
"releases":["v0.18.0"],
|
||||
"commits":{"v0.18.0...v0.22.0":["定版 v0.22.0（ship-check 送得到）","修一支閘（inkstone/ISEP#1）"]}}
|
||||
JSON
|
||||
t 0 "前置齊全、release 缺 → 建起來" "已建立 release「v0.22.0 — ship-check 送得到」" b1.json v0.22.0
|
||||
t 0 "建完回頭跑 release-check 覆核（問收貨端）" "覆核（release-check v0.22.0" b1.json v0.22.0
|
||||
t 0 "note 自動從 Gitea 的 commit 清單生成（不靠本機 git log）" "commit 清單自動生成" b1.json v0.22.0
|
||||
|
||||
# B2：release 已存在 → 冪等，不重複建、不動它
|
||||
cat > "$TMP/b2.json" <<'JSON'
|
||||
{"current":"0.18.0","dingban":["0.18.0"],"loaded":"0.18.0",
|
||||
"tags":["v0.18.0"],"manifest":{"v0.18.0":"0.18.0"},"releases":["v0.18.0"]}
|
||||
JSON
|
||||
t 0 "release 已存在 → 冪等放行、不重複建" "本來就在了" b2.json v0.18.0 --notes-file "$TMP/b2.json"
|
||||
not "release 已存在時不准說「已建立」（09-05 那句假綠）" "已建立 release" b2.json v0.18.0
|
||||
|
||||
# B3：--dry-run 不 POST
|
||||
cat > "$TMP/b3.json" <<'JSON'
|
||||
{"tags":["v0.22.0"],"manifest":{"v0.22.0":"0.22.0"},"releases":[]}
|
||||
JSON
|
||||
t 0 "--dry-run 全走一遍但不 POST" "不 POST" b3.json v0.22.0 --dry-run
|
||||
not "--dry-run 不寫 sink（真的沒建）" "fixture-created" b3.json v0.22.0 --dry-run
|
||||
|
||||
# B4：🔴 不是最新的 tag 也建得了（總管 09-07：在 v0.23.0 的 checkout 跑被擋，訊息說最新是 v0.24.0）
|
||||
cat > "$TMP/b4.json" <<'JSON'
|
||||
{"current":"0.24.0","dingban":["0.24.0","0.23.0","0.22.0"],"loaded":"0.24.0",
|
||||
"tags":["v0.24.0","v0.23.0","v0.22.0"],
|
||||
"manifest":{"v0.24.0":"0.24.0","v0.23.0":"0.23.0","v0.22.0":"0.22.0"},
|
||||
"releases":["v0.22.0"],
|
||||
"commits":{"v0.22.0...v0.23.0":["定版 v0.23.0（雲端拿得到票與主線）"]}}
|
||||
JSON
|
||||
t 0 "最新 tag 是 v0.24.0，要建的是 v0.23.0 → 照建（前置①看 tag 的樹，不看「最新」）" \
|
||||
"已建立 release「v0.23.0 — 雲端拿得到票與主線」" b4.json v0.23.0
|
||||
t 0 "覆核的是 v0.23.0 這一版，不是工作樹宣稱的 0.24.0" "v0.23.0 ✅ ✅ ✅ ←" b4.json v0.23.0
|
||||
not "工作樹 plugin.json 是 9.9.9 也不會被拿來比（B 群全綠就是證據，這條釘住訊息）" "9.9.9" b4.json v0.23.0
|
||||
|
||||
echo ""
|
||||
echo "──────────────────────────────"
|
||||
printf '共 %d 項：✅ %d ／ ❌ %d\n' "$N" "$PASS" "$FAIL"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
@@ -323,3 +323,91 @@ leo 當場：「**這些為什麼不寫到票裡？**」
|
||||
離線測試的假 CF 對 secret PUT 回 200，27/27 全綠；第一次真跑 CF 回 **201**，工具把它講成「失敗」——
|
||||
而獨立用 CF API 一列，那把 secret 明明種進去了。全綠的測試證明的是「工具跟假伺服器合得來」，
|
||||
不是「工具跟 CF 合得來」。⇒ 假伺服器的回應碼要抄真的（現在回 201），而且**離線全綠之後一定要真跑一次**。
|
||||
|
||||
## ⚠️ MISTAKE: 前置條件判的是「手邊的樹」，而要送出去的東西是「那個 tag 的樹」
|
||||
|
||||
票: `inkstone/ISEP#67` → comment 6574
|
||||
日期: 2026-09-07
|
||||
|
||||
症狀: 總管在 v0.23.0 的 checkout 跑 `release-ship v0.23.0 --dry-run` 被擋，訊息說
|
||||
「最新 tag 是 v0.24.0」。v0.23.0 的樹明明一致，只因為它不是最新的那個 tag，
|
||||
就永遠建不了 release——而 09-07 缺 release 的正是 v0.23.0 與 v0.24.0 兩個。
|
||||
|
||||
實查: 09-05 那版 release-ship 的前置①直接跑 `check-version-consistency.sh`
|
||||
（工作樹 `plugin.json` vs **本機最新** tag）當判準，理由寫著「不另立判準」。
|
||||
但那支守的是「打 tag 那一刻 main 跟最新 tag 一致」（release-tag-guard.sh 的事），
|
||||
建 release 這一刻要問的是「**要送的那個 tag 的樹**，自己講的版本對不對」——
|
||||
工作樹可能是任何分支（release-ship 本身就是在一條 feature 分支上寫的），跟那個 tag 無關。
|
||||
|
||||
原因: 「重用既有判準」是對的方向，但重用之前要問「**它判的是哪個對象**」。
|
||||
對象錯了，判準再對也只是在檢查一個跟交付物無關的東西——而且會用一條看起來
|
||||
很有道理的訊息把正確的操作擋掉（誤攔）。
|
||||
|
||||
正確做法: 前置①改成問 Gitea `contents/.claude-plugin/plugin.json?ref=<tag>`，
|
||||
比的是 tag 自己的樹；工作樹的版本完全不參與（`scripts/test-release-ship.sh` 把工作樹
|
||||
故意擺成 `9.9.9`，B 群全綠才算證明）。同時把「問 Gitea」收成一份
|
||||
（`hooks/lib/release_chain.py`），release-ship／release-check／SessionStart 信標三處共用——
|
||||
判準散在三處各寫一份，就是 `leo21c-write-guard.sh` 那一族漂掉的路。
|
||||
|
||||
📌 判準：**送出去之前，先問「我判的是不是我要送的那個東西」**。
|
||||
工作樹、最新 tag、main——都不是；tag 指到的那棵樹才是。
|
||||
|
||||
## ⚠️ MISTAKE: 派工單的紅線建立在「Gitea 匿名讀得到」上，而那件事沒人打過一次
|
||||
|
||||
票: `inkstone/ISEP#140`（母票 `inkstone/ISEP#130`）
|
||||
日期: 2026-09-07
|
||||
|
||||
症狀: 工單 comment 6611 寫「主線指標在 Gitea 上讀得到（匿名讀 raw 檔或 API contents，D20 讀不擋）」，
|
||||
紅線據此寫成「讀 Gitea 一律匿名，不帶 token」。開工第一個指令匿名打
|
||||
`/api/v1/repos/inkstone/InkStoneCo/raw/…`、`/contents/…`、`/repos/inkstone/InkStoneCo` ⇒ **三個都 404**。
|
||||
`inkstone/ISEP` 同樣的三個端點 200 ⇒ 不是網路，是 InkStoneCo 在 Gitea 是 private。
|
||||
|
||||
實查: 照紅線字面做（純匿名）⇒ 這張票在真環境永遠讀不到，測試卻可以全綠（假伺服器照自己的想像回 200，
|
||||
同日 #137 那條坑的翻版）。而 SessionStart 同一條鏈上的 `countdown-milestone-refresh.sh` 與
|
||||
`mainline refresh` 本來就帶 `GITEA_TOKEN_CLAUDE_CODE` 打 Gitea；D20 管的是 GitHub 那個會被 flag 的帳號，
|
||||
不是 Gitea 機器帳號的讀。
|
||||
|
||||
原因: 「讀得到」是一個可以一個指令驗掉的事實宣稱，卻被當成前提直接寫進紅線；收工方若不打那一下，
|
||||
就會交出一個「測試全綠、雲端永遠退回舊線」的東西——形狀跟 #137「假伺服器回 200」一模一樣。
|
||||
|
||||
正確做法: 匿名優先、匿名被拒（401／403／404）且環境拿得到 token 才帶 token 再問一次（`fetch_gitea()`）；
|
||||
假伺服器要有 private 模式（匿名 404、帶 token 200）照真 Gitea 回；真跑兩條都跑（帶 token 讀到、拔 token 退回）。
|
||||
收到「X 讀得到／X 不存在」這種宣稱先打一次再動手——那是一個 curl 的成本。
|
||||
|
||||
## ⚠️ MISTAKE: 閘看的是 hook 自己的環境／cwd，不是指令要動的那個 repo
|
||||
|
||||
票: `inkstone/ISEP#109`（comment 6587／6629）；`inkstone/ISEP#125` 是缺陷 A 與 D 的原票（09-02 開）
|
||||
日期: 2026-09-07
|
||||
|
||||
症狀: 同一天兩支閘同一個病。① `line-needs-own-worktree.sh` 印的出路
|
||||
`WORKTREE_OK=1 git -C … checkout …` 照貼三次三次被擋。
|
||||
② `github-contact-guard.sh` 把 `git -C <InkStoneCo> push origin x` 判成「remote origin 指向 GitHub」擋下
|
||||
（總管站在薄殼 cwd；InkStoneCo 的 origin 明明是 Gitea），連 `-C` 都沒看；
|
||||
同日 arcrun-hand 在 `Arcrun#176` comment 6614 撞到同一支。當天只能改用完整 Gitea 網址推，
|
||||
而那種形狀分類器又時過時不過。
|
||||
|
||||
實查: ① hook 讀的是 `$WORKTREE_OK` 這個**環境變數**。PreToolUse hook 跟指令不是同一個行程，
|
||||
指令字串裡的 `WORKTREE_OK=1` 是給 git 的前綴賦值，hook 的行程裡永遠沒有它
|
||||
⇒ 那條出路在 Claude Code 底下**結構上**走不通，不是偶爾。（`NOT_MY_BRANCH_OK` 同形狀，見下）
|
||||
② hook 拿 **payload 的 cwd** 去 `git remote get-url origin`，而 `-C`／`cd … &&` 改的是
|
||||
指令自己的目錄。`main-and-prod-push-guard.sh` 08-23 就為同一個病接了
|
||||
`lib/push_target_dir.py`（`inkstone/ISEP#30` comment 3949）——**同一族的另一支沒跟上**，
|
||||
跟 `leo21c-write-guard.sh` 那條坑一模一樣（修一份不會帶動另外兩份）。
|
||||
修之前拿新測試跑舊閘：① 3 條紅；② **7 條紅——4 條誤攔之外還有 3 條漏擋**
|
||||
（站在 Gitea 那份 `git -C <薄殼> push origin x` 舊版放行）。cwd 不只讓它誤擋，也讓 D20 有洞。
|
||||
|
||||
原因: 兩支都在回答「這條指令會動到哪個 repo」，卻拿「hook 自己站在哪」當答案。
|
||||
本機一份目錄時兩者恰好相等，所以測試全綠；雲端薄殼＋真身兩份目錄一分開就露餡。
|
||||
而「出路走不走得通」那一格從來沒被測過——測的只有「擋不擋」。
|
||||
|
||||
正確做法:
|
||||
- 出路要是 hook **讀得到**的形狀：認指令字串裡的字面前綴（判準是位置——前綴必須掛在會移動 HEAD
|
||||
的那條 git 指令上；印個字、掛在別的指令上、寫在引號裡都不算），或 `gate-ok` 同款的戳記檔。
|
||||
- 「這條指令在哪個 repo 執行」一律走 `hooks/lib/push_target_dir.py`／`checkout_target_dir.py`
|
||||
解 cd 鏈與 `-C`，解不出來才退回 cwd（退回的方向是照舊，不是放寬）。改判準時 `grep -l` 找同一族
|
||||
（`main-and-prod-push-guard`／`github-contact-guard`／`line-needs-own-worktree`／`not-my-branch-guard`）一次看齊。
|
||||
- 測試要有一條「把閘印出來的那一行原樣餵回去」（A24 (61)–(63)），還要有 payload 帶 `cwd`、
|
||||
cwd 與目標 repo **不同**的案例（A39 後 12 條）——本機一份目錄的測試驗不出這個病。
|
||||
|
||||
📌 沒在本票修的同形狀：`not-my-branch-guard.sh` 的 `NOT_MY_BRANCH_OK=1 git commit …` 同樣只讀環境變數
|
||||
（第 28 行），沒實測、沒動——它認的動作是 commit，不是 push_target_dir 那條線的事，另報。
|
||||
|
||||
Reference in New Issue
Block a user