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

13 Commits

Author SHA1 Message Date
Claude Code 672439bd95 把 main（v0.15.0，派工紀律三件 #105）併進來，逐支點名複驗過 hooks.json 
## hooks.json：這次 git 自動合成功了，而那正是最危險的情況

`hooks.json` 是 JSON——**合錯了語法照樣合法、閘卻不見了，不會有任何東西喊一聲。**
所以「沒有衝突」不等於「沒掉東西」，一律再做兩件事：

① 逐支點名（指令已寫進 README「裝什麼」那段）→ 82 條，60 支各自幾條全部列出
② 跟**兩個父節點**做集合對照：

    merged 82 ＝ main 79 ＋ 我的 3
    從 main 掉了：0 條
    從我這邊掉了：0 條
    兩邊都沒有卻冒出來的：0 條

`#105` 三支與我的兩支同時在，位置也對：

    roster-guard.sh              PreToolUse  Agent ／ Task
    diagnosis-evidence-guard.sh  PreToolUse  Bash
    investigate-first-stamp.sh   PostToolUse Agent|Task ／ SendMessage
    overdue-nag-guard.sh         SessionStart
    wiki-size-guard.sh           SessionStart ／ PreToolUse Write|Edit|MultiEdit

（總管提醒的 `roster-guard` vs `mainline-focus-guard` 那種「同一陣列位置兩邊各一支」
 這次沒有再發生衝突，但兩支都在，各 2 條。）

## 三處文字衝突：兩邊都留，數字重數

- plugin.json     版本吃 main 的 **0.15.0**（總管已定版，**我沒有動它**）；
                  描述欄補上 main 新增的「7 位有名字的工人」，三個數字重數
- README.md       吃 main 的新表格結構（多了 agents/commands/skills/scripts 四列），
                  數字重數；並把累積成**四列**的 `hooks/` 收成一列
- hooks-inventory 標頭被貼成兩份、「一句話結論」被貼成**三份**（數字還互相打架），
                  各收成一份；版本註記兩邊都留

