主線成員改由相依邊決定，不靠同名里程碑；adopt 別 repo 的票＝加相依到 hub 票；帳本落在 InkStoneCo/system-dev（inkstone/ISEP#133 → 6743）

leo 2026-09-07：「拆，誰說『同名跨 repo 是 mainline 機制的一部分』，早就定了只有一個 milestone，不同 repo 用指針」。上一版 scripts/mainline 檔頭把現場的樣子（5 個同名）寫成「既有做法」，成員也照標題跨 repo 收；總管照它做、抄進 ops-facts、還在 arcrun-rag 補建了一個同名的。改了什麼（判準全部是 Gitea 欄位，沒有標題比對）： - hooks/lib/mainline.py：collect_members()＝hub 里程碑裡的票＋hub 票，沿 /dependencies 邊（跨 repo）收下去；belongs() 要同時拿到「掛哪個 milestone」＋「誰把它當相依」才准說「不屬於」，只知一半回 None（閘放行）；project_roots() 給主線檔與帳本共用 - scripts/mainline：set --hub <票>、adopt 別 repo ⇒ POST 相依到 hub 票（--via 可指定成員），沒 hub 票時擋下並給兩條走得通的路，不建同名里程碑；has 查 /blocks； refresh --members 才重收（真 Gitea 25 張要 19 秒，SessionStart 成本不變） - scripts/ticket：add_dependency() 一份（subtask 與 adopt 共用，409 冪等）；pick 主線組走成員清單，逾期組一個里程碑物件一組；claim 的主線判定改看相依；pickable(None) 給靠邊進來的票 - hooks/mainline-focus-guard.sh：新鮮查詢問 milestone＋/blocks，補收出路明講不要開同名里程碑 - scripts/milestone-account：帳本找家用同一把尺，退回原始碼目錄只在它有 .git（plugin 快取沒有）測試：新 hooks/tests/mainline-members-by-dependency.test.sh 56 條（假 Gitea 照真的回 201/409）； scripts/test-ticket-pick.sh 48→53 條（池子改用相依邊，補「同名沒邊 ⇒ 不抓」）；既有 mainline-focus-guard／repo-mirror／gitea-fallback／idle／milestone-account／debt-worklist／ handoff-writeback 全綠。真 Gitea 唯讀實跑：set --hub inkstone/InkStoneCo#44 收到 25 張、5 個 repo， mira#6／ISEP#130／ISEP#140／arcrun-rag#104 都在，不必新增任何邊。版本：待總管定版（改了會被載入的 hook／scripts）。 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0178ef1fGw3XeZtpN7LaZrm4
2026-09-07 10:40:55 +00:00
parent 7a9e30589c
commit d4bf172990
11 changed files with 912 additions and 170 deletions
@@ -420,12 +420,12 @@ bash hooks/tests/gitea-arm-check.test.sh                     .
 - ①③⑤⑥ 任一紅 ⇒ 收手收得太晚，暫存區已經開始長東西（磁碟風險回來了）
 - ② 紅 ⇒ 訊息沒給出走得通的那一行（本票整張票在講的就是這件事）
 - ⑧⑨⑩ 任一紅 ⇒ **誤攔／複製錯**：正常用法被弄壞，或複本裡混進了 `hooks/` 以外的東西
-### A31 — 雲端工人抓票的規則是機械可判的：48 條
+### A31 — 雲端工人抓票的規則是機械可判的：53 條
 ```
 bash scripts/test-ticket-pick.sh
 ```
-**該看到**：`通過 48 條，失敗 0 條`。**全程離線**：假池子（3 個 repo、3 個 open milestone、
-11 張票）餵給換掉的 `api()`，時鐘走 `ISEP_COUNTDOWN_NOW`，`TICKET_HOST` 指到連不上的位址
+**該看到**：`通過 53 條，失敗 0 條`。**全程離線**：假池子（3 個 repo、3 個 open milestone、
+12 張票、1 條相依邊）餵給換掉的 `api()`，時鐘走 `ISEP_COUNTDOWN_NOW`，`TICKET_HOST` 指到連不上的位址
 ——任何一條真的走到網路會當場炸，不會靜靜變成假綠。**不開票、不改票、不留任何東西在 Gitea 上。**

 **它在守什麼**（`inkstone/ISEP#131`）：Routine 08-06 起讀 `journeys.md` 本 sprint 段，
