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