## 盤點（全部在合併後的樹上實數，不是加減推的）

    ls hooks/*.sh | wc -l                    58 → 60
    grep -c '"command":' hooks/hooks.json    79 → 82
    ls agents/*.md | wc -l                        7
    ls -p scripts | grep -v / | wc -l            48
    未掛進 hooks.json 的 .sh                       3（與本頁原本寫的一致，重數過）

📌 抓到的漂移（每次併都有一個，這次三個）：
   ① hooks-inventory 的標頭 ×2、一句話結論 ×3
   ② README 的 `hooks/` 列 ×4，其中兩列是舊數字
   ③ plugin.json 描述欄寫「49 支腳本」，而用本頁寫死的那道指令實數是 48

## 測試（合併後全部重跑，帶對參數）

hooks/tests 23 支全綠：ask-user-question 14、countdown 20、diagnosis-evidence 26、
dispatch-format 52、factory-idle 33、gate-ok 17、gitea-arm-check 16、
presence-beacon 14、cross-repo 19、main-and-prod-push 10、mainline-focus 24、
mainline-idle 61、milestone-account 22、**overdue-nag 36**、pr-verdict 52、
prod-write 37、reply-identity 11、roster 24、sdd 8、search-is-not-proof 31、
stage-before-prod 16、unpushed-police 10、**wiki-compress 25**

scripts/test-* 13 支全綠。
claude plugin validate . ✔ passed；check-version-consistency ✅ 0.15.0 ＝ v0.15.0。
兩支新 SessionStart hook 併完實跑過，閘判定探針對 v0.15.0 的 prod-write-guard 回 pass。

🔴 跑之前清 `CLAUDE_CODE_CHILD_SESSION`；四支要帶參數
（三支帶 hook 絕對路徑、cross-repo 帶 hook 絕對路徑、gitea-arm-check 帶 repo 根目錄）
——不帶會紅，而那是假紅。
 2026-08-28 01:25:49 +00:00
Claude 44f60ba0b8 merge main（v0.14.0，五批）into 派工紀律三件 
hooks.json 兩處衝突：roster-guard 與 mainline-focus-guard 在同一個陣列位置，
兩支都是真的閘，展開成兩個項目保留（不是二選一）。
盤點在合併後重數：58 支 .sh／79 條註冊／49 支腳本／7 位具名工人。版本 0.15.0。
 2026-08-28 01:20:00 +00:00
Claude Code 79ee9e62d6 把 main（v0.14.0，五批）併進來，解 5 處衝突，盤點數字在合併後的樹上重數 
衝突全部**兩邊都留**，沒有丟掉任何一側：

- hooks.json      main 的 `scripts/mainline refresh` ＋ 我的兩支，同一個
                  SessionStart 陣列裡並存
- plugin.json     版本吃 main 的 0.14.0（**沒有自己決定版本**），描述欄的
                  三個數字在合併後的樹上重數
- README.md       main 那格被貼成兩列（54 支／69 條 與 54 支／71 條，互相矛盾），
                  收成一列並填上實數
- hooks-inventory main 的 `mainline refresh` 那列 ＋ 我的兩列；標頭與
                  「一句話結論」的數字重數
- TESTING.md      兩邊各自新增的格子都留。**我的兩格改號成 A21／A22**——
                  併之前兩邊都叫 A16／A17，撞號（這一頁本來就已經有
                  三組重複的 A14–A18，這次至少沒有再加一組）

盤點（`ls hooks/*.sh | wc -l`、`grep -c '"command":' hooks/hooks.json`、
`ls -p scripts | grep -v / | wc -l`，都在**合併後**的樹上跑）：

    55 → 57 支 .sh
    72 → 75 條註冊
         47 支腳本

📌 順手抓到一個漂移：main 的 plugin.json 描述欄寫「48 支腳本」，
   而用 hooks-inventory 自己寫死的那道指令實數是 44（main）／47（合併後）。
   已記在 hooks-inventory 的版本註記裡——**同一個病，第 N 次，只是換一欄。**

📌 TESTING.md 的「已知斷點」那段補上總管用 MCP 查到的更廣範圍：
   不只 notify_leo 不見了，那台實例的工作流定義是**整批失效**；
   而且修它要寫 leo 的個人帳號 ⇒ `leo21c-write-guard.sh` 明文禁止
   ⇒ **那是真人閘，總管也不能解**。

測試（合併後全部重跑，帶對參數）：
  我的兩套          overdue-nag 36/36、wiki-compress 25/25
  hooks/tests/*     ask-user-question 14、countdown 20、dispatch-format 33、
                    factory-idle 33、gate-ok 17、presence-beacon 14、
                    mainline-focus 24、mainline-idle 61、milestone-account 22、
                    pr-verdict 52、reply-identity 11、sdd 8、
                    search-is-not-proof 31、unpushed-police 10、
                    prod-write 37、stage-before-prod 16、
                    main-and-prod-push 10、cross-repo 19、gitea-arm-check 16
  scripts/test-*    13 支全綠（含 release-manifest 21、milestone-account 23、
                    debt-worklist 47、ticket-handoff-writeback 49）
  claude plugin validate . 通過；check-version-consistency 通過（0.14.0 ＝ v0.14.0）
 2026-08-28 01:15:54 +00:00
Leo 5ac06abc95 工人有名字＋回覆也是派工＋未經調查不寫診斷（inkstone/ISEP#86／#87／#88） 
三張票同一族（誰在派、派給誰、派的內容住哪裡），做在同一條分支：

#86 工人名單：agents/ 七位有名字的工人＋scripts/roster＋hooks/roster-guard.sh
    派工用 Task 的 subagent_type 指名，派工單格式一個字都沒改；
    指對名字就把那位的檔案原文注入（你是誰／先讀什麼／你的紅線）。
    【身份】欄同時吃得下工人名字（原本三個角色照舊）。

#87 未經調查不寫診斷：hooks/diagnosis-evidence-guard.sh ＋ investigate-first-stamp.sh
    三個結構訊號（派過人查沒／有沒有走得過去的出處／有沒有份量），
    一個關鍵字比對都沒有；轉述有出處不會被誤擋。

#88 回覆也是派工：不另造閘，把攔截點加掛上去。
    hooks/lib/dispatch_parse.py 的 tool_channel() 一次列全所有通往 subagent 的路
    （SendMessage／雲端 session・trigger／claude -p）；擋下來時把那段內容原文印出來。
    subagent 往上回報（to: "main"）＝交件不是派工，刻意不管。

順手修掉一個真的會咬人的 flake：dispatch-format-guard 原本開四支 python 各讀一個欄位，
機器忙的時候某個欄位會靜靜變空字串（實測連跑 10 次有 1 次「豁免了卻還是被擋」）。
四個欄位改成一次讀完。

版本號待總管定（plugin.json 只更新了描述裡的數字，版本沒動）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016ZBu4Sa1cGntKFRBYNZ6xs
 2026-08-28 01:15:09 +00:00
Claude Code da9bd53cae 沒人會叫的事會自己叫＋讀不完的必讀檔要被整理（inkstone/ISEP#93、inkstone/ISEP#89） 
兩張票放同一條分支：都是「該發生卻不會自己發生的事」，觸發點都在 session 邊界。

## inkstone/ISEP#93 —— 逾期和掛著沒人接的事會主動叫

- scripts/isep-nag        撈三種沒人會叫的事（逾期 milestone／等 leo 的票／掉在地上的棒子）
- scripts/isep-notify     發 Telegram，而且**發不出去的時候不會安靜**
- hooks/overdue-nag-guard.sh  SessionStart 跑一次（不輪詢、不 fan-out、不掛 Actions）
- hooks/tests/overdue-nag.test.sh  35 條，全程離線

實跑撈得出票上點名的那五個逾期 milestone（08-24 三個、08-26 兩個）。
沒東西可報時會說「查過了，沒有」——安靜跟壞掉長得一模一樣。

🔴 工單補的那個限制（今天實測出來的）已經處理：
「能不能發得出去」取決於這個 session 載到的 ISEP 是哪一版
（prod-write-guard v0.10.0 才認得出 notify_leo 不是部署，而 hook 註冊路徑
在 session 啟動當下就寫死了）。所以 isep-notify 會**先拿真的要送的那一則
去問這個 session 註冊的那支閘**，把判定寫成檔（誰都查得到），然後：
  · 放行 ⇒ 送，並驗內層 data.data.ok（外層 200 不算送到）
  · 會擋 ⇒ **不繞路**，改貼回票上並把原文印在眼前
用 git 歷史裡的真跡（c263866 那一版閘）測過「會擋」那條路。

⛔ 實測發現通道本身現在是斷的：實例上找不到 notify_leo 工作流（404）。
   不是閘、不是網路、不是金鑰。詳情與修法寫在 docs/TESTING.md 最後一段。
   退路兩次都走通了（inkstone/ISEP#93 comment 5182、5184）。

## inkstone/ISEP#89 —— wiki 太長時有人整理

- scripts/wiki-compress   audit／plan／apply／verify／bench 五個動詞
- hooks/wiki-size-guard.sh  SessionStart 點名太長的檔；寫檔時擋「沒走流程的壓縮」
- hooks/tests/wiki-compress.test.sh  25 條，全程離線、不碰真的 wiki

設計上最重要的一條：**只搬不改**，正文一個字都不動。
「合併同類、濃縮成一行」要重寫正文，而重寫的當下沒有人會發現弄丟了什麼。
所以機器只做「搬 ＋ 目錄 ＋ 標 ×N／↻」，合併留給人。

拿現在的 mistakes.md 複本實壓過（不動真的 wiki）：
  7,681 行 → 1,199 行
  260 條一條都沒少（verify 用內文雜湊逐條對帳）
  80 個查詢命中率 80/80，定位成本 2,956 → 131 行，**快 22.5 倍**（bench）
verify 反向測過：真的弄丟一條時它抓得到（抓不到的對帳表比沒有更糟）。

## 盤點數字

在這棵樹上當場數的，不是拿上一版加減推的：
  ls hooks/*.sh | wc -l              → 55（was 53）
  grep -c '"command":' hooks.json    → 71（was 68）
plugin.json／README／hooks-inventory 三處同步改。
**版本號沒動**（0.11.0），待總管定版。
 2026-08-28 01:04:16 +00:00
claude-code b6405b2a5c 跨 repo 版本清單＋結案記帳（inkstone/ISEP#84、#85）（README.md） 2026-08-28 01:04:03 +00:00
claude-code 07cb5e4e55 併進 main（#96 雲端接線／#100 v0.12.0／#99 主線唯一），解 TESTING.md 撞號（inkstone/ISEP#92） 
唯一衝突在 docs/TESTING.md：兩條線各自加了一節、**都叫 A16**。
兩邊內容都留，我這一節改成 A19（main 已用掉 A16/A17/A18），
「目前狀態」表的那一列跟著搬到 A18 後面。

main 側本來就有的 A11／A12／A14／A15 重號**沒有動**——那是它兩條線各自編的，
不是這次造成的，動它會把 diff 炸開。

沒有碰的：.claude-plugin/plugin.json（維持 main 的 v0.12.0，版本由總管統一定）、
hooks/hooks.json、docs/hooks-inventory.md——這三個檔本線一個字都沒改，
自動合併拿到的就是 main 那份。

盤點數字在合併後的樹上重數（不是相加、不是抄別人的）：
  hooks/*.sh 54　hooks.json 註冊 71　commands 7　skills 2　scripts 頂層 38
docs/hooks-inventory.md 寫的 54／71 **是對的**；README 寫的 48／59／23
**三個都錯**，已改成實數，並把「怎麼重數」的指令寫進去——
這種數字會漂是因為沒人知道它怎麼來的。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016ZBu4Sa1cGntKFRBYNZ6xs
 2026-08-28 00:48:49 +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 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 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 1dfc4e373a v0.2.1：43 支閘的白話盤點、測試手冊、補上兩個被抓到的洞 
leo 2026-08-20 問「InkStoneCo#40 加入了嗎？如果是這樣我應該可以白話文看到 hooks 的內容？」
答案是不行——43 支閘沒有任何白話清單。這一版補上。

docs/hooks-inventory.md   43 支逐支一行，按「你會在什麼時候撞到它」分 9 組
                          抽驗 5 支逐行核對源碼；順帶抓到 3 支有檔案沒註冊
docs/TESTING.md           A1-A8 + B1-B5，每格都有「怎麼跑/該看到什麼/什麼算失敗」
scripts/test-*.sh         兩支閘的測試，共 21 條，全過

兩個實撞的洞：
- release-tag-guard 的排除清單是前綴比對，x 整條放行
  （A8 那個新 session 抓到的，總管複驗屬實）。改用 #23 驗證過的判準：
  關鍵字要在指令位置才算執行。補 3 條複合指令測試，8/8。
  ⇒ 這是 InkStoneCo#36「包一層就繞過去」的同一個病，發生在同一天新寫的閘上。
- scripts/ticket 寫死只認名叫 gitea 的 remote，在 ISEP（remote 叫 origin）整個跑不起來
  ⇒「開票前先搜」那道閘在新 repo 等於不存在。改成掃所有指向本站的 remote + 環境變數 fallback。

A8 已通過：新 session 裡 plugin 的閘真的觸發（exit 2、tag 未建立、訊息來自 plugin 路徑）。

文件漂移訂正：plugin.json 與 README 寫 42 支/52 條，實際 43 支/53 條。

兩支新閘補上 #40 §1 要求的三行中文檔頭。
🔴 但仍違反 #40 §3「新規則一律先 warn」——兩支都是 block。理由記在 #40 留言，等 leo 裁。
 2026-08-20 17:08:00 +08:00
Leo e4e3d69acf fix(release): 版本只有 Gitea Releases 答得出來，不再靠 README 自報（inkstone/ISEP#6） 
現況：README.md 宣稱「狀態 0.1.0」，但 repo release_counter=0、一個 tag
都沒打。leo 當場指出這是違規，命中規範自己的 E12（宣稱交付但沒有 tag）；
leo 補充：「release 不是寫在 readme，要放在 release 裡」。

改法（結構性防漂移，不是靠人記得同步）：
- README.md 不再自行宣告版本號，改成指向 Gitea Releases 頁面
- .claude-plugin/plugin.json 的 version 改回哨兵值 0.0.0
  （=誠實承認目前沒有一個經過驗證、掛在 Releases 上的版本；
  真正打 tag 那天才跟 tag 一起同步成那個號碼）
- 新增 scripts/check-version-consistency.sh：隨時可跑的一致性檢查
  （plugin.json version 是否等於最新 tag／README 是否偷偷自報版本）
- 新增 hooks/release-tag-guard.sh：PreToolUse Bash 閘，在真正打 git tag
  的那一刻擋下與 plugin.json 不一致的版本號，註冊進 hooks.json

紅線：本次不打 tag、不建 release——那是總管驗過整個 milestone 之後的動作，
這裡交的是機制與草稿。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-08-20 13:10:00 +08:00
Leo c2638668e3 ISEP 0.1.0：環境設定收成一個 plugin，本機與雲端共用一份 
leo 2026-08-20：「同一個 plugin 你用，薄殼也用，保證兩邊同步」
              「我要你幫雲端做薄殼，永遠都有問題，你要做的就是這組設定
                你自己可以 dogfooding」

搬進來：41 支 hook（51 條註冊）／7 支 command／2 支 skill／23 支腳本。
不搬 .env、wiki、docs——那些是知識不是環境。

51 條 hook 路徑全部從 $CLAUDE_PROJECT_DIR/.claude/hooks/ 改成 ${CLAUDE_PLUGIN_ROOT}/hooks/，
零漏網。那正是薄殼一直壞掉的根：雲端 cwd 不是真身，寫死路徑就斷。

尚未驗證：Claude Code 能不能從私有 Gitea repo 裝 marketplace（要憑證）。
下一步就是在本機實際裝一次，通了才動雲端 bootstrap.sh。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-20 11:41:46 +08:00