@@ -434,8 +434,10 @@ Gitea 主線里程碑抓票（`inkstone/InkStoneCo#118`），但那是一段給
 這一支把規則做成 `scripts/ticket pick`／`claim` 兩個動詞，規則本體在 `pickable()` 一支純函式：

 ```
-可抓  s/* 恰好是 {s/todo} ＋ 沒有 assignee ＋ 沒有 Human／human/* ＋ 不是 hub ＋ 里程碑＝主線
-      主線抓盡才抓「逾期的 open 里程碑」；backlog／沒里程碑一律不抓
+可抓  s/* 恰好是 {s/todo} ＋ 沒有 assignee ＋ 沒有 Human／human/* ＋ 不是 hub ＋ 在主線上
+      「在主線上」＝hub 里程碑裡、或被主線成員當相依（跨 repo 邊，inkstone/ISEP#133）；
+      別 repo 裡同名的里程碑**不算**主線。主線抓盡才抓「逾期的 open 里程碑」（一個里程碑物件一組）；
+      backlog／沒里程碑且沒有邊的一律不抓
 認領  claim ＝ 指派 ＋ s/doing ＋ 第一行【身份】的留言，一個動作
 完成  handback --label s/review（本來就有的那半，不重做）
 ```
@@ -448,6 +450,8 @@ Gitea 主線里程碑抓票（`inkstone/InkStoneCo#118`），但那是一段給
  要嘛抓盡了還回 `Arcrun#8`（既不是主線也沒逾期）
 - ②「離開碼 1」紅 ⇒ 「真的沒有票」與「讀不到」被講成同一句——後者要離開碼 2
 - ②「沒有主線 → 離開碼 2 且一通 API 都沒打」紅 ⇒ 沒主線時去抓了別的
+- ②「ISEP#1 靠相依進主線」／「ISEP#13 同名沒邊 → 不在」任一紅 ⇒ 成員又變回靠名字算
+  （leo 2026-09-07 推翻的那條判準回來了，A41 也會一起紅）
 - ③「該擋」六條任一紅 ⇒ 規則只長在 `pick` 這端，手動 `claim` 一張 Human 的票照樣過
 - ③「身份名不在名單上 → 一通都沒打」紅 ⇒ 名單以外的名字碰到了 Gitea
 - ④ 第一條紅 ⇒ 連不上 Gitea 時回了離開碼 1，雲端會把「斷線」當「沒票」收工
@@ -1014,6 +1018,52 @@ bash scripts/test-worktree.sh
 - (28)(29) 紅 ⇒ 判準滑回看名字（`course_gen` 被當關鍵字），違反本 repo 紅線。
 - (31)(32) 紅 ⇒ 把「離線」當成「沒推」——拿雜訊懲罰謹慎。

