inkstone/ISEP
2
0
Fork 0
Code Issues 18 Pull Requests 1 Actions Packages Projects Releases 22 Wiki Activity
102 Commits 64 Branches 24 Tags
3e83a4b4f30adf64cb4a8f320042e490d2576582
Commit Graph

102 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
claude-code 3e83a4b4f3 修好「總管可以放行」那道門——它在 Linux（＝每個雲端 session）上是焊死的（inkstone/ISEP#90 ④） 
三支閘（prod-write-guard／main-and-prod-push-guard／stage-before-prod-guard）
判斷戳記新不新，都寫成這一行：

    MT=$(stat -f %m "$STAMP" 2>/dev/null || stat -c %Y "$STAMP" 2>/dev/null || echo 0)

macOS（BSD stat）上 `-f %m` 就是 mtime，對的。
**GNU coreutils 的 `-f` 是「顯示檔案系統資訊」**，而且它一邊回非零、
一邊往 stdout 吐一整段區塊 ⇒ `||` 接上的秒數被那段文字污染
⇒ 下一行的 `case "$NOW$MT" in *[!0-9]*) return 1` 必然命中
⇒ **在 Linux 上那三支閘的戳記永遠不會被接受。**

後果不是少一個便利功能：那三支閘都是「擋下來、但總管看過就能放行」，
而放行那道門在雲端打不開 ⇒ **它們在雲端等於純擋**，
總管照著閘自己印的指示做，做幾次都打不開，閘也不會告訴他門是壞的
（inkstone/InkStoneCo#99 那次「連續四次蓋不出戳記」就是這個形狀）。

· hooks/lib/mtime.sh：先 `-c %Y`（GNU）再 `-f %m`（BSD），**每一步都驗是不是純數字**
  ——這個 bug 的成因正是「命令失敗了卻還是印了東西」，只看離開碼會再被騙一次。
  四支用到的檔各自帶一份 inline fallback：這道門不能因為少一個檔案就再關上一次。
· scripts/gate-ok：把散在各閘訊息裡的七種逃生口收斂成一個名字、一種形狀
  （`gate-ok <閘名> [參數]`）。原因是逃生口原本是「臨時湊出來的 Bash 指令」，
  而臨時湊的指令沒有穩定形狀可以事先放行——settings.json 的 allow 只能逐條完全比對，
  多一個 `&&`、換一個 session id 就落在規則外。它蓋的戳記與閘原本認的完全同一個檔、
  同一種語意（單次、綁 repo、綁 session、有效期都沒動），換掉的只有「怎麼蓋」。

測試 hooks/tests/gate-ok.test.sh：16/16。既有的三支測試（29／16／10）不受影響。
拿 main 跑同一份：②⑤（門打得開）紅、⑥⑦⑧（門沒變寬）全綠
⇒ 這支補的正是既有測試從來沒驗過的那半邊。
 2026-08-28 00:11:42 +00:00
claude-code adb7009b67 信標多報三件雲端會壞掉的事：版本落差／舊複本遮蔽正門／退役機制的殘骸（inkstone/ISEP#90 ②③） 
信標原本只證明「有一份 plugin 載入了」，不證明「載入的是哪一份」——
2026-08-27 雲端載的是 0.3.9、main 是 0.9.0，中間差 7 個 release，而它照樣是綠的。
那個看不見的落差的實際後果：0.3.9 裡還活著兩支 v0.9.0 已整支刪掉的 hook，
於是 .claude/pending-verification/ 被清掉之後又長回來。

三格（都只報告、不擋、拿不到答案就閉嘴）：
· 版本落差：匿名讀 ISEP main 的 plugin.json（D20 判準下屬於「讀」），快取 6 小時、
  逾時 6 秒。落後就講清楚差幾版與怎麼修，並指向 inkstone/ISEP#67。
