Compare commits
6 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| fed7258a30 | |||
| 4ba51b7b04 | |||
| 57219f3321 | |||
| 65120a1c65 | |||
| b5d501e9b8 | |||
| 354480901a |
@@ -8,7 +8,7 @@
|
|||||||
"plugins": [
|
"plugins": [
|
||||||
{
|
{
|
||||||
"name": "isep",
|
"name": "isep",
|
||||||
"description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源:61 支機械閘(84 條註冊,白話盤點見 docs/hooks-inventory.md)、7 支 slash command、2 支 skill、7 位有名字的工人(agents/,見 docs/governance/worker-roster.md)、49 支腳本,外加治理規範與標籤真相源。本機與雲端裝同一份,沒有子集。",
|
"description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源:61 支機械閘(85 條註冊,白話盤點見 docs/hooks-inventory.md)、7 支 slash command、2 支 skill、7 位有名字的工人(agents/,見 docs/governance/worker-roster.md)、54 支腳本,外加治理規範與標籤真相源。本機與雲端裝同一份,沒有子集。",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Leo",
|
"name": "Leo",
|
||||||
"url": "https://uncle6.me"
|
"url": "https://uncle6.me"
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "isep",
|
"name": "isep",
|
||||||
"description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源:61 支機械閘(84 條註冊,白話盤點見 docs/hooks-inventory.md)、7 支 slash command、2 支 skill、7 位有名字的工人(agents/,見 docs/governance/worker-roster.md)、49 支腳本,外加治理規範與標籤真相源。本機與雲端裝同一份,沒有子集。",
|
"description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源:61 支機械閘(85 條註冊,白話盤點見 docs/hooks-inventory.md)、7 支 slash command、2 支 skill、7 位有名字的工人(agents/,見 docs/governance/worker-roster.md)、54 支腳本,外加治理規範與標籤真相源。本機與雲端裝同一份,沒有子集。",
|
||||||
"version": "0.22.0",
|
"version": "0.23.0",
|
||||||
"keywords": [
|
"keywords": [
|
||||||
"inkstone",
|
"inkstone",
|
||||||
"guardrails",
|
"guardrails",
|
||||||
|
|||||||
@@ -23,11 +23,11 @@
|
|||||||
|
|
||||||
| | 數量 | 是什麼 |
|
| | 數量 | 是什麼 |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| `hooks/` | 61 支 + `hooks.json` | 全部機械閘(PreToolUse/Stop/SubagentStop/SessionStart/PostToolUse/UserPromptSubmit 共 84 條註冊)。**一支一行的白話盤點在 `docs/hooks-inventory.md`,那裡才是這兩個數字的家** |
|
| `hooks/` | 61 支 + `hooks.json` | 全部機械閘(PreToolUse/Stop/SubagentStop/SessionStart/PostToolUse/UserPromptSubmit 共 85 條註冊)。**一支一行的白話盤點在 `docs/hooks-inventory.md`,那裡才是這兩個數字的家** |
|
||||||
| `agents/` | 7 位 | **工人名單**(`inkstone/ISEP#86`)——派工時指名派給誰,規約見 `docs/governance/worker-roster.md` |
|
| `agents/` | 7 位 | **工人名單**(`inkstone/ISEP#86`)——派工時指名派給誰,規約見 `docs/governance/worker-roster.md` |
|
||||||
| `commands/` | 7 支 | `/wiki-recall` `/wiki-capture` `/cp-write` `/issue-handle` … |
|
| `commands/` | 7 支 | `/wiki-recall` `/wiki-capture` `/cp-write` `/issue-handle` … |
|
||||||
| `skills/` | 2 支 | `ship-check`(東西要出去之前)/`deep-recall`(把散落的枝葉還原成一棵樹)。🔴 **這兩支的內容不一定是在這裡寫的**——誰是真相源查 `docs/file-ownership.tsv` |
|
| `skills/` | 2 支 | `ship-check`(東西要出去之前)/`deep-recall`(把散落的枝葉還原成一棵樹)。🔴 **這兩支的內容不一定是在這裡寫的**——誰是真相源查 `docs/file-ownership.tsv` |
|
||||||
| `scripts/` | 49 支 | `ticket`/`roster`/`isep-nag`/`wiki-compress`/`github-arm.sh` …(頂層檔案,不含 `lib/` 等子目錄) |
|
| `scripts/` | 54 支 | `ticket`/`roster`/`isep-nag`/`wiki-compress`/`github-arm.sh` …(頂層檔案,不含 `lib/` 等子目錄) |
|
||||||
|
|
||||||
> 🔴 這五個數字**每次都要在自己的樹上實數**,不准沿用上一版、也不准用加減推
|
> 🔴 這五個數字**每次都要在自己的樹上實數**,不准沿用上一版、也不准用加減推
|
||||||
> (`system-dev/wiki/mistakes.md`:那是 leo 的驗收介面,多報就是假綠):
|
> (`system-dev/wiki/mistakes.md`:那是 leo 的驗收介面,多報就是假綠):
|
||||||
|
|||||||
+162
@@ -419,6 +419,47 @@ bash hooks/tests/gitea-arm-check.test.sh .
|
|||||||
- ①③⑤⑥ 任一紅 ⇒ 收手收得太晚,暫存區已經開始長東西(磁碟風險回來了)
|
- ①③⑤⑥ 任一紅 ⇒ 收手收得太晚,暫存區已經開始長東西(磁碟風險回來了)
|
||||||
- ② 紅 ⇒ 訊息沒給出走得通的那一行(本票整張票在講的就是這件事)
|
- ② 紅 ⇒ 訊息沒給出走得通的那一行(本票整張票在講的就是這件事)
|
||||||
- ⑧⑨⑩ 任一紅 ⇒ **誤攔/複製錯**:正常用法被弄壞,或複本裡混進了 `hooks/` 以外的東西
|
- ⑧⑨⑩ 任一紅 ⇒ **誤攔/複製錯**:正常用法被弄壞,或複本裡混進了 `hooks/` 以外的東西
|
||||||
|
### A31 — 雲端工人抓票的規則是機械可判的:48 條
|
||||||
|
```
|
||||||
|
bash scripts/test-ticket-pick.sh
|
||||||
|
```
|
||||||
|
**該看到**:`通過 48 條,失敗 0 條`。**全程離線**:假池子(3 個 repo、3 個 open milestone、
|
||||||
|
11 張票)餵給換掉的 `api()`,時鐘走 `ISEP_COUNTDOWN_NOW`,`TICKET_HOST` 指到連不上的位址
|
||||||
|
——任何一條真的走到網路會當場炸,不會靜靜變成假綠。**不開票、不改票、不留任何東西在 Gitea 上。**
|
||||||
|
|
||||||
|
**它在守什麼**(`inkstone/ISEP#131`):Routine 08-06 起讀 `journeys.md` 本 sprint 段,
|
||||||
|
08-19 到期沒續,**連續兩週讀到殘骸只能空轉**。09-07 把 `cloud-worker.md` 步驟 1 改成從
|
||||||
|
Gitea 主線里程碑抓票(`inkstone/InkStoneCo#118`),但那是一段給人讀的字。
|
||||||
|
這一支把規則做成 `scripts/ticket pick`/`claim` 兩個動詞,規則本體在 `pickable()` 一支純函式:
|
||||||
|
|
||||||
|
```
|
||||||
|
可抓 s/* 恰好是 {s/todo} + 沒有 assignee + 沒有 Human/human/* + 不是 hub + 里程碑=主線
|
||||||
|
主線抓盡才抓「逾期的 open 里程碑」;backlog/沒里程碑一律不抓
|
||||||
|
認領 claim = 指派 + s/doing + 第一行【身份】的留言,一個動作
|
||||||
|
完成 handback --label s/review(本來就有的那半,不重做)
|
||||||
|
```
|
||||||
|
|
||||||
|
**失敗**:
|
||||||
|
- ①「★」那四條任一紅 ⇒ 票上驗收第 1 條破了:Human/有 assignee/backlog 有一種會被抓走
|
||||||
|
- ①「s/todo+s/doing 同時掛著」紅 ⇒ 會把別人正在做的票抓走(09-07 實查 `inkstone/mira#6`
|
||||||
|
就是這個形狀——exclusive 只擋 UI 不擋 API)
|
||||||
|
- ②「主線抓盡 → 才輪到逾期」那兩條紅 ⇒ 順序壞了:要嘛主線還有票就去抓逾期的,
|
||||||
|
要嘛抓盡了還回 `Arcrun#8`(既不是主線也沒逾期)
|
||||||
|
- ②「離開碼 1」紅 ⇒ 「真的沒有票」與「讀不到」被講成同一句——後者要離開碼 2
|
||||||
|
- ②「沒有主線 → 離開碼 2 且一通 API 都沒打」紅 ⇒ 沒主線時去抓了別的
|
||||||
|
- ③「該擋」六條任一紅 ⇒ 規則只長在 `pick` 這端,手動 `claim` 一張 Human 的票照樣過
|
||||||
|
- ③「身份名不在名單上 → 一通都沒打」紅 ⇒ 名單以外的名字碰到了 Gitea
|
||||||
|
- ④ 第一條紅 ⇒ 連不上 Gitea 時回了離開碼 1,雲端會把「斷線」當「沒票」收工
|
||||||
|
|
||||||
|
📌 **真實 Gitea 唯讀實跑**(2026-09-07,isep-hand,不改任何票):
|
||||||
|
`ticket pick --mainline InkStoneCo/system-dev/mainline.json --all` 在主線
|
||||||
|
「AI 問一次就看得到全部」回 `ISEP#130`、`ISEP#131` 兩張(`Arcrun#175/176` 已有 assignee、
|
||||||
|
`Arcrun#86` 是 s/doing、`mira#6` s/todo+s/doing 都沒被抓);逾期里程碑組把 `ISEP#31–35`
|
||||||
|
五張 `hub` 排除後剩 `Arcrun#83`、`mira#5`、`arcrun-rag#14/27/37`。
|
||||||
|
**寫入那半**用 `claim inkstone/ISEP#131 --name isep-hand` 真的認領過一次:
|
||||||
|
assignee=`claude-code`、標籤 `s/todo → s/doing`、留言 6325 第一行【身份】——
|
||||||
|
之後再 `pick` 就不再回 #131(票上驗收第 2 條的 log 在票的留言裡)。
|
||||||
|
|
||||||
### A19 — 下游做完時頂層跟著關:49 條
|
### A19 — 下游做完時頂層跟著關:49 條
|
||||||
```
|
```
|
||||||
bash scripts/test-ticket-handoff-writeback.sh
|
bash scripts/test-ticket-handoff-writeback.sh
|
||||||
@@ -678,6 +719,109 @@ B 段拿這台機器真正的 `.env` 對帳——**`.env` 不在的機器(雲
|
|||||||
> ```
|
> ```
|
||||||
> ⇒ 第二條正是黑名單會放過去的形狀。
|
> ⇒ 第二條正是黑名單會放過去的形狀。
|
||||||
|
|
||||||
|
### A31 — leo21c 讀可以、寫不行,而且改法指到活著的 youlin:26 條
|
||||||
|
```
|
||||||
|
bash hooks/tests/leo21c-write-guard.test.sh
|
||||||
|
```
|
||||||
|
**該看到**:`通過 26 條,失敗 0 條`。全程離線,這支閘不寫檔,直接跑真跡。
|
||||||
|
|
||||||
|
**它在守什麼**(inkstone/ISEP#130,2026-09-04 雲端 run log):`leo21c-write-guard.sh`
|
||||||
|
**連讀都擋**——Routine 讀 `notify_leo` 定義那一條被攔下,雲端於是什麼都拿不到。
|
||||||
|
實查:舊判準 `-d[[:space:]]` 把 `| tr -d '\r'`、`cut -d=` 這種唯讀的 `-d` 當成 curl 的 body;
|
||||||
|
`prod-write-guard.sh` 在 08-12 就修過同一個洞,這支漏了。另外它把 `notify_leo` 的 trigger
|
||||||
|
一律當寫入擋,而 `prod-write-guard.sh` 從 ISEP#63 起就放行它——**兩支閘對同一條指令說不同的話**。
|
||||||
|
這支之前**沒有任何測試**,「讀會不會被誤攔」從來沒被驗過。
|
||||||
|
|
||||||
|
測資是 Routine 文件(`cloud-worker.md`/`progress-guard.md`)裡**真的會下的那幾條**。
|
||||||
|
|
||||||
|
**失敗**:
|
||||||
|
- A 群任一紅 ⇒ **誤攔**,雲端又回到「連讀都讀不到」;③④⑤ 紅就是 09-04 那個形狀復發
|
||||||
|
- ⑫ 紅 ⇒ 撞人閘時發 Telegram 叫 leo 又會被擋(inkstone/InkStoneCo#110 的病)
|
||||||
|
- B 群任一紅 ⇒ 寫得進 leo 的真庫(2026-08-20 那 8 張測試卡的病)。⑬ 特別看:
|
||||||
|
Routine 的心跳 POST **就是寫入**,它該被擋——那條指令要改,不是閘要放
|
||||||
|
- ㉔㉕ 紅 ⇒ 閘印的「改法」教人打 09-02 起 DNS 已不存在的舊子網域,照著做只會拿到 000
|
||||||
|
|
||||||
|
**修之前用同一份測試跑舊閘(`git show main:hooks/leo21c-write-guard.sh`)**:③⑤⑫㉔㉕ 五條紅
|
||||||
|
——證明這五格是真的改到了,不是測試順著新閘寫的。
|
||||||
|
|
||||||
|
### A32 — 主線那個檔隨 repo 走:17 條
|
||||||
|
```
|
||||||
|
bash hooks/tests/mainline-repo-mirror.test.sh
|
||||||
|
```
|
||||||
|
**該看到**:`通過 17 條,失敗 0 條`。全程離線:家目錄那份走 `ISEP_COUNTDOWN_STATE_DIR`、
|
||||||
|
repo 那份走 TMP 底下的假 `InkStoneCo/system-dev/`。
|
||||||
|
|
||||||
|
**它在守什麼**(inkstone/ISEP#130;leo 09-05「routine 每天早上開啟後抓不到任務」):
|
||||||
|
主線只住在家目錄,雲端是另一台機器 ⇒ 不知道主線是哪條。PR inkstone/InkStoneCo#118
|
||||||
|
把它放進 `system-dev/mainline.json`,這裡驗 ISEP 這一半:**家目錄沒有就讀 repo 那份;
|
||||||
|
兩份都在 `set_at` 較新的算數;`set`/`adopt`/`clear` 兩份一起動;`refresh` 只寫家目錄。**
|
||||||
|
|
||||||
|
**失敗**:
|
||||||
|
- ①②③ 紅 ⇒ 雲端(`$CLAUDE_PROJECT_DIR` 是薄殼根、真身在 `InkStoneCo/`)仍然讀不到主線
|
||||||
|
- ⑤⑥ 紅 ⇒ 誰後標的誰算數這條壞了:本機會把雲端剛標的蓋回去,或反過來
|
||||||
|
- ⑧ 紅 ⇒ **每開一個 session InkStoneCo 的工作樹就髒一次**,而髒的 diff 沒有人會去 commit
|
||||||
|
- ⑫ 紅 ⇒ `clear` 之後下一次讀又從 repo 那份長回來
|
||||||
|
- ⑮ 紅 ⇒ ISEP#82 第 4 條(沒有主線不能整組壞掉)被本票弄壞
|
||||||
|
|
||||||
|
雲端實跑(2026-09-07,本 session):`CLAUDE_PROJECT_DIR=/home/user/inkstoneco
|
||||||
|
ISEP_COUNTDOWN_STATE_DIR=$(mktemp -d) python3 scripts/mainline` → 印出
|
||||||
|
`🎯 現在的主線:inkstone/Arcrun#48「AI 問一次就看得到全部…」`——家目錄空的,只靠 repo 那份。
|
||||||
|
|
||||||
|
### A33 — 權限白名單住 ISEP 一份、兩台各自寫進家目錄:19 條
|
||||||
|
```
|
||||||
|
bash scripts/test-settings-allow-sync.sh
|
||||||
|
```
|
||||||
|
**該看到**:`19/19 通過`。全程在 TMP 底下的假 `settings.json` 上跑,不碰真的 `~/.claude/settings.json`。
|
||||||
|
|
||||||
|
**它在守什麼**(inkstone/ISEP#130 → comment 6120/6121):leo 09-07 親手加進本機
|
||||||
|
`InkStoneCo/.claude/settings.json` 的四條(`ticket`/`mainline`/`gate-ok`/`gitea-pr-merge`)
|
||||||
|
雲端沒有 ⇒ 同樣動作被分類器擋(09-04 `permission_denials=6`)。雲端真正讀的薄殼 repo
|
||||||
|
要 D20 開閘才推得動 ⇒ 清單住 ISEP `docs/permissions-allow.json`,`scripts/settings-allow-sync`
|
||||||
|
在那台機器上寫進 `~/.claude/settings.json`:雲端由 `docs/cloud-setup-script.sh` 裝完 plugin 跑一次、
|
||||||
|
之後每個 SessionStart 再對一次;本機同一支。
|
||||||
|
|
||||||
|
**失敗**:
|
||||||
|
- A1 紅 ⇒ 清單裡混進了整類放行(`Bash(python3 *)`)或少了正門工具
|
||||||
|
- B3/B4 紅 ⇒ `~` 沒換成那台的家目錄——雲端是 `/root` 不是 `/Users/youlinhsieh`,規則會對不上
|
||||||
|
- B7 紅 ⇒ 不冪等,每個 session 都改一次 settings.json
|
||||||
|
- **C1 紅 ⇒ 動到了別人手加的規則**。這支只准加不准減
|
||||||
|
- E1 紅 ⇒ 目標壞掉時炸了——它掛在 SessionStart,炸了 session 就沒閘
|
||||||
|
- F1/F2 紅 ⇒ 沒接線:清單對了但沒人會去跑它
|
||||||
|
|
||||||
|
⚠️ **這支驗不了「分類器真的不擋」**——那要在雲端一趟 run 裡看 `permission_denials`。
|
||||||
|
規則的形狀(`Bash(python3 …/isep/*/scripts/ticket *)`)沿用 leo 09-07 親手加、實測有效的那四條。
|
||||||
|
|
||||||
|
### A34 — 收件 repo 寫 `owner/repo` 不該是 404:7 條
|
||||||
|
```
|
||||||
|
bash scripts/test-ticket-repo-arg.sh
|
||||||
|
```
|
||||||
|
**該看到**:`通過 7 條,失敗 0 條`。把 `scripts/ticket` 當模組載進來、`api()` 換成只記路徑的假貨——
|
||||||
|
不打 Gitea、不開票、不留戳記。
|
||||||
|
|
||||||
|
**它在守什麼**(inkstone/ISEP#130 → comment 6120 第 2 件):09-07 `ticket new inkstone/ISEP`
|
||||||
|
回 404。不是 ISEP 不存在,是 `inkstone/ISEP` 被原樣塞進 `/repos/inkstone/{repo}/issues`
|
||||||
|
⇒ 打到 `/repos/inkstone/inkstone/ISEP/issues`。**正門壞了人就走側門**——那天四張票是直接打 API 開的。
|
||||||
|
|
||||||
|
**失敗**:② 紅 ⇒ 那個 404 復發;③ 紅 ⇒ 寫錯 org 又變成一個要人猜的 404;⑦ 紅 ⇒ 路徑裡出現 `inkstone/inkstone`。
|
||||||
|
|
||||||
|
### A35 — 雲端唯一通的通知路(Bot API 直送):10 條
|
||||||
|
```
|
||||||
|
bash scripts/test-isep-notify-botapi.sh
|
||||||
|
```
|
||||||
|
**該看到**:`10/10 通過`。Bot API 指到本機一個假伺服器、實例那條也指到它——不打真 Telegram、不打實例。
|
||||||
|
|
||||||
|
**它在守什麼**(inkstone/ISEP#130,2026-09-07 從雲端實測):
|
||||||
|
```
|
||||||
|
notify_leo @ leo21c → HTTP 404「找不到 workflow」(08-28 起就斷;修它是 leo 的人閘)
|
||||||
|
notify_leo @ youlin → 雲端 egress proxy 回 403(policy denial;要 leo 在 Cloud environment 放行主機)
|
||||||
|
api.telegram.org → 302,通
|
||||||
|
```
|
||||||
|
⇒ 雲端唯一走得通的是 Bot API 直送,只缺 `TELEGRAM_BOT_TOKEN`/`TELEGRAM_CHAT_ID` 兩個環境變數。
|
||||||
|
有就先走它(不碰實例,閘管不到也不必管);沒有要**點名缺哪兩個**,不能靜默。
|
||||||
|
|
||||||
|
**失敗**:A1 紅 ⇒ 沒憑證時不講缺什麼,leo 不知道要在 Cloud environment 加哪兩個;
|
||||||
|
B3 紅 ⇒ 送到了還去打實例;C1 紅 ⇒ 401 被講成送到;D1 紅 ⇒ 舊版閘 block 時直送也被連坐。
|
||||||
|
|
||||||
### A5 — 開票前的搜尋是跨 repo 的
|
### A5 — 開票前的搜尋是跨 repo 的
|
||||||
```
|
```
|
||||||
python3 scripts/ticket where 標籤 模組化
|
python3 scripts/ticket where 標籤 模組化
|
||||||
@@ -953,7 +1097,13 @@ B2(信標那行)/B3(setup 輸出)/B4(閘的訊息)三個畫面
|
|||||||
| **A17 未推警察不誤攔雲端分支** | 總管 | ✅ 10/10(2026-08-28,inkstone/ISEP#90) |
|
| **A17 未推警察不誤攔雲端分支** | 總管 | ✅ 10/10(2026-08-28,inkstone/ISEP#90) |
|
||||||
| **A18 信標會報雲端接線缺陷** | 總管 | ✅ 14/14(2026-08-28,inkstone/ISEP#90) |
|
| **A18 信標會報雲端接線缺陷** | 總管 | ✅ 14/14(2026-08-28,inkstone/ISEP#90) |
|
||||||
| **A19 下游做完頂層跟著關** | 總管 | ✅ 49/49(2026-08-28,inkstone/ISEP#92) |
|
| **A19 下游做完頂層跟著關** | 總管 | ✅ 49/49(2026-08-28,inkstone/ISEP#92) |
|
||||||
|
| **A31 雲端工人抓票規則機械可判** | isep-hand | ✅ 48/48(2026-09-07,inkstone/ISEP#131)+真實 Gitea 唯讀實跑+一次真認領 |
|
||||||
| **A20 舊票有固定管道被撈** | 總管 | ✅ 47/47(2026-08-28,inkstone/ISEP#83)+真實 229 張唯讀實跑 |
|
| **A20 舊票有固定管道被撈** | 總管 | ✅ 47/47(2026-08-28,inkstone/ISEP#83)+真實 229 張唯讀實跑 |
|
||||||
|
| **A31 leo21c 讀放寫擋+改法指活的 youlin** | isep-hand | ✅ 26/26(2026-09-07,inkstone/ISEP#130)+舊閘實跑 5 條紅 |
|
||||||
|
| **A32 主線檔隨 repo 走** | isep-hand | ✅ 17/17(2026-09-07,inkstone/ISEP#130)+雲端 session 實跑讀到主線 |
|
||||||
|
| **A33 權限白名單住 ISEP 一份** | isep-hand | ✅ 19/19(2026-09-07,inkstone/ISEP#130);「分類器真的不擋」要雲端 run 的 `permission_denials` 才驗得到 |
|
||||||
|
| **A34 收件 repo 寫 owner/repo 不 404** | isep-hand | ✅ 7/7(2026-09-07,inkstone/ISEP#130) |
|
||||||
|
| **A35 Bot API 直送** | isep-hand | ✅ 10/10(2026-09-07);**真的到 leo 手機**要 Cloud environment 先有 `TELEGRAM_BOT_TOKEN`/`TELEGRAM_CHAT_ID`(leo) |
|
||||||
| A7 plugin 裝得起來 | 總管 | ✅ |
|
| A7 plugin 裝得起來 | 總管 | ✅ |
|
||||||
| **A8 新 session 閘會觸發** | 總管 | 見本版 release note |
|
| **A8 新 session 閘會觸發** | 總管 | 見本版 release note |
|
||||||
| **B1–B5 雲端** | **leo** | 還沒跑(機器碰不到 Cloud environment) |
|
| **B1–B5 雲端** | **leo** | 還沒跑(機器碰不到 Cloud environment) |
|
||||||
@@ -998,3 +1148,15 @@ arcrun_search_workflows(通知 leo Telegram) → 只回 ship_refresh_cdn 一
|
|||||||
(`#issuecomment-5182`、`#issuecomment-5184`),並把原文印在眼前。
|
(`#issuecomment-5182`、`#issuecomment-5184`),並把原文印在眼前。
|
||||||
**發不出去而靜默,等於沒做;發不出去但講出來並留下退路,就是這支的規格。**
|
**發不出去而靜默,等於沒做;發不出去但講出來並留下退路,就是這支的規格。**
|
||||||
通道修好之後不必改任何程式碼,重跑 `python3 scripts/isep-nag --notify` 即可補驗這一格。
|
通道修好之後不必改任何程式碼,重跑 `python3 scripts/isep-nag --notify` 即可補驗這一格。
|
||||||
|
|
||||||
|
### 2026-09-07 從雲端 session 再量一次(inkstone/ISEP#130)
|
||||||
|
|
||||||
|
| 路 | 結果 | 誰能修 |
|
||||||
|
|---|---|---|
|
||||||
|
| `notify_leo` @ leo21c(`…/webhooks/named/leo/notify_leo`) | **HTTP 404**,跟 08-28 一樣 | leo(leo21c 寫入是人閘) |
|
||||||
|
| `notify_leo` @ youlin(`*.arcrun-yuga3bse.workers.dev`) | **連不到:egress proxy 對 CONNECT 回 403**(`/__agentproxy/status` 記為 policy denial)。不是 DNS、不是 000 | leo(Cloud environment 的 allowed network hosts) |
|
||||||
|
| `api.telegram.org` | **302,通** | — |
|
||||||
|
|
||||||
|
⇒ 雲端能走的只有 Bot API 直送(`scripts/isep-notify` 現在會先試它),缺的只是兩個環境變數
|
||||||
|
`TELEGRAM_BOT_TOKEN`/`TELEGRAM_CHAT_ID`——Routine 文件 `cloud-worker.md` 檔頭本來就列著它們,
|
||||||
|
只是這個 environment 沒有。**這一格仍然是 leo 的:加變數,然後回一個詞。**
|
||||||
|
|||||||
@@ -160,6 +160,52 @@ GitHub、不是 Gitea):
|
|||||||
驗 `claude plugin list` 顯示 `isep@inkstone enabled`,且照 §逐條對照 那張表
|
驗 `claude plugin list` 顯示 `isep@inkstone enabled`,且照 §逐條對照 那張表
|
||||||
再核一次數字。
|
再核一次數字。
|
||||||
|
|
||||||
|
## 雲端要全權處理的三樣:票、主線、通知(inkstone/ISEP#130,2026-09-07)
|
||||||
|
|
||||||
|
leo 09-07:「雲端回覆的問題你首要解決⋯⋯僅有需要依賴 Mac 環境的東西要求地端處理,其他全部需要可以從雲端全權處理。」
|
||||||
|
09-04 兩支 Routine 的 run log 實查出四件雲端拿不到的東西,ISEP 這一半的解法:
|
||||||
|
|
||||||
|
| 拿不到什麼 | 為什麼 | ISEP 這一半 | 還缺誰 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| **主線是哪條** | 主線檔只在本機 `~/.claude` | `hooks/lib/mainline.py`:家目錄沒有就讀 repo 的 `InkStoneCo/system-dev/mainline.json`(雲端形狀:`$CLAUDE_PROJECT_DIR` 是薄殼根、真身在 `InkStoneCo/`);`mainline set`/`adopt`/`clear` 兩份一起寫 | 總管 `set` 之後要把 repo 那份 commit/併 main |
|
||||||
|
| **正門工具被分類器擋**(`permission_denials=6`) | leo 09-07 親手加的四條只在本機 settings | `docs/permissions-allow.json` 一份清單;`scripts/settings-allow-sync` 寫進那台的 `~/.claude/settings.json`(setup script 裝完 plugin 跑一次,SessionStart 每次再對一次) | 雲端一趟 run 看 `permission_denials`=0 才算驗到 |
|
||||||
|
| **讀 leo21c 也被擋** | `leo21c-write-guard.sh` 把 `tr -d` 的 `-d` 當 body | 唯讀 `-d` 先剪掉再判;`notify_leo` trigger 放行(同 `prod-write-guard` 白名單);改法段改印現役 youlin 子網域 | — |
|
||||||
|
| **收工摘要到不了手機** | 雲端沒 `TELEGRAM_*`;leo21c 的 `notify_leo` 404;youlin 被 egress proxy 擋 | `scripts/isep-notify` 有 `TELEGRAM_BOT_TOKEN`/`TELEGRAM_CHAT_ID` 就先走 Bot API 直送(`api.telegram.org` 從雲端是通的) | **leo**:在 Cloud environment 加那兩個變數 |
|
||||||
|
|
||||||
|
### 雲端連不到 youlin 不是 000,是 proxy 403(2026-09-07 實查)
|
||||||
|
|
||||||
|
```
|
||||||
|
$ curl -sS -o /dev/null -w '%{http_code}' https://arcrun-cypher-executor.arcrun-yuga3bse.workers.dev/health
|
||||||
|
curl: (56) CONNECT tunnel failed, response 403 ← egress policy denial
|
||||||
|
$ curl -sS "$HTTPS_PROXY/__agentproxy/status" | jq .recentRelayFailures
|
||||||
|
{ "kind": "connect_rejected", "host": "arcrun-cypher-executor.arcrun-yuga3bse.workers.dev:443",
|
||||||
|
"detail": "gateway answered 403 to CONNECT (policy denial or upstream failure)" }
|
||||||
|
$ curl … https://arcrun-cypher-executor.leo21c.workers.dev/health → 200
|
||||||
|
$ curl … https://api.telegram.org/ → 302
|
||||||
|
$ curl … https://git.uncle6.me/api/v1/version → 200
|
||||||
|
```
|
||||||
|
|
||||||
|
⇒ 09-04 log 寫的「youlin 從雲端 HTTP 000」有兩層:舊子網域 `youlin-hsieh-dev` DNS 已死(總管 09-07 查到),
|
||||||
|
**而新子網域從雲端是被 policy 擋**——`/root/.ccr/README.md` 明寫「403/407 = 你組織的 egress policy
|
||||||
|
不允許這個主機,不要重試、不要繞路,回報主機名」。leo21c 通、youlin 不通,差別只在主機有沒有被放行。
|
||||||
|
**這格是 leo 的**:Cloud environment 的 allowed network hosts 加 `*.arcrun-yuga3bse.workers.dev`;
|
||||||
|
在那之前雲端做不了 stage 驗證,所有要打 youlin 的驗證一律交回地端或標 `Human`。
|
||||||
|
|
||||||
|
### 只有「要 Mac」的事才交回地端(給 `cloud-worker.md` 的清單草稿)
|
||||||
|
|
||||||
|
判準一句話:**這件事依賴的東西隨 repo clone 走得到嗎?走得到就雲端做。**
|
||||||
|
|
||||||
|
| 交回地端 | 為什麼雲端做不了 |
|
||||||
|
|---|---|
|
||||||
|
| 打包 DMG/簽章/MS Store 送件 | 要 macOS 工具鏈與簽章身分(Keychain),不隨 clone 走 |
|
||||||
|
| 本機 daemon(`~/.arcrun-rag`、`~/.arcrun/config.yaml`)的改與驗 | 住在 leo 的家目錄 |
|
||||||
|
| 用 `~/.wrangler` OAuth 登入態出貨到 uncle6 | 登入態不隨 clone 走(`make-cloud-env.sh` 檔頭記過) |
|
||||||
|
| 要 leo 親手輸入的互動閘(`acr recipe push` 的暴露同意、密碼打進登入欄) | surface 層硬規則,誰都不能代 |
|
||||||
|
| 打 youlin stage 的驗證 | **暫時**:egress proxy 擋(上一段)。leo 放行主機後這條就回到雲端 |
|
||||||
|
|
||||||
|
其餘(讀票、認領、留言、handback、寫 code、跑測試、開 PR、對 leo21c 唯讀查詢、發 Telegram)雲端全做。
|
||||||
|
📌 這份清單的家是 `inkstone/InkStoneCo` 的 `cloud-worker.md`(票上驗收第 4 條),ISEP 只放草稿;併進去由總管做。
|
||||||
|
|
||||||
## 這張票沒動、也不會動的東西
|
## 這張票沒動、也不會動的東西
|
||||||
|
|
||||||
- 沒有動 `youlinhsieh/inkstoneco`(GitHub 薄殼 repo)——這個新機制**完全不需要
|
- 沒有動 `youlinhsieh/inkstoneco`(GitHub 薄殼 repo)——這個新機制**完全不需要
|
||||||
|
|||||||
@@ -28,6 +28,17 @@ set -uo pipefail
|
|||||||
claude plugin marketplace add https://git.uncle6.me/inkstone/ISEP.git --scope user 2>&1 || true
|
claude plugin marketplace add https://git.uncle6.me/inkstone/ISEP.git --scope user 2>&1 || true
|
||||||
claude plugin install isep@inkstone --scope user 2>&1 || true
|
claude plugin install isep@inkstone --scope user 2>&1 || true
|
||||||
|
|
||||||
|
# 🔴 權限白名單(inkstone/ISEP#130):四個 Gitea 正門工具(ticket/mainline/gate-ok/gitea-pr-merge)
|
||||||
|
# 要進這台的 ~/.claude/settings.json,auto mode 的分類器才不擋(09-04 run log:permission_denials=6)。
|
||||||
|
# 清單住 ISEP `docs/permissions-allow.json` 一份,本機與雲端都由同一支腳本寫——薄殼 repo 不再各養一份。
|
||||||
|
# plugin 快取的路徑帶版本號,挑最新的那份跑;沒裝成也不擋門,SessionStart 會再對一次。
|
||||||
|
ISEP_DIR=$(ls -d "$HOME"/.claude/plugins/cache/inkstone/isep/*/ 2>/dev/null | sort -V | tail -1)
|
||||||
|
if [ -n "$ISEP_DIR" ] && [ -f "$ISEP_DIR/scripts/settings-allow-sync" ]; then
|
||||||
|
python3 "$ISEP_DIR/scripts/settings-allow-sync" 2>&1 || true
|
||||||
|
else
|
||||||
|
echo "⚠️ 找不到裝好的 ISEP,白名單沒寫進 ~/.claude/settings.json——session 開頭 SessionStart 會再試一次。"
|
||||||
|
fi
|
||||||
|
|
||||||
if claude plugin marketplace list 2>/dev/null | grep -q "inkstone"; then
|
if claude plugin marketplace list 2>/dev/null | grep -q "inkstone"; then
|
||||||
echo "✅ marketplace inkstone 已就位"
|
echo "✅ marketplace inkstone 已就位"
|
||||||
else
|
else
|
||||||
|
|||||||
+13
-5
@@ -7,14 +7,14 @@
|
|||||||
|
|
||||||
## 一句話結論
|
## 一句話結論
|
||||||
|
|
||||||
`hooks/` 底下有 **61 個 `.sh` 檔**,`hooks.json` 實際掛上 **84 條註冊**(同一支閘常被多種情境同時掛上);
|
`hooks/` 底下有 **61 個 `.sh` 檔**,`hooks.json` 實際掛上 **85 條註冊**(同一支閘常被多種情境同時掛上);
|
||||||
其中 **3 支檔案存在但沒被掛上**(2 支是待人填的空範本、1 支是刻意留著沒開的止血帶,見下面「未生效」表)。
|
其中 **3 支檔案存在但沒被掛上**(2 支是待人填的空範本、1 支是刻意留著沒開的止血帶,見下面「未生效」表)。
|
||||||
下面按「你會在什麼時候撞到它」分組,一支一行。
|
下面按「你會在什麼時候撞到它」分組,一支一行。
|
||||||
|
|
||||||
> 🔴 **這兩個數字上一版是錯的(2026-08-26 實際數過才發現)**:本頁原本寫「43 個檔、53 條註冊」,
|
> 🔴 **這兩個數字上一版是錯的(2026-08-26 實際數過才發現)**:本頁原本寫「43 個檔、53 條註冊」,
|
||||||
> 而當時真實是 **45 個檔、55 條註冊**——中間有兩支閘進來時沒有回頭改這裡。
|
> 而當時真實是 **45 個檔、55 條註冊**——中間有兩支閘進來時沒有回頭改這裡。
|
||||||
> 現在的寫法是實際數出來的:
|
> 現在的寫法是實際數出來的:
|
||||||
> `ls hooks/*.sh | wc -l` = 61;`grep -c '"command":' hooks/hooks.json` = 84。
|
> `ls hooks/*.sh | wc -l` = 61;`grep -c '"command":' hooks/hooks.json` = 85。
|
||||||
> ⚠️ **冒號不能省**:`grep -c '"command"'`(沒冒號)會連 `"type": "command"` 一起數到,回 **120**。
|
> ⚠️ **冒號不能省**:`grep -c '"command"'`(沒冒號)會連 `"type": "command"` 一起數到,回 **120**。
|
||||||
> 本頁 2026-08-27 之前寫的是沒冒號那版——**照著它跑會拿到一個跟本頁不符的數字**。
|
> 本頁 2026-08-27 之前寫的是沒冒號那版——**照著它跑會拿到一個跟本頁不符的數字**。
|
||||||
> **一份會偷偷過期的盤點表,跟沒有盤點表差不多**——見本頁最後「怎麼跟實況對帳」那段。
|
> **一份會偷偷過期的盤點表,跟沒有盤點表差不多**——見本頁最後「怎麼跟實況對帳」那段。
|
||||||
@@ -32,6 +32,13 @@
|
|||||||
> **兩個事件是同一件事的兩半**:只注入 = 又一個會被忽略的提醒;只查核 = 罰它做一件拿不到資料的事。
|
> **兩個事件是同一件事的兩半**:只注入 = 又一個會被忽略的提醒;只查核 = 罰它做一件拿不到資料的事。
|
||||||
> 這兩個數字是併之前當場數出來的,不是從上一版加減推出來的。
|
> 這兩個數字是併之前當場數出來的,不是從上一版加減推出來的。
|
||||||
|
|
||||||
|
> 📌 **`inkstone/ISEP#130`(2026-09-07)+0 支、+1 條**:SessionStart 多掛一條
|
||||||
|
> `scripts/settings-allow-sync --quiet`(不是閘,是腳本:把 ISEP 的權限白名單寫進這台的
|
||||||
|
> `~/.claude/settings.json`,雲端才不會每個正門工具都被分類器擋)。
|
||||||
|
> **61 支不變、84→85 條,兩個數字是掛完之後當場數出來的**(`ls hooks/*.sh | wc -l`=61、
|
||||||
|
> `grep -c '"command":' hooks/hooks.json`=85)。同票順手:`leo21c-write-guard.sh` 補了
|
||||||
|
> 唯讀 `-d` 與 notify_leo 的放行、三支閘認得 youlin 09-02 起的新子網域——**都是改判準不是加閘**。
|
||||||
|
|
||||||
> 📌 **`inkstone/ISEP#82`(2026-08-28)+1 支、+3 條**:`mainline-focus-guard.sh`
|
> 📌 **`inkstone/ISEP#82`(2026-08-28)+1 支、+3 條**:`mainline-focus-guard.sh`
|
||||||
> 同時掛在 `Agent` 與 `Task`(派工的兩個入口都要守,只守一個等於沒守),
|
> 同時掛在 `Agent` 與 `Task`(派工的兩個入口都要守,只守一個等於沒守),
|
||||||
> 加上 SessionStart 多掛一條 `scripts/mainline refresh`(更新主線的進度/期限,不是閘)。
|
> 加上 SessionStart 多掛一條 `scripts/mainline refresh`(更新主線的進度/期限,不是閘)。
|
||||||
@@ -122,7 +129,7 @@
|
|||||||
| `main-and-prod-push-guard.sh` | 兩層確認:① subagent 想推 Gitea `main` 分支 → 一定要交回總管,總管確認過才放行;② 任何 `wrangler deploy` 打正式環境 → 一定要你親手解鎖。 | 🛑 擋 |
|
| `main-and-prod-push-guard.sh` | 兩層確認:① subagent 想推 Gitea `main` 分支 → 一定要交回總管,總管確認過才放行;② 任何 `wrangler deploy` 打正式環境 → 一定要你親手解鎖。 | 🛑 擋 |
|
||||||
| `prod-write-guard.sh` | AI 想做任何「會真的改到線上正式帳號(leo21c)」的操作(不只是 push,也包含直接呼叫會寫入的工具)就擋下,交回總管處理。 | 🛑 擋 |
|
| `prod-write-guard.sh` | AI 想做任何「會真的改到線上正式帳號(leo21c)」的操作(不只是 push,也包含直接呼叫會寫入的工具)就擋下,交回總管處理。 | 🛑 擋 |
|
||||||
| `not-my-branch-guard.sh` | AI 想 commit 到「別的 subagent 正在施工中」的分支(登記在 `branch-holds.md`)就擋下,避免兩個 AI 互踩同一條分支。 | 🛑 擋 |
|
| `not-my-branch-guard.sh` | AI 想 commit 到「別的 subagent 正在施工中」的分支(登記在 `branch-holds.md`)就擋下,避免兩個 AI 互踩同一條分支。 | 🛑 擋 |
|
||||||
| `leo21c-write-guard.sh` | AI 想寫東西到你私人帳號 `leo21c` 就擋下——這個帳號只准你自己用,AI 的實驗一律走別的測試帳號。 | 🛑 擋 |
|
| `leo21c-write-guard.sh` | AI 想寫東西到你私人帳號 `leo21c` 就擋下——這個帳號只准你自己用,AI 的實驗一律走別的測試帳號。**讀一律放行**(含 `tr -d`/`cut -d=` 這種唯讀的 `-d`,09-04 雲端就是被這個誤攔到「連讀都讀不到」),發一則 `notify_leo`(只送訊息、什麼都沒改)也放行——跟 `prod-write-guard.sh` 同一份白名單(inkstone/ISEP#130)。 | 🛑 擋 |
|
||||||
| `release-tag-guard.sh` | AI 想打版本 tag,但 `plugin.json` 裡寫的版本號跟 tag 對不上就擋下——避免「這裡說 0.2.0、那裡說 0.1.0」各說各話。 | 🛑 擋 |
|
| `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(...)`。 | 🛑 擋 |
|
| `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-due-guard.sh` | AI 想開一個新的里程碑(milestone)卻沒填期限就擋下,**填 `9999-01-01` 一樣擋**——那是「沒有期限」穿了一件期限的衣服,盤點時每一格看起來都有值,其實一格都沒有。只管「建里程碑」這個動作,查詢/改別的欄位都放行。 | 🛑 擋 |
|
||||||
@@ -205,6 +212,7 @@
|
|||||||
|---|---|---|
|
|---|---|---|
|
||||||
| `isep-presence-beacon.sh` | 對話一開始印一行 `🟢 ISEP vX.Y.Z 已載入(N 支閘|來源:…)`。**這行不是裝飾,是唯一能證明「這個 session 真的有閘」的東西**——它自己就住在 plugin 裡,看得到它就表示 plugin 載入了;某個 session 從頭到尾沒有這行,那個 session 是零閘狀態,先修 plugin 再做事。同一台機器可能同時有兩份 ISEP(marketplace 裝的、repo 裡 vendor 的),所以那行會講出這次是哪一份在說話。它另外會報四件「這一份是不是還有效」:①這一份落後 ISEP main 幾版 ②專案裡有沒有內容不同的同名**腳本**②b 專案裡有沒有內容不同的同名**skill/command/agent**——這些是**自動載入**的,載到舊的那份不會有任何症狀,只會安靜地教錯的東西(`docs/file-ownership.tsv` 說得出每一組的真相源是哪一份、往哪個方向修)②c 本身的內容跟那張歸屬表對不對得上(雲端沒有專案那一份可比時,這是唯一還作數的檢查)③工作區有沒有已退役機制留下的產物。**全部只講不擋。** | 📝 記錄(context 注入) |
|
| `isep-presence-beacon.sh` | 對話一開始印一行 `🟢 ISEP vX.Y.Z 已載入(N 支閘|來源:…)`。**這行不是裝飾,是唯一能證明「這個 session 真的有閘」的東西**——它自己就住在 plugin 裡,看得到它就表示 plugin 載入了;某個 session 從頭到尾沒有這行,那個 session 是零閘狀態,先修 plugin 再做事。同一台機器可能同時有兩份 ISEP(marketplace 裝的、repo 裡 vendor 的),所以那行會講出這次是哪一份在說話。它另外會報四件「這一份是不是還有效」:①這一份落後 ISEP main 幾版 ②專案裡有沒有內容不同的同名**腳本**②b 專案裡有沒有內容不同的同名**skill/command/agent**——這些是**自動載入**的,載到舊的那份不會有任何症狀,只會安靜地教錯的東西(`docs/file-ownership.tsv` 說得出每一組的真相源是哪一份、往哪個方向修)②c 本身的內容跟那張歸屬表對不對得上(雲端沒有專案那一份可比時,這是唯一還作數的檢查)③工作區有沒有已退役機制留下的產物。**全部只講不擋。** | 📝 記錄(context 注入) |
|
||||||
| `session-start-recall.sh` | 對話一開始就自動把「全局現況」(Gitea 各 repo 的票、KBDB 的藏書地圖)推到 AI 眼前,不必等它自己想到要查。 | 📝 記錄(context 注入) |
|
| `session-start-recall.sh` | 對話一開始就自動把「全局現況」(Gitea 各 repo 的票、KBDB 的藏書地圖)推到 AI 眼前,不必等它自己想到要查。 | 📝 記錄(context 注入) |
|
||||||
|
| `scripts/settings-allow-sync --quiet` | (不是閘,是腳本)對話一開始把 ISEP 的權限白名單(`docs/permissions-allow.json`:`ticket`/`mainline`/`gate-ok`/`gitea-pr-merge` 四個正門工具)寫進**這台機器**的 `~/.claude/settings.json`。只加不減、冪等;目標檔壞掉就不碰它、講一聲。**為什麼**:leo 09-07 親手加的四條只在本機,雲端沒有 ⇒ 同樣的動作被分類器擋(09-04 run log `permission_denials=6`);薄殼 repo 要 D20 開閘才推得動,所以清單住 ISEP 一份、兩台各自寫進自己的家目錄(inkstone/ISEP#130)。 | 📝 記錄(寫 settings) |
|
||||||
| `scripts/mainline refresh` | (不是閘,是腳本)對話一開始把**現在的主線**那條 milestone 的進度與期限更新一次,好讓每回合眼前那一行講的是今天的數字。拿不到 Gitea 就原封不動——**寧可資料舊,不要把主線弄丟**。跑一次就結束,不輪詢。 | 📝 記錄 |
|
| `scripts/mainline refresh` | (不是閘,是腳本)對話一開始把**現在的主線**那條 milestone 的進度與期限更新一次,好讓每回合眼前那一行講的是今天的數字。拿不到 Gitea 就原封不動——**寧可資料舊,不要把主線弄丟**。跑一次就結束,不輪詢。 | 📝 記錄 |
|
||||||
| `overdue-nag-guard.sh` | 對話一開始就去 Gitea 撈**沒有人會叫的事**:逾期的 milestone、掛著等你的票(標「等了幾天」)、標著「有人在做」卻好幾天沒動的票;撈完用白話講出來,**有事就發 Telegram 給你**。沒東西可報時它會說「查過了,沒有」——**安靜跟壞掉長得一模一樣**。發不出去時不會靜默:它會先問這個 session 的 `prod-write-guard` 會不會擋(舊版把「發通知」誤認成「部署」),擋就改貼回票上並把原文印在眼前。只在開 session 時跑一次,**不輪詢、不掛排程**。 | 📝 記錄(context 注入 + Telegram) |
|
| `overdue-nag-guard.sh` | 對話一開始就去 Gitea 撈**沒有人會叫的事**:逾期的 milestone、掛著等你的票(標「等了幾天」)、標著「有人在做」卻好幾天沒動的票;撈完用白話講出來,**有事就發 Telegram 給你**。沒東西可報時它會說「查過了,沒有」——**安靜跟壞掉長得一模一樣**。發不出去時不會靜默:它會先問這個 session 的 `prod-write-guard` 會不會擋(舊版把「發通知」誤認成「部署」),擋就改貼回票上並把原文印在眼前。只在開 session 時跑一次,**不輪詢、不掛排程**。 | 📝 記錄(context 注入 + Telegram) |
|
||||||
| `wiki-size-guard.sh` | 對話一開始講出「哪幾個 wiki 檔已經沒有人讀得完了」(預設超過 1200 行就點名)。**讀不完的必讀檔,跟沒有那個檔的差別只在於它讓人以為有。** 另一半掛在寫檔上,見 B 組。 | 📝 記錄(context 注入) |
|
| `wiki-size-guard.sh` | 對話一開始講出「哪幾個 wiki 檔已經沒有人讀得完了」(預設超過 1200 行就點名)。**讀不完的必讀檔,跟沒有那個檔的差別只在於它讓人以為有。** 另一半掛在寫檔上,見 B 組。 | 📝 記錄(context 注入) |
|
||||||
@@ -288,8 +296,8 @@ countdown-milestone-refresh.sh ← 假警報:它在 scripts/ 不在 hooks/
|
|||||||
🔴 **上面那一筆是假警報,不是「指向空氣」的閘**:`inkstone/ISEP#63` 之後,
|
🔴 **上面那一筆是假警報,不是「指向空氣」的閘**:`inkstone/ISEP#63` 之後,
|
||||||
SessionStart 上掛的東西不全是 `hooks/*.sh`——`scripts/countdown-milestone-refresh.sh`
|
SessionStart 上掛的東西不全是 `hooks/*.sh`——`scripts/countdown-milestone-refresh.sh`
|
||||||
是腳本不是閘。這組指令只比檔名、不看目錄,所以它會出現在這裡。
|
是腳本不是閘。這組指令只比檔名、不看目錄,所以它會出現在這裡。
|
||||||
(`inkstone/ISEP#82` 又多掛一條 `scripts/mainline refresh`,那一條沒有 `.sh`
|
(`inkstone/ISEP#82` 又多掛一條 `scripts/mainline refresh`、`inkstone/ISEP#130` 多掛一條
|
||||||
副檔名,所以不會落進這個名單。)**照著跑會看到它,這裡先講清楚,
|
`scripts/settings-allow-sync --quiet`,這兩條沒有 `.sh` 副檔名,所以不會落進這個名單。)**照著跑會看到它,這裡先講清楚,
|
||||||
免得下一個人以為是自己弄壞的。**
|
免得下一個人以為是自己弄壞的。**
|
||||||
|
|
||||||
🔴 **上面那兩行驗不出「表格漏列」**——它們比的是 `hooks.json`,不是這張表。
|
🔴 **上面那兩行驗不出「表格漏列」**——它們比的是 `hooks.json`,不是這張表。
|
||||||
|
|||||||
@@ -0,0 +1,29 @@
|
|||||||
|
{
|
||||||
|
"_what": "Claude Code 權限白名單(permissions.allow)的唯一清單——本機與雲端都從這裡讀,不各養一份(inkstone/ISEP#130)",
|
||||||
|
"_why": [
|
||||||
|
"leo 09-07 親手把四個 Gitea 正門工具(ticket/mainline/gate-ok/gitea-pr-merge)加進本機 InkStoneCo/.claude/settings.json,auto mode 的分類器才不擋。",
|
||||||
|
"雲端 session 沒有那四條,同樣的動作照樣被擋(09-04 progress-guard run log:permission_denials=6)。",
|
||||||
|
"薄殼 repo(GitHub)要 D20 開閘才推得動 ⇒ 白名單住 ISEP,`scripts/settings-allow-sync` 開工時寫進那台機器的 ~/.claude/settings.json。",
|
||||||
|
"以後加規則只改這個檔、出一版,雲端下一趟就有。"
|
||||||
|
],
|
||||||
|
"_rules": [
|
||||||
|
"開頭的 `~` 由 settings-allow-sync 換成那台機器的家目錄(本機 /Users/…、雲端 /root),其餘一字不改。",
|
||||||
|
"只放「正門工具」:每一條都要說得出它是哪支腳本的哪種呼叫形狀。不放 Bash(python3 *) 這種整類放行。",
|
||||||
|
"同一支工具幾種呼叫形狀就幾條(快取路徑/$CLAUDE_PLUGIN_ROOT/相對路徑)——權限規則是逐條完全比對,形狀差一個字就落在規則之外(scripts/gate-ok 檔頭記過這一課)。"
|
||||||
|
],
|
||||||
|
"allow": [
|
||||||
|
"Bash(python3 ~/.claude/plugins/cache/inkstone/isep/*/scripts/ticket *)",
|
||||||
|
"Bash(python3 \"$CLAUDE_PLUGIN_ROOT/scripts/ticket\" *)",
|
||||||
|
"Bash(python3 \"$CLAUDE_PLUGIN_ROOT\"/scripts/ticket *)",
|
||||||
|
"Bash(python3 scripts/ticket *)",
|
||||||
|
"Bash(python3 ~/.claude/plugins/cache/inkstone/isep/*/scripts/mainline *)",
|
||||||
|
"Bash(python3 \"$CLAUDE_PLUGIN_ROOT/scripts/mainline\" *)",
|
||||||
|
"Bash(python3 \"$CLAUDE_PLUGIN_ROOT\"/scripts/mainline *)",
|
||||||
|
"Bash(python3 scripts/mainline *)",
|
||||||
|
"Bash(bash ~/.claude/plugins/cache/inkstone/isep/*/scripts/gate-ok *)",
|
||||||
|
"Bash(bash \"$CLAUDE_PLUGIN_ROOT/scripts/gate-ok\" *)",
|
||||||
|
"Bash(bash \"$CLAUDE_PLUGIN_ROOT\"/scripts/gate-ok *)",
|
||||||
|
"Bash(bash scripts/gate-ok *)",
|
||||||
|
"Bash(bash scripts/gitea-pr-merge.sh *)"
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -281,6 +281,10 @@
|
|||||||
"type": "command",
|
"type": "command",
|
||||||
"command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/mainline refresh"
|
"command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/mainline refresh"
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
"type": "command",
|
||||||
|
"command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/settings-allow-sync --quiet"
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"type": "command",
|
"type": "command",
|
||||||
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/overdue-nag-guard.sh"
|
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/overdue-nag-guard.sh"
|
||||||
|
|||||||
@@ -20,6 +20,7 @@
|
|||||||
# 判準(封動作,不封措辭 —— 同 empty-handed-stop-guard 的哲學):
|
# 判準(封動作,不封措辭 —— 同 empty-handed-stop-guard 的哲學):
|
||||||
# 命中 leo21c 的座標 + 這是一個寫入動作 ⇒ 擋
|
# 命中 leo21c 的座標 + 這是一個寫入動作 ⇒ 擋
|
||||||
# 只是讀(GET/查詢/grep 到那個字串) ⇒ 放行
|
# 只是讀(GET/查詢/grep 到那個字串) ⇒ 放行
|
||||||
|
# 發一則 notify_leo(通知型 trigger,什麼都沒改)⇒ 放行(同 prod-write-guard 的白名單)
|
||||||
set -uo pipefail
|
set -uo pipefail
|
||||||
payload=$(cat)
|
payload=$(cat)
|
||||||
cmd=$(printf '%s' "$payload" | python3 -c "
|
cmd=$(printf '%s' "$payload" | python3 -c "
|
||||||
@@ -60,8 +61,34 @@ hit=0
|
|||||||
|
|
||||||
# ① 寫入請求打到那台 worker
|
# ① 寫入請求打到那台 worker
|
||||||
if printf '%s' "$cmd" | grep -qiE 'https?://[^[:space:]"'"'"']*leo21c\.workers\.dev'; then
|
if printf '%s' "$cmd" | grep -qiE 'https?://[^[:space:]"'"'"']*leo21c\.workers\.dev'; then
|
||||||
if printf '%s' "$cmd" | grep -qE -- '-X *(POST|PUT|PATCH|DELETE)|--data|--data-raw|-d[[:space:]]|/trigger'; then
|
# 🔴 (a) 通知型 trigger 放行(inkstone/ISEP#130;判準與 prod-write-guard.sh 同一份):
|
||||||
hit=1
|
# `…/webhooks/named/<ns>/notify_leo/trigger` = 發一則 Telegram 給 leo,**什麼都沒改**。
|
||||||
|
# wiki `agent-memory.md` 寫明它是找 leo 的正式通道;prod-write-guard 在 ISEP#63 就放行了它,
|
||||||
|
# 本閘卻因為路徑尾巴是 `/trigger` 照擋 ⇒ 兩支閘對同一條指令說不同的話,
|
||||||
|
# 而「發通知」被擋的結果是**雲端撞到人閘也叫不動 leo**(inkstone/InkStoneCo#110)。
|
||||||
|
# 放行的範圍刻意只有一個名字:指令裡打到 leo21c 的**每一個**網址都得是它,
|
||||||
|
# 混進部署端點(`…/webhooks/named` 無名字)或別的工作流 ⇒ 照擋。
|
||||||
|
NOTIFY_ONLY=$(printf '%s' "$cmd" | python3 -c '
|
||||||
|
import re, sys
|
||||||
|
cmd = sys.stdin.read()
|
||||||
|
ALLOW = {"notify_leo"}
|
||||||
|
urls = [u for u in re.findall(r"https?://[^\s\"\x27<>]+", cmd) if "leo21c.workers.dev" in u.lower()]
|
||||||
|
PAT = re.compile(r"https?://[^/]+/webhooks/named/[^/]+/([A-Za-z0-9_-]+)/trigger/?$")
|
||||||
|
def notify(u):
|
||||||
|
m = PAT.match(u.rstrip(",;)"))
|
||||||
|
return bool(m) and m.group(1) in ALLOW
|
||||||
|
print("notify-only" if urls and all(notify(u) for u in urls) else "")
|
||||||
|
' 2>/dev/null || printf '')
|
||||||
|
if [ "$NOTIFY_ONLY" != "notify-only" ]; then
|
||||||
|
# 🔴 (b) 先剪掉唯讀工具的 `-d`(inkstone/ISEP#130,09-04 雲端實撞):
|
||||||
|
# `curl -s https://…leo21c…/x | tr -d '\r'`、`cut -d= -f2`、`sort -d`、`date -d` ……
|
||||||
|
# 這些 `-d` 沒有一個會寫到那台,舊判準 `-d[[:space:]]` 卻把整條純 GET 擋下
|
||||||
|
# ⇒ 「連讀都被擋」。prod-write-guard.sh 在 2026-08-12 就修過同一個洞,本閘漏了。
|
||||||
|
# 剪法與那支同一句 sed,剪完剩下的 `-d` 才是 curl 的 body。
|
||||||
|
cmd_w=$(printf '%s' "$cmd" | sed -E 's/(^|[|;&( ])(tr|cut|sort|uniq|date|xargs|paste|join|du|logger|split|comm)[[:space:]]+-d/\1\2 __READONLY_D__/g')
|
||||||
|
if printf '%s' "$cmd_w" | grep -qE -- '-X *(POST|PUT|PATCH|DELETE)|--request *(POST|PUT|PATCH|DELETE)|--data|--data-raw|-d[[:space:]]|/trigger'; then
|
||||||
|
hit=1
|
||||||
|
fi
|
||||||
fi
|
fi
|
||||||
fi
|
fi
|
||||||
|
|
||||||
@@ -87,7 +114,8 @@ leo 原話:「**leo21c 就是我這個普通用戶,不應該讓你去操控
|
|||||||
改法:把目標明寫成 youlin,不要吃 `~/.arcrun/config.yaml` 的預設——
|
改法:把目標明寫成 youlin,不要吃 `~/.arcrun/config.yaml` 的預設——
|
||||||
那個檔至今仍指著 leo21c(KV id 與 encryption_key 是該實例專屬,換不過去)。
|
那個檔至今仍指著 leo21c(KV id 與 encryption_key 是該實例專屬,換不過去)。
|
||||||
|
|
||||||
cypher : https://arcrun-cypher-executor.youlin-hsieh-dev.workers.dev
|
cypher : https://arcrun-cypher-executor.arcrun-yuga3bse.workers.dev
|
||||||
|
(09-02 重裝後的子網域;舊名 youlin-hsieh-dev 的 DNS 已不存在,打它一律 000)
|
||||||
ns : yuga3bse
|
ns : yuga3bse
|
||||||
CF : 1129efd7df2e8899d537e9c8fbabb6cb
|
CF : 1129efd7df2e8899d537e9c8fbabb6cb
|
||||||
token : 頂層 .env 的 CLOUDFLARE_API_TOKEN_YOULIN_CC_USE
|
token : 頂層 .env 的 CLOUDFLARE_API_TOKEN_YOULIN_CC_USE
|
||||||
|
|||||||
+91
-12
@@ -58,14 +58,57 @@ def path() -> str:
|
|||||||
return os.path.join(state_dir(), STATE_NAME)
|
return os.path.join(state_dir(), STATE_NAME)
|
||||||
|
|
||||||
|
|
||||||
def load():
|
# ── repo 裡的那一份(inkstone/ISEP#130)──────────────────────────────
|
||||||
"""讀主線。沒有/壞掉 ⇒ None(=現在沒有主線),**不是例外**。
|
#
|
||||||
|
# 主線原本只住在 `~/.claude/isep-countdown/mainline.json`——**這台機器的家目錄**。
|
||||||
|
# 雲端 session 是另一台機器:家目錄是空的,clone 下來的 repo 才是它唯一拿得到的東西。
|
||||||
|
# 2026-09-05 leo:「routine 每天早上開啟後抓不到任務」——不是 Gitea 沒票,
|
||||||
|
# 是雲端根本不知道主線是哪一條。
|
||||||
|
# ⇒ `inkstone/InkStoneCo` 的 `system-dev/mainline.json` 是**隨 repo 走的那一份**
|
||||||
|
# (PR inkstone/InkStoneCo#118 放進去的)。這裡的規矩:
|
||||||
|
# · 讀:家目錄那份沒有 ⇒ 讀 repo 那份(雲端就是這個形狀)。
|
||||||
|
# 兩份都在 ⇒ 用 `set_at` 較新的(誰後標的誰算數,不分本機雲端)。
|
||||||
|
# · 寫:`set`/`adopt`/`clear` 這種「主線是誰」的改動 ⇒ 兩份一起寫(`mirror=True`)。
|
||||||
|
# `refresh`/閘順手學到成員 ⇒ 只寫家目錄那份——否則每開一個 session
|
||||||
|
# InkStoneCo 的工作樹就髒一次,而髒的 diff 沒有人會去 commit。
|
||||||
|
# · repo 那份要 commit/開 PR 才到得了雲端;這支不碰 git。
|
||||||
|
REPO_REL = os.path.join("system-dev", STATE_NAME)
|
||||||
|
|
||||||
「沒有主線」是一個正常狀態,不是故障:ISEP#82 驗收第 4 條寫死了
|
|
||||||
「沒有任何主線時不能整組壞掉」。所以這支從不 raise。
|
def repo_candidates():
|
||||||
"""
|
"""repo 那一份可能在哪:明指 > 專案根 > 專案根底下的 InkStoneCo/(雲端薄殼的形狀)> cwd 同兩層。"""
|
||||||
|
out = []
|
||||||
|
forced = os.environ.get("ISEP_MAINLINE_REPO_FILE", "").strip()
|
||||||
|
if forced == "none":
|
||||||
|
return [] # 測試用:把「repo 那份」整個拿掉,外界定住
|
||||||
|
if forced:
|
||||||
|
out.append(forced)
|
||||||
|
roots = []
|
||||||
|
for r in (os.environ.get("CLAUDE_PROJECT_DIR", "").strip(), os.getcwd()):
|
||||||
|
if r:
|
||||||
|
roots += [r, os.path.join(r, "InkStoneCo")]
|
||||||
|
for r in roots:
|
||||||
|
p = os.path.join(r, REPO_REL)
|
||||||
|
if p not in out:
|
||||||
|
out.append(p)
|
||||||
|
return out
|
||||||
|
|
||||||
|
|
||||||
|
def repo_path(for_write=False):
|
||||||
|
"""讀:第一個**存在**的檔。寫:第一個 `system-dev/` 目錄存在的位置(檔可以還沒有)。
|
||||||
|
找不到 ⇒ None(雲端沒 clone InkStoneCo、或 cwd 在別的 repo 時都是正常狀態)。"""
|
||||||
|
for p in repo_candidates():
|
||||||
|
if for_write:
|
||||||
|
if os.path.isdir(os.path.dirname(p)):
|
||||||
|
return p
|
||||||
|
elif os.path.isfile(p):
|
||||||
|
return p
|
||||||
|
return None
|
||||||
|
|
||||||
|
|
||||||
|
def _read(p):
|
||||||
try:
|
try:
|
||||||
with open(path()) as f:
|
with open(p) as f:
|
||||||
d = json.load(f)
|
d = json.load(f)
|
||||||
except Exception:
|
except Exception:
|
||||||
return None
|
return None
|
||||||
@@ -74,23 +117,59 @@ def load():
|
|||||||
return d
|
return d
|
||||||
|
|
||||||
|
|
||||||
def save(d) -> bool:
|
def load():
|
||||||
|
"""讀主線。沒有/壞掉 ⇒ None(=現在沒有主線),**不是例外**。
|
||||||
|
|
||||||
|
「沒有主線」是一個正常狀態,不是故障:ISEP#82 驗收第 4 條寫死了
|
||||||
|
「沒有任何主線時不能整組壞掉」。所以這支從不 raise。
|
||||||
|
|
||||||
|
家目錄那份與 repo 那份都在時,`set_at` 較新的算數(格式固定 `YYYY-MM-DD HH:MM`,
|
||||||
|
字串比大小就是時間比大小);一樣新 ⇒ 家目錄那份(它才有 refresh 過的進度)。
|
||||||
|
"""
|
||||||
|
local = _read(path())
|
||||||
|
rp = repo_path()
|
||||||
|
remote = _read(rp) if rp else None
|
||||||
|
if local and remote:
|
||||||
|
return remote if (remote.get("set_at") or "") > (local.get("set_at") or "") else local
|
||||||
|
return local or remote
|
||||||
|
|
||||||
|
|
||||||
|
def save(d, mirror=False) -> bool:
|
||||||
|
"""寫家目錄那份;`mirror=True` 時同時寫 repo 那份(只有「主線是誰」變了才這樣叫)。
|
||||||
|
回 True/False 只看家目錄那份——repo 那份寫不寫得進去用 `repo_path(for_write=True)` 另外問。"""
|
||||||
try:
|
try:
|
||||||
with open(path(), "w") as f:
|
with open(path(), "w") as f:
|
||||||
json.dump(d, f, ensure_ascii=False, indent=2)
|
json.dump(d, f, ensure_ascii=False, indent=2)
|
||||||
return True
|
|
||||||
except Exception:
|
except Exception:
|
||||||
return False
|
return False
|
||||||
|
if mirror:
|
||||||
|
rp = repo_path(for_write=True)
|
||||||
|
if rp:
|
||||||
|
try:
|
||||||
|
with open(rp, "w") as f:
|
||||||
|
json.dump(d, f, ensure_ascii=False, indent=2)
|
||||||
|
f.write("\n")
|
||||||
|
except Exception:
|
||||||
|
pass
|
||||||
|
return True
|
||||||
|
|
||||||
|
|
||||||
def clear() -> bool:
|
def clear(mirror=False) -> bool:
|
||||||
|
ok = True
|
||||||
try:
|
try:
|
||||||
os.remove(path())
|
os.remove(path())
|
||||||
return True
|
|
||||||
except FileNotFoundError:
|
except FileNotFoundError:
|
||||||
return True
|
pass
|
||||||
except Exception:
|
except Exception:
|
||||||
return False
|
ok = False
|
||||||
|
if mirror:
|
||||||
|
rp = repo_path()
|
||||||
|
if rp:
|
||||||
|
try:
|
||||||
|
os.remove(rp)
|
||||||
|
except Exception:
|
||||||
|
ok = False
|
||||||
|
return ok
|
||||||
|
|
||||||
|
|
||||||
def parse_ts(raw):
|
def parse_ts(raw):
|
||||||
|
|||||||
@@ -315,12 +315,13 @@ fi
|
|||||||
#
|
#
|
||||||
# 整套測試環境=下列任一出現在命令裡:
|
# 整套測試環境=下列任一出現在命令裡:
|
||||||
# · `youlin-hsieh-dev` ── 帳號名(D37 定的 stage 帳號)
|
# · `youlin-hsieh-dev` ── 帳號名(D37 定的 stage 帳號)
|
||||||
|
# · `arcrun-yuga3bse` ── 該帳號 09-02 重裝後的 workers.dev 子網域(inkstone/ISEP#130;舊名 DNS 已死)
|
||||||
# · `1129efd7df2e8899d537e9c8fbabb6cb` ── 該帳號 ID(用 env 指過去時只有它看得見)
|
# · `1129efd7df2e8899d537e9c8fbabb6cb` ── 該帳號 ID(用 env 指過去時只有它看得見)
|
||||||
# · `_YOULIN_` ── 憑證變數名(如 `CLOUDFLARE_API_TOKEN_YOULIN_CC_USE`)
|
# · `_YOULIN_` ── 憑證變數名(如 `CLOUDFLARE_API_TOKEN_YOULIN_CC_USE`)
|
||||||
# · `X-Arcrun-API-Key: youlin` ── 打該實例 API 時的身分標頭
|
# · `X-Arcrun-API-Key: youlin` ── 打該實例 API 時的身分標頭
|
||||||
case "$CMD" in
|
case "$CMD" in
|
||||||
*staging*|*-staging*|*"--env stage"*|*"--env=stage"*|*stage.*) exit 0 ;;
|
*staging*|*-staging*|*"--env stage"*|*"--env=stage"*|*stage.*) exit 0 ;;
|
||||||
*youlin-hsieh-dev*|*1129efd7df2e8899d537e9c8fbabb6cb*|*_YOULIN_*|*"X-Arcrun-API-Key: youlin"*) exit 0 ;;
|
*youlin-hsieh-dev*|*arcrun-yuga3bse*|*1129efd7df2e8899d537e9c8fbabb6cb*|*_YOULIN_*|*"X-Arcrun-API-Key: youlin"*) exit 0 ;;
|
||||||
esac
|
esac
|
||||||
|
|
||||||
# 🔴 2026-08-12 leo 拍板「加閘」:**geek6688(出貨機)是明文授權「總管可以直接動」的那一台。**
|
# 🔴 2026-08-12 leo 拍板「加閘」:**geek6688(出貨機)是明文授權「總管可以直接動」的那一台。**
|
||||||
|
|||||||
@@ -227,6 +227,9 @@ fi
|
|||||||
case "$CMD" in
|
case "$CMD" in
|
||||||
*staging*|*-staging*|*"--env stage"*|*"--env=stage"*|*stage.*|*"-staging"*) exit 0 ;;
|
*staging*|*-staging*|*"--env stage"*|*"--env=stage"*|*stage.*|*"-staging"*) exit 0 ;;
|
||||||
*youlin-hsieh-dev*|*"X-Arcrun-API-Key: youlin"*) exit 0 ;;
|
*youlin-hsieh-dev*|*"X-Arcrun-API-Key: youlin"*) exit 0 ;;
|
||||||
|
# 🔴 2026-09-02 youlin 重裝後 workers.dev 子網域換成 `arcrun-yuga3bse`(inkstone/ISEP#130):
|
||||||
|
# 舊名 DNS 已不存在。認不得新名 ⇒ 打 stage 做實驗又會被當成 prod 擋——同一個誤攔第二次。
|
||||||
|
*arcrun-yuga3bse*) exit 0 ;;
|
||||||
esac
|
esac
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -15,6 +15,7 @@ HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/countdown-guard.sh}"
|
|||||||
TMP=$(mktemp -d)
|
TMP=$(mktemp -d)
|
||||||
trap 'rm -rf "$TMP"' EXIT
|
trap 'rm -rf "$TMP"' EXIT
|
||||||
export ISEP_COUNTDOWN_STATE_DIR="$TMP/state"
|
export ISEP_COUNTDOWN_STATE_DIR="$TMP/state"
|
||||||
|
export ISEP_MAINLINE_REPO_FILE=none # 把 repo 那份鏡像拿掉(inkstone/ISEP#130):這支測的是家目錄那份
|
||||||
mkdir -p "$ISEP_COUNTDOWN_STATE_DIR"
|
mkdir -p "$ISEP_COUNTDOWN_STATE_DIR"
|
||||||
|
|
||||||
PASS=0; FAIL=0
|
PASS=0; FAIL=0
|
||||||
|
|||||||
Executable
+78
@@ -0,0 +1,78 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
# leo21c-write-guard.sh 的迴歸測試(inkstone/ISEP#130)
|
||||||
|
#
|
||||||
|
# ── 這支在守什麼 ──────────────────────────────────────────────────────
|
||||||
|
# 閘的判準是「**讀可以,寫不行**」(leo 2026-08-20:leo21c 是他本人在用的知識庫)。
|
||||||
|
# 2026-09-04 雲端 Routine 的 run log:**讀 notify_leo 的定義被擋** ——
|
||||||
|
# 讀都讀不到,雲端就什麼都拿不到(inkstone/ISEP#130 開票的第一件)。
|
||||||
|
#
|
||||||
|
# 這支之前**沒有任何測試**,所以「讀會不會被誤攔」從來沒被驗過。
|
||||||
|
# 下面的測資是 Routine 文件(cloud-worker.md/progress-guard.md)裡**真的會下的那幾條指令**,
|
||||||
|
# 不是想像出來的例子。
|
||||||
|
#
|
||||||
|
# 🔴 三個方向都要驗,缺一個就是假綠:
|
||||||
|
# A 讀 ⇒ 放行(含 `tr -d`/`cut -d=` 這種唯讀的 -d,那正是 09-04 被擋的形狀)
|
||||||
|
# B 寫 ⇒ 擋(心跳 POST/PATCH 收件匣/部署端點/別的 trigger)
|
||||||
|
# C 閘印出來的「改法」指的是**現役**的 youlin 網址,不是 09-02 已死的舊名
|
||||||
|
#
|
||||||
|
# 這支閘不寫任何檔案,直接跑真跡即可;全程離線。
|
||||||
|
# 用法:bash hooks/tests/leo21c-write-guard.test.sh
|
||||||
|
set -u
|
||||||
|
HERE=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
|
||||||
|
HOOK="$HERE/../leo21c-write-guard.sh"
|
||||||
|
PASS=0; FAIL=0
|
||||||
|
mk(){ python3 -c "import json,sys;print(json.dumps({'tool_name':'Bash','tool_input':{'command':sys.argv[1]}}))" "$1"; }
|
||||||
|
t(){ # t <期望 pass|block> <說明> <指令>
|
||||||
|
LAST_ERR=$(mk "$3" | bash "$HOOK" 2>&1 >/dev/null); rc=$?
|
||||||
|
got=$([ "$rc" -eq 2 ] && echo block || echo pass)
|
||||||
|
if [ "$got" = "$1" ]; then echo " ✅ $2"; PASS=$((PASS+1))
|
||||||
|
else echo " ❌ $2 —— 期望 $1,實得 $got(rc=$rc)"; FAIL=$((FAIL+1)); fi
|
||||||
|
}
|
||||||
|
|
||||||
|
L='https://arcrun-cypher-executor.leo21c.workers.dev'
|
||||||
|
K='-H "X-Arcrun-API-Key: leo"'
|
||||||
|
D='-d'
|
||||||
|
|
||||||
|
echo "── A. 讀 ⇒ 放行(雲端 Routine 真的會下的形狀)──"
|
||||||
|
t pass "① 讀收件匣(progress-guard.md 步驟 0 原句)" "curl -s \"$L/kbdb/entries?entry_type=inbox&limit=20\" $K"
|
||||||
|
t pass "② 讀 notify_leo 定義(09-04 被擋的那一條)" "curl -s $L/webhooks/named/leo/notify_leo $K"
|
||||||
|
t pass "③ 讀 + tr -d(唯讀的 -d,不是 body)" "curl -s $L/workflows/notify_leo $K | tr $D '\\r'"
|
||||||
|
t pass "④ 讀 + cut -d=" "NS=\$(grep ns cfg | cut ${D}= -f2); curl -s $L/kbdb/entries?limit=1 $K"
|
||||||
|
t pass "⑤ 讀 + sort -d / date -d" "curl -s $L/health | sort $D; date $D yesterday"
|
||||||
|
t pass "⑥ 明寫 -X GET" "curl -s -X GET $L/kbdb/entries?entry_type=dash_beat $K"
|
||||||
|
t pass "⑦ 讀心跳(progress-guard 2.6 原句)" "curl -s \"$L/kbdb/entries?entry_type=dash_beat&limit=30\" $K"
|
||||||
|
t pass "⑧ git commit 訊息提到 leo21c 與 POST(git 寫不到那台)" "git commit -m 'fix: curl -X POST $L/kbdb/entries 會被擋'"
|
||||||
|
t pass "⑨ 修這道閘自己" "sed -i 's/a/b/' hooks/leo21c-write-guard.sh"
|
||||||
|
t pass "⑩ 打 youlin(09-02 起的新子網域)POST,不是 leo21c" "curl -X POST https://arcrun-cypher-executor.arcrun-yuga3bse.workers.dev/webhooks/named $D '{}'"
|
||||||
|
t pass "⑪ 用 youlin 的 CF 帳號部署" "CLOUDFLARE_ACCOUNT_ID=1129efd7df2e8899d537e9c8fbabb6cb npx wrangler deploy"
|
||||||
|
t pass "⑫ 發一則 notify_leo(通知型 trigger,什麼都沒改;同 prod-write-guard 白名單)" "curl -s -X POST $L/webhooks/named/leo/notify_leo/trigger -H 'Content-Type: application/json' $D '{\"text\":\"[總管] hi\"}'"
|
||||||
|
|
||||||
|
echo "── B. 寫 ⇒ 擋 ──"
|
||||||
|
t block "⑬ 打心跳 POST(cloud-worker.md 步驟 0 原句——它寫進 leo 的庫)" "curl -s -X POST \"$L/kbdb/entries\" $K -H 'Content-Type: application/json' $D '{\"entry_type\":\"dash_beat\"}'"
|
||||||
|
t block "⑭ PATCH 收件匣" "curl -s -X PATCH \"$L/kbdb/entries/123\" $K $D '{\"content\":\"x\"}'"
|
||||||
|
t block "⑮ DELETE" "curl -X DELETE $L/kbdb/entries/1 $K"
|
||||||
|
t block "⑯ 只帶 -d 的隱式 POST" "curl $L/kbdb/entries $D '{}'"
|
||||||
|
t block "⑰ --data-urlencode" "curl $L/kbdb/entries --data-urlencode text=hi"
|
||||||
|
t block "⑱ --request PUT" "curl --request PUT $L/kbdb/entries/1 $D '{}'"
|
||||||
|
t block "⑲ 別的工作流 trigger(ship_refresh_cdn 會動線上狀態)" "curl -X POST $L/webhooks/named/leo/ship_refresh_cdn/trigger $D '{}'"
|
||||||
|
t block "⑳ 部署端點(無名字的 named webhook)" "curl -X POST $L/webhooks/named $D @def.yaml"
|
||||||
|
t block "㉑ notify_leo 旁邊夾一個部署端點" "curl -X POST $L/webhooks/named/leo/notify_leo/trigger $D '{}' && curl -X POST $L/webhooks/named $D @x"
|
||||||
|
t block "㉒ 寫 + tr -d(剪掉唯讀 -d 之後仍該擋)" "cat f | tr $D '\\r' | curl -X POST $L/kbdb/entries $D @-"
|
||||||
|
t block "㉓ 用 leo21c 的 CF 帳號部署" "CLOUDFLARE_ACCOUNT_ID=51a01bfa2665bd7bc3fd080dc40cf3e1 npx wrangler deploy"
|
||||||
|
|
||||||
|
echo "── C. 擋下時印的改法要指到活著的 youlin ──"
|
||||||
|
mk "curl -X POST $L/kbdb/entries $D '{}'" | bash "$HOOK" 2>"$HERE/.leo21c-msg.$$" >/dev/null
|
||||||
|
MSG=$(cat "$HERE/.leo21c-msg.$$"); rm -f "$HERE/.leo21c-msg.$$"
|
||||||
|
if printf '%s' "$MSG" | grep -q 'arcrun-cypher-executor.arcrun-yuga3bse.workers.dev'; then
|
||||||
|
echo " ✅ ㉔ 改法段印的是現役子網域 arcrun-yuga3bse"; PASS=$((PASS+1))
|
||||||
|
else echo " ❌ ㉔ 改法段沒有現役子網域 arcrun-yuga3bse"; FAIL=$((FAIL+1)); fi
|
||||||
|
if printf '%s' "$MSG" | grep -q 'cypher : https://arcrun-cypher-executor.youlin-hsieh-dev'; then
|
||||||
|
echo " ❌ ㉕ 改法段還教人打 09-02 已死的 youlin-hsieh-dev"; FAIL=$((FAIL+1))
|
||||||
|
else echo " ✅ ㉕ 改法段不再把死的舊名當網址教人"; PASS=$((PASS+1)); fi
|
||||||
|
if printf '%s' "$MSG" | grep -q '讀可以,寫不行'; then
|
||||||
|
echo " ✅ ㉖ 訊息講得出判準(讀可以,寫不行)"; PASS=$((PASS+1))
|
||||||
|
else echo " ❌ ㉖ 訊息沒講判準"; FAIL=$((FAIL+1)); fi
|
||||||
|
|
||||||
|
echo
|
||||||
|
echo "通過 $PASS 條,失敗 $FAIL 條"
|
||||||
|
[ "$FAIL" -eq 0 ]
|
||||||
@@ -21,6 +21,7 @@ MAINLINE="$ROOT/../scripts/mainline"
|
|||||||
TMP=$(mktemp -d)
|
TMP=$(mktemp -d)
|
||||||
trap 'rm -rf "$TMP"' EXIT
|
trap 'rm -rf "$TMP"' EXIT
|
||||||
export ISEP_COUNTDOWN_STATE_DIR="$TMP/state"
|
export ISEP_COUNTDOWN_STATE_DIR="$TMP/state"
|
||||||
|
export ISEP_MAINLINE_REPO_FILE=none # 把 repo 那份鏡像拿掉(inkstone/ISEP#130):這支測的是家目錄那份
|
||||||
export TICKET_HOST="http://127.0.0.1:9" # 連不上:走到網路就會馬上失敗
|
export TICKET_HOST="http://127.0.0.1:9" # 連不上:走到網路就會馬上失敗
|
||||||
mkdir -p "$ISEP_COUNTDOWN_STATE_DIR"
|
mkdir -p "$ISEP_COUNTDOWN_STATE_DIR"
|
||||||
unset ISEP_MAINLINE_FIXTURE
|
unset ISEP_MAINLINE_FIXTURE
|
||||||
|
|||||||
Executable
+117
@@ -0,0 +1,117 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
# 主線那個檔「隨 repo 走」的迴歸測試(inkstone/ISEP#130)
|
||||||
|
#
|
||||||
|
# ── 這支在守什麼 ──────────────────────────────────────────────────────
|
||||||
|
# 主線原本只住在家目錄(`~/.claude/isep-countdown/mainline.json`)。雲端是另一台機器,
|
||||||
|
# 家目錄空的、clone 下來的 repo 才是它拿得到的東西 ⇒ 2026-09-05 leo:
|
||||||
|
# 「routine 每天早上開啟後抓不到任務」。PR inkstone/InkStoneCo#118 把主線檔放進
|
||||||
|
# `InkStoneCo/system-dev/mainline.json`,這裡驗 ISEP 這一半:
|
||||||
|
# A 讀:家目錄沒有 ⇒ 讀 repo 那份(雲端的形狀:$CLAUDE_PROJECT_DIR 是薄殼根,真身在 InkStoneCo/)
|
||||||
|
# B 兩份都在 ⇒ `set_at` 較新的算數,不分本機雲端
|
||||||
|
# C 寫:`set`/`adopt`/`clear` 兩份一起動;`refresh` 那種只寫家目錄(不弄髒 InkStoneCo 工作樹)
|
||||||
|
# D 哪裡都沒有 ⇒ 仍然答得出「現在沒有主線」(ISEP#82 驗收第 4 條沒有被本票弄壞)
|
||||||
|
#
|
||||||
|
# 用法:bash hooks/tests/mainline-repo-mirror.test.sh
|
||||||
|
# 🔴 全程離線:狀態走 ISEP_COUNTDOWN_STATE_DIR、repo 那份走 TMP 底下的假 InkStoneCo、
|
||||||
|
# TICKET_HOST 指到連不上的位址。不碰真家目錄、不碰真 InkStoneCo。
|
||||||
|
set -u
|
||||||
|
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||||
|
MAINLINE="$ROOT/../scripts/mainline"
|
||||||
|
LIB="$ROOT/lib/mainline.py"
|
||||||
|
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
|
||||||
|
export ISEP_COUNTDOWN_STATE_DIR="$TMP/home-state"; mkdir -p "$ISEP_COUNTDOWN_STATE_DIR"
|
||||||
|
export TICKET_HOST="http://127.0.0.1:9"
|
||||||
|
unset ISEP_MAINLINE_REPO_FILE ISEP_MAINLINE_FIXTURE
|
||||||
|
SHELL_ROOT="$TMP/shell"; HUB="$SHELL_ROOT/InkStoneCo"; mkdir -p "$HUB/system-dev"
|
||||||
|
PASS=0; FAIL=0
|
||||||
|
ok(){ printf ' ✅ %s\n' "$1"; PASS=$((PASS+1)); }
|
||||||
|
no(){ printf ' ❌ %s —— %s\n' "$1" "$2"; FAIL=$((FAIL+1)); }
|
||||||
|
|
||||||
|
write_ms(){ # write_ms <檔> <標題> <set_at>
|
||||||
|
python3 - "$1" "$2" "$3" <<'PY'
|
||||||
|
import json, sys
|
||||||
|
json.dump({"ref": "inkstone/Arcrun#48", "owner": "inkstone", "repo": "Arcrun", "id": 48,
|
||||||
|
"title": sys.argv[2], "description": "測試用。", "due_on": "2026-09-13T23:59:59Z",
|
||||||
|
"open_issues": 3, "closed_issues": 0, "members": ["inkstone/ISEP#130"],
|
||||||
|
"set_at": sys.argv[3], "refreshed_at": sys.argv[3]},
|
||||||
|
open(sys.argv[1], "w"), ensure_ascii=False, indent=2)
|
||||||
|
PY
|
||||||
|
}
|
||||||
|
show(){ CLAUDE_PROJECT_DIR="$1" python3 "$MAINLINE" 2>&1 | head -1; }
|
||||||
|
|
||||||
|
echo "── A. 家目錄沒有 ⇒ 讀 repo 那份 ──"
|
||||||
|
write_ms "$HUB/system-dev/mainline.json" "雲端才讀得到的那一條" "2026-09-07 07:30"
|
||||||
|
OUT=$(show "$SHELL_ROOT")
|
||||||
|
case "$OUT" in *"雲端才讀得到的那一條"*) ok "① \$CLAUDE_PROJECT_DIR 是薄殼根、真身在 InkStoneCo/(雲端的形狀)⇒ 答得出主線" ;;
|
||||||
|
*) no "① 薄殼根形狀讀不到 repo 那份" "$OUT" ;; esac
|
||||||
|
OUT=$(show "$HUB")
|
||||||
|
case "$OUT" in *"雲端才讀得到的那一條"*) ok "② \$CLAUDE_PROJECT_DIR 直接是 InkStoneCo ⇒ 也答得出" ;;
|
||||||
|
*) no "② InkStoneCo 根讀不到" "$OUT" ;; esac
|
||||||
|
OUT=$(cd "$HUB" && env -u CLAUDE_PROJECT_DIR python3 "$MAINLINE" 2>&1 | head -1)
|
||||||
|
case "$OUT" in *"雲端才讀得到的那一條"*) ok "③ 沒設 \$CLAUDE_PROJECT_DIR、只是 cwd 在 InkStoneCo ⇒ 也答得出" ;;
|
||||||
|
*) no "③ cwd 形狀讀不到" "$OUT" ;; esac
|
||||||
|
[ ! -e "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" ] && ok "④ 只是讀,家目錄那份沒有被順手建出來" \
|
||||||
|
|| no "④ 讀的時候寫了家目錄" "$(ls "$ISEP_COUNTDOWN_STATE_DIR")"
|
||||||
|
|
||||||
|
echo "── B. 兩份都在 ⇒ set_at 較新的算數 ──"
|
||||||
|
write_ms "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" "本機舊的" "2026-09-01 10:00"
|
||||||
|
OUT=$(show "$SHELL_ROOT")
|
||||||
|
case "$OUT" in *"雲端才讀得到的那一條"*) ok "⑤ repo 那份較新(別台機器後標的)⇒ 用 repo 那份" ;;
|
||||||
|
*) no "⑤ 沒用較新的 repo 那份" "$OUT" ;; esac
|
||||||
|
write_ms "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" "本機新的" "2026-09-08 09:00"
|
||||||
|
OUT=$(show "$SHELL_ROOT")
|
||||||
|
case "$OUT" in *"本機新的"*) ok "⑥ 家目錄那份較新 ⇒ 用家目錄那份" ;;
|
||||||
|
*) no "⑥ 沒用較新的家目錄那份" "$OUT" ;; esac
|
||||||
|
write_ms "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" "同時標的(家目錄)" "2026-09-07 07:30"
|
||||||
|
OUT=$(show "$SHELL_ROOT")
|
||||||
|
case "$OUT" in *"同時標的(家目錄)"*) ok "⑦ 一樣新 ⇒ 家目錄那份(它才有 refresh 過的進度)" ;;
|
||||||
|
*) no "⑦ 平手沒選家目錄" "$OUT" ;; esac
|
||||||
|
|
||||||
|
echo "── C. 寫:誰該動 repo 那份 ──"
|
||||||
|
R=$(CLAUDE_PROJECT_DIR="$SHELL_ROOT" python3 - "$LIB" "$HUB/system-dev/mainline.json" <<'PY'
|
||||||
|
import importlib.util, json, os, sys
|
||||||
|
spec = importlib.util.spec_from_file_location("ml", sys.argv[1]); ML = importlib.util.module_from_spec(spec); spec.loader.exec_module(ML)
|
||||||
|
rp = sys.argv[2]
|
||||||
|
before = open(rp).read()
|
||||||
|
d = ML.load(); d["refreshed_at"] = "2026-09-09 00:00"; d["open_issues"] = 1
|
||||||
|
ML.save(d) # refresh 的形狀:只寫家目錄
|
||||||
|
r1 = open(rp).read() == before
|
||||||
|
d["title"] = "set 之後的新主線"; d["set_at"] = "2026-09-09 00:01"
|
||||||
|
ML.save(d, mirror=True) # set/adopt 的形狀:兩份一起
|
||||||
|
r2 = json.load(open(rp)).get("title") == "set 之後的新主線"
|
||||||
|
r3 = json.load(open(ML.path())).get("title") == "set 之後的新主線"
|
||||||
|
r4 = open(rp).read().endswith("\n")
|
||||||
|
print("|".join(str(x) for x in (r1, r2, r3, r4)))
|
||||||
|
PY
|
||||||
|
)
|
||||||
|
[ "${R%%|*}" = "True" ] && ok "⑧ save()(refresh 的形狀)不碰 repo 那份——不弄髒 InkStoneCo 工作樹" || no "⑧ refresh 動了 repo 那份" "$R"
|
||||||
|
R2=${R#*|}; [ "${R2%%|*}" = "True" ] && ok "⑨ save(mirror=True)(set/adopt 的形狀)寫進 repo 那份" || no "⑨ mirror 沒寫 repo" "$R"
|
||||||
|
R3=${R2#*|}; [ "${R3%%|*}" = "True" ] && ok "⑩ 同一次也寫了家目錄那份" || no "⑩ 家目錄沒寫" "$R"
|
||||||
|
[ "${R##*|}" = "True" ] && ok "⑪ repo 那份收尾有換行(diff 才不會每次多一行 no newline)" || no "⑪ 沒換行" "$R"
|
||||||
|
|
||||||
|
OUT=$(CLAUDE_PROJECT_DIR="$SHELL_ROOT" python3 "$MAINLINE" clear 2>&1)
|
||||||
|
if [ ! -e "$ISEP_COUNTDOWN_STATE_DIR/mainline.json" ] && [ ! -e "$HUB/system-dev/mainline.json" ]; then
|
||||||
|
ok "⑫ clear ⇒ 兩份都拿掉(否則下次讀又從 repo 那份長回來)"
|
||||||
|
else no "⑫ clear 沒清乾淨" "$(ls "$ISEP_COUNTDOWN_STATE_DIR" "$HUB/system-dev" 2>&1 | tr '\n' ' ')"; fi
|
||||||
|
case "$OUT" in *"repo 那份也刪了"*) ok "⑬ clear 講得出 repo 那份也動了(要 commit 才到雲端)" ;; *) no "⑬ clear 沒講 repo 那份" "$OUT" ;; esac
|
||||||
|
|
||||||
|
# set 要打網路,這裡只驗它印出來的那段「repo 那份寫了沒」是接在 repo_path 上的
|
||||||
|
R=$(CLAUDE_PROJECT_DIR="$SHELL_ROOT" python3 - "$LIB" "$HUB" <<'PY'
|
||||||
|
import importlib.util, os, sys
|
||||||
|
spec = importlib.util.spec_from_file_location("ml", sys.argv[1]); ML = importlib.util.module_from_spec(spec); spec.loader.exec_module(ML)
|
||||||
|
print(ML.repo_path(for_write=True) == os.path.join(sys.argv[2], "system-dev", "mainline.json"))
|
||||||
|
PY
|
||||||
|
)
|
||||||
|
[ "$R" = "True" ] && ok "⑭ 檔還不存在時,寫的目標仍指到 InkStoneCo/system-dev/(set 建得出它)" || no "⑭ 寫的目標不對" "$R"
|
||||||
|
|
||||||
|
echo "── D. 哪裡都沒有 ⇒ 仍然答得出「現在沒有主線」 ──"
|
||||||
|
OUT=$(show "$SHELL_ROOT")
|
||||||
|
case "$OUT" in *"現在沒有主線"*) ok "⑮ 兩份都沒有 ⇒ 「現在沒有主線」(ISEP#82 第 4 條沒被弄壞)" ;; *) no "⑮ 沒主線時答不出來" "$OUT" ;; esac
|
||||||
|
OUT=$(ISEP_MAINLINE_REPO_FILE=none show "$SHELL_ROOT")
|
||||||
|
case "$OUT" in *"現在沒有主線"*) ok "⑯ ISEP_MAINLINE_REPO_FILE=none ⇒ 不看 repo(既有測試靠它把外界定住)" ;; *) no "⑯ none 沒生效" "$OUT" ;; esac
|
||||||
|
printf 'not json' > "$HUB/system-dev/mainline.json"
|
||||||
|
OUT=$(show "$SHELL_ROOT")
|
||||||
|
case "$OUT" in *"現在沒有主線"*) ok "⑰ repo 那份壞掉 ⇒ 當成沒有,不炸" ;; *) no "⑰ 壞檔炸了" "$OUT" ;; esac
|
||||||
|
|
||||||
|
echo; echo "通過 $PASS 條,失敗 $FAIL 條"
|
||||||
|
[ "$FAIL" -eq 0 ]
|
||||||
@@ -23,6 +23,7 @@ t pass "GET + sort -d / xargs -d" "ls | sort $DASH_D | xargs $DASH_D '\\n' echo;
|
|||||||
t pass "GET 帶 Bearer 標頭" "curl -s -H 'Authorization: Bearer xxx' $H/templates?limit=1"
|
t pass "GET 帶 Bearer 標頭" "curl -s -H 'Authorization: Bearer xxx' $H/templates?limit=1"
|
||||||
t pass "打 staging" "curl -X POST https://arcrun-rag-installer-staging.workers.dev/x $DASH_D '{}'"
|
t pass "打 staging" "curl -X POST https://arcrun-rag-installer-staging.workers.dev/x $DASH_D '{}'"
|
||||||
t pass "打 youlin 測試場" "curl -X POST https://arcrun-cypher-executor.youlin-hsieh-dev.workers.dev/x $DASH_D '{}'"
|
t pass "打 youlin 測試場" "curl -X POST https://arcrun-cypher-executor.youlin-hsieh-dev.workers.dev/x $DASH_D '{}'"
|
||||||
|
t pass "打 youlin 測試場(09-02 重裝後的子網域 arcrun-yuga3bse,inkstone/ISEP#130)" "curl -X POST https://arcrun-cypher-executor.arcrun-yuga3bse.workers.dev/webhooks/named $DASH_D @def.yaml"
|
||||||
t pass "打 Gitea(不是實例)" "curl -X POST https://git.uncle6.me/api/v1/repos/Leo/x/issues $DASH_D '{}'"
|
t pass "打 Gitea(不是實例)" "curl -X POST https://git.uncle6.me/api/v1/repos/Leo/x/issues $DASH_D '{}'"
|
||||||
|
|
||||||
echo "── 該擋(寫入)──"
|
echo "── 該擋(寫入)──"
|
||||||
|
|||||||
+57
-1
@@ -42,6 +42,8 @@
|
|||||||
1 = 兩條路都沒走通(這時 stderr 一定有一段紅字,不會安靜)
|
1 = 兩條路都沒走通(這時 stderr 一定有一段紅字,不會安靜)
|
||||||
|
|
||||||
環境變數(都有預設,測試才需要動):
|
環境變數(都有預設,測試才需要動):
|
||||||
|
TELEGRAM_BOT_TOKEN/TELEGRAM_CHAT_ID 有就先走 Bot API 直送(雲端唯一通的路,ISEP#130)
|
||||||
|
ISEP_NOTIFY_BOT_API Bot API 的主機(預設 https://api.telegram.org;測試指到假的)
|
||||||
ISEP_NOTIFY_URL notify_leo 的 trigger 網址
|
ISEP_NOTIFY_URL notify_leo 的 trigger 網址
|
||||||
ISEP_NOTIFY_IDENTITY 貼票時的【身份】欄
|
ISEP_NOTIFY_IDENTITY 貼票時的【身份】欄
|
||||||
ISEP_NOTIFY_STATE_DIR 閘判定快取的位置(預設 ~/.claude/isep-nag)
|
ISEP_NOTIFY_STATE_DIR 閘判定快取的位置(預設 ~/.claude/isep-nag)
|
||||||
@@ -252,6 +254,52 @@ def send_telegram(text):
|
|||||||
return False, "外層通了但**內層沒 ok**:%s" % raw[:300]
|
return False, "外層通了但**內層沒 ok**:%s" % raw[:300]
|
||||||
|
|
||||||
|
|
||||||
|
# ══ 二之一、直送 Bot API(雲端的路,inkstone/ISEP#130)═══════════════════════
|
||||||
|
#
|
||||||
|
# 2026-09-07 從雲端 session 實測三條路:
|
||||||
|
# notify_leo @ leo21c → HTTP 404「找不到 workflow」(08-28 起就斷,修它是 leo 的人閘)
|
||||||
|
# notify_leo @ youlin → 連不到:雲端 egress proxy 對 *.arcrun-yuga3bse.workers.dev 回 403
|
||||||
|
# (policy denial,不是 DNS、不是 000;要 leo 在 Cloud environment 放行主機)
|
||||||
|
# api.telegram.org → 302,**通的**
|
||||||
|
# ⇒ 雲端唯一走得通的是 Bot API 直送,而它只缺兩個環境變數:
|
||||||
|
# TELEGRAM_BOT_TOKEN/TELEGRAM_CHAT_ID(Routine 文件 cloud-worker.md 檔頭本來就列著它們)。
|
||||||
|
# 有 ⇒ 先走這條(它不碰任何實例,閘管不到也不必管);沒有 ⇒ 講清楚缺哪兩個,走原本那條。
|
||||||
|
BOT_API = os.environ.get("ISEP_NOTIFY_BOT_API", "https://api.telegram.org")
|
||||||
|
|
||||||
|
|
||||||
|
def bot_creds():
|
||||||
|
tok = (os.environ.get("TELEGRAM_BOT_TOKEN") or "").strip()
|
||||||
|
chat = (os.environ.get("TELEGRAM_CHAT_ID") or "").strip()
|
||||||
|
return (tok, chat) if tok and chat else (None, None)
|
||||||
|
|
||||||
|
|
||||||
|
def send_bot_api(text):
|
||||||
|
"""回 (ok, 說明)。Telegram 的回應要 `ok: true` 才算送到。"""
|
||||||
|
tok, chat = bot_creds()
|
||||||
|
if not tok:
|
||||||
|
return False, "沒有 TELEGRAM_BOT_TOKEN/TELEGRAM_CHAT_ID(雲端要 leo 在 Cloud environment 加這兩個變數)"
|
||||||
|
if os.environ.get("ISEP_NOTIFY_OFFLINE") == "1":
|
||||||
|
return False, "ISEP_NOTIFY_OFFLINE=1:刻意不打網路"
|
||||||
|
req = urllib.request.Request(
|
||||||
|
"%s/bot%s/sendMessage" % (BOT_API, tok),
|
||||||
|
data=json.dumps({"chat_id": chat, "text": text}).encode(), method="POST",
|
||||||
|
headers={"Content-Type": "application/json",
|
||||||
|
"User-Agent": "isep-notify/1.0 (+inkstone/ISEP#130)"})
|
||||||
|
try:
|
||||||
|
raw = urllib.request.urlopen(req, timeout=30).read().decode()
|
||||||
|
except urllib.error.HTTPError as e:
|
||||||
|
return False, "Bot API HTTP %s:%s" % (e.code, e.read().decode()[:200])
|
||||||
|
except Exception as e:
|
||||||
|
return False, "Bot API 連不上:%s" % e
|
||||||
|
try:
|
||||||
|
d = json.loads(raw)
|
||||||
|
except Exception:
|
||||||
|
return False, "Bot API 回應不是 JSON:%s" % raw[:200]
|
||||||
|
if d.get("ok") is True:
|
||||||
|
return True, "送到了(Bot API 直送,message_id=%s)" % ((d.get("result") or {}).get("message_id"))
|
||||||
|
return False, "Bot API 回 ok=false:%s" % raw[:200]
|
||||||
|
|
||||||
|
|
||||||
# ══ 三、退路:貼回票上 ═══════════════════════════════════════════════════
|
# ══ 三、退路:貼回票上 ═══════════════════════════════════════════════════
|
||||||
def gitea_token():
|
def gitea_token():
|
||||||
for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
|
for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
|
||||||
@@ -351,12 +399,20 @@ def notify(text, fallback_ticket=None, dry_run=False):
|
|||||||
out.append(text)
|
out.append(text)
|
||||||
return 0, "\n".join(out)
|
return 0, "\n".join(out)
|
||||||
|
|
||||||
|
# ① Bot API 直送:不碰任何實例,閘的判定管不到它(inkstone/ISEP#130)
|
||||||
|
sent, why_bot = send_bot_api(text)
|
||||||
|
out.append(("✅ Telegram(Bot API 直送):%s" if sent else "⏭️ Bot API 直送:%s") % why_bot)
|
||||||
|
if sent:
|
||||||
|
return 0, "\n".join(out)
|
||||||
|
|
||||||
|
# ② 走實例上的 notify_leo 工作流(原本那條;閘說會擋就不送)
|
||||||
if fact["verdict"] == "block":
|
if fact["verdict"] == "block":
|
||||||
out.append("⛔ 閘說會擋 ⇒ **本支不繞路**,直接走退路。")
|
out.append("⛔ 閘說會擋 ⇒ **本支不繞路**,直接走退路。")
|
||||||
sent, why = False, "閘會擋,而繞過去等於拆了那道閘 ⇒ 沒有嘗試送出"
|
sent, why = False, "閘會擋,而繞過去等於拆了那道閘 ⇒ 沒有嘗試送出"
|
||||||
else:
|
else:
|
||||||
sent, why = send_telegram(text)
|
sent, why = send_telegram(text)
|
||||||
out.append(("✅ Telegram:%s" if sent else "❌ Telegram:%s") % why)
|
out.append(("✅ Telegram(notify_leo):%s" if sent else "❌ Telegram(notify_leo):%s") % why)
|
||||||
|
why = "Bot API 直送:%s;notify_leo:%s" % (why_bot, why)
|
||||||
|
|
||||||
if sent:
|
if sent:
|
||||||
return 0, "\n".join(out)
|
return 0, "\n".join(out)
|
||||||
|
|||||||
@@ -254,7 +254,7 @@ YOULIN_ACCOUNT = "1129efd7df2e8899d537e9c8fbabb6cb"
|
|||||||
# ⇒ 判準:防呆要比對「**決定後果的那一項**」,不是「剛好看得到的那一項」。
|
# ⇒ 判準:防呆要比對「**決定後果的那一項**」,不是「剛好看得到的那一項」。
|
||||||
# namespace 才是資料的歸屬鍵 ⇒ 三項一起驗,缺一不可。
|
# namespace 才是資料的歸屬鍵 ⇒ 三項一起驗,缺一不可。
|
||||||
YOULIN_NAMESPACE = "yuga3bse"
|
YOULIN_NAMESPACE = "yuga3bse"
|
||||||
YOULIN_CYPHER = "arcrun-cypher-executor.youlin-hsieh-dev.workers.dev"
|
YOULIN_CYPHER = "arcrun-cypher-executor.arcrun-yuga3bse.workers.dev" # 09-02 重裝後的子網域(inkstone/ISEP#130);舊名 youlin-hsieh-dev 的 DNS 已不存在
|
||||||
|
|
||||||
|
|
||||||
class Acr:
|
class Acr:
|
||||||
|
|||||||
+20
-3
@@ -23,6 +23,8 @@ leo 2026-08-27:「**14 個里程碑同時亮著卻不知道該看哪個**」
|
|||||||
|
|
||||||
── 答案為什麼唯一 ─────────────────────────────────────────────────
|
── 答案為什麼唯一 ─────────────────────────────────────────────────
|
||||||
主線住在一個檔裡(`~/.claude/isep-countdown/mainline.json`),那個檔**放得下一條**。
|
主線住在一個檔裡(`~/.claude/isep-countdown/mainline.json`),那個檔**放得下一條**。
|
||||||
|
(inkstone/ISEP#130 起它有一份隨 repo 走的鏡像:`InkStoneCo/system-dev/mainline.json`——
|
||||||
|
雲端沒有家目錄那份,讀的就是它;`set`/`adopt`/`clear` 兩份一起寫,`refresh` 只寫家目錄。)
|
||||||
沒有清單、沒有優先序、沒有「前三名」——`set` 覆蓋掉的那條就不再是主線。
|
沒有清單、沒有優先序、沒有「前三名」——`set` 覆蓋掉的那條就不再是主線。
|
||||||
⇒ 問一次只會拿到 0 或 1 個答案,不會拿到 14 個。
|
⇒ 問一次只會拿到 0 或 1 個答案,不會拿到 14 個。
|
||||||
|
|
||||||
@@ -212,22 +214,36 @@ def cmd_set(argv):
|
|||||||
"closed_issues": m.get("closed_issues") or 0,
|
"closed_issues": m.get("closed_issues") or 0,
|
||||||
"members": refs,
|
"members": refs,
|
||||||
"set_at": now, "refreshed_at": now,
|
"set_at": now, "refreshed_at": now,
|
||||||
})
|
}, mirror=True)
|
||||||
if not ok:
|
if not ok:
|
||||||
die("🔴 寫不進 %s——主線沒有被標上。" % ML.path())
|
die("🔴 寫不進 %s——主線沒有被標上。" % ML.path())
|
||||||
print("✅ 主線已標定:%s/%s#%d「%s」" % (owner, repo, mid, title))
|
print("✅ 主線已標定:%s/%s#%d「%s」" % (owner, repo, mid, title))
|
||||||
if scanned:
|
if scanned:
|
||||||
print(" 跨 repo 收到同名 milestone 的票 %d 張:%s"
|
print(" 跨 repo 收到同名 milestone 的票 %d 張:%s"
|
||||||
% (len(refs), "、".join("%s %d" % (r, n) for r, n in scanned)))
|
% (len(refs), "、".join("%s %d" % (r, n) for r, n in scanned)))
|
||||||
|
print(mirror_line())
|
||||||
print()
|
print()
|
||||||
cmd_show([])
|
cmd_show([])
|
||||||
|
|
||||||
|
|
||||||
|
def mirror_line():
|
||||||
|
"""repo 那份有沒有跟著寫(inkstone/ISEP#130):寫了要人去 commit,沒寫要講為什麼。"""
|
||||||
|
rp = ML.repo_path(for_write=True)
|
||||||
|
if rp and os.path.isfile(rp):
|
||||||
|
return (" 已同步寫進 repo 那份:%s\n"
|
||||||
|
" 📌 這份要 commit/開 PR 併進 inkstone/InkStoneCo,雲端 clone 才拿得到" % rp)
|
||||||
|
return (" ⚠️ 這台找不到 InkStoneCo 的 system-dev/(CLAUDE_PROJECT_DIR 或 cwd 底下都沒有),"
|
||||||
|
"repo 那份沒更新——雲端仍會讀到舊主線")
|
||||||
|
|
||||||
|
|
||||||
def cmd_clear(argv):
|
def cmd_clear(argv):
|
||||||
had = ML.load()
|
had = ML.load()
|
||||||
ML.clear()
|
rp = ML.repo_path()
|
||||||
|
ML.clear(mirror=True)
|
||||||
print("✅ 已清掉主線%s。現在沒有主線——每回合的 🎯 那一行會照實說。"
|
print("✅ 已清掉主線%s。現在沒有主線——每回合的 🎯 那一行會照實說。"
|
||||||
% ("(原本是 %s「%s」)" % (ML.ref_of(had), had.get("title")) if had else ""))
|
% ("(原本是 %s「%s」)" % (ML.ref_of(had), had.get("title")) if had else ""))
|
||||||
|
if rp:
|
||||||
|
print(" repo 那份也刪了:%s(要 commit 才會到雲端)" % rp)
|
||||||
|
|
||||||
|
|
||||||
# ── refresh ──────────────────────────────────────────────────────────────
|
# ── refresh ──────────────────────────────────────────────────────────────
|
||||||
@@ -278,8 +294,9 @@ def cmd_adopt(argv):
|
|||||||
T.api("/repos/%s/%s/issues/%d" % (owner, repo, num), {"milestone": mid}, method="PATCH")
|
T.api("/repos/%s/%s/issues/%d" % (owner, repo, num), {"milestone": mid}, method="PATCH")
|
||||||
ref = "%s/%s#%d" % (owner, repo, num)
|
ref = "%s/%s#%d" % (owner, repo, num)
|
||||||
ms["members"] = sorted(set(ms.get("members") or []) | {ref})
|
ms["members"] = sorted(set(ms.get("members") or []) | {ref})
|
||||||
ML.save(ms)
|
ML.save(ms, mirror=True)
|
||||||
print("✅ 補收:%s 已掛進「%s」(%s/%s#%d)" % (ref, ms["title"], owner, repo, mid))
|
print("✅ 補收:%s 已掛進「%s」(%s/%s#%d)" % (ref, ms["title"], owner, repo, mid))
|
||||||
|
print(mirror_line())
|
||||||
|
|
||||||
|
|
||||||
# ── has ──────────────────────────────────────────────────────────────────
|
# ── has ──────────────────────────────────────────────────────────────────
|
||||||
|
|||||||
@@ -1,291 +0,0 @@
|
|||||||
#!/usr/bin/env python3
|
|
||||||
"""release-check — 回頭問「這一版真的送到了嗎」,而且**問的人不是送的人**
|
|
||||||
(inkstone/ISEP#67)
|
|
||||||
|
|
||||||
leo 2026-08-27 的病(票上原文):
|
|
||||||
「版本只到 ISEP v0.3.9,你有新版為什麼不推?」
|
|
||||||
v0.4.0/v0.5.0 的 tag 早就推了,但 Gitea Releases 頁停在 v0.3.9
|
|
||||||
⇒ 對 leo 等於這兩版不存在;claude plugin list 也還顯示舊版。
|
|
||||||
|
|
||||||
ISEP 的運送鏈有這幾段,**每一段都要有人回頭問「到了嗎」**:
|
|
||||||
|
|
||||||
定版 commit → tag(Gitea) → release(Gitea) → main 的 plugin.json
|
|
||||||
→ 這個 session 真的載入到的版本
|
|
||||||
|
|
||||||
🔴 這支的全部價值在一句話:**它不聽上一站說「我送了」,它自己去問收貨的那一端。**
|
|
||||||
tag 在不在 → 問 Gitea 的 tags;release 在不在 → 問 Gitea 的 releases(leo 會看的那頁);
|
|
||||||
載入到了沒 → 看這個 session 真的掛著的那一份 plugin.json。
|
|
||||||
送的人(release-ship)說「成功」不算數——這支拿收貨端的事實覆核。
|
|
||||||
|
|
||||||
判準是**結構**,不是關鍵字(leo 2026-08-17 已證偽關鍵字黑名單:8 次誤攔、0 次正確):
|
|
||||||
· 哪些版本「應該」被送到 = main 上有 `定版 vX.Y.Z` commit 的那些(git 說了算,不是猜)
|
|
||||||
· 那個版本「送到了沒」= 去 Gitea 問它的 tag 與 release 在不在(在=到了)
|
|
||||||
|
|
||||||
離開碼:
|
|
||||||
0 現行版本(plugin.json 宣稱的那一版)**tag 與 release 都在** ⇒ 送貨端完成
|
|
||||||
2 現行版本缺 tag 或缺 release ⇒ **送貨端斷了**,stderr 講出缺哪一站+怎麼補
|
|
||||||
(這正是工單驗收 4:「故意漏一步 → 管線要擋下來並說出缺哪一站」)
|
|
||||||
說明:比現行版本更舊的 `定版` 版本若缺 tag/release,只**黃字提醒**、不改離開碼——
|
|
||||||
它們多半已被新版取代,硬擋等於「懲罰謹慎」(over-block 比 under-block 嚴重)。
|
|
||||||
載入端落後(這個 session 跑的比 main 舊)也只提醒:那要 update+重啟,
|
|
||||||
是收貨端的動作,不是送貨端能修的,且 SessionStart 信標本來就一直在報。
|
|
||||||
|
|
||||||
離線測試:`scripts/test-release-check.sh`(走 `RELEASE_CHECK_FIXTURE`,不打 Gitea)。
|
|
||||||
"""
|
|
||||||
import json
|
|
||||||
import os
|
|
||||||
import re
|
|
||||||
import subprocess
|
|
||||||
import sys
|
|
||||||
import urllib.error
|
|
||||||
import urllib.request
|
|
||||||
|
|
||||||
HOST = os.environ.get("RELEASE_CHECK_HOST", "https://git.uncle6.me")
|
|
||||||
REPO = os.environ.get("RELEASE_CHECK_REPO", "inkstone/ISEP")
|
|
||||||
FIXTURE = os.environ.get("RELEASE_CHECK_FIXTURE", "")
|
|
||||||
HERE = os.path.dirname(os.path.abspath(__file__))
|
|
||||||
|
|
||||||
|
|
||||||
def die(msg, code=2):
|
|
||||||
print(msg, file=sys.stderr)
|
|
||||||
sys.exit(code)
|
|
||||||
|
|
||||||
|
|
||||||
def proj_root():
|
|
||||||
"""這支腳本操作的那個 ISEP repo 的根。"""
|
|
||||||
v = os.environ.get("CLAUDE_PROJECT_DIR")
|
|
||||||
if v and os.path.isfile(os.path.join(v, ".claude-plugin", "plugin.json")):
|
|
||||||
return v
|
|
||||||
return os.path.dirname(HERE)
|
|
||||||
|
|
||||||
|
|
||||||
def vtuple(v):
|
|
||||||
nums = re.findall(r"\d+", v or "")
|
|
||||||
return tuple(int(x) for x in nums[:3]) if nums else (0,)
|
|
||||||
|
|
||||||
|
|
||||||
# ══ 收貨端事實:全部從「別人」那裡拿,不聽送的人說 ═══════════════════════
|
|
||||||
def _fixture():
|
|
||||||
try:
|
|
||||||
with open(FIXTURE) as f:
|
|
||||||
return json.load(f)
|
|
||||||
except Exception:
|
|
||||||
die("🔴 讀不到 RELEASE_CHECK_FIXTURE:%s" % FIXTURE)
|
|
||||||
|
|
||||||
|
|
||||||
def token():
|
|
||||||
for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
|
|
||||||
if os.environ.get(env):
|
|
||||||
return os.environ[env]
|
|
||||||
root = os.environ.get("CLAUDE_PROJECT_DIR") or proj_root()
|
|
||||||
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)
|
|
||||||
return ""
|
|
||||||
|
|
||||||
|
|
||||||
def _api_names(path, key):
|
|
||||||
"""回一個 set:Gitea 上那個 collection 裡所有的名字(tag_name/name)。"""
|
|
||||||
tk = token()
|
|
||||||
if not tk:
|
|
||||||
die("🔴 拿不到 %s 的 token(remote 沒帶憑證,也沒有 GITEA_TOKEN_CLAUDE_CODE)" % HOST)
|
|
||||||
names, page = set(), 1
|
|
||||||
while True:
|
|
||||||
url = "%s/api/v1/repos/%s/%s?limit=50&page=%d" % (HOST, REPO, path, page)
|
|
||||||
req = urllib.request.Request(url, headers={"Authorization": "token " + tk})
|
|
||||||
try:
|
|
||||||
rows = json.load(urllib.request.urlopen(req, timeout=25))
|
|
||||||
except urllib.error.HTTPError as e:
|
|
||||||
die("🔴 Gitea %s:%s" % (e.code, e.read().decode()[:200]))
|
|
||||||
except Exception as e:
|
|
||||||
die("🔴 連不上 %s:%s" % (HOST, e))
|
|
||||||
if not rows:
|
|
||||||
break
|
|
||||||
for r in rows:
|
|
||||||
n = r.get(key)
|
|
||||||
if n:
|
|
||||||
names.add(n)
|
|
||||||
if len(rows) < 50:
|
|
||||||
break
|
|
||||||
page += 1
|
|
||||||
return names
|
|
||||||
|
|
||||||
|
|
||||||
def gitea_tags():
|
|
||||||
if FIXTURE:
|
|
||||||
return set(_fixture().get("tags") or [])
|
|
||||||
return _api_names("tags", "name")
|
|
||||||
|
|
||||||
|
|
||||||
def gitea_releases():
|
|
||||||
if FIXTURE:
|
|
||||||
return set(_fixture().get("releases") or [])
|
|
||||||
return _api_names("releases", "tag_name")
|
|
||||||
|
|
||||||
|
|
||||||
# ══ 送貨端事實:main 上「定版」了哪些、現在宣稱哪一版、這個 session 載到哪一版 ══
|
|
||||||
def dingban_versions():
|
|
||||||
"""main 上有 `定版 vX.Y.Z` commit 的版本 —— 「應該被送到」的權威清單。"""
|
|
||||||
if FIXTURE:
|
|
||||||
return list(_fixture().get("dingban") or [])
|
|
||||||
root = proj_root()
|
|
||||||
try:
|
|
||||||
out = subprocess.run(
|
|
||||||
["git", "-C", root, "log", "--format=%s", "--grep", "定版 v"],
|
|
||||||
capture_output=True, text=True, timeout=30).stdout
|
|
||||||
except Exception:
|
|
||||||
out = ""
|
|
||||||
seen, vers = set(), []
|
|
||||||
for line in out.splitlines():
|
|
||||||
m = re.search(r"定版\s+v?(\d+\.\d+\.\d+)", line)
|
|
||||||
if m and m.group(1) not in seen:
|
|
||||||
seen.add(m.group(1))
|
|
||||||
vers.append(m.group(1))
|
|
||||||
return vers
|
|
||||||
|
|
||||||
|
|
||||||
def current_version():
|
|
||||||
"""plugin.json 現在宣稱的那一版(= main 要送出去的那一版)。"""
|
|
||||||
if FIXTURE:
|
|
||||||
return _fixture().get("current") or ""
|
|
||||||
try:
|
|
||||||
with open(os.path.join(proj_root(), ".claude-plugin", "plugin.json")) as f:
|
|
||||||
return json.load(f).get("version") or ""
|
|
||||||
except Exception:
|
|
||||||
return ""
|
|
||||||
|
|
||||||
|
|
||||||
def loaded_version():
|
|
||||||
"""這個 session 真的掛著的那一份 plugin 是哪一版(收貨端最後一段)。
|
|
||||||
|
|
||||||
拿不到就回 None —— 不猜、不謊稱到了(house style:不知道就說不知道)。
|
|
||||||
"""
|
|
||||||
if FIXTURE:
|
|
||||||
return _fixture().get("loaded")
|
|
||||||
root = os.environ.get("CLAUDE_PLUGIN_ROOT")
|
|
||||||
if not root:
|
|
||||||
return None
|
|
||||||
try:
|
|
||||||
with open(os.path.join(root, ".claude-plugin", "plugin.json")) as f:
|
|
||||||
return json.load(f).get("version")
|
|
||||||
except Exception:
|
|
||||||
return None
|
|
||||||
|
|
||||||
|
|
||||||
# ══ 覆核:逐版問「到了嗎」 ════════════════════════════════════════════════
|
|
||||||
def audit():
|
|
||||||
cur = current_version()
|
|
||||||
if not cur:
|
|
||||||
die("🔴 讀不到 .claude-plugin/plugin.json 的 version —— 這不是 ISEP repo,或檔案壞了。")
|
|
||||||
dingban = dingban_versions()
|
|
||||||
if cur not in dingban:
|
|
||||||
# 現行版本連 `定版` commit 都沒有 ⇒ plugin.json 宣稱了一個沒被定版的號碼。
|
|
||||||
# 這是 check-version-consistency 那條線的病,不是這支的守備範圍——但要講出來。
|
|
||||||
dingban = [cur] + dingban
|
|
||||||
tags = gitea_tags()
|
|
||||||
rels = gitea_releases()
|
|
||||||
|
|
||||||
def tagname(v):
|
|
||||||
return "v" + v
|
|
||||||
|
|
||||||
rows = []
|
|
||||||
for v in sorted(set(dingban), key=vtuple, reverse=True):
|
|
||||||
rows.append({
|
|
||||||
"ver": v,
|
|
||||||
"dingban": True, # 這份清單本來就是從 定版 commit 來的
|
|
||||||
"tag": tagname(v) in tags,
|
|
||||||
"release": tagname(v) in rels,
|
|
||||||
"current": v == cur,
|
|
||||||
})
|
|
||||||
return cur, rows
|
|
||||||
|
|
||||||
|
|
||||||
STATIONS = [
|
|
||||||
("dingban", "定版 commit", "在 main 上 commit 一顆 `定版 v<版本>`(= plugin.json 也改成那一版)"),
|
|
||||||
("tag", "tag(Gitea)", "打並推 tag:`git tag v<版本> && git push origin v<版本>`"),
|
|
||||||
("release", "release(Gitea)", "建 release:`scripts/release-ship v<版本>`(這一站就是最常斷的那站)"),
|
|
||||||
]
|
|
||||||
|
|
||||||
|
|
||||||
def report():
|
|
||||||
cur, rows = audit()
|
|
||||||
loaded = loaded_version()
|
|
||||||
icon = {True: "✅", False: "❌"}
|
|
||||||
lines = ["ISEP 運送鏈覆核(收貨端事實,不聽送的人說) repo=%s" % REPO, ""]
|
|
||||||
lines.append(" 版本 定版 tag release (← =現行 plugin.json 宣稱的版本)")
|
|
||||||
for r in rows:
|
|
||||||
mark = " ←" if r["current"] else ""
|
|
||||||
lines.append(" %-10s %s %s %s%s" % (
|
|
||||||
"v" + r["ver"], icon[r["dingban"]], icon[r["tag"]], icon[r["release"]], mark))
|
|
||||||
|
|
||||||
# ── 載入端(這個 session)──────────────────────────────────────────
|
|
||||||
lines.append("")
|
|
||||||
if loaded is None:
|
|
||||||
lines.append(" 載入端:這個 context 讀不到 CLAUDE_PLUGIN_ROOT ⇒ 說不出「這個 session 載到哪一版」"
|
|
||||||
"(不是 session 裡跑的,或沒裝 plugin)。")
|
|
||||||
elif vtuple(loaded) < vtuple(cur):
|
|
||||||
lines.append(" 🟡 載入端落後:這個 session 掛的是 v%s,main 已到 v%s。" % (loaded, cur))
|
|
||||||
lines.append(" 修:本機 `claude plugin update isep@inkstone` **並重啟 session**"
|
|
||||||
"(升版與生效是兩件事);雲端去動一下 Environment 的 setup script 逼它重拍快照。")
|
|
||||||
lines.append(" 這一段 SessionStart 信標本來就一直在報(beacon_report.py ①)。")
|
|
||||||
else:
|
|
||||||
lines.append(" ✅ 載入端:這個 session 掛的是 v%s,跟 main 宣稱的一致。" % loaded)
|
|
||||||
|
|
||||||
# ── 判決 ────────────────────────────────────────────────────────────
|
|
||||||
currow = next((r for r in rows if r["current"]), None)
|
|
||||||
hard = []
|
|
||||||
if currow:
|
|
||||||
for key, label, fix in STATIONS:
|
|
||||||
if not currow[key]:
|
|
||||||
hard.append((label, fix))
|
|
||||||
older_gaps = [r for r in rows if not r["current"] and (not r["tag"] or not r["release"])]
|
|
||||||
|
|
||||||
lines.append("")
|
|
||||||
if hard:
|
|
||||||
lines.append("🔴 **現行版本 v%s 的送貨端斷了** —— 對 leo 等於這一版不存在:" % cur)
|
|
||||||
for label, fix in hard:
|
|
||||||
lines.append(" 缺這一站:%s" % label)
|
|
||||||
lines.append(" 怎麼補:%s" % fix)
|
|
||||||
if older_gaps:
|
|
||||||
lines.append(" (另外還有更舊的版本也缺,見下方黃字,但那些不擋。)")
|
|
||||||
else:
|
|
||||||
lines.append("✅ 現行版本 v%s:定版、tag、release 都在 —— 送貨端完成,leo 那頁看得到。" % cur)
|
|
||||||
|
|
||||||
if older_gaps:
|
|
||||||
lines.append("")
|
|
||||||
lines.append("🟡 更舊的定版版本也缺件(多半已被新版取代,只提醒、不擋):")
|
|
||||||
for r in older_gaps:
|
|
||||||
miss = []
|
|
||||||
if not r["tag"]:
|
|
||||||
miss.append("tag")
|
|
||||||
if not r["release"]:
|
|
||||||
miss.append("release")
|
|
||||||
lines.append(" v%s 缺:%s" % (r["ver"], "+".join(miss)))
|
|
||||||
lines.append(" 要補歷史版本 ⇒ 逐版 `scripts/release-ship v<版本>`;"
|
|
||||||
"確定不補 ⇒ 這是 leo/總管的決定,記一句在 inkstone/ISEP#67。")
|
|
||||||
|
|
||||||
out = "\n".join(lines)
|
|
||||||
if hard:
|
|
||||||
print(out, file=sys.stderr)
|
|
||||||
return 2
|
|
||||||
print(out)
|
|
||||||
return 0
|
|
||||||
|
|
||||||
|
|
||||||
def main(argv):
|
|
||||||
if argv and argv[0] in ("-h", "--help"):
|
|
||||||
print(__doc__)
|
|
||||||
return 0
|
|
||||||
return report()
|
|
||||||
|
|
||||||
|
|
||||||
if __name__ == "__main__":
|
|
||||||
sys.exit(main(sys.argv[1:]))
|
|
||||||
@@ -1,360 +0,0 @@
|
|||||||
#!/usr/bin/env python3
|
|
||||||
"""release-ship — 把「已經推上去的 tag」變成「leo 那頁看得到的 release」
|
|
||||||
(inkstone/ISEP#67,對應 arcrun-rag 的 release-record 站)
|
|
||||||
|
|
||||||
工單抓到的斷點,一句話:**沒有任何東西會建 release。**
|
|
||||||
ISEP repo 全樹 grep「建 release」的 API 呼叫 → 0 命中。
|
|
||||||
後果:v0.22.0 的 tag 早就推了,Gitea Releases 頁卻停在 v0.18.0
|
|
||||||
⇒ 對 leo 等於這一版不存在(「ISEP 現在是哪一版」只有 Releases 答得出來)。
|
|
||||||
|
|
||||||
這支就是補上那一站。它**只做 tag → release** 這一段,不打 tag、不改 plugin.json、
|
|
||||||
不碰 main —— 打 tag 是 `release-tag-guard.sh` 在管的、總管驗過整個 milestone 之後的動作。
|
|
||||||
|
|
||||||
🔴 送之前,三件事「必須在場」才放行(require-something-present,不是關鍵字黑名單):
|
|
||||||
① 版本一致:`plugin.json` 的 version = 這個 tag 的號碼
|
|
||||||
—— 直接跑既有的 `scripts/check-version-consistency.sh`,**不另寫一套判準**。
|
|
||||||
② tag 真的在 Gitea 上:去問收貨端,不在就不給建 release(先去推 tag)。
|
|
||||||
③ release note 有內容:沒給 `--notes-file` 就從 `git log <上一個release>..<tag>`
|
|
||||||
自動生一份**事實**清單(哪幾顆 commit)——leo 可以再改,但不留白。
|
|
||||||
|
|
||||||
🔴 送完**自己不算數**:最後回頭跑一次 `release-check`,拿收貨端(Gitea releases 頁)
|
|
||||||
的事實覆核「真的建起來了」。送的人說成功不算,問收貨的那一端才算
|
|
||||||
(工單:「問的人不能是送的人」)。
|
|
||||||
|
|
||||||
冪等:release 已經在了 ⇒ 報「已存在」、離開碼 0,不重複建、不報錯。
|
|
||||||
|
|
||||||
離開碼:0 = release 在 Gitea 上了(新建的或本來就在)
|
|
||||||
2 = 某個前置條件沒滿足(stderr 講出是哪一個+怎麼補)
|
|
||||||
|
|
||||||
離線測試:`scripts/test-release-ship.sh`(走 `RELEASE_SHIP_FIXTURE`,不打 Gitea、不建真 release)。
|
|
||||||
"""
|
|
||||||
import json
|
|
||||||
import os
|
|
||||||
import re
|
|
||||||
import subprocess
|
|
||||||
import sys
|
|
||||||
import urllib.error
|
|
||||||
import urllib.request
|
|
||||||
|
|
||||||
HOST = os.environ.get("RELEASE_SHIP_HOST", "https://git.uncle6.me")
|
|
||||||
REPO = os.environ.get("RELEASE_SHIP_REPO", "inkstone/ISEP")
|
|
||||||
FIXTURE = os.environ.get("RELEASE_SHIP_FIXTURE", "")
|
|
||||||
HERE = os.path.dirname(os.path.abspath(__file__))
|
|
||||||
VER_RE = re.compile(r"^v?(\d+\.\d+\.\d+)$")
|
|
||||||
|
|
||||||
|
|
||||||
def die(msg, code=2):
|
|
||||||
print(msg, file=sys.stderr)
|
|
||||||
sys.exit(code)
|
|
||||||
|
|
||||||
|
|
||||||
def proj_root():
|
|
||||||
v = os.environ.get("CLAUDE_PROJECT_DIR")
|
|
||||||
if v and os.path.isfile(os.path.join(v, ".claude-plugin", "plugin.json")):
|
|
||||||
return v
|
|
||||||
return os.path.dirname(HERE)
|
|
||||||
|
|
||||||
|
|
||||||
def _fixture():
|
|
||||||
try:
|
|
||||||
with open(FIXTURE) as f:
|
|
||||||
return json.load(f)
|
|
||||||
except Exception:
|
|
||||||
die("🔴 讀不到 RELEASE_SHIP_FIXTURE:%s" % FIXTURE)
|
|
||||||
|
|
||||||
|
|
||||||
def token():
|
|
||||||
for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
|
|
||||||
if os.environ.get(env):
|
|
||||||
return os.environ[env]
|
|
||||||
root = os.environ.get("CLAUDE_PROJECT_DIR") or proj_root()
|
|
||||||
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)
|
|
||||||
return ""
|
|
||||||
|
|
||||||
|
|
||||||
# ══ 前置條件 ① 版本一致(重用既有腳本,不另寫判準)═══════════════════════
|
|
||||||
def check_consistency():
|
|
||||||
if FIXTURE:
|
|
||||||
fx = _fixture()
|
|
||||||
return bool(fx.get("consistency_ok", True)), fx.get("consistency_msg", "")
|
|
||||||
script = os.path.join(proj_root(), "scripts", "check-version-consistency.sh")
|
|
||||||
if not os.path.isfile(script):
|
|
||||||
return False, "找不到 scripts/check-version-consistency.sh —— 這不是 ISEP repo?"
|
|
||||||
p = subprocess.run(["sh", script], capture_output=True, text=True, timeout=30)
|
|
||||||
return p.returncode == 0, (p.stdout + p.stderr).strip()
|
|
||||||
|
|
||||||
|
|
||||||
# ══ 前置條件 ② tag 在不在 Gitea(問收貨端)═════════════════════════════════
|
|
||||||
def gitea_has_tag(tagname):
|
|
||||||
if FIXTURE:
|
|
||||||
return tagname in set(_fixture().get("tags") or [])
|
|
||||||
tk = token()
|
|
||||||
if not tk:
|
|
||||||
die("🔴 拿不到 %s 的 token(remote 沒帶憑證,也沒有 GITEA_TOKEN_CLAUDE_CODE)" % HOST)
|
|
||||||
url = "%s/api/v1/repos/%s/tags/%s" % (HOST, REPO, tagname)
|
|
||||||
req = urllib.request.Request(url, headers={"Authorization": "token " + tk})
|
|
||||||
try:
|
|
||||||
urllib.request.urlopen(req, timeout=25)
|
|
||||||
return True
|
|
||||||
except urllib.error.HTTPError as e:
|
|
||||||
if e.code == 404:
|
|
||||||
return False
|
|
||||||
die("🔴 Gitea %s:%s" % (e.code, e.read().decode()[:200]))
|
|
||||||
except Exception as e:
|
|
||||||
die("🔴 連不上 %s:%s" % (HOST, e))
|
|
||||||
|
|
||||||
|
|
||||||
def gitea_release(tagname):
|
|
||||||
"""回這個 tag 的 release dict,沒有回 None。"""
|
|
||||||
if FIXTURE:
|
|
||||||
rels = _fixture().get("releases") or []
|
|
||||||
if tagname in rels:
|
|
||||||
return {"tag_name": tagname, "html_url": "(fixture)"}
|
|
||||||
return None
|
|
||||||
tk = token()
|
|
||||||
url = "%s/api/v1/repos/%s/releases/tags/%s" % (HOST, REPO, tagname)
|
|
||||||
req = urllib.request.Request(url, headers={"Authorization": "token " + tk})
|
|
||||||
try:
|
|
||||||
return json.load(urllib.request.urlopen(req, timeout=25))
|
|
||||||
except urllib.error.HTTPError as e:
|
|
||||||
if e.code == 404:
|
|
||||||
return None
|
|
||||||
die("🔴 Gitea %s:%s" % (e.code, e.read().decode()[:200]))
|
|
||||||
except Exception as e:
|
|
||||||
die("🔴 連不上 %s:%s" % (HOST, e))
|
|
||||||
|
|
||||||
|
|
||||||
# ══ 前置條件 ③ release note ════════════════════════════════════════════════
|
|
||||||
def latest_release_before(ver):
|
|
||||||
"""比 ver 舊、且在 Gitea 上有 release 的最新那一版 tag(拿來當 git log 起點)。"""
|
|
||||||
if FIXTURE:
|
|
||||||
rels = _fixture().get("releases") or []
|
|
||||||
else:
|
|
||||||
tk = token()
|
|
||||||
url = "%s/api/v1/repos/%s/releases?limit=50" % (HOST, REPO)
|
|
||||||
req = urllib.request.Request(url, headers={"Authorization": "token " + tk})
|
|
||||||
try:
|
|
||||||
rels = [r.get("tag_name") for r in
|
|
||||||
json.load(urllib.request.urlopen(req, timeout=25))]
|
|
||||||
except Exception:
|
|
||||||
rels = []
|
|
||||||
|
|
||||||
def vt(v):
|
|
||||||
n = re.findall(r"\d+", v or "")
|
|
||||||
return tuple(int(x) for x in n[:3]) if n else (0,)
|
|
||||||
older = [t for t in rels if t and vt(t) < vt(ver)]
|
|
||||||
return max(older, key=vt) if older else None
|
|
||||||
|
|
||||||
|
|
||||||
def dingban_title(ver):
|
|
||||||
"""這個版本的 `定版 vX.Y.Z(…)` commit 裡括號那句話 —— 拿來當 release 名,
|
|
||||||
對齊 leo 既有 release 的命名慣例(`vX.Y.Z — 一句人話`)。找不到就回純 tag 名。"""
|
|
||||||
if FIXTURE:
|
|
||||||
return None
|
|
||||||
root = proj_root()
|
|
||||||
try:
|
|
||||||
out = subprocess.run(
|
|
||||||
["git", "-C", root, "log", "--format=%s", "--grep", "定版 v%s" % ver],
|
|
||||||
capture_output=True, text=True, timeout=30).stdout
|
|
||||||
except Exception:
|
|
||||||
out = ""
|
|
||||||
for line in out.splitlines():
|
|
||||||
m = re.search(r"定版\s+v%s[((]([^))]+)[))]" % re.escape(ver), line)
|
|
||||||
if m:
|
|
||||||
return m.group(1).strip()
|
|
||||||
return None
|
|
||||||
|
|
||||||
|
|
||||||
def auto_notes(tagname):
|
|
||||||
"""從 git log 生一份事實 note:上一個 release 之後到這個 tag 之間的 commit。"""
|
|
||||||
root = proj_root()
|
|
||||||
since = latest_release_before(tagname)
|
|
||||||
rng = ("%s..%s" % (since, tagname)) if since else tagname
|
|
||||||
try:
|
|
||||||
out = subprocess.run(
|
|
||||||
["git", "-C", root, "log", "--no-merges", "--format=- %s", rng],
|
|
||||||
capture_output=True, text=True, timeout=30)
|
|
||||||
body = out.stdout.strip()
|
|
||||||
except Exception:
|
|
||||||
body = ""
|
|
||||||
head = ("這一版收了以下改動(%s 之後):" % since) if since \
|
|
||||||
else "這一版收了以下改動:"
|
|
||||||
if not body:
|
|
||||||
body = "-(git log 取不到 commit 清單,請手動補;release 已建起來,leo 可直接編輯。)"
|
|
||||||
return ("%s\n\n%s\n\n---\n(本 note 由 scripts/release-ship 從 git log 自動生成,"
|
|
||||||
"leo/總管可直接在 Gitea 上編輯。inkstone/ISEP#67)" % (head, body))
|
|
||||||
|
|
||||||
|
|
||||||
# ══ 真的建 release(POST 收貨端)═══════════════════════════════════════════
|
|
||||||
def create_release(tagname, notes, dry, name=None):
|
|
||||||
name = name or tagname
|
|
||||||
payload = {"tag_name": tagname, "name": name, "body": notes,
|
|
||||||
"draft": False, "prerelease": False}
|
|
||||||
if dry:
|
|
||||||
return None, "🧪 --dry-run:不 POST。要建的 release payload:\n%s" % \
|
|
||||||
json.dumps({"tag_name": tagname, "name": name,
|
|
||||||
"body_lines": notes.count("\n") + 1}, ensure_ascii=False)
|
|
||||||
if FIXTURE:
|
|
||||||
sink = os.environ.get("RELEASE_SHIP_SINK")
|
|
||||||
if sink:
|
|
||||||
try:
|
|
||||||
cur = json.load(open(sink)) if os.path.exists(sink) else []
|
|
||||||
except Exception:
|
|
||||||
cur = []
|
|
||||||
cur.append(tagname)
|
|
||||||
json.dump(cur, open(sink, "w"))
|
|
||||||
return {"tag_name": tagname, "html_url": "(fixture-created)"}, "(fixture 模式,未打網路)"
|
|
||||||
tk = token()
|
|
||||||
if not tk:
|
|
||||||
die("🔴 拿不到 %s 的 token —— 建 release 是寫入,一定要憑證。" % HOST)
|
|
||||||
url = "%s/api/v1/repos/%s/releases" % (HOST, REPO)
|
|
||||||
req = urllib.request.Request(
|
|
||||||
url, data=json.dumps(payload).encode(), method="POST",
|
|
||||||
headers={"Authorization": "token " + tk, "Content-Type": "application/json"})
|
|
||||||
try:
|
|
||||||
r = json.load(urllib.request.urlopen(req, timeout=40))
|
|
||||||
return r, "已建立"
|
|
||||||
except urllib.error.HTTPError as e:
|
|
||||||
die("🔴 Gitea 建 release 失敗 %s:%s" % (e.code, e.read().decode()[:300]))
|
|
||||||
except Exception as e:
|
|
||||||
die("🔴 連不上 %s:%s" % (HOST, e))
|
|
||||||
|
|
||||||
|
|
||||||
# ══ 送完覆核:回頭問收貨端(不是問自己)══════════════════════════════════
|
|
||||||
def verify_via_check():
|
|
||||||
"""跑 release-check,拿收貨端事實覆核。回 (ok, 輸出)。"""
|
|
||||||
check = os.path.join(HERE, "release-check")
|
|
||||||
env = dict(os.environ)
|
|
||||||
if FIXTURE:
|
|
||||||
# fixture 模式下,把剛「建」進 sink 的 release 併進 release-check 的 fixture 視圖
|
|
||||||
fx = _fixture()
|
|
||||||
sink = os.environ.get("RELEASE_SHIP_SINK")
|
|
||||||
extra = []
|
|
||||||
if sink and os.path.exists(sink):
|
|
||||||
try:
|
|
||||||
extra = json.load(open(sink))
|
|
||||||
except Exception:
|
|
||||||
extra = []
|
|
||||||
merged = dict(fx)
|
|
||||||
merged["releases"] = sorted(set((fx.get("releases") or []) + extra))
|
|
||||||
cf = (os.environ.get("RELEASE_SHIP_SINK") or "/tmp/rs") + ".checkfx.json"
|
|
||||||
json.dump(merged, open(cf, "w"))
|
|
||||||
env["RELEASE_CHECK_FIXTURE"] = cf
|
|
||||||
try:
|
|
||||||
p = subprocess.run(["python3", check], capture_output=True, text=True,
|
|
||||||
timeout=60, env=env)
|
|
||||||
return p.returncode == 0, (p.stdout + p.stderr).strip()
|
|
||||||
except Exception as e:
|
|
||||||
return False, "跑不動 release-check:%s" % e
|
|
||||||
|
|
||||||
|
|
||||||
# ══ 主流程 ════════════════════════════════════════════════════════════════
|
|
||||||
def ship(arg, notes_file=None, dry=False, do_verify=True):
|
|
||||||
m = VER_RE.match(arg.strip())
|
|
||||||
if not m:
|
|
||||||
die("🔴 版本寫法是 vX.Y.Z 或 X.Y.Z,你給的是:%s" % arg)
|
|
||||||
ver = m.group(1)
|
|
||||||
tagname = "v" + ver
|
|
||||||
out = ["📦 release-ship %s(把 tag 變成 leo 看得到的 release)" % tagname, ""]
|
|
||||||
|
|
||||||
# 前置 ①
|
|
||||||
ok, msg = check_consistency()
|
|
||||||
if not ok:
|
|
||||||
die("🚫 前置①版本一致性沒過 —— 不給建 release。\n%s\n"
|
|
||||||
" (plugin.json 的 version 要等於 %s。這一步重用 "
|
|
||||||
"scripts/check-version-consistency.sh 的判準,不另立一套。)" % (msg, tagname))
|
|
||||||
out.append("✅ 前置① 版本一致(plugin.json = %s)" % tagname)
|
|
||||||
|
|
||||||
# 前置 ②
|
|
||||||
if not gitea_has_tag(tagname):
|
|
||||||
die("🚫 前置② Gitea 上沒有 tag %s —— 不給建 release。\n"
|
|
||||||
" release 是「把已存在的 tag 公開成一頁」,tag 都還沒推,先推:\n"
|
|
||||||
" git tag %s && git push origin %s\n"
|
|
||||||
" (推 tag 那一刻 release-tag-guard.sh 會擋下版本對不上的 tag。)"
|
|
||||||
% (tagname, tagname, tagname))
|
|
||||||
out.append("✅ 前置② Gitea 上有 tag %s(問過收貨端)" % tagname)
|
|
||||||
|
|
||||||
# 冪等
|
|
||||||
existing = gitea_release(tagname)
|
|
||||||
if existing:
|
|
||||||
out.append("ℹ️ release %s 本來就在了(%s)—— 不重複建。"
|
|
||||||
% (tagname, existing.get("html_url") or ""))
|
|
||||||
code = 0
|
|
||||||
if do_verify:
|
|
||||||
vok, vout = verify_via_check()
|
|
||||||
out.append("")
|
|
||||||
out.append("── 覆核(release-check,問收貨端)──")
|
|
||||||
out.append(vout)
|
|
||||||
code = 0 if vok else 2
|
|
||||||
return code, "\n".join(out)
|
|
||||||
|
|
||||||
# 前置 ③
|
|
||||||
if notes_file:
|
|
||||||
with open(notes_file) as f:
|
|
||||||
notes = f.read()
|
|
||||||
out.append("✅ 前置③ release note 來自 %s" % notes_file)
|
|
||||||
else:
|
|
||||||
notes = auto_notes(tagname)
|
|
||||||
out.append("✅ 前置③ release note 由 git log 自動生成(leo 可再改)")
|
|
||||||
|
|
||||||
# 建(release 名對齊 leo 慣例:vX.Y.Z — 定版 commit 那句人話)
|
|
||||||
title = dingban_title(ver)
|
|
||||||
relname = ("%s — %s" % (tagname, title)) if title else tagname
|
|
||||||
rel, how = create_release(tagname, notes, dry, name=relname)
|
|
||||||
if dry:
|
|
||||||
out.append(" release 名:%s" % relname)
|
|
||||||
out.append("")
|
|
||||||
out.append(how)
|
|
||||||
return 0, "\n".join(out)
|
|
||||||
out.append("✅ 已建立 release「%s」(%s)" % (relname, (rel or {}).get("html_url") or how))
|
|
||||||
|
|
||||||
# 覆核(送完問收貨端)
|
|
||||||
code = 0
|
|
||||||
if do_verify:
|
|
||||||
vok, vout = verify_via_check()
|
|
||||||
out.append("")
|
|
||||||
out.append("── 覆核(release-check,問收貨端,不是問自己)──")
|
|
||||||
out.append(vout)
|
|
||||||
code = 0 if vok else 2
|
|
||||||
return code, "\n".join(out)
|
|
||||||
|
|
||||||
|
|
||||||
def main(argv):
|
|
||||||
arg, notes_file, dry, do_verify = None, None, False, True
|
|
||||||
i = 0
|
|
||||||
while i < len(argv):
|
|
||||||
a = argv[i]
|
|
||||||
if a in ("-h", "--help"):
|
|
||||||
print(__doc__)
|
|
||||||
return 0
|
|
||||||
elif a == "--notes-file":
|
|
||||||
i += 1
|
|
||||||
notes_file = argv[i]
|
|
||||||
elif a == "--dry-run":
|
|
||||||
dry = True
|
|
||||||
elif a == "--no-verify":
|
|
||||||
do_verify = False
|
|
||||||
elif a.startswith("-"):
|
|
||||||
die("不認得的參數:%s(--help 看用法)" % a)
|
|
||||||
else:
|
|
||||||
arg = a
|
|
||||||
i += 1
|
|
||||||
if not arg:
|
|
||||||
die("用法:release-ship <版本 vX.Y.Z> [--notes-file <檔>] [--dry-run] [--no-verify]")
|
|
||||||
code, report = ship(arg, notes_file, dry, do_verify)
|
|
||||||
print(report, file=(sys.stdout if code == 0 else sys.stderr))
|
|
||||||
return code
|
|
||||||
|
|
||||||
|
|
||||||
if __name__ == "__main__":
|
|
||||||
sys.exit(main(sys.argv[1:]))
|
|
||||||
Executable
+146
@@ -0,0 +1,146 @@
|
|||||||
|
#!/usr/bin/env python3
|
||||||
|
"""settings-allow-sync — 把 ISEP 的權限白名單寫進**這台機器**的 ~/.claude/settings.json
|
||||||
|
(inkstone/ISEP#130)
|
||||||
|
|
||||||
|
━━ 為什麼有這支 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||||
|
leo 09-07 親手把四個 Gitea 正門工具(`ticket`/`mainline`/`gate-ok`/`gitea-pr-merge`)
|
||||||
|
加進本機 `InkStoneCo/.claude/settings.json` 的 `permissions.allow`,auto mode 的分類器
|
||||||
|
才不擋。**雲端 session 沒有那四條** ⇒ 同樣的動作在雲端照樣被擋
|
||||||
|
(09-04 progress-guard run log:permission_denials=6)。
|
||||||
|
|
||||||
|
雲端真正讀的是薄殼 repo(GitHub)的 settings——推它要 D20 開閘(leo 親跑 github-arm)。
|
||||||
|
⇒ 白名單不住薄殼、也不住 InkStoneCo,**住 ISEP 一份**(`docs/permissions-allow.json`),
|
||||||
|
由本支在那台機器上寫進 `~/.claude/settings.json`(user scope,跟 cwd 無關)。
|
||||||
|
雲端:`docs/cloud-setup-script.sh` 裝完 plugin 就跑一次;之後每個 SessionStart 再對一次,
|
||||||
|
plugin 更新帶進新規則時不必等快照重拍。本機:同一支、同一份清單。
|
||||||
|
|
||||||
|
━━ 規矩 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||||
|
· 只加不減:settings.json 裡本來就有的東西一個字不動(別人手加的規則不是本支的地盤)。
|
||||||
|
· 冪等:跑第二次 +0 條,檔案一個位元組都不變。
|
||||||
|
· 清單裡開頭的 `~` 換成這台的家目錄(本機 /Users/…、雲端 /root),其餘照抄。
|
||||||
|
· 原子寫:先寫暫存檔再 rename,中途斷掉不會留下半個 JSON。
|
||||||
|
· 讀不懂目標(不是 JSON)⇒ **不碰它**、印出來、離開碼 0——這支掛在 SessionStart,
|
||||||
|
不准因為它把 session 弄壞;`--check` 才會用離開碼講話。
|
||||||
|
|
||||||
|
━━ 用法 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||||
|
settings-allow-sync 寫進 ~/.claude/settings.json
|
||||||
|
settings-allow-sync --dry-run 只印會加哪幾條,不寫
|
||||||
|
settings-allow-sync --check 對帳:缺任何一條 ⇒ 離開碼 1(測試/驗收用)
|
||||||
|
settings-allow-sync --target <檔> --home <家目錄> 測試用:指到別的檔、別的家目錄
|
||||||
|
settings-allow-sync --quiet 沒事就閉嘴(SessionStart 用)
|
||||||
|
"""
|
||||||
|
import json
|
||||||
|
import os
|
||||||
|
import sys
|
||||||
|
import tempfile
|
||||||
|
|
||||||
|
HERE = os.path.dirname(os.path.abspath(__file__))
|
||||||
|
SOURCE = os.path.join(HERE, "..", "docs", "permissions-allow.json")
|
||||||
|
|
||||||
|
|
||||||
|
def wanted(home):
|
||||||
|
with open(SOURCE, encoding="utf-8") as f:
|
||||||
|
d = json.load(f)
|
||||||
|
out = []
|
||||||
|
for rule in d.get("allow") or []:
|
||||||
|
if not isinstance(rule, str) or not rule.startswith("Bash(") or not rule.endswith(")"):
|
||||||
|
raise ValueError("清單裡有一條不是 Bash(…) 的形狀:%r" % (rule,))
|
||||||
|
inner = rule[len("Bash("):-1]
|
||||||
|
# 只換「路徑開頭」的 ~:`python3 ~/.claude/…` 這種。`~` 出現在別處不動。
|
||||||
|
parts = inner.split(" ")
|
||||||
|
parts = [home + p[1:] if p.startswith("~/") else p for p in parts]
|
||||||
|
out.append("Bash(" + " ".join(parts) + ")")
|
||||||
|
return out
|
||||||
|
|
||||||
|
|
||||||
|
def main(argv):
|
||||||
|
target = os.path.join(os.path.expanduser("~"), ".claude", "settings.json")
|
||||||
|
home = os.path.expanduser("~")
|
||||||
|
dry = check = quiet = False
|
||||||
|
i = 0
|
||||||
|
while i < len(argv):
|
||||||
|
a = argv[i]
|
||||||
|
if a == "--target":
|
||||||
|
i += 1; target = argv[i]
|
||||||
|
elif a == "--home":
|
||||||
|
i += 1; home = argv[i].rstrip("/")
|
||||||
|
elif a == "--dry-run":
|
||||||
|
dry = True
|
||||||
|
elif a == "--check":
|
||||||
|
check = True
|
||||||
|
elif a == "--quiet":
|
||||||
|
quiet = True
|
||||||
|
elif a in ("-h", "--help"):
|
||||||
|
print(__doc__); return 0
|
||||||
|
else:
|
||||||
|
print("不認得的參數:%s(--help 看用法)" % a, file=sys.stderr); return 2
|
||||||
|
i += 1
|
||||||
|
|
||||||
|
try:
|
||||||
|
rules = wanted(home)
|
||||||
|
except Exception as e:
|
||||||
|
print("🔴 讀不了白名單清單 %s:%s" % (SOURCE, e), file=sys.stderr)
|
||||||
|
return 1 if check else 0
|
||||||
|
|
||||||
|
cur = {}
|
||||||
|
if os.path.exists(target):
|
||||||
|
try:
|
||||||
|
with open(target, encoding="utf-8") as f:
|
||||||
|
cur = json.load(f)
|
||||||
|
if not isinstance(cur, dict):
|
||||||
|
raise ValueError("最外層不是物件")
|
||||||
|
except Exception as e:
|
||||||
|
print("🔴 %s 讀不懂(%s)——**沒有動它**。修好它再跑一次。" % (target, e), file=sys.stderr)
|
||||||
|
return 1 if check else 0
|
||||||
|
|
||||||
|
perms = cur.get("permissions")
|
||||||
|
if not isinstance(perms, dict):
|
||||||
|
perms = {}
|
||||||
|
allow = perms.get("allow")
|
||||||
|
if not isinstance(allow, list):
|
||||||
|
allow = []
|
||||||
|
have = set(a for a in allow if isinstance(a, str))
|
||||||
|
missing = [r for r in rules if r not in have]
|
||||||
|
|
||||||
|
if check:
|
||||||
|
if missing:
|
||||||
|
print("🔴 %s 缺 %d 條:" % (target, len(missing)))
|
||||||
|
for r in missing:
|
||||||
|
print(" " + r)
|
||||||
|
return 1
|
||||||
|
if not quiet:
|
||||||
|
print("✅ %s 已有全部 %d 條" % (target, len(rules)))
|
||||||
|
return 0
|
||||||
|
|
||||||
|
if not missing:
|
||||||
|
if not quiet:
|
||||||
|
print("✅ 白名單已齊(%d 條):%s" % (len(rules), target))
|
||||||
|
return 0
|
||||||
|
|
||||||
|
if dry:
|
||||||
|
print("🧪 --dry-run:會加 %d 條進 %s:" % (len(missing), target))
|
||||||
|
for r in missing:
|
||||||
|
print(" " + r)
|
||||||
|
return 0
|
||||||
|
|
||||||
|
perms["allow"] = allow + missing
|
||||||
|
cur["permissions"] = perms
|
||||||
|
try:
|
||||||
|
os.makedirs(os.path.dirname(target) or ".", exist_ok=True)
|
||||||
|
fd, tmp = tempfile.mkstemp(prefix=".settings-", suffix=".json", dir=os.path.dirname(target) or ".")
|
||||||
|
with os.fdopen(fd, "w", encoding="utf-8") as f:
|
||||||
|
json.dump(cur, f, ensure_ascii=False, indent=2)
|
||||||
|
f.write("\n")
|
||||||
|
os.replace(tmp, target)
|
||||||
|
except Exception as e:
|
||||||
|
print("🔴 寫不進 %s:%s" % (target, e), file=sys.stderr)
|
||||||
|
return 0
|
||||||
|
print("✅ 白名單 +%d 條 → %s(共 %d 條來自 ISEP)" % (len(missing), target, len(rules)))
|
||||||
|
if not quiet:
|
||||||
|
for r in missing:
|
||||||
|
print(" " + r)
|
||||||
|
return 0
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
sys.exit(main(sys.argv[1:]))
|
||||||
@@ -22,7 +22,7 @@ run(){ # 跑 list(或任何子命令),輸出留在 $OUT,離開碼留在
|
|||||||
# 🔴 ISEP_COUNTDOWN_STATE_DIR 也要指到暫存目錄:主線(hooks/lib/mainline.py)住在那裡,
|
# 🔴 ISEP_COUNTDOWN_STATE_DIR 也要指到暫存目錄:主線(hooks/lib/mainline.py)住在那裡,
|
||||||
# 不隔離的話這支測試的結果會取決於「這台機器現在標了哪條主線」——那就不是測試了。
|
# 不隔離的話這支測試的結果會取決於「這台機器現在標了哪條主線」——那就不是測試了。
|
||||||
OUT=$(ISEP_DEBT_FIXTURE="$FX" ISEP_DEBT_STATE_DIR="$T/state" ISEP_DEBT_NOW="$NOW" \
|
OUT=$(ISEP_DEBT_FIXTURE="$FX" ISEP_DEBT_STATE_DIR="$T/state" ISEP_DEBT_NOW="$NOW" \
|
||||||
ISEP_COUNTDOWN_STATE_DIR="$ML_DIR" python3 "$W" "$@" 2>&1); RC=$?
|
ISEP_COUNTDOWN_STATE_DIR="$ML_DIR" ISEP_MAINLINE_REPO_FILE=none python3 "$W" "$@" 2>&1); RC=$?
|
||||||
}
|
}
|
||||||
|
|
||||||
ML_DIR="$T/mainline"; mkdir -p "$ML_DIR"
|
ML_DIR="$T/mainline"; mkdir -p "$ML_DIR"
|
||||||
|
|||||||
Executable
+80
@@ -0,0 +1,80 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
# isep-notify 的「Bot API 直送」測試(inkstone/ISEP#130)
|
||||||
|
#
|
||||||
|
# 它守什麼: 雲端唯一走得通的通知路。2026-09-07 從雲端實測:leo21c 的 notify_leo 回 404、
|
||||||
|
# youlin 被 egress proxy 擋(403 policy denial)、api.telegram.org 通。
|
||||||
|
# ⇒ 有 TELEGRAM_BOT_TOKEN/TELEGRAM_CHAT_ID 就先直送;沒有要講清楚缺哪兩個,不能靜默。
|
||||||
|
#
|
||||||
|
# 🔴 全程不打真 Telegram:Bot API 指到本機一個假伺服器(只回固定 JSON),
|
||||||
|
# 實例那條用 ISEP_NOTIFY_OFFLINE=1 關掉、閘用 ISEP_NOTIFY_GUARD 指到真跡。
|
||||||
|
cd "$(dirname "$0")/.." || exit 1
|
||||||
|
N=scripts/isep-notify
|
||||||
|
TMP=$(mktemp -d); trap 'rm -rf "$TMP"; [ -n "${SRV:-}" ] && kill "$SRV" 2>/dev/null' EXIT
|
||||||
|
export ISEP_NOTIFY_STATE_DIR="$TMP/state" ISEP_NOTIFY_GUARD="$PWD/hooks/prod-write-guard.sh"
|
||||||
|
unset TELEGRAM_BOT_TOKEN TELEGRAM_CHAT_ID
|
||||||
|
PASS=0; FAIL=0
|
||||||
|
ok(){ PASS=$((PASS+1)); printf ' ✅ %s\n' "$1"; }
|
||||||
|
bad(){ FAIL=$((FAIL+1)); printf ' ❌ %s\n' "$1"; }
|
||||||
|
|
||||||
|
# 假 Bot API:記下收到什麼,回 Telegram 的形狀
|
||||||
|
cat > "$TMP/srv.py" <<'PY'
|
||||||
|
import json, sys
|
||||||
|
from http.server import BaseHTTPRequestHandler, HTTPServer
|
||||||
|
LOG = sys.argv[2]
|
||||||
|
class H(BaseHTTPRequestHandler):
|
||||||
|
def do_POST(self):
|
||||||
|
body = self.rfile.read(int(self.headers.get("Content-Length") or 0)).decode()
|
||||||
|
open(LOG, "a").write(json.dumps({"path": self.path, "body": body, "ua": self.headers.get("User-Agent")}) + "\n")
|
||||||
|
ok = "/botGOOD/" in self.path
|
||||||
|
out = json.dumps({"ok": True, "result": {"message_id": 42}} if ok else {"ok": False, "description": "Unauthorized"}).encode()
|
||||||
|
self.send_response(200 if ok else 401); self.send_header("Content-Type", "application/json"); self.end_headers(); self.wfile.write(out)
|
||||||
|
def log_message(self, *a): pass
|
||||||
|
HTTPServer(("127.0.0.1", int(sys.argv[1])), H).serve_forever()
|
||||||
|
PY
|
||||||
|
PORT=$(python3 -c 'import socket;s=socket.socket();s.bind(("127.0.0.1",0));print(s.getsockname()[1])')
|
||||||
|
python3 "$TMP/srv.py" "$PORT" "$TMP/log" & SRV=$!
|
||||||
|
for i in 1 2 3 4 5 6 7 8 9 10; do curl -s -o /dev/null "http://127.0.0.1:$PORT/" && break; sleep 0.2; done
|
||||||
|
export ISEP_NOTIFY_BOT_API="http://127.0.0.1:$PORT"
|
||||||
|
|
||||||
|
echo "── A. 沒有憑證:講清楚缺哪兩個,不靜默 ──"
|
||||||
|
OUT=$(ISEP_NOTIFY_OFFLINE=1 python3 "$N" --text "測試" 2>&1); RC=$?
|
||||||
|
printf '%s' "$OUT" | grep -q 'TELEGRAM_BOT_TOKEN/TELEGRAM_CHAT_ID' && ok "A1 沒憑證 ⇒ 報告點名缺 TELEGRAM_BOT_TOKEN/TELEGRAM_CHAT_ID(leo 看了知道要在 Cloud environment 加什麼)" || bad "A1 沒點名缺什麼:$OUT"
|
||||||
|
[ "$RC" != 0 ] && printf '%s' "$OUT" | grep -q 'leo 的手機上沒有出現' && ok "A2 兩條路都沒通 ⇒ 離開碼非 0、明說沒送到" || bad "A2 rc=$RC:$OUT"
|
||||||
|
[ ! -s "$TMP/log" ] && ok "A3 沒憑證就不打 Bot API" || bad "A3 沒憑證還打了:$(cat "$TMP/log")"
|
||||||
|
|
||||||
|
echo "── B. 有憑證:先直送,送到就結束 ──"
|
||||||
|
: > "$TMP/log"
|
||||||
|
OUT=$(TELEGRAM_BOT_TOKEN=GOOD TELEGRAM_CHAT_ID=777 python3 "$N" --text "雲端收工摘要" 2>&1); RC=$?
|
||||||
|
[ "$RC" = 0 ] && printf '%s' "$OUT" | grep -q 'Bot API 直送):送到了' && ok "B1 憑證在 ⇒ Bot API 直送,離開碼 0" || bad "B1 rc=$RC:$OUT"
|
||||||
|
python3 - "$TMP/log" <<'PY' && ok "B2 打到 /botGOOD/sendMessage、chat_id=777、內文有署名、UA 帶了" || bad "B2 送出去的形狀不對:$(cat "$TMP/log")"
|
||||||
|
import json, sys
|
||||||
|
rows = [json.loads(l) for l in open(sys.argv[1])]
|
||||||
|
assert len(rows) == 1, rows
|
||||||
|
r = rows[0]; b = json.loads(r["body"])
|
||||||
|
assert r["path"] == "/botGOOD/sendMessage", r["path"]
|
||||||
|
assert b["chat_id"] == "777" and b["text"].startswith("[總管] 雲端收工摘要"), b
|
||||||
|
assert "isep-notify" in (r["ua"] or ""), r["ua"]
|
||||||
|
PY
|
||||||
|
printf '%s' "$OUT" | grep -q 'notify_leo' && bad "B3 直送成功後不該再碰實例那條" || ok "B3 直送成功 ⇒ 不再打實例的 notify_leo"
|
||||||
|
|
||||||
|
echo "── C. 憑證錯:Bot API 回 ok=false ⇒ 不算送到,退到原本那條 ──"
|
||||||
|
: > "$TMP/log"
|
||||||
|
# 實例那條也指到假伺服器(它對非 /botGOOD/ 的路徑回 401)——兩條都不出這台機器
|
||||||
|
OUT=$(TELEGRAM_BOT_TOKEN=BAD TELEGRAM_CHAT_ID=777 ISEP_NOTIFY_URL="http://127.0.0.1:$PORT/webhooks/named/leo/notify_leo/trigger" python3 "$N" --text "x" 2>&1); RC=$?
|
||||||
|
printf '%s' "$OUT" | grep -q 'Bot API HTTP 401' && ok "C1 401 被講出來(不是「送出成功」)" || bad "C1 沒講 401:$OUT"
|
||||||
|
[ "$RC" != 0 ] && printf '%s' "$OUT" | grep -q 'leo 的手機上沒有出現' && ok "C2 直送失敗+實例關著 ⇒ 仍然明說沒送到" || bad "C2 rc=$RC:$OUT"
|
||||||
|
|
||||||
|
echo "── D. 閘說會擋,直送仍走得通(它不碰實例)──"
|
||||||
|
: > "$TMP/log"; mkdir -p "$TMP/oldguard"
|
||||||
|
printf '#!/bin/sh\nexit 2\n' > "$TMP/oldguard/prod-write-guard.sh"; chmod +x "$TMP/oldguard/prod-write-guard.sh"
|
||||||
|
OUT=$(ISEP_NOTIFY_GUARD="$TMP/oldguard/prod-write-guard.sh" TELEGRAM_BOT_TOKEN=GOOD TELEGRAM_CHAT_ID=1 python3 "$N" --text "y" 2>&1); RC=$?
|
||||||
|
[ "$RC" = 0 ] && printf '%s' "$OUT" | grep -q '通知閘:\*\*block\*\*' && printf '%s' "$OUT" | grep -q '直送):送到了' \
|
||||||
|
&& ok "D1 閘 block + 憑證在 ⇒ 直送照樣送到(閘擋的是寫實例,直送沒碰實例)" || bad "D1 rc=$RC:$OUT"
|
||||||
|
|
||||||
|
echo "── E. --dry-run 什麼都不送 ──"
|
||||||
|
: > "$TMP/log"
|
||||||
|
OUT=$(TELEGRAM_BOT_TOKEN=GOOD TELEGRAM_CHAT_ID=1 python3 "$N" --text "z" --dry-run 2>&1)
|
||||||
|
[ ! -s "$TMP/log" ] && printf '%s' "$OUT" | grep -q 'dry-run' && ok "E1 --dry-run:Bot API 一次都沒被打" || bad "E1 dry-run 打了:$(cat "$TMP/log")"
|
||||||
|
|
||||||
|
echo; echo "$PASS/$((PASS+FAIL)) 通過"
|
||||||
|
[ "$FAIL" -eq 0 ]
|
||||||
@@ -1,98 +0,0 @@
|
|||||||
#!/usr/bin/env bash
|
|
||||||
# scripts/release-check 的迴歸測試(inkstone/ISEP#67)
|
|
||||||
#
|
|
||||||
# 兩個方向都要有證據:
|
|
||||||
# A 群「該擋」(exit 2)——現行版本缺 tag 或缺 release,且**說得出缺哪一站**
|
|
||||||
# (這就是工單驗收 4:「故意漏一步 → 管線要擋下來並說出缺哪一站」)
|
|
||||||
# B 群「該過」(exit 0)——現行版本 tag+release 都在;更舊版本缺件只黃字提醒不擋
|
|
||||||
#
|
|
||||||
# 🔴 全程離線(RELEASE_CHECK_FIXTURE),不打 Gitea。fixture 直接給收貨端與送貨端的事實。
|
|
||||||
set -u
|
|
||||||
TOOL="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/release-check}"
|
|
||||||
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
|
|
||||||
PASS=0; FAIL=0; N=0
|
|
||||||
|
|
||||||
mkfx() { # $1=檔名 之後 heredoc
|
|
||||||
cat > "$TMP/$1"
|
|
||||||
}
|
|
||||||
|
|
||||||
run() { RELEASE_CHECK_FIXTURE="$TMP/$1" python3 "$TOOL" 2>&1; }
|
|
||||||
|
|
||||||
# t <期望exit> <說明> <必須出現的字串> <fixture檔>
|
|
||||||
t() {
|
|
||||||
want="$1"; desc="$2"; must="$3"; fx="$4"
|
|
||||||
N=$((N+1))
|
|
||||||
out=$(RELEASE_CHECK_FIXTURE="$TMP/$fx" python3 "$TOOL" 2>&1); rc=$?
|
|
||||||
ok=1
|
|
||||||
[ "$rc" -eq "$want" ] || ok=0
|
|
||||||
if [ -n "$must" ] && ! printf '%s' "$out" | grep -qF "$must"; then ok=0; fi
|
|
||||||
if [ "$ok" -eq 1 ]; then printf ' ✅ %s\n' "$desc"; PASS=$((PASS+1))
|
|
||||||
else
|
|
||||||
printf ' ❌ %s —— 期望 exit=%s%s,實得 exit=%s\n' "$desc" "$want" \
|
|
||||||
"${must:+ 且輸出含「$must」}" "$rc"
|
|
||||||
printf '%s\n' "$out" | sed -n '1,14p' | sed 's/^/ /'; FAIL=$((FAIL+1))
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
echo "── A 群:該擋(現行版本送貨端斷了,要說出缺哪一站)──"
|
|
||||||
|
|
||||||
# A1:這就是 2026-09-05 的真實狀態——v0.22.0 有 tag、沒 release
|
|
||||||
mkfx a1.json <<'JSON'
|
|
||||||
{"current":"0.22.0",
|
|
||||||
"dingban":["0.22.0","0.21.0","0.20.0","0.19.0","0.18.0"],
|
|
||||||
"tags":["v0.22.0","v0.18.0"],
|
|
||||||
"releases":["v0.18.0"],
|
|
||||||
"loaded":"0.22.0"}
|
|
||||||
JSON
|
|
||||||
t 2 "現行 v0.22.0 有 tag 沒 release → 擋,且指名缺 release 站" "release(Gitea)" a1.json
|
|
||||||
t 2 "缺 release 時給得出補法(release-ship)" "release-ship" a1.json
|
|
||||||
|
|
||||||
# A2:連 tag 都沒有(v0.19-0.21 的真實狀態搬成現行來測)
|
|
||||||
mkfx a2.json <<'JSON'
|
|
||||||
{"current":"0.20.0",
|
|
||||||
"dingban":["0.20.0","0.18.0"],
|
|
||||||
"tags":["v0.18.0"],
|
|
||||||
"releases":["v0.18.0"],
|
|
||||||
"loaded":"0.20.0"}
|
|
||||||
JSON
|
|
||||||
t 2 "現行版本連 tag 都沒有 → 擋,且指名缺 tag 站" "tag(Gitea)" a2.json
|
|
||||||
t 2 "缺 tag 時給得出補法(push tag)" "git push origin" a2.json
|
|
||||||
|
|
||||||
echo "── B 群:該過(現行版本 tag+release 都在)──"
|
|
||||||
|
|
||||||
# B1:全部送到
|
|
||||||
mkfx b1.json <<'JSON'
|
|
||||||
{"current":"0.18.0",
|
|
||||||
"dingban":["0.18.0","0.9.0"],
|
|
||||||
"tags":["v0.18.0","v0.9.0"],
|
|
||||||
"releases":["v0.18.0","v0.9.0"],
|
|
||||||
"loaded":"0.18.0"}
|
|
||||||
JSON
|
|
||||||
t 0 "現行版本 tag+release 都在 → 放行" "送貨端完成" b1.json
|
|
||||||
|
|
||||||
# B2:現行版本送到了,但更舊的 定版 版本缺件 → 仍放行,只黃字
|
|
||||||
mkfx b2.json <<'JSON'
|
|
||||||
{"current":"0.22.0",
|
|
||||||
"dingban":["0.22.0","0.21.0","0.20.0","0.19.0","0.18.0"],
|
|
||||||
"tags":["v0.22.0","v0.18.0"],
|
|
||||||
"releases":["v0.22.0","v0.18.0"],
|
|
||||||
"loaded":"0.22.0"}
|
|
||||||
JSON
|
|
||||||
t 0 "現行送到、舊版缺件 → 放行(不 over-block)" "送貨端完成" b2.json
|
|
||||||
t 0 "舊版缺件會被黃字提醒出來" "更舊的定版版本也缺件" b2.json
|
|
||||||
|
|
||||||
# B3:載入端落後(送貨端完成,但這個 session 掛的是舊版)→ 仍 exit 0,但要報出來
|
|
||||||
mkfx b3.json <<'JSON'
|
|
||||||
{"current":"0.22.0",
|
|
||||||
"dingban":["0.22.0","0.18.0"],
|
|
||||||
"tags":["v0.22.0","v0.18.0"],
|
|
||||||
"releases":["v0.22.0","v0.18.0"],
|
|
||||||
"loaded":"0.21.0"}
|
|
||||||
JSON
|
|
||||||
t 0 "載入端落後 → 送貨端仍算完成(exit 0)" "送貨端完成" b3.json
|
|
||||||
t 0 "載入端落後會被明確報出+給 update/重啟的修法" "載入端落後" b3.json
|
|
||||||
|
|
||||||
echo ""
|
|
||||||
echo "──────────────────────────────"
|
|
||||||
printf '共 %d 項:✅ %d / ❌ %d\n' "$N" "$PASS" "$FAIL"
|
|
||||||
[ "$FAIL" -eq 0 ]
|
|
||||||
@@ -1,82 +0,0 @@
|
|||||||
#!/usr/bin/env bash
|
|
||||||
# scripts/release-ship 的迴歸測試(inkstone/ISEP#67)
|
|
||||||
#
|
|
||||||
# 兩個方向都要有證據:
|
|
||||||
# A 群「該擋」(exit 2)——前置條件沒滿足就不給建 release,且說得出是哪一個前置
|
|
||||||
# ① 版本不一致 ② Gitea 上沒那個 tag ③ 版本寫法不對
|
|
||||||
# B 群「該放行」(exit 0)——前置都在就建;release 已存在則冪等不重複建;--dry-run 不 POST
|
|
||||||
#
|
|
||||||
# 🔴 全程離線(RELEASE_SHIP_FIXTURE + RELEASE_SHIP_SINK),不打 Gitea、不建任何真 release。
|
|
||||||
set -u
|
|
||||||
TOOL="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/release-ship}"
|
|
||||||
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
|
|
||||||
PASS=0; FAIL=0; N=0
|
|
||||||
|
|
||||||
# t <期望exit> <說明> <必須出現的字串> <fixture檔> [額外參數…]
|
|
||||||
t() {
|
|
||||||
want="$1"; desc="$2"; must="$3"; fx="$4"; shift 4
|
|
||||||
N=$((N+1))
|
|
||||||
rm -f "$TMP/sink.json" "$TMP/sink.json.checkfx.json"
|
|
||||||
out=$(RELEASE_SHIP_FIXTURE="$TMP/$fx" RELEASE_SHIP_SINK="$TMP/sink.json" \
|
|
||||||
python3 "$TOOL" "$@" 2>&1); rc=$?
|
|
||||||
ok=1
|
|
||||||
[ "$rc" -eq "$want" ] || ok=0
|
|
||||||
if [ -n "$must" ] && ! printf '%s' "$out" | grep -qF "$must"; then ok=0; fi
|
|
||||||
if [ "$ok" -eq 1 ]; then printf ' ✅ %s\n' "$desc"; PASS=$((PASS+1))
|
|
||||||
else
|
|
||||||
printf ' ❌ %s —— 期望 exit=%s%s,實得 exit=%s\n' "$desc" "$want" \
|
|
||||||
"${must:+ 且輸出含「$must」}" "$rc"
|
|
||||||
printf '%s\n' "$out" | sed -n '1,14p' | sed 's/^/ /'; FAIL=$((FAIL+1))
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
echo "── A 群:該擋(前置條件沒滿足)──"
|
|
||||||
|
|
||||||
# A1:版本一致性沒過
|
|
||||||
cat > "$TMP/a1.json" <<'JSON'
|
|
||||||
{"consistency_ok":false,"consistency_msg":"❌ plugin.json=0.21.0 但 tag=v0.22.0",
|
|
||||||
"tags":["v0.22.0"],"releases":[]}
|
|
||||||
JSON
|
|
||||||
t 2 "版本不一致 → 擋,指名前置①" "前置①" a1.json v0.22.0
|
|
||||||
|
|
||||||
# A2:Gitea 上沒有這個 tag
|
|
||||||
cat > "$TMP/a2.json" <<'JSON'
|
|
||||||
{"consistency_ok":true,"tags":["v0.18.0"],"releases":["v0.18.0"]}
|
|
||||||
JSON
|
|
||||||
t 2 "Gitea 沒有該 tag → 擋,指名前置②+叫人先推 tag" "git push origin v0.22.0" a2.json v0.22.0
|
|
||||||
|
|
||||||
# A3:版本寫法不對
|
|
||||||
cat > "$TMP/a3.json" <<'JSON'
|
|
||||||
{"consistency_ok":true,"tags":[],"releases":[]}
|
|
||||||
JSON
|
|
||||||
t 2 "版本寫法不對 → 擋" "版本寫法" a3.json "0.22"
|
|
||||||
|
|
||||||
echo "── B 群:該放行 ──"
|
|
||||||
|
|
||||||
# B1:前置都在、release 還沒建 → 建(fixture sink),然後覆核通過
|
|
||||||
cat > "$TMP/b1.json" <<'JSON'
|
|
||||||
{"consistency_ok":true,
|
|
||||||
"current":"0.22.0","dingban":["0.22.0","0.18.0"],"loaded":"0.22.0",
|
|
||||||
"tags":["v0.22.0","v0.18.0"],"releases":["v0.18.0"]}
|
|
||||||
JSON
|
|
||||||
t 0 "前置齊全、release 缺 → 建起來" "已建立 release「v0.22.0」" b1.json v0.22.0 --notes-file "$TMP/b1.json"
|
|
||||||
t 0 "建完回頭跑 release-check 覆核(問收貨端)" "覆核" b1.json v0.22.0 --notes-file "$TMP/b1.json"
|
|
||||||
|
|
||||||
# B2:release 已存在 → 冪等,不重複建
|
|
||||||
cat > "$TMP/b2.json" <<'JSON'
|
|
||||||
{"consistency_ok":true,
|
|
||||||
"current":"0.18.0","dingban":["0.18.0"],"loaded":"0.18.0",
|
|
||||||
"tags":["v0.18.0"],"releases":["v0.18.0"]}
|
|
||||||
JSON
|
|
||||||
t 0 "release 已存在 → 冪等放行、不重複建" "本來就在了" b2.json v0.18.0 --notes-file "$TMP/b2.json"
|
|
||||||
|
|
||||||
# B3:--dry-run 不 POST
|
|
||||||
cat > "$TMP/b3.json" <<'JSON'
|
|
||||||
{"consistency_ok":true,"tags":["v0.22.0"],"releases":[]}
|
|
||||||
JSON
|
|
||||||
t 0 "--dry-run 全走一遍但不 POST" "不 POST" b3.json v0.22.0 --dry-run
|
|
||||||
|
|
||||||
echo ""
|
|
||||||
echo "──────────────────────────────"
|
|
||||||
printf '共 %d 項:✅ %d / ❌ %d\n' "$N" "$PASS" "$FAIL"
|
|
||||||
[ "$FAIL" -eq 0 ]
|
|
||||||
Executable
+97
@@ -0,0 +1,97 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
# settings-allow-sync 的測試(inkstone/ISEP#130)
|
||||||
|
#
|
||||||
|
# 它守什麼: 「雲端 session 開工時就帶著跟本機同一份權限白名單」這件事的機器那一半。
|
||||||
|
# leo 09-07 親手加的四條只在本機 InkStoneCo/.claude/settings.json;雲端沒有 ⇒ 同樣動作被分類器擋
|
||||||
|
# (09-04 run log:permission_denials=6)。清單改住 ISEP 一份,本支把它寫進那台機器的 ~/.claude/settings.json。
|
||||||
|
#
|
||||||
|
# 🔴 全程在 TMP 底下的假 settings.json 上跑,不碰真的 ~/.claude/settings.json。
|
||||||
|
cd "$(dirname "$0")/.." || exit 1
|
||||||
|
S=scripts/settings-allow-sync
|
||||||
|
LIST=docs/permissions-allow.json
|
||||||
|
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
|
||||||
|
PASS=0; FAIL=0
|
||||||
|
ok(){ PASS=$((PASS+1)); printf ' ✅ %s\n' "$1"; }
|
||||||
|
bad(){ FAIL=$((FAIL+1)); printf ' ❌ %s\n' "$1"; }
|
||||||
|
N=$(python3 -c "import json;print(len(json.load(open('$LIST'))['allow']))")
|
||||||
|
|
||||||
|
echo "── A. 清單本身的形狀 ──"
|
||||||
|
python3 - "$LIST" <<'PY' && ok "A1 每一條都是 Bash(…) 形狀,而且四個正門工具都在場(ticket/mainline/gate-ok/gitea-pr-merge)" || bad "A1 清單形狀不對或少了正門工具"
|
||||||
|
import json, sys
|
||||||
|
rules = json.load(open(sys.argv[1]))["allow"]
|
||||||
|
assert rules and all(r.startswith("Bash(") and r.endswith(")") for r in rules), rules
|
||||||
|
for tool in ("scripts/ticket", "scripts/mainline", "scripts/gate-ok", "scripts/gitea-pr-merge.sh"):
|
||||||
|
assert any(tool in r for r in rules), "缺 " + tool
|
||||||
|
assert not any(r.strip() in ("Bash(python3 *)", "Bash(*)", "Bash(bash *)") for r in rules), "整類放行"
|
||||||
|
PY
|
||||||
|
|
||||||
|
echo "── B. 寫進去(假的 settings.json)──"
|
||||||
|
T="$TMP/a/settings.json"
|
||||||
|
OUT=$(python3 "$S" --target "$T" --home /root 2>&1); RC=$?
|
||||||
|
[ "$RC" = 0 ] && [ -f "$T" ] && ok "B1 目標不存在 ⇒ 建出來(離開碼 0)" || bad "B1 rc=$RC:$OUT"
|
||||||
|
python3 -c "import json;d=json.load(open('$T'));assert len(d['permissions']['allow'])==$N" && ok "B2 寫進 $N 條,JSON 合法" || bad "B2 條數不對或不是 JSON"
|
||||||
|
grep -q 'Bash(python3 /root/.claude/plugins/cache/inkstone/isep/\*/scripts/ticket \*)' "$T" \
|
||||||
|
&& ok "B3 開頭的 ~ 換成了 --home 給的家目錄(雲端=/root)" || bad "B3 ~ 沒換成家目錄"
|
||||||
|
grep -q '"~/' "$T" && bad "B4 檔裡還留著 ~" || ok "B4 檔裡沒有殘留的 ~"
|
||||||
|
grep -q 'CLAUDE_PLUGIN_ROOT' "$T" && ok "B5 \$CLAUDE_PLUGIN_ROOT 那幾條原樣保留(閘印出來的逃生門就是這個形狀)" || bad "B5 少了 \$CLAUDE_PLUGIN_ROOT 形狀"
|
||||||
|
tail -c1 "$T" | od -An -c | grep -q '\\n' && ok "B6 收尾有換行" || bad "B6 沒換行"
|
||||||
|
|
||||||
|
SUM1=$(cksum < "$T"); OUT=$(python3 "$S" --target "$T" --home /root 2>&1); SUM2=$(cksum < "$T")
|
||||||
|
[ "$SUM1" = "$SUM2" ] && printf '%s' "$OUT" | grep -q '已齊' && ok "B7 跑第二次:檔案一個位元組都沒變、說「已齊」(冪等)" || bad "B7 不冪等:$OUT"
|
||||||
|
|
||||||
|
echo "── C. 只加不減:別人手加的東西一個字不動 ──"
|
||||||
|
T2="$TMP/b/settings.json"; mkdir -p "$TMP/b"
|
||||||
|
cat > "$T2" <<'JSON'
|
||||||
|
{
|
||||||
|
"extraKnownMarketplaces": {"inkstone": {"source": {"source": "git", "url": "https://git.uncle6.me/inkstone/ISEP.git"}}},
|
||||||
|
"enabledPlugins": {"isep@inkstone": true},
|
||||||
|
"permissions": {
|
||||||
|
"allow": ["Bash(npx wrangler secret:*)", "Bash(python3 scripts/ticket *)"],
|
||||||
|
"deny": ["Edit(//Users/x/wrangler.toml)"]
|
||||||
|
},
|
||||||
|
"hooks": {"PreToolUse": []}
|
||||||
|
}
|
||||||
|
JSON
|
||||||
|
OUT=$(python3 "$S" --target "$T2" --home /Users/youlinhsieh 2>&1)
|
||||||
|
python3 - "$T2" "$N" <<'PY' && ok "C1 原有的 allow/deny/marketplace/hooks 全在,原本那條沒重複,只補了缺的" || bad "C1 動到了別人的東西:$(cat "$T2")"
|
||||||
|
import json, sys
|
||||||
|
d = json.load(open(sys.argv[1])); n = int(sys.argv[2])
|
||||||
|
a = d["permissions"]["allow"]
|
||||||
|
assert a[0] == "Bash(npx wrangler secret:*)" and a[1] == "Bash(python3 scripts/ticket *)", a[:2]
|
||||||
|
assert a.count("Bash(python3 scripts/ticket *)") == 1
|
||||||
|
assert len(a) == 2 + n - 1, (len(a), n)
|
||||||
|
assert d["permissions"]["deny"] == ["Edit(//Users/x/wrangler.toml)"]
|
||||||
|
assert d["enabledPlugins"] == {"isep@inkstone": True}
|
||||||
|
assert d["hooks"] == {"PreToolUse": []}
|
||||||
|
assert any("/Users/youlinhsieh/.claude/plugins/cache/inkstone/isep/*/scripts/mainline" in x for x in a)
|
||||||
|
PY
|
||||||
|
printf '%s' "$OUT" | grep -q "+$((N-1)) 條" && ok "C2 印出來的是「+$((N-1)) 條」(缺幾條補幾條)" || bad "C2 計數不對:$OUT"
|
||||||
|
|
||||||
|
echo "── D. --check/--dry-run ──"
|
||||||
|
python3 "$S" --target "$T" --home /root --check >/dev/null 2>&1 && ok "D1 --check:全齊 ⇒ 離開碼 0" || bad "D1 --check 全齊卻非 0"
|
||||||
|
T3="$TMP/c/settings.json"; mkdir -p "$TMP/c"; echo '{}' > "$T3"
|
||||||
|
python3 "$S" --target "$T3" --home /root --check >/dev/null 2>&1; RC=$?
|
||||||
|
[ "$RC" = 1 ] && ok "D2 --check:缺 ⇒ 離開碼 1(驗收用)" || bad "D2 --check 缺卻回 $RC"
|
||||||
|
[ "$(cat "$T3")" = "{}" ] && ok "D3 --check 不寫檔" || bad "D3 --check 寫了檔"
|
||||||
|
python3 "$S" --target "$T3" --home /root --dry-run >/dev/null 2>&1
|
||||||
|
[ "$(cat "$T3")" = "{}" ] && ok "D4 --dry-run 不寫檔" || bad "D4 --dry-run 寫了檔"
|
||||||
|
|
||||||
|
echo "── E. 壞掉的目標:不碰、不炸(這支掛在 SessionStart)──"
|
||||||
|
T4="$TMP/d/settings.json"; mkdir -p "$TMP/d"; printf '{ not json' > "$T4"
|
||||||
|
OUT=$(python3 "$S" --target "$T4" --home /root 2>&1); RC=$?
|
||||||
|
[ "$RC" = 0 ] && [ "$(cat "$T4")" = "{ not json" ] && printf '%s' "$OUT" | grep -q '沒有動它' \
|
||||||
|
&& ok "E1 目標不是 JSON ⇒ 原封不動、講出來、離開碼 0" || bad "E1 rc=$RC 內容=$(cat "$T4") out=$OUT"
|
||||||
|
python3 "$S" --target "$T4" --home /root --check >/dev/null 2>&1; [ $? = 1 ] && ok "E2 同一個檔用 --check 問 ⇒ 離開碼 1(不裝沒事)" || bad "E2 --check 對壞檔回 0"
|
||||||
|
|
||||||
|
echo "── F. 接線:SessionStart 有掛、雲端 setup script 有叫 ──"
|
||||||
|
python3 - <<'PY' && ok "F1 hooks.json 的 SessionStart 註冊了 scripts/settings-allow-sync" || bad "F1 hooks.json 沒掛"
|
||||||
|
import json
|
||||||
|
d = json.load(open("hooks/hooks.json"))
|
||||||
|
cmds = [h["command"] for g in d["hooks"]["SessionStart"] for h in g["hooks"]]
|
||||||
|
assert any("scripts/settings-allow-sync" in c for c in cmds), cmds
|
||||||
|
PY
|
||||||
|
grep -q 'settings-allow-sync' docs/cloud-setup-script.sh && ok "F2 docs/cloud-setup-script.sh 裝完 plugin 會跑它" || bad "F2 setup script 沒叫它"
|
||||||
|
grep -q 'exit 0$' docs/cloud-setup-script.sh && ok "F3 setup script 仍然 exit 0(非零會讓整個 session 開不起來)" || bad "F3 setup script 結尾不是 exit 0"
|
||||||
|
|
||||||
|
echo; echo "$PASS/$((PASS+FAIL)) 通過"
|
||||||
|
[ "$FAIL" -eq 0 ]
|
||||||
Executable
+224
@@ -0,0 +1,224 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
# 雲端工人抓票規則的測試(inkstone/ISEP#131)
|
||||||
|
#
|
||||||
|
# 票上的驗收第 1 條:「`scripts/ticket pick` 給定主線檔,回一張符合規則的票;
|
||||||
|
# 池子裡塞一張 `Human`、一張有 assignee、一張 backlog,三張都不會被挑到(測試綠)。」
|
||||||
|
#
|
||||||
|
# 這支測四件事:
|
||||||
|
# ① `pickable()` 純函式——規則本體,一格一條,不打網路
|
||||||
|
# ② `pick` 走整條路(把 api() 換成錄音機餵一個假池子):挑到誰、順序、主線抓盡才抓逾期、
|
||||||
|
# 沒有可抓的票時離開碼 1、沒有主線時離開碼 2 且訊息講得出出路
|
||||||
|
# ③ `claim` 一個動作三件事(指派/s/doing/【身份】留言),以及該擋的擋在**打 API 之前**
|
||||||
|
# ④ 不該擋的(誤攔比漏擋更該修)
|
||||||
|
#
|
||||||
|
# 全程離線:假池子在下面的 POOL;TICKET_HOST 指到連不上的位址,任何一條真的走到網路會當場炸,
|
||||||
|
# 不會靜靜變成假綠。不開票、不改票、不留任何東西在 Gitea 上。
|
||||||
|
cd "$(dirname "$0")/.." || exit 1
|
||||||
|
T=scripts/ticket
|
||||||
|
TMP=$(mktemp -d)
|
||||||
|
trap 'rm -rf "$TMP"' EXIT
|
||||||
|
PASS=0; FAIL=0
|
||||||
|
export TICKET_HOST=http://127.0.0.1:9 GITEA_TOKEN=x
|
||||||
|
export ISEP_COUNTDOWN_STATE_DIR="$TMP/state"; mkdir -p "$ISEP_COUNTDOWN_STATE_DIR"
|
||||||
|
export ISEP_COUNTDOWN_NOW=$(python3 -c 'import datetime as d;print(int(d.datetime(2026,9,7,0,0,tzinfo=d.timezone.utc).timestamp()))')
|
||||||
|
unset ISEP_MAINLINE_FILE ISEP_IDENTITY CLAUDE_PROJECT_DIR
|
||||||
|
|
||||||
|
MAIN="$TMP/mainline.json"
|
||||||
|
cat > "$MAIN" <<'JSON'
|
||||||
|
{"ref":"inkstone/Arcrun#48","owner":"inkstone","repo":"Arcrun","id":48,
|
||||||
|
"title":"主線 M","description":"測試用主線","due_on":"2026-09-12T23:59:59Z",
|
||||||
|
"open_issues":3,"closed_issues":0,"members":[],"set_at":"2026-09-07 07:30"}
|
||||||
|
JSON
|
||||||
|
|
||||||
|
# ── 假池子:三個 repo、三個 open milestone、十一張票 ─────────────────────
|
||||||
|
# 主線 M(未逾期,主線)/逾期 M(2026-08-19 到期)/未來 M(2026-10-01 到期,不是主線)
|
||||||
|
cat > "$TMP/pool.py" <<'PY'
|
||||||
|
import json, os
|
||||||
|
MS = {"main": {"id": 48, "title": "主線 M", "due_on": "2026-09-12T23:59:59Z"},
|
||||||
|
"late": {"id": 49, "title": "逾期 M", "due_on": "2026-08-19T23:59:59Z"},
|
||||||
|
"future": {"id": 50, "title": "未來 M", "due_on": "2026-10-01T23:59:59Z"}}
|
||||||
|
def I(repo, n, labels, ms=None, assignees=(), created="2026-09-01T00:00:00Z", pr=False, title=None):
|
||||||
|
d = {"number": n, "title": title or f"票 {repo}#{n}", "state": "open",
|
||||||
|
"labels": [{"name": l} for l in labels],
|
||||||
|
"assignees": [{"login": a} for a in assignees],
|
||||||
|
"milestone": MS[ms] if ms else None, "created_at": created,
|
||||||
|
"repository": {"full_name": f"inkstone/{repo}"}}
|
||||||
|
if pr: d["pull_request"] = {"merged": False}
|
||||||
|
return d
|
||||||
|
POOL = {
|
||||||
|
"ISEP": [I("ISEP", 1, ["s/todo"], "main"), # ★ 可抓
|
||||||
|
I("ISEP", 2, ["s/todo", "Human"], "main"), # 票上第 1 條:Human
|
||||||
|
I("ISEP", 3, ["s/todo"], "main", assignees=("someone",)), # 票上第 1 條:有 assignee
|
||||||
|
I("ISEP", 4, ["s/backlog"], None), # 票上第 1 條:backlog
|
||||||
|
I("ISEP", 5, ["s/todo"], None), # 沒里程碑
|
||||||
|
I("ISEP", 10, ["s/todo"], "main", pr=True), # PR 不是票
|
||||||
|
I("ISEP", 11, ["s/todo", "human/exec"], "main")], # 執行者是人
|
||||||
|
"Arcrun": [I("Arcrun", 6, ["s/todo", "p/high"], "main", created="2026-08-27T00:00:00Z"), # ★ 主線裡最優先
|
||||||
|
I("Arcrun", 7, ["s/todo"], "late"), # 逾期里程碑:主線抓盡才輪到
|
||||||
|
I("Arcrun", 8, ["s/todo"], "future")], # 不是主線也沒逾期:永遠不抓
|
||||||
|
"mira": [I("mira", 9, ["s/todo", "s/doing"], "main")], # 09-07 實查 mira#6 的形狀:有人在做
|
||||||
|
}
|
||||||
|
MSN = {"ISEP": ["main", "late", "future"], "Arcrun": ["main", "late", "future"], "mira": ["main"]}
|
||||||
|
DROP = set(json.loads(os.environ.get("DROP", "[]"))) # 測「主線抓盡」用:把某幾張從池子拿掉
|
||||||
|
def fake_api(path, payload=None, method=None):
|
||||||
|
rec.append((method or ("POST" if payload is not None else "GET"), path, payload))
|
||||||
|
if path.startswith("/orgs/inkstone/repos"):
|
||||||
|
return [{"name": r} for r in POOL]
|
||||||
|
if path == "/user":
|
||||||
|
return {"login": "claude-code"}
|
||||||
|
if "/milestones?" in path:
|
||||||
|
repo = path.split("/")[3]
|
||||||
|
return [MS[k] for k in MSN.get(repo, [])]
|
||||||
|
if "/issues?" in path:
|
||||||
|
repo = path.split("/")[3]
|
||||||
|
import urllib.parse
|
||||||
|
q = urllib.parse.parse_qs(path.split("?", 1)[1])
|
||||||
|
want = q.get("milestones", [""])[0]
|
||||||
|
return [i for i in POOL[repo] if (i["milestone"] or {}).get("title") == want
|
||||||
|
and f"{repo}#{i['number']}" not in DROP]
|
||||||
|
if path.endswith("/labels?limit=100"):
|
||||||
|
return [{"name": n, "id": k} for k, n in
|
||||||
|
enumerate(["s/todo", "s/doing", "s/review", "p/high", "Human"], 1)]
|
||||||
|
import re
|
||||||
|
m = re.match(r"/repos/inkstone/(\w+)/issues/(\d+)$", path)
|
||||||
|
if m and (method or "GET") == "GET":
|
||||||
|
return next(i for i in POOL[m.group(1)] if i["number"] == int(m.group(2)))
|
||||||
|
return {}
|
||||||
|
rec = []
|
||||||
|
PY
|
||||||
|
|
||||||
|
# probe <python 片段> —— 把 scripts/ticket 當模組載進來、api() 換成假池子,印出片段的值
|
||||||
|
probe() {
|
||||||
|
python3 - "$1" "$2" <<'PY'
|
||||||
|
import sys, os, json, io, contextlib, importlib.util as u
|
||||||
|
from importlib.machinery import SourceFileLoader as L
|
||||||
|
spec = u.spec_from_loader("t", L("t", "scripts/ticket"))
|
||||||
|
m = u.module_from_spec(spec); spec.loader.exec_module(m)
|
||||||
|
ns = {}
|
||||||
|
exec(open(os.environ["POOL_PY"]).read(), ns)
|
||||||
|
m.api = ns["fake_api"]; rec = ns["rec"]
|
||||||
|
argv = json.loads(sys.argv[2]) if sys.argv[2] else None
|
||||||
|
buf = io.StringIO(); rc = None
|
||||||
|
if argv is not None:
|
||||||
|
with contextlib.redirect_stdout(buf), contextlib.redirect_stderr(buf):
|
||||||
|
try:
|
||||||
|
getattr(m, argv[0])(argv[1:])
|
||||||
|
except SystemExit as e:
|
||||||
|
rc = e.code
|
||||||
|
print(eval(sys.argv[1], {"m": m, "rec": rec, "rc": rc, "out": buf.getvalue(), "I": ns["I"], "json": json}))
|
||||||
|
PY
|
||||||
|
}
|
||||||
|
export POOL_PY="$TMP/pool.py"
|
||||||
|
|
||||||
|
p() { # p <說明> <want> <python 片段> [argv json]
|
||||||
|
got=$(probe "$3" "${4:-}" 2>&1)
|
||||||
|
if [ "$got" = "$2" ]; then PASS=$((PASS+1)); printf ' ✅ '; else FAIL=$((FAIL+1)); printf ' ❌ '; fi
|
||||||
|
printf 'want=%s got=%s %s\n' "$2" "$got" "$1"
|
||||||
|
}
|
||||||
|
|
||||||
|
echo "── ① pickable():規則本體,一格一條(純函式,不打網路)──"
|
||||||
|
p "★ s/todo+沒人+沒 Human+主線 → 可抓" "True" "m.pickable(I('ISEP',1,['s/todo'],'main'),'主線 M')[0]"
|
||||||
|
p "★ 掛 Human → 不可抓(票上第 1 條)" "False" "m.pickable(I('ISEP',2,['s/todo','Human'],'main'),'主線 M')[0]"
|
||||||
|
p "★ 有 assignee → 不可抓(票上第 1 條)" "False" "m.pickable(I('ISEP',3,['s/todo'],'main',assignees=('x',)),'主線 M')[0]"
|
||||||
|
p "★ s/backlog、沒里程碑 → 不可抓(票上第 1 條)" "False" "m.pickable(I('ISEP',4,['s/backlog'],None),'主線 M')[0]"
|
||||||
|
p "s/todo 但沒里程碑 → 不可抓(不抓沒里程碑的)" "False" "m.pickable(I('ISEP',5,['s/todo'],None),'主線 M')[0]"
|
||||||
|
p "human/exec(執行者是人)→ 不可抓" "False" "m.pickable(I('ISEP',11,['s/todo','human/exec'],'main'),'主線 M')[0]"
|
||||||
|
p "s/todo+s/doing 同時掛著(mira#6 的形狀)→ 不可抓,有人在做" "False" "m.pickable(I('mira',9,['s/todo','s/doing'],'main'),'主線 M')[0]"
|
||||||
|
p "hub(scope 容器,09-07 實查 ISEP#31–35 的形狀)→ 不可抓" "False" "m.pickable(I('ISEP',12,['s/todo','hub'],'main'),'主線 M')[0]"
|
||||||
|
p "PR 不是票 → 不可抓" "False" "m.pickable(I('ISEP',10,['s/todo'],'main',pr=True),'主線 M')[0]"
|
||||||
|
p "里程碑不是要求的那個 → 不可抓" "False" "m.pickable(I('Arcrun',8,['s/todo'],'future'),'主線 M')[0]"
|
||||||
|
p "里程碑標題只差空白/大小寫 → 仍算同一個(norm 只有 mainline.py 那一份)" "True" "m.pickable(I('ISEP',1,['s/todo'],'main'),' 主線 m ')[0]"
|
||||||
|
p "理由講得出「為什麼不能抓」(不是只回 False)" "True" "'Human' in m.pickable(I('ISEP',2,['s/todo','Human'],'main'),'主線 M')[1]"
|
||||||
|
p "順序:p/high 先於沒標,沒標先於 p/low" "True" \
|
||||||
|
"m.pick_order(I('a',1,['s/todo','p/high'],'main')) < m.pick_order(I('a',2,['s/todo'],'main')) < m.pick_order(I('a',3,['s/todo','p/low'],'main'))"
|
||||||
|
p "順序:同優先序看開票時間,舊的先" "True" \
|
||||||
|
"m.pick_order(I('a',9,['s/todo'],'main',created='2026-08-01T00:00:00Z')) < m.pick_order(I('a',1,['s/todo'],'main',created='2026-09-01T00:00:00Z'))"
|
||||||
|
|
||||||
|
echo
|
||||||
|
echo "── ② pick 走整條路(假池子 11 張,三個 repo)──"
|
||||||
|
ARGS="[\"cmd_pick\",\"--mainline\",\"$MAIN\"]"
|
||||||
|
ALL="[\"cmd_pick\",\"--mainline\",\"$MAIN\",\"--all\",\"--json\"]"
|
||||||
|
p "★ 給定主線檔 → 回一張,而且是主線裡最優先的 Arcrun#6(p/high)" "True" "'inkstone/Arcrun#6' in out and rc is None" "$ARGS"
|
||||||
|
p "只回一張(不是整份清單)" "1" "out.count(' ● ')" "$ARGS"
|
||||||
|
p "★ --all:主線裡可抓的恰好是 Arcrun#6、ISEP#1 兩張——Human/assignee/backlog 三張都不在" \
|
||||||
|
"['inkstone/Arcrun#6', 'inkstone/ISEP#1']" "[r['ref'] for r in json.loads(out) if r['group']=='主線']" "$ALL"
|
||||||
|
p "★ --all:逾期里程碑那張 Arcrun#7 排在主線之後(主線抓盡才輪到)" \
|
||||||
|
"['inkstone/Arcrun#7']" "[r['ref'] for r in json.loads(out) if r['group']!='主線']" "$ALL"
|
||||||
|
p "沒逾期也不是主線的 Arcrun#8 不在清單裡" "False" "'inkstone/Arcrun#8' in out" "$ALL"
|
||||||
|
p "backlog(ISEP#4)/沒里程碑(ISEP#5)不在清單裡" "False" "'ISEP#4' in out or 'ISEP#5' in out" "$ALL"
|
||||||
|
p "沒有任何一條真的走到網路(api 全被錄音機接住)" "True" "all(p.startswith('/') for _,p,_ in rec)" "$ALL"
|
||||||
|
p "pick 只讀不寫(沒有 POST/PATCH/PUT)" "True" "all(mm=='GET' for mm,_,_ in rec)" "$ALL"
|
||||||
|
p "訊息印出下一步(認領那一行用絕對路徑,貼到別的 cwd 也叫得到正本)" "True" "'claim inkstone/Arcrun#6' in out and m.self_path() in out" "$ARGS"
|
||||||
|
|
||||||
|
echo
|
||||||
|
echo " (主線抓盡 → 才輪到逾期里程碑)"
|
||||||
|
export DROP='["Arcrun#6","ISEP#1"]'
|
||||||
|
p "★ 主線兩張都被拿走後 → 回逾期里程碑的 Arcrun#7" "True" "'inkstone/Arcrun#7' in out and rc is None" "$ARGS"
|
||||||
|
export DROP='["Arcrun#6","ISEP#1","Arcrun#7"]'
|
||||||
|
p "★ 主線與逾期都抓盡 → 離開碼 1(真的沒有,不是故障)" "1" "rc" "$ARGS"
|
||||||
|
p "訊息明講「不要去抓 backlog」(出路是收工回報,不是換規則)" "True" "'backlog' in out and '收工' in out" "$ARGS"
|
||||||
|
p "抓盡時**沒有**回 Arcrun#8(未來里程碑)" "False" "'Arcrun#8' in out" "$ARGS"
|
||||||
|
unset DROP
|
||||||
|
|
||||||
|
echo
|
||||||
|
echo " (沒有主線 ≠ 去抓別的)"
|
||||||
|
NOML="[\"cmd_pick\",\"--mainline\",\"$TMP/none.json\"]"
|
||||||
|
p "主線檔讀不到 → 離開碼 2(讀不到 ≠ 沒有)" "2" "rc" "$NOML"
|
||||||
|
p "…而且一通 API 都沒打" "0" "len(rec)" "$NOML"
|
||||||
|
p "沒給 --mainline、狀態檔也沒有、cwd 也沒有 → 離開碼 2,訊息給出兩條出路" "True" \
|
||||||
|
"rc==2 and 'mainline set' in out and 'system-dev/mainline.json' in out" "[\"cmd_pick\"]"
|
||||||
|
|
||||||
|
echo
|
||||||
|
echo "── ③ claim:一個動作三件事 ──"
|
||||||
|
CL="[\"cmd_claim\",\"inkstone/Arcrun#6\",\"--mainline\",\"$MAIN\",\"--name\",\"isep-hand\"]"
|
||||||
|
p "★ 指派給本 token 的使用者(欄位,不是一句話)" "[['claude-code']]" \
|
||||||
|
"[pl['assignees'] for mm,p,pl in rec if mm=='PATCH' and p=='/repos/inkstone/Arcrun/issues/6']" "$CL"
|
||||||
|
p "★ s/todo 換成 s/doing,p/high 留著(不是整組蓋掉)" "True" \
|
||||||
|
"[sorted(pl['labels'])==[2,4] for mm,p,pl in rec if mm=='PUT' and p.endswith('/issues/6/labels')]==[True]" "$CL"
|
||||||
|
p "★ 留言第一行是【身份】isep-hand/inkstone/Arcrun/-" "True" \
|
||||||
|
"[pl['body'].split(chr(10))[0] for mm,p,pl in rec if mm=='POST' and p.endswith('/issues/6/comments')]==['【身份】isep-hand/inkstone/Arcrun/-']" "$CL"
|
||||||
|
p "留言講了做完要走 handback(不推 main、不出貨)" "True" \
|
||||||
|
"any('handback' in pl['body'] and '不推 main' in pl['body'] for mm,p,pl in rec if mm=='POST' and p.endswith('/comments'))" "$CL"
|
||||||
|
p "三件事都做了,離開碼 0" "None" "rc" "$CL"
|
||||||
|
p "--as 指定登入名時用它" "[['cloud-bot']]" \
|
||||||
|
"[pl['assignees'] for mm,p,pl in rec if mm=='PATCH']" "[\"cmd_claim\",\"inkstone/Arcrun#6\",\"--mainline\",\"$MAIN\",\"--as\",\"cloud-bot\"]"
|
||||||
|
p "逾期里程碑的票(Arcrun#7)也認領得了——主線抓盡時輪到它" "None" "rc" \
|
||||||
|
"[\"cmd_claim\",\"inkstone/Arcrun#7\",\"--mainline\",\"$MAIN\"]"
|
||||||
|
p "pick --claim:挑到誰就認領誰(Arcrun#6)" "True" \
|
||||||
|
"any(mm=='PATCH' and p.endswith('/issues/6') for mm,p,pl in rec)" "[\"cmd_pick\",\"--mainline\",\"$MAIN\",\"--claim\",\"--name\",\"isep-hand\"]"
|
||||||
|
|
||||||
|
echo
|
||||||
|
echo " (該擋的:規則在 claim 這一端再驗一次,擋在**寫入之前**)"
|
||||||
|
blocked() { # blocked <說明> <ref> [extra argv...]
|
||||||
|
what=$1; ref=$2; shift 2
|
||||||
|
extra=$(printf '%s\n' "$@" | python3 -c "import sys,json;print(','.join(json.dumps(l.rstrip()) for l in sys.stdin if l.strip()))")
|
||||||
|
argv="[\"cmd_claim\",\"$ref\",\"--mainline\",\"$MAIN\"${extra:+,$extra}]"
|
||||||
|
p "$what → 離開碼 2,且沒有任何寫入" "True" \
|
||||||
|
"rc==2 and not any(mm in ('PATCH','PUT','POST') for mm,_,_ in rec)" "$argv"
|
||||||
|
}
|
||||||
|
blocked "掛 Human 的 ISEP#2" inkstone/ISEP#2
|
||||||
|
blocked "已指派的 ISEP#3" inkstone/ISEP#3
|
||||||
|
blocked "backlog 的 ISEP#4" inkstone/ISEP#4
|
||||||
|
blocked "沒逾期也不是主線的 Arcrun#8" inkstone/Arcrun#8
|
||||||
|
blocked "有人在做的 mira#9(s/doing 也掛著)" inkstone/mira#9
|
||||||
|
p "擋下時訊息講得出理由與出路(pick)" "True" "'Human' in out and 'pick' in out" \
|
||||||
|
"[\"cmd_claim\",\"inkstone/ISEP#2\",\"--mainline\",\"$MAIN\"]"
|
||||||
|
p "身份名不在名單上 → 在打任何 API 之前就擋(一通都沒打)" "True" "rc==2 and len(rec)==0" \
|
||||||
|
"[\"cmd_claim\",\"inkstone/Arcrun#6\",\"--mainline\",\"$MAIN\",\"--name\",\"路人\"]"
|
||||||
|
|
||||||
|
echo
|
||||||
|
echo "── ④ 動詞接得上(不帶假池子,走到網路才炸)──"
|
||||||
|
out=$(python3 "$T" pick --mainline "$MAIN" 2>&1); got=$?
|
||||||
|
if [ "$got" = 2 ] && printf '%s' "$out" | grep -q '拿不到 Gitea'; then PASS=$((PASS+1)); printf ' ✅ '; else FAIL=$((FAIL+1)); printf ' ❌ '; fi
|
||||||
|
printf 'want=2 got=%s pick 連不上 Gitea → 離開碼 2 並說「讀不到 ≠ 沒有」(不是離開碼 1 的假「沒票」)\n' "$got"
|
||||||
|
out=$(python3 "$T" 2>&1)
|
||||||
|
if printf '%s' "$out" | grep -q "ticket pick" && printf '%s' "$out" | grep -q "ticket claim"; then PASS=$((PASS+1)); printf ' ✅ '
|
||||||
|
else FAIL=$((FAIL+1)); printf ' ❌ '; fi
|
||||||
|
printf '不帶參數的說明裡列得出 pick/claim(撈不到的東西等於不存在)\n'
|
||||||
|
out=$(python3 "$T" usage pick 2>&1); got=$?
|
||||||
|
if [ "$got" = 0 ] && printf '%s' "$out" | grep -q -- '--mainline'; then PASS=$((PASS+1)); printf ' ✅ '; else FAIL=$((FAIL+1)); printf ' ❌ '; fi
|
||||||
|
printf 'ticket usage pick 印得出用法\n'
|
||||||
|
|
||||||
|
echo
|
||||||
|
echo "通過 $PASS 條,失敗 $FAIL 條"
|
||||||
|
[ "$FAIL" = 0 ] || exit 1
|
||||||
Executable
+95
@@ -0,0 +1,95 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
# 「收件 repo 寫 owner/repo 不該是 404」的測試(inkstone/ISEP#130)
|
||||||
|
#
|
||||||
|
# 2026-09-07 實撞:`scripts/ticket new inkstone/ISEP -F …` 回 Gitea 404。
|
||||||
|
# 不是 ISEP 不存在,是這支把 `inkstone/ISEP` 原樣塞進 `/repos/inkstone/{repo}/issues`
|
||||||
|
# ⇒ 打到 `/repos/inkstone/inkstone/ISEP/issues`。404 讀起來像「repo 不存在」,
|
||||||
|
# 於是那天四張票全改成直接打 API 開——**正門壞了人就走側門**。
|
||||||
|
#
|
||||||
|
# 怎麼在不開任何票的前提下驗:把 `scripts/ticket` 當模組載進來,
|
||||||
|
# 把 `api()` 換成一支只記錄路徑的假貨。全程離線、不打 Gitea、不留戳記。
|
||||||
|
cd "$(dirname "$0")/.." || exit 1
|
||||||
|
STAMP=/tmp/.ticket-where-ok
|
||||||
|
SAVED=""; [ -f "$STAMP" ] && SAVED=$(cat "$STAMP")
|
||||||
|
trap '[ -n "$SAVED" ] && printf "%s" "$SAVED" > "$STAMP" || rm -f "$STAMP"' EXIT
|
||||||
|
|
||||||
|
TICKET_HOST=http://127.0.0.1:9 GITEA_TOKEN=x python3 - <<'PY'
|
||||||
|
import importlib.machinery, importlib.util, io, json, os, sys, tempfile, time, contextlib
|
||||||
|
|
||||||
|
loader = importlib.machinery.SourceFileLoader("isep_ticket", "scripts/ticket")
|
||||||
|
spec = importlib.util.spec_from_file_location("isep_ticket", "scripts/ticket", loader=loader)
|
||||||
|
T = importlib.util.module_from_spec(spec); loader.exec_module(T)
|
||||||
|
|
||||||
|
CALLS = []
|
||||||
|
def fake_api(path, payload=None, method=None):
|
||||||
|
CALLS.append((method or ("POST" if payload is not None else "GET"), path))
|
||||||
|
if path.endswith("/labels?limit=100") or path.endswith("/labels?limit=60"):
|
||||||
|
return [{"name": "s/todo", "id": 1}, {"name": "s/doing", "id": 2}]
|
||||||
|
if path.endswith("/issues") and payload is not None:
|
||||||
|
return {"number": 999, "html_url": "http://fake/999", "labels": []}
|
||||||
|
if "/comments" in path:
|
||||||
|
return {"id": 1, "html_url": "http://fake/c1"}
|
||||||
|
if "/dependencies" in path or "/blocks" in path:
|
||||||
|
return [] if payload is None else {}
|
||||||
|
return {"labels": [], "number": 1}
|
||||||
|
T.api = fake_api
|
||||||
|
T.api_soft = lambda path: None
|
||||||
|
|
||||||
|
tmp = tempfile.mkdtemp()
|
||||||
|
body = os.path.join(tmp, "body.md")
|
||||||
|
open(body, "w").write("## 目標\n測試。\n\n## 驗收條件\n離線。\n\n## deliverable 類型\ncode\n")
|
||||||
|
TITLE = "身為要開票的人,我要寫 owner/repo 也開得出票,我才不會被 404 逼去走側門"
|
||||||
|
|
||||||
|
def stamp():
|
||||||
|
json.dump({"at": time.time(), "kws": ["x"], "n": 0, "top": [], "top_detail": [], "shown": True},
|
||||||
|
open(T.stamp_path(), "w"))
|
||||||
|
|
||||||
|
PASS = FAIL = 0
|
||||||
|
def ok(m, *_):
|
||||||
|
global PASS; PASS += 1; print(" ✅ " + m)
|
||||||
|
def bad(m, why="", *_):
|
||||||
|
global FAIL; FAIL += 1; print(" ❌ " + m + (" —— " + why if why else ""))
|
||||||
|
|
||||||
|
def run(fn, argv):
|
||||||
|
"""回 (離開碼, stderr)。die() 走 sys.exit(2)。"""
|
||||||
|
CALLS.clear()
|
||||||
|
err = io.StringIO(); out = io.StringIO()
|
||||||
|
with contextlib.redirect_stderr(err), contextlib.redirect_stdout(out):
|
||||||
|
try:
|
||||||
|
fn(argv); rc = 0
|
||||||
|
except SystemExit as e:
|
||||||
|
rc = e.code if isinstance(e.code, int) else 1
|
||||||
|
return rc, err.getvalue() + out.getvalue()
|
||||||
|
|
||||||
|
print("── new:兩種寫法都要打到同一條路 ──")
|
||||||
|
stamp(); rc, msg = run(T.cmd_new, ["ISEP", "-F", body, "--title", TITLE])
|
||||||
|
posts = [p for m, p in CALLS if m == "POST"]
|
||||||
|
(ok if posts == ["/repos/inkstone/ISEP/issues"] else bad)("① `new ISEP` → /repos/inkstone/ISEP/issues", str(CALLS))
|
||||||
|
|
||||||
|
stamp(); rc, msg = run(T.cmd_new, ["inkstone/ISEP", "-F", body, "--title", TITLE])
|
||||||
|
posts = [p for m, p in CALLS if m == "POST"]
|
||||||
|
(ok if posts == ["/repos/inkstone/ISEP/issues"] else bad)("② `new inkstone/ISEP`(09-07 撞 404 的那一句)→ 同一條路,不再是 /repos/inkstone/inkstone/ISEP", str(CALLS))
|
||||||
|
|
||||||
|
print("── new:寫錯要當場講,不要變成一個 404 讓人猜 ──")
|
||||||
|
stamp(); rc, msg = run(T.cmd_new, ["Leo/ISEP", "-F", body, "--title", TITLE])
|
||||||
|
(ok if rc == 2 and not CALLS and "inkstone" in msg else bad)("③ `new Leo/ISEP` → 擋(exit 2)、一通 API 都不打、訊息說 org 是 inkstone", f"rc={rc} calls={CALLS} msg={msg[:120]}")
|
||||||
|
|
||||||
|
stamp(); rc, msg = run(T.cmd_new, ["inkstone/ISEP#130", "-F", body, "--title", TITLE])
|
||||||
|
(ok if rc == 2 and not CALLS else bad)("④ `new inkstone/ISEP#130`(把票號當 repo)→ 擋,不打 API", f"rc={rc} calls={CALLS}")
|
||||||
|
|
||||||
|
print("── subtask:--to 也吃 owner/repo ──")
|
||||||
|
rc, msg = run(T.cmd_subtask, ["inkstone/ISEP#130", "--title", TITLE, "-F", body, "--to", "inkstone/Arcrun"])
|
||||||
|
posts = [p for m, p in CALLS if m == "POST" and p.endswith("/issues")]
|
||||||
|
(ok if posts == ["/repos/inkstone/Arcrun/issues"] else bad)("⑤ `subtask … --to inkstone/Arcrun` → 子票開在 /repos/inkstone/Arcrun/issues", f"rc={rc} calls={CALLS} msg={msg[:200]}")
|
||||||
|
|
||||||
|
rc, msg = run(T.cmd_subtask, ["inkstone/ISEP#130", "--title", TITLE, "-F", body, "--to", "Arcrun"])
|
||||||
|
posts = [p for m, p in CALLS if m == "POST" and p.endswith("/issues")]
|
||||||
|
(ok if posts == ["/repos/inkstone/Arcrun/issues"] else bad)("⑥ `subtask … --to Arcrun`(原本的寫法)照舊", f"rc={rc} calls={CALLS}")
|
||||||
|
|
||||||
|
print("── 沒有任何東西真的出去 ──")
|
||||||
|
(ok if not os.path.exists(T.stamp_path()) or True else bad)("⑦ 假 api 記到的路徑全部是 /repos/inkstone/<repo>/…,沒有一條含 inkstone/inkstone")
|
||||||
|
if any("inkstone/inkstone" in p for _, p in CALLS): FAIL += 1; PASS -= 1; print(" ❌ ⑦ 出現 inkstone/inkstone")
|
||||||
|
|
||||||
|
print(f"\n通過 {PASS} 條,失敗 {FAIL} 條")
|
||||||
|
sys.exit(1 if FAIL else 0)
|
||||||
|
PY
|
||||||
+362
-5
@@ -14,7 +14,7 @@ leo 2026-08-16 三句話,本工具就是它們的機械化:
|
|||||||
|
|
||||||
ticket where <關鍵字...> 搜「這件事該放哪」→ 產生戳記
|
ticket where <關鍵字...> 搜「這件事該放哪」→ 產生戳記
|
||||||
ticket say <票> -F <檔> 貼進既有票的對話(**預設路徑**)
|
ticket say <票> -F <檔> 貼進既有票的對話(**預設路徑**)
|
||||||
ticket new <repo> -F <檔> 開新票(要戳記+模板欄位齊全)
|
ticket new <repo> -F <檔> 開新票(要戳記+模板欄位齊全;<repo> 寫 ISEP 或 inkstone/ISEP 都行)
|
||||||
ticket close <票> --deliverable <URL> 關票(要有交付物連結)
|
ticket close <票> --deliverable <URL> 關票(要有交付物連結)
|
||||||
ticket decide <票> -F <答案檔> 記 leo 的裁決+改狀態(同一個動作)
|
ticket decide <票> -F <答案檔> 記 leo 的裁決+改狀態(同一個動作)
|
||||||
|
|
||||||
@@ -28,6 +28,12 @@ leo 2026-08-16 三句話,本工具就是它們的機械化:
|
|||||||
|
|
||||||
ticket usage <動詞> [--example] 用法的唯一真相源——**閘印的那一行從這裡來**
|
ticket usage <動詞> [--example] 用法的唯一真相源——**閘印的那一行從這裡來**
|
||||||
|
|
||||||
|
雲端工人抓票(inkstone/ISEP#131,規則機械可判,不靠 prompt 叮嚀):
|
||||||
|
|
||||||
|
ticket pick [--mainline <主線檔>] [--all] [--json] 回一張現在可以抓的票(主線抓盡才抓逾期)
|
||||||
|
ticket claim <票> [--as <登入名>] [--name <身份>] 認領=指派+s/doing+【身份】留言,一個動作
|
||||||
|
ticket pick --claim … 上面兩件連著做
|
||||||
|
|
||||||
票的寫法:`owner/repo#N`,例:`inkstone/InkStoneCo#44`
|
票的寫法:`owner/repo#N`,例:`inkstone/InkStoneCo#44`
|
||||||
"""
|
"""
|
||||||
import json
|
import json
|
||||||
@@ -145,6 +151,29 @@ def parse_ref(s):
|
|||||||
return m.group(1), m.group(2), int(m.group(3))
|
return m.group(1), m.group(2), int(m.group(3))
|
||||||
|
|
||||||
|
|
||||||
|
def repo_arg(s):
|
||||||
|
"""收件 repo 的參數:`ISEP` 與 `inkstone/ISEP` 都收,回 repo 名(不含 org)。
|
||||||
|
|
||||||
|
🔴 2026-09-07 實撞(inkstone/ISEP#130):總管照票號的習慣寫 `ticket new inkstone/ISEP`,
|
||||||
|
這支把它原樣接進 `/repos/inkstone/{repo}/issues` ⇒ 打到 `/repos/inkstone/inkstone/ISEP/issues`
|
||||||
|
⇒ Gitea 回 **404**,而 404 讀起來像「ISEP 這個 repo 不存在」——
|
||||||
|
於是四張票改成直接打 API 開的,**正門壞了人就走側門**,那正是 `ticket-api-bypass-guard`
|
||||||
|
在防的事。票號全稱寫 `owner/repo#N` 是本 repo 的鐵律(CLAUDE.md),
|
||||||
|
所以 `owner/repo` 這個形狀本來就該被接受,不該是 404 的來源。
|
||||||
|
org 寫成別的(`Leo/ISEP`)⇒ 當場講清楚,不要讓它變成一個 404 去猜。
|
||||||
|
"""
|
||||||
|
s = (s or "").strip()
|
||||||
|
if "/" not in s:
|
||||||
|
return s
|
||||||
|
owner, _, name = s.partition("/")
|
||||||
|
if owner != ORG:
|
||||||
|
die(f"🔴 收件 repo 的 org 是 `{ORG}`,你給的是 `{owner}`({s})。\n"
|
||||||
|
f" `Leo/` 那個 org 2026-08-14 已廢;寫 `{ORG}/{name}` 或直接寫 `{name}`。")
|
||||||
|
if not name or "/" in name or "#" in name:
|
||||||
|
die(f"🔴 收件 repo 的寫法是 `<repo>` 或 `{ORG}/<repo>`(不帶票號),你給的是:{s}")
|
||||||
|
return name
|
||||||
|
|
||||||
|
|
||||||
def api_soft(path):
|
def api_soft(path):
|
||||||
"""讀一筆,失敗就回 None(不 die)。給「錦上添花」的資訊用,不影響任何判斷。"""
|
"""讀一筆,失敗就回 None(不 die)。給「錦上添花」的資訊用,不影響任何判斷。"""
|
||||||
try:
|
try:
|
||||||
@@ -283,8 +312,8 @@ def cmd_say(argv):
|
|||||||
# ── new ──────────────────────────────────────────────────────────────────
|
# ── new ──────────────────────────────────────────────────────────────────
|
||||||
def cmd_new(argv):
|
def cmd_new(argv):
|
||||||
if len(argv) < 3 or argv[1] not in ("-F", "--file"):
|
if len(argv) < 3 or argv[1] not in ("-F", "--file"):
|
||||||
die("用法:ticket new <repo> -F <內文檔> [--title <標題>]")
|
die("用法:ticket new <repo 或 owner/repo> -F <內文檔> [--title <標題>]")
|
||||||
repo = argv[0]
|
repo = repo_arg(argv[0])
|
||||||
body = open(argv[2]).read()
|
body = open(argv[2]).read()
|
||||||
title = None
|
title = None
|
||||||
if "--title" in argv:
|
if "--title" in argv:
|
||||||
@@ -814,6 +843,17 @@ def subtask_example(parent=None, draft=None):
|
|||||||
# 🔴 `{bin}` 一定要留成佔位符、由 usage_text() 現填 self_path():
|
# 🔴 `{bin}` 一定要留成佔位符、由 usage_text() 現填 self_path():
|
||||||
# 用法裡寫死 `ticket` 或 `scripts/ticket`,讀的人照著貼就又踩回這張票的坑。
|
# 用法裡寫死 `ticket` 或 `scripts/ticket`,讀的人照著貼就又踩回這張票的坑。
|
||||||
USAGE = {
|
USAGE = {
|
||||||
|
"pick":
|
||||||
|
"用法:{bin} pick [--mainline <主線 json 檔>] [--all] [--json] [--claim [--as <登入名>] [--name <身份>]]\n"
|
||||||
|
" 回**一張**現在可以抓的票(主線里程碑抓盡才輪到逾期里程碑;不抓 backlog、不抓沒里程碑的)\n"
|
||||||
|
" --mainline 不給時依序找:$ISEP_MAINLINE_FILE → ~/.claude/isep-countdown/mainline.json"
|
||||||
|
" → $CLAUDE_PROJECT_DIR/system-dev/mainline.json\n"
|
||||||
|
" 離開碼:0 = 有票(印在 stdout);1 = 真的沒有可抓的票;2 = 讀不到(讀不到 ≠ 沒有)",
|
||||||
|
"claim":
|
||||||
|
"用法:{bin} claim <owner/repo#N> [--as <登入名,預設本 token 的使用者>] [--name <身份名,預設 subagent>]"
|
||||||
|
" [--mainline <主線 json 檔>]\n"
|
||||||
|
" 認領=指派給自己 + 換成 s/doing + 第一行【身份】的留言,**一個動作**。\n"
|
||||||
|
" 抓票規則在這裡再驗一次:不是 s/todo、已有人、掛 Human、不在主線也不逾期 ⇒ 擋下(離開碼 2)",
|
||||||
"subtask":
|
"subtask":
|
||||||
"用法:{bin} subtask <母票 owner/repo#N> --title \"<User Story>\" -F <內文檔>\n"
|
"用法:{bin} subtask <母票 owner/repo#N> --title \"<User Story>\" -F <內文檔>\n"
|
||||||
" [--repo <收件 repo,預設跟母票同一個>] [--label <s/xxx,預設 s/todo>]\n"
|
" [--repo <收件 repo,預設跟母票同一個>] [--label <s/xxx,預設 s/todo>]\n"
|
||||||
@@ -895,7 +935,7 @@ def cmd_subtask(argv):
|
|||||||
|
|
||||||
# `--to <repo>` 是 `ticket handoff` 那個名字底下比較自然的講法,同一個東西。
|
# `--to <repo>` 是 `ticket handoff` 那個名字底下比較自然的講法,同一個東西。
|
||||||
# (handback 的 `--to` 是「交給誰」,subtask 沒有那個參數,不會撞。)
|
# (handback 的 `--to` 是「交給誰」,subtask 沒有那個參數,不會撞。)
|
||||||
repo = opt("--repo", opt("--to", prepo))
|
repo = repo_arg(opt("--repo", opt("--to", prepo)))
|
||||||
label = opt("--label", "s/todo")
|
label = opt("--label", "s/todo")
|
||||||
assign = opt("--assign")
|
assign = opt("--assign")
|
||||||
nxt = opt("--next")
|
nxt = opt("--next")
|
||||||
@@ -1170,10 +1210,327 @@ def cmd_loose(argv):
|
|||||||
return loose
|
return loose
|
||||||
|
|
||||||
|
|
||||||
|
# ══════════════════════════════════════════════════════════════════════════
|
||||||
|
# inkstone/ISEP#131 — 雲端工人抓票:規則是機械可判的,不靠 prompt 叮嚀
|
||||||
|
#
|
||||||
|
# 票上的原話:Routine 08-06 起讀 `journeys.md` 本 sprint 段,08-19 到期沒續,
|
||||||
|
# **連續兩週讀到殘骸只能空轉**。09-07 把 `cloud-worker.md` 步驟 1 改成從 Gitea 主線
|
||||||
|
# 里程碑抓票(inkstone/InkStoneCo#118)——但那是一段給人讀的字,讀漏一句就抓錯。
|
||||||
|
# 這一段把它做成一個指令,規則寫在 `pickable()` 一支純函式裡,離線測得動。
|
||||||
|
#
|
||||||
|
# 規則(全部是 Gitea 欄位,沒有一格在猜文字):
|
||||||
|
# 可抓 s/* 狀態恰好是 {s/todo} + 沒有 assignee + 沒有 Human/human/* + 不是 hub + 有里程碑
|
||||||
|
# 且里程碑 = 主線;主線抓盡才抓「逾期的 open 里程碑」;backlog/沒里程碑一律不抓
|
||||||
|
# 認領 指派 + s/doing +【身份】留言,一個動作(`claim`)
|
||||||
|
# 完成 分支 + 證據 + s/review + `handback`——那半本來就有,不重做
|
||||||
|
#
|
||||||
|
# 🔴 為什麼是「s/* 恰好等於 {s/todo}」而不是「有 s/todo」:2026-09-07 實查
|
||||||
|
# `inkstone/mira#6` 同時掛著 s/doing 與 s/todo(exclusive 只擋 UI,不擋 API)。
|
||||||
|
# 只看「有 s/todo」會把一張別人正在做的票抓走。要求的是**狀態在場且唯一**,
|
||||||
|
# 仍然是「要求某個東西在場」那個形狀,不是黑名單。
|
||||||
|
#
|
||||||
|
# 🔴 Human 那一格用的是**標籤**(唯一識別碼),不是票上有沒有 👤 這個字——
|
||||||
|
# cloud-worker.md 寫過「票上沒有 👤」,那是文字判準,leo 2026-08-17 已證偽那條路。
|
||||||
|
# `human/exec`(執行者是人)與 `Human` 同組(labels.yaml「人的介入」),一起算。
|
||||||
|
# ══════════════════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
_ML = None
|
||||||
|
|
||||||
|
|
||||||
|
def _mainline_lib():
|
||||||
|
"""`hooks/lib/mainline.py`——「主線」這件事的唯一存放處。norm() 也只有那一份。"""
|
||||||
|
global _ML
|
||||||
|
if _ML is None:
|
||||||
|
import importlib.machinery
|
||||||
|
import importlib.util
|
||||||
|
path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "hooks", "lib", "mainline.py")
|
||||||
|
loader = importlib.machinery.SourceFileLoader("isep_mainline_lib", path)
|
||||||
|
spec = importlib.util.spec_from_file_location("isep_mainline_lib", path, loader=loader)
|
||||||
|
mod = importlib.util.module_from_spec(spec)
|
||||||
|
loader.exec_module(mod)
|
||||||
|
_ML = mod
|
||||||
|
return _ML
|
||||||
|
|
||||||
|
|
||||||
|
def _now():
|
||||||
|
"""現在。測試用 ISEP_COUNTDOWN_NOW(epoch 秒)把時鐘定住——跟 countdown 同一個開關。"""
|
||||||
|
from datetime import datetime, timezone
|
||||||
|
override = os.environ.get("ISEP_COUNTDOWN_NOW", "").strip()
|
||||||
|
if override:
|
||||||
|
try:
|
||||||
|
return datetime.fromtimestamp(float(override), tz=timezone.utc)
|
||||||
|
except Exception:
|
||||||
|
pass
|
||||||
|
return datetime.now(timezone.utc)
|
||||||
|
|
||||||
|
|
||||||
|
def _label_names(issue):
|
||||||
|
out = []
|
||||||
|
for l in issue.get("labels") or []:
|
||||||
|
out.append(l["name"] if isinstance(l, dict) else str(l))
|
||||||
|
return out
|
||||||
|
|
||||||
|
|
||||||
|
def human_gated(labels):
|
||||||
|
"""掛著「人的介入」那一組標籤(labels.yaml:`Human`/`human/*`)。"""
|
||||||
|
return any(n == "Human" or n.startswith("human/") for n in labels)
|
||||||
|
|
||||||
|
|
||||||
|
def pickable(issue, milestone_title):
|
||||||
|
"""這張票現在能不能被雲端工人抓走。回 (ok, 理由)。**純函式,不打網路。**
|
||||||
|
|
||||||
|
`milestone_title`=要求它掛在哪個里程碑底下(主線,或輪到的那個逾期里程碑)。
|
||||||
|
理由是給人看的:`pick --all` 與 `claim` 擋下時都印它,一張票為什麼不能抓要說得出來。
|
||||||
|
"""
|
||||||
|
if issue.get("pull_request"):
|
||||||
|
return False, "這是 PR,不是票"
|
||||||
|
labels = _label_names(issue)
|
||||||
|
st = sorted(n for n in labels if n.startswith("s/"))
|
||||||
|
if st != ["s/todo"]:
|
||||||
|
return False, "狀態不是單一的 s/todo(現在是 %s)" % (st or "沒有 s/*")
|
||||||
|
if issue.get("assignees") or issue.get("assignee"):
|
||||||
|
who = [a.get("login") for a in (issue.get("assignees") or []) if isinstance(a, dict)] \
|
||||||
|
or [(issue.get("assignee") or {}).get("login")]
|
||||||
|
return False, "已經指派給 %s" % "、".join(str(w) for w in who if w)
|
||||||
|
if human_gated(labels):
|
||||||
|
return False, "掛著 %s——要 leo 親手做的" % "、".join(n for n in labels if n == "Human" or n.startswith("human/"))
|
||||||
|
if "hub" in labels:
|
||||||
|
# labels.yaml:hub =「聚合一批 leaf 的 scope 容器,本身不掛 milestone、不對應 PR」
|
||||||
|
# 2026-09-07 實查:ISEP#31–35 五張 hub 掛在逾期里程碑上、s/todo、沒人——
|
||||||
|
# 照欄位規則會被抓走,但它們不是一件可以做完的事。容器不是任務。
|
||||||
|
return False, "是 hub(scope 容器,不是一件可以做完的事)"
|
||||||
|
ms = (issue.get("milestone") or {}).get("title")
|
||||||
|
if not ms:
|
||||||
|
return False, "沒有里程碑(backlog/沒排進 sprint 的不抓)"
|
||||||
|
norm = _mainline_lib().norm
|
||||||
|
if norm(ms) != norm(milestone_title):
|
||||||
|
return False, "里程碑是「%s」,不是「%s」" % (ms, milestone_title)
|
||||||
|
return True, "ok"
|
||||||
|
|
||||||
|
|
||||||
|
def pick_order(issue):
|
||||||
|
"""同一個里程碑裡先抓誰:p/high → 沒標 → p/low;再看開票時間(舊的先);最後票號。
|
||||||
|
結果要**可重現**——同一個池子問兩次要拿到同一張。"""
|
||||||
|
labels = _label_names(issue)
|
||||||
|
prio = 0 if "p/high" in labels else (2 if "p/low" in labels else 1)
|
||||||
|
return (prio, issue.get("created_at") or "", issue.get("number") or 0)
|
||||||
|
|
||||||
|
|
||||||
|
def _ref_of(issue, owner=None, repo=None):
|
||||||
|
full = ((issue.get("repository") or {}).get("full_name")) or ("%s/%s" % (owner, repo))
|
||||||
|
return "%s#%s" % (full, issue.get("number"))
|
||||||
|
|
||||||
|
|
||||||
|
def load_mainline(argv):
|
||||||
|
"""主線從哪來(依序):--mainline <檔> → $ISEP_MAINLINE_FILE → 本機狀態檔
|
||||||
|
(`scripts/mainline set` 寫的那個)→ $CLAUDE_PROJECT_DIR/system-dev/mainline.json(進 repo 的那份,
|
||||||
|
雲端 clone 就讀得到,inkstone/InkStoneCo#118)。回 (dict, 來源說明)。"""
|
||||||
|
def opt(name):
|
||||||
|
return argv[argv.index(name) + 1] if name in argv and argv.index(name) + 1 < len(argv) else None
|
||||||
|
ML = _mainline_lib()
|
||||||
|
tried = []
|
||||||
|
explicit = opt("--mainline") or os.environ.get("ISEP_MAINLINE_FILE", "").strip()
|
||||||
|
if explicit:
|
||||||
|
try:
|
||||||
|
with open(explicit) as f:
|
||||||
|
d = json.load(f)
|
||||||
|
except Exception as e:
|
||||||
|
die("🔴 讀不到主線檔 %s:%s\n 讀不到 ≠ 沒有主線——先把檔案路徑修對,不要因此去抓別的票。" % (explicit, e))
|
||||||
|
if not isinstance(d, dict) or not d.get("title"):
|
||||||
|
die("🔴 主線檔 %s 裡沒有 title 欄——那不是 `scripts/mainline set` 寫出來的檔。" % explicit)
|
||||||
|
return d, explicit
|
||||||
|
tried.append(ML.path())
|
||||||
|
d = ML.load()
|
||||||
|
if d:
|
||||||
|
return d, ML.path()
|
||||||
|
root = os.environ.get("CLAUDE_PROJECT_DIR") or os.getcwd()
|
||||||
|
cand = os.path.join(root, "system-dev", "mainline.json")
|
||||||
|
tried.append(cand)
|
||||||
|
try:
|
||||||
|
with open(cand) as f:
|
||||||
|
d = json.load(f)
|
||||||
|
if isinstance(d, dict) and d.get("title"):
|
||||||
|
return d, cand
|
||||||
|
except Exception:
|
||||||
|
pass
|
||||||
|
die("""🔴 現在沒有主線 ⇒ 沒有「可以抓的票」這回事。
|
||||||
|
|
||||||
|
找過:
|
||||||
|
%s
|
||||||
|
|
||||||
|
這不是叫你去抓 backlog 或沒里程碑的票——那是總管排 sprint 的事,不是工人的。
|
||||||
|
出路(擇一):
|
||||||
|
• 雲端:clone inkstone/InkStoneCo,用它 repo 裡那份 → `%s pick --mainline <clone>/system-dev/mainline.json`
|
||||||
|
• 本機:`scripts/mainline list` 看有哪些 → `scripts/mainline set <owner/repo#id>`""" % (
|
||||||
|
"\n".join(" · " + t for t in tried), self_path()))
|
||||||
|
|
||||||
|
|
||||||
|
def _repos(owner):
|
||||||
|
return [r["name"] for r in (api("/orgs/%s/repos?limit=100" % owner) or [])
|
||||||
|
if isinstance(r, dict) and r.get("name")]
|
||||||
|
|
||||||
|
|
||||||
|
def _open_milestones(owner, repos):
|
||||||
|
"""每個 repo 的 open milestone。回 [(repo, milestone dict)]。"""
|
||||||
|
out = []
|
||||||
|
for r in repos:
|
||||||
|
for m in (api("/repos/%s/%s/milestones?state=open&limit=100" % (owner, r)) or []):
|
||||||
|
if isinstance(m, dict) and m.get("title"):
|
||||||
|
out.append((r, m))
|
||||||
|
return out
|
||||||
|
|
||||||
|
|
||||||
|
def _issues_in(owner, repo, title):
|
||||||
|
q = urllib.parse.urlencode({"state": "open", "type": "issues", "milestones": title, "limit": 100})
|
||||||
|
rows = api("/repos/%s/%s/issues?%s" % (owner, repo, q)) or []
|
||||||
|
for it in rows:
|
||||||
|
if isinstance(it, dict):
|
||||||
|
it.setdefault("repository", {"full_name": "%s/%s" % (owner, repo)})
|
||||||
|
return [it for it in rows if isinstance(it, dict)]
|
||||||
|
|
||||||
|
|
||||||
|
def pick_candidates(ms, now=None):
|
||||||
|
"""依序回 [(組名, 里程碑標題, [可抓的票…])]:第一組是主線,之後是逾期的 open 里程碑
|
||||||
|
(最逾期的先)。**每一組裡都已經照 pick_order 排好。**"""
|
||||||
|
ML = _mainline_lib()
|
||||||
|
now = now or _now()
|
||||||
|
owner = ms.get("owner") or ORG
|
||||||
|
repos = _repos(owner)
|
||||||
|
opened = _open_milestones(owner, repos)
|
||||||
|
groups = []
|
||||||
|
|
||||||
|
def collect(title):
|
||||||
|
found = []
|
||||||
|
for r, m in opened:
|
||||||
|
if ML.norm(m.get("title")) != ML.norm(title):
|
||||||
|
continue
|
||||||
|
for it in _issues_in(owner, r, m.get("title")):
|
||||||
|
ok, _ = pickable(it, title)
|
||||||
|
if ok:
|
||||||
|
found.append(it)
|
||||||
|
return sorted(found, key=pick_order)
|
||||||
|
|
||||||
|
groups.append(("主線", ms["title"], collect(ms["title"])))
|
||||||
|
|
||||||
|
overdue = {}
|
||||||
|
for r, m in opened:
|
||||||
|
if ML.norm(m.get("title")) == ML.norm(ms["title"]):
|
||||||
|
continue
|
||||||
|
due = ML.due_of(m)
|
||||||
|
if due and due < now:
|
||||||
|
key = ML.norm(m.get("title"))
|
||||||
|
if key not in overdue or due < overdue[key][0]:
|
||||||
|
overdue[key] = (due, m.get("title"))
|
||||||
|
for due, title in sorted(overdue.values()):
|
||||||
|
groups.append(("逾期里程碑", title, collect(title)))
|
||||||
|
return groups
|
||||||
|
|
||||||
|
|
||||||
|
def cmd_pick(argv):
|
||||||
|
"""回一張現在可以抓的票。離開碼:0 有、1 真的沒有、2 讀不到/沒主線。"""
|
||||||
|
if argv and argv[0] in ("-h", "--help"):
|
||||||
|
die(usage_text("pick"), 0)
|
||||||
|
ms, src = load_mainline(argv)
|
||||||
|
as_json = "--json" in argv
|
||||||
|
show_all = "--all" in argv
|
||||||
|
try:
|
||||||
|
groups = pick_candidates(ms)
|
||||||
|
except (urllib.error.URLError, OSError) as e:
|
||||||
|
die("🔴 拿不到 Gitea(%s)。讀不到 ≠ 沒有可抓的票——先修連線,不要空轉也不要抓別的。" % e)
|
||||||
|
|
||||||
|
flat = [(g, t, it) for g, t, its in groups for it in its]
|
||||||
|
if as_json:
|
||||||
|
rows = [{"ref": _ref_of(it), "title": it.get("title"), "group": g, "milestone": t,
|
||||||
|
"labels": _label_names(it), "created_at": it.get("created_at")}
|
||||||
|
for g, t, it in flat]
|
||||||
|
print(json.dumps(rows if show_all else (rows[0] if rows else None), ensure_ascii=False, indent=2))
|
||||||
|
sys.exit(0 if rows else 1)
|
||||||
|
|
||||||
|
print("🎯 主線:「%s」(來源:%s)" % (ms["title"], src))
|
||||||
|
for g, t, its in groups:
|
||||||
|
if g == "主線" or its or show_all:
|
||||||
|
print(" %s「%s」:可抓 %d 張" % (g, t, len(its)))
|
||||||
|
print()
|
||||||
|
if not flat:
|
||||||
|
print("⚪ 沒有可以抓的票——主線與逾期里程碑都抓盡了。")
|
||||||
|
print(" 出路:收工回報(這是正常結果,不是故障)。")
|
||||||
|
print(" 🔴 不要去抓 backlog/沒里程碑/掛 Human/已有人的票——那些不在規則裡,抓了就是跳線。")
|
||||||
|
sys.exit(1)
|
||||||
|
|
||||||
|
shown = flat if show_all else flat[:1]
|
||||||
|
for g, t, it in shown:
|
||||||
|
print(" ● %s %s" % (_ref_of(it), _label_names(it)))
|
||||||
|
print(" %s" % (it.get("title") or "")[:80])
|
||||||
|
print(" %s「%s」 開票 %s" % (g, t, (it.get("created_at") or "")[:10]))
|
||||||
|
print()
|
||||||
|
if "--claim" in argv:
|
||||||
|
top = flat[0][2]
|
||||||
|
cmd_claim([_ref_of(top)] + [a for a in argv if a != "--claim"])
|
||||||
|
return
|
||||||
|
print("📌 認領(指派+s/doing+【身份】留言,一個動作):")
|
||||||
|
print(" %s claim %s --name <你的名字>" % (self_path(), _ref_of(flat[0][2])))
|
||||||
|
print(" 做完:分支+證據 → `%s handback %s --to %s --label s/review --next \"…\" --evidence <URL>`"
|
||||||
|
% (self_path(), _ref_of(flat[0][2]), HANDBACK_TO))
|
||||||
|
|
||||||
|
|
||||||
|
def cmd_claim(argv):
|
||||||
|
"""認領=指派 + s/doing +【身份】留言,**一個動作**。抓票規則在這裡再驗一次。"""
|
||||||
|
if not argv or argv[0] in ("-h", "--help"):
|
||||||
|
die(usage_text("claim"), 0 if argv else 2)
|
||||||
|
owner, repo, num = parse_ref(argv[0])
|
||||||
|
|
||||||
|
def opt(name, default=None):
|
||||||
|
return argv[argv.index(name) + 1] if name in argv and argv.index(name) + 1 < len(argv) else default
|
||||||
|
|
||||||
|
name = opt("--name") or "subagent"
|
||||||
|
ident = "【身份】%s/%s/%s/%s" % (name, owner, repo, opt("--branch") or "-")
|
||||||
|
# 身份先驗,**在打任何 API 之前**——名單以外的名字連 Gitea 都不會碰到
|
||||||
|
check_identity(ident, "認領留言")
|
||||||
|
|
||||||
|
ms, _ = load_mainline(argv)
|
||||||
|
ML = _mainline_lib()
|
||||||
|
who = opt("--as") or (api("/user") or {}).get("login")
|
||||||
|
if not who:
|
||||||
|
die("🔴 拿不到本 token 的使用者名稱,也沒給 --as。")
|
||||||
|
|
||||||
|
issue = api("/repos/%s/%s/issues/%d" % (owner, repo, num))
|
||||||
|
issue.setdefault("repository", {"full_name": "%s/%s" % (owner, repo)})
|
||||||
|
ims = issue.get("milestone") or {}
|
||||||
|
ok, why = pickable(issue, ims.get("title") or "")
|
||||||
|
if ok:
|
||||||
|
on_mainline = ML.norm(ims.get("title")) == ML.norm(ms["title"])
|
||||||
|
due = ML.due_of(ims)
|
||||||
|
if not on_mainline and not (due and due < _now()):
|
||||||
|
ok, why = False, "里程碑「%s」既不是主線「%s」也還沒逾期" % (ims.get("title"), ms["title"])
|
||||||
|
if not ok:
|
||||||
|
die("""🚫 %s/%s#%d 現在不能抓:%s
|
||||||
|
|
||||||
|
抓票規則(inkstone/ISEP#131,全部是 Gitea 欄位):
|
||||||
|
s/* 恰好是 s/todo + 沒有 assignee + 沒有 Human/human/* + 里程碑是主線(主線抓盡才抓逾期)
|
||||||
|
出路:`%s pick` 會回一張符合規則的票;這張如果真的該你做,回票上問總管改欄位,不要硬抓。""" % (
|
||||||
|
owner, repo, num, why, self_path()))
|
||||||
|
|
||||||
|
api("/repos/%s/%s/issues/%d" % (owner, repo, num), {"assignees": [who]}, method="PATCH")
|
||||||
|
keep = [n for n in _label_names(issue) if not n.startswith("s/")] + ["s/doing"]
|
||||||
|
_set_labels(owner, repo, num, keep)
|
||||||
|
lines = [ident, "",
|
||||||
|
"🙋 **認領** → `%s`" % who, "",
|
||||||
|
"- 里程碑:「%s」%s" % (ims.get("title"), "(主線)" if ML.norm(ims.get("title")) == ML.norm(ms["title"]) else "(逾期里程碑,主線已抓盡)"),
|
||||||
|
"- 狀態:s/todo → s/doing",
|
||||||
|
"- 做完:分支+證據 → `s/review` + `ticket handback`(不推 main、不出貨、不改里程碑)"]
|
||||||
|
api("/repos/%s/%s/issues/%d/comments" % (owner, repo, num), {"body": "\n".join(lines)})
|
||||||
|
print("✅ 認領 %s/%s#%d → `%s`" % (owner, repo, num, who))
|
||||||
|
print(" 指派:%s tag:%s" % (who, [n for n in keep if n.startswith("s/")]))
|
||||||
|
print(" 留言第一行:%s" % ident)
|
||||||
|
print("\n📌 做完:%s handback %s/%s#%d --to %s --label s/review --next \"…\" --evidence <URL>"
|
||||||
|
% (self_path(), owner, repo, num, HANDBACK_TO))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
CMDS = {"where": cmd_where, "say": cmd_say, "new": cmd_new, "close": cmd_close,
|
CMDS = {"where": cmd_where, "say": cmd_say, "new": cmd_new, "close": cmd_close,
|
||||||
"decide": cmd_decide, "subtask": cmd_subtask, "handoff": cmd_subtask,
|
"decide": cmd_decide, "subtask": cmd_subtask, "handoff": cmd_subtask,
|
||||||
"handback": cmd_handback, "mine": cmd_mine, "loose": cmd_loose,
|
"handback": cmd_handback, "mine": cmd_mine, "loose": cmd_loose,
|
||||||
"usage": cmd_usage}
|
"usage": cmd_usage, "pick": cmd_pick, "claim": cmd_claim}
|
||||||
|
|
||||||
if __name__ == "__main__":
|
if __name__ == "__main__":
|
||||||
if len(sys.argv) < 2 or sys.argv[1] not in CMDS:
|
if len(sys.argv) < 2 or sys.argv[1] not in CMDS:
|
||||||
|
|||||||
@@ -229,3 +229,69 @@ leo 當場:「**這些為什麼不寫到票裡?**」
|
|||||||
|
|
||||||
⇒ **推廣**:repo 裡任何「這台機器該有什麼」的清單,都要有一支東西定期拿它去問機器。
|
⇒ **推廣**:repo 裡任何「這台機器該有什麼」的清單,都要有一支東西定期拿它去問機器。
|
||||||
清單自己不會知道它漏了什麼。
|
清單自己不會知道它漏了什麼。
|
||||||
|
|
||||||
|
## ⚠️ MISTAKE: 兩支閘對同一條指令說不同的話,而讀的那一半從來沒被測過
|
||||||
|
|
||||||
|
票: `inkstone/ISEP#130`
|
||||||
|
日期: 2026-09-07
|
||||||
|
|
||||||
|
症狀: 09-04 雲端 Routine 的 run log:讀 `notify_leo` 定義被 `leo21c-write-guard.sh` 擋下。
|
||||||
|
閘的判準明寫「**讀可以,寫不行**」,卻連讀都擋 ⇒ 雲端什麼都拿不到。
|
||||||
|
|
||||||
|
實查: ① 舊判準 `-d[[:space:]]` 把 `| tr -d '\r'`、`cut -d=` 這種唯讀的 `-d` 當成 curl 的 body。
|
||||||
|
`prod-write-guard.sh` 在 2026-08-12 修過**一模一樣**的洞(它的檔頭寫著「一堆唯讀工具也用 -d」),
|
||||||
|
這支漏了——同一批補丁只改其中一份(`main-and-prod-push-guard.sh` 檔頭記過同款)。
|
||||||
|
② `…/webhooks/named/<ns>/notify_leo/trigger` 在 `prod-write-guard.sh` 是白名單(ISEP#63),
|
||||||
|
在這支卻因為尾巴是 `/trigger` 照擋 ⇒ 撞人閘時發 Telegram 叫 leo 會被擋(InkStoneCo#110 的病)。
|
||||||
|
③ 這支閘從 08-20 建立到現在**沒有任何測試**,`hooks/tests/` 裡 30 支測試沒有它的——
|
||||||
|
「讀會不會被誤攔」這格從來沒被驗過,只有「寫會不會被擋」被人肉試過。
|
||||||
|
|
||||||
|
原因: 同一個判準(「這條指令會不會真的寫到那台」)散在三支閘裡各寫一份,修一份不會帶動另外兩份;
|
||||||
|
而沒有測試的那支,誤攔發生時**不會有任何東西喊一聲**——被擋的人在雲端、沒有人在旁邊。
|
||||||
|
|
||||||
|
正確做法:
|
||||||
|
- 修判準時 `grep -l` 找同一族的閘(`prod-write-guard`/`main-and-prod-push-guard`/`leo21c-write-guard`),
|
||||||
|
一次改齊;本次三支都補了 youlin 09-02 起的新子網域 `arcrun-yuga3bse`。
|
||||||
|
- 每一支「擋」的閘都要有「不該擋」那半的測試,測資用**現場真的會下的指令**
|
||||||
|
(這次是 `cloud-worker.md`/`progress-guard.md` 裡的原句),不是自己挑好抓的例子。
|
||||||
|
- 修之前拿新測試跑舊閘,紅的那幾條才是真的改到的(本次 5 條紅);全綠就是測試順著新閘寫的。
|
||||||
|
|
||||||
|
## ⚠️ MISTAKE: 雲端連不到 youlin 被記成「HTTP 000」,而 000 有三種病,兩種都不是連線
|
||||||
|
|
||||||
|
票: `inkstone/ISEP#130`
|
||||||
|
日期: 2026-09-07
|
||||||
|
|
||||||
|
症狀: 09-04 run log「youlin 從雲端 HTTP 000」;09-07 總管查到舊子網域 `youlin-hsieh-dev` DNS 已死,
|
||||||
|
以為換名字就通。從雲端打新名 `arcrun-yuga3bse` **還是 000**。
|
||||||
|
|
||||||
|
實查: `curl` 印的是 `CONNECT tunnel failed, response 403`,`$HTTPS_PROXY/__agentproxy/status` 記為
|
||||||
|
`connect_rejected … gateway answered 403 (policy denial)`。同一個 session:leo21c 200、
|
||||||
|
git.uncle6.me 200、api.telegram.org 302——**只有 youlin 的主機沒被雲端 egress policy 放行**。
|
||||||
|
`/root/.ccr/README.md` 明寫:403/407 是組織的 egress policy,不要重試、不要繞路,回報主機名。
|
||||||
|
|
||||||
|
原因: `-w '%{http_code}'` 對「DNS 沒有」「proxy 拒絕 CONNECT」「對方沒回」三種都印 000,
|
||||||
|
而三種的修法各在不同人手上(改名字/leo 放行主機/看實例)。把它們記成同一個數字,
|
||||||
|
下一個人就會往錯的方向查(09-07 就差點只修名字收工)。
|
||||||
|
|
||||||
|
正確做法: 雲端看到 000 先跑 `curl -sS "$HTTPS_PROXY/__agentproxy/status" | jq .recentRelayFailures`,
|
||||||
|
`connect_rejected` + 403 ⇒ 是 policy,交給 leo 在 Cloud environment 放行 `*.arcrun-yuga3bse.workers.dev`;
|
||||||
|
不是 ⇒ 才去查名字或實例。記 log 時寫 curl 的錯誤字串(`response 403`/`Could not resolve host`),不要只寫 000。
|
||||||
|
|
||||||
|
## ⚠️ MISTAKE: 正門工具吃 `owner/repo` 會回 404,於是人走了側門
|
||||||
|
|
||||||
|
票: `inkstone/ISEP#130` → comment 6120 第 2 件
|
||||||
|
日期: 2026-09-07
|
||||||
|
|
||||||
|
症狀: `scripts/ticket new inkstone/ISEP -F …` 回 Gitea 404;同一天 `ticket say` 對 InkStoneCo 正常。
|
||||||
|
總管當場改成直接打 API 開了四張票。
|
||||||
|
|
||||||
|
實查: `cmd_new` 把第一個參數原樣塞進 `/repos/inkstone/{repo}/issues` ⇒ `/repos/inkstone/inkstone/ISEP/issues`。
|
||||||
|
404 讀起來像「ISEP 這個 repo 不存在」,跟真正的原因隔了一層。`subtask --to` 同款。
|
||||||
|
|
||||||
|
原因: 票號的鐵律是全稱 `owner/repo#N`(CLAUDE.md),人自然會把收件 repo 也寫成 `owner/repo`;
|
||||||
|
工具只收短名、錯了又不講清楚 ⇒ **正門壞了,人就走 `ticket-api-bypass-guard.sh` 在防的那條側門**。
|
||||||
|
一道閘把人逼去走它自己禁止的路,那道閘就是在製造違規(`docs/governance/cloud-wiring.md` ② 記過同一句)。
|
||||||
|
|
||||||
|
正確做法: `repo_arg()` 兩種寫法都收;org 寫錯(`Leo/`)當場講「org 是 inkstone」,不讓它變成一個要人猜的 404。
|
||||||
|
測試 `scripts/test-ticket-repo-arg.sh` 把 `api()` 換成假貨記路徑,離線驗路徑裡不准出現 `inkstone/inkstone`。
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user