+
+### A41 — 主線成員由相依邊決定，不靠同名里程碑：56 條
+```
+bash hooks/tests/mainline-members-by-dependency.test.sh
+```
+**該看到**：`通過 56 條，失敗 0 條`。**全程離線**：Gitea 是本機一個假伺服器（`TICKET_HOST` 指過去，
+照真 Gitea 回：相依 POST 201、已存在 409、issue 列表用 `milestones=` 名字查），狀態走
+`ISEP_COUNTDOWN_STATE_DIR`、repo 那份走 TMP 底下的假薄殼、`HOME` 也指到 TMP。
+**不碰真家目錄、不碰真 Gitea、不碰真 InkStoneCo。**
+
+**它在守什麼**（`inkstone/ISEP#133` → comment 6743）：`scripts/mainline` 第一版檔頭寫
+「跨 repo 同名是既有做法，不動它」，成員也照標題跨 repo 收；總管 09-07 照它做、把那句抄進
+InkStoneCo 的 ops-facts、還在 arcrun-rag 補建了一個同名的。leo 當天：
+「**拆，誰說『同名跨 repo 是 mainline 機制的一部分』，早就定了只有一個 milestone，不同 repo 用指針**」
+（規則本身：`inkstone/ISEP#30`、`inkstone/InkStoneCo#44`）。
+
+現在的判準全部是 Gitea 的欄位，沒有標題比對：
+
+```
+錨       owner/repo#<milestone id>：整個 Gitea 只有這一個 milestone 物件
+hub 票   mainline set … --hub <owner/repo#N>：這條線的載體票，別 repo 的票用相依指到它
+成員     hub 里程碑裡的票 ＋ hub 票，沿 /dependencies 邊（跨 repo）收下去（hooks/lib/mainline.py::collect_members）
+adopt    同 repo ⇒ 掛進 hub 里程碑；別 repo ⇒ POST 相依到 hub 票（或 --via 指定的成員）。不建同名里程碑
+```
+
+**失敗**：
+- A 群 ③④⑤ 任一紅 ⇒ 相依邊沒走到（跨 repo 成員收不到）
+- A 群 ⑥⑦ 紅 ⇒ **同名里程碑裡的票又被當成成員**——被推翻的判準回來了
+- ⑪ 紅 ⇒ `set` 又去別的 repo 找同名的了
+- ⑮⑯⑰ 任一紅 ⇒ `adopt` 別 repo 的票不是加相依：要嘛改了那張票的 milestone、要嘛建了里程碑
+- ⑳ 紅 ⇒ 重複 adopt 炸了（Gitea 409 沒被當成「邊本來就在」）
+- ㉔–㉙ 任一紅 ⇒ 沒 hub 票時沒擋、沒給路、或給的路**貼上去跑不動**（㉙ 把訊息裡那行原樣執行）
+- ㉛–㉞ 任一紅 ⇒ **票上驗法第 1 條破了**：同名里程碑關掉後成員掉出主線，或 `pick` 抓不到靠邊進來的票
+- ㊱㊴㊵ 任一紅 ⇒ `has`／focus guard 沒去問 `/blocks`，只看 milestone 就下結論（那是「只知一半」）
+- ㊹ 紅 ⇒ 派一張掛在別 repo 同名里程碑、沒邊的票被放行 ⇒ 閘還在拿名字判
+- ㊻ 紅 ⇒ Gitea 讀不到時成員被清掉（讀不到 ≠ 沒有成員）
+- ㊼–㊿ 任一紅 ⇒ **票上驗法第 3 條破了**：帳本落在 plugin 快取（`claude plugin update` 一換就沒）
+
+📌 **真實 Gitea 唯讀實跑**（2026-09-07，isep-hand，state 與鏡像都指到暫存目錄，不寫 Gitea）：
+`mainline set inkstone/Arcrun#48 --hub inkstone/InkStoneCo#44` 收到 **25 張成員、5 個 repo**
+（里程碑裡 4 ＋ 相依收到 20），其中 `mira#6`、`ISEP#130`、`ISEP#140`、`arcrun-rag#104` 都在
+——**不必新增任何邊**，現有的相依圖已經連得到；`has` 四張都回「在」；
+`ticket pick --all` 主線組回 `Arcrun#197`、`mira#5`（後者靠 `Arcrun#86` 的邊，沒掛任何 hub 里程碑）。
+這一走 19 秒（約 30 次序列 GET）⇒ SessionStart 的 `refresh` **不帶** `--members`（成本不變），
+`set`／`adopt`／`refresh --members` 才重收；`pick`／`has`／閘每次現問 Gitea，快取只餵 `show`。
+
 ### A5 — 開票前的搜尋是跨 repo 的
 ```
 python3 scripts/ticket where 標籤 模組化
@@ -471,6 +471,8 @@ Telegram → 純投影。**Wiki 壞不影響 Gitea，Gitea 壞不影響 SDD，
 > 🔴 **排序不是按票號，是按「什麼擋住什麼」**：上面的群沒解，下面的群做了也看不到效果。
 > 本節是唯一把六群串起來的地方——Gitea 沒有跨 repo milestone（已查證），
 > 各 repo 的同名里程碑都指回這裡。
+> 🔴 **「各 repo 同名」這半句 2026-09-07 已被 leo 推翻**（`inkstone/ISEP#133`）：一條線只有一個
+> milestone，別 repo 的票用相依指到 hub 票；`scripts/mainline` 的成員判定改看相依邊，不看名字。

 ### 13.0 六群一頁看完

