Compare commits
10 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 3f622ba646 | |||
| bebbbd2c11 | |||
| eb7c3656be | |||
| 16c03e46c1 | |||
| 99abdf725b | |||
| accedb5898 | |||
| 77a2032858 | |||
| be09353330 | |||
| 81368f451f | |||
| a9e30fc6e7 |
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "isep",
|
||||
"description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源:52 支機械閘(67 條註冊,白話盤點見 docs/hooks-inventory.md)、7 支 slash command、2 支 skill、28 支腳本,外加治理規範與標籤真相源。本機與雲端裝同一份,沒有子集。",
|
||||
"version": "0.10.0",
|
||||
"description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源:54 支機械閘(69 條註冊,白話盤點見 docs/hooks-inventory.md)、7 支 slash command、2 支 skill、39 支腳本,外加治理規範與標籤真相源。本機與雲端裝同一份,沒有子集。",
|
||||
"version": "0.11.0",
|
||||
"keywords": [
|
||||
"inkstone",
|
||||
"guardrails",
|
||||
|
||||
@@ -23,7 +23,7 @@
|
||||
|
||||
| | 數量 | 是什麼 |
|
||||
|---|---|---|
|
||||
| `hooks/` | 48 支 + `hooks.json` | 全部機械閘(PreToolUse/Stop/SubagentStop/SessionStart/PostToolUse 共 59 條註冊;`ISEP#60` 移除 `claim-verify-police.sh`/`subagent-claim-worksheet.sh` 這對自造機制,改由 Gitea 原生三格承接見 `ISEP#59`) |
|
||||
| `hooks/` | 54 支 + `hooks.json` | 全部機械閘(PreToolUse/Stop/SubagentStop/SessionStart/PostToolUse 共 69 條註冊,2026-08-28 在樹上實數;`ISEP#60` 移除 `claim-verify-police.sh`/`subagent-claim-worksheet.sh` 這對自造機制,改由 Gitea 原生三格承接見 `ISEP#59`) |
|
||||
| `commands/` | 7 支 | `/wiki-recall` `/ship-check` `/cp-write` … |
|
||||
| `skills/` | 2 支 | |
|
||||
| `scripts/` | 23 支 | `ticket`/`github-arm.sh`/`gitea-bootstrap.sh` … |
|
||||
|
||||
+101
@@ -91,6 +91,40 @@ bash scripts/test-baton-handback-guard.sh
|
||||
- 「不該報」4 條任一紅 ⇒ 每條線收工都被念一次,警報會被學會忽略
|
||||
- 「票已關」那條紅 ⇒ 棒子已經到終點還在催,那是最典型的假警報
|
||||
|
||||
### A14 — PR 一定要有結論:52 條
|
||||
```
|
||||
bash hooks/tests/pr-verdict-guard.test.sh
|
||||
```
|
||||
**該看到**:`52 通過 / 0 失敗`。全程離線(走 `PR_VERDICT_FIXTURE`),
|
||||
**不打 Gitea、不開測試 PR、不留任何測試票**;狀態檔走 `PR_VERDICT_STATE_DIR`。
|
||||
|
||||
**它在守什麼**(`inkstone/ISEP#81`,2026-08-27 實查):最久的三個 open PR 躺了兩星期
|
||||
(`inkstone/arcrun-rag#91` 14 天、`inkstone/Arcrun#116` 14 天、`inkstone/Arcrun#104` 15 天),
|
||||
而 v0.9.0 的 46 支閘**一支都沒有在管 PR**。票看起來是「已交付」,
|
||||
東西卻沒進 main ⇒ 沒進版本 ⇒ **leo 手上永遠不會出現它**。
|
||||
|
||||
**失敗**:
|
||||
- B 群(⑨⑩⑪,票上那三個真跡)任一紅 ⇒ 今天這個形狀會再發生一次
|
||||
- C 群 ⑭⑰ 紅 ⇒ 驗收條件 1/3 沒過:「放著不管」抓不到,或「merge 了分支還在」放行
|
||||
- **A 群任何一條紅 ⇒ 誤攔,這比漏擋嚴重**。②③特別重要:
|
||||
指派給人/掛 Human 之後還在點名,就是 ISEP v0.6.0 divergence §B4 記過的那個坑
|
||||
(「`s/review` 佇列非空即 block」⇒ 佇列本來就不會空 ⇒ **總管永遠停不下來**)
|
||||
- E 群 ㉙ 紅 ⇒ 閘訊息裡承諾的出路(「把它指派給那個人,本閘立刻不再點名它」)是假的
|
||||
- D 群 ㉓ 紅 ⇒ 判準從「識別碼比對」滑成「只要提到票號就放行」,閘會被任何一句話關掉
|
||||
|
||||
> 📌 **真跡不只在 fixture 裡跑過**:同一支閘打真實 Gitea 也驗過,
|
||||
> 一次點名 7 個沒有結論的 PR,含票上那三個(15/14/14 天)。
|
||||
> 指令:`printf '{"session_id":"x","transcript_path":"/nonexistent"}' | bash hooks/pr-verdict-guard.sh`
|
||||
> ——**唯讀,不改動任何 PR**。
|
||||
|
||||
### A15 — 給結論的那支工具自己說得出要打哪幾通 API
|
||||
```
|
||||
python3 scripts/pr-verdict list
|
||||
python3 scripts/pr-verdict merge inkstone/ISEP#71 --dry-run
|
||||
```
|
||||
**該看到**:`list` 印出 open PR 與「有沒有人被指派」;`merge --dry-run` 印出
|
||||
`[dry-run] POST …/pulls/71/merge` 與 `[dry-run] DELETE …/branches/<分支>`,**一通都不真的送出**。
|
||||
**失敗**:`--dry-run` 底下出現真實的寫入結果 ⇒ 這支工具沒辦法在按下去之前被檢查。
|
||||
### A14 — 每一則回覆都自己說出拖了多久:20 條
|
||||
```
|
||||
bash hooks/tests/countdown-guard.test.sh
|
||||
@@ -131,6 +165,68 @@ bash hooks/tests/prod-write-guard.test.sh hooks/prod-write-guard.sh
|
||||
- 「卡點二」2 條任一紅 ⇒ 「談論它」又被當成「執行它」(同款第八次),
|
||||
或是剝了內文之後連真的部署都放行了
|
||||
|
||||
### A16 — 一次交貨 = 一份清單(跨 repo 版本組合):21 條
|
||||
```
|
||||
bash scripts/test-release-manifest.sh
|
||||
```
|
||||
**該看到**:`通過 21 條,失敗 0 條`。全程離線(`RELEASE_MANIFEST_FIXTURE`),
|
||||
**不打 Gitea、不建任何真的 release**;清單寫在 `mktemp` 的目錄,不碰 repo 裡的 `releases/`。
|
||||
|
||||
**它在守什麼**(`inkstone/ISEP#84`):一次交貨常常同時動到好幾個 repo,
|
||||
而「這一版 = 哪幾個 repo 的哪幾版」**沒有任何地方記著** ⇒ 退版只退了其中一個,
|
||||
剩下的還停在新版 ⇒ **變成一組從來沒測過的組合**。
|
||||
|
||||
**失敗**:
|
||||
- ⑨⑩ 紅 ⇒ 驗收 1 沒過:**版本號寫上去就算數**,沒有真的去 Gitea 抓過
|
||||
(「寫上去」跟「存在」是兩件事,而清單的用處完全建立在後者)
|
||||
- ⑱ 紅 ⇒ 驗收 3 沒過:**只退其中一個 repo 沒有被擋下來**,那正是票上那個病
|
||||
- ⑯⑰⑲ 任一紅 ⇒ 驗收 2 沒過:退版沒有吐出整份清單的每一格
|
||||
(包含「已經在目標版本、不必動」那幾格——列出來才證明沒有一格被漏掉)
|
||||
- ⑫ 紅 ⇒ 凍結過的清單還能再加東西,「凍結」兩個字就沒有意義了
|
||||
- ⑳㉑ 紅 ⇒ 驗收 4 沒過:leo 打開 `INDEX.md` 看不出「我現在手上是哪一版」
|
||||
|
||||
### A17 — 每次結案都留下估多久/花多久/差多少:23 條
|
||||
```
|
||||
bash scripts/test-milestone-account.sh
|
||||
```
|
||||
**該看到**:`通過 23 條,失敗 0 條`。全程離線(`MILESTONE_ACCOUNT_FIXTURE` =一份假的
|
||||
Gitea 回應表),時鐘用 `MILESTONE_ACCOUNT_NOW` 定住,帳本寫在 `mktemp` 目錄,
|
||||
**不打 Gitea、不關任何真的 milestone**。
|
||||
|
||||
**它在守什麼**(`inkstone/ISEP#85`,leo 2026-08-27 說那天「**拖時間**」):
|
||||
拖了多久、比預計多拖多少、為什麼拖——**沒有任何數字**。偵測器早就有了
|
||||
(`mainline-idle-guard.sh`/`factory-idle-guard.sh`),**但沒有人把它算成帳**。
|
||||
|
||||
**失敗**:
|
||||
- ①②③④ 任一紅 ⇒ 驗收 1 沒過:三個數字不是自己算出來的
|
||||
- ⑤⑥ 紅 ⇒ 驗收 2 沒過:差超過 ±25% 卻能不挑代號就結案
|
||||
- ⑧ 紅 ⇒ 代號不再是封閉集合。**能統計的前提是分類有限**,這一格垮了統計就垮了
|
||||
- ⑨ 紅 ⇒ **挑一個時間軸撐不住的代號也能過**,等於「採信我自己說的」,
|
||||
而票上寫死證據一律從 Gitea 的時間軸取
|
||||
- ⑦ 紅 ⇒ **誤攔**:只差 -6% 也逼人挑代號。這比漏擋嚴重——每次結案都被念,
|
||||
人就學會繞過去
|
||||
- ⑭⑮⑯⑰ 任一紅 ⇒ 驗收 3 沒過:累積之後看不出哪一種原因最常發生
|
||||
- ⑱⑲ 紅 ⇒ 驗收 4 沒過:拿已經逾期的里程碑進去算不出數字
|
||||
|
||||
### A18 — 結案要記帳的那道閘:22 條
|
||||
```
|
||||
bash hooks/tests/milestone-account-guard.test.sh
|
||||
```
|
||||
**該看到**:`通過 22 條,失敗 0 條`。離線(帳本走 `MILESTONE_ACCOUNT_LEDGER`),
|
||||
純結構判斷、沒有語意判官,所以每次結果都一樣。
|
||||
|
||||
**失敗**:
|
||||
- **A 群任何一條紅 ⇒ 誤攔,這比漏擋嚴重。** ⑥⑦⑧⑪ 特別重要:
|
||||
`echo` 一段指令、`cat` 這支閘自己、commit 訊息裡提到、把指令寫進文件的 heredoc 內文
|
||||
——**四種都只是「談論它」,不是「執行它」**。這四格是本 repo 撞過很多次的同一個病
|
||||
(`strip_heredoc.py` 的檔頭記著兩次真跡)
|
||||
- ⑨⑩ 紅 ⇒ 走正門 `scripts/milestone-account close` 反而被自己的閘擋下,
|
||||
那道閘就等於封死了唯一的出路
|
||||
- ⑭⑮⑯⑰⑱ 任一紅 ⇒ 漏擋:換個寫法(`python urllib`、前面串一個無害指令、
|
||||
`--request` 長寫法、換一個 repo)就繞過去了
|
||||
- ⑲ 紅 ⇒ 訊息沒有點名目標,人看完不知道要對哪一個里程碑動手
|
||||
- ⑳㉑ 紅 ⇒ 「記過帳就放行」這個出路是假的,或者一記帳就把所有里程碑全開了
|
||||
|
||||
### A5 — 開票前的搜尋是跨 repo 的
|
||||
```
|
||||
python3 scripts/ticket where 標籤 模組化
|
||||
@@ -324,8 +420,13 @@ B2(信標那行)/B3(setup 輸出)/B4(閘的訊息)三個畫面
|
||||
| A3 打 tag 閘 | 總管 | ✅ 3/3 |
|
||||
| **A4 新增 Gitea 東西側門閘** | 總管 | ✅ 24/24(2026-08-27,inkstone/ISEP#72) |
|
||||
| **A13 戳記證明看過不是跑過** | 總管 | ✅ 17/17(2026-08-27,inkstone/ISEP#72→4873) |
|
||||
| **A14 PR 一定要有結論** | 總管 | ✅ 52/52(2026-08-28,inkstone/ISEP#81)+真實 Gitea 唯讀重演 |
|
||||
| **A15 pr-verdict --dry-run** | 總管 | ✅(2026-08-28) |
|
||||
| **A14 回覆自己說出拖了多久** | 總管 | ✅ 20/20(2026-08-28,inkstone/ISEP#63) |
|
||||
| **A15 發通知不等於部署** | 總管 | ✅ 37/37(2026-08-28,inkstone/ISEP#63) |
|
||||
| **A16 跨 repo 版本清單** | 總管 | ✅ 21/21(2026-08-28,inkstone/ISEP#84) |
|
||||
| **A17 估多久/花多久/差多少** | 總管 | ✅ 23/23(2026-08-28,inkstone/ISEP#85) |
|
||||
| **A18 結案要記帳的閘** | 總管 | ✅ 22/22(2026-08-28,inkstone/ISEP#85) |
|
||||
| A5 搜尋跨 repo | 總管 | ✅ |
|
||||
| A6 標籤對齊+冪等 | 總管 | ✅ 14 repo,第二次 0/0 |
|
||||
| **A9 人閘警察管路** | 總管 | ✅ 14/14(2026-08-26) |
|
||||
|
||||
+20
-3
@@ -1,4 +1,4 @@
|
||||
# 52 支閘,白話盤點表
|
||||
# 54 支閘,白話盤點表
|
||||
|
||||
> 回應 `inkstone/InkStoneCo#40`:「如果加入了,我應該可以白話文看到 hooks 的內容?」
|
||||
> 這份表就是那個「白話文」——不用點開任何 `.sh` 檔,一行看懂一支閘在管什麼。
|
||||
@@ -7,14 +7,15 @@
|
||||
|
||||
## 一句話結論
|
||||
|
||||
`hooks/` 底下有 **52 個 `.sh` 檔**,`hooks.json` 實際掛上 **67 條註冊**(同一支閘常被多種情境同時掛上);
|
||||
`hooks/` 底下有 **54 個 `.sh` 檔**,`hooks.json` 實際掛上 **69 條註冊**(同一支閘常被多種情境同時掛上);
|
||||
其中 **3 支檔案存在但沒被掛上**(2 支是待人填的空範本、1 支是刻意留著沒開的止血帶,見下面「未生效」表)。
|
||||
下面按「你會在什麼時候撞到它」分組,一支一行。
|
||||
|
||||
> 🔴 **這兩個數字上一版是錯的(2026-08-26 實際數過才發現)**:本頁原本寫「43 個檔、53 條註冊」,
|
||||
> 而當時真實是 **45 個檔、55 條註冊**——中間有兩支閘進來時沒有回頭改這裡。
|
||||
> 現在的寫法是實際數出來的:
|
||||
> `ls hooks/*.sh | wc -l` = 52;`grep -c '"command":' hooks/hooks.json` = 67。
|
||||
> `ls hooks/*.sh | wc -l` = 53;`grep -c '"command":' hooks/hooks.json` = 68。
|
||||
> `ls hooks/*.sh | wc -l` = 53;`grep -c '"command":' hooks/hooks.json` = 68。
|
||||
> ⚠️ **冒號不能省**:`grep -c '"command"'`(沒冒號)會連 `"type": "command"` 一起數到,回 **120**。
|
||||
> 本頁 2026-08-27 之前寫的是沒冒號那版——**照著它跑會拿到一個跟本頁不符的數字**。
|
||||
> **一份會偷偷過期的盤點表,跟沒有盤點表差不多**——見本頁最後「怎麼跟實況對帳」那段。
|
||||
@@ -38,6 +39,20 @@
|
||||
>
|
||||
> 📌 **`0.7.0`(`inkstone/ISEP#30`,2026-08-27)進來一支**:`mainline-idle-guard.sh`(F 組,Stop)。
|
||||
> 48→**49** 支、59→**60** 條,兩個數字都是加完之後當場數出來的(指令同上)。
|
||||
>
|
||||
> 📌 **`0.10.0`(`inkstone/ISEP#81`,2026-08-28)進來一支**:`pr-verdict-guard.sh`(F 組,Stop)。
|
||||
> 51→**52** 支、64→**65** 條,兩個數字都是加完之後當場數出來的(指令同上)。
|
||||
> 順手改掉一個過期的數字:描述欄長期寫「27 支腳本」,實數是 **34**
|
||||
> (`ls -p scripts | grep -v / | wc -l`)——**同一個病,只是換一欄。**
|
||||
|
||||
> 📌 **`inkstone/ISEP#85`(2026-08-28)進來一支**:`milestone-account-guard.sh`(A 組,PreToolUse/Bash)。
|
||||
> 53→**54** 支、68→**69** 條,兩個數字都是加完之後**在自己的樹上當場數出來的**
|
||||
> (指令同上),**不是拿上一版加一**——`system-dev/wiki/mistakes.md` 記著這條:
|
||||
> 那個數字是 leo 的驗收介面,多報就是假綠。
|
||||
> 順手修掉一個真的漂移:上一版「一句話結論」那一句**被貼了兩次**(同一行連續出現兩遍),
|
||||
> 而標頭寫 52、內文寫 53——**同一頁裡三個數字互相矛盾**,正是本頁自己警告過的那種病。
|
||||
> 另外描述欄的「38 支腳本」是把 `kbdb-live-exam/`/`lib/`/`patches/` 三個**目錄**也數進去了;
|
||||
> 用本頁寫死的那道指令(只數檔案)實數是 **39**。
|
||||
|
||||
---
|
||||
|
||||
@@ -67,6 +82,7 @@
|
||||
| `release-tag-guard.sh` | AI 想打版本 tag,但 `plugin.json` 裡寫的版本號跟 tag 對不上就擋下——避免「這裡說 0.2.0、那裡說 0.1.0」各說各話。 | 🛑 擋 |
|
||||
| `ticket-api-bypass-guard.sh` | AI 想繞過 `scripts/ticket` 工具、直接打 API 新增 Gitea 東西(開新票/milestone/label/PR,會漏掉「新增前先搜過」這道檢查)就擋下——不管是隱式 POST(urllib 傳 data= 沒寫 method)還是小寫 `requests.post(...)`。 | 🛑 擋 |
|
||||
| `milestone-due-guard.sh` | AI 想開一個新的里程碑(milestone)卻沒填期限就擋下,**填 `9999-01-01` 一樣擋**——那是「沒有期限」穿了一件期限的衣服,盤點時每一格看起來都有值,其實一格都沒有。只管「建里程碑」這個動作,查詢/改別的欄位都放行。 | 🛑 擋 |
|
||||
| `milestone-account-guard.sh` | AI 想直接打 API 把某個里程碑改成「已關閉」,卻**還沒留下「估多久/花多久/差多少/為什麼差」**就擋下。跟上一列是同一條線的兩端:那支管**開**里程碑要有真的期限,這支管**關**的時候要留下帳。走正門 `scripts/milestone-account close` 就會自己算(數字取自 Gitea 的 `created_at`/`due_on`/`closed_at`,不用手填),差超過 ±25% 才要你從**七個固定代號**裡挑一個,而且那個代號要有 Gitea 時間軸撐得住——**不採信自述**。純讀取/建里程碑/改期限/只是談論它/走正門,全部放行;真要手動關就在指令裡加 `milestone-account-ok`(留痕)。 | 🛑 擋 |
|
||||
| `reply-identity-guard.sh` | 直接打 Gitea API 貼留言到票上時,內文第一行沒有 `【身份】`(`總管`/`subagent`/`leo`)就擋下——票上多條線並行時,看不出哪一則是誰寫的。純讀取、走 `scripts/ticket` 正門、指令裡加 `reply-identity-ok` 都放行。 | 🛑 擋 |
|
||||
| `comment-carries-task-guard.sh` | AI 要在票裡留一則「等某某上線才驗得了」這種**還沒做完的事**,卻沒有把它開成一張子票時,擋一次。留言沒人會回頭讀,票的 open/closed 撈一次就看得到。 | 🛑 擋(同一輪只擋一次) |
|
||||
| `search-is-not-proof-guard.sh` | AI 用知識庫的**搜尋**找到一筆東西,然後把那筆東西的原始編號直接貼進票裡或派工單裡,當成「某個功能壞了」的證據——而它從沒用正規的檢索路徑去查過那筆——擋一次。你關心的是:不會再有人拿錯的方法量出一個錯的結論,然後退回一張其實已經做完的票。 | 🛑 擋(同一輪只擋一次) |
|
||||
@@ -132,6 +148,7 @@
|
||||
| `worklist-guard.sh` | AI 自己列過的待辦清單裡還有沒做完的步驟,卻想收工寫報告,就擋下,逼它做完剩下的步驟。 | 🛑 擋 |
|
||||
| `factory-idle-guard.sh` | AI 該去派工卻沒派(工頭停工),就擋下要它交出「已經派工的憑證」,不是隨口說一句「我會催」就算數。**過閘有四條路:現在就派工/把票號寫進那句話/寫一行 `⏸ 等:<在等什麼>`/這一輪收尾在動作上。** 2026-08-23(inkstone/ISEP#30)修好「引用被當成主張」——貼原始碼、引用它自己的訊息、否認自己有下一步,都不再被咬。 | 🛑 擋 |
|
||||
| `mainline-idle-guard.sh` | AI **連續 4 個回合一直在查、一直在讀,卻什麼都沒交出去**(沒派工、沒改檔、沒寫回票)就擋一次。補的是上面兩支中間那一格:「沒動作」空手警察管、「說了下一步卻沒派」稼動率警察管,**而「有動作、但就是不說下一步」以前兩支都放行**。這支**一個字都不讀**,只看有沒有派工/產出/工作區變動。響過一次門檻就加倍(4→8→16),不會變成一直在響的警報。 | 🛑 擋(響過就退讓) |
|
||||
| `pr-verdict-guard.sh` | 收工時清點「還有哪些 PR 沒有結論」——open、**沒有人被指派**、也沒有「要求修改」review 的 PR,就擋一次並**點名是哪幾個**(含開了幾天與網址);已經 merge 但**分支還留著**的也一起點名(票上寫死「併完當場刪掉那條 branch」)。背景:2026-08-27 實查,最久的三個 open PR 躺了兩星期,而當時 46 支閘沒有一支在管 PR——票看起來「已交付」,東西卻沒進 main、沒進版本,**leo 手上永遠不會出現它**。🔴 **擋的是遺忘,不是等待**:指派給誰(或掛 Human)就立刻不再點名它;響過門檻就加倍(1→4→8→16,每個 PR 各自算)。搭配 `scripts/pr-verdict`(merge/reject/changes 各一個動作)。 | 🛑 擋(響過就退讓) |
|
||||
| `countdown-guard.sh` | **每一則回覆都自己說出「這件事已經花了多久/距今天收工線還剩多久」**,而且不必有人記得。一支閘掛兩個事件:你送出訊息時它先把算好的那一行放到 AI 眼前(`UserPromptSubmit`),AI 想收工時它再看這一回合的回覆裡到底有沒有那一行,沒有就擋一次要它補(`Stop`)。**只做前半 = 又一個會被忽略的提醒**,所以兩半綁在一起。已過時間從**這段對話的第一則訊息**算起(=一個 release 的起點);收工線是台北 16:00,過線後四小時內顯示「已超過」,不會把超時悄悄換算掉。子 session、純工具回合、已經提醒過一次的,全部放行。 | 🛑 擋(至多攔一次) |
|
||||
| `browser-verify-guard.sh` | 這一輪 AI 宣稱「前端驗過了」,卻沒有真的用瀏覽器工具載入過,就擋下——`curl` 抓到 HTML 不算驗過。 | 🛑 擋 |
|
||||
| `self-drive-police.sh` | AI 想停下來問你「早就決定過的事」(用固定句型判斷,例如「要不要 X」「下一步做什麼」「這交給你」)就擋下,反問它查過 wiki/查過派工表了沒。 | 🛑 擋 |
|
||||
|
||||
@@ -49,6 +49,10 @@
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/milestone-due-guard.sh"
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/milestone-account-guard.sh"
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/reply-identity-guard.sh"
|
||||
@@ -253,6 +257,10 @@
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/mainline-idle-guard.sh"
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/pr-verdict-guard.sh"
|
||||
}
|
||||
]
|
||||
},
|
||||
|
||||
Executable
+107
@@ -0,0 +1,107 @@
|
||||
#!/usr/bin/env bash
|
||||
# 管什麼: 直接打 Gitea API 把一個里程碑改成 closed,卻沒有先記帳(估多久/花多久/
|
||||
# 差多少/為什麼差),就擋下來。
|
||||
# 為什麼: leo 2026-08-27 說那天「拖時間」,但拖了多久、比預計多拖多少、為什麼拖——
|
||||
# 一個數字都沒有。偵測器早就有了(mainline-idle-guard/factory-idle-guard),
|
||||
# **但沒有人把它算成帳**,所以事後只能說「這次比較慢」,下次還是一樣。
|
||||
# 誤觸時怎麼關: 走正門 `scripts/milestone-account close <owner/repo#編號>`
|
||||
# (它會自己算三個數字、自己去 Gitea 的時間軸取證據、然後幫你關)。
|
||||
# 真的有理由要繞過去 ⇒ 指令裡加 `milestone-account-ok`(留痕,commit 說明理由)。
|
||||
#
|
||||
# milestone-account-guard.sh — 結案要記帳(PreToolUse/Bash;inkstone/ISEP#85)
|
||||
#
|
||||
# ── 這支跟 milestone-due-guard.sh 是同一條線的兩端 ────────────────────
|
||||
# 那支管**開**里程碑要有真的期限(沒有期限就沒有「估多久」可言)。
|
||||
# 這支管**關**里程碑要留下那三個數字。少了任何一端,帳都算不出來。
|
||||
#
|
||||
# ── 判準:三件同時成立才擋,缺一放行 ──────────────────────────────
|
||||
# ① 指令位置真的有人在發網路請求(curl/wget/python/node/gh)
|
||||
# ——「講到它」跟「執行它」是兩件事,這是本 repo 已經證明過的判準
|
||||
# (release-tag-guard.sh 的 `git tag` 位置比對、strip_heredoc.py 的來由)。
|
||||
# ② URL 指名了**某一個**里程碑:`/repos/<owner>/<repo>/milestones/<數字>`
|
||||
# ——沒有數字的(建里程碑、列清單)不是本閘管的形狀。
|
||||
# ③ 有寫入動詞(PATCH/POST/.patch(/.post()**而且**內容把 state 設成 closed。
|
||||
#
|
||||
# ⇒ 純 GET、建里程碑、改標題改期限、`cat` 這支腳本、把指令寫進文件(heredoc 內文
|
||||
# 先被 strip_heredoc.py 剝掉)、走正門 `scripts/milestone-account close`
|
||||
# ——全部放行,一條都不擋。
|
||||
#
|
||||
# ── 抽不出 owner/repo/編號就不擋 ────────────────────────────────────
|
||||
# fail-open on 解析失敗(不是 fail-open on 檢查結果)。理由同 release-tag-guard.sh:
|
||||
# 誤攔比漏擋更該修——**誤攔會懲罰謹慎**,而被誤攔幾次之後人就學會繞過這支閘。
|
||||
#
|
||||
# ── 已知的漏擋(寫出來,不假裝沒有)────────────────────────────────
|
||||
# `bash -c 'curl -X PATCH …'` 這種把真正的指令包進引號裡的寫法,本閘看不到。
|
||||
# 這是刻意的取捨:要接住它就得去猜引號裡的內容,而那條路的盡頭是關鍵字黑名單
|
||||
# (leo 2026-08-17 已證偽:當日 8 次誤攔、0 次正確攔截)。
|
||||
#
|
||||
# 迴歸測試:hooks/tests/milestone-account-guard.test.sh(離線,不打 Gitea)
|
||||
set -uo pipefail
|
||||
|
||||
HOOKDIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
INPUT=$(cat 2>/dev/null || echo '{}')
|
||||
CMD=$(printf '%s' "$INPUT" | python3 -c '
|
||||
import json, sys
|
||||
try: print(json.load(sys.stdin).get("tool_input", {}).get("command", "") or "")
|
||||
except Exception: print("")
|
||||
' 2>/dev/null || printf '')
|
||||
[ -n "$CMD" ] || exit 0
|
||||
|
||||
# 明講的豁免(留痕)
|
||||
case "$CMD" in *milestone-account-ok*) exit 0 ;; esac
|
||||
|
||||
# heredoc 的內文是資料不是指令——先剝掉,理由見 hooks/lib/strip_heredoc.py 檔頭
|
||||
if [ -f "$HOOKDIR/lib/strip_heredoc.py" ]; then
|
||||
CMD=$(printf '%s' "$CMD" | python3 "$HOOKDIR/lib/strip_heredoc.py" 2>/dev/null || printf '%s' "$CMD")
|
||||
fi
|
||||
|
||||
# ① 指令位置真的有人在發請求
|
||||
printf '%s' "$CMD" | grep -qE '(^|[;&|(`]|&&|\|\|)[[:space:]]*(sudo[[:space:]]+)?(curl|wget|http|python3?|node|gh)[[:space:]]' || exit 0
|
||||
|
||||
# ② 指名某一個里程碑
|
||||
REF=$(printf '%s' "$CMD" | grep -oE '/repos/[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+/milestones/[0-9]+' | head -1 || printf '')
|
||||
[ -n "$REF" ] || exit 0
|
||||
|
||||
# ③ 寫入動詞 + 把 state 設成 closed
|
||||
printf '%s' "$CMD" | grep -qiE -- '-X[[:space:]]*[^A-Za-z]{0,3}(PATCH|POST)|--request[[:space:]]*[^A-Za-z]{0,3}(PATCH|POST)|\.(patch|post)\(|method[[:space:]]*=[[:space:]]*[^A-Za-z]{0,3}(PATCH|POST)' || exit 0
|
||||
printf '%s' "$CMD" | grep -qiE 'state[^A-Za-z0-9]{1,8}closed' || exit 0
|
||||
|
||||
OWNER=$(printf '%s' "$REF" | cut -d/ -f3)
|
||||
REPO=$(printf '%s' "$REF" | cut -d/ -f4)
|
||||
NUM=$(printf '%s' "$REF" | cut -d/ -f6)
|
||||
TARGET="$OWNER/$REPO#$NUM"
|
||||
|
||||
# 已經記過帳的就放行——正門 `milestone-account close` 是**先記帳、再關**,
|
||||
# 所以「帳本裡有這一筆」就代表三個數字已經留下來了。
|
||||
LEDGER="${MILESTONE_ACCOUNT_LEDGER:-}"
|
||||
if [ -z "$LEDGER" ] && [ -x "$HOOKDIR/../scripts/milestone-account" ]; then
|
||||
LEDGER=$(python3 "$HOOKDIR/../scripts/milestone-account" ledger-path 2>/dev/null || printf '')
|
||||
fi
|
||||
if [ -n "$LEDGER" ] && [ -f "$LEDGER" ] && grep -qF "\"ref\": \"$TARGET\"" "$LEDGER" 2>/dev/null; then
|
||||
exit 0
|
||||
fi
|
||||
|
||||
cat >&2 <<MSG
|
||||
⏱️ 結案要記帳:**$TARGET 還沒有留下「估多久/花多久/差多少」。**
|
||||
|
||||
【inkstone/ISEP#85】leo 2026-08-27 說那天「**拖時間**」。
|
||||
但拖了多久、比預計多拖多少、為什麼拖——**沒有任何數字**。
|
||||
「偵測器早就有了,但沒有人把它算成帳」⇒ 每次事後只能說「這次比較慢」,下次還是一樣。
|
||||
|
||||
━━ 走正門,它會把該做的一次做完 ━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
先看時間軸怎麼說: scripts/milestone-account audit $TARGET
|
||||
結案(會自己算、自己關):
|
||||
scripts/milestone-account close $TARGET [--reason <代號>]
|
||||
|
||||
三個數字**它自己算**(取自 Gitea 的 created_at/due_on/closed_at),不用你手填。
|
||||
差超過 ±25%(超時或提早都算)才需要 --reason,而且代號只能從那七個裡面挑:
|
||||
scripts/milestone-account codes
|
||||
代號要有**時間軸撐得住**——證據取自 Gitea,不採信任何人的自述。
|
||||
|
||||
━━ 為什麼不是「你自己 curl 一下就好」 ━━━━━━━━━━━━━━━━━━━━
|
||||
這一關掉,那個里程碑就再也算不出帳了(closed_at 之後沒有人會回頭補)。
|
||||
⇒ 這是**不可逆**的一步,所以閘長在這裡,不長在誰的記性上。
|
||||
|
||||
真的有理由要手動關 ⇒ 指令裡加 `milestone-account-ok`(留痕,commit 說明理由)。
|
||||
MSG
|
||||
exit 2
|
||||
@@ -0,0 +1,394 @@
|
||||
#!/usr/bin/env bash
|
||||
# 管什麼: 收工那一刻清點「我這邊還有沒有 PR 沒給結論」——open 且沒人在管的 PR、
|
||||
# 以及已經 merge 但**分支還留著**的 PR。有就擋一次並點名是哪幾個。
|
||||
# 為什麼: 2026-08-27 實查,最久的三個 open PR 躺了兩星期(inkstone/arcrun-rag#91、
|
||||
# inkstone/Arcrun#116、inkstone/Arcrun#104),而 v0.9.0 的 46 支閘沒有一支在管 PR。
|
||||
# 票看起來「已交付」,但東西沒進 main ⇒ 沒進版本 ⇒ leo 手上永遠不會出現它。
|
||||
# 誤觸時怎麼關: 直接再送一次即可(擋完就歸零,而且那幾個 PR 的門檻已加倍)。
|
||||
# 真的在等別人 ⇒ 把 PR 指派給他(或掛 Human),本閘立刻不再點名它。
|
||||
#
|
||||
# pr-verdict-guard.sh — PR 收斂警察(Stop;inkstone/ISEP#81)
|
||||
#
|
||||
# ── 為什麼是 Stop 而不是 PreToolUse ──────────────────────────────────
|
||||
# PR 堆積不是「某個動作做錯了」,是「某個動作從來沒發生」。
|
||||
# 沒有發生的事情攔不到,只能在收工那一刻清點。同 worklist-guard.sh 的形狀。
|
||||
# **刻意只掛 Stop,不掛 SubagentStop**:給 PR 結論是總管的事,
|
||||
# subagent 手上沒有那個權(它連 main 都不准推)⇒ 掛上去只會變成對它的誤攔。
|
||||
#
|
||||
# ── 這支跟 baton-handback-guard.sh 是接力,不是重複 ────────────────
|
||||
# baton 管「棒子有沒有交回來」(票的指派+tag+下一步三格)。
|
||||
# 本支管「交回來之後,總管有沒有動它」——PR 是那根棒子的實體。
|
||||
#
|
||||
# ── 🔴 已知的坑:這支很容易長成「讓總管永遠停不下來」的那一支 ──────
|
||||
# ISEP v0.6.0 的 divergence 文件 §B4 記過同款:
|
||||
# 「`s/review` 佇列非空即 block 總管 stop」⇒ 佇列本來就不會空 ⇒ 永遠擋。
|
||||
# ⇒ **要擋的是遺忘,不是等待。** 本閘用三層把「等待」全部放掉:
|
||||
#
|
||||
# ① 有人被指派(或掛 Human)⇒ 不點名。
|
||||
# 指派是 Gitea 原生欄位、也是本 repo 既有的「現在誰該動」真相
|
||||
# (見 baton-handback-guard 檔頭那張三格表)。棒子在誰手上是**事實**,
|
||||
# 不是措辭 ⇒ 有人拿著 = 在等,不是忘了。
|
||||
# ② 有一則 REQUEST_CHANGES 的 review ⇒ 不點名。
|
||||
# 「要求修改」這個結論已經給了,球在對方腳下。
|
||||
# ③ 這一回合碰過它 ⇒ 不點名(見下面「怎麼算碰過」)。
|
||||
# ④ 點名過就退讓:那個 PR 的門檻 1 → 4 → 8 → 16…(每 PR 各自算)。
|
||||
# ⇒ 不可能鎖死:擋完歸零,再送一次就過;真的長期不理才會再響。
|
||||
#
|
||||
# ── 怎麼算「碰過」:不讀任何一句話 ──────────────────────────────
|
||||
# ① `updated_at` 跟上一次收工比變了 ⇒ 碰過(留言/改標籤/推 commit/submit review
|
||||
# 全部會動它)。這是**外部系統的事實**,跟我在對話裡怎麼寫無關。
|
||||
# ② 上一次收工時還不存在的 PR ⇒ 剛開出來 ⇒ 碰過(不在它誕生的那一回合就開罵)。
|
||||
# ③ 這一回合的 tool call 裡出現它的**識別碼**(`owner/repo#N`/`/pulls/N`/它的網址)
|
||||
# ⇒ 碰過。這一條是為了接住「結論寫在票上」——票被改了、PR 沒被改,
|
||||
# ①②都看不到,但那正是本票規定的其中一種合法結論。
|
||||
#
|
||||
# 🔴 ③ 不是關鍵字黑名單(leo 2026-08-17 已證偽那條路:當日 8 次誤攔、0 次正確攔截)。
|
||||
# 差別在方向與集合:黑名單拿**措辭**來**擋**(措辭無限,永遠追不完);
|
||||
# 這裡拿**識別碼**來**放行**(識別碼是有限且唯一的,而且比對錯了只會少擋一次)。
|
||||
# 本 repo 心法:只准往放行的方向做字面比對。
|
||||
#
|
||||
# ── merge 了但分支還在 = 結論只給了一半 ────────────────────────
|
||||
# 票上寫死:「merge → 併完當場刪掉那條 branch」。所以某個 PR 從 open 清單消失時,
|
||||
# 本閘去看它是不是 merged、head 分支還在不在;還在就一起點名。
|
||||
# (只在「上次還 open、這次不見了」時查,平常一通 API 都不多打。)
|
||||
#
|
||||
# ── 內部錯誤不准靜默放行 ────────────────────────────────────────
|
||||
# Stop 閘 fail-closed 會鎖死 session,而誤攔是本 repo 的第一級缺陷
|
||||
# ⇒ 內部錯誤走 exit 0,但留痕(log + stderr 各一行)。同 mainline-idle-guard.sh。
|
||||
#
|
||||
# 迴歸測試:hooks/tests/pr-verdict-guard.test.sh(離線,走 PR_VERDICT_FIXTURE)
|
||||
set -u
|
||||
|
||||
PROJ="${CLAUDE_PROJECT_DIR:-$(pwd)}"
|
||||
PAYLOAD=$(cat 2>/dev/null || echo '{}')
|
||||
|
||||
# ── token:同 scripts/ticket 的做法(掃 remote 找帶憑證的,再退到環境變數)──
|
||||
TOKEN=""
|
||||
if [ -z "${PR_VERDICT_FIXTURE:-}" ]; then
|
||||
for d in "$PROJ" "$PROJ/products"/* "$PROJ/matrix"/* "$PROJ/polaris"/*; do
|
||||
[ -e "$d/.git" ] || continue
|
||||
U=$(git -C "$d" remote -v 2>/dev/null | grep -m1 'git\.uncle6\.me' | grep '@' | awk '{print $2}') || true
|
||||
if [ -n "${U:-}" ]; then
|
||||
T=$(printf '%s' "$U" | sed -E 's|.*//[^:]+:([^@]+)@.*|\1|')
|
||||
[ "$T" != "$U" ] && { TOKEN="$T"; break; }
|
||||
fi
|
||||
done
|
||||
[ -n "$TOKEN" ] || TOKEN="${GITEA_TOKEN_CLAUDE_CODE:-${GITEA_TOKEN:-}}"
|
||||
fi
|
||||
|
||||
# PR_VERDICT_DEBUG=1 時把內部錯誤原文放出來(平常吞掉,避免雜訊蓋掉閘的訊息)
|
||||
ERRSINK=/dev/null
|
||||
[ -n "${PR_VERDICT_DEBUG:-}" ] && ERRSINK=/dev/stderr
|
||||
|
||||
# 🔴 payload 走環境變數,不走 stdin——`python3 - <<PY` 的 stdin **就是腳本本身**,
|
||||
# 再從 sys.stdin 讀就會讀到自己的原始碼(第一版實撞,回 CRASH:bad-payload)。
|
||||
VERDICT=$(GITEA_TOKEN_RESOLVED="$TOKEN" PR_VERDICT_PAYLOAD="$PAYLOAD" python3 - <<'PY' 2>"$ERRSINK"
|
||||
import json, os, re, sys, time
|
||||
import urllib.error, urllib.parse, urllib.request
|
||||
|
||||
HOST = os.environ.get("PR_VERDICT_HOST", "https://git.uncle6.me")
|
||||
ORGS = [o.strip().lower() for o in
|
||||
os.environ.get("PR_VERDICT_ORGS", "inkstone").split(",") if o.strip()]
|
||||
FIXTURE = os.environ.get("PR_VERDICT_FIXTURE", "")
|
||||
TOKEN = os.environ.get("GITEA_TOKEN_RESOLVED", "")
|
||||
|
||||
def out(s):
|
||||
sys.stdout.write(s)
|
||||
raise SystemExit
|
||||
|
||||
try:
|
||||
d = json.loads(os.environ.get("PR_VERDICT_PAYLOAD") or "{}")
|
||||
except Exception:
|
||||
out("CRASH:bad-payload")
|
||||
|
||||
# 已被別的 Stop 閘擋過這一輪 ⇒ 不計數、不擋(避免疊擋,同 mainline-idle-guard)
|
||||
if d.get("stop_hook_active"):
|
||||
out("SKIP:already-nudged")
|
||||
|
||||
sid = re.sub(r"[^A-Za-z0-9_.-]", "_", str(d.get("session_id") or "nosid"))[:64]
|
||||
state_path = os.path.join(os.environ.get("PR_VERDICT_STATE_DIR", "/tmp"),
|
||||
".pr-verdict-%s.json" % sid)
|
||||
|
||||
# ── 資料來源:正式打 Gitea,測試走 fixture(單一 JSON 檔或目錄下的 state.json)──
|
||||
FX = None
|
||||
if FIXTURE:
|
||||
p = FIXTURE if os.path.isfile(FIXTURE) else os.path.join(FIXTURE, "state.json")
|
||||
try:
|
||||
with open(p) as f:
|
||||
FX = json.load(f)
|
||||
except Exception:
|
||||
out("CRASH:bad-fixture")
|
||||
|
||||
def api(path, soft=True):
|
||||
"""GET 一筆。fixture 模式完全不碰網路。失敗回 None(不影響該不該擋的核心判斷)。"""
|
||||
if FX is not None:
|
||||
return None
|
||||
if not TOKEN:
|
||||
return None
|
||||
try:
|
||||
req = urllib.request.Request(HOST + "/api/v1" + path,
|
||||
headers={"Authorization": "token " + TOKEN})
|
||||
return json.load(urllib.request.urlopen(req, timeout=12))
|
||||
except urllib.error.HTTPError as e:
|
||||
return {"__status__": e.code}
|
||||
except Exception:
|
||||
return None
|
||||
|
||||
# ── ① 撈 open PR(一通跨 repo 的呼叫)─────────────────────────────
|
||||
if FX is not None:
|
||||
pulls = FX.get("pulls", [])
|
||||
else:
|
||||
if not TOKEN:
|
||||
out("SKIP:no-token")
|
||||
pulls = api("/repos/issues/search?type=pulls&state=open&limit=50")
|
||||
if pulls is None or isinstance(pulls, dict):
|
||||
out("SKIP:api-unreachable")
|
||||
|
||||
def ref_of(pr):
|
||||
return "%s#%s" % (pr.get("repository", {}).get("full_name", "?"), pr.get("number"))
|
||||
|
||||
live = {}
|
||||
for pr in pulls:
|
||||
full = (pr.get("repository") or {}).get("full_name") or ""
|
||||
if "/" not in full:
|
||||
continue
|
||||
if ORGS and full.split("/", 1)[0].lower() not in ORGS:
|
||||
continue # 只管我這邊的 org;舊 org 的鏡像不是我的責任
|
||||
if (pr.get("pull_request") or {}).get("draft"):
|
||||
continue # draft = 作者自己說「還沒好」,不是等我給結論
|
||||
live[ref_of(pr)] = pr
|
||||
|
||||
# ── ② 讀上一次收工的快照 ─────────────────────────────────────────
|
||||
st = {}
|
||||
try:
|
||||
with open(state_path) as f:
|
||||
st = json.load(f)
|
||||
except Exception:
|
||||
st = {}
|
||||
seen = st.get("seen") or {}
|
||||
leftover = st.get("leftover") or {} # ref -> branch,merge 完分支還沒刪的
|
||||
first_run = not seen and "seen" not in st
|
||||
|
||||
# ── ③ 這一回合的 tool call 裡提到了哪些識別碼(只用來放行)──────────
|
||||
turn_blob = ""
|
||||
tp = d.get("transcript_path") or ""
|
||||
if tp and os.path.exists(tp):
|
||||
try:
|
||||
rows = []
|
||||
with open(tp) as f:
|
||||
for line in f:
|
||||
line = line.strip()
|
||||
if line:
|
||||
try:
|
||||
rows.append(json.loads(line))
|
||||
except Exception:
|
||||
pass
|
||||
start = 0
|
||||
for i, r in enumerate(rows):
|
||||
if r.get("type") == "user":
|
||||
c = (r.get("message") or {}).get("content")
|
||||
blocks = c if isinstance(c, list) else [{"type": "text"}]
|
||||
if not any(isinstance(b, dict) and b.get("type") == "tool_result"
|
||||
for b in blocks):
|
||||
start = i
|
||||
chunks = []
|
||||
for r in rows[start:]:
|
||||
if r.get("type") != "assistant":
|
||||
continue
|
||||
for b in (r.get("message") or {}).get("content") or []:
|
||||
if isinstance(b, dict) and b.get("type") == "tool_use":
|
||||
chunks.append(json.dumps(b.get("input") or {}, ensure_ascii=False))
|
||||
turn_blob = "\n".join(chunks)
|
||||
except Exception:
|
||||
turn_blob = ""
|
||||
|
||||
def mentioned(ref):
|
||||
"""這一回合的 tool call 有沒有指名這個 PR。識別碼比對,只用來放行。"""
|
||||
if not turn_blob:
|
||||
return False
|
||||
full, num = ref.split("#")
|
||||
owner, repo = full.split("/", 1)
|
||||
pats = ["%s#%s" % (full, num), "%s#%s" % (repo, num),
|
||||
"/pulls/%s" % num, "/pull/%s" % num]
|
||||
return any(p in turn_blob for p in pats)
|
||||
|
||||
# ── ④ merge 完分支還在不在(只在「上次還 open、這次不見了」時查)────
|
||||
def branch_alive(owner, repo, br):
|
||||
if FX is not None:
|
||||
return bool((FX.get("branches") or {}).get("%s/%s:%s" % (owner, repo, br)))
|
||||
r = api("/repos/%s/%s/branches/%s" % (owner, repo, urllib.parse.quote(br, safe="")))
|
||||
if isinstance(r, dict) and r.get("__status__") == 404:
|
||||
return False
|
||||
return isinstance(r, dict) and "name" in r
|
||||
|
||||
def pr_detail(ref):
|
||||
if FX is not None:
|
||||
return (FX.get("detail") or {}).get(ref)
|
||||
full, num = ref.split("#")
|
||||
owner, repo = full.split("/", 1)
|
||||
r = api("/repos/%s/%s/pulls/%s" % (owner, repo, num))
|
||||
return r if isinstance(r, dict) and "__status__" not in r else None
|
||||
|
||||
for ref in list(seen.keys()):
|
||||
if ref in live:
|
||||
continue
|
||||
det = pr_detail(ref) # 不見了:是被 merge 還是被 close?
|
||||
if not det or not det.get("merged"):
|
||||
continue
|
||||
br = ((det.get("head") or {}).get("ref")) or ""
|
||||
if not br:
|
||||
continue
|
||||
full = ref.split("#")[0]
|
||||
owner, repo = full.split("/", 1)
|
||||
if branch_alive(owner, repo, br):
|
||||
leftover[ref] = br
|
||||
|
||||
for ref in list(leftover.keys()): # 已經刪掉的就從清單移除
|
||||
full = ref.split("#")[0]
|
||||
owner, repo = full.split("/", 1)
|
||||
if not branch_alive(owner, repo, leftover[ref]):
|
||||
leftover.pop(ref, None)
|
||||
|
||||
# ── ⑤ 逐個 open PR 判「有沒有人在管」──────────────────────────────
|
||||
def reviews_of(ref):
|
||||
if FX is not None:
|
||||
return (FX.get("reviews") or {}).get(ref) or []
|
||||
full, num = ref.split("#")
|
||||
owner, repo = full.split("/", 1)
|
||||
r = api("/repos/%s/%s/pulls/%s/reviews" % (owner, repo, num))
|
||||
return r if isinstance(r, list) else []
|
||||
|
||||
try:
|
||||
BASE = max(1, int(os.environ.get("PR_VERDICT_THRESHOLD", "1")))
|
||||
except Exception:
|
||||
BASE = 1
|
||||
|
||||
overdue, newseen = [], {}
|
||||
for ref, pr in live.items():
|
||||
prev = seen.get(ref) or {}
|
||||
rec = {"updated_at": pr.get("updated_at"),
|
||||
"quiet": int(prev.get("quiet", 0) or 0),
|
||||
"threshold": int(prev.get("threshold", BASE) or BASE),
|
||||
"fires": int(prev.get("fires", 0) or 0)}
|
||||
newseen[ref] = rec
|
||||
|
||||
# 有人被指派/掛了 Human = 棒子在某個人手上 ⇒ 在等,不是忘了
|
||||
if pr.get("assignees"):
|
||||
rec["quiet"] = 0
|
||||
continue
|
||||
if any((l.get("name") or "").lower() == "human" for l in (pr.get("labels") or [])):
|
||||
rec["quiet"] = 0
|
||||
continue
|
||||
# 上一次收工時還不存在 ⇒ 剛開出來,別在它誕生的那一回合就開罵
|
||||
if not first_run and ref not in seen:
|
||||
rec["quiet"] = 0
|
||||
continue
|
||||
# 這一回合真的動過它(外部事實)/指名過它(識別碼)
|
||||
if prev.get("updated_at") and pr.get("updated_at") != prev.get("updated_at"):
|
||||
rec["quiet"] = 0
|
||||
continue
|
||||
if mentioned(ref):
|
||||
rec["quiet"] = 0
|
||||
continue
|
||||
|
||||
rec["quiet"] += 1
|
||||
if rec["quiet"] < rec["threshold"]:
|
||||
continue
|
||||
# 「要求修改」這個結論已經給了 ⇒ 球在對方腳下(只在要開罵時才多打這通)
|
||||
if any((rv.get("state") or "").upper() == "REQUEST_CHANGES" for rv in reviews_of(ref)):
|
||||
rec["quiet"] = 0
|
||||
continue
|
||||
|
||||
rec["quiet"] = 0
|
||||
rec["threshold"] = max(4, rec["threshold"] * 4 if rec["threshold"] == 1
|
||||
else rec["threshold"] * 2)
|
||||
rec["fires"] += 1
|
||||
overdue.append((ref, pr))
|
||||
|
||||
try:
|
||||
with open(state_path, "w") as f:
|
||||
json.dump({"seen": newseen, "leftover": leftover, "ts": time.time()}, f)
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
if not overdue and not leftover:
|
||||
out("OK:clean:%d-open" % len(live))
|
||||
|
||||
def age_days(pr):
|
||||
try:
|
||||
t = time.mktime(time.strptime(pr.get("created_at", "")[:19], "%Y-%m-%dT%H:%M:%S"))
|
||||
return max(0, int((time.time() - t) / 86400))
|
||||
except Exception:
|
||||
return -1
|
||||
|
||||
lines = []
|
||||
if overdue:
|
||||
lines.append("【沒有結論的 PR】(open、沒有人被指派、也沒有「要求修改」的 review)")
|
||||
for ref, pr in sorted(overdue, key=lambda x: -age_days(x[1])):
|
||||
dd = age_days(pr)
|
||||
lines.append(" ❌ %-28s 開了 %s天 %s"
|
||||
% (ref, dd if dd >= 0 else "?", (pr.get("title") or "")[:36]))
|
||||
lines.append(" %s" % ((pr.get("pull_request") or {}).get("html_url") or ""))
|
||||
if leftover:
|
||||
lines.append("【merge 了,但分支還留著】(結論只給了一半)")
|
||||
for ref, br in sorted(leftover.items()):
|
||||
lines.append(" ❌ %-28s 分支 %s 還在" % (ref, br))
|
||||
|
||||
out("FIRE::" + json.dumps({"body": "\n".join(lines),
|
||||
"n": len(overdue) + len(leftover)}, ensure_ascii=False))
|
||||
PY
|
||||
) || VERDICT="CRASH:hook-error"
|
||||
[ -n "${VERDICT:-}" ] || VERDICT="CRASH:empty"
|
||||
|
||||
STAMP=$(date "+%Y-%m-%d %H:%M:%S" 2>/dev/null || echo "?")
|
||||
LOGDIR="$PROJ/.claude/hooks"
|
||||
note() {
|
||||
if [ -d "$LOGDIR" ]; then
|
||||
printf '| %s | %s | %s |\n' "$STAMP" "$1" "$2" >> "$LOGDIR/pr-verdict-guard.log" 2>/dev/null || true
|
||||
fi
|
||||
}
|
||||
|
||||
case "$VERDICT" in
|
||||
FIRE::*)
|
||||
BODY=$(printf '%s' "${VERDICT#FIRE::}" | python3 -c 'import json,sys; print(json.load(sys.stdin)["body"])')
|
||||
N=$(printf '%s' "${VERDICT#FIRE::}" | python3 -c 'import json,sys; print(json.load(sys.stdin)["n"])')
|
||||
note "⛔ 擋下" "$N 個 PR 沒有結論"
|
||||
cat >&2 <<MSG
|
||||
🔀 PR 收斂警察:**還有 ${N} 個 PR 沒有結論,現在不是收工的時候。**
|
||||
|
||||
$BODY
|
||||
|
||||
【inkstone/ISEP#81】「我交出去的 PR 沒有人去看它⋯⋯票看起來是『已交付』,
|
||||
但東西沒有進 main,也就沒有進版本,**leo 手上永遠不會出現它**。」
|
||||
|
||||
━━ 「有結論」只有三種,缺一不可 ━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
merge → **併完當場刪掉那條 branch**
|
||||
scripts/pr-verdict merge <owner/repo#N>
|
||||
退回 → 理由**寫在票上**(不是寫在訊息裡),然後關掉 PR
|
||||
scripts/pr-verdict reject <owner/repo#N> --ticket <owner/repo#N> -F <檔>
|
||||
要求修改 → 修改要求**寫在票上**,並在 PR 上留一則 REQUEST_CHANGES
|
||||
scripts/pr-verdict changes <owner/repo#N> --ticket <owner/repo#N> -F <檔>
|
||||
|
||||
撈一次現況:scripts/pr-verdict list
|
||||
|
||||
━━ 如果它本來就在等別人,不是被我忘了 ━━━━━━━━━━━━━━━━━━━━
|
||||
**把它指派給那個人**(或掛 Human)——本閘立刻不再點名它。
|
||||
指派是 Gitea 原生欄位,撈一次就看得到「現在誰該動」;
|
||||
寫在對話裡的「我在等 X」會捲走,欄位不會。
|
||||
|
||||
這一條就是本閘跟「s/review 佇列非空即 block」的分界:
|
||||
**擋的是遺忘,不是等待。**(ISEP v0.6.0 divergence §B4 記過那個坑)
|
||||
|
||||
━━ 這幾個現在真的不該處理 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
直接再送一次即可,本閘已經歸零,而且這幾個 PR 的門檻已加倍
|
||||
(1 → 4 → 8 → 16…,每個 PR 各自算)。**不必為了過這道閘去做一件假的動作。**
|
||||
MSG
|
||||
exit 2 ;;
|
||||
CRASH*)
|
||||
note "⚠️ 內部錯誤" "$VERDICT"
|
||||
printf '⚠️ pr-verdict-guard 內部錯誤(%s)——本回合未清點 PR,已記入 log。\n' "$VERDICT" >&2
|
||||
exit 0 ;;
|
||||
*)
|
||||
note "✅ 放行" "$VERDICT"
|
||||
exit 0 ;;
|
||||
esac
|
||||
Executable
+85
@@ -0,0 +1,85 @@
|
||||
#!/usr/bin/env bash
|
||||
# milestone-account-guard.sh 的迴歸測試(inkstone/ISEP#85)
|
||||
#
|
||||
# A 群「不該擋」——純讀取/建里程碑/改別的欄位/只是談論它/heredoc 內文/
|
||||
# 走正門 `milestone-account close`/已經記過帳/解析不出來
|
||||
# B 群「該擋」 ——真的用 curl/python 把某一個里程碑 PATCH 成 closed,而帳本裡沒有它
|
||||
# C 群「訊息承諾的出路真的走得通」——記過帳之後立刻不再擋;加了豁免字樣就放行
|
||||
#
|
||||
# 🔴 全程離線:帳本走 MILESTONE_ACCOUNT_LEDGER 指到 mktemp 的檔,不打 Gitea。
|
||||
# **誤攔比漏擋更該修**——A 群任何一條紅,就是這支閘在懲罰謹慎。
|
||||
set -u
|
||||
HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/milestone-account-guard.sh}"
|
||||
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
|
||||
LED="$TMP/ledger.jsonl"; : > "$LED"
|
||||
PASS=0; FAIL=0; N=0
|
||||
|
||||
fire() {
|
||||
want="$1"; desc="$2"; cmd="$3"
|
||||
N=$((N+1))
|
||||
payload=$(python3 -c 'import json,sys; print(json.dumps({"tool_input":{"command":sys.argv[1]}}))' "$cmd")
|
||||
out=$(printf '%s' "$payload" | MILESTONE_ACCOUNT_LEDGER="$LED" bash "$HOOK" 2>&1 >/dev/null); rc=$?
|
||||
if [ "$rc" -eq "$want" ]; then printf ' ✅ %s\n' "$desc"; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ %s —— 期望 exit=%s,實得 exit=%s\n' "$desc" "$want" "$rc"
|
||||
printf '%s\n' "$out" | sed -n '1,6p' | sed 's/^/ /'; FAIL=$((FAIL+1))
|
||||
fi
|
||||
}
|
||||
|
||||
CLOSE='curl -s -X PATCH -H "Authorization: token X" -d {"state":"closed"} https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones/12'
|
||||
|
||||
echo "── A 群:不該擋(誤攔比漏擋更該修)─────────────────────────"
|
||||
fire 0 "① 空指令" ""
|
||||
fire 0 "② 純 GET 撈里程碑" \
|
||||
'curl -s https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones/12'
|
||||
fire 0 "③ 列出所有里程碑" \
|
||||
'curl -s "https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones?state=open"'
|
||||
fire 0 "④ 建一個新里程碑(那是 milestone-due-guard 管的,不是這支)" \
|
||||
'curl -X POST -d {"title":"x","due_on":"2026-09-05T23:59:59Z"} https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones'
|
||||
fire 0 "⑤ PATCH 但只是改期限,沒有要關它" \
|
||||
'curl -X PATCH -d {"due_on":"2026-09-05T23:59:59Z"} https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones/12'
|
||||
fire 0 "⑥ 只是談論它(echo 在指令位置,curl 在字串裡)" \
|
||||
"echo '$CLOSE'"
|
||||
fire 0 "⑦ 讀這支閘自己的原始碼" 'cat hooks/milestone-account-guard.sh'
|
||||
fire 0 "⑧ commit 訊息裡出現「關掉 milestone」" \
|
||||
'git commit -m "關掉 milestone 12,state closed"'
|
||||
fire 0 "⑨ 走正門:scripts/milestone-account close" \
|
||||
'python3 scripts/milestone-account close inkstone/ISEP#12 --reason idle'
|
||||
fire 0 "⑩ 正門的 --dry-run" \
|
||||
'python3 scripts/milestone-account close inkstone/ISEP#12 --reason idle --dry-run'
|
||||
fire 0 "⑪ 把那段指令寫進文件(heredoc 內文是資料不是指令)" \
|
||||
"$(printf 'cat > docs/x.md <<%s\n%s\nEOD\n' "'EOD'" "$CLOSE")"
|
||||
fire 0 "⑫ 網址沒有里程碑編號(抽不出目標 ⇒ 不擋)" \
|
||||
'curl -X PATCH -d {"state":"closed"} https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones'
|
||||
fire 0 "⑬ 關的是一張票不是里程碑" \
|
||||
'curl -X PATCH -d {"state":"closed"} https://git.uncle6.me/api/v1/repos/inkstone/ISEP/issues/12'
|
||||
|
||||
echo "── B 群:該擋 ──────────────────────────────────────────────"
|
||||
fire 2 "⑭ curl PATCH state=closed,帳本裡沒有它" "$CLOSE"
|
||||
fire 2 "⑮ 換成 python urllib(method=\"PATCH\")一樣擋" \
|
||||
'python3 -c "import urllib.request,json; urllib.request.urlopen(urllib.request.Request(\"https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones/12\", data=json.dumps({\"state\":\"closed\"}).encode(), method=\"PATCH\"))"'
|
||||
fire 2 "⑯ 前面串一個無害指令也擋(不是靠前綴判斷)" "ls && $CLOSE"
|
||||
fire 2 "⑰ --request PATCH 的長寫法" \
|
||||
'curl --request PATCH --data {"state":"closed"} https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones/12'
|
||||
fire 2 "⑱ 別的 repo 的里程碑一樣管" \
|
||||
'curl -X PATCH -d {"state":"closed"} https://git.uncle6.me/api/v1/repos/inkstone/arcrun-rag/milestones/47'
|
||||
|
||||
echo "── C 群:訊息承諾的出路真的走得通 ──────────────────────────"
|
||||
N=$((N+1))
|
||||
out=$(python3 -c 'import json,sys; print(json.dumps({"tool_input":{"command":sys.argv[1]}}))' "$CLOSE" \
|
||||
| MILESTONE_ACCOUNT_LEDGER="$LED" bash "$HOOK" 2>&1 >/dev/null)
|
||||
if printf '%s' "$out" | grep -q "scripts/milestone-account audit inkstone/ISEP#12"; then
|
||||
printf ' ✅ ⑲ 訊息直接給出可以照打的那一行(含正確的 owner/repo#編號)\n'; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ ⑲ 訊息沒有點名目標\n'; FAIL=$((FAIL+1))
|
||||
fi
|
||||
|
||||
echo '{"ref": "inkstone/ISEP#12", "reason": "idle"}' >> "$LED"
|
||||
fire 0 "⑳ 記過帳之後立刻放行(正門是先記帳再關)" "$CLOSE"
|
||||
fire 2 "㉑ 但別的里程碑還是照擋(不是一記帳就全開)" \
|
||||
'curl -X PATCH -d {"state":"closed"} https://git.uncle6.me/api/v1/repos/inkstone/ISEP/milestones/13'
|
||||
fire 0 "㉒ 明講的豁免字樣(留痕)" "$CLOSE # milestone-account-ok"
|
||||
|
||||
echo
|
||||
echo "通過 $PASS 條,失敗 $FAIL 條(共 $N 條)"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
@@ -0,0 +1,220 @@
|
||||
#!/usr/bin/env bash
|
||||
# pr-verdict-guard.sh 的迴歸測試(inkstone/ISEP#81)
|
||||
#
|
||||
# 兩個方向都要有證據:
|
||||
# A 群「不該擋」——沒有 PR/有人指派/掛 Human/draft/不在 org/剛開出來/
|
||||
# 這回合動過/這回合指名過/已有 REQUEST_CHANGES/已被別的閘擋過/
|
||||
# merge 完分支已刪/fixture 壞掉
|
||||
# B 群「該擋」 ——沒人管的 open PR、放著不管一回合、merge 了但分支還在、
|
||||
# 以及**票上那三個躺了兩週的真跡**
|
||||
# C 群「訊息承諾的出路真的走得通」——擋完歸零門檻加倍、指派下去立刻閉嘴
|
||||
#
|
||||
# 🔴 全程離線(PR_VERDICT_FIXTURE),不打 Gitea、不留任何測試票/測試 PR。
|
||||
# 狀態檔走 PR_VERDICT_STATE_DIR,不碰 /tmp 的正式檔。
|
||||
#
|
||||
# 用法:hooks/tests/pr-verdict-guard.test.sh [hooks/pr-verdict-guard.sh 的路徑]
|
||||
set -u
|
||||
HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/pr-verdict-guard.sh}"
|
||||
TMP=$(mktemp -d)
|
||||
trap 'rm -rf "$TMP"' EXIT
|
||||
|
||||
PASS=0; FAIL=0; N=0
|
||||
NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
|
||||
OLD="2026-08-13T04:34:01Z"
|
||||
|
||||
# fixture <檔名> <PR 規格...>
|
||||
# PR 規格:ref|updated|created|assignee|labels|draft
|
||||
mkfx() { python3 - "$@" <<'PY'
|
||||
import json, sys, os
|
||||
path, specs = sys.argv[1], sys.argv[2:]
|
||||
extra = {}
|
||||
if os.path.exists(path):
|
||||
extra = json.load(open(path))
|
||||
pulls = []
|
||||
for s in specs:
|
||||
ref, upd, crt, asg, lbl, draft = (s.split("|") + [""] * 6)[:6]
|
||||
full, num = ref.split("#")
|
||||
pulls.append({
|
||||
"number": int(num),
|
||||
"title": "測試 PR " + ref,
|
||||
"created_at": crt, "updated_at": upd,
|
||||
"repository": {"full_name": full, "id": 1},
|
||||
"assignees": [{"login": a} for a in asg.split(",") if a],
|
||||
"labels": [{"name": n} for n in lbl.split(",") if n],
|
||||
"pull_request": {"merged": False, "draft": draft == "draft",
|
||||
"html_url": "https://git.uncle6.me/%s/pulls/%s" % (full, num)},
|
||||
})
|
||||
extra["pulls"] = pulls
|
||||
json.dump(extra, open(path, "w"), ensure_ascii=False)
|
||||
PY
|
||||
}
|
||||
|
||||
# 加一筆「這個 PR 已經被 merge,head 分支叫 X」的細節,以及分支還在不在
|
||||
mkdetail() { python3 - "$@" <<'PY'
|
||||
import json, sys, os
|
||||
path, ref, branch, alive = sys.argv[1:5]
|
||||
d = json.load(open(path)) if os.path.exists(path) else {}
|
||||
full = ref.split("#")[0]
|
||||
d.setdefault("detail", {})[ref] = {
|
||||
"merged": True, "head": {"ref": branch, "repo": {"full_name": full}}}
|
||||
d.setdefault("branches", {})["%s:%s" % (full, branch)] = (alive == "alive")
|
||||
json.dump(d, open(path, "w"), ensure_ascii=False)
|
||||
PY
|
||||
}
|
||||
|
||||
mkreview() { python3 - "$@" <<'PY'
|
||||
import json, sys, os
|
||||
path, ref, state = sys.argv[1:4]
|
||||
d = json.load(open(path)) if os.path.exists(path) else {}
|
||||
d.setdefault("reviews", {})[ref] = [{"state": state}]
|
||||
json.dump(d, open(path, "w"), ensure_ascii=False)
|
||||
PY
|
||||
}
|
||||
|
||||
# 造一份「這一回合叫過這些工具、輸入長這樣」的 transcript
|
||||
mktranscript() { python3 - "$@" <<'PY'
|
||||
import json, sys
|
||||
path = sys.argv[1]
|
||||
with open(path, "w") as f:
|
||||
f.write(json.dumps({"type": "user",
|
||||
"message": {"content": [{"type": "text", "text": "繼續"}]}}) + "\n")
|
||||
blocks = [{"type": "tool_use", "name": "Bash", "id": "t",
|
||||
"input": {"command": c}} for c in sys.argv[2:]]
|
||||
f.write(json.dumps({"type": "assistant", "message": {"content": blocks}},
|
||||
ensure_ascii=False) + "\n")
|
||||
PY
|
||||
}
|
||||
|
||||
# fire <session> <fixture> <期望 exit> <說明> [transcript] [extra-json] [必須出現的字串]
|
||||
fire() {
|
||||
sid="$1"; fx="$2"; want="$3"; desc="$4"; tr="${5:-/nonexistent}"; extra="${6:-}"; must="${7:-}"
|
||||
N=$((N+1))
|
||||
payload=$(printf '{"session_id":"%s","transcript_path":"%s"%s}' "$sid" "$tr" "$extra")
|
||||
out=$(printf '%s' "$payload" | PR_VERDICT_FIXTURE="$fx" PR_VERDICT_STATE_DIR="$TMP" \
|
||||
CLAUDE_PROJECT_DIR="$TMP" bash "$HOOK" 2>&1 >/dev/null); 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,8p' | sed 's/^/ /'
|
||||
FAIL=$((FAIL+1))
|
||||
fi
|
||||
}
|
||||
|
||||
echo "── A 群:不該擋 ────────────────────────────────────────────"
|
||||
|
||||
FX="$TMP/empty.json"; mkfx "$FX"
|
||||
fire s-empty "$FX" 0 "① 一個 open PR 都沒有 ⇒ 放行"
|
||||
|
||||
FX="$TMP/assigned.json"; mkfx "$FX" "inkstone/Arcrun#104|$OLD|$OLD|Leo||"
|
||||
fire s-asg "$FX" 0 "② 有人被指派(棒子在他手上=在等,不是忘了)⇒ 不點名"
|
||||
|
||||
FX="$TMP/human.json"; mkfx "$FX" "inkstone/Arcrun#104|$OLD|$OLD||Human,p/high|"
|
||||
fire s-hum "$FX" 0 "③ 掛了 Human(等 leo 親手做)⇒ 不點名"
|
||||
|
||||
FX="$TMP/draft.json"; mkfx "$FX" "inkstone/Arcrun#104|$OLD|$OLD|||draft"
|
||||
fire s-drf "$FX" 0 "④ draft(作者自己說還沒好)⇒ 不點名"
|
||||
|
||||
FX="$TMP/otherorg.json"; mkfx "$FX" "Leo/Arcrun#104|$OLD|$OLD|||"
|
||||
fire s-org "$FX" 0 "⑤ 不在 inkstone org(舊 org 的鏡像)⇒ 不點名"
|
||||
|
||||
FX="$TMP/review.json"; mkfx "$FX" "inkstone/Arcrun#104|$OLD|$OLD|||"
|
||||
mkreview "$FX" "inkstone/Arcrun#104" "REQUEST_CHANGES"
|
||||
fire s-rev "$FX" 0 "⑥ 已經留了 REQUEST_CHANGES(結論給過了,球在對方腳下)⇒ 不點名"
|
||||
|
||||
FX="$TMP/active.json"; mkfx "$FX" "inkstone/Arcrun#104|$OLD|$OLD|||"
|
||||
fire s-act "$FX" 0 "⑦ stop_hook_active(已被別的 Stop 閘擋過)⇒ 不疊擋" \
|
||||
/nonexistent ',"stop_hook_active":true'
|
||||
|
||||
fire s-bad "$TMP/does-not-exist.json" 0 "⑧ fixture 讀不到 ⇒ 放行(Stop 閘不准把 session 鎖死)"
|
||||
|
||||
echo "── B 群:該擋 ──────────────────────────────────────────────"
|
||||
|
||||
# 票上那三個真跡(真實 ref、真實開票日)
|
||||
FX="$TMP/real.json"
|
||||
mkfx "$FX" \
|
||||
"inkstone/arcrun-rag#91|$OLD|$OLD|||" \
|
||||
"inkstone/Arcrun#116|2026-08-13T05:24:51Z|2026-08-13T05:24:51Z|||" \
|
||||
"inkstone/Arcrun#104|2026-08-12T08:51:06Z|2026-08-12T08:51:06Z|||"
|
||||
fire s-real "$FX" 2 "⑨ 真跡重演:三個躺了兩週的 PR ⇒ **擋下**" \
|
||||
/nonexistent '' 'inkstone/arcrun-rag#91'
|
||||
FX2="$TMP/real2.json"; cp "$FX" "$FX2"
|
||||
fire s-real2 "$FX2" 2 "⑩ 同上,訊息要點名 inkstone/Arcrun#116" \
|
||||
/nonexistent '' 'inkstone/Arcrun#116'
|
||||
FX3="$TMP/real3.json"; cp "$FX" "$FX3"
|
||||
fire s-real3 "$FX3" 2 "⑪ 同上,訊息要點名 inkstone/Arcrun#104" \
|
||||
/nonexistent '' 'inkstone/Arcrun#104'
|
||||
|
||||
echo "── C 群:驗收條件 1–3(開著不管 → 擋;merge → 放行;分支要不見)──"
|
||||
|
||||
# 驗收 1:一個新 PR 出現(不在它誕生那回合開罵),下一回合放著不管 ⇒ 擋
|
||||
FX="$TMP/ac.json"; mkfx "$FX"
|
||||
fire s-ac "$FX" 0 "⑫ 基準回合:目前沒有 PR"
|
||||
mkfx "$FX" "inkstone/ISEP#999|$NOW|$NOW|||"
|
||||
fire s-ac "$FX" 0 "⑬ PR 剛開出來(上一回合還不存在)⇒ 不在它誕生的回合開罵"
|
||||
fire s-ac "$FX" 2 "⑭ **驗收 1**:開著放著不管,收工 ⇒ 擋下,且點名它" \
|
||||
/nonexistent '' 'inkstone/ISEP#999'
|
||||
|
||||
# 驗收 2+3:merge 掉(PR 從 open 清單消失)且分支已刪 ⇒ 放行
|
||||
mkfx "$FX" # #999 從 open 清單消失
|
||||
mkdetail "$FX" "inkstone/ISEP#999" "feat/x" "gone"
|
||||
fire s-ac "$FX" 0 "⑮ **驗收 2+3**:merge 掉且分支已不存在 ⇒ 放行"
|
||||
|
||||
# 驗收 3 的反面:merge 了但分支還在 = 結論只給了一半 ⇒ 擋
|
||||
FX="$TMP/left.json"; mkfx "$FX" "inkstone/ISEP#998|$NOW|$NOW|||"
|
||||
fire s-left "$FX" 2 "⑯ 先讓 #998 進到快照(沒人管 ⇒ 擋一次)" \
|
||||
/nonexistent '' 'inkstone/ISEP#998'
|
||||
mkfx "$FX" # 消失了
|
||||
mkdetail "$FX" "inkstone/ISEP#998" "feat/y" "alive"
|
||||
fire s-left "$FX" 2 "⑰ **驗收 3**:merge 了但分支 feat/y 還在 ⇒ 擋下並點名分支" \
|
||||
/nonexistent '' 'feat/y'
|
||||
mkfx "$FX"; mkdetail "$FX" "inkstone/ISEP#998" "feat/y" "gone"
|
||||
fire s-left "$FX" 0 "⑱ 分支刪掉之後 ⇒ 放行(清單會自己清乾淨)"
|
||||
|
||||
echo "── D 群:這一回合碰過它就不點名(不讀任何一句話)──────────────"
|
||||
|
||||
FX="$TMP/touch.json"; mkfx "$FX" "inkstone/ISEP#997|$OLD|$OLD|||"
|
||||
fire s-t1 "$FX" 2 "⑲ 沒人管 ⇒ 擋一次(建立基準)"
|
||||
# updated_at 動了 = 外部系統的事實(留言/推 commit/改標籤都會動它)
|
||||
mkfx "$FX" "inkstone/ISEP#997|$NOW|$OLD|||"
|
||||
for i in 1 2 3 4 5; do
|
||||
fire s-t1 "$FX" 0 "⑳ updated_at 變了(這回合真的動過它)第 $i 次 ⇒ 不點名"
|
||||
mkfx "$FX" "inkstone/ISEP#997|$NOW-$i|$OLD|||"
|
||||
done
|
||||
|
||||
FX="$TMP/mention.json"; mkfx "$FX" "inkstone/ISEP#996|$OLD|$OLD|||"
|
||||
TR="$TMP/tr.jsonl"
|
||||
mktranscript "$TR" "python3 scripts/ticket say inkstone/ISEP#996 -F /tmp/x.md"
|
||||
fire s-t2 "$FX" 0 "㉑ 這回合的 tool call 指名了 inkstone/ISEP#996(結論寫在票上)⇒ 不點名" "$TR"
|
||||
for i in 1 2 3 4; do
|
||||
fire s-t2 "$FX" 0 "㉒ 同上第 $i 次——指名過就不該累積成擋下" "$TR"
|
||||
done
|
||||
mktranscript "$TR" "python3 scripts/ticket say inkstone/ISEP#111 -F /tmp/x.md"
|
||||
fire s-t2 "$FX" 2 "㉓ 換成指名**別的**票號 ⇒ 這個 PR 仍然沒被碰 ⇒ 擋"
|
||||
|
||||
echo "── E 群:響過就退讓(訊息裡承諾的出路真的存在)────────────────"
|
||||
|
||||
FX="$TMP/backoff.json"; mkfx "$FX" "inkstone/ISEP#995|$OLD|$OLD|||"
|
||||
fire s-bo "$FX" 2 "㉔ 第 1 次 ⇒ 擋(門檻 1)"
|
||||
for i in 1 2 3; do
|
||||
fire s-bo "$FX" 0 "㉕ 擋過之後第 $i 個回合——門檻已加倍(1→4),不該再響"
|
||||
done
|
||||
fire s-bo "$FX" 2 "㉖ 第 4 個回合 ⇒ 再擋一次(門檻 4)"
|
||||
for i in 1 2 3 4 5 6 7; do
|
||||
fire s-bo "$FX" 0 "㉗ 再擋過之後第 $i 個回合——門檻 4→8,不該響"
|
||||
done
|
||||
fire s-bo "$FX" 2 "㉘ 第 8 個回合 ⇒ 再擋(證明退讓是加倍不是無限)"
|
||||
|
||||
# 訊息說「把它指派給那個人,本閘立刻不再點名它」——這條出路要真的走得通
|
||||
mkfx "$FX" "inkstone/ISEP#995|$OLD|$OLD|claude-code||"
|
||||
for i in 1 2 3 4 5 6 7 8 9; do
|
||||
fire s-bo "$FX" 0 "㉙ 指派下去之後第 $i 個回合 ⇒ 永遠不再點名(訊息承諾的出路成立)"
|
||||
done
|
||||
|
||||
echo
|
||||
printf '結果:%s 通過 / %s 失敗(共 %s 條)\n' "$PASS" "$FAIL" "$N"
|
||||
[ "$FAIL" -eq 0 ] || exit 1
|
||||
Executable
+634
@@ -0,0 +1,634 @@
|
||||
#!/usr/bin/env python3
|
||||
"""milestone-account — 每次結案都留下「估多久/花多久/差多少/為什麼」(inkstone/ISEP#85)。
|
||||
|
||||
leo 的問題(票上原文):「leo 2026-08-27 說今天『**拖時間**』。但拖了多久、
|
||||
比預計多拖多少、為什麼拖——**沒有任何數字**⋯⋯每次事後只能用『這次比較慢』
|
||||
這種話帶過,下次還是一樣。」
|
||||
|
||||
milestone-account codes 七個代號是哪七個(封閉集合)
|
||||
milestone-account list --org inkstone [--overdue] 現在每個里程碑的三個數字
|
||||
milestone-account audit inkstone/ISEP#12 從 Gitea 時間軸算證據
|
||||
milestone-account close inkstone/ISEP#12 --reason idle [--dry-run]
|
||||
milestone-account report 累計:哪一種原因最常發生
|
||||
milestone-account ledger-path 帳本檔在哪(給閘問的)
|
||||
|
||||
🔴 這支工具的三條,全部長在機器上(不是寫在規範裡靠人記得):
|
||||
|
||||
① **三個數字自己算,不用手填**:期限與實際都取自 Gitea 的 `created_at`/
|
||||
`due_on`/`closed_at`。手填的數字沒有人會去對,等於沒有。
|
||||
② **差超過 25%(超時或提早都算)就一定要挑一個代號**,挑不出來不准結案。
|
||||
提早太多不是好消息,是**當初估太鬆**——所以兩個方向同一條線。
|
||||
③ **代號要有時間軸撐得住**:`audit` 先從 Gitea 的時間軸算出哪幾個訊號成立,
|
||||
`close` 只接受**訊號成立的那幾個代號**;一個都沒成立時,唯一合法的代號
|
||||
就是 `misestimate`(=票上那句「以上都沒有,但還是差很多」)。
|
||||
⇒ **不採信我自己說的**,這是票上寫死的。
|
||||
|
||||
🔴 代號是**封閉集合**,這一點是刻意的——票上原文:「**能統計的前提是分類有限**」。
|
||||
真的歸不進去才提案加一個,而那要走 leo 核准(開票,不是自己加)。
|
||||
|
||||
離線測試:`scripts/test-milestone-account.sh`(走 `MILESTONE_ACCOUNT_FIXTURE`,不打網路)。
|
||||
"""
|
||||
import json
|
||||
import os
|
||||
import re
|
||||
import subprocess
|
||||
import sys
|
||||
import time
|
||||
import urllib.error
|
||||
import urllib.parse
|
||||
import urllib.request
|
||||
|
||||
HOST = os.environ.get("MILESTONE_ACCOUNT_HOST", "https://git.uncle6.me")
|
||||
HERE = os.path.dirname(os.path.abspath(__file__))
|
||||
ROOT = os.path.dirname(HERE)
|
||||
def _resolve_dir():
|
||||
"""帳本住哪裡。
|
||||
|
||||
🔴 **不能住在 plugin 目錄裡**:ISEP 是用 marketplace 裝的,
|
||||
`claude plugin update` 會把那個目錄整個換掉 ⇒ 累積幾個月的帳一次歸零,
|
||||
而這張票的全部價值就在「累積」。
|
||||
順序:環境變數 → 這個 session 的專案根底下的 `system-dev/`(總管的跨專案知識庫,
|
||||
帳本本來就屬於那一層)→ 這份原始碼所在 repo 的 `system-dev/` → `~/.claude/`。
|
||||
"""
|
||||
v = os.environ.get("MILESTONE_ACCOUNT_DIR")
|
||||
if v:
|
||||
return v
|
||||
for base in (os.environ.get("CLAUDE_PROJECT_DIR") or "", ROOT):
|
||||
if base and os.path.isdir(os.path.join(base, "system-dev")):
|
||||
return os.path.join(base, "system-dev", "estimates")
|
||||
return os.path.join(os.path.expanduser("~"), ".claude", "isep-estimates")
|
||||
|
||||
|
||||
DIR = _resolve_dir()
|
||||
LEDGER = os.path.join(DIR, "ledger.jsonl")
|
||||
FIXTURE = os.environ.get("MILESTONE_ACCOUNT_FIXTURE", "")
|
||||
DRY = False
|
||||
THRESHOLD = 25.0 # 差超過幾 % 就一定要挑代號(票上寫死「四分之一」)
|
||||
|
||||
# ── 封閉集合:七個代號,一個都不准多、不准少 ──────────────────────────────
|
||||
CODES = [
|
||||
("idle", "磨洋工", "小事拖成大事", "時間軸上有長長的空白"),
|
||||
("sidetrack", "分心跳線", "講到別的就跑去做", "期間出現不屬於這條線的動作"),
|
||||
("undispatched", "忘了派工", "該派沒派,票停著", "票很久沒有人被指派"),
|
||||
("cherry-pick", "偏科", "挑喜歡的做,難的擱著", "完成順序跟優先順序倒過來"),
|
||||
("waiting", "等答案", "問了就原地等,沒去做別的", "等待期間其他票零進度"),
|
||||
("scope-creep", "範圍變大", "一直塞新東西進來", "補收的次數、票數成長曲線"),
|
||||
("misestimate", "純粹估錯", "過程沒異常,就是估錯", "以上都沒有,但還是差很多"),
|
||||
]
|
||||
CODE_IDS = [c[0] for c in CODES]
|
||||
LABEL = {c[0]: c[1] for c in CODES}
|
||||
|
||||
|
||||
def die(msg, code=2):
|
||||
print(msg, file=sys.stderr)
|
||||
sys.exit(code)
|
||||
|
||||
|
||||
def token():
|
||||
root = os.environ.get("CLAUDE_PROJECT_DIR") or HERE
|
||||
host = 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 host in line:
|
||||
m = re.search(r"//[^:/]+:([^@]+)@", line)
|
||||
if m:
|
||||
return m.group(1)
|
||||
for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
|
||||
if os.environ.get(env):
|
||||
return os.environ[env]
|
||||
return ""
|
||||
|
||||
|
||||
_FX = None
|
||||
|
||||
|
||||
def fx():
|
||||
global _FX
|
||||
if _FX is None:
|
||||
try:
|
||||
with open(FIXTURE) as f:
|
||||
_FX = json.load(f)
|
||||
except Exception:
|
||||
die("🔴 讀不到 MILESTONE_ACCOUNT_FIXTURE:%s" % FIXTURE)
|
||||
return _FX
|
||||
|
||||
|
||||
def api(path, payload=None, method=None):
|
||||
verb = method or ("POST" if payload is not None else "GET")
|
||||
if FIXTURE:
|
||||
if verb == "GET":
|
||||
return (fx().get("api") or {}).get(path)
|
||||
print(" [fixture] %s %s %s" % (verb, path, json.dumps(payload or {})))
|
||||
return {}
|
||||
if DRY and verb != "GET":
|
||||
print(" [dry-run] %s %s %s" % (verb, path, json.dumps(payload or {})))
|
||||
return {}
|
||||
tk = token()
|
||||
if not tk:
|
||||
die("🔴 拿不到 %s 的 token(remote 沒帶憑證,也沒有 GITEA_TOKEN_CLAUDE_CODE)" % HOST)
|
||||
data = json.dumps(payload).encode() if payload is not None else None
|
||||
req = urllib.request.Request(
|
||||
HOST + "/api/v1" + path, data=data, method=verb,
|
||||
headers={"Authorization": "token " + tk, "Content-Type": "application/json"})
|
||||
try:
|
||||
raw = urllib.request.urlopen(req, timeout=30).read()
|
||||
return json.loads(raw) if raw.strip() else {}
|
||||
except urllib.error.HTTPError as e:
|
||||
if e.code == 404:
|
||||
return None
|
||||
die("🔴 Gitea %d on %s %s:%s" % (e.code, verb, path, e.read().decode()[:200]))
|
||||
except Exception as e:
|
||||
die("🔴 連不上 %s:%s" % (HOST, e))
|
||||
|
||||
|
||||
# ── 時間 ─────────────────────────────────────────────────────────────────
|
||||
_TS = re.compile(r"^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2}):(\d{2})"
|
||||
r"(?:\.\d+)?(Z|[+-]\d{2}:?\d{2})?$")
|
||||
|
||||
|
||||
def ts(s):
|
||||
"""Gitea 的時間字串 → epoch 秒。認得 Z 與 +08:00 兩種尾巴;認不得回 None。"""
|
||||
if not s:
|
||||
return None
|
||||
m = _TS.match(str(s).strip())
|
||||
if not m:
|
||||
return None
|
||||
y, mo, d, h, mi, se, off = m.groups()
|
||||
t = time.mktime((int(y), int(mo), int(d), int(h), int(mi), int(se), 0, 1, 0)) \
|
||||
- time.timezone
|
||||
if off and off not in ("Z", "z"):
|
||||
sign = 1 if off[0] == "+" else -1
|
||||
off = off[1:].replace(":", "")
|
||||
t -= sign * (int(off[:2]) * 3600 + int(off[2:]) * 60)
|
||||
return t
|
||||
|
||||
|
||||
def now():
|
||||
v = os.environ.get("MILESTONE_ACCOUNT_NOW")
|
||||
return ts(v) if v else time.time()
|
||||
|
||||
|
||||
def days(sec):
|
||||
return sec / 86400.0
|
||||
|
||||
|
||||
def parse_ref(s):
|
||||
m = re.match(r"^([\w.-]+)/([\w.-]+)#(\d+)$", s.strip())
|
||||
if not m:
|
||||
die("🔴 寫法是 owner/repo#里程碑編號,你給的是:%s" % s)
|
||||
return m.group(1), m.group(2), int(m.group(3))
|
||||
|
||||
|
||||
# ── 三個數字 ─────────────────────────────────────────────────────────────
|
||||
def numbers(ms):
|
||||
"""回 (planned_days, actual_days, deviation_pct)。算不出來的格子回 None。"""
|
||||
c, due = ts(ms.get("created_at")), ts(ms.get("due_on"))
|
||||
end = ts(ms.get("closed_at")) or now()
|
||||
if c is None:
|
||||
return None, None, None
|
||||
actual = days(end - c)
|
||||
if due is None or due <= c:
|
||||
return None, actual, None
|
||||
planned = days(due - c)
|
||||
return planned, actual, (actual - planned) / planned * 100.0
|
||||
|
||||
|
||||
def fmt(v, unit=""):
|
||||
return "—" if v is None else ("%.1f%s" % (v, unit))
|
||||
|
||||
|
||||
def three_lines(ms, planned, actual, dev):
|
||||
return (" 當初訂的期限 %s天 (%s → %s)\n"
|
||||
" 實際花掉的 %s天 (到 %s)\n"
|
||||
" 差了 %s"
|
||||
% (fmt(planned), (ms.get("created_at") or "?")[:10],
|
||||
(ms.get("due_on") or "沒填期限")[:10],
|
||||
fmt(actual), (ms.get("closed_at") or "現在")[:10],
|
||||
"算不出來(期限沒填,或期限不晚於建立日)" if dev is None
|
||||
else "%+.0f%%%s" % (dev, " 🔴 超過 ±25%,要挑代號"
|
||||
if abs(dev) > THRESHOLD else "")))
|
||||
|
||||
|
||||
# ── 從 Gitea 時間軸取證據 ────────────────────────────────────────────────
|
||||
def fetch_issues(owner, repo):
|
||||
rows, page = [], 1
|
||||
while page <= 5:
|
||||
r = api("/repos/%s/%s/issues?state=all&type=issues&limit=50&page=%d"
|
||||
% (owner, repo, page))
|
||||
if not isinstance(r, list) or not r:
|
||||
break
|
||||
rows.extend(r)
|
||||
if len(r) < 50:
|
||||
break
|
||||
page += 1
|
||||
return rows
|
||||
|
||||
|
||||
def fetch_comments(owner, repo, since):
|
||||
q = "?limit=100"
|
||||
if since:
|
||||
q += "&since=" + urllib.parse.quote(since)
|
||||
r = api("/repos/%s/%s/issues/comments%s" % (owner, repo, q))
|
||||
return r if isinstance(r, list) else []
|
||||
|
||||
|
||||
def prio(issue):
|
||||
"""優先度:p/high=3、p/med=2、p/low=1、沒標=0。"""
|
||||
v = 0
|
||||
for l in issue.get("labels") or []:
|
||||
n = (l.get("name") or "").lower()
|
||||
if n in ("p/high", "p/urgent", "p0", "p1"):
|
||||
v = max(v, 3)
|
||||
elif n in ("p/med", "p/medium", "p2"):
|
||||
v = max(v, 2)
|
||||
elif n in ("p/low", "p3"):
|
||||
v = max(v, 1)
|
||||
return v
|
||||
|
||||
|
||||
def evidence(owner, repo, ms):
|
||||
"""把 Gitea 時間軸算成七個訊號。回 (signals, detail)。
|
||||
|
||||
🔴 這裡**一句話都不讀**:全部只看時間戳、指派欄位、標籤、票的歸屬。
|
||||
票上寫死「不採信我自己說的」,所以判準不能碰任何自然語言。
|
||||
"""
|
||||
start = ts(ms.get("created_at"))
|
||||
end = ts(ms.get("closed_at")) or now()
|
||||
span = max(end - start, 1.0)
|
||||
mid = ms.get("id")
|
||||
|
||||
issues = fetch_issues(owner, repo)
|
||||
if issues is None:
|
||||
issues = []
|
||||
mine = [i for i in issues if (i.get("milestone") or {}).get("id") == mid]
|
||||
others = [i for i in issues if (i.get("milestone") or {}).get("id") != mid]
|
||||
comments = fetch_comments(owner, repo, ms.get("created_at"))
|
||||
|
||||
mine_ids = set(i.get("number") for i in mine)
|
||||
|
||||
def cnum(c):
|
||||
u = c.get("issue_url") or c.get("html_url") or ""
|
||||
m = re.search(r"/(?:issues|pulls)/(\d+)", u)
|
||||
return int(m.group(1)) if m else c.get("issue_number")
|
||||
|
||||
ev_mine, ev_other = [], []
|
||||
for i in mine:
|
||||
for k in ("created_at", "closed_at"):
|
||||
t = ts(i.get(k))
|
||||
if t and start <= t <= end:
|
||||
ev_mine.append(t)
|
||||
for c in comments:
|
||||
t = ts(c.get("created_at"))
|
||||
if not t or not (start <= t <= end):
|
||||
continue
|
||||
(ev_mine if cnum(c) in mine_ids else ev_other).append(t)
|
||||
for i in others:
|
||||
t = ts(i.get("created_at"))
|
||||
if t and start <= t <= end:
|
||||
ev_other.append(t)
|
||||
|
||||
marks = sorted([start] + ev_mine + [end])
|
||||
gap, gap_at = 0.0, None
|
||||
for a, b in zip(marks, marks[1:]):
|
||||
if b - a > gap:
|
||||
gap, gap_at = b - a, a
|
||||
sig, det = {}, {}
|
||||
|
||||
# ① 磨洋工:時間軸上有長長的空白
|
||||
sig["idle"] = days(gap) >= 2.0 and gap / span >= 0.35
|
||||
det["idle"] = ("最長空白 %.1f 天(佔整段 %.0f%%),起點 %s"
|
||||
% (days(gap), gap / span * 100,
|
||||
time.strftime("%Y-%m-%d", time.gmtime(gap_at)) if gap_at else "?"))
|
||||
|
||||
# ② 分心跳線:期間出現不屬於這條線的動作
|
||||
tot = len(ev_mine) + len(ev_other)
|
||||
ratio = (len(ev_other) / tot) if tot else 0.0
|
||||
sig["sidetrack"] = len(ev_other) >= 5 and ratio >= 0.30
|
||||
det["sidetrack"] = ("這段期間 %d 個動作在這條線上、%d 個在別的票上(%.0f%%)"
|
||||
% (len(ev_mine), len(ev_other), ratio * 100))
|
||||
|
||||
# ③ 忘了派工:票很久沒有人被指派
|
||||
naked = [i for i in mine if not (i.get("assignees") or i.get("assignee"))
|
||||
and days(end - (ts(i.get("created_at")) or end)) >= days(span) * 0.5]
|
||||
sig["undispatched"] = len(naked) > 0
|
||||
det["undispatched"] = ("%d 張票整段期間沒有人被指派:%s"
|
||||
% (len(naked), ", ".join("#%s" % i.get("number")
|
||||
for i in naked[:6])) if naked
|
||||
else "每一張票都有人被指派過")
|
||||
|
||||
# ④ 偏科:完成順序跟優先順序倒過來
|
||||
inv = 0
|
||||
closed = [i for i in mine if ts(i.get("closed_at"))]
|
||||
openv = [i for i in mine if not ts(i.get("closed_at"))]
|
||||
for a in closed:
|
||||
for b in closed:
|
||||
if prio(a) < prio(b) and ts(a["closed_at"]) < ts(b["closed_at"]):
|
||||
inv += 1
|
||||
for a in closed:
|
||||
for b in openv:
|
||||
if prio(a) < prio(b):
|
||||
inv += 1
|
||||
sig["cherry-pick"] = inv >= 2
|
||||
det["cherry-pick"] = ("低優先先收掉、高優先還晾著的配對 %d 組" % inv)
|
||||
|
||||
# ⑤ 等答案:等待期間其他票零進度
|
||||
waitset = [i for i in mine
|
||||
if any((l.get("name") or "").lower() == "human"
|
||||
for l in (i.get("labels") or []))]
|
||||
wait_days = 0.0
|
||||
for i in waitset:
|
||||
s = ts(i.get("created_at")) or start
|
||||
e = ts(i.get("closed_at")) or end
|
||||
wait_days = max(wait_days, days(e - s))
|
||||
moved = sum(1 for i in mine
|
||||
if ts(i.get("closed_at")) and i not in waitset)
|
||||
sig["waiting"] = bool(waitset) and wait_days >= days(span) * 0.30 and moved == 0
|
||||
det["waiting"] = ("掛 Human 的票 %d 張、最長等 %.1f 天;期間其他票關掉 %d 張"
|
||||
% (len(waitset), wait_days, moved))
|
||||
|
||||
# ⑥ 範圍變大:補收的次數、票數成長曲線
|
||||
late = [i for i in mine
|
||||
if (ts(i.get("created_at")) or start) > start + span * 0.25]
|
||||
sig["scope-creep"] = len(late) >= 1 and len(mine) and len(late) / len(mine) >= 0.20
|
||||
det["scope-creep"] = ("開跑之後才補進來的票 %d/%d 張:%s"
|
||||
% (len(late), len(mine),
|
||||
", ".join("#%s" % i.get("number") for i in late[:6])))
|
||||
|
||||
# ⑦ 純粹估錯:以上都沒有
|
||||
sig["misestimate"] = not any(sig[c] for c in CODE_IDS if c != "misestimate")
|
||||
det["misestimate"] = ("上面六個訊號%s成立"
|
||||
% ("一個都沒有" if sig["misestimate"] else "有"))
|
||||
return sig, det
|
||||
|
||||
|
||||
def get_milestone(owner, repo, num):
|
||||
ms = api("/repos/%s/%s/milestones/%d" % (owner, repo, num))
|
||||
if not isinstance(ms, dict) or not ms.get("id"):
|
||||
die("🔴 抓不到里程碑 %s/%s#%d(編號對嗎?)" % (owner, repo, num))
|
||||
return ms
|
||||
|
||||
|
||||
# ── 指令 ─────────────────────────────────────────────────────────────────
|
||||
def cmd_codes(argv):
|
||||
print("七個代號(封閉集合,inkstone/ISEP#85)——「能統計的前提是分類有限」\n")
|
||||
for cid, label, plain, how in CODES:
|
||||
print(" %-13s %-8s %-22s 從哪看出來:%s" % (cid, label, plain, how))
|
||||
print("\n真的歸不進去 ⇒ 開一張票請 leo 核准加一個,**不要自己加**。")
|
||||
|
||||
|
||||
def _repos(argv):
|
||||
rs = [r for r in (argv[i + 1] for i, a in enumerate(argv)
|
||||
if a == "--repo" and i + 1 < len(argv))]
|
||||
if rs:
|
||||
return rs
|
||||
org = None
|
||||
for i, a in enumerate(argv):
|
||||
if a == "--org" and i + 1 < len(argv):
|
||||
org = argv[i + 1]
|
||||
if not org:
|
||||
die("用法:milestone-account list --org inkstone [--overdue] 或 --repo owner/repo")
|
||||
rows = api("/orgs/%s/repos?limit=100" % org)
|
||||
if not isinstance(rows, list):
|
||||
die("🔴 撈不到 %s 底下的 repo" % org)
|
||||
return [r["full_name"] for r in rows]
|
||||
|
||||
|
||||
def cmd_list(argv):
|
||||
overdue = "--overdue" in argv
|
||||
n = 0
|
||||
for full in _repos(argv):
|
||||
owner, repo = full.split("/", 1)
|
||||
mss = api("/repos/%s/%s/milestones?state=open&limit=50" % (owner, repo))
|
||||
if not isinstance(mss, list):
|
||||
continue
|
||||
for ms in mss:
|
||||
planned, actual, dev = numbers(ms)
|
||||
late = dev is not None and dev > 0
|
||||
if overdue and not late:
|
||||
continue
|
||||
n += 1
|
||||
print("%s %-34s %-30s 估 %s天/已 %s天/%s"
|
||||
% ("🔴" if (dev is not None and abs(dev) > THRESHOLD) else " ",
|
||||
"%s#%s" % (full, ms.get("id")), (ms.get("title") or "")[:28],
|
||||
fmt(planned), fmt(actual),
|
||||
"—" if dev is None else "%+.0f%%" % dev))
|
||||
print("\n共 %d 個%s里程碑。🔴 = 差超過 ±25%%,結案時一定要挑一個代號。"
|
||||
% (n, "逾期的 " if overdue else "open "))
|
||||
print("挑代號之前先跑:milestone-account audit <owner/repo#編號>")
|
||||
|
||||
|
||||
def cmd_audit(argv):
|
||||
if not argv:
|
||||
die("用法:milestone-account audit <owner/repo#里程碑編號>")
|
||||
owner, repo, num = parse_ref(argv[0])
|
||||
ms = get_milestone(owner, repo, num)
|
||||
planned, actual, dev = numbers(ms)
|
||||
print("【%s/%s#%d】%s\n" % (owner, repo, num, ms.get("title") or ""))
|
||||
print(three_lines(ms, planned, actual, dev))
|
||||
sig, det = evidence(owner, repo, ms)
|
||||
print("\n【時間軸怎麼說】(全部取自 Gitea 的時間戳/欄位,一句話都沒讀)")
|
||||
for cid, label, _plain, _how in CODES:
|
||||
print(" %s %-13s %-8s %s" % ("🔴" if sig[cid] else " ", cid, label, det[cid]))
|
||||
ok = [c for c in CODE_IDS if sig[c]]
|
||||
print("\n可以挑的代號:%s" % " / ".join(ok))
|
||||
print("結案:milestone-account close %s/%s#%d --reason %s" % (owner, repo, num, ok[0]))
|
||||
|
||||
|
||||
def _ledger():
|
||||
rows = []
|
||||
try:
|
||||
with open(LEDGER) as f:
|
||||
for line in f:
|
||||
line = line.strip()
|
||||
if line:
|
||||
try:
|
||||
rows.append(json.loads(line))
|
||||
except Exception:
|
||||
pass
|
||||
except Exception:
|
||||
pass
|
||||
return rows
|
||||
|
||||
|
||||
def cmd_close(argv):
|
||||
if not argv:
|
||||
die("用法:milestone-account close <owner/repo#編號> [--reason 代號] [--dry-run]")
|
||||
owner, repo, num = parse_ref(argv[0])
|
||||
ref = "%s/%s#%d" % (owner, repo, num)
|
||||
reason = None
|
||||
for i, a in enumerate(argv):
|
||||
if a == "--reason" and i + 1 < len(argv):
|
||||
reason = argv[i + 1]
|
||||
|
||||
ms = get_milestone(owner, repo, num)
|
||||
planned, actual, dev = numbers(ms)
|
||||
print("【%s】%s\n" % (ref, ms.get("title") or ""))
|
||||
print(three_lines(ms, planned, actual, dev))
|
||||
|
||||
sig, det = evidence(owner, repo, ms)
|
||||
legal = [c for c in CODE_IDS if sig[c]]
|
||||
need = dev is None or abs(dev) > THRESHOLD
|
||||
|
||||
if need and not reason:
|
||||
die("\n🚫 **差 %s,超過 ±25%%——挑不出代號不准結案。**\n\n"
|
||||
"【inkstone/ISEP#85】「差超過四分之一(不管是超時還是提早太多,\n"
|
||||
" **提早太多代表當初估太鬆**)就要挑一個原因,而且**只能從固定的幾個裡面挑**,\n"
|
||||
" 不准用一段話帶過。」\n\n"
|
||||
"時間軸撐得住的代號:%s\n"
|
||||
"%s\n"
|
||||
" 再送一次:milestone-account close %s --reason %s\n"
|
||||
" 想看全部七個:milestone-account codes / 看證據:milestone-account audit %s"
|
||||
% ("算不出來(期限沒填)" if dev is None else "%+.0f%%" % dev,
|
||||
" / ".join(legal),
|
||||
"\n".join(" %-13s %s" % (c, det[c]) for c in legal), ref, legal[0], ref))
|
||||
|
||||
if reason:
|
||||
if reason not in CODE_IDS:
|
||||
die("\n🚫 `%s` 不是那七個代號之一。\n"
|
||||
" 【inkstone/ISEP#85】代號是**封閉集合**——「能統計的前提是分類有限」。\n"
|
||||
" 七個:%s\n"
|
||||
" 真的歸不進去 ⇒ 開票請 leo 核准加一個,不要自己造。"
|
||||
% (reason, " / ".join(CODE_IDS)))
|
||||
if reason not in legal:
|
||||
die("\n🚫 `%s`(%s)**時間軸撐不住**——不接受。\n\n"
|
||||
" 【inkstone/ISEP#85】「證據一律從 Gitea 的時間軸取"
|
||||
"(留言、指派、標籤、commit 都有時間戳),**不採信我自己說的**。」\n\n"
|
||||
" 這個代號的訊號:%s\n"
|
||||
" 撐得住的是:%s\n"
|
||||
" (訊號真的判錯了 ⇒ 那是 audit 的 bug,去修偵測器,"
|
||||
"不是在這裡繞過去——這條線的意義就是「可以統計、可以迭代」。)"
|
||||
% (reason, LABEL[reason], det[reason], " / ".join(legal)))
|
||||
|
||||
rec = {"ref": ref, "title": ms.get("title") or "",
|
||||
"created_at": ms.get("created_at"), "due_on": ms.get("due_on"),
|
||||
"closed_at": ms.get("closed_at") or time.strftime(
|
||||
"%Y-%m-%dT%H:%M:%SZ", time.gmtime(now())),
|
||||
"planned_days": None if planned is None else round(planned, 2),
|
||||
"actual_days": None if actual is None else round(actual, 2),
|
||||
"deviation_pct": None if dev is None else round(dev, 1),
|
||||
"over_threshold": bool(need),
|
||||
"reason": reason, "reason_label": LABEL.get(reason or "", ""),
|
||||
"signals": {c: bool(sig[c]) for c in CODE_IDS},
|
||||
"evidence": {c: det[c] for c in CODE_IDS},
|
||||
"recorded_at": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime(now()))}
|
||||
|
||||
if DRY:
|
||||
print("\n[dry-run] 會寫進 %s:" % LEDGER)
|
||||
print(json.dumps(rec, ensure_ascii=False, indent=2)[:900])
|
||||
print(" [dry-run] PATCH /repos/%s/%s/milestones/%d {\"state\": \"closed\"}"
|
||||
% (owner, repo, num))
|
||||
print("[dry-run] 一筆都沒有真的寫出去。")
|
||||
return
|
||||
|
||||
# 🔴 順序:**先記帳、再關**。反過來的話,關成功而記帳失敗,
|
||||
# 那個里程碑就永遠不會出現在統計裡——而那正是這張票要解的病。
|
||||
os.makedirs(DIR, exist_ok=True)
|
||||
with open(LEDGER, "a") as f:
|
||||
f.write(json.dumps(rec, ensure_ascii=False) + "\n")
|
||||
print("\n✅ 已記帳:%s 估 %s天/花 %s天/%s%s"
|
||||
% (ref, fmt(planned), fmt(actual),
|
||||
"—" if dev is None else "%+.0f%%" % dev,
|
||||
" 原因=%s(%s)" % (reason, LABEL[reason]) if reason else ""))
|
||||
|
||||
if (ms.get("state") or "") != "closed":
|
||||
api("/repos/%s/%s/milestones/%d" % (owner, repo, num),
|
||||
{"state": "closed"}, method="PATCH")
|
||||
print("✅ 里程碑已關閉")
|
||||
else:
|
||||
print("ℹ️ 里程碑本來就是 closed,只補記帳")
|
||||
write_report()
|
||||
print("📊 累計統計已更新:%s" % os.path.join(DIR, "REPORT.md"))
|
||||
|
||||
|
||||
def write_report():
|
||||
rows = _ledger()
|
||||
cnt = {}
|
||||
for r in rows:
|
||||
if r.get("reason"):
|
||||
cnt[r["reason"]] = cnt.get(r["reason"], 0) + 1
|
||||
devs = [r["deviation_pct"] for r in rows if r.get("deviation_pct") is not None]
|
||||
lines = ["# 估多久/花多久/差多少——累計統計", "",
|
||||
"> 這份檔案由 `scripts/milestone-account` 自動重寫,**不要手改**。",
|
||||
"> 【inkstone/ISEP#85】「每次事後只能用『這次比較慢』這種話帶過,"
|
||||
"下次還是一樣。」", "",
|
||||
"- 累計結案 **%d** 個里程碑" % len(rows)]
|
||||
if devs:
|
||||
lines.append("\t- 平均偏差 **%+.0f%%**(正=超時,負=提早)"
|
||||
% (sum(devs) / len(devs)))
|
||||
lines.append("\t- 超過 ±25%% 的有 **%d** 個"
|
||||
% sum(1 for d in devs if abs(d) > THRESHOLD))
|
||||
lines.append("- 哪一種原因最常發生(這才是迭代的依據)")
|
||||
if not cnt:
|
||||
lines.append("\t- 目前還沒有任何被挑過的代號。")
|
||||
for cid, n in sorted(cnt.items(), key=lambda kv: -kv[1]):
|
||||
lines.append("\t- **%s(%s)** ×%d" % (LABEL.get(cid, cid), cid, n))
|
||||
lines.append("- 逐筆")
|
||||
for r in sorted(rows, key=lambda r: r.get("recorded_at") or "", reverse=True):
|
||||
lines.append("\t- `%s` %s" % (r["ref"], r.get("title", "")))
|
||||
lines.append("\t\t- 估 %s 天/花 %s 天/差 %s"
|
||||
% (r.get("planned_days"), r.get("actual_days"),
|
||||
"—" if r.get("deviation_pct") is None
|
||||
else "%+.0f%%" % r["deviation_pct"]))
|
||||
if r.get("reason"):
|
||||
lines.append("\t\t- 原因:**%s(%s)**" % (r.get("reason_label"), r["reason"]))
|
||||
lines.append("\t\t- 時間軸證據:%s"
|
||||
% (r.get("evidence") or {}).get(r["reason"], "—"))
|
||||
try:
|
||||
os.makedirs(DIR, exist_ok=True)
|
||||
with open(os.path.join(DIR, "REPORT.md"), "w") as f:
|
||||
f.write("\n".join(lines) + "\n")
|
||||
except Exception as e:
|
||||
die("🔴 寫不進 %s:%s" % (DIR, e))
|
||||
|
||||
|
||||
def cmd_report(argv):
|
||||
rows = _ledger()
|
||||
if not rows:
|
||||
print("(帳本還是空的:%s)" % LEDGER)
|
||||
print("關掉第一個里程碑就會有第一筆:milestone-account close <owner/repo#編號>")
|
||||
return
|
||||
cnt = {}
|
||||
for r in rows:
|
||||
if r.get("reason"):
|
||||
cnt[r["reason"]] = cnt.get(r["reason"], 0) + 1
|
||||
devs = [r["deviation_pct"] for r in rows if r.get("deviation_pct") is not None]
|
||||
print("累計結案 %d 個里程碑" % len(rows))
|
||||
if devs:
|
||||
print("平均偏差 %+.0f%%(正=超時,負=提早);超過 ±25%% 的有 %d 個"
|
||||
% (sum(devs) / len(devs), sum(1 for d in devs if abs(d) > THRESHOLD)))
|
||||
print("\n哪一種原因最常發生:")
|
||||
if not cnt:
|
||||
print(" (還沒有任何被挑過的代號)")
|
||||
for cid, n in sorted(cnt.items(), key=lambda kv: -kv[1]):
|
||||
print(" %-13s %-8s ×%d %s" % (cid, LABEL.get(cid, cid), n, "█" * n))
|
||||
write_report()
|
||||
print("\n人看的版本:%s" % os.path.join(DIR, "REPORT.md"))
|
||||
|
||||
|
||||
def main():
|
||||
global DRY
|
||||
argv = sys.argv[1:]
|
||||
if "--dry-run" in argv:
|
||||
DRY = True
|
||||
argv = [a for a in argv if a != "--dry-run"]
|
||||
if not argv:
|
||||
print(__doc__)
|
||||
return
|
||||
cmd, rest = argv[0], argv[1:]
|
||||
table = {"codes": cmd_codes, "list": cmd_list, "audit": cmd_audit,
|
||||
"close": cmd_close, "report": cmd_report,
|
||||
# 給 hooks/milestone-account-guard.sh 問「帳本在哪」用的。
|
||||
# 讓「怎麼找到帳本」只有一份答案,閘不必自己再實作一次解析。
|
||||
"ledger-path": lambda a: print(LEDGER)}
|
||||
if cmd not in table:
|
||||
print(__doc__)
|
||||
die("🔴 沒有這個子指令:%s" % cmd)
|
||||
table[cmd](rest)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,257 @@
|
||||
#!/usr/bin/env python3
|
||||
"""pr-verdict — 給 PR 一個結論,一個動作把該做的全做完(inkstone/ISEP#81)。
|
||||
|
||||
leo 的問題(票上原文):「我交出去的 PR 沒有人去看它⋯⋯票看起來是『已交付』,
|
||||
但東西沒有進 main,也就沒有進版本,**leo 手上永遠不會出現它**。」
|
||||
|
||||
「有結論」只有三種,缺一不可:
|
||||
|
||||
pr-verdict merge <owner/repo#N> 併 + **當場刪掉那條 branch**
|
||||
pr-verdict reject <owner/repo#N> --ticket <票> -F <檔> 退回:理由寫**票上** + 關 PR
|
||||
pr-verdict changes <owner/repo#N> --ticket <票> -F <檔> 要求修改:寫**票上** + REQUEST_CHANGES
|
||||
pr-verdict list 撈一次:誰還沒有結論
|
||||
|
||||
🔴 為什麼要有這支、而不是叫人記得多做一步:
|
||||
「merge 完要刪 branch」「退回理由要寫在票上」都是**第二個動作**,
|
||||
而所有掉棒的形狀都長一樣——第一個動作做了,第二個沒有。
|
||||
把兩件事綁成一個指令,就沒有「忘了做第二件」這個狀態可以存在。
|
||||
|
||||
🔴 `--dry-run` 會把要打的每一通 API 印出來但不送出。
|
||||
加在任何子指令上都有效;**收工前想確認自己按下去會發生什麼,用它。**
|
||||
"""
|
||||
import json
|
||||
import os
|
||||
import re
|
||||
import subprocess
|
||||
import sys
|
||||
import urllib.error
|
||||
import urllib.parse
|
||||
import urllib.request
|
||||
|
||||
HOST = os.environ.get("PR_VERDICT_HOST", "https://git.uncle6.me")
|
||||
DRY = False
|
||||
|
||||
|
||||
def die(msg, code=2):
|
||||
print(msg, file=sys.stderr)
|
||||
sys.exit(code)
|
||||
|
||||
|
||||
def token():
|
||||
root = os.environ.get("CLAUDE_PROJECT_DIR") or os.getcwd()
|
||||
host = 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 host in line:
|
||||
m = re.search(r"//[^:/]+:([^@]+)@", line)
|
||||
if m:
|
||||
return m.group(1)
|
||||
for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
|
||||
if os.environ.get(env):
|
||||
return os.environ[env]
|
||||
die(f"🔴 拿不到 {host} 的 token(remote 沒帶憑證,也沒有 GITEA_TOKEN_CLAUDE_CODE)")
|
||||
|
||||
|
||||
def api(path, payload=None, method=None, soft=False):
|
||||
verb = method or ("POST" if payload is not None else "GET")
|
||||
if DRY and verb != "GET":
|
||||
print(f" [dry-run] {verb} {path}"
|
||||
+ (f"\n {json.dumps(payload, ensure_ascii=False)}" if payload else ""))
|
||||
return {}
|
||||
url = path if path.startswith("http") else f"{HOST}/api/v1{path}"
|
||||
data = json.dumps(payload).encode() if payload is not None else None
|
||||
req = urllib.request.Request(
|
||||
url, data=data, method=verb,
|
||||
headers={"Authorization": f"token {token()}", "Content-Type": "application/json"})
|
||||
try:
|
||||
raw = urllib.request.urlopen(req, timeout=40).read()
|
||||
return json.loads(raw) if raw.strip() else {}
|
||||
except urllib.error.HTTPError as e:
|
||||
if soft:
|
||||
return {"__status__": e.code}
|
||||
die(f"🔴 Gitea {e.code} on {verb} {path}:{e.read().decode()[:300]}")
|
||||
|
||||
|
||||
def parse_ref(s):
|
||||
m = re.match(r"^([\w.-]+)/([\w.-]+)#(\d+)$", s.strip())
|
||||
if not m:
|
||||
die(f"🔴 寫法是 owner/repo#N,你給的是:{s}")
|
||||
return m.group(1), m.group(2), int(m.group(3))
|
||||
|
||||
|
||||
def read_body(argv, what):
|
||||
if "-F" not in argv:
|
||||
die(f"🚫 缺 -F <檔>:{what}要**寫在票上**,不是寫在訊息裡。\n"
|
||||
f" (inkstone/ISEP#81:「退回理由寫在票上(寫票,不是寫訊息)」)")
|
||||
p = argv[argv.index("-F") + 1]
|
||||
try:
|
||||
with open(p) as f:
|
||||
return f.read().strip()
|
||||
except Exception as e:
|
||||
die(f"🔴 讀不到 {p}:{e}")
|
||||
|
||||
|
||||
def opt(argv, name, default=None):
|
||||
return argv[argv.index(name) + 1] if name in argv else default
|
||||
|
||||
|
||||
def say_on_ticket(ref, body):
|
||||
"""把結論貼進**票**(不是貼進 PR 的討論串——PR 會隨自己沉掉,票才是那條線的家)。
|
||||
|
||||
內文第一行帶【總管】身份欄,對齊 reply-identity-guard 的規約
|
||||
(leo 2026-08-27:「subagent 回覆時要表明身份」)。
|
||||
"""
|
||||
owner, repo, num = parse_ref(ref)
|
||||
if DRY:
|
||||
print(f" [dry-run] POST /repos/{owner}/{repo}/issues/{num}/comments")
|
||||
print(f" {body[:120]}…")
|
||||
return
|
||||
api(f"/repos/{owner}/{repo}/issues/{num}/comments", {"body": body})
|
||||
|
||||
|
||||
# ── merge ────────────────────────────────────────────────────────────────
|
||||
def cmd_merge(argv):
|
||||
if not argv:
|
||||
die("用法:pr-verdict merge <owner/repo#N> [--style merge|squash|rebase] [--dry-run]")
|
||||
owner, repo, num = parse_ref(argv[0])
|
||||
style = opt(argv, "--style", "merge")
|
||||
|
||||
pr = api(f"/repos/{owner}/{repo}/pulls/{num}")
|
||||
branch = ((pr.get("head") or {}).get("ref")) or ""
|
||||
same_repo = ((pr.get("head") or {}).get("repo") or {}).get("full_name") == f"{owner}/{repo}"
|
||||
|
||||
if not pr.get("merged"):
|
||||
if pr.get("state") != "open":
|
||||
die(f"🔴 {owner}/{repo}#{num} 不是 open(state={pr.get('state')})——沒得 merge。")
|
||||
api(f"/repos/{owner}/{repo}/pulls/{num}/merge",
|
||||
{"Do": style, "delete_branch_after_merge": True})
|
||||
if not DRY:
|
||||
print(f"✅ {owner}/{repo}#{num} 已 merge({style})")
|
||||
else:
|
||||
print(f"ℹ️ {owner}/{repo}#{num} 本來就是 merged,只補刪分支")
|
||||
|
||||
# 🔴 第二件事:**當場複驗分支真的不見了**。
|
||||
# Gitea 的 delete_branch_after_merge 在某些設定下不會生效(保護分支、
|
||||
# 跨 fork),而「我下了刪除的指令」不等於「它被刪掉了」——
|
||||
# 本 repo 心法:交出去之前,我知不知道它能不能用。
|
||||
if not branch:
|
||||
print("⚠️ 拿不到 head 分支名,無法複驗——請自己確認分支已刪。")
|
||||
return
|
||||
if not same_repo:
|
||||
print(f"ℹ️ head 在別的 repo(fork),本指令不跨 repo 刪分支:{branch}")
|
||||
return
|
||||
if DRY:
|
||||
print(f" [dry-run] DELETE /repos/{owner}/{repo}/branches/{branch}(若還在)")
|
||||
return
|
||||
if _branch_alive(owner, repo, branch):
|
||||
api(f"/repos/{owner}/{repo}/branches/{urllib.parse.quote(branch, safe='')}",
|
||||
method="DELETE", soft=True)
|
||||
if _branch_alive(owner, repo, branch):
|
||||
die(f"🔴 分支 {branch} 刪不掉(保護分支?權限?)——**結論只給了一半**,"
|
||||
f"pr-verdict-guard 會繼續點名它。")
|
||||
print(f"✅ 分支 {branch} 已刪除(複驗過:查不到了)")
|
||||
|
||||
|
||||
def _branch_alive(owner, repo, br):
|
||||
r = api(f"/repos/{owner}/{repo}/branches/{urllib.parse.quote(br, safe='')}", soft=True)
|
||||
return isinstance(r, dict) and "name" in r
|
||||
|
||||
|
||||
# ── reject / changes ─────────────────────────────────────────────────────
|
||||
def _verdict_with_reason(argv, kind):
|
||||
if not argv:
|
||||
die(f"用法:pr-verdict {kind} <owner/repo#N> --ticket <owner/repo#N> -F <檔> [--dry-run]")
|
||||
owner, repo, num = parse_ref(argv[0])
|
||||
ticket = opt(argv, "--ticket")
|
||||
if not ticket:
|
||||
die("🚫 缺 --ticket <owner/repo#N>:結論要寫在**票**上。\n"
|
||||
" PR 的討論串會隨 PR 一起沉掉;票才是那條線的家。")
|
||||
body = read_body(argv, "退回理由" if kind == "reject" else "修改要求")
|
||||
|
||||
pr = api(f"/repos/{owner}/{repo}/pulls/{num}")
|
||||
head = f"{owner}/{repo}#{num}"
|
||||
url = (pr.get("html_url") or "")
|
||||
title = "退回" if kind == "reject" else "要求修改"
|
||||
say_on_ticket(ticket, f"【總管】**PR {title}**:{head} {url}\n\n{body}")
|
||||
if not DRY:
|
||||
print(f"✅ {title}理由已寫進票 {ticket}")
|
||||
|
||||
if kind == "reject":
|
||||
api(f"/repos/{owner}/{repo}/issues/{num}", {"state": "closed"}, method="PATCH")
|
||||
if not DRY:
|
||||
print(f"✅ {head} 已關閉")
|
||||
br = ((pr.get("head") or {}).get("ref")) or ""
|
||||
same = ((pr.get("head") or {}).get("repo") or {}).get("full_name") == f"{owner}/{repo}"
|
||||
if br and same and not DRY and _branch_alive(owner, repo, br):
|
||||
api(f"/repos/{owner}/{repo}/branches/{urllib.parse.quote(br, safe='')}",
|
||||
method="DELETE", soft=True)
|
||||
print(f"✅ 分支 {br} 已刪除")
|
||||
else:
|
||||
# REQUEST_CHANGES:**讓「已經給過結論」變成 Gitea 查得到的事實**,
|
||||
# 這樣 pr-verdict-guard 就不會再把它當成被遺忘的 PR(=擋等待)。
|
||||
api(f"/repos/{owner}/{repo}/pulls/{num}/reviews",
|
||||
{"event": "REQUEST_CHANGES", "body": f"修改要求寫在 {ticket}"})
|
||||
if not DRY:
|
||||
print(f"✅ {head} 已留下 REQUEST_CHANGES review(閘看得到,不會再點名它)")
|
||||
if DRY:
|
||||
print("\n[dry-run] 以上一通都沒有送出。")
|
||||
return
|
||||
print("\n📌 兩件事是同一個動作——不會只寫了理由而 PR 還開著"
|
||||
"(reject),也不會留了 review 而票上查不到理由(changes)。")
|
||||
|
||||
|
||||
# ── list ─────────────────────────────────────────────────────────────────
|
||||
def cmd_list(argv):
|
||||
orgs = [o.strip().lower() for o in
|
||||
os.environ.get("PR_VERDICT_ORGS", "inkstone").split(",") if o.strip()]
|
||||
rows = api("/repos/issues/search?type=pulls&state=open&limit=50")
|
||||
import time
|
||||
now = time.time()
|
||||
n = 0
|
||||
for pr in rows:
|
||||
full = (pr.get("repository") or {}).get("full_name") or ""
|
||||
if "/" not in full or (orgs and full.split("/", 1)[0].lower() not in orgs):
|
||||
continue
|
||||
try:
|
||||
t = time.mktime(time.strptime(pr["created_at"][:19], "%Y-%m-%dT%H:%M:%S"))
|
||||
age = int((now - t) / 86400)
|
||||
except Exception:
|
||||
age = -1
|
||||
who = [a["login"] for a in (pr.get("assignees") or [])]
|
||||
mark = "🕒" if who else "❌"
|
||||
print(f"{mark} {full}#{pr['number']:<5} 開了 {age:>3} 天 "
|
||||
f"{'指派=' + ','.join(who) if who else '沒有人被指派'} {pr['title'][:34]}")
|
||||
n += 1
|
||||
print(f"\n共 {n} 個 open PR(org:{'/'.join(orgs) or '全部'})。"
|
||||
f" ❌=沒有人在管,pr-verdict-guard 會點名它")
|
||||
|
||||
|
||||
def main():
|
||||
global DRY
|
||||
argv = sys.argv[1:]
|
||||
if "--dry-run" in argv:
|
||||
DRY = True
|
||||
argv.remove("--dry-run")
|
||||
if not argv:
|
||||
print(__doc__)
|
||||
sys.exit(0)
|
||||
cmd, rest = argv[0], argv[1:]
|
||||
if cmd == "merge":
|
||||
cmd_merge(rest)
|
||||
elif cmd == "reject":
|
||||
_verdict_with_reason(rest, "reject")
|
||||
elif cmd == "changes":
|
||||
_verdict_with_reason(rest, "changes")
|
||||
elif cmd == "list":
|
||||
cmd_list(rest)
|
||||
else:
|
||||
print(__doc__)
|
||||
die(f"🔴 沒有這個子指令:{cmd}")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Executable
+410
@@ -0,0 +1,410 @@
|
||||
#!/usr/bin/env python3
|
||||
"""release-manifest — 一次交貨 = 一份清單(inkstone/ISEP#84)。
|
||||
|
||||
leo 的問題(票上原文):「一次交貨常常同時動到好幾個 repo,但**沒有任何地方記著
|
||||
『這一版 = 哪幾個 repo 的哪幾個版本』**⋯⋯要退版的時候,只退了其中一個 repo,
|
||||
剩下的還停在新版 ⇒ **變成一組從來沒測過的組合**。」
|
||||
|
||||
release-manifest freeze R-2026.08.30 --part inkstone/Arcrun@v1.4.52 \
|
||||
--part inkstone/arcrun-collector@v0.18.36
|
||||
release-manifest current 我現在手上是哪一版、由什麼組成
|
||||
release-manifest list 全部清單,新的在上面
|
||||
release-manifest show R-2026.08.30
|
||||
release-manifest verify R-2026.08.30 清單上的版本號現在還抓得到嗎
|
||||
release-manifest diff R-2026.08.29 R-2026.08.30
|
||||
release-manifest rollback R-2026.08.29 退版:**整份一起退**
|
||||
|
||||
🔴 三條硬規則,全部長在這支工具裡(不是寫在文件裡靠人記得):
|
||||
|
||||
① **freeze 之前每一個版本號都真的去 Gitea 抓一次**。抓不到就不給凍結——
|
||||
「寫上去」跟「存在」是兩件事,而清單的用處完全建立在後者。
|
||||
② **凍結了就不准再加東西**。同名清單已存在 ⇒ 拒絕覆寫,新的需求進下一份。
|
||||
③ **退版沒有「只退一個」這個選項**。`rollback` 一定吐出整份清單的每一格;
|
||||
指名單一 repo(`--only`)會被擋下,因為那正是票上那個病:
|
||||
**剩下的還停在新版 ⇒ 一組從來沒測過的組合。**
|
||||
|
||||
📌 跟 `release-tag-guard.sh` 是包含關係不是重複:那支管「打 tag 那一刻,
|
||||
單一 repo 內版本號三處一致」;這支管它上面那一層——**跨 repo 的組合**。
|
||||
|
||||
📌 單一 repo 的交貨不必特例:清單就退化成只有一格,規則一字不改。
|
||||
|
||||
離線測試:`scripts/test-release-manifest.sh`(走 `RELEASE_MANIFEST_FIXTURE`,不打網路)。
|
||||
"""
|
||||
import json
|
||||
import os
|
||||
import re
|
||||
import subprocess
|
||||
import sys
|
||||
import time
|
||||
import urllib.error
|
||||
import urllib.request
|
||||
|
||||
HOST = os.environ.get("RELEASE_MANIFEST_HOST", "https://git.uncle6.me")
|
||||
HERE = os.path.dirname(os.path.abspath(__file__))
|
||||
def _resolve_dir():
|
||||
"""清單住哪裡。
|
||||
|
||||
🔴 **不能住在 plugin 目錄裡**:ISEP 是用 marketplace 裝的,
|
||||
`claude plugin update` 會把那個目錄整個換掉 ⇒ 所有出貨清單一次消失,
|
||||
而清單的用處全部發生在「以後要退版的那一天」。
|
||||
順序:環境變數 → 這個 session 的專案根(有 `system-dev/` =總管的工作區,
|
||||
跨 repo 的出貨清單本來就屬於那一層)→ 這份原始碼所在 repo → `~/.claude/`。
|
||||
"""
|
||||
v = os.environ.get("RELEASE_MANIFEST_DIR")
|
||||
if v:
|
||||
return v
|
||||
root = os.path.dirname(HERE)
|
||||
for base in (os.environ.get("CLAUDE_PROJECT_DIR") or "", root):
|
||||
if base and os.path.isdir(os.path.join(base, "system-dev")):
|
||||
return os.path.join(base, "releases")
|
||||
return os.path.join(os.path.expanduser("~"), ".claude", "isep-releases")
|
||||
|
||||
|
||||
DIR = _resolve_dir()
|
||||
FIXTURE = os.environ.get("RELEASE_MANIFEST_FIXTURE", "")
|
||||
DRY = False
|
||||
|
||||
NAME_RE = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$")
|
||||
PART_RE = re.compile(r"^([\w.-]+)/([\w.-]+)@(\S+)$")
|
||||
|
||||
|
||||
def die(msg, code=2):
|
||||
print(msg, file=sys.stderr)
|
||||
sys.exit(code)
|
||||
|
||||
|
||||
def token():
|
||||
root = os.environ.get("CLAUDE_PROJECT_DIR") or HERE
|
||||
host = 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 host in line:
|
||||
m = re.search(r"//[^:/]+:([^@]+)@", line)
|
||||
if m:
|
||||
return m.group(1)
|
||||
for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
|
||||
if os.environ.get(env):
|
||||
return os.environ[env]
|
||||
return ""
|
||||
|
||||
|
||||
def _fixture():
|
||||
try:
|
||||
with open(FIXTURE) as f:
|
||||
return json.load(f)
|
||||
except Exception:
|
||||
die("🔴 讀不到 RELEASE_MANIFEST_FIXTURE:%s" % FIXTURE)
|
||||
|
||||
|
||||
def api(path):
|
||||
"""GET 一筆。回 dict/list,查不到回 None。fixture 模式完全不碰網路。"""
|
||||
if FIXTURE:
|
||||
return None
|
||||
tk = token()
|
||||
if not tk:
|
||||
die("🔴 拿不到 %s 的 token(remote 沒帶憑證,也沒有 GITEA_TOKEN_CLAUDE_CODE)" % HOST)
|
||||
try:
|
||||
req = urllib.request.Request(HOST + "/api/v1" + path,
|
||||
headers={"Authorization": "token " + tk})
|
||||
return json.load(urllib.request.urlopen(req, timeout=25))
|
||||
except urllib.error.HTTPError:
|
||||
return None
|
||||
except Exception as e:
|
||||
die("🔴 連不上 %s:%s" % (HOST, e))
|
||||
|
||||
|
||||
def resolve(owner, repo, ver):
|
||||
"""這個版本號**真的存在嗎**。存在回一段可以貼給人看的證據,不存在回 None。
|
||||
|
||||
先問 release,再問 tag:有些 repo 只打 tag 沒建 release,那也算存在
|
||||
(票上要的是「抓得到那個 release」=抓得到那個版本,不是逼每個 repo 都建 release 頁)。
|
||||
"""
|
||||
if FIXTURE:
|
||||
fx = _fixture().get("versions") or {}
|
||||
return fx.get("%s/%s@%s" % (owner, repo, ver))
|
||||
r = api("/repos/%s/%s/releases/tags/%s" % (owner, repo, ver))
|
||||
if isinstance(r, dict) and r.get("tag_name"):
|
||||
return {"kind": "release", "url": r.get("html_url") or "",
|
||||
"commit": (r.get("target_commitish") or "")[:12]}
|
||||
t = api("/repos/%s/%s/tags/%s" % (owner, repo, ver))
|
||||
if isinstance(t, dict) and t.get("name"):
|
||||
return {"kind": "tag", "url": (t.get("commit") or {}).get("url") or "",
|
||||
"commit": ((t.get("commit") or {}).get("sha") or "")[:12]}
|
||||
return None
|
||||
|
||||
|
||||
# ── 清單的存取 ────────────────────────────────────────────────────────────
|
||||
def path_of(name):
|
||||
return os.path.join(DIR, name + ".json")
|
||||
|
||||
|
||||
def load(name):
|
||||
try:
|
||||
with open(path_of(name)) as f:
|
||||
return json.load(f)
|
||||
except Exception:
|
||||
return None
|
||||
|
||||
|
||||
def all_manifests():
|
||||
try:
|
||||
names = [f[:-5] for f in os.listdir(DIR) if f.endswith(".json")]
|
||||
except Exception:
|
||||
return []
|
||||
rows = [load(n) for n in names]
|
||||
rows = [m for m in rows if m]
|
||||
# 🔴 排序鍵不能只用時間戳:同一分鐘凍兩份清單就會並列,
|
||||
# 而並列之後「現在手上的是哪一份」會變成 os.listdir 的順序(等於隨機)。
|
||||
# seq 是 freeze 當下遞增的流水號 ⇒ 先後永遠有唯一解。
|
||||
rows.sort(key=lambda m: (m.get("seq", 0), m.get("frozen_at") or ""), reverse=True)
|
||||
return rows
|
||||
|
||||
|
||||
def parse_part(s):
|
||||
m = PART_RE.match(s.strip())
|
||||
if not m:
|
||||
die("🔴 寫法是 owner/repo@版本號,你給的是:%s" % s)
|
||||
return m.group(1), m.group(2), m.group(3)
|
||||
|
||||
|
||||
def opts(argv, name):
|
||||
return [argv[i + 1] for i, a in enumerate(argv) if a == name and i + 1 < len(argv)]
|
||||
|
||||
|
||||
def opt(argv, name, default=None):
|
||||
v = opts(argv, name)
|
||||
return v[0] if v else default
|
||||
|
||||
|
||||
# ── INDEX.md:leo 打開就看得懂「我現在手上是哪一版」 ──────────────────────
|
||||
def write_index():
|
||||
rows = all_manifests()
|
||||
lines = ["# 出貨清單(哪一版由哪幾個 repo 的哪幾版組成)", "",
|
||||
"> 這份檔案由 `scripts/release-manifest` 自動重寫,**不要手改**"
|
||||
"(手改的那一份會安靜地騙人)。", "",
|
||||
"- 每一列 = 一次交貨。**最上面那一份就是現在手上的這一版。**"]
|
||||
if not rows:
|
||||
lines.append("\t- 目前還沒有任何凍結過的清單。")
|
||||
for i, m in enumerate(rows):
|
||||
head = "**%s**%s" % (m["name"], " ← 現在手上的這一版" if i == 0 else "")
|
||||
lines.append("\t- " + head)
|
||||
lines.append("\t\t- 凍結於 %s(UTC)" % m.get("frozen_at", "?"))
|
||||
if m.get("note"):
|
||||
lines.append("\t\t- 說明:%s" % m["note"])
|
||||
lines.append("\t\t- 由這些組成(沒有更動的 repo 不會出現在這裡)")
|
||||
for p in m.get("parts", []):
|
||||
ev = p.get("verified") or {}
|
||||
lines.append("\t\t\t- `%s` @ **%s** (凍結當下驗過:%s %s)"
|
||||
% (p["repo"], p["version"], ev.get("kind", "?"),
|
||||
ev.get("commit", "")))
|
||||
lines.append("\t\t- 要退回這一版:`scripts/release-manifest rollback %s`" % m["name"])
|
||||
lines.append("")
|
||||
lines.append("- 為什麼要有這份東西(`inkstone/ISEP#84`)")
|
||||
lines.append("\t- 退版只退了其中一個 repo,剩下的還停在新版"
|
||||
" ⇒ **變成一組從來沒測過的組合**。")
|
||||
lines.append("\t- 所以送測、放行、出貨、退版**全部以一份清單為單位**,"
|
||||
"不以單一 repo 為單位。")
|
||||
try:
|
||||
os.makedirs(DIR, exist_ok=True)
|
||||
with open(os.path.join(DIR, "INDEX.md"), "w") as f:
|
||||
f.write("\n".join(lines) + "\n")
|
||||
except Exception as e:
|
||||
die("🔴 寫不進 %s:%s" % (DIR, e))
|
||||
|
||||
|
||||
# ── freeze ───────────────────────────────────────────────────────────────
|
||||
def cmd_freeze(argv):
|
||||
if not argv:
|
||||
die("用法:release-manifest freeze <清單名> --part owner/repo@版本 [--part …] "
|
||||
"[--note 說明] [--dry-run]")
|
||||
name = argv[0]
|
||||
if not NAME_RE.match(name):
|
||||
die("🔴 清單名只准英數與 . _ -(例:R-2026.08.30),你給的是:%s" % name)
|
||||
raw = opts(argv[1:], "--part")
|
||||
if not raw:
|
||||
die("🚫 一份清單至少要有一格 --part owner/repo@版本號。\n"
|
||||
" (單一 repo 的交貨也要開清單——它只是退化成一格,規則不變。)")
|
||||
|
||||
if load(name) is not None:
|
||||
die("🚫 %s 已經凍結過了,不准再加東西。\n"
|
||||
" 【inkstone/ISEP#84】「清單一旦凍結就不再加東西,**新的需求進下一版**。」\n"
|
||||
" 要出新的組合 ⇒ 換一個清單名重新 freeze(舊的留著,退版時要用)。" % name)
|
||||
|
||||
seen, parts = set(), []
|
||||
for s in raw:
|
||||
owner, repo, ver = parse_part(s)
|
||||
full = "%s/%s" % (owner, repo)
|
||||
if full in seen:
|
||||
die("🔴 同一個 repo 在清單裡出現兩次:%s" % full)
|
||||
seen.add(full)
|
||||
ev = resolve(owner, repo, ver)
|
||||
if not ev:
|
||||
die("🚫 %s@%s **在 Gitea 上抓不到**——不給凍結。\n"
|
||||
" 【inkstone/ISEP#84 驗收 1】「清單上的版本號**真的存在**"
|
||||
"(不是寫上去而已,要抓得到那個 release)」。\n"
|
||||
" 先把那個 repo 的版本打出來(tag/release),再回來 freeze。"
|
||||
% (full, ver))
|
||||
parts.append({"repo": full, "version": ver, "verified": ev})
|
||||
|
||||
nxt = max([m.get("seq", 0) for m in all_manifests()] or [0]) + 1
|
||||
man = {"name": name, "seq": nxt,
|
||||
"frozen_at": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()),
|
||||
"note": opt(argv[1:], "--note", "") or "",
|
||||
"parts": parts}
|
||||
|
||||
if DRY:
|
||||
print("[dry-run] 會寫進 %s" % path_of(name))
|
||||
print(json.dumps(man, ensure_ascii=False, indent=2))
|
||||
print("[dry-run] 一個檔都沒有真的寫出去。")
|
||||
return
|
||||
os.makedirs(DIR, exist_ok=True)
|
||||
with open(path_of(name), "w") as f:
|
||||
json.dump(man, f, ensure_ascii=False, indent=2)
|
||||
write_index()
|
||||
print("✅ 清單 %s 已凍結(%d 個 repo,每一格都驗過真的抓得到)" % (name, len(parts)))
|
||||
for p in parts:
|
||||
print(" %-34s %s" % (p["repo"], p["version"]))
|
||||
print("\n📌 從現在起:送測/放行/出貨/退版都以 %s 為單位,不以單一 repo 為單位。" % name)
|
||||
print(" 人看的版本:%s" % os.path.join(DIR, "INDEX.md"))
|
||||
|
||||
|
||||
# ── verify / show / list / current / diff ────────────────────────────────
|
||||
def cmd_verify(argv):
|
||||
if not argv:
|
||||
die("用法:release-manifest verify <清單名>")
|
||||
man = load(argv[0]) or die("🔴 沒有這份清單:%s" % argv[0])
|
||||
bad = 0
|
||||
for p in man["parts"]:
|
||||
owner, repo = p["repo"].split("/", 1)
|
||||
ev = resolve(owner, repo, p["version"])
|
||||
print("%s %-34s %s" % ("✅" if ev else "❌", p["repo"], p["version"]))
|
||||
if not ev:
|
||||
bad += 1
|
||||
if bad:
|
||||
die("\n🔴 %d 格抓不到了——這份清單現在**退不回去**,"
|
||||
"要嘛版本被刪了,要嘛當初就沒真的存在。" % bad)
|
||||
print("\n✅ %s 全部 %d 格都還抓得到,可以拿它退版。" % (man["name"], len(man["parts"])))
|
||||
|
||||
|
||||
def cmd_show(argv):
|
||||
if not argv:
|
||||
die("用法:release-manifest show <清單名>")
|
||||
man = load(argv[0]) or die("🔴 沒有這份清單:%s" % argv[0])
|
||||
print(json.dumps(man, ensure_ascii=False, indent=2))
|
||||
|
||||
|
||||
def cmd_list(argv):
|
||||
rows = all_manifests()
|
||||
if not rows:
|
||||
print("(還沒有任何凍結過的清單。第一份用 release-manifest freeze 開。)")
|
||||
return
|
||||
for i, m in enumerate(rows):
|
||||
print("%s %-18s %s %d 個 repo:%s"
|
||||
% ("👉" if i == 0 else " ", m["name"], m.get("frozen_at", "?"),
|
||||
len(m.get("parts", [])),
|
||||
" + ".join("%s@%s" % (p["repo"].split("/")[-1], p["version"])
|
||||
for p in m.get("parts", []))))
|
||||
print("\n👉 = 現在手上的這一版。人看的版本:%s" % os.path.join(DIR, "INDEX.md"))
|
||||
|
||||
|
||||
def cmd_current(argv):
|
||||
rows = all_manifests()
|
||||
if not rows:
|
||||
die("🔴 一份清單都沒有——「我現在手上是哪一版」目前沒有人答得出來。", 1)
|
||||
m = rows[0]
|
||||
print("現在手上的這一版:%s(凍結於 %s)" % (m["name"], m.get("frozen_at", "?")))
|
||||
for p in m["parts"]:
|
||||
print(" %-34s %s" % (p["repo"], p["version"]))
|
||||
|
||||
|
||||
def cmd_diff(argv):
|
||||
if len(argv) < 2:
|
||||
die("用法:release-manifest diff <舊清單> <新清單>")
|
||||
a = load(argv[0]) or die("🔴 沒有這份清單:%s" % argv[0])
|
||||
b = load(argv[1]) or die("🔴 沒有這份清單:%s" % argv[1])
|
||||
va = {p["repo"]: p["version"] for p in a["parts"]}
|
||||
vb = {p["repo"]: p["version"] for p in b["parts"]}
|
||||
for repo in sorted(set(va) | set(vb)):
|
||||
x, y = va.get(repo), vb.get(repo)
|
||||
if x == y:
|
||||
print(" = %-34s %s" % (repo, x))
|
||||
elif x is None:
|
||||
print(" + %-34s %s(新進來的)" % (repo, y))
|
||||
elif y is None:
|
||||
print(" - %-34s %s(新清單裡沒有了)" % (repo, x))
|
||||
else:
|
||||
print(" ~ %-34s %s → %s" % (repo, x, y))
|
||||
|
||||
|
||||
# ── rollback:整份一起退,沒有「只退一個」這個選項 ────────────────────────
|
||||
def cmd_rollback(argv):
|
||||
if not argv:
|
||||
die("用法:release-manifest rollback <清單名> [--dry-run]")
|
||||
name = argv[0]
|
||||
man = load(name) or die("🔴 沒有這份清單:%s" % name)
|
||||
|
||||
only = opts(argv[1:], "--only")
|
||||
if only:
|
||||
die("🚫 **退版沒有「只退一個」這個選項。**(你指名了:%s)\n\n"
|
||||
" 【inkstone/ISEP#84】「要退版的時候,只退了其中一個 repo,\n"
|
||||
" 剩下的還停在新版 ⇒ **變成一組從來沒測過的組合**。」\n\n"
|
||||
" %s 這一版由 %d 個 repo 組成:\n%s\n"
|
||||
" ⇒ 拿掉 --only,整份一起退:release-manifest rollback %s\n"
|
||||
" ⇒ 真的只有一個 repo 要動 ⇒ 那就 freeze 一份**新的**清單,"
|
||||
"把不動的那幾格照抄過去。"
|
||||
% (", ".join(only), name, len(man["parts"]),
|
||||
"\n".join(" %s @ %s" % (p["repo"], p["version"])
|
||||
for p in man["parts"]), name))
|
||||
|
||||
cur = all_manifests()
|
||||
curv = {p["repo"]: p["version"] for p in cur[0]["parts"]} if cur else {}
|
||||
curname = cur[0]["name"] if cur else "(沒有)"
|
||||
|
||||
print("退版目標:%s(現在手上的是 %s)\n" % (name, curname))
|
||||
moves, stays = [], []
|
||||
for p in man["parts"]:
|
||||
(stays if curv.get(p["repo"]) == p["version"] else moves).append(p)
|
||||
|
||||
print("【要動的】")
|
||||
if not moves:
|
||||
print(" (沒有——現在手上的組合已經等於這份清單)")
|
||||
for p in moves:
|
||||
owner_repo = p["repo"]
|
||||
print(" %-34s %s → %s" % (owner_repo, curv.get(owner_repo, "?"), p["version"]))
|
||||
print(" git -C <%s 的工作目錄> fetch --tags && "
|
||||
"git -C <同上> checkout %s" % (owner_repo.split("/")[-1], p["version"]))
|
||||
if stays:
|
||||
print("\n【已經在目標版本、不必動】(列出來是為了讓你確認**沒有一格被漏掉**)")
|
||||
for p in stays:
|
||||
print(" %-34s %s" % (p["repo"], p["version"]))
|
||||
|
||||
print("\n🔴 這 %d 格是一組,要嘛全部到位,要嘛就不算退版完成。"
|
||||
% len(man["parts"]))
|
||||
print(" 退完跑一次複驗:release-manifest verify %s" % name)
|
||||
|
||||
|
||||
def main():
|
||||
global DRY
|
||||
argv = sys.argv[1:]
|
||||
if "--dry-run" in argv:
|
||||
DRY = True
|
||||
argv = [a for a in argv if a != "--dry-run"]
|
||||
if not argv:
|
||||
print(__doc__)
|
||||
return
|
||||
cmd, rest = argv[0], argv[1:]
|
||||
table = {"freeze": cmd_freeze, "verify": cmd_verify, "show": cmd_show,
|
||||
"list": cmd_list, "current": cmd_current, "diff": cmd_diff,
|
||||
"rollback": cmd_rollback}
|
||||
if cmd not in table:
|
||||
print(__doc__)
|
||||
die("🔴 沒有這個子指令:%s" % cmd)
|
||||
table[cmd](rest)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Executable
+155
@@ -0,0 +1,155 @@
|
||||
#!/usr/bin/env bash
|
||||
# scripts/milestone-account 的迴歸測試(inkstone/ISEP#85)
|
||||
#
|
||||
# 驗收 1:關掉一個 milestone → 三個數字要自己算出來,不用手填
|
||||
# 驗收 2:差超過 25% → 要逼我挑一個代號,挑不出來不准結案
|
||||
# 驗收 3:累積幾次之後 → 看得出哪一種原因最常發生
|
||||
# 驗收 4:拿已經逾期的 milestone 進去算 → 要算得出數字
|
||||
#
|
||||
# 🔴 全程離線(MILESTONE_ACCOUNT_FIXTURE =一份假的 Gitea 回應表),
|
||||
# 時鐘用 MILESTONE_ACCOUNT_NOW 定住,帳本寫在 mktemp 目錄。
|
||||
# **不打 Gitea、不關任何真的 milestone、不碰 repo 裡的 system-dev/estimates/。**
|
||||
set -u
|
||||
TOOL="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/milestone-account}"
|
||||
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
|
||||
PASS=0; FAIL=0; N=0
|
||||
NOW="2026-08-28T00:00:00Z"
|
||||
FX="$TMP/fx.json"
|
||||
|
||||
python3 - "$FX" <<'PY'
|
||||
import json, sys, urllib.parse
|
||||
api = {}
|
||||
|
||||
def iso(d, h=0):
|
||||
return "2026-08-%02dT%02d:00:00Z" % (d, h)
|
||||
|
||||
def issue(n, created, closed=None, assignee=True, labels=(), ms=None):
|
||||
return {"number": n, "created_at": created, "closed_at": closed,
|
||||
"updated_at": closed or created,
|
||||
"assignees": [{"login": "cc"}] if assignee else [],
|
||||
"labels": [{"name": l} for l in labels],
|
||||
"milestone": ({"id": ms} if ms else None)}
|
||||
|
||||
def comment(n, at):
|
||||
return {"issue_url": "https://x/api/v1/repos/o/r/issues/%d" % n, "created_at": at}
|
||||
|
||||
def repo(full, mid, title, created, due, closed, issues, comments, open_ms=True):
|
||||
o, r = full.split("/")
|
||||
ms = {"id": mid, "title": title, "created_at": created, "due_on": due,
|
||||
"closed_at": closed, "state": "open" if closed is None else "closed"}
|
||||
api["/repos/%s/%s/milestones/%d" % (o, r, mid)] = ms
|
||||
api["/repos/%s/%s/issues?state=all&type=issues&limit=50&page=1" % (o, r)] = issues
|
||||
api["/repos/%s/%s/issues/comments?limit=100&since=%s"
|
||||
% (o, r, urllib.parse.quote(created))] = comments
|
||||
api["/repos/%s/%s/milestones?state=open&limit=50" % (o, r)] = [ms] if open_ms else []
|
||||
|
||||
# ① A#12 磨洋工:08-02 收掉一張之後,時間軸整整空了 24 天
|
||||
repo("inkstone/A", 12, "sprint-磨洋工", iso(1), "2026-08-08T23:59:59Z", None,
|
||||
[issue(1, iso(1, 1), iso(2), ms=12), issue(2, iso(1, 2), ms=12),
|
||||
issue(3, iso(1, 3), ms=12), issue(9, iso(10), ms=None)],
|
||||
[comment(1, iso(26))])
|
||||
|
||||
# ② B#13 準時收掉:偏差只有 -6%,不必挑代號
|
||||
repo("inkstone/B", 13, "sprint-準時", iso(20), "2026-08-27T23:59:59Z",
|
||||
"2026-08-27T12:00:00Z",
|
||||
[issue(1, iso(20, 1), iso(25), ms=13), issue(2, iso(20, 2), iso(26), ms=13)],
|
||||
[comment(1, iso(22)), comment(2, iso(24))], open_ms=False)
|
||||
|
||||
# ③ C#14 過程沒異常、就是估錯:每兩天都有動作,其他六個訊號全不成立
|
||||
repo("inkstone/C", 14, "sprint-估錯", iso(1), "2026-08-10T23:59:59Z",
|
||||
"2026-08-25T00:00:00Z",
|
||||
[issue(1, iso(1, 1), iso(24), ms=14), issue(2, iso(1, 2), iso(23), ms=14)],
|
||||
[comment(1, iso(d)) for d in range(3, 25, 2)], open_ms=False)
|
||||
|
||||
# ④ D#15 範圍變大:開跑之後又補進來三張票
|
||||
repo("inkstone/D", 15, "sprint-範圍變大", iso(1), "2026-08-10T23:59:59Z",
|
||||
"2026-08-25T00:00:00Z",
|
||||
[issue(1, iso(1, 1), iso(24), ms=15), issue(2, iso(1, 2), iso(23), ms=15),
|
||||
issue(3, iso(15), ms=15), issue(4, iso(15, 1), ms=15),
|
||||
issue(5, iso(15, 2), ms=15)],
|
||||
[comment(1, iso(d)) for d in range(3, 25, 2)], open_ms=False)
|
||||
|
||||
api["/orgs/inkstone/repos?limit=100"] = [
|
||||
{"full_name": "inkstone/%s" % x} for x in "ABCD"]
|
||||
json.dump({"api": api}, open(sys.argv[1], "w"), ensure_ascii=False)
|
||||
PY
|
||||
|
||||
run() { MILESTONE_ACCOUNT_FIXTURE="$FX" MILESTONE_ACCOUNT_DIR="$TMP/led" \
|
||||
MILESTONE_ACCOUNT_NOW="$NOW" python3 "$TOOL" "$@" 2>&1; }
|
||||
|
||||
t() {
|
||||
want="$1"; desc="$2"; must="$3"; shift 4
|
||||
N=$((N+1)); out=$(run "$@"); 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,12p' | sed 's/^/ /'; FAIL=$((FAIL+1))
|
||||
fi
|
||||
}
|
||||
|
||||
echo "── 驗收 1:三個數字自己算出來 ─────────────────────────────"
|
||||
t 0 "① audit 印出「當初訂的期限」" "當初訂的期限" -- audit inkstone/A#12
|
||||
t 0 "② audit 印出「實際花掉的」" "實際花掉的" -- audit inkstone/A#12
|
||||
t 0 "③ 偏差算得出來(A#12 逾期 +238%)" "+238%" -- audit inkstone/A#12
|
||||
t 0 "④ 期限是 08-08、實際算到今天 08-28 ⇒ 27 天" "27.0天" -- audit inkstone/A#12
|
||||
|
||||
echo "── 驗收 2:差超過 25% 逼你挑代號 ──────────────────────────"
|
||||
t 2 "⑤ A#12 差 +237% 卻沒給 --reason ⇒ 不准結案" "挑不出代號不准結案" -- \
|
||||
close inkstone/A#12
|
||||
t 2 "⑥ 承上:訊息要直接列出撐得住的代號" "時間軸撐得住的代號:idle" -- close inkstone/A#12
|
||||
t 0 "⑦ B#13 只差 -6% ⇒ 不必挑代號,直接結得掉" "已記帳" -- close inkstone/B#13
|
||||
t 2 "⑧ 造一個不存在的代號 ⇒ 擋(封閉集合)" "不是那七個代號之一" -- \
|
||||
close inkstone/A#12 --reason 拖延症
|
||||
t 2 "⑨ 挑一個時間軸撐不住的代號 ⇒ 擋(不採信我自己說的)" "時間軸撐不住" -- \
|
||||
close inkstone/C#14 --reason idle
|
||||
t 0 "⑩ C#14 六個訊號都不成立 ⇒ 唯一合法的是 misestimate" "misestimate" -- \
|
||||
audit inkstone/C#14
|
||||
t 0 "⑪ 承上:--reason misestimate 收得掉" "原因=misestimate" -- \
|
||||
close inkstone/C#14 --reason misestimate
|
||||
t 0 "⑫ A#12 挑 idle(時間軸真的有 24 天空白)⇒ 收得掉" "原因=idle" -- \
|
||||
close inkstone/A#12 --reason idle
|
||||
t 0 "⑬ D#15 開跑後補三張票 ⇒ scope-creep 撐得住" "原因=scope-creep" -- \
|
||||
close inkstone/D#15 --reason scope-creep
|
||||
|
||||
echo "── 驗收 3:看得出哪一種原因最常發生 ───────────────────────"
|
||||
t 0 "⑭ report 數得出每個代號各幾次" "磨洋工" -- report
|
||||
t 0 "⑮ report 算得出累計結案幾個" "累計結案 4 個里程碑" -- report
|
||||
N=$((N+1))
|
||||
if grep -q "哪一種原因最常發生" "$TMP/led/REPORT.md" 2>/dev/null \
|
||||
&& grep -q "時間軸證據" "$TMP/led/REPORT.md"; then
|
||||
printf ' ✅ ⑯ REPORT.md 寫出來了,而且每一筆都帶時間軸證據\n'; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ ⑯ REPORT.md 內容不對\n'; FAIL=$((FAIL+1))
|
||||
fi
|
||||
N=$((N+1))
|
||||
if [ "$(wc -l < "$TMP/led/ledger.jsonl")" = "4" ]; then
|
||||
printf ' ✅ ⑰ 帳本剛好四筆(沒有被擋下的那幾次也記進去)\n'; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ ⑰ 帳本筆數不對:%s\n' "$(wc -l < "$TMP/led/ledger.jsonl" 2>/dev/null)"
|
||||
FAIL=$((FAIL+1))
|
||||
fi
|
||||
|
||||
echo "── 驗收 4:拿已經逾期的里程碑進去算 ───────────────────────"
|
||||
t 0 "⑱ list --overdue 撈得到逾期的那一個,而且帶數字" "inkstone/A#12" -- \
|
||||
list --org inkstone --overdue
|
||||
t 0 "⑲ 承上:逾期的要被標成「差超過 ±25%」那一類" "🔴" -- \
|
||||
list --org inkstone --overdue
|
||||
|
||||
echo "── 其他 ───────────────────────────────────────────────────"
|
||||
t 0 "⑳ codes 印得出七個代號,一個不多一個不少" "misestimate" -- codes
|
||||
N=$((N+1))
|
||||
if [ "$(run codes | grep -cE '^ [a-z-]+ ')" = "7" ]; then
|
||||
printf ' ✅ ㉑ 真的是七個(封閉集合)\n'; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ ㉑ 代號數量不是 7:%s\n' "$(run codes | grep -cE '^ [a-z-]+ ')"; FAIL=$((FAIL+1))
|
||||
fi
|
||||
t 0 "㉒ --dry-run 印出要打的那通 API 但不送出" "一筆都沒有真的寫出去" -- \
|
||||
close inkstone/A#12 --reason idle --dry-run
|
||||
t 2 "㉓ 里程碑編號寫錯 ⇒ 講清楚寫法" "寫法是 owner/repo#里程碑編號" -- audit ISEP-12
|
||||
|
||||
echo
|
||||
echo "通過 $PASS 條,失敗 $FAIL 條(共 $N 條)"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
Executable
+98
@@ -0,0 +1,98 @@
|
||||
#!/usr/bin/env bash
|
||||
# scripts/release-manifest 的迴歸測試(inkstone/ISEP#84)
|
||||
#
|
||||
# 兩個方向都要有證據:
|
||||
# A 群「該擋」——版本號在 Gitea 抓不到/清單已凍結還想加東西/退版只退一個
|
||||
# B 群「該過」——版本號真的存在就凍結得起來、退版吐出整份、diff 看得出差在哪
|
||||
# C 群「leo 打開看得懂」——INDEX.md 真的被重寫,而且第一份標著「現在手上的這一版」
|
||||
#
|
||||
# 🔴 全程離線(RELEASE_MANIFEST_FIXTURE),不打 Gitea、不建任何真的 release。
|
||||
# 清單寫在 mktemp 的目錄(RELEASE_MANIFEST_DIR),不碰 repo 裡的 releases/。
|
||||
set -u
|
||||
TOOL="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/release-manifest}"
|
||||
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
|
||||
PASS=0; FAIL=0; N=0
|
||||
|
||||
FX="$TMP/fx.json"
|
||||
cat > "$FX" <<'JSON'
|
||||
{"versions": {
|
||||
"inkstone/Arcrun@v1.4.52": {"kind":"release","url":"u1","commit":"aaaaaaaaaaaa"},
|
||||
"inkstone/Arcrun@v1.4.51": {"kind":"release","url":"u2","commit":"bbbbbbbbbbbb"},
|
||||
"inkstone/arcrun-collector@v0.18.36": {"kind":"tag","url":"u3","commit":"cccccccccccc"},
|
||||
"inkstone/arcrun-collector@v0.18.35": {"kind":"tag","url":"u4","commit":"dddddddddddd"}
|
||||
}}
|
||||
JSON
|
||||
|
||||
run() { RELEASE_MANIFEST_FIXTURE="$FX" RELEASE_MANIFEST_DIR="$TMP/rel" python3 "$TOOL" "$@" 2>&1; }
|
||||
|
||||
# t <期望 exit> <說明> <必須出現的字串(可空)> -- <參數…>
|
||||
t() {
|
||||
want="$1"; desc="$2"; must="$3"; shift 4
|
||||
N=$((N+1))
|
||||
out=$(run "$@"); 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,8p' | sed 's/^/ /'; FAIL=$((FAIL+1))
|
||||
fi
|
||||
}
|
||||
|
||||
echo "── B 群:該過 ──────────────────────────────────────────────"
|
||||
t 0 "① 兩個 repo 的版本都真的存在 ⇒ 凍結得起來" "已凍結(2 個 repo" -- \
|
||||
freeze R-2026.08.29 --part inkstone/Arcrun@v1.4.51 --part inkstone/arcrun-collector@v0.18.35
|
||||
t 0 "② 單一 repo 的交貨不必特例(清單退化成一格)" "已凍結(1 個 repo" -- \
|
||||
freeze R-single --part inkstone/Arcrun@v1.4.51
|
||||
t 0 "③ 再凍一份新的(這才是「新的需求進下一版」)" "已凍結(2 個 repo" -- \
|
||||
freeze R-2026.08.30 --part inkstone/Arcrun@v1.4.52 --part inkstone/arcrun-collector@v0.18.36
|
||||
t 0 "④ current 答得出「我現在手上是哪一版」" "R-2026.08.30" -- current
|
||||
t 0 "⑤ verify:每一格都還抓得到" "全部 2 格都還抓得到" -- verify R-2026.08.30
|
||||
t 0 "⑥ diff 看得出兩份差在哪一格" "v1.4.51 → v1.4.52" -- diff R-2026.08.29 R-2026.08.30
|
||||
t 0 "⑦ --dry-run 不寫檔" "一個檔都沒有真的寫出去" -- \
|
||||
freeze R-dryrun --part inkstone/Arcrun@v1.4.52 --dry-run
|
||||
t 2 "⑧ 承上:--dry-run 那份真的沒被寫出去" "沒有這份清單" -- show R-dryrun
|
||||
|
||||
echo "── A 群:該擋 ──────────────────────────────────────────────"
|
||||
t 2 "⑨ 版本號在 Gitea 抓不到 ⇒ 不給凍結(驗收 1)" "在 Gitea 上抓不到" -- \
|
||||
freeze R-bad --part inkstone/Arcrun@v9.9.9
|
||||
t 2 "⑩ 承上:整份都不寫(不會留下半份清單)" "沒有這份清單" -- show R-bad
|
||||
t 2 "⑪ 一格都不給 ⇒ 擋" "至少要有一格" -- freeze R-empty
|
||||
t 2 "⑫ 同名清單已凍結 ⇒ 不准再加東西" "新的需求進下一版" -- \
|
||||
freeze R-2026.08.30 --part inkstone/Arcrun@v1.4.51
|
||||
t 2 "⑬ 同一個 repo 出現兩次 ⇒ 擋" "出現兩次" -- \
|
||||
freeze R-dup --part inkstone/Arcrun@v1.4.51 --part inkstone/Arcrun@v1.4.52
|
||||
t 2 "⑭ 清單名亂寫 ⇒ 擋" "清單名只准" -- freeze "R 2026/08" --part inkstone/Arcrun@v1.4.51
|
||||
t 2 "⑮ part 寫法不對 ⇒ 擋" "寫法是 owner/repo@版本號" -- \
|
||||
freeze R-x --part Arcrun-v1.4.52
|
||||
|
||||
echo "── 驗收 2/3:退版 ─────────────────────────────────────────"
|
||||
t 0 "⑯ 退版吐出整份清單的每一格(驗收 2)" "這 2 格是一組" -- rollback R-2026.08.29
|
||||
t 0 "⑰ 承上:兩個 repo 都被列進「要動的」" "arcrun-collector" -- rollback R-2026.08.29
|
||||
t 2 "⑱ 試著只退其中一個 ⇒ 被擋下來(驗收 3)" "沒有「只退一個」這個選項" -- \
|
||||
rollback R-2026.08.29 --only inkstone/Arcrun
|
||||
t 0 "⑲ 已經在目標版本的那幾格也要列出來(沒有一格被漏掉)" "不必動" -- \
|
||||
rollback R-2026.08.30
|
||||
|
||||
echo "── 驗收 4:leo 打開那份清單看得懂 ──────────────────────────"
|
||||
N=$((N+1))
|
||||
IDX="$TMP/rel/INDEX.md"
|
||||
if [ -f "$IDX" ] && grep -q "現在手上的這一版" "$IDX" \
|
||||
&& grep -q "R-2026.08.30" "$IDX" && grep -q "從來沒測過的組合" "$IDX"; then
|
||||
printf ' ✅ ⑳ INDEX.md 被重寫,標出「現在手上的這一版」與為什麼要有它\n'; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ ⑳ INDEX.md 內容不對\n'; sed -n '1,20p' "$IDX" 2>/dev/null | sed 's/^/ /'
|
||||
FAIL=$((FAIL+1))
|
||||
fi
|
||||
N=$((N+1))
|
||||
if head -20 "$IDX" 2>/dev/null | grep -A2 "R-2026.08.30" | grep -q "現在手上的這一版"; then
|
||||
printf ' ✅ ㉑ 最新那一份(不是最舊那份)才被標成「現在手上的」\n'; PASS=$((PASS+1))
|
||||
else
|
||||
printf ' ❌ ㉑ 標錯了哪一份是現在手上的\n'; FAIL=$((FAIL+1))
|
||||
fi
|
||||
|
||||
echo
|
||||
echo "通過 $PASS 條,失敗 $FAIL 條(共 $N 條)"
|
||||
[ "$FAIL" -eq 0 ]
|
||||
Reference in New Issue
Block a user