Compare commits
2 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 602500a4c7 | |||
| ac2f89c610 |
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "isep",
|
||||
"description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源:54 支機械閘(69 條註冊,白話盤點見 docs/hooks-inventory.md)、7 支 slash command、2 支 skill、39 支腳本,外加治理規範與標籤真相源。本機與雲端裝同一份,沒有子集。",
|
||||
"description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源:54 支機械閘(71 條註冊,白話盤點見 docs/hooks-inventory.md)、7 支 slash command、2 支 skill、36 支腳本,外加治理規範與標籤真相源。本機與雲端裝同一份,沒有子集。",
|
||||
"version": "0.11.0",
|
||||
"keywords": [
|
||||
"inkstone",
|
||||
|
||||
@@ -23,7 +23,7 @@
|
||||
|
||||
| | 數量 | 是什麼 |
|
||||
|---|---|---|
|
||||
| `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`) |
|
||||
| `hooks/` | 48 支 + `hooks.json` | 全部機械閘(PreToolUse/Stop/SubagentStop/SessionStart/PostToolUse 共 59 條註冊;`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` … |
|
||||
|
||||
+43
-65
@@ -154,6 +154,49 @@ bash hooks/tests/countdown-guard.test.sh
|
||||
(subagent 的回覆不是給 leo 看的),所以在一條 subagent 裡跑,B 群會**全綠而且是假綠**。
|
||||
測試檔自己會把它清掉——2026-08-28 第一次跑就撞到這個,才補上去的。
|
||||
|
||||
### A16 — 現在的主線是哪一個:24 條
|
||||
```
|
||||
bash hooks/tests/mainline-focus-guard.test.sh
|
||||
```
|
||||
**該看到**:`通過 24 條,失敗 0 條`。**全程離線**:狀態走 `ISEP_COUNTDOWN_STATE_DIR`、
|
||||
時鐘走 `ISEP_COUNTDOWN_NOW`、「那張票掛在哪」走 `ISEP_MAINLINE_FIXTURE`,
|
||||
並把 `TICKET_HOST` 指到一個連不上的位址——**任何一條真的走到網路,會在那裡當場失敗,
|
||||
不會靜靜地變成假綠**。
|
||||
|
||||
**它在守什麼**(`inkstone/ISEP#82`,leo 2026-08-27):
|
||||
「**14 個里程碑同時亮著卻不知道該看哪個**」。當天實查 14 個 open milestone,
|
||||
其中「Mira 現代化」這個名字同時活在 5 個 repo,5 個已經逾期
|
||||
⇒ SOP 說的「只做**該** milestone 的事」**沒有指涉對象,等於不存在**。
|
||||
|
||||
**判準**:問「現在的主線是哪一個」,`scripts/mainline` 回一個答案,而且只有一個。
|
||||
|
||||
**失敗**:
|
||||
- A 群任一條紅 ⇒ 答案不唯一,或標了新的舊的還在——那就回到 14 個一起亮的狀態
|
||||
- ⑧ 紅 ⇒ **目標宣告沒有自己出現**(票上驗收第 2 條),leo 又要自己去翻
|
||||
- ⑨ 紅 ⇒ 主線的名字沒掛在被查核的 ⏱ 那一行上 ⇒ 它到不了 leo 眼前
|
||||
(本票刻意不另立第二道會擋人的閘,就是靠這一格成立)
|
||||
- ⑩ 紅 ⇒ 用「期限最近的那個」蓋過了被指定的主線。**猜的不准蓋過指定的**
|
||||
- ⑬⑭ 紅 ⇒ 派了不在主線上的票沒被問一次,或問了卻沒給補收/跳線兩條路
|
||||
- ⑯ 紅 ⇒ **鬼打牆**:同一張票被擋第二次。至多擋一次是硬要求
|
||||
- **⑲–㉔(不該擋)任一條紅 ⇒ 誤攔,這比漏擋嚴重**。特別是 ⑲(沒有主線就一律放行,
|
||||
票上驗收第 4 條)與 ㉒(問不到那張票掛在哪 ⇒ 放行)——
|
||||
**「讀不到」不等於「不屬於」,把這兩件事講成同一句是最貴的錯**
|
||||
|
||||
📌 這一條線的另一半是**指令**,不是閘:`scripts/mainline`(`show`/`list`/`set`/
|
||||
`clear`/`refresh`/`adopt`/`has`)。要打網路的那幾個(list/set/adopt)不在測試裡跑,
|
||||
因為它們**只有真的 Gitea 才驗得了**——驗法見 A17。
|
||||
|
||||
### A17 — 主線那支指令真的問得到 Gitea(要網路)
|
||||
```
|
||||
python3 scripts/mainline list
|
||||
```
|
||||
**該看到**:一份 open milestone 清單,**跨多個 repo**(`ISEP` / `Arcrun` / `arcrun-rag` / `mira`…),
|
||||
每一行左邊是可以直接貼給 `set` 的 `owner/repo#<milestone id>`。
|
||||
**失敗**:
|
||||
- `一個 open milestone 都沒讀到` ⇒ 這台機器拿不到 Gitea。**那是讀不到,不是沒有**
|
||||
——不要因此標一個猜的主線
|
||||
- 只有單一 repo ⇒ 沒有跨 repo,等於沒看到全局
|
||||
|
||||
### A15 — 發通知不等於部署:37 條
|
||||
```
|
||||
bash hooks/tests/prod-write-guard.test.sh hooks/prod-write-guard.sh
|
||||
@@ -165,68 +208,6 @@ 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 標籤 模組化
|
||||
@@ -424,9 +405,6 @@ B2(信標那行)/B3(setup 輸出)/B4(閘的訊息)三個畫面
|
||||
| **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
-14
@@ -7,7 +7,7 @@
|
||||
|
||||
## 一句話結論
|
||||
|
||||
`hooks/` 底下有 **54 個 `.sh` 檔**,`hooks.json` 實際掛上 **69 條註冊**(同一支閘常被多種情境同時掛上);
|
||||
`hooks/` 底下有 **54 個 `.sh` 檔**,`hooks.json` 實際掛上 **71 條註冊**(同一支閘常被多種情境同時掛上);
|
||||
其中 **3 支檔案存在但沒被掛上**(2 支是待人填的空範本、1 支是刻意留著沒開的止血帶,見下面「未生效」表)。
|
||||
下面按「你會在什麼時候撞到它」分組,一支一行。
|
||||
|
||||
@@ -33,6 +33,13 @@
|
||||
> **兩個事件是同一件事的兩半**:只注入 = 又一個會被忽略的提醒;只查核 = 罰它做一件拿不到資料的事。
|
||||
> 這兩個數字是併之前當場數出來的,不是從上一版加減推出來的。
|
||||
|
||||
> 📌 **`inkstone/ISEP#82`(2026-08-28)+1 支、+3 條**:`mainline-focus-guard.sh`
|
||||
> 同時掛在 `Agent` 與 `Task`(派工的兩個入口都要守,只守一個等於沒守),
|
||||
> 加上 SessionStart 多掛一條 `scripts/mainline refresh`(更新主線的進度/期限,不是閘)。
|
||||
> **53→54 支、68→71 條,兩個數字是加完之後當場數出來的**(指令見本頁最後一段)。
|
||||
> ⚠️ 同時修掉一行重複:上一版「一句話結論」那一句被貼了兩遍
|
||||
> (53/68 那組數字本身是對的,只是印了兩次)。
|
||||
|
||||
> 🔴 **`0.6.1`(2026-08-27)補回表格漏掉的兩列**:`isep-presence-beacon.sh`(E 組)、
|
||||
> `milestone-due-guard.sh`(A 組)。**標頭寫 48 支的同時,下面的表格只列得出 46 支**
|
||||
> ——數字是對的,人話少了兩行。發現的方法與防它再犯的指令,見下面「落差偵測」第二組 `comm`。
|
||||
@@ -45,15 +52,6 @@
|
||||
> 順手改掉一個過期的數字:描述欄長期寫「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**。
|
||||
|
||||
---
|
||||
|
||||
## 怎麼讀這張表
|
||||
@@ -82,7 +80,6 @@
|
||||
| `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 用知識庫的**搜尋**找到一筆東西,然後把那筆東西的原始編號直接貼進票裡或派工單裡,當成「某個功能壞了」的證據——而它從沒用正規的檢索路徑去查過那筆——擋一次。你關心的是:不會再有人拿錯的方法量出一個錯的結論,然後退回一張其實已經做完的票。 | 🛑 擋(同一輪只擋一次) |
|
||||
@@ -118,6 +115,7 @@
|
||||
| `micromanage-guard.sh` | 派工單寫得太細(指名檔案函式、編號步驟、要求每做一項回報一次…)就擋下——subagent 該被當成有能力的同事,不是照抄劇本的工具。 | 🛑 擋 |
|
||||
| `irreversible-dispatch-guard.sh` | 派工單裡出現「刪分支」「drop table」「rm -rf」這類不可逆動作,卻沒寫「先停下來等回覆才執行」就擋下。 | 🛑 擋 |
|
||||
| `no-ticket-no-dispatch.sh` | 派工單裡沒有寫工單號(`【工單】owner/repo#N`),或那張票已經關閉/根本不存在,就擋下——沒有票號的工作沒有人追得到進度。 | 🛑 擋 |
|
||||
| `mainline-focus-guard.sh` | 派出去的票**不在「現在的主線」上**,就擋一次,並問你是「補收」(它本來就該掛在主線上)還是「跳線」(真的插件事)。背景:2026-08-27 實查有 **14 個 milestone 同時開著**,其中「Mira 現代化」同名活在 5 個 repo ⇒ SOP 說的「只做該 milestone 的事」在現場**沒有指涉對象**,等於不存在。現在主線是一個查得到的事實(`scripts/mainline`,答案唯一),這支就是那個事實的用處。🔴 **沒有標主線 ⇒ 一律放行**;多張票只要有一張在主線上就放行;查不到那張票掛在哪也放行(**讀不到 ≠ 不屬於**);**同一張票只擋一次**,重送就過。跳線會留一筆紀錄——不留痕的話,跳線與專注在機器上長得一模一樣。 | 🛑 擋(同一張票至多一次) |
|
||||
| `dispatch-format-guard.sh` | **派工單 = 票號,就這樣。** 票號以外還寫了別的東西(背景、驗收條件、紅線、交件方式、「這個 session 才知道的事」)就擋下,並告訴你那些內容該搬去哪:每次都一樣的 → 共通規定;這次才知道的 → **寫進那張票**。反過來,合規的派工它會**自動把共通規定注入**給收工方(交件方式、不准 push main、org 是 `inkstone`…),所以你不寫也不會漏。判準是「這一行是不是【工單】欄位」——**在不在**,不是寫了什麼,所以講得再謹慎也不會被多罰。純禮貌收尾(「謝謝」)不算違規;`(→ comment M)` 不論全形或半形括號都認得(ISEP#65 修過一次:CLAUDE.md 自己規定的合格寫法曾經被這支閘自己擋下)。 | 🛑 擋(+注入) |
|
||||
|
||||
## D2. AI 想開口問你問題的當下(PreToolUse / AskUserQuestion)
|
||||
@@ -138,6 +136,7 @@
|
||||
|---|---|---|
|
||||
| `isep-presence-beacon.sh` | 對話一開始印一行 `🟢 ISEP vX.Y.Z 已載入(N 支閘|來源:…)`。**這行不是裝飾,是唯一能證明「這個 session 真的有閘」的東西**——它自己就住在 plugin 裡,看得到它就表示 plugin 載入了;某個 session 從頭到尾沒有這行,那個 session 是零閘狀態,先修 plugin 再做事。同一台機器可能同時有兩份 ISEP(marketplace 裝的、repo 裡 vendor 的),所以那行會講出這次是哪一份在說話。 | 📝 記錄(context 注入) |
|
||||
| `session-start-recall.sh` | 對話一開始就自動把「全局現況」(Gitea 各 repo 的票、KBDB 的藏書地圖)推到 AI 眼前,不必等它自己想到要查。 | 📝 記錄(context 注入) |
|
||||
| `scripts/mainline refresh` | (不是閘,是腳本)對話一開始把**現在的主線**那條 milestone 的進度與期限更新一次,好讓每回合眼前那一行講的是今天的數字。拿不到 Gitea 就原封不動——**寧可資料舊,不要把主線弄丟**。跑一次就結束,不輪詢。 | 📝 記錄 |
|
||||
| `skill-deploy-drift-guard.sh` | 如果「全機真正在用的 skill」跟「repo 裡版控的正本」內容對不上,就在開場講出來——避免用著一份沒人知道已經跟正本分家的舊拷貝。 | 📝 記錄 |
|
||||
|
||||
## F. AI 想結束這一輪、要收工的時候(Stop)
|
||||
@@ -149,7 +148,7 @@
|
||||
| `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、純工具回合、已經提醒過一次的,全部放行。 | 🛑 擋(至多攔一次) |
|
||||
| `countdown-guard.sh` | **每一則回覆都自己說出「這件事已經花了多久/距今天收工線還剩多久」**,而且不必有人記得。一支閘掛兩個事件:你送出訊息時它先把算好的那一行放到 AI 眼前(`UserPromptSubmit`),AI 想收工時它再看這一回合的回覆裡到底有沒有那一行,沒有就擋一次要它補(`Stop`)。**只做前半 = 又一個會被忽略的提醒**,所以兩半綁在一起。已過時間從**這段對話的第一則訊息**算起(=一個 release 的起點);收工線是台北 16:00,過線後四小時內顯示「已超過」,不會把超時悄悄換算掉。子 session、純工具回合、已經提醒過一次的,全部放行。**同一個注入點還帶第二行 `🎯 現在的主線是哪一個`**(`inkstone/ISEP#82`)——那一行沒有另外立閘,因為主線的名字本來就掛在被查核的 ⏱ 那一行上。 | 🛑 擋(至多攔一次) |
|
||||
| `browser-verify-guard.sh` | 這一輪 AI 宣稱「前端驗過了」,卻沒有真的用瀏覽器工具載入過,就擋下——`curl` 抓到 HTML 不算驗過。 | 🛑 擋 |
|
||||
| `self-drive-police.sh` | AI 想停下來問你「早就決定過的事」(用固定句型判斷,例如「要不要 X」「下一步做什麼」「這交給你」)就擋下,反問它查過 wiki/查過派工表了沒。 | 🛑 擋 |
|
||||
| `self-drive-judge.sh` | 跟上面同一件事,但改用小模型(haiku)判斷「換句話說」的請示句——防止 AI 只是把「要不要」改寫成「不確定是否符合期待」就閃過上一支閘。 | 🛑 擋 |
|
||||
@@ -210,11 +209,18 @@ pre-write-guard.sh
|
||||
pre-write-guard.template.sh
|
||||
shadow-table-guard.sh
|
||||
|
||||
# hooks.json 註冊了、但檔案不存在 → 空(目前沒有這種「指向空氣」的閘)
|
||||
# hooks.json 註冊了、但檔案不存在 → 應該是空的
|
||||
$ comm -13 /tmp/fs_hooks.txt /tmp/registered_hooks.txt
|
||||
(無輸出)
|
||||
countdown-milestone-refresh.sh ← 假警報:它在 scripts/ 不在 hooks/
|
||||
```
|
||||
|
||||
🔴 **上面那一筆是假警報,不是「指向空氣」的閘**:`inkstone/ISEP#63` 之後,
|
||||
SessionStart 上掛的東西不全是 `hooks/*.sh`——`scripts/countdown-milestone-refresh.sh`
|
||||
是腳本不是閘。這組指令只比檔名、不看目錄,所以它會出現在這裡。
|
||||
(`inkstone/ISEP#82` 又多掛一條 `scripts/mainline refresh`,那一條沒有 `.sh`
|
||||
副檔名,所以不會落進這個名單。)**照著跑會看到它,這裡先講清楚,
|
||||
免得下一個人以為是自己弄壞的。**
|
||||
|
||||
🔴 **上面那兩行驗不出「表格漏列」**——它們比的是 `hooks.json`,不是這張表。
|
||||
「有閘、但這頁沒有它那一行人話」要另外一組指令才看得見,就是下面這組
|
||||
(2026-08-27 就是靠它抓到本頁漏了 `isep-presence-beacon.sh`/`milestone-due-guard.sh` 兩列):
|
||||
|
||||
@@ -16,6 +16,16 @@
|
||||
# ① UserPromptSubmit ── 注入:把算好的那一行送到眼前(模型不必自己算、也算不準)
|
||||
# ② Stop ── 查核:這一回合的回覆裡到底有沒有那一行;沒有就擋一次
|
||||
#
|
||||
# ── 注入點的第二行:🎯 現在的主線是哪一個(inkstone/ISEP#82)────────────
|
||||
# 同一個注入點,兩行,來源不同:⏱ 算時間,🎯 讀 `hooks/lib/mainline.py` 裡被標定的主線。
|
||||
# 🔴 **Stop 那一半只查 ⏱,沒有跟著擴大成兩個標記**,兩個理由:
|
||||
# ① ⏱ 那一行本身**已經帶著主線的名字**(`countdown.py` 的第三段),
|
||||
# 所以主線是跟著一道**已經驗過的閘**到 leo 眼前的,不是靠新增一道會擋人的閘。
|
||||
# ② 一個回合最多該被擋一次。多要求一個標記 = 多一種被擋的方式,
|
||||
# 而本 repo 心法第 2 條寫死了:永遠在響的警報等於訓練人忽略警報。
|
||||
# 主線這條線真正會擋人的地方在派工那一端(`hooks/mainline-focus-guard.sh`),
|
||||
# 那裡擋的是「派了一張不在主線上的票」——**一個動作**,不是一段文字。
|
||||
#
|
||||
# 只有 ① = 又一個會被忽略的提醒(本 repo 心法第 2 條明令不要做這種東西)。
|
||||
# 只有 ② = 罰它做一件它拿不到資料的事。兩段合起來才是一條走得通的路。
|
||||
#
|
||||
@@ -64,12 +74,27 @@ try:
|
||||
except Exception:
|
||||
raise SystemExit(0) # 算不出來就不出聲,不要讓它變成噪音
|
||||
|
||||
# 第二行:現在的主線是哪一個(inkstone/ISEP#82)。
|
||||
# 同一個注入點的兩行,來源不同:⏱ 算時間,🎯 讀被標定的主線。
|
||||
# 算不出來也一定回一句話(「現在沒有主線」),所以這裡不需要 fallback;
|
||||
# 真的整支壞掉(import 失敗)才留白——一行注入不該讓整個 session 停下來。
|
||||
try:
|
||||
ml = cd._mainline().line()
|
||||
except Exception:
|
||||
ml = ""
|
||||
|
||||
ctx = (
|
||||
stamp + "\n\n"
|
||||
"🔴 這一行是 ISEP 的倒數(inkstone/ISEP#63)。**把它原樣放在你這則回覆的最前面**,"
|
||||
stamp + "\n"
|
||||
+ (ml + "\n" if ml else "")
|
||||
+ "\n"
|
||||
"🔴 第一行是 ISEP 的倒數(inkstone/ISEP#63)。**把它原樣放在你這則回覆的最前面**,"
|
||||
"數字不要自己重算、也不要改寫措辭——它是機器算的,你算的會漂。\n"
|
||||
"leo 整天上課、一天只看兩眼:沒有這行,他就不知道『這件事還來得及嗎』。\n"
|
||||
"收工前這一回合若沒有戴上它,Stop 那一半會擋一次要你補。"
|
||||
"收工前這一回合若沒有戴上它,Stop 那一半會擋一次要你補。\n\n"
|
||||
"🎯 第二行是**現在的主線**(inkstone/ISEP#82)——leo:「14 個里程碑同時亮著"
|
||||
"卻不知道該看哪個」。它是你這回合的判準:**手上這件事在不在那條線上**。\n"
|
||||
"不在,就當場說清楚是『補收』(它本來就該在主線上)還是『跳線』(真的插件事),"
|
||||
"不要默默做完。主線的名字已經在第一行的倒數裡,戴上倒數=主線也一起到了 leo 眼前。"
|
||||
)
|
||||
print(json.dumps({
|
||||
"hookSpecificOutput": {
|
||||
|
||||
+12
-4
@@ -49,10 +49,6 @@
|
||||
"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"
|
||||
@@ -153,6 +149,10 @@
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/dispatch-format-guard.sh"
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/mainline-focus-guard.sh"
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/search-is-not-proof-guard.sh"
|
||||
@@ -196,6 +196,10 @@
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/dispatch-format-guard.sh"
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/mainline-focus-guard.sh"
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/search-is-not-proof-guard.sh"
|
||||
@@ -231,6 +235,10 @@
|
||||
{
|
||||
"type": "command",
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/scripts/countdown-milestone-refresh.sh"
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/mainline refresh"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
+46
-6
@@ -27,6 +27,13 @@ leo 2026-08-28 07:40:「今天我整天上課……**下午四點左右**希
|
||||
從快取檔讀,**這支從不打網路**:UserPromptSubmit 走在每一則訊息的關鍵路徑上,
|
||||
在那裡打網路 = 每一句話都先等一次 HTTP。快取由 SessionStart 那支負責更新
|
||||
(`scripts/countdown-milestone-refresh.sh`),拿不到就整段不顯示,不編數字。
|
||||
|
||||
🔴 **來源有兩個,優先序寫死(inkstone/ISEP#82)**:
|
||||
① **被標定的主線**(`hooks/lib/mainline.py`,`scripts/mainline set` 寫的)—— 優先
|
||||
② 期限最近的那一個(`milestone-due` 快取,`countdown-milestone-refresh.sh` 寫的)
|
||||
② 是**猜**出來的(「最近到期的大概就是在做的那個」),而 ISEP#82 的整件事就是
|
||||
「那個 active milestone」在 14 個裡沒有指涉對象。⇒ 一旦有人真的標了主線,
|
||||
就不准再用猜的那個蓋過它。兩個都沒有 ⇒ 整段不顯示。
|
||||
"""
|
||||
import json
|
||||
import os
|
||||
@@ -137,10 +144,40 @@ def deadline(now: datetime) -> datetime:
|
||||
return d
|
||||
|
||||
|
||||
def milestone() -> "tuple[str, datetime] | None":
|
||||
"""主線 milestone 的期限。快取檔一行:`YYYY-MM-DD|<名稱>`。沒有就沒有。"""
|
||||
def _mainline():
|
||||
"""借 `hooks/lib/mainline.py` 讀「被標定的主線」。拿不到就當沒有(fail-open)。
|
||||
|
||||
刻意用檔案路徑載入而不是 `import mainline`:本檔自己也是被
|
||||
`spec_from_file_location` 載進去的,`sys.path` 裡沒有 `hooks/lib`。
|
||||
"""
|
||||
try:
|
||||
import importlib.util
|
||||
p = os.path.join(os.path.dirname(os.path.abspath(__file__)), "mainline.py")
|
||||
spec = importlib.util.spec_from_file_location("isep_mainline", p)
|
||||
mod = importlib.util.module_from_spec(spec)
|
||||
spec.loader.exec_module(mod)
|
||||
return mod
|
||||
except Exception:
|
||||
return None
|
||||
|
||||
|
||||
def milestone() -> "tuple[str, datetime | None] | None":
|
||||
"""主線 milestone 的期限。優先讀被標定的主線,其次讀「期限最近」的快取。
|
||||
|
||||
快取檔一行:`YYYY-MM-DD|<名稱>`。兩個都沒有就沒有(回 None,整段不顯示)。
|
||||
期限可能是 None(被標定的主線沒設期限)——那時只說名字,不編一個日期。
|
||||
"""
|
||||
raw = os.environ.get("ISEP_MILESTONE_DUE", "").strip()
|
||||
name = os.environ.get("ISEP_MILESTONE_NAME", "").strip()
|
||||
if not raw:
|
||||
mod = _mainline()
|
||||
if mod is not None:
|
||||
try:
|
||||
seg = mod.countdown_segment()
|
||||
except Exception:
|
||||
seg = None
|
||||
if seg:
|
||||
return seg
|
||||
if not raw:
|
||||
p = os.path.join(state_dir(), "milestone-due")
|
||||
try:
|
||||
@@ -184,11 +221,14 @@ def line(session_id: str, transcript_path: str) -> str:
|
||||
ms = milestone()
|
||||
if ms:
|
||||
name, due = ms
|
||||
gap = due - now
|
||||
if gap.total_seconds() >= 0:
|
||||
parts.append("主線 %s 剩 %s" % (name, human(gap)))
|
||||
if due is None:
|
||||
parts.append("主線 %s(沒設期限)" % name)
|
||||
else:
|
||||
parts.append("🔴 主線 %s 已逾期 %s" % (name, human(gap)))
|
||||
gap = due - now
|
||||
if gap.total_seconds() >= 0:
|
||||
parts.append("主線 %s 剩 %s" % (name, human(gap)))
|
||||
else:
|
||||
parts.append("🔴 主線 %s 已逾期 %s" % (name, human(gap)))
|
||||
|
||||
return "|".join(parts)
|
||||
|
||||
|
||||
@@ -0,0 +1,248 @@
|
||||
#!/usr/bin/env python3
|
||||
"""hooks/lib/mainline.py —— 「現在的主線是哪一個」這件事的**唯一存放處**。
|
||||
|
||||
這是 helper,不是閘(inkstone/ISEP#40 S7:`lib/` 底下的東西不算一支手寫的閘)。
|
||||
三個呼叫者共用它,所以「主線是誰」的答案只有一份:
|
||||
· `scripts/mainline` —— 人問「現在的主線是哪一個」
|
||||
· `hooks/lib/countdown.py` —— 每一則回覆眼前那一行的第二段
|
||||
· `hooks/mainline-focus-guard.sh` —— 派了一張不屬於主線的票就攔一次
|
||||
|
||||
── 為什麼要有這個檔(inkstone/ISEP#82)──────────────────────────────
|
||||
2026-08-27 實查:`GET /repos/inkstone/*/milestones?state=open` 回 **14 個**,
|
||||
其中「Mira 現代化」這個名字同時活在 5 個 repo,還有 5 個已經逾期。
|
||||
SOP 說「有 active milestone 時只做該 milestone 的事」——但**「那個」在現場沒有指涉對象**。
|
||||
|
||||
leo 的原話是「**14 個里程碑同時亮著卻不知道該看哪個**」。
|
||||
⇒ 要解的不是「milestone 太多」(跨 repo 同名是既有做法,v0.6.0 §4/SOP S7-4),
|
||||
要解的是「**這一刻我在做哪一條**」沒有答案。
|
||||
|
||||
⇒ 所以這個檔的形狀就是答案的形狀:**一個檔,放得下一條**。
|
||||
沒有清單、沒有優先序、沒有「前三名」——被覆蓋掉的那條就不再是主線。
|
||||
問「現在的主線是哪一個」永遠只會拿到 0 或 1 個答案,不會拿到 14 個。
|
||||
|
||||
── 主線是一個「名字」,錨在一個具體的 milestone 上 ──────────────────
|
||||
Gitea 的 milestone 不能跨 repo,而同一條線常常同時開在 5 個 repo(票上實查)。
|
||||
所以:
|
||||
· **錨**(anchor)= `owner/repo#<milestone id>`:期限、進度、目標宣告都讀它
|
||||
· **成員判定**= 票所屬 milestone 的**標題**與主線標題相同(不分 repo)
|
||||
⇒ 「同名跨 repo」照舊能用,而「現在在做哪一條」仍然只有一個答案。
|
||||
|
||||
── 這支從不打網路 ────────────────────────────────────────────────
|
||||
它被 `UserPromptSubmit` 用(每一則訊息的關鍵路徑)。在那裡打 HTTP = 每講一句話
|
||||
都先等一次網路。網路那一半全部在 `scripts/mainline`(set/refresh/adopt),
|
||||
本支只讀寫 state 檔。讀不到 ⇒ 回「沒有主線」,**不編一條出來**。
|
||||
"""
|
||||
import json
|
||||
import os
|
||||
from datetime import datetime, timedelta, timezone
|
||||
|
||||
TAIPEI = timezone(timedelta(hours=8))
|
||||
MARKER = "🎯"
|
||||
STATE_NAME = "mainline.json"
|
||||
JUMP_LOG = "mainline-jumps.jsonl"
|
||||
|
||||
|
||||
def state_dir() -> str:
|
||||
"""與倒數共用同一個狀態目錄——兩行字是同一個注入點的兩半,狀態不該分家。"""
|
||||
d = os.environ.get("ISEP_COUNTDOWN_STATE_DIR", "").strip()
|
||||
if not d:
|
||||
d = os.path.join(os.path.expanduser("~"), ".claude", "isep-countdown")
|
||||
try:
|
||||
os.makedirs(d, exist_ok=True)
|
||||
except Exception:
|
||||
pass
|
||||
return d
|
||||
|
||||
|
||||
def path() -> str:
|
||||
return os.path.join(state_dir(), STATE_NAME)
|
||||
|
||||
|
||||
def load():
|
||||
"""讀主線。沒有/壞掉 ⇒ None(=現在沒有主線),**不是例外**。
|
||||
|
||||
「沒有主線」是一個正常狀態,不是故障:ISEP#82 驗收第 4 條寫死了
|
||||
「沒有任何主線時不能整組壞掉」。所以這支從不 raise。
|
||||
"""
|
||||
try:
|
||||
with open(path()) as f:
|
||||
d = json.load(f)
|
||||
except Exception:
|
||||
return None
|
||||
if not isinstance(d, dict) or not d.get("title"):
|
||||
return None
|
||||
return d
|
||||
|
||||
|
||||
def save(d) -> bool:
|
||||
try:
|
||||
with open(path(), "w") as f:
|
||||
json.dump(d, f, ensure_ascii=False, indent=2)
|
||||
return True
|
||||
except Exception:
|
||||
return False
|
||||
|
||||
|
||||
def clear() -> bool:
|
||||
try:
|
||||
os.remove(path())
|
||||
return True
|
||||
except FileNotFoundError:
|
||||
return True
|
||||
except Exception:
|
||||
return False
|
||||
|
||||
|
||||
def parse_ts(raw):
|
||||
if not isinstance(raw, str) or not raw.strip():
|
||||
return None
|
||||
s = raw.strip().replace("Z", "+00:00")
|
||||
try:
|
||||
dt = datetime.fromisoformat(s)
|
||||
except Exception:
|
||||
try:
|
||||
dt = datetime.fromisoformat(s + "T23:59:59+08:00")
|
||||
except Exception:
|
||||
return None
|
||||
return dt if dt.tzinfo else dt.replace(tzinfo=timezone.utc)
|
||||
|
||||
|
||||
def due_of(ms):
|
||||
return parse_ts((ms or {}).get("due_on") or "")
|
||||
|
||||
|
||||
def norm(s) -> str:
|
||||
"""比對標題用。只做「看不見的差異」的正規化——大小寫與空白。
|
||||
|
||||
🔴 刻意不做同義詞、不做模糊比對:主線是**被指定的**,不是被猜出來的。
|
||||
猜錯的方向是「把不屬於主線的票放行」,那正是這張票要擋的事。
|
||||
"""
|
||||
return "".join((s or "").split()).lower()
|
||||
|
||||
|
||||
def ref_of(ms) -> str:
|
||||
if not ms:
|
||||
return ""
|
||||
return "%s/%s#%s" % (ms.get("owner") or "?", ms.get("repo") or "?", ms.get("id") or "?")
|
||||
|
||||
|
||||
def members(ms):
|
||||
return set(ms.get("members") or []) if ms else set()
|
||||
|
||||
|
||||
def belongs(ticket_ref, ms, ticket_milestone_title=None):
|
||||
"""這張票屬不屬於主線?回 True/False/None。
|
||||
|
||||
None = **不知道**(快取裡沒有這張票,而呼叫端也沒查到它的 milestone)。
|
||||
🔴 「不知道」不等於「不屬於」——這條分界就是誤攔與否的分水嶺。
|
||||
呼叫的閘拿到 None 時該放行(本 repo 心法第 2 條:誤攔比漏擋更該修)。
|
||||
"""
|
||||
if not ms:
|
||||
return True # 沒有主線 ⇒ 沒有「不屬於主線」這回事
|
||||
ref = (ticket_ref or "").strip()
|
||||
if ref and ref in members(ms):
|
||||
return True
|
||||
if ticket_milestone_title is not None:
|
||||
return norm(ticket_milestone_title) == norm(ms.get("title"))
|
||||
return None
|
||||
|
||||
|
||||
def fixture_titles():
|
||||
"""測試用:把「去 Gitea 問這張票掛在哪」換成一份現成的答案。
|
||||
|
||||
`ISEP_MAINLINE_FIXTURE` 指向一個 JSON:`{"owner/repo#N": "milestone 標題"}`。
|
||||
設了它,閘就不打網路,直接拿這份當事實。
|
||||
|
||||
🔴 這與 `ISEP_COUNTDOWN_NOW`(把時鐘定住)是同一個性質的東西:
|
||||
**把外界定住,讓閘能離線、可重複地被測**。正式環境不會設它;
|
||||
沒設 ⇒ 這支回 None,判決完全走真實的 Gitea。
|
||||
"""
|
||||
p = os.environ.get("ISEP_MAINLINE_FIXTURE", "").strip()
|
||||
if not p:
|
||||
return None
|
||||
try:
|
||||
with open(p) as f:
|
||||
d = json.load(f)
|
||||
return d if isinstance(d, dict) else None
|
||||
except Exception:
|
||||
return None
|
||||
|
||||
|
||||
def record_jump(ticket_ref, ms):
|
||||
"""把「派了一張不在主線上的票」記一筆。**只留痕,不判罪。**
|
||||
|
||||
跳線本身常常是對的(補收、真的插件事)。留痕是為了讓「這條線今天被岔開幾次」
|
||||
事後數得出來——沒有紀錄的話,跳線與專注在機器上長得一模一樣。
|
||||
"""
|
||||
try:
|
||||
with open(os.path.join(state_dir(), JUMP_LOG), "a") as f:
|
||||
f.write(json.dumps({
|
||||
"at": datetime.now(timezone.utc).isoformat(),
|
||||
"ticket": ticket_ref,
|
||||
"mainline": ref_of(ms),
|
||||
"mainline_title": (ms or {}).get("title"),
|
||||
}, ensure_ascii=False) + "\n")
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
|
||||
def _human(delta: timedelta) -> str:
|
||||
days = int(abs(delta).total_seconds()) // 86400
|
||||
if days >= 1:
|
||||
return "%d 天" % days
|
||||
hours = int(abs(delta).total_seconds()) // 3600
|
||||
return "%d 小時" % hours
|
||||
|
||||
|
||||
def due_phrase(ms, now=None) -> str:
|
||||
"""期限那一段。沒設期限就說沒設——不准編一個日期出來。"""
|
||||
dt = due_of(ms)
|
||||
if not dt:
|
||||
return "沒設期限"
|
||||
now = now or datetime.now(timezone.utc)
|
||||
day = dt.astimezone(TAIPEI).strftime("%Y-%m-%d")
|
||||
gap = dt - now
|
||||
if gap.total_seconds() >= 0:
|
||||
return "%s(剩 %s)" % (day, _human(gap))
|
||||
return "%s(🔴 已逾期 %s)" % (day, _human(gap))
|
||||
|
||||
|
||||
def progress(ms):
|
||||
o = int((ms or {}).get("open_issues") or 0)
|
||||
c = int((ms or {}).get("closed_issues") or 0)
|
||||
total = o + c
|
||||
pct = int(round(c * 100.0 / total)) if total else 0
|
||||
return c, total, pct
|
||||
|
||||
|
||||
def line(now=None) -> str:
|
||||
"""注入用的那一行(倒數那一行的第二行)。**沒有主線時也要回一句話。**
|
||||
|
||||
ISEP#82 驗收第 4 條:沒有主線不能整組壞掉,要講得出「現在沒有主線」。
|
||||
⇒ 這支永遠回一個非空字串,永遠不 raise。
|
||||
"""
|
||||
ms = load()
|
||||
if not ms:
|
||||
return ("%s 現在沒有主線——沒有任何 milestone 被標成「現在在做的那一條」。"
|
||||
"要標:`scripts/mainline set <owner/repo#milestone_id>`"
|
||||
"(先看有哪些:`scripts/mainline list`)" % MARKER)
|
||||
c, total, pct = progress(ms)
|
||||
head = "%s 主線:%s「%s」|%s|%d/%d 張已關(%d%%)" % (
|
||||
MARKER, ref_of(ms), ms.get("title") or "?", due_phrase(ms, now), c, total, pct)
|
||||
goal = (ms.get("description") or "").strip().splitlines()
|
||||
if goal:
|
||||
head += "\n 目標:" + goal[0].strip()[:120]
|
||||
return head
|
||||
|
||||
|
||||
def countdown_segment(now=None):
|
||||
"""給 `countdown.py` 用的 (名稱, 期限) ——讓 ⏱ 那一行說得出主線是誰。
|
||||
|
||||
為什麼要塞進 ⏱ 那一行:⏱ 那一行**已經有一支 Stop 閘在查它有沒有被戴上**
|
||||
(inkstone/ISEP#63)。主線的名字掛在那一行上,就跟著那道已經驗過的閘一起
|
||||
到 leo 眼前——不必為了同一件事再立第二道會擋人的閘。
|
||||
"""
|
||||
ms = load()
|
||||
if not ms:
|
||||
return None
|
||||
return (ms.get("title") or "主線", due_of(ms))
|
||||
Executable
+176
@@ -0,0 +1,176 @@
|
||||
#!/usr/bin/env bash
|
||||
# mainline-focus-guard.sh — 派了一張不在主線上的票,就當場問清楚(inkstone/ISEP#82)
|
||||
#
|
||||
# ── 補的是哪一格 ────────────────────────────────────────────────
|
||||
# leo 2026-08-27:「**14 個里程碑同時亮著卻不知道該看哪個**」「今天……分心」。
|
||||
# SOP 說「有 active milestone 時只做該 milestone 的事」——但現場 14 個 open milestone,
|
||||
# 「那個」沒有指涉對象 ⇒ **那條規則在機器上等於不存在**(同款第 N 次:
|
||||
# history-first/KBDB-first/stage-first 全是「規則被讀到了,卻沒有機制驗證有沒有照做」)。
|
||||
#
|
||||
# ISEP#82 把「現在在做哪一條」變成一個查得到的事實(`scripts/mainline`),
|
||||
# 本閘是那個事實的**用處**:派工的票號不在主線上,就當場說是補收還是跳線,
|
||||
# 不要默默做完——分心不是「做了壞事」,是「岔開了而沒有人注意到」。
|
||||
#
|
||||
# ── 🔴 這不是關鍵字黑名單(leo 2026-08-17 已證偽那條路)────────────────
|
||||
# 「自然語言的變體是無限的,blacklist 永遠追不完……封路哲學之所以有效,
|
||||
# 是因為它封的是**動作**——動作有限且可枚舉,文字不是。」
|
||||
# 當日實測:文字層的閘 8 次誤攔、0 次正確攔截。
|
||||
#
|
||||
# 本閘從頭到尾**不讀派工單的任何一個字義**。它只做兩個查表:
|
||||
# ① 派工單的【工單】欄位是哪一張票(`hooks/lib/dispatch_parse.py` 解結構,不判語意)
|
||||
# ② 那張票所屬的 milestone 標題,等不等於被標定的主線標題(字串相等,不是模糊比對)
|
||||
# 措辭怎麼寫都不影響判決;改的只有「這張票掛在哪」這個 Gitea 上的事實。
|
||||
#
|
||||
# ── 誤攔的出口全部先關掉(誤攔比漏擋更該修)──────────────────────────
|
||||
# · **沒有主線 ⇒ 一律放行**(ISEP#82 驗收第 4 條:沒有主線不能整組壞掉)
|
||||
# · 派工單裡沒有票號 ⇒ 放行(那是 no-ticket-no-dispatch.sh 的地盤,
|
||||
# 兩支閘同時開口,收工方會拿到兩份打架的教學)
|
||||
# · 多張票只要**有一張**在主線上 ⇒ 放行(那次派工有在推主線)
|
||||
# · 快取裡查不到,就**打一次網路去問那張票**;問不到 ⇒ 放行
|
||||
# (🔴「讀不到」不等於「不屬於」——把這兩件事講成同一句是最貴的錯)
|
||||
# · 子 session 不查:主線是**派工者**手上的判準(CLAUDE.md:「critical path 是
|
||||
# 你用來盯 subagent 的判準」),不是收工方要背的東西
|
||||
# · **同一張票只擋一次**:擋完就落一個戳記,重送即放行 ⇒ 不會鬼打牆
|
||||
# · 內部出錯一律放行——這是節拍器不是安全閘,它壞掉不該讓派工停擺
|
||||
set -uo pipefail
|
||||
|
||||
INPUT="$(cat)"
|
||||
HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
|
||||
# 子 session 不查(見上)
|
||||
[ "${CLAUDE_CODE_CHILD_SESSION:-}" = "1" ] && exit 0
|
||||
|
||||
VERDICT=$(printf '%s' "$INPUT" | ISEP_HOOKS_DIR="$HERE" python3 -c '
|
||||
import importlib.machinery, importlib.util, json, os, sys, urllib.request
|
||||
|
||||
HERE = os.environ["ISEP_HOOKS_DIR"]
|
||||
|
||||
def load(name, path):
|
||||
ldr = importlib.machinery.SourceFileLoader(name, path)
|
||||
spec = importlib.util.spec_from_file_location(name, path, loader=ldr)
|
||||
mod = importlib.util.module_from_spec(spec)
|
||||
ldr.exec_module(mod)
|
||||
return mod
|
||||
|
||||
def bail(why):
|
||||
print("SKIP:" + why); raise SystemExit
|
||||
|
||||
try:
|
||||
d = json.load(sys.stdin)
|
||||
except Exception:
|
||||
bail("bad-json")
|
||||
|
||||
prompt = (d.get("tool_input") or {}).get("prompt") or ""
|
||||
if not prompt.strip():
|
||||
bail("no-prompt")
|
||||
|
||||
try:
|
||||
dp = load("isep_dispatch_parse", os.path.join(HERE, "lib", "dispatch_parse.py"))
|
||||
ML = load("isep_mainline", os.path.join(HERE, "lib", "mainline.py"))
|
||||
except Exception:
|
||||
bail("lib-unavailable")
|
||||
|
||||
try:
|
||||
refs = dp.parse_dispatch(prompt).get("refs") or []
|
||||
except Exception:
|
||||
bail("parse-failed")
|
||||
if not refs:
|
||||
bail("no-ticket") # no-ticket-no-dispatch 的地盤
|
||||
|
||||
ms = ML.load()
|
||||
if not ms:
|
||||
bail("no-mainline") # 沒有主線 ⇒ 沒有「不屬於主線」這回事
|
||||
|
||||
wanted = ["%s/%s#%d" % (r["owner"], r["repo"], r["num"]) for r in refs]
|
||||
|
||||
# ① 離線先問快取:有一張在主線上就放行
|
||||
unknown = []
|
||||
for ref in wanted:
|
||||
v = ML.belongs(ref, ms)
|
||||
if v is True:
|
||||
print("SKIP:on-mainline"); raise SystemExit
|
||||
if v is None:
|
||||
unknown.append(ref)
|
||||
|
||||
# ② 快取查不到的,去問那張票掛在哪。問不到 ⇒ 放行。
|
||||
if unknown:
|
||||
fx = ML.fixture_titles()
|
||||
if fx is not None: # 測試把外界定住(見 mainline.fixture_titles)
|
||||
learned = [r for r in unknown
|
||||
if ML.norm(fx.get(r, "")) == ML.norm(ms.get("title"))]
|
||||
if learned:
|
||||
print("SKIP:on-mainline-fixture"); raise SystemExit
|
||||
if not any(r in fx for r in unknown):
|
||||
bail("unreachable") # fixture 沒收錄 ⇒ 等同問不到
|
||||
else:
|
||||
try:
|
||||
T = load("isep_ticket", os.path.join(HERE, "..", "scripts", "ticket"))
|
||||
tok = T.token()
|
||||
host = T.HOST
|
||||
# 🔴 BaseException 不是筆誤:`scripts/ticket` 拿不到憑證時是 sys.exit(SystemExit),
|
||||
# 那不是 Exception 的子類。只接 Exception 的話,這支會整個死掉而不是放行。
|
||||
except BaseException:
|
||||
bail("no-token") # 讀不到 ≠ 不屬於
|
||||
reached = False
|
||||
learned = []
|
||||
for ref in unknown:
|
||||
try:
|
||||
owner, rest = ref.split("/", 1)
|
||||
repo, num = rest.split("#", 1)
|
||||
req = urllib.request.Request(
|
||||
"%s/api/v1/repos/%s/%s/issues/%s" % (host, owner, repo, num),
|
||||
headers={"Authorization": "token %s" % tok})
|
||||
it = json.load(urllib.request.urlopen(req, timeout=6))
|
||||
reached = True
|
||||
except Exception:
|
||||
continue
|
||||
title = ((it or {}).get("milestone") or {}).get("title") or ""
|
||||
if ML.norm(title) == ML.norm(ms.get("title")):
|
||||
learned.append(ref)
|
||||
if learned:
|
||||
ms["members"] = sorted(set(ms.get("members") or []) | set(learned))
|
||||
ML.save(ms)
|
||||
print("SKIP:on-mainline-fresh"); raise SystemExit
|
||||
if not reached:
|
||||
bail("unreachable") # 一張都問不到 ⇒ 放行
|
||||
|
||||
# ③ 確定都不在主線上 —— 同一組票只擋一次
|
||||
import hashlib
|
||||
key = hashlib.sha1(("|".join(sorted(wanted)) + "@" + ML.ref_of(ms)).encode()).hexdigest()[:16]
|
||||
stamp = os.path.join(ML.state_dir(), "jump-ok-" + key)
|
||||
if os.path.exists(stamp):
|
||||
print("SKIP:already-asked"); raise SystemExit
|
||||
try:
|
||||
open(stamp, "w").close()
|
||||
except Exception:
|
||||
pass
|
||||
ML.record_jump(",".join(wanted), ms)
|
||||
print("BLOCK:%s\t%s\t%s" % (",".join(wanted), ML.ref_of(ms), ms.get("title") or "?"))
|
||||
' 2>/dev/null || echo "SKIP:crash")
|
||||
|
||||
case "$VERDICT" in
|
||||
BLOCK:*)
|
||||
PAYLOAD="${VERDICT#BLOCK:}"
|
||||
TICKETS=$(printf '%s' "$PAYLOAD" | cut -f1)
|
||||
MREF=$(printf '%s' "$PAYLOAD" | cut -f2)
|
||||
MTITLE=$(printf '%s' "$PAYLOAD" | cut -f3)
|
||||
FIRST=$(printf '%s' "$TICKETS" | cut -d, -f1)
|
||||
{
|
||||
printf '🎯 這張票不在主線上(inkstone/ISEP#82)\n\n'
|
||||
printf ' 現在的主線:%s「%s」\n' "$MREF" "$MTITLE"
|
||||
printf ' 這次要派的:%s\n\n' "$TICKETS"
|
||||
printf '**先說是哪一種,再繼續**——兩種都可能是對的,錯的是默默做完:\n\n'
|
||||
printf ' ① 補收 —— 它本來就該在主線上,只是沒掛上去\n'
|
||||
printf ' `scripts/mainline adopt %s` 然後重送\n\n' "$FIRST"
|
||||
printf ' ② 跳線 —— 真的是插件事(leo 臨時交辦、擋路的地雷…)\n'
|
||||
printf ' 直接重送即可(**同一張票只擋一次**),並在回覆講一句為什麼現在要岔開主線\n\n'
|
||||
printf '為什麼要問:leo 2026-08-27「今天……分心」。分心的前提是有一條主線,\n'
|
||||
printf '而分心本身不是做了壞事,是**岔開了而沒有人注意到**。這一問就是那個「注意到」。\n\n'
|
||||
printf '想確認主線是誰:`scripts/mainline`(唯一答案)。\n'
|
||||
} >&2
|
||||
exit 2
|
||||
;;
|
||||
*)
|
||||
exit 0
|
||||
;;
|
||||
esac
|
||||
@@ -1,107 +0,0 @@
|
||||
#!/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
|
||||
@@ -145,12 +145,17 @@ case "$CTX" in
|
||||
esac
|
||||
|
||||
# milestone:沒有快取就整段不出現(不准編一個日期出來)
|
||||
case "$CTX" in
|
||||
*"主線"*) no "⑨ 沒有 milestone 快取 ⇒ 那一段不出現" "實得:$CTX" ;;
|
||||
# 🔴 只比對**第一行**(那條 ⏱ 倒數本身)。inkstone/ISEP#82 之後,同一個注入點還帶著
|
||||
# 第二行「🎯 主線……」與一段說明,那段文字裡本來就會出現「主線」兩個字
|
||||
# ——拿整段去比對會把說明當成數字,變成一條**測不到重點的假紅**。
|
||||
# 這一格要驗的一直都是「⏱ 那一行有沒有多長出一段編出來的期限」。
|
||||
STAMP_LINE_ONLY=$(printf '%s\n' "$CTX" | head -1)
|
||||
case "$STAMP_LINE_ONLY" in
|
||||
*"主線"*) no "⑨ 沒有 milestone 快取 ⇒ 那一段不出現" "實得:$STAMP_LINE_ONLY" ;;
|
||||
*) ok "⑨ 沒有 milestone 快取 ⇒ 那一段不出現(不編數字)" ;;
|
||||
esac
|
||||
printf '2026-08-30|Sprint 8-28\n' > "$ISEP_COUNTDOWN_STATE_DIR/milestone-due"
|
||||
CTX=$(inject s-ms "$TMP/a5.jsonl" "$T0")
|
||||
CTX=$(printf '%s\n' "$(inject s-ms "$TMP/a5.jsonl" "$T0")" | head -1)
|
||||
case "$CTX" in
|
||||
*"主線 Sprint 8-28 剩"*) ok "⑩ 有 milestone 快取 ⇒ 期限那一段出現" ;;
|
||||
*) no "⑩ 有 milestone 快取 ⇒ 期限那一段出現" "實得:$CTX" ;;
|
||||
|
||||
Executable
+202
@@ -0,0 +1,202 @@
|
||||
#!/usr/bin/env bash
|
||||
# 主線那一條線的迴歸測試(inkstone/ISEP#82)
|
||||
#
|
||||
# 票上四條驗收,這裡一條一群:
|
||||
# A 「現在的主線是哪一個」→ 一個指令答得出來,而且答案唯一
|
||||
# B 標了主線之後開新回合 → 目標宣告自己出現(不用人去翻)
|
||||
# C 派一張不屬於主線的票 → 攔一次,並問是補收還是跳線
|
||||
# D 沒有任何主線 → 不能整組壞掉,要講得出「現在沒有主線」
|
||||
# E 不該擋的(誤攔比漏擋更該修)
|
||||
#
|
||||
# 用法:hooks/tests/mainline-focus-guard.test.sh
|
||||
# 🔴 全程離線:狀態走 ISEP_COUNTDOWN_STATE_DIR、時鐘走 ISEP_COUNTDOWN_NOW、
|
||||
# 「那張票掛在哪」走 ISEP_MAINLINE_FIXTURE,並把 TICKET_HOST 指到一個
|
||||
# 連不上的位址——**任何一條真的走到網路,就會在那裡當場失敗,不會靜靜地變成假綠**。
|
||||
set -u
|
||||
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
GUARD="$ROOT/mainline-focus-guard.sh"
|
||||
COUNTDOWN="$ROOT/countdown-guard.sh"
|
||||
MAINLINE="$ROOT/../scripts/mainline"
|
||||
|
||||
TMP=$(mktemp -d)
|
||||
trap 'rm -rf "$TMP"' EXIT
|
||||
export ISEP_COUNTDOWN_STATE_DIR="$TMP/state"
|
||||
export TICKET_HOST="http://127.0.0.1:9" # 連不上:走到網路就會馬上失敗
|
||||
mkdir -p "$ISEP_COUNTDOWN_STATE_DIR"
|
||||
unset ISEP_MAINLINE_FIXTURE
|
||||
|
||||
PASS=0; FAIL=0
|
||||
ok(){ printf ' ✅ %s\n' "$1"; PASS=$((PASS+1)); }
|
||||
no(){ printf ' ❌ %s —— %s\n' "$1" "$2"; FAIL=$((FAIL+1)); }
|
||||
|
||||
T0=$(python3 -c 'import datetime as d;print(int(d.datetime(2026,8,28,0,0,tzinfo=d.timezone.utc).timestamp()))')
|
||||
|
||||
# set_mainline <標題> <成員 ref...> —— 直接寫 state(離線;`mainline set` 那半要網路)
|
||||
set_mainline(){
|
||||
python3 - "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" "$@" <<'PY'
|
||||
import json, sys
|
||||
path, title = sys.argv[1], sys.argv[2]
|
||||
json.dump({"ref": "inkstone/ISEP#57", "owner": "inkstone", "repo": "ISEP", "id": 57,
|
||||
"title": title, "description": "把 SOP 變成閘:規則要長在機器上,不是長在誰的記性上。",
|
||||
"due_on": "2026-08-31T15:59:59+08:00",
|
||||
"open_issues": 12, "closed_issues": 1,
|
||||
"members": list(sys.argv[3:]), "set_at": "2026-08-28 08:00"},
|
||||
open(path, "w"), ensure_ascii=False)
|
||||
PY
|
||||
}
|
||||
clear_mainline(){ rm -f "$ISEP_COUNTDOWN_STATE_DIR/mainline.json"; }
|
||||
|
||||
# dispatch <派工單內文> → "exit|訊息"
|
||||
dispatch(){
|
||||
out=$(python3 -c '
|
||||
import json,sys; print(json.dumps({"tool_input":{"prompt":sys.argv[1]},"session_id":"t"}))' "$1" \
|
||||
| CLAUDE_CODE_CHILD_SESSION= bash "$GUARD" 2>&1); rc=$?
|
||||
printf '%s|%s' "$rc" "$(printf '%s' "$out" | tr '\n' ' ')"
|
||||
}
|
||||
|
||||
# inject <now> → UserPromptSubmit 注入的內容
|
||||
inject(){
|
||||
printf '{"hook_event_name":"UserPromptSubmit","session_id":"s","transcript_path":"%s"}' "$TMP/none.jsonl" \
|
||||
| ISEP_COUNTDOWN_NOW="$1" bash "$COUNTDOWN" 2>/dev/null \
|
||||
| python3 -c 'import json,sys
|
||||
try: print(json.load(sys.stdin)["hookSpecificOutput"]["additionalContext"])
|
||||
except Exception: print("")'
|
||||
}
|
||||
|
||||
echo "── A 群:「現在的主線是哪一個」一個指令答得出來,答案唯一(驗收 1)──"
|
||||
|
||||
clear_mainline
|
||||
OUT=$(python3 "$MAINLINE" 2>&1); RC=$?
|
||||
[ "$RC" = 0 ] && ok "① 沒標過主線 ⇒ 指令仍然回答得出來(exit 0,不是壞掉)" \
|
||||
|| no "① 沒標過主線 ⇒ exit 0" "實得 exit=$RC"
|
||||
case "$OUT" in
|
||||
*"現在沒有主線"*) ok "② 沒標過主線 ⇒ 答案是「現在沒有主線」(驗收 4)" ;;
|
||||
*) no "② 沒標過 ⇒ 說「現在沒有主線」" "實得:$OUT" ;;
|
||||
esac
|
||||
|
||||
set_mainline "SOP 變成閘" "inkstone/ISEP#82" "inkstone/ISEP#57"
|
||||
OUT=$(python3 "$MAINLINE" 2>&1)
|
||||
N=$(printf '%s\n' "$OUT" | grep -c "現在的主線")
|
||||
[ "$N" = 1 ] && ok "③ 標了之後 ⇒ 只有一個答案(「現在的主線」出現 1 次,不是 14 個)" \
|
||||
|| no "③ 答案唯一" "「現在的主線」出現 $N 次"
|
||||
case "$OUT" in
|
||||
*"SOP 變成閘"*) ok "④ 答案指名道姓(標題印出來了)" ;;
|
||||
*) no "④ 答案指名道姓" "實得:$OUT" ;;
|
||||
esac
|
||||
|
||||
set_mainline "換一條線" "inkstone/ISEP#82"
|
||||
# 🔴 只看標題那一行:描述欄裡本來就會提到舊標題(它是同一份測資),
|
||||
# 拿整份輸出去比對會**因為描述而誤判**——那不是「舊的還是主線」。
|
||||
OUT=$(python3 "$MAINLINE" 2>&1 | head -1)
|
||||
case "$OUT" in
|
||||
*"SOP 變成閘"*) no "⑤ 換標一條 ⇒ 舊的不再是主線" "舊標題還在:$OUT" ;;
|
||||
*"換一條線"*) ok "⑤ 換標一條 ⇒ 舊的當場不再是主線(一個檔放得下一條)" ;;
|
||||
*) no "⑤ 換標一條" "實得:$OUT" ;;
|
||||
esac
|
||||
|
||||
echo "── B 群:標了之後開新回合,目標宣告自己出現(驗收 2)──────────"
|
||||
|
||||
set_mainline "SOP 變成閘" "inkstone/ISEP#82"
|
||||
CTX=$(inject "$T0")
|
||||
case "$CTX" in
|
||||
*"🎯 主線:"*) ok "⑥ 什麼都沒交代 ⇒ 注入裡有 🎯 主線那一行" ;;
|
||||
*) no "⑥ 注入裡有 🎯 主線那一行" "實得:$CTX" ;;
|
||||
esac
|
||||
case "$CTX" in
|
||||
*"SOP 變成閘"*) ok "⑦ 注入裡有主線的名字" ;;
|
||||
*) no "⑦ 注入裡有主線的名字" "實得:$CTX" ;;
|
||||
esac
|
||||
case "$CTX" in
|
||||
*"目標:把 SOP 變成閘"*) ok "⑧ 注入裡有**目標宣告**(milestone 的描述),不用人去翻" ;;
|
||||
*) no "⑧ 注入裡有目標宣告" "實得:$CTX" ;;
|
||||
esac
|
||||
# ⏱ 那一行是**已經有 Stop 閘在查**的那一行(ISEP#63)。主線的名字掛在它上面,
|
||||
# 就跟著那道驗過的閘一起到 leo 眼前——不必為了同一件事再立第二道會擋人的閘。
|
||||
FIRST=$(printf '%s\n' "$CTX" | head -1)
|
||||
case "$FIRST" in
|
||||
*"⏱"*"主線 SOP 變成閘"*) ok "⑨ 被查核的那一行(⏱)也帶著主線名字 ⇒ 主線會到 leo 眼前" ;;
|
||||
*) no "⑨ ⏱ 那一行帶主線名字" "實得:$FIRST" ;;
|
||||
esac
|
||||
# 被標定的主線要蓋過「期限最近的那個」快取——後者是猜的,前者是被指定的
|
||||
printf '2026-08-29|某個期限更近的\n' > "$ISEP_COUNTDOWN_STATE_DIR/milestone-due"
|
||||
FIRST=$(inject "$T0" | head -1)
|
||||
case "$FIRST" in
|
||||
*"主線 SOP 變成閘"*) ok "⑩ 標定的主線蓋過「期限最近」的猜測(不准用猜的蓋過指定的)" ;;
|
||||
*) no "⑩ 標定的主線優先" "實得:$FIRST" ;;
|
||||
esac
|
||||
rm -f "$ISEP_COUNTDOWN_STATE_DIR/milestone-due"
|
||||
|
||||
clear_mainline
|
||||
CTX=$(inject "$T0")
|
||||
case "$CTX" in
|
||||
*"現在沒有主線"*) ok "⑪ 沒有主線 ⇒ 注入照樣講得出「現在沒有主線」(驗收 4,不編一條)" ;;
|
||||
*) no "⑪ 沒有主線 ⇒ 注入講「現在沒有主線」" "實得:$CTX" ;;
|
||||
esac
|
||||
|
||||
echo "── C 群:派了不在主線上的票 ⇒ 攔一次並問清楚(驗收 3)──────────"
|
||||
|
||||
set_mainline "SOP 變成閘" "inkstone/ISEP#82" "inkstone/ISEP#57"
|
||||
printf '{"inkstone/Arcrun#50":"AI 問得到內文"}\n' > "$TMP/fx.json"
|
||||
export ISEP_MAINLINE_FIXTURE="$TMP/fx.json"
|
||||
|
||||
R=$(dispatch '【工單】inkstone/ISEP#82')
|
||||
[ "${R%%|*}" = 0 ] && ok "⑫ 派主線上的票 ⇒ 放行" || no "⑫ 派主線上的票 ⇒ 放行" "實得 exit=${R%%|*}"
|
||||
|
||||
R=$(dispatch '【工單】inkstone/Arcrun#50')
|
||||
[ "${R%%|*}" = 2 ] && ok "⑬ 派不在主線上的票 ⇒ 擋" || no "⑬ 派不在主線上的票 ⇒ 擋" "實得 exit=${R%%|*}"
|
||||
case "${R#*|}" in
|
||||
*"補收"*"跳線"*) ok "⑭ 擋下時問的是「補收還是跳線」,兩條路都給了指令" ;;
|
||||
*) no "⑭ 訊息問補收/跳線" "實得:${R#*|}" ;;
|
||||
esac
|
||||
case "${R#*|}" in
|
||||
*"SOP 變成閘"*) ok "⑮ 擋下時說得出現在的主線是誰(不是只說「你錯了」)" ;;
|
||||
*) no "⑮ 訊息說出主線是誰" "實得:${R#*|}" ;;
|
||||
esac
|
||||
|
||||
R=$(dispatch '【工單】inkstone/Arcrun#50')
|
||||
[ "${R%%|*}" = 0 ] && ok "⑯ 同一張票重送 ⇒ 放行(至多擋一次,不鬼打牆)" \
|
||||
|| no "⑯ 重送 ⇒ 放行" "實得 exit=${R%%|*}"
|
||||
|
||||
J=$(wc -l < "$ISEP_COUNTDOWN_STATE_DIR/mainline-jumps.jsonl" 2>/dev/null || echo 0)
|
||||
[ "$J" -ge 1 ] && ok "⑰ 跳線留痕(mainline-jumps.jsonl 記了一筆)——不留痕的話跳線與專注長得一樣" \
|
||||
|| no "⑰ 跳線留痕" "jumps 檔有 $J 行"
|
||||
|
||||
R=$(dispatch '【工單】inkstone/Arcrun#50
|
||||
【工單】inkstone/ISEP#82')
|
||||
[ "${R%%|*}" = 0 ] && ok "⑱ 多張票只要有一張在主線上 ⇒ 放行(那次派工有在推主線)" \
|
||||
|| no "⑱ 多張票有一張在主線 ⇒ 放行" "實得 exit=${R%%|*}"
|
||||
|
||||
echo "── D/E 群:不該擋(誤攔比漏擋更該修)──────────────────────────"
|
||||
|
||||
clear_mainline
|
||||
R=$(dispatch '【工單】inkstone/Arcrun#50')
|
||||
[ "${R%%|*}" = 0 ] && ok "⑲ 沒有主線 ⇒ 一律放行(驗收 4:不能整組壞掉)" \
|
||||
|| no "⑲ 沒有主線 ⇒ 放行" "實得 exit=${R%%|*}"
|
||||
|
||||
set_mainline "SOP 變成閘" "inkstone/ISEP#82"
|
||||
R=$(dispatch '幫我看一下這個 repo 的狀況')
|
||||
[ "${R%%|*}" = 0 ] && ok "⑳ 派工單裡沒有票號 ⇒ 放行(那是 no-ticket-no-dispatch 的地盤)" \
|
||||
|| no "⑳ 沒有票號 ⇒ 放行" "實得 exit=${R%%|*}"
|
||||
|
||||
out=$(python3 -c '
|
||||
import json;print(json.dumps({"tool_input":{"prompt":"【工單】inkstone/Arcrun#50"},"session_id":"t"}))' \
|
||||
| CLAUDE_CODE_CHILD_SESSION=1 bash "$GUARD" 2>&1); rc=$?
|
||||
[ "$rc" = 0 ] && ok "㉑ 子 session ⇒ 放行(主線是派工者手上的判準,不是收工方要背的)" \
|
||||
|| no "㉑ 子 session ⇒ 放行" "實得 exit=$rc"
|
||||
|
||||
unset ISEP_MAINLINE_FIXTURE
|
||||
R=$(dispatch '【工單】inkstone/mira#999')
|
||||
[ "${R%%|*}" = 0 ] && ok "㉒ 問不到那張票掛在哪(沒 fixture、網路也不通)⇒ 放行:讀不到 ≠ 不屬於" \
|
||||
|| no "㉒ 問不到 ⇒ 放行" "實得 exit=${R%%|*}"
|
||||
|
||||
printf 'not json {{{\n' > "$ISEP_COUNTDOWN_STATE_DIR/mainline.json"
|
||||
R=$(dispatch '【工單】inkstone/Arcrun#50')
|
||||
[ "${R%%|*}" = 0 ] && ok "㉓ state 檔壞掉 ⇒ 放行(節拍器壞掉不該讓派工停擺)" \
|
||||
|| no "㉓ state 壞掉 ⇒ 放行" "實得 exit=${R%%|*}"
|
||||
OUT=$(python3 "$MAINLINE" 2>&1); RC=$?
|
||||
[ "$RC" = 0 ] && ok "㉔ state 檔壞掉 ⇒ 指令仍然回答得出來(當成「現在沒有主線」)" \
|
||||
|| no "㉔ state 壞掉 ⇒ 指令不崩" "實得 exit=$RC:$OUT"
|
||||
|
||||
echo
|
||||
echo "結果:通過 $PASS 條,失敗 $FAIL 條"
|
||||
[ "$FAIL" -eq 0 ] || exit 1
|
||||
@@ -1,85 +0,0 @@
|
||||
#!/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 ]
|
||||
Executable
+332
@@ -0,0 +1,332 @@
|
||||
#!/usr/bin/env python3
|
||||
"""mainline — 「現在的主線是哪一個」這個問題的**唯一指令**(inkstone/ISEP#82)。
|
||||
|
||||
leo 2026-08-27:「**14 個里程碑同時亮著卻不知道該看哪個**」。
|
||||
當天實查 `GET /repos/inkstone/*/milestones?state=open` 回 14 個,其中「Mira 現代化」
|
||||
這個名字同時活在 5 個 repo,另有 5 個已經逾期。
|
||||
⇒ SOP 說的「**那個** active milestone」在現場根本沒有指涉對象——
|
||||
要注入不知道注哪一個,要擋跳線也不知道拿哪一個當基準。
|
||||
|
||||
這支不解「milestone 太多」(跨 repo 同名是既有做法,不動它),
|
||||
它解的是「**這一刻我在做哪一條**」沒有答案:
|
||||
|
||||
mainline 現在的主線是哪一個(= show,唯一答案,離線)
|
||||
mainline list 有哪些 open milestone 可以選(打網路)
|
||||
mainline set <owner/repo#id> 把某一個 milestone 標成主線(打網路,寫進 state)
|
||||
mainline clear 現在沒有主線(例:一條線收掉了,下一條還沒開始)
|
||||
mainline refresh [--members] 更新進度/期限(SessionStart 跑一次,不輪詢)
|
||||
mainline adopt <owner/repo#N> 「補收」:把一張票掛進主線(打網路)
|
||||
mainline has <owner/repo#N> 這張票在不在主線上(exit 0 =在,1 =不在)
|
||||
|
||||
🔴 **`<owner/repo#id>` 的 id 是 milestone 的 id,不是 issue 的號碼。**
|
||||
兩者在 Gitea 是兩套獨立編號,`mainline list` 印出來的就是可以直接貼的那一個。
|
||||
|
||||
── 答案為什麼唯一 ─────────────────────────────────────────────────
|
||||
主線住在一個檔裡(`~/.claude/isep-countdown/mainline.json`),那個檔**放得下一條**。
|
||||
沒有清單、沒有優先序、沒有「前三名」——`set` 覆蓋掉的那條就不再是主線。
|
||||
⇒ 問一次只會拿到 0 或 1 個答案,不會拿到 14 個。
|
||||
|
||||
── 主線是一個名字,錨在一個具體的 milestone 上 ────────────────────
|
||||
Gitea 的 milestone 不能跨 repo,而同一條線常常同時開在 5 個 repo。所以
|
||||
**錨**(期限/進度/目標宣告都讀它)是 `owner/repo#id`,
|
||||
**成員判定**看的是「票所屬 milestone 的標題與主線標題相同」(不分 repo)。
|
||||
兩件事都成立:同名跨 repo 照舊能用,而「現在在做哪一條」仍然只有一個答案。
|
||||
"""
|
||||
import importlib.machinery
|
||||
import importlib.util
|
||||
import os
|
||||
import sys
|
||||
import urllib.parse
|
||||
from datetime import datetime, timezone
|
||||
|
||||
HERE = os.path.dirname(os.path.abspath(__file__))
|
||||
|
||||
|
||||
def _load(name, path):
|
||||
"""把一個檔載進來當模組。`scripts/ticket` 沒有 `.py` 副檔名,所以要明著給 loader
|
||||
(`spec_from_file_location` 只靠副檔名認不出它,會回 None)。"""
|
||||
loader = importlib.machinery.SourceFileLoader(name, path)
|
||||
spec = importlib.util.spec_from_file_location(name, path, loader=loader)
|
||||
mod = importlib.util.module_from_spec(spec)
|
||||
loader.exec_module(mod)
|
||||
return mod
|
||||
|
||||
|
||||
# 憑證怎麼拿、API 怎麼打、票號怎麼解析——**全部沿用 `scripts/ticket` 那一份**。
|
||||
# 🔴 刻意不自己再寫一份 token():金鑰的取得只准有一條路(頂層 CLAUDE.md 金鑰鐵律
|
||||
# + 2026-07-29 t145 的實害——同一把金鑰兩種寫法並存,必然漂移)。
|
||||
ML = _load("isep_mainline", os.path.join(HERE, "..", "hooks", "lib", "mainline.py"))
|
||||
try:
|
||||
T = _load("isep_ticket", os.path.join(HERE, "ticket"))
|
||||
except Exception:
|
||||
# 🔴 載不到就只是「打不了網路的那幾個動作不能用」,不是整支壞掉。
|
||||
# ISEP#82 驗收第 4 條要的是「沒有主線也不能整組壞掉」,同一個道理:
|
||||
# `show` 是離線的,它不該因為別的零件壞了而回答不出來。
|
||||
T = None
|
||||
|
||||
|
||||
def die(msg, code=2):
|
||||
print(msg, file=sys.stderr)
|
||||
sys.exit(code)
|
||||
|
||||
|
||||
def need_net():
|
||||
if T is None:
|
||||
die("🔴 載不到 `scripts/ticket`(憑證與 API 都沿用它),這個動作打不了網路。\n"
|
||||
" `scripts/mainline show` 仍然可以用——它是離線的。")
|
||||
|
||||
|
||||
def parse_ms_ref(s):
|
||||
"""`owner/repo#<milestone id>`。與票號同形,所以錯手貼票號會拿到 404,訊息要講清楚。"""
|
||||
import re
|
||||
m = re.match(r"^([\w.-]+)/([\w.-]+)#(\d+)$", (s or "").strip())
|
||||
if not m:
|
||||
die("🔴 寫法是 owner/repo#<milestone id>,你給的是:%s\n"
|
||||
"(先跑 `scripts/mainline list` 看有哪些,那裡印的就是可以直接貼的)" % s)
|
||||
return m.group(1), m.group(2), int(m.group(3))
|
||||
|
||||
|
||||
def org_repos(owner):
|
||||
rows = T.api_soft("/orgs/%s/repos?limit=100" % owner) or []
|
||||
return [r["name"] for r in rows if isinstance(r, dict) and r.get("name")]
|
||||
|
||||
|
||||
def issues_in_milestone(owner, repo, title):
|
||||
q = urllib.parse.urlencode({"state": "all", "type": "issues",
|
||||
"milestones": title, "limit": 100})
|
||||
rows = T.api_soft("/repos/%s/%s/issues?%s" % (owner, repo, q)) or []
|
||||
out = []
|
||||
for it in rows:
|
||||
if not isinstance(it, dict) or it.get("pull_request"):
|
||||
continue
|
||||
ms = it.get("milestone") or {}
|
||||
# 🔴 再比對一次標題:`milestones=` 這個參數在不同 Gitea 版本上對「名稱 vs id」
|
||||
# 的解讀不完全一致,拿回來的東西要自己確認過才算數(不要相信查詢字串)。
|
||||
if ML.norm(ms.get("title")) != ML.norm(title):
|
||||
continue
|
||||
out.append("%s/%s#%d" % (owner, repo, it["number"]))
|
||||
return out
|
||||
|
||||
|
||||
def collect_members(owner, title, anchor_repo):
|
||||
"""跨 repo 收齊「掛在同名 milestone 底下」的票。"""
|
||||
refs, scanned = [], []
|
||||
repos = org_repos(owner)
|
||||
if anchor_repo not in repos:
|
||||
repos.append(anchor_repo)
|
||||
for r in repos:
|
||||
got = issues_in_milestone(owner, r, title)
|
||||
if got:
|
||||
scanned.append((r, len(got)))
|
||||
refs.extend(got)
|
||||
return sorted(set(refs)), scanned
|
||||
|
||||
|
||||
def fetch_milestone(owner, repo, mid):
|
||||
d = T.api_soft("/repos/%s/%s/milestones/%d" % (owner, repo, mid))
|
||||
if not isinstance(d, dict) or not d.get("title"):
|
||||
die("🔴 讀不到 %s/%s#%d 這個 milestone。\n"
|
||||
" · id 是 milestone 的 id,不是 issue 的號碼(`scripts/mainline list` 會印對的)\n"
|
||||
" · 或是這台機器現在拿不到 Gitea(那就先別標,不要標一個猜的)" % (owner, repo, mid))
|
||||
return d
|
||||
|
||||
|
||||
# ── show ─────────────────────────────────────────────────────────────────
|
||||
def cmd_show(argv):
|
||||
"""離線。**永遠回一個答案**,包括「現在沒有主線」(ISEP#82 驗收第 4 條)。"""
|
||||
ms = ML.load()
|
||||
if not ms:
|
||||
print("🎯 現在沒有主線。")
|
||||
print()
|
||||
print(" 這不是故障——沒有人標過,或上一條收掉了。")
|
||||
print(" 要標一條:`scripts/mainline list` 看有哪些 → `scripts/mainline set <owner/repo#id>`")
|
||||
print()
|
||||
print("📌 在標之前,每回合的 🎯 那一行也會照樣講「現在沒有主線」,不會編一條出來。")
|
||||
return
|
||||
c, total, pct = ML.progress(ms)
|
||||
print("🎯 現在的主線:%s「%s」" % (ML.ref_of(ms), ms.get("title")))
|
||||
desc = (ms.get("description") or "").strip()
|
||||
if desc:
|
||||
first = desc.splitlines()[0].strip()
|
||||
# 只印第一行、最多 150 字:這是**一眼掃**的答案,不是 milestone 的全文。
|
||||
# leo 一天看兩眼(白話鐵律),整段貼過來他就不會看。
|
||||
print(" 目標:" + (first[:150] + "…" if len(first) > 150 else first))
|
||||
print(" 期限:%s" % ML.due_phrase(ms))
|
||||
print(" 進度:%d/%d 張已關(%d%%)" % (c, total, pct))
|
||||
mem = sorted(ML.members(ms))
|
||||
byrepo = {}
|
||||
for r in mem:
|
||||
byrepo[r.split("#")[0]] = byrepo.get(r.split("#")[0], 0) + 1
|
||||
print(" 屬於主線的票:%d 張%s" % (
|
||||
len(mem), ("(" + "、".join("%s %d" % (k, v) for k, v in sorted(byrepo.items())) + ")") if byrepo else ""))
|
||||
if ms.get("set_at"):
|
||||
print(" 標定於:%s" % ms["set_at"])
|
||||
if ms.get("refreshed_at"):
|
||||
print(" 最後更新:%s" % ms["refreshed_at"])
|
||||
print()
|
||||
print("📌 這是唯一答案——主線住在一個檔裡,那個檔放得下一條:%s" % ML.path())
|
||||
|
||||
|
||||
# ── list ─────────────────────────────────────────────────────────────────
|
||||
def cmd_list(argv):
|
||||
need_net()
|
||||
owner = argv[0] if argv else T.ORG
|
||||
rows = []
|
||||
for r in org_repos(owner):
|
||||
for m in (T.api_soft("/repos/%s/%s/milestones?state=open" % (owner, r)) or []):
|
||||
if not isinstance(m, dict):
|
||||
continue
|
||||
rows.append((owner, r, m))
|
||||
if not rows:
|
||||
die("🔴 一個 open milestone 都沒讀到——多半是拿不到 Gitea,不是真的沒有。\n"
|
||||
"(讀不到 ≠ 不存在。先修連線,不要因此標一個猜的主線。)", 1)
|
||||
now = datetime.now(timezone.utc)
|
||||
cur = ML.load()
|
||||
print("open milestone 共 %d 個(%s):\n" % (len(rows), owner))
|
||||
for o, r, m in sorted(rows, key=lambda x: (ML.due_of(x[2]) or datetime.max.replace(tzinfo=timezone.utc))):
|
||||
c, total, pct = ML.progress(m)
|
||||
mark = " ← 現在的主線" if cur and ML.ref_of(cur) == "%s/%s#%s" % (o, r, m.get("id")) else ""
|
||||
print(" %-28s %-24s %3d%% 期限 %s%s" % (
|
||||
"%s/%s#%s" % (o, r, m.get("id")), (m.get("title") or "")[:24],
|
||||
pct, ML.due_phrase(m, now), mark))
|
||||
print("\n📌 貼左邊那一欄:`scripts/mainline set <owner/repo#id>`")
|
||||
|
||||
|
||||
# ── set ──────────────────────────────────────────────────────────────────
|
||||
def cmd_set(argv):
|
||||
need_net()
|
||||
if not argv:
|
||||
die("用法:mainline set <owner/repo#milestone_id>")
|
||||
owner, repo, mid = parse_ms_ref(argv[0])
|
||||
m = fetch_milestone(owner, repo, mid)
|
||||
title = m.get("title")
|
||||
refs, scanned = collect_members(owner, title, repo)
|
||||
now = datetime.now(timezone.utc).astimezone().strftime("%Y-%m-%d %H:%M")
|
||||
ok = ML.save({
|
||||
"ref": "%s/%s#%d" % (owner, repo, mid),
|
||||
"owner": owner, "repo": repo, "id": mid,
|
||||
"title": title,
|
||||
"description": m.get("description") or "",
|
||||
"due_on": m.get("due_on") or "",
|
||||
"open_issues": m.get("open_issues") or 0,
|
||||
"closed_issues": m.get("closed_issues") or 0,
|
||||
"members": refs,
|
||||
"set_at": now, "refreshed_at": now,
|
||||
})
|
||||
if not ok:
|
||||
die("🔴 寫不進 %s——主線沒有被標上。" % ML.path())
|
||||
print("✅ 主線已標定:%s/%s#%d「%s」" % (owner, repo, mid, title))
|
||||
if scanned:
|
||||
print(" 跨 repo 收到同名 milestone 的票 %d 張:%s"
|
||||
% (len(refs), "、".join("%s %d" % (r, n) for r, n in scanned)))
|
||||
print()
|
||||
cmd_show([])
|
||||
|
||||
|
||||
def cmd_clear(argv):
|
||||
had = ML.load()
|
||||
ML.clear()
|
||||
print("✅ 已清掉主線%s。現在沒有主線——每回合的 🎯 那一行會照實說。"
|
||||
% ("(原本是 %s「%s」)" % (ML.ref_of(had), had.get("title")) if had else ""))
|
||||
|
||||
|
||||
# ── refresh ──────────────────────────────────────────────────────────────
|
||||
def cmd_refresh(argv):
|
||||
"""SessionStart 跑一次。**拿不到就原封不動**——寧可資料舊,不要把主線弄丟。"""
|
||||
ms = ML.load()
|
||||
if not ms:
|
||||
return # 沒有主線就沒有東西要更新,安靜結束
|
||||
d = T.api_soft("/repos/%s/%s/milestones/%s" % (ms["owner"], ms["repo"], ms["id"]))
|
||||
if not isinstance(d, dict) or not d.get("title"):
|
||||
return # 讀不到 ≠ 主線不存在
|
||||
ms.update({
|
||||
"title": d.get("title") or ms["title"],
|
||||
"description": d.get("description") or ms.get("description") or "",
|
||||
"due_on": d.get("due_on") or ms.get("due_on") or "",
|
||||
"open_issues": d.get("open_issues") or 0,
|
||||
"closed_issues": d.get("closed_issues") or 0,
|
||||
"refreshed_at": datetime.now(timezone.utc).astimezone().strftime("%Y-%m-%d %H:%M"),
|
||||
})
|
||||
if "--members" in argv:
|
||||
refs, _ = collect_members(ms["owner"], ms["title"], ms["repo"])
|
||||
if refs:
|
||||
ms["members"] = refs
|
||||
ML.save(ms)
|
||||
|
||||
|
||||
# ── adopt(補收)──────────────────────────────────────────────────────────
|
||||
def cmd_adopt(argv):
|
||||
need_net()
|
||||
if not argv:
|
||||
die("用法:mainline adopt <owner/repo#N>(把一張票掛進主線=「補收」)")
|
||||
ms = ML.load()
|
||||
if not ms:
|
||||
die("🔴 現在沒有主線,沒有東西可以補收進去。先 `scripts/mainline set …`。")
|
||||
owner, repo, num = T.parse_ref(argv[0])
|
||||
cands = [m for m in (T.api_soft("/repos/%s/%s/milestones?state=all" % (owner, repo)) or [])
|
||||
if isinstance(m, dict) and ML.norm(m.get("title")) == ML.norm(ms["title"])]
|
||||
if not cands:
|
||||
die("""🔴 `%s/%s` 底下沒有叫「%s」的 milestone,所以這張票掛不進去。
|
||||
|
||||
兩條路,**都要人決定,這支不會替你選**:
|
||||
· 這件事真的屬於主線 ⇒ 在 `%s/%s` 開一個同名 milestone(記得設真的期限,
|
||||
`milestone-due-guard.sh` 會擋沒期限的),再跑一次 adopt
|
||||
· 這件事其實是另一條線 ⇒ 那就是**跳線**,不是補收。直接重送派工
|
||||
(本閘同一張票只擋一次),並在回覆說清楚為什麼現在要岔開主線。""" % (
|
||||
owner, repo, ms["title"], owner, repo))
|
||||
mid = cands[0]["id"]
|
||||
T.api("/repos/%s/%s/issues/%d" % (owner, repo, num), {"milestone": mid}, method="PATCH")
|
||||
ref = "%s/%s#%d" % (owner, repo, num)
|
||||
ms["members"] = sorted(set(ms.get("members") or []) | {ref})
|
||||
ML.save(ms)
|
||||
print("✅ 補收:%s 已掛進「%s」(%s/%s#%d)" % (ref, ms["title"], owner, repo, mid))
|
||||
|
||||
|
||||
# ── has ──────────────────────────────────────────────────────────────────
|
||||
def cmd_has(argv):
|
||||
if not argv:
|
||||
die("用法:mainline has <owner/repo#N>")
|
||||
ms = ML.load()
|
||||
ref = argv[0].strip()
|
||||
if not ms:
|
||||
print("🎯 現在沒有主線 ⇒ 沒有「不屬於主線」這回事。")
|
||||
return
|
||||
v = ML.belongs(ref, ms)
|
||||
if v is None:
|
||||
owner, repo, num = T.parse_ref(ref)
|
||||
it = T.api_soft("/repos/%s/%s/issues/%d" % (owner, repo, num))
|
||||
title = ((it or {}).get("milestone") or {}).get("title") if isinstance(it, dict) else None
|
||||
v = ML.belongs(ref, ms, ticket_milestone_title=title or "")
|
||||
if not isinstance(it, dict):
|
||||
print("⚪ 讀不到 %s,判不出來(讀不到 ≠ 不屬於)。" % ref)
|
||||
sys.exit(0)
|
||||
if v:
|
||||
print("✅ %s 在主線「%s」上。" % (ref, ms["title"]))
|
||||
sys.exit(0)
|
||||
print("🚧 %s **不在**主線「%s」上。\n"
|
||||
" 補收 ⇒ `scripts/mainline adopt %s`;真的是插件事 ⇒ 那是跳線,說清楚再做。"
|
||||
% (ref, ms["title"], ref))
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
CMDS = {"show": cmd_show, "list": cmd_list, "set": cmd_set, "clear": cmd_clear,
|
||||
"refresh": cmd_refresh, "adopt": cmd_adopt, "has": cmd_has}
|
||||
|
||||
if __name__ == "__main__":
|
||||
# `mainline | head` 是很自然的用法,別讓它吐一段 BrokenPipe 的 traceback
|
||||
# ——那會讓人以為這支壞了。
|
||||
try:
|
||||
import signal
|
||||
signal.signal(signal.SIGPIPE, signal.SIG_DFL)
|
||||
except Exception:
|
||||
pass
|
||||
if len(sys.argv) < 2:
|
||||
cmd_show([])
|
||||
sys.exit(0)
|
||||
if sys.argv[1] in ("-h", "--help", "help"):
|
||||
print(__doc__)
|
||||
sys.exit(0)
|
||||
if sys.argv[1] not in CMDS:
|
||||
print(__doc__)
|
||||
sys.exit(2)
|
||||
CMDS[sys.argv[1]](sys.argv[2:])
|
||||
@@ -1,634 +0,0 @@
|
||||
#!/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()
|
||||
@@ -1,410 +0,0 @@
|
||||
#!/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()
|
||||
@@ -1,155 +0,0 @@
|
||||
#!/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 ]
|
||||
@@ -1,98 +0,0 @@
|
||||
#!/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