@@ -639,7 +641,7 @@ leo 08-17 診斷見公理 3；08-17 實測：文字層的閘 **8 次誤攔、0
 3. **一切要留痕、可量測。** 閘的動作、開場全局、里程碑百分比——leo 看到的畫面就是實況。
 4. **進度＝舊票關掉幾張。** 版本只是讓閘生效的載具，release note 寫明關了哪張票。

-### 15.2 工作順序（六個里程碑，各 repo 同名，內容一經確定不增不減）
+### 15.2 工作順序（六個里程碑，內容一經確定不增不減；「各 repo 同名」已於 2026-09-07 推翻——一條線一個 milestone，別 repo 用相依，`inkstone/ISEP#133`）

 | 順 | 里程碑 | 來源票（由目標遍歷票池而來，M4.0） |
 |---|---|---|
@@ -210,7 +210,7 @@
 | `no-ticket-no-dispatch.sh` | 派工單裡沒有寫工單號（`【工單】owner/repo#N`），或那張票已經關閉／根本不存在，就擋下——沒有票號的工作沒有人追得到進度。 | 🛑 擋 |
 | `dispatch-format-guard.sh` | **派工單 ＝ 票號，就這樣。** 票號以外還寫了別的東西（背景、驗收條件、紅線、交件方式、「這個 session 才知道的事」）就擋下，並告訴你那些內容該搬去哪：每次都一樣的 → 共通規定；這次才知道的 → **寫進那張票**。反過來，合規的派工它會**自動把共通規定注入**給收工方（交件方式、不准 push main、org 是 `inkstone`…），所以你不寫也不會漏。判準是「這一行是不是【工單】欄位」——**在不在**，不是寫了什麼，所以講得再謹慎也不會被多罰。純禮貌收尾（「謝謝」）不算違規；`（→ comment M）` 不論全形或半形括號都認得（ISEP#65 修過一次：CLAUDE.md 自己規定的合格寫法曾經被這支閘自己擋下）。**`ISEP#88` 起同一支閘也掛在「回覆 subagent」那條路上**（`SendMessage`、雲端 session／trigger、以及 Bash 的 `claude -p`）——回覆也是派工，同一套規矩；擋下來時會把那段內容**原文印出來**方便直接貼上票。subagent 往上回報（`to: "main"`）不管，那是交件不是派工。 | 🛑 擋（＋注入） |
 | `roster-guard.sh` | 派工要**指名派給誰**：`Task` 的 `subagent_type` 得是 `agents/` 名單上的名字（`isep-hand`／`arcrun-hand`／`scout`…），沒指名或指了不存在的名字就擋下，並把整份名單印出來。指對了它會**自動把那位工人的檔案原文注入**給它——你是誰、負責哪個 repo、開工前先讀什麼、你的紅線是什麼（這些每個工人都不一樣，共通規定補不了）。名單是資料：加一個工人＝在 `agents/` 加一個 `.md`，不必改任何 hook。 | 🛑 擋（＋注入） |