· 舊複本遮蔽正門：plugin 的 scripts/* 在專案樹（含雲端的 $TOP/InkStoneCo/）裡
  有同名但**內容不同**的複本就點名。實例＝InkStoneCo/scripts/ticket 的取 token
  邏輯還停在「只認名叫 gitea 的 remote」，而雲端的 Gitea 叫 origin
  ⇒ 一律死在「拿不到 gitea token」⇒ 人被逼去繞過正門直接打 API，
  而那正是 ticket-api-bypass-guard.sh 在防的事。
· 退役機制的殘骸：.claude/ 底下的目錄，若 plugin 的 hooks/scripts 一個字都沒提到
  ⇒ 產生它的東西已經不在這一份裡了。判準是「plugin 現在還認不認得它」，
  **不是關鍵字黑名單**（leo 2026-08-17 已證明那條路 8 次誤攔、0 次正確攔截）。

訊息改由 hooks/lib/beacon_report.py 序列化：三段報告含引號與換行，
用 shell 內插拼 JSON 一個引號就會讓整行信標消失——而那正是「零閘狀態」的長相。
fail-open：python 掛掉、檔案不見、網路不通，一律退回原本那一行乾淨的信標。

測試 hooks/tests/isep-presence-beacon.test.sh：14/14（全離線）。
第 ⑪ 條守的是寫這支時真的犯過的 bug（內層迴圈變數跟外層的 d 撞名，
第二個殘骸之後全部被靜靜跳過）——把那個 bug 放回去，該條立刻轉紅。
 2026-08-28 00:05:15 +00:00
claude-code 352d7a0b81 未推警察改用「遠端有沒有這顆 commit」判斷，不再用「有沒有 upstream」（inkstone/ISEP#90 ①） 
雲端 session 開出來的工作分支天生沒有 upstream，內容卻等於遠端 main
（薄殼 HEAD 081c547 ＝ GitHub 遠端 main 081c547，同一顆）
⇒ 每個雲端 session、每次收工都被攔一次，08-27 一個 session 五次全是誤報。

三件：
· 判準改成問遠端（git ls-remote，快取 120 秒）。本機只答得準「有」，
  答「沒有」時才打網路——實測本 session 的 origin/main 落後遠端 4 天。
· 三態：遠端有／遠端沒有／問不到。**問不到一律不報**，不拿離線當罪證。
· 散落分支的基準也一起換成遠端實際那顆——基準過期會把已經在遠端 main 上的
  分支整批報成散落（包含雲端 session 自己那條）。

順手補雲端那格接線：`$CLAUDE_PROJECT_DIR` 在雲端是薄殼根，真身在 `$TOP/InkStoneCo/`。
舊的掃描清單四個路徑一個都不存在 ⇒ 真身有東西沒推，這支閘一輩子不會知道。

測試 hooks/tests/unpushed-police.test.sh：10/10（全離線，本機 bare repo 當遠端）。
拿舊版跑同一份：A 群 5 條全紅、B 群 4 條全綠 ⇒ 測試有鑑別力，不是改到寬鬆。
 2026-08-28 00:00:36 +00:00
claude-code e0ac81b2e3 Merge pull request '補上「用錯的路去證明一件事」那一格的閘（inkstone/ISEP#30 → comment 4879）' (#80) from feat/gate-search-is-not-proof into main v0.9.0 2026-08-27 13:41:17 +00:00
Leo 7de1ad6be6 補上「用錯的路去證明一件事」那一格的閘（inkstone/ISEP#30 → comment 4879） 
擋的是**證據的出處**，不是措辭。

判準（兩個條件同時成立才響）：
  ① 要送出去的那份東西（票上的留言／派工單）裡，貼了一個值
     ——entry id 或 `kb://` 來源位址——而它這個 session 只在
     `kbdb_search` 的回應裡出現過
  ② 這個 session 從沒用產品檢索路徑（graph／wiki 內容／query）拿過那筆

為什麼不比對措辭：驗收條件第 4 條寫死不准，而 leo 2026-08-17 已經證偽過
文字層——那天 8 次誤攔、0 次正確攔截，且方向穩定：紅線寫得越細，命中
關鍵字的機率越高 ⇒ 那些閘在懲罰謹慎。值跟動作一樣有限且可枚舉，措辭不是。

🔴 `kbdb_search` 一點都沒有變難用：查 wiki、找 record_id、看某筆在不在，
全部照放。它只在「把搜尋輸出貼出去當產品檢索壞掉的證據」那一刻才響。

實測 31 條，A 群（不該擋）11 條、B 群（該擋）5 條、C 群訊息 6 條、
D 群登記處 9 條。真跡重演＝inkstone/Arcrun#167 comment 4865 那則退回，
原文照貼會被擋；走過一次真路徑之後同一份留言就放行。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 21:38:17 +08:00
claude-code a001b10947 Merge pull request '戳記要證明「看過」，不是「跑過」（inkstone/ISEP#72）' (#79) from fix/stamp-proves-seen-not-run into main v0.8.0 2026-08-27 13:24:28 +00:00
Leo ba444d1210 戳記要證明「看過」，不是「跑過」（inkstone/ISEP#72 → comment 4873） 
2026-08-27 實犯：`ticket where … >/dev/null 2>&1` 之後直接 `ticket new`——
戳記寫成功了，命中的 72 張一眼沒看，於是開出 arcrun-rag#147，
而第一名 arcrun-rag#104 講的是同一件事，已經開了 13 天。

⇒ 舊戳記證明的是「這個程序被執行過」，而「有沒有看」在 stdout 那一端，
  閘本來完全碰不到。

做法：把 stdout 那一端變成機械事實，不是文字判斷。
- `fd_is_devnull(fd)`：fstat 問得出來的事實。刻意只認 /dev/null 這一種
  （寫進檔案讀得回來、pipe 有下游，只有 /dev/null 物理上找不回來）。
- `where` 把 `shown` 記進戳記；順便替前 3 名補內文摘要——今天的實害正是
  「光看標題看不出是同一條線」（#104 的標題完全沒提 ingest）。
- `new` 的閘一之二：命中 >0 且 shown 為假就擋，並把那份被丟掉的清單
  交到眼前；只要 stderr 不是 /dev/null，這一次的擋就記成「看過了」，
  重下一模一樣的指令就會過——成本落在「看」，不落在「寫」。
- 刻意排在閘二**之前**：否則第一次就帶 `--not-a-comment "理由"` 的人
  永遠看不到候選清單，理由是閉著眼睛寫的。
- 舊格式戳記（沒有 shown 欄位）當成沒看過（fail-closed）。

不該擋的（測試覆蓋）：沒命中就不吵、看過了就不吵、`--not-a-comment`
既有欄位照舊、不判斷理由寫得好不好（leo 2026-08-17 已證偽文字層判準）。

測試 17/17：scripts/test-ticket-where-seen-guard.sh（離線，不打真實 Gitea、
不留測試票；離開碼 2＝擋、1＝放行走到網路才炸）。docs/TESTING.md 新增 A13。
plugin.json 升到 0.8.0——版本沒動＝沒有人吃得到。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 21:17:35 +08:00
claude-code a4eb17df48 Merge pull request '補上「有動作但主線沒動」那一格的閘（inkstone/ISEP#30）' (#78) from feat/gate-catches-recon-without-output into main v0.7.0 2026-08-27 12:32:17 +00:00
Leo 35e927ef55 補上「有動作、不宣告」那一格：主線閒置警察（inkstone/ISEP#30） 
空手警察判「有沒有動作」、稼動率警察判「有沒有那句話」，兩支中間留了一格：
**有動作、就是不宣告下一步** ⇒ 兩支都放行。2026-08-27 實際發生的就是這一格。

新閘 hooks/mainline-idle-guard.sh（Stop）判的是「有沒有推進」，不是「有沒有動作」：
- 乾回合 ＝ 這回合 ≥3 個 tool call，且沒有任何推進證據
- 推進證據五種（任一成立就歸零）：派工／產出／寫進外部系統／Bash 寫入白名單／
  **工作區狀態變了**（HEAD 或未提交變更的指紋，heredoc·sed 改檔也吃得到）
- 連續 4 個乾回合擋一次，擋完歸零且**門檻加倍**（4→8→16）

一個字都不讀（守票上「不准文字層判準」那條紅線）；③④ 的字面比對只用來放行，
永遠不用來擋——白名單漏一項是少放行一次，黑名單漏一項是誤攔一次。

門檻 4 是量出來的，不是拍腦袋：重放 6 份真 transcript、1965 個真實回合，
門檻 3 響 4 次、門檻 4 響 1 次（0.05%）；門檻 3 多出來那三次都落在
「leo 連問問題、我逐題查證回答」的段落——那正是票上第 3 條驗收要保護的情境。

測試 hooks/tests/mainline-idle-guard.test.sh：61 條，A 群 15 條全是「不該擋」。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 20:28:55 +08:00
claude-code 736a601589 Merge pull request '盤點表補回漏掉的兩列人話＋補上驗得出這種漏的指令（inkstone/ISEP#75）' (#76) from docs/inventory-missing-rows into main v0.6.1 2026-08-27 10:39:59 +00:00
claude-code 1b64f3cc4e Merge pull request '跑測試不再偽造「有一筆推 main 在等你裁」（inkstone/ISEP#59）' (#77) from fix/tests-leave-no-forged-pending into main 2026-08-27 10:38:48 +00:00
Leo fa2f76177e docs(inventory): 反向那半補上真正驗得到幽靈的那一格（總管複驗退回） 
總管複驗指出反向 comm 有 3 個輸出。實跑重現了，但逐個查過之後：
**三個都不是幽靈，三個都不該刪。**

  claim-verify-police.sh / subagent-claim-worksheet.sh
    → 全部 5 處都在內文，講的是「已於 ISEP#60 移除」。表格列（第一欄）
      命中數 = 0。刪掉它們等於刪掉「G 組為什麼是空的」這段歷史。
  github-arm.sh
    → 它存在，在 scripts/ 不在 hooks/；出現在 github-contact-guard 那一列的
      描述裡，是告訴人「怎麼解鎖」的逃生口。刪掉那一列就不再說得出怎麼過閘。

成因是那組 grep 拿掉了 `^\| \`` 錨點。有錨點＝「這一行的第一欄就是這支閘」＝
表格真的列了它；沒錨點＝全頁所有反引號。**0 次正確攔截、3 次誤攔。**

但「頁面上出現根本不存在的檔名」確實該被抓到，只是不能靠文字判斷。
本次補上第三格 C：頁面提到的每個 *.sh，要嘛現在存在，要嘛 git 歷史裡存在過。
**「現在沒有但曾經有」＝歷史；「從來沒有過」＝幽靈。** 它問的是 git 不是用字。

順帶：標頭區那個 43 是 2026-08-20 快照段落裡的歷史數字，不是現況宣稱，
但原文用現在式讀起來像現況 ⇒ 加上「這一段每個數字都是那天的」標記。

實測（含兩個反向對照，證明新那格不是橡皮圖章）：
  現況              A1[] A2[] C[]                48 檔 / 48 列
  表格種一支假閘    A2 與 C 都叫
  散文種一支假閘    A1/A2 抓不到、C 抓到          ← 只有 C 守得住這種
18 個測試檔 0 失敗；claude plugin validate 通過。

inkstone/ISEP#75（總管複驗 comment 4822）
 2026-08-27 18:35:49 +08:00
Leo 950c3e1919 測試不再偽造「有一筆推 main 在等總管裁」（inkstone/ISEP#59） 
現象（實測，不是推論）：跑完 main-and-prod-push-guard 那三支測試之後

    $ git status --short
     M hooks/lib/__pycache__/strip_heredoc.cpython-314.pyc
     M pending-main-push/unnamed--ISEP.md
    ?? pending-main-push/unnamed--A.md

成因：這支閘擋下推 main 的同時，會把那次請求寫成
`<hooks 的上一層>/pending-main-push/<誰>--<repo>.md`，而三支測試的測資本來
就全是推 main。於是每跑一次測試，工作區就多／改幾筆**偽造的待裁決**。

兩個後果，後者比較貴：
  ① `git add -A` 很容易把它們帶進 commit（08-27 那次真的帶進去了，事後才拔掉）
  ② 總管的迴圈讀那個目錄，讀到的每一筆都該是真的在等他裁——
     測試每跑一次就偽造一筆 ⇒ **下一筆真的請求會混在雜訊裡**。
     這跟「永遠在響的警報」是同一個病。

改法（產品程式碼一行都沒動）：
- 新增 hooks/tests/lib/hook-sandbox.sh：把整個 hooks/ 複製到暫存區再跑複本。
  閘算 pending 目錄的位置靠的是 `$0` 的上一層 ⇒ 請求寫進暫存區。
  **刻意不在閘上開一個「寫去哪」的環境變數**——那種開關同時是一條把紀錄關掉的路。
- 三支測試改測沙盒複本，並各補兩條斷言：
  ① repo 的 pending-main-push 一個位元都沒動
  ② 沙盒裡**真的有**留下請求（只驗 ① 的話，把留紀錄的功能整個關掉也會綠）
- pending-main-push/ 不再進版控（它是本機狀態不是原始碼），只留一份 README 說明規約；
  既有的兩筆與那顆被追蹤的 .pyc 一併 `git rm --cached`，檔案留在硬碟上不刪。

實測：
- 三支各自 10/10、19/19、13/13（原本 8／17／11，各多兩條新斷言）
- 把 `H` 改回真跡重跑 ⇒ 新斷言兩條都紅（11/13）＋工作區又髒
  ⇒ 這兩條斷言真的抓得到它要抓的東西
- 全套 16 支測試檔跑完 0 失敗，`git status` 沒有多出任何一行
- `claude plugin validate .` ✔ Validation passed

沒有升版：這次只動測試與版控範圍，沒有任何閘的行為改變，
不需要靠新版本號送到任何人手上；請跟著總管下一個 release 一起出去。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 18:33:44 +08:00
Leo a671948fa5 docs(inventory): 補回表格漏掉的兩列人話，並補上驗得出這種漏的那組指令 
標頭寫 48 支，下面的表格只列得出 46 支——缺的是
`isep-presence-beacon.sh`（E 組 SessionStart）與
`milestone-due-guard.sh`（A 組 PreToolUse/Bash）這兩列。
不是本次合併造成的，`origin/main` 上數同一個指令也是這兩支。

為什麼這個漏會活這麼久：本頁「落差偵測」只有一組 comm，比的是
`hooks.json`（驗有沒有註冊），驗不了「有沒有寫進這張人話表」。
所以本次同時補上第二組 comm（fs 檔名 vs 表格列出的閘名），
並把「怎麼跟實況對帳」第 1 條指到那一組。

順手修掉同一頁另外兩處自己會騙人的地方：
- 標頭的複驗指令 `grep -c '"command"'` 會連 `"type": "command"` 一起數，
  實跑回 118 不是 59；正確寫法要帶冒號。
- 「其餘 41 支」是 43 支閘那一版數的。改成拿掉數字而不是改成 46——
  改成 46 等於宣稱逐支重讀過源碼，而這次沒有。

版本 0.6.0 → 0.6.1（v0.6.0 已出 release，不升版沒有人吃得到這頁）。

實測：48 檔 vs 48 列，兩個方向的 comm 都空；
18 個測試檔全綠（0 失敗）；claude plugin validate 通過。

inkstone/ISEP#59（comment 4779 第二件）
 2026-08-27 18:24:20 +08:00
claude-code 7795cd705a Merge pull request '第二波：棒子三格＋移除自造待驗單，版本收斂 0.6.0（inkstone/ISEP#58 #62）' (#74) from integrate/isep59-wave2 into main v0.6.0 2026-08-27 10:13:17 +00:00
Leo 577c736b74 merge: 移除自造的待驗單機制，改由 Gitea 原生三格承接（inkstone/ISEP#62） 
順序刻意是先 #58 後 #62：新機制（comment-carries-task-guard／baton-handback-guard／
scripts/ticket 的 subtask）先到位，舊機制才拆，main 上不存在「舊的拆了、新的沒到」的真空。

衝突只有 .claude-plugin/plugin.json：
- version 依 inkstone/ISEP#59 comment 4763 的裁決收斂成 0.6.0（四張 PR 各自宣告的作廢）
- description 的數字不採信任何一邊，改成併完後當場數出來的 48 支／59 條

一併把 docs/hooks-inventory.md 與 README.md 的同一組數字改成實數結果
（原本各寫 58／57，都是用加減兜出來的）。
 2026-08-27 18:02:24 +08:00
Leo 7e1b762cbe merge: 棒子不會掉——子票相依＋tag＋指派三格全用 Gitea 原生欄位（inkstone/ISEP#58） 
衝突只有 docs/hooks-inventory.md 的 A 組表格，解法照 ISEP#59 comment 4763 指定的
「兩列都留」：保留 main 上 #73 更新過的 ticket-api-bypass 敘述與 reply-identity-guard，
再加上本分支新增的 comment-carries-task-guard。標頭數字留到 #62 併完後一次實數。
 2026-08-27 17:56:11 +08:00
claude-code e32957e72b Merge pull request '封「新增 Gitea 東西」的每一道側門，不是只有開票（closes inkstone/ISEP#72）' (#73) from fix/gitea-write-search-guard into main 2026-08-27 09:50:21 +00:00
claude-code e7e60fff89 Merge pull request 'dispatch-format-guard 修兩處：合格範例被自己擋、禮貌收尾不該算違規（closes #65）' (#70) from fix/dispatch-guard-parens-and-wiring into main 2026-08-27 09:49:13 +00:00
Leo 23e4472715 封「新增 Gitea 東西」的每一道側門，不是只有開票（inkstone/ISEP#72） 
leo 2026-08-27：「開票不查是否有現成的，這是什麼問題？」「不只開票前，
所有新增 gitea 的東西，都要搜尋」。

v1 的 ticket-api-bypass-guard 只認裸字 `grep -qw POST`（大小寫敏感），
只管 issues 端點。2026-08-27 總管一天開 13 張票，v1 一次都沒攔到——
用的是 `urllib.request.Request(url, data=...)`（靠傳 data= 隱式變 POST，
指令裡從頭到尾沒有 "POST" 三個字）和 `requests.post(...)`（小寫）。

本次改動：
- 寫入訊號從單一裸字換成一組結構性訊號（curl 資料類旗標／`.post(`／
  `method=post`／urllib 隱式 POST），且大小寫不敏感，同時保留 v1 的裸字比對
- 端點擴大到 milestones／labels／pulls（含 org 層級的 labels），不再只管 issues
- 用「resource/數字」特徵先放行帶 ID 的既有資源子路徑（貼留言、改標籤、
  合併 PR 等），避免貪婪比對把 `/issues/5/labels` 誤判成頂層 `/labels` 端點
- 擋下 issues 新增時，順手用標題猜關鍵字查一次跨 repo 搜尋，把可能撞到的
  舊票（例如 Arcrun#100）直接列進擋下的訊息裡

測試：scripts/test-ticket-api-bypass-guard.sh 24/24 通過（v1 的 13 條 + 本次
新增 11 條，含一條打真實 Gitea 網路重演 Arcrun#100 重複主題偵測）。

plugin.json 0.5.0 → 0.5.1；version-consistency 會在合併打 tag 那一刻才對齊
（release-tag-guard.sh 的既定分工：打 tag 是總管驗過整個 milestone 之後的事）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 16:19:06 +08:00
Leo b1830053e5 dispatch-format-guard 修兩處：規則自己的合格範例會被自己擋，禮貌收尾不該算違規 
inkstone/ISEP#65：leo 發現「寫完 ISEP#30 那條規則之後，同一天總管又犯了 8 次」，
派來查「現行閘為什麼抓不到」。查證結果分兩層：

━━ 真正在跑的閘其實是 dispatch-format-guard.sh，不是 no-ticket-no-dispatch.sh ━━
no-ticket-no-dispatch.sh 的殼驗證早就是已知行為（只驗有沒有一行【工單】），
但 ISEP#30 已經為此新增了 dispatch-format-guard.sh 做內容判定，測試 19/19 通過。
問題是它有兩個沒被那 19 條測資蓋到的洞：

1. **regex 洞（本體 bug）**：頂層 CLAUDE.md 規定的合格格式帶全形括號——
   「【工單】owner/repo#N（→ comment M）」。_COMMENT_RE 只吃「→ comment M」
   本體，兩側括號沒被算進去，殘留括號讓 _REF_RE 比不過，於是**規則自己定義
   的合格範例會被自己的閘擋下**（半形括號 `(...)` 同樣會中）。用今天派我這張
   票的那份派工單原句實測，改之前 exit=2「票號形狀不對」。
2. **零容忍過頭**：純禮貌收尾（「謝謝」）跟「記得先讀 CLAUDE.md」這種真內容
   一樣被當「派工單不只有票號」擋下。ISEP#65 test 4 明講這四種不該擋
   （只有票號／空行／「謝謝」／括號包住的 comment 格式），優先做成低誤鎖。

判斷：不改 no-ticket-no-dispatch.sh、不另立第三支閘——dispatch-format-guard.sh
已經是「另立一支」的正確位置，這兩個洞在它自己的地盤上補。

修法：
- _COMMENT_RE 兩側括號（全形／半形）都設可選
- 新增 _COURTESY_CLOSERS 白名單（謝謝／多謝／感謝／辛苦了…）＋ _is_courtesy_closer()，
  只在圍欄外生效，判準仍是「整行清乾淨標點後完全相等」不是「包含」——
  白名單不是黑名單，猜漏頂多誤鎖一次，不會反過來放走真內容（③g 測資證明）

測試：hooks/tests/dispatch-format-guard.test.sh 19→33 條，全過。新增：
- ③b/③c 全形／半形括號格式（規則自己的例句）
- ③d/③e/③f ISEP#65 test 4 的三種不該擋
- ③g 白名單邊界（禮貌詞混真內容裡照樣算數，防止白名單被誤用成漏洞）
- ⑮b–⑮i：leo 點名的「寫完規則後又犯的 8 次」當回歸樣本，內容是從
  ISEP#60/#61/#64、Arcrun#142/#144/#165、arcrun-rag#104、InkStoneCo#102
  的真實票內文摘錄（見 hooks/tests/fixtures/README.md 記載來歷），
  不是想像出來的例子；8 種形狀全部驗證會被擋
reply-identity.test.sh 11/11 仍全過（共用 dispatch_parse.py 沒有回歸）

升版 0.5.0 → 0.5.1（改完不升版沒人吃得到；check-version-consistency.sh
在本分支照慣例是紅的，tag 於 merge 時打）。

另查：.shell-payload/ 整個被 gitignore（scripts/vendor-to-shell.py 產物），
不是 git 分發的一部分——「這支閘會不會被吃到」取決於消費端有沒有重跑
plugin update／vendor-to-shell.py，不是這個 repo 委交的內容缺漏，故不在
本票改動範圍內，僅記錄供總管排查用。

未動 no-ticket-no-dispatch.sh（判斷見上，職責保持不重疊，兩支閘互斥見
dispatch_parse.py 的 has_ticket_marker 分岔）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 14:25:17 +08:00
Leo 770a0ee824 移除自造的待驗單機制，改由 Gitea 原生三格承接（inkstone/ISEP#60） 
subagent-claim-worksheet.sh（SubagentStop 產待驗單）與 claim-verify-police.sh
（Stop 攔收工）這一套整組移除。它們守的東西違反 D58（不要硬做平台不支援的機制）
——「待驗單」只是一張沒有狀態、沒有持有人的 markdown，必然退化成雜訊。

改由 inkstone/ISEP#59／PR #58 的三個 Gitea 原生欄位承接同樣的情境：
子票相依（存在嗎/做完了嗎）、s/* tag（卡在哪）、指派（誰該動）。

- hooks/hooks.json：移除 Stop／SubagentStop 兩條註冊
- hooks/lib/path-resolve.sh：拿掉已刪檔案的註解引用
- docs/hooks-inventory.md、README.md：更新閘數量（48→46 檔、59→57 條註冊）
- docs/governance/sdd-gitea-governance.md：E12/E14 標記現況，新增 §8.4 說明
  移交對象；PR #58 未 merge 前這兩條實質仍是待建，誠實標記
- .claude-plugin/plugin.json：0.5.0 → 0.6.0（版本沒動＝plugin update 是 no-op）

未動 docs/governance/DIVERGENCE-v0.5.0-to-v0.6.0.md——那是 2026-08-20 的
時間點快照（意見書），修改它等於竄改歷史記錄，不在本票範圍。

未動 InkStoneCo/.claude/pending-verification/{done,done-20260826,verified}/
三個歸檔目錄——它們是 InkStoneCo repo 裡的已提交檔案，跨 repo 且需要
InkStoneCo 自己的 git 流程處理，超出本票（ISEP repo）範圍，留給總管判斷。

測試：scripts/test-*.sh 全數 6 支通過；hooks/tests/*.test.sh 與 pristine
origin/main 基準比對，失敗特徵完全一致（環境既有問題，非本次改動引入）；
claude plugin validate . 通過。check-version-consistency.sh 目前會報不一致
（0.6.0 vs tag v0.5.0）——這是預期的，等總管收斂 release 打 v0.6.0 tag 時解決。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-08-27 12:38:31 +08:00
Leo 9d20ef925e subtask 指派了人就一定要寫下一步——不然新子票一開出來就是「棒子沒有下一步」 
實跑 ticket mine 時自己抓到：剛用 subtask 開的 #143 顯示
「❌ 沒有人寫下一步」——工具自己造出了它要消滅的那個狀態。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 12:15:20 +08:00
Leo b46bc5e44c dogfood 抓到自己的漏：交棒標記只認第一行，不認「內文提過」 
實跑自己那則交件報告時，閘沒有擋——因為報告裡**引用了一段 ticket mine 的輸出**
（那段有 🏃），整則就被豁免掉了，而它裡面真的有「等雲端那半出貨」。
⇒ 同 inkstone/InkStoneCo#23 那個病：複述關鍵字被當成本人。
ticket handback 寫的交棒留言 🏃 一定在第一行，引用別人的輸出則不會 ⇒ 錨在第一行。

回歸測試 +2（20/20 → 22/22）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 12:13:27 +08:00
Leo 0b6af15f1a 補：實測探針票的去處，以及 close/* 七類沒有一類裝得下它 
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 12:08:48 +08:00
Leo e474b4cb6f 棒子不會掉：子票相依＋tag＋指派三格，全部用 Gitea 原生欄位 
leo 2026-08-27：「子票相依是 gitea 原有機制，改 tag 和指定也是，這些全部都要」

08-26 掉的那一次（arcrun-rag#136 comment 4267「等雲端那半出貨才驗得了」躺了
14 小時）三格全缺：沒有子票、tag 沒動、沒有指派給任何人。根因不是誰忘了，
是那件事沒有落在任何一個「撈一次就看得到」的欄位上。

實測（Gitea 1.26.4）：子票還開著時關母票 → HTTP 412
"cannot close this issue or pull request because it still has open dependencies"
⇒ 相依是平台保證的硬擋，不是提醒。跨 repo 也成立（201）。

- scripts/ticket 新增三個動詞：subtask（長子票＋掛相依）／
  handback（指派＋改 tag＋寫下一步，一個動作）／mine（撈一次看棒子在誰手上）
- hooks/comment-carries-task-guard.sh：留言帶未完成的未來式卻沒開子票 → 擋一次
- hooks/baton-handback-guard.sh：一條線收工，三格缺哪一格當場說出來（提醒不擋）
- docs/governance §16：三個維度／粒度（傾向多開票）／既有票只從今天起適用／
  與 s/* 的關係／實測輸出
- 測試 20+10 全綠，用 fixture 跑不打網路、不在票池留測試票

📌 踩到並記進閘的檔頭：hook 裡比對中文一律用 python3 的 re，不要用 grep 的字元類
（等[^。]{0,20}出貨 在真實 hook 呼叫路徑下對「等雲端那半出貨」不匹配，閘靜默失效）

票：inkstone/ISEP#30（comment 4334／4335／4346／4347）

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 12:05:53 +08:00
Leo 8e28041ba4 merge: 派工單只剩票號——閘從驗「有沒有票號」改成驗「是不是只有票號」（ISEP#30） 
leo 2026-08-27：「這些話票上都沒有，你根本沒照規則做事，你的 hook 讓你這樣搞？」
四條追加：output parser 分點規定格式／散文警察抓不到／描述寫進票留歷史／subagent 回覆要表明身份。

總管複驗過才併（自己跑的）：
- dispatch-format-guard.test.sh  19/19
- reply-identity.test.sh         11/11
- 兩支都涵蓋「該擋」與「不該擋」兩側；訊息點得出違反哪一條規則，不是籠統的「格式不對」

版本 0.3.9 → 0.5.0（產物按版本號分資料夾，不升版新閘不會被載入）。

🔴 仍是 report 不是 deliver 的一格：「新 session 真的會叫它」要併版後開新 session 才驗得了。
v0.5.0 		2026-08-27 11:55:24 +08:00
Leo 3bc7f3c5f5 派工單只剩票號——閘從驗「有沒有票號」改成驗「是不是只有票號」 
leo 2026-08-27（inkstone/ISEP#30 comment 4322／4325／4327）：
「這些話票上都沒有，你根本沒照規則做事，你的 hook 讓你這樣搞？」
「你用一個 output parser 把你給 subagent 的指令規範，分作幾點，每一點規定格式，
  照這種散文寫法根本無法迭代」「警察也不能抓」
「交件方式不需要寫，定義在原則裡⋯⋯每次都一樣提取出來變成共通規定」
「（那些 session 事實）這些為什麼不寫到票裡？」「subagent 回覆時要表明身份」

病根：no-ticket-no-dispatch.sh 驗的是「有沒有一行【工單】owner/repo#N」，
而規則的原文是「派工單只寫票號」。⇒ 把 40 行任務全寫在 prompt 裡、票號補一行，
閘照樣放行。2026-08-27 一天內這樣做了 5 次，每次票上都沒有那份任務。
規則存在，閘只驗了它的殼——同款第 N 次（history-first／KBDB-first／stage-first）。

新增 hooks/dispatch-format-guard.sh（PreToolUse Task｜Agent），兩件事：
- 擋：【工單】以外還有實質內容就 exit 2，並指出那些內容該搬去哪
  （每次都一樣 → 共通規定；這次才知道 → 寫進那張票。
   判準「這句話換一張票還成立嗎？」）
- 注入：合規的派工自動把共通規定送給收工方（交件方式、不准 push main、
  org 是 inkstone…）——這是「派工單只剩票號」能成立的前提，
  leo 的驗收條件之一就是「收工方沒讀派工單也知道要貼回原票」

判準是結構不是文字（leo 2026-08-17 那條檢驗）：問的是「這一行是不是【工單】欄位」
——在不在，不是寫什麼。hooks/lib/dispatch_parse.py 全檔零個「命中某個詞就違規」的比對。
⇒ 也因此不需要語意判官：免費、瞬間、每次結果一樣。

新增 hooks/reply-identity-guard.sh（PreToolUse Bash）＋ scripts/ticket 內建檢查：
票上每一則留言第一行要有【身份】（總管／subagent／leo）。貼留言有兩條路，兩條都封
——ticket-api-bypass-guard 是刻意放行「對既有票留言」的，只封正門等於沒封。
實害：多條線並行時總管寫的診斷被當成 subagent 的結論，而其中一則是錯的。

規約寫成文件：docs/governance/dispatch-and-reply-format.md
（§2 那段就是被注入的那份共通規定本體——只有一份，改那裡等於改所有派工）

實測（離線、不打網路、不花錢）：
  hooks/tests/dispatch-format-guard.test.sh   19/19
  hooks/tests/reply-identity.test.sh          11/11
測資裡的 B⑨ 是真跡：產生 ISEP#30 這條線的那一次派工，一字未改。
另 4 份 leo 點名的違規派工拿不回來了——它們住在 prompt 裡，agent 一停就沒了，
這件事本身就是這條規則的證據（見 hooks/tests/fixtures/README.md，不用想像的例子替補）。

升版 0.4.0 → 0.5.0（產物按版本號分資料夾，不升版新閘不會被載入）。
tag 照慣例打在 merge commit 上，所以這條分支上 check-version-consistency.sh 是紅的。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 11:35:03 +08:00
Leo 8e7e265589 merge: 閘掛在收工後，而 leo 是在被問到的當下被打擾——補上那一刻的攔截（InkStoneCo#55） 
leo 2026-08-26：「今天已經好幾次問我，為什麼 hooks 沒有攔下來？」

總管複驗過才併：
- 掛點：PreToolUse / matcher AskUserQuestion（自己從 hooks.json 解出來的）
- 封動作不封文字：整支 261 行零個判擋用的正則，決定 exit 2 的只有判官 verdict；
  判官掛掉／回空／不在 PATH 一律 fail-open
- 測試自己跑過 14/14（含「樹要不要捲」那種真人閘必須放行的案例）
- 版本 0.3.9 → 0.4.0：第一版忘了升版，而產物是按版本號分資料夾的
  ⇒ 不升版＝新閘永遠不會被載入。退回補後已驗產物資料夾長得出來。

🔴 仍有一格是 report 不是 deliver：「新 session 真的會叫它」驗不到——
AskUserQuestion 官方明載 subagent 不可用，它撞不到自己這道閘。
那一格要 leo 開新 session 才驗得了。
v0.4.0 		2026-08-26 22:43:34 +08:00
claude-code e0557334bc 閘掛在「收工後」，而 leo 是在「被問到」的當下被打擾——補上那一刻的攔截 
leo 2026-08-26：「今天已經好幾次問我，為什麼 hooks 沒有攔下來？」

實查：總管問 leo 走的動作是 AskUserQuestion，而 hooks.json 裡它出現 0 次，
沒有任何 matcher。判準其實早就寫好了——self-drive-police / self-drive-judge
用的就是同一套四題公式——但那兩支只掛在 Stop 與 SubagentStop，
是回合結束後才跑的。問題早就送到他眼前了，事後再反問「你查過了嗎」，
成本已經轉嫁出去。判準對了，時機錯了。

新增 hooks/ask-user-question-guard.sh（PreToolUse / AskUserQuestion）：
- 觸發條件是那個動作本身，不是任何句型或關鍵字——全檔零個判擋用的正則，
  換句話說閃不過去，講得謹慎也不會被多罰（leo 2026-08-17 文字層封路的檢驗）
- 進來之後用四題公式的 haiku 判官分「該問 / 不該問」，命中任一題一律放行
- 同一個問題只擋一次（雜湊戳記）：判官誤判時重送即過，
  leo 該收到的問題不會因為一支閘而永遠送不到
- 判官掛掉／沒網路／claude 不在 PATH 一律 fail-open，壞掉等於它不存在

版本 0.3.9 → 0.4.0。這不是儀式，是傳輸機制本身：產物按版本號分資料夾
（~/.claude/plugins/cache/inkstone/isep/<版本>/），版本沒動就不會長出新資料夾，
這支閘一個 session 都載入不到。docs/TESTING.md 開頭那段講的就是這件事，
而第一版我漏了——總管複驗時量出來的。

假設（沒有前例可循，先裁再記）：跳 0.4.0 而不是 0.3.10。理由是這一版第一次
掛上 AskUserQuestion 這個事件面，是新能力不是修補；而且 0.3.10 在
plugin 快取目錄的 ls 裡會排到 0.3.1 旁邊，肉眼不好認。錯了打回，改號很便宜。

順手修掉自己寫出來的一個坑：訊息原本用沒加引號的 heredoc，
反引號被當命令執行，wiki 路徑與豁免指令兩行變成空白（閘照擋，只看離開碼看不出來）。
已收成 mistakes.md 一條，並由 ⑩b 這條測試守著。

實測：
- hooks/tests/ask-user-question-guard.test.sh      14/14（離線，不花錢）
- hooks/tests/ask-user-question-guard.live.test.sh 9/9 連跑三次（真的叫 haiku）
  A 群 5 條真人閘（花錢／不可逆／跨專案結構／品味方向／物理人閘）全部放行，誤攔 0
  B 群 4 條純技術路徑選擇全部擋下
- 既有 7 支測試與改動前逐條對照，結果完全相同（沒有被我弄壞）

順手對帳：plugin.json 與 marketplace.json 的描述寫「43 支機械閘、53 條註冊」，
實際數過是 46／56（含本次新增這支）。docs/hooks-inventory.md 一併更正。

【工單】inkstone/InkStoneCo#55
 2026-08-26 22:36:08 +08:00
claude-code d4547bfec3 Merge pull request '信標自己講「這一份是誰」——vendor 還是 plugin 快取' (#55) from fix/beacon-says-which-copy into main v0.3.9 2026-08-23 13:03:37 +00:00
Leo 2f43ecc346 信標自己講「這一份是誰」——vendor 還是 plugin 快取 
leo 的雲端驗收整整卡了一輪在這個問題上：同一台機器可能有兩份 ISEP，
兩份都會印信標，版本號一樣時分不出誰在說話。而「閘從哪一份走」正是決定
「另一份能不能拆」的唯一判準。

總管上一版設計的判準（叫雲端跑 env | grep CLAUDE_PLUGIN_ROOT）也是錯的：
那個變數是 hook 呼叫當下才注入的，在 Bash 工具的 env 裡本來就看不到
⇒ 空輸出不代表沒載入，那個探針從一開始就答不了這題。

改法：讓路徑自己講。快取在 plugins/cache/ 底下，vendor 的在 repo 的 .claude/ 底下。

三向實測：
  /root/.claude/plugins/cache/inkstone/isep/0.3.9  → 來源：plugin（marketplace 裝的）
  /home/user/inkstoneco/.claude/isep               → 來源：vendor（repo 裡的複製本）
  其他路徑                                          → 來源不明（不假裝知道）

inkstone/InkStoneCo#57
 2026-08-23 21:02:45 +08:00
claude-code 1b95388a0f Merge pull request '身為總管，我要這道閘擋的是「宣告」而不是「提到宣告」，我才不會一舉報 bug 就被它擋下' (#54) from fix/factory-idle-guard-blocks-actions-not-mentions into main v0.3.8 2026-08-23 09:58:41 +00:00
Leo e3d05df341 再修兩類：主詞是 leo 的下一步、票號放寬把閘變鈍——都是真 transcript 量出來的 
交付警察擋回來是對的：前一顆只驗了「我自己造的假 transcript」。
改用本機一條 2068 行的真 session（26 個真實回合終止點）重驗，當場多找到兩個問題：

① 主詞是「你」的下一步，被當成我的宣告。
   舊閘在 26 個真實回合裡擋了 2 次，兩次咬的都是我在交代 leo 該做什麼：
     「下一步還是那一個動作：你把 feat/... 併進 main」
     「## 你下一步（兩招，先便宜的）」
   ⇒ 這是全新的第四類誤攔，我原本一向都沒列到。
   修法是主詞檢查（誰要動手），只掛在「下一步」這條 alternative 上；
   用 finditer 逐個檢查前 8 字有沒有第二人稱，蓋得到「你的下一步」這種
   單字 lookbehind 蓋不到的變體。「你點頭我就做」主詞本來就是我，不受影響。

② 票號從「宣告句附近」放寬成「整段」，把閘變鈍了。
   真數據：26 個真實回合有 20 個是靠「文中某處剛好有票號」放行的——
   而報告幾乎一定會提到票號 ⇒ 這道閘在實務上等於不會響。
   當初放寬是因為票號常寫在行內 code 裡，剝掉就找不到。
   ⇒ 改成**等長**替換（蓋成同樣長度的哨兵而非刪除），位移就能對回原文，
     locality 與「行內 code 裡的票號也算數」兩件同時成立。
   收緊後的判定分佈：21 no-declaration ／ 3 dispatched ／ 2 ticket-referenced
   （原本是 20 ticket-referenced ／ 3 no-declaration ／ 3 dispatched）。

真 transcript 實測：舊閘擋 2 次（兩次都是誤攔）→ 新閘擋 0 次。
測試 33 向（+6）：舊版 21/33 → 新版 33/33。
版號 0.3.7 → 0.3.8。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-23 17:54:17 +08:00
Leo a594decb78 稼動率警察改成擋「宣告」，不擋「提到宣告」 
2026-08-23 雲端驗收連續三次被這道閘誤攔，三次都不是宣告意圖：
① 否認自己有下一步 ②引用閘自己的訊息 ③貼閘自己的正則原始碼舉報 bug。
而訊息教人走的「選項③：說明它在等什麼」，程式碼裡根本沒有那條分支
——唯一走得通的路是不寫那三個字，正是同一則訊息明文禁止的動作。

四個真兇，沒有一個是「例外沒列夠」：
(a) DECL 會匹配裸的「下一步」三個字（每一節都可選 ⇒ 退化成關鍵字）
    ⇒ 收緊：每一條 alternative 都必須接到動作動詞才算命中
(b) 只剝 > 引言與長「」，不認 code fence 與行內 code ⇒ 引用被當成主張
    ⇒ 引用性標記整段換成哨兵（不是刪掉）：內層宣告消失、外層句構留著
      ——刪掉正是 08-17 漏掉「回『規劃』我就派人」的原因，兩個方向一起修
(c) 取 blocks_text[-1]，但那則文字後面可能還有 tool_use ⇒ 宣告其實兌現了
    ⇒ 只看「最後一個動作之後」的文字；收尾在動作上就不觸發
(d) 訊息承諾的出路只有兩條真的存在
    ⇒ 出路③ 給一個機械形式 ⏸ 等：<在等什麼>（白名單標記，要刻意寫，留痕）

方向刻意與「再加幾個關鍵字例外」相反——例外清單會越加越長、越長越誤攔。
守 leo 的封路哲學：紅線寫得越細，命中關鍵字的機率越高 ⇒ 那些閘在懲罰謹慎。

順手：擋下與放行都留痕（InkStoneCo#48：只記擋下的話分母未知）；
log 目錄不在時安靜跳過，不再噴 redirect 錯誤到 stderr。

測試 hooks/tests/factory-idle-guard.test.sh 27 向，誤攔與漏攔兩個方向都測：
舊版 18/27（9 敗）→ 新版 27/27。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-23 17:42:22 +08:00
claude-code 5789f0a917 Merge pull request '信標改數「真的被註冊的閘」——它一直多報一支樣板' (#53) from fix/beacon-counts-registered-gates into main v0.3.6 2026-08-23 08:52:30 +00:00
Leo b1f399f8b9 信標改數「真的被註冊的閘」——它一直多報一支樣板 
leo 的雲端驗收（2026-08-23）抓到：信標說 44 支，`ls hooks/ | wc -l` 是 49，對不上。
追下去是 `ls "$ROOT"/hooks/*.sh | wc -l`：
把 `pre-write-guard.template.sh`（樣板，不是閘）與兩支沒掛註冊的輔助檔一起算進去。

🔴 這個數字是 leo 判斷「這個 session 到底有沒有閘」的唯一介面——**多報就是假綠**。

改成數 `hooks.json` 裡註冊過的唯一 `.sh`；hooks.json 讀不到才退回檔案數（且排除樣板）。

實測兩向：
  正向（真的 plugin 根目錄）      → 42（與 hooks.json 註冊數一致）
  反向（沒有 hooks.json 的假根）  → 2（三個檔裡有一個是 .template.sh，沒算進去）

查過歷史：本檔自 daa1674 建立以來只有那一版，沒有別的分支修過這段。

inkstone/InkStoneCo#57
 2026-08-23 16:52:01 +08:00
claude-code a446ad6d1d Merge pull request '推 main 的戳記改綁「push 真正的目標 repo」，不再綁 hook 自己的 cwd' (#52) from fix/push-guard-cross-repo-stamp into main v0.3.5 2026-08-23 07:31:01 +00:00
Leo 41c56acd32 推 main 的戳記改綁「push 真正的目標 repo」，不再綁 hook 自己的 cwd 
跨 repo 交辦時（總管站在 A repo，要推 B repo 的 main）main-and-prod-push-guard
的戳記機制永遠對不上：HERE 讀的是 hook 自己的 cwd（=session 的真身，不會變），
WANT 是總管替目標 repo（B）寫進戳記的路徑——兩者結構性地不可能相等，不是
判斷錯，是這個情境在舊模型裡根本不存在（inkstone/ISEP#30 comment 3949，
脈絡 inkstone/InkStoneCo#57，2026-08-21 實撞）。

新增 hooks/lib/push_target_dir.py：純 tokenize（不執行任何指令）解析指令裡
`cd <path> && git push` 或 `git -C <path> push` 真正會落地的目錄，對多層 cd
鏈與子殼（`(cd A && ...); git push` 這種子殼 cd 不能外洩出去）都做了範圍化——
這條範圍化是防穿透的關鍵，不是順手：沒有它，`(cd A && true); git push`
會被誤判成推向 A，讓替 A 開的舊戳記錯誤地放行推到殼外真正的目標。解不出來
一律退回舊行為（hook 自己的 cwd），維持 fail-closed 方向不變。

順手修掉補測時自己抓到的另一個洞：`(git push origin HEAD:main)`——單純加一層
括號——舊版目的地判斷完全偵測不到，整段直接放行，跟戳記無關。成因是截斷
refspec 尾巴的 sed 只認 `;`／`&`／`|` 三種字元，沒算到 `)`；補上即可，git 的
refspec 語法本來就不允許出現 `)`，這裡截斷永遠安全。

綁 repo＋單次用完即丟兩條 2026-08-11/12 用血換來的性質完全沒有鬆動：只是把
「現在人在哪個 repo」問得更準，比對邏輯一個字沒動。

實測：
- hooks/tests/main-and-prod-push-guard.test.sh 舊有 8 向：8/8
- scripts/test-main-and-prod-push-guard.sh 舊有 11 向：11/11
- 新增 hooks/tests/main-and-prod-push-guard-cross-repo.test.sh 17 向
  （跨 repo 正向／反向不准鬆／git -C／子殼範圍化／括號洞／單次用完即丟／
  900 秒逾時／空戳記／既有行為零回歸）：17/17

本輪只驗證，未拿去放行任何真實推送；plugin.json 隨慣例 bump 0.3.4 -> 0.3.5
並重跑 vendor-to-shell.py（.shell-payload 為 gitignore 產物，不入版控）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-23 14:18:28 +08:00
claude-code 2eb9b2aaaa Merge pull request '身為總管，我要閘擋的是動作不是字面，我才不會一晚被自己的閘擋六次' (#51) from fix/push-guard-target-not-substring into main v0.3.4 2026-08-20 17:30:46 +00:00
Leo 67dae3b814 推送閘改成判目標，不判整條指令裡有沒有那個字 
一個晚上誤攔六次，全都不是在推預設分支：
  ① checkout -b 建新分支時把預設分支寫在後面，再推那條新分支
  ② gh pr create 指定 base——根本不是 git push
  ③ 推 tag（refs/tags/…）
  ④ 推 feature 分支（帶 -u）
  ⑤ 它擋住了我用來**測試它自己**的那條指令
  ⑥ 它擋住了這一筆的 commit——因為 message 裡引用了那幾個字

leo 2026-08-17 早就講過這個形狀：文字層封路必敗，
「紅線寫得越細，命中關鍵字的機率越高 ⇒ 那些閘在懲罰謹慎」。
舊版掃整條指令字串，正是文字層。

改成解析 push 的目標 refspec：
  旗標跳過／第一個非旗標＝remote／a:b 取 b／refs/tags/* 不算分支
  一個 refspec 都沒給，才退回看當前分支

八向實測（hooks/tests/main-and-prod-push-guard.test.sh，8/8）：
  五種該放行的（今晚誤攔的原形狀，含分支名帶 domain 那種）全過
  三種該擋的全擋

中途自己抓到一個 bug：tag 被跳過後目標清單變空 → 退回猜當前分支
⇒ 當前分支剛好叫預設名時誤擋。改成看到 refspec 就不退回猜測。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-21 01:29:55 +08:00
claude-code 43c328d26f Merge pull request 'feat/milestone-must-have-due' (#50) from feat/milestone-must-have-due into main v0.3.3 2026-08-20 17:26:08 +00:00
claude-code bcb736ed19 Merge pull request 'fix/worksheet-dedup-by-content' (#49) from fix/worksheet-dedup-by-content into main 2026-08-20 17:26:06 +00:00
Leo 6772ca67d3 每個里程碑都要有真的期限，9999 也擋 
leo 2026-08-21：「以後所有的 milestone 限制時間」「你根本沒有時間概念，浪費一整天」

實查七個 open milestone：六個期限是 9999-01-01、一個空白。
9999 比空白更糟——盤點時每一格看起來都有值，
於是沒有人發現這裡從來沒有時間壓力。七個已全部改成真日期。

新增 hooks/milestone-due-guard.sh，四向實測：
  無 due_on → exit 2
  due_on 帶 9999 → exit 2
  真期限 → exit 0
  只是讀 milestone → exit 0

規範補 M4.8（怎麼定期限、過期只對帳不自動關）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-21 01:25:12 +08:00
Leo 1b5551274a 待驗工作單改用宣稱內容去重，驗過的不再冒出來 
stamp 原本雜湊「交件路徑」⇒ 同樣的宣稱每回合生一個新檔名，
而且不知道總管已經驗過了。

實際發作（2026-08-21 一個 session 內）：同兩條 sdd-guard 宣稱連生四張單
1c97d461／fcb285dc／256de849／394b97ae——驗掉一張下一回合又冒一張，
Stop 閘於是變成永遠過不去。閘在懲罰有照做的人。

改成雜湊宣稱內容本身，並在寫檔前檢查 verified/ 底下有沒有同名。

雙向實測：
  兩次不同 transcript、同樣宣稱 → 只生 1 個檔
  移進 verified/ 後再跑         → SKIP:already-verified，沒再冒出來

過程中兩個自己的錯，記下來免得下次重犯：
  ① 先猜了變數名 blocked/ok/nogo，實際是 ok_hits/ng_hits
     ——猜錯的話 _claims 永遠是空的、悄悄退回舊行為，不會報錯
  ② 測試資料先寫成 role:assistant，再寫成 role:user 都不觸發
     ——它要的是 <task-notification> 裡的 <result>
     前兩次「0 個檔」我差點當成去重成功

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-21 01:18:16 +08:00
claude-code 1920d4cb06 Merge pull request '身為 leo，我要雲端 clone 下來就有閘，我才不用先處理憑證' (#48) from fix/b4-real-probe into main v0.3.2 2026-08-20 17:11:52 +00:00
Leo 47ed778cc4 改走「直接複製進薄殼 repo」，並修掉一支會偷跑指令的閘 
leo 2026-08-21：「你應該把 Plugin 直接裝進 Github repo，從本地直接複製就好了」

為什麼這條對：雲端 session 是 fresh clone 薄殼 repo，而 setup script 讀不到
環境變數。走 marketplace 就得同時處理憑證、repo 可見性、環境快取三件事——
今天這三件各失敗過一次。複製進 repo 之後，clone 下來就有，沒有任何前置條件。

新增 scripts/vendor-to-shell.py：
  把 hooks/skills/commands/scripts/.claude-plugin 整份複製到 .claude/isep/，
  並把 54 條 hook 註冊改寫成薄殼裡的絕對路徑。
  保留 CLAUDE_PLUGIN_ROOT 這個變數名（44 支閘內部靠它定位自己的 lib/），
  只是把它指到複製過來的那份。

冒煙測試（54 條註冊全跑一遍，找路徑壞掉的）：
  第一輪 4 條壞 → 3 條是 log 目錄不存在（已補建 .claude/hooks/）
                  1 條在真身也一樣壞 ⇒ 不是複製造成的
  第二輪 0 條壞

順手修掉那支既有 bug：wiki-first-search.sh
  python3 -c 用雙引號，註解裡的反引號被 shell 當指令替換
  ⇒ 這支閘每次觸發都在偷跑 bge-m3 與 head changelog.md。
  改成全形引號後實測靜默 exit 0。
  （crude grep 掃出 6 支疑似，但冒煙測試證明只有這一支真的中——
    再一次：證據勝過掃描。）

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-21 00:51:00 +08:00
Leo 03d9782f22 查了官方文件才發現：setup script 根本讀不到環境變數，而 exit 1 會鎖死 session 
leo 問「寫以前為什麼不查」——沒有藉口，我假設了兩件事都沒查，兩件都是錯的。

① setup script 讀不到 Environment variables
   官方原文：Each session copies the environment's values once, at startup,
   into ordinary environment variables
   而 setup script 是 before Claude Code launches 跑的 ⇒ 注入在它之後。
   ⇒ 把 token 放進 Environment variables 再要 setup script 讀，永遠讀不到。
   證據吻合：leo 的變數設對了、值也跟本機同一把（長度 40、頭尾一致），
   而腳本回報找不到。

② exit 非零會讓整個 session 開不起來
   官方原文：Exit zero: if the script exits non-zero, the session fails to start.
   前一版為了大聲失敗用 exit 1 ⇒ 直接造成 Session initialization failed。
   ⇒ 現在一律 exit 0，失敗寫進 /tmp/.isep-setup-report。

本機三向實測：
  無變數（雲端真實情況）→ exit 0，印出說明，不擋 session
  有變數（未來平台若改行為）→ 設 git 認證並驗證
  ls-remote 加 timeout 45（本機曾掛住近 4 分鐘）

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-21 00:39:48 +08:00
Leo 36d8e05a32 認證驗證加 timeout：掛住比失敗更糟 
2026-08-21 本機隔離測試：git ls-remote 掛住近 4 分鐘不回。
setup 卡在那裡看起來像還在跑，不會有人知道它壞了。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-21 00:34:34 +08:00
Leo 135637291c B4 的探針我自己沒撞過，實撞後發現它根本不會擋 
v0.3.1 我把 B4 從 git tag 換成「寫 __GITEA_TOKEN__ 進 /tmp/x.md」，
說它會被 credential-only-guard 擋下。今天實撞：exit 0，閘完全沒反應。

原因：那支閘刻意豁免 .md／docs/／wiki/（文件本來就要能談論這些字串）。
它只管會被執行的產物：*workflow*／.yaml／.yml／installer／worker.js／wrangler。

改成 /tmp/wf.yaml 後三向實測：
  違規 workflow.yaml 帶佔位符       → exit 2 credential 鐵律攔截
  同檔用 {{credential.gitea_token}} → exit 0（正確放行）
  .md 談論同一個字串                 → exit 0（正確豁免）
薄殼指標端同樣實測：真身在＋違規 → exit 2。

這是同一個病的第四次：修假綠的那一刀，自己又是沒撞過就寫。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-21 00:33:44 +08:00