-| `mainline-focus-guard.sh` | 派出去的票**不在「現在的主線」上**，就擋一次，並問你是「補收」（它本來就該掛在主線上）還是「跳線」（真的插件事）。背景：2026-08-27 實查有 **14 個 milestone 同時開著**，其中「Mira 現代化」同名活在 5 個 repo ⇒ SOP 說的「只做該 milestone 的事」在現場**沒有指涉對象**，等於不存在。現在主線是一個查得到的事實（`scripts/mainline`，答案唯一），這支就是那個事實的用處。🔴 **沒有標主線 ⇒ 一律放行**；多張票只要有一張在主線上就放行；查不到那張票掛在哪也放行（**讀不到 ≠ 不屬於**）；**同一張票只擋一次**，重送就過。跳線會留一筆紀錄——不留痕的話，跳線與專注在機器上長得一模一樣。 | 🛑 擋（同一張票至多一次） |
+| `mainline-focus-guard.sh` | 派出去的票**不在「現在的主線」上**，就擋一次，並問你是「補收」（它本來就該掛在主線上）還是「跳線」（真的插件事）。背景：2026-08-27 實查有 **14 個 milestone 同時開著**，其中「Mira 現代化」同名活在 5 個 repo ⇒ SOP 說的「只做該 milestone 的事」在現場**沒有指涉對象**，等於不存在。現在主線是一個查得到的事實（`scripts/mainline`，答案唯一），這支就是那個事實的用處。「在不在主線上」看兩個 Gitea 欄位：掛在錨那一個 milestone、或被主線成員當相依（`/blocks`，跨 repo）——**別 repo 裡同名的里程碑不算**（leo 2026-09-07，`inkstone/ISEP#133`）。🔴 **沒有標主線 ⇒ 一律放行**；多張票只要有一張在主線上就放行；查不到那張票掛在哪、或查不到誰指著它，也放行（**讀不到 ≠ 不屬於**）；**同一張票只擋一次**，重送就過。跳線會留一筆紀錄——不留痕的話，跳線與專注在機器上長得一模一樣。 | 🛑 擋（同一張票至多一次） |
 | `dispatch-format-guard.sh` | **派工單 ＝ 票號，就這樣。** 票號以外還寫了別的東西（背景、驗收條件、紅線、交件方式、「這個 session 才知道的事」）就擋下，並告訴你那些內容該搬去哪：每次都一樣的 → 共通規定；這次才知道的 → **寫進那張票**。反過來，合規的派工它會**自動把共通規定注入**給收工方（交件方式、不准 push main、org 是 `inkstone`…），所以你不寫也不會漏。判準是「這一行是不是【工單】欄位」——**在不在**，不是寫了什麼，所以講得再謹慎也不會被多罰。純禮貌收尾（「謝謝」）不算違規；`（→ comment M）` 不論全形或半形括號都認得（ISEP#65 修過一次：CLAUDE.md 自己規定的合格寫法曾經被這支閘自己擋下）。 | 🛑 擋（＋注入） |
 | `parallel-lines-cap-guard.sh` | **同時在跑的線超過上限就派不出下一條**（預設 3，`ISEP_MAX_PARALLEL_LINES` 可調），而且訊息會列出現在有哪幾條在跑、各跑了多久。你關心的是：不會再因為一次派七條而讓機器爆掉，也不會再有「同時盯七條線所以派錯、量錯」那種錯。**條數是從 harness 自己寫的檔案數出來的，不是靠誰記得**——所以某一條收工，下一條立刻派得出去，不會卡死。真的非同時不可：`touch /tmp/.parallel-ok-<session_id>`（用一次就消失）。 | 🛑 擋 |

@@ -233,7 +233,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 本身的內容跟那張歸屬表對不對得上（雲端沒有專案那一份可比時，這是唯一還作數的檢查）③工作區有沒有已退役機制留下的產物 ④**打了 tag 卻沒 release**（Gitea 最新 tag 沒有 release、或 main 定版了還沒打 tag）——一行說缺哪一站＋可以直接貼著跑的補法（`scripts/release-ship`），都在時一個字都不說；判準跟 `release-ship`／`release-check` 同一份（`hooks/lib/release_chain.py`），匿名讀、問不到就閉嘴（`inkstone/ISEP#67`）。**全部只講不擋。** | 📝 記錄（context 注入） |
 | `session-start-recall.sh` | 對話一開始就自動把「全局現況」（Gitea 各 repo 的票、KBDB 的藏書地圖）推到 AI 眼前，不必等它自己想到要查。 | 📝 記錄（context 注入） |
 | `scripts/settings-allow-sync --quiet` | （不是閘，是腳本）對話一開始把 ISEP 的權限白名單（`docs/permissions-allow.json`：`ticket`／`mainline`／`gate-ok`／`gitea-pr-merge`／`stage`（inkstone/ISEP#137 起，雲端對 stage 寫入的正門）五個正門工具，外加 Arcrun 的 `stage-deploy-artifacts.py`）寫進**這台機器**的 `~/.claude/settings.json`。只加不減、冪等；目標檔壞掉就不碰它、講一聲。**為什麼**：leo 09-07 親手加的四條只在本機，雲端沒有 ⇒ 同樣的動作被分類器擋（09-04 run log `permission_denials=6`）；薄殼 repo 要 D20 開閘才推得動，所以清單住 ISEP 一份、兩台各自寫進自己的家目錄（inkstone/ISEP#130）。 | 📝 記錄（寫 settings） |
-| `scripts/mainline refresh` | （不是閘，是腳本）對話一開始把**現在的主線**那條 milestone 的進度與期限更新一次，好讓每回合眼前那一行講的是今天的數字。拿不到 Gitea 就原封不動——**寧可資料舊，不要把主線弄丟**。跑一次就結束，不輪詢。**家目錄與 repo 那份都不在時**（雲端薄殼跑到這裡 `InkStoneCo/` 還沒 clone）先去 Gitea 讀 `inkstone/InkStoneCo` main 的 `system-dev/mainline.json` 一次寫進家目錄（`inkstone/ISEP#140`）：匿名優先、被拒才帶 token；讀不到就退回，不報錯、逾時有上限。優先序寫在 `hooks/lib/mainline.py` 檔頭。 | 📝 記錄 |
+| `scripts/mainline refresh` | （不是閘，是腳本）對話一開始把**現在的主線**那條 milestone 的進度與期限更新一次，好讓每回合眼前那一行講的是今天的數字。拿不到 Gitea 就原封不動——**寧可資料舊，不要把主線弄丟**。跑一次就結束，不輪詢。成員清單（hub 里程碑裡的票＋沿相依邊跨 repo 收到的，`inkstone/ISEP#133`）**不在這裡重收**——真 Gitea 一走 19 秒；`set`／`adopt`／`refresh --members` 才重收，`pick`／`has`／focus guard 每次現問。**家目錄與 repo 那份都不在時**（雲端薄殼跑到這裡 `InkStoneCo/` 還沒 clone）先去 Gitea 讀 `inkstone/InkStoneCo` main 的 `system-dev/mainline.json` 一次寫進家目錄（`inkstone/ISEP#140`）：匿名優先、被拒才帶 token；讀不到就退回，不報錯、逾時有上限。優先序寫在 `hooks/lib/mainline.py` 檔頭。 | 📝 記錄 |
 | `overdue-nag-guard.sh` | 對話一開始就去 Gitea 撈**沒有人會叫的事**：逾期的 milestone、掛著等你的票（標「等了幾天」）、標著「有人在做」卻好幾天沒動的票；撈完用白話講出來，**有事就發 Telegram 給你**。沒東西可報時它會說「查過了，沒有」——**安靜跟壞掉長得一模一樣**。發不出去時不會靜默：它會先問這個 session 的 `prod-write-guard` 會不會擋（舊版把「發通知」誤認成「部署」），擋就改貼回票上並把原文印在眼前。只在開 session 時跑一次，**不輪詢、不掛排程**。 | 📝 記錄（context 注入 ＋ Telegram） |
 | `wiki-size-guard.sh` | 對話一開始講出「哪幾個 wiki 檔已經沒有人讀得完了」（預設超過 1200 行就點名）。**讀不完的必讀檔，跟沒有那個檔的差別只在於它讓人以為有。** 另一半掛在寫檔上，見 B 組。 | 📝 記錄（context 注入） |
 | `skill-deploy-drift-guard.sh` | 如果「全機真正在用的 skill」跟「repo 裡版控的正本」內容對不上，就在開場講出來——避免用著一份沒人知道已經跟正本分家的舊拷貝。 | 📝 記錄 |