inkstone/ISEP
2
0
Fork 0
Code Issues 37 Pull Requests 5 Actions Packages Projects Releases 43 Wiki Activity
248 Commits 107 Branches 46 Tags
daa84b583feb5777cf3b89fcfc034fafc161e7ba
Commit Graph

70 Commits

Author SHA1 Message Date
Leo daa84b583f ISEP#47: source Gitea token from env/.env, not remote URL (9 scripts + credential helper) 
- 6 hooks + gitea-labels-sync/wiki-panorama/gitea-bootstrap 全改用 gitea_token()
- wiki-panorama clone/fetch 改乾淨 URL + credential helper
- gitea-bootstrap 冪等清 remote URL + 設 credential.helper
- 驗證：bootstrap/labels-sync API 認證通過、clone/push 經 helper 無 token 洩漏

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Kxf68FcYGqiuLAPiKKU2U3
 2026-09-18 12:36:30 +00:00
Leo c7890335cc ISEP#47: gitea-token resolver + credential helper (source from env/.env, not remote URL) 2026-09-18 12:27:57 +00:00
Leo 09769a0dd1 雲端環境產物拆成兩個檔：變數檔只有 KEY=VALUE、開機腳本檔逐位元組＝cloud-setup-script.sh（＋README） 
2026-09-18 實撞：兩段同檔、「════」分隔線被一起貼進 Setup script 欄 ⇒ 雲端開機 exit 127，
cloud-worker 每一趟在開機就死（cse_013LPaaD47m4arFzLjGvSZnN）。新增 V3（變數檔每行都是 KEY=VALUE）、
V4（開機腳本檔逐位元組相同）；test-make-cloud-env.sh 15/15。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-18 20:16:19 +08:00
Leo 6047dff71b 雲端環境 v7：收回現行雲端有、v1–v6 漏收的 TELEGRAM_CHAT_ID／TELEGRAM_BOT_TOKEN（MIRA_ALLOWED 點名放行，B8 其餘照擋）與固定值 ISEP_DRAIN=1 
leo 09-18 貼出現行雲端環境才發現。已驗：chat id 與 leo 貼的相同；bot getMe＝總管名片王（雲端工人發訊那支）。test-make-cloud-env.sh 13/13（B8x 反例照樣抓得到）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-18 20:00:24 +08:00
Leo ef11871ba4 雲端環境變數清單有版本了：docs/cloud-env-versions.tsv 記每版 key，產生器印版本與差異、改清單沒升版就拒絕，產物預設放桌面（v6：＋ARCRUN_NS_UNCLE6／GITHUB_MIRROR_TOKEN／GITHUB_ACCOUNT_NAME） 
leo 2026-09-18：「你這裡記錄每版的 credential 的 key，但 value 自動產生，我就貼上去，你要有版本，因為這件事做了很多次，但你都沒記錄版本」
v1–v5 由 git 歷史還原（f855d82、ca9ea99、7aef943、cb310e9、dd86fef）。test-make-cloud-env.sh 13/13（新增 V1 檔頭版本、V2 不一致拒絕）。
（inkstone/ISEP#158、inkstone/InkStoneCo#98 c7739）

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-18 19:44:40 +08:00
Leo 2bbcda2ac3 雲端工人會分診、會組里程碑，組了就照里程碑做（inkstone/ISEP#159） 
leo 09-18：「它看到票時要能夠組成 milestone 提出版本，所以不只是看票，還要組票。」
雲端只會撿（ISEP#130），沒有任何機制分診或組里程碑；open 302 張裡 74 張沒 s/*、257 張沒掛里程碑。

- ticket triage：沒 s/* 的票 → s/backlog／s/triage／s/pending＋票上一則說明（--why 必填），一個動作；
  --dup-of：說明＋close/duplicate＋關＋在留下的那張留一則指回來（留下的那張若是 leo 的就不寫）
- ticket compose：把已分診的票組成 InkStoneCo 里程碑（開工規約 1–7 條）：既有載體＋前置相依、
  s/backlog → s/todo、名字不准是版本號、期限 1–60 天、不開新票；先全部讀過才寫，理由一次列齊
- 不碰：Human／human/*、指派給別人（含 Leo）——判準是標籤與 assignee 登入名
- pick --pool：還沒到期的 InkStoneCo 里程碑的前置排在散票之前；可做的都抓盡時回待分診的票，
  每列帶 next；queue-drain-guard 照 next 印（待分診是 triage，不是 claim）
- 全局票池只有一個讀法 pool_issues()，接口留給 ISEP#154（global_index 寫卡驗完後只換這一個函式）
- InkStoneCo 掛在 open 里程碑的票＝載體（容器）：不進票池、不算待分診

假設（寫在這裡等總管 review）：
- 分診只收「沒有 s/*」的票；s/triage 仍是總管／leo 的判斷，工人只能把拿不準的丟進 s/triage
- 載體撈不到時，工人用 ticket where＋ticket new 補一張 InkStoneCo User Story 當載體（開工規約第 2 條的「真缺口」）
- 期限上限 60 天（9999 與過去日期都擋）

實測：test-ticket-triage 80/80、test-ticket-pick 84/84、queue-drain-guard 28/28；
真 Gitea 代跑一趟：分診 4 張、建 InkStoneCo milestone 68（載體 InkStoneCo#136，前置 ISEP#47、arcrun-rag#199），
pick --pool 第一組即為它的前置；一次違規三格的 compose 真的零寫入擋下。
待總管定版。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-18 18:43:07 +08:00
Leo 06fb2c59c8 雲端工人從 open 票池持續領票，可抓 0 張時講出池子去哪了（inkstone/ISEP#130 c7801） 
根因：pick 只看主線成員與逾期里程碑；org 299 張 open 裡 254 張沒掛里程碑，
舊規則實跑可抓 0 張，09-18 六趟 run 都印「正常結果，不是故障」收工。

- 第三層：主線與逾期都抓盡、且是接票的環境（--pool 或 ISEP_DRAIN=1），
  再看整個 open 票池裡 s/* 恰好是 s/todo 或 s/backlog 的票（不限里程碑）。
  Human／human/*、指派給別人（含 Leo）、hub、PR、s/triage、沒有 s/* 一格不放寬。
- 本機沒設 ISEP_DRAIN 時不讀票池：總管跑過 handback 不會被佇列閘叫去抓票池（避免誤攔）。
- claim 同規則；可抓 0 張時列池子大小與每種不能抓的理由各幾張，不再說成正常。
- 分頁讀到空頁才停（伺服器每頁上限可能小於 50）。

假設（寫在這裡等總管 review）：s/backlog 算「決定要做」可抓；沒有 s/* 的 72 張算未驗傷不抓、只計數。
實測：真 Gitea 改前可抓 0／改後 --pool 可抓 101；test-ticket-pick 80/80。
待總管定版。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-18 13:58:56 +08:00
Leo 5d938f5d3a 票上回碼解的保險寫回專案根，出貨線讀得到（inkstone/ISEP#156） 
gitea-arm-to-github-armed.sh 原本用腳本自己的上一層決定 .github-armed 寫在哪；
plugin 發佈後那是 ~/.claude/plugins/cache/inkstone/isep/<ver>/，
於是保險寫進快取、印「已解」、ship.mjs 與各閘讀不到（arcrun-rag#202 c7598）。

改寫到 gitea_arm_proj_dir（${CLAUDE_PROJECT_DIR:-$(pwd)}），與
main-and-prod-push-guard／github-contact-guard／stage-before-prod-guard 讀的位置、
以及 check 自己讀 token／待核請求的位置一致。擋下時印的 request 路徑改絕對路徑。

測試：hooks/tests/gitea-arm-to-github-armed.test.sh 18/18；修之前 11 條紅。
TESTING.md 補 A42。版本待總管定。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-17 19:58:50 +08:00
Leo d2f706a16c 新 repo 的工人不再靠人記得：課程工人 course-hand＋開場點名「有票卻沒工人」（inkstone/ISEP#118） 
- agents/course-hand.md：管 inkstone/ax-courses、course_gen、llm-wiki-template（c7358 leo「你可以製作一個」）
  假設：llm-wiki-template 也歸課程工人（同為課程素材），總管不同意就把它拆出去
- hooks/lib/roster.py：`負責 repo` 可列多個（、或逗號），新增 which()／uncovered()；find() 與閘本身未動
- scripts/roster which 改走 roster.which
- scripts/isep-nag 第④類：org 裡有開著的票、名單上卻沒人負責的 repo，只進開場長版、不進 Telegram
- 測試：roster-guard 25→31、overdue-nag 36→43；兩種突變（拿掉票數條件／只認第一個 repo）都會紅
- 文件：worker-roster.md 回答「新 repo 的工人誰在什麼時候加」；README／plugin.json 工人 8、scripts 65（樹上實數）

待總管定版（改了 agents／scripts，要升版才裝得上）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-14 13:13:12 +08:00
Leo 436e30b9d1 交棒警察不再對剛出發的背景工人說「收工了」（inkstone/ISEP#153） 
- PostToolUse:Agent 看到 launch ack（isAsync／async_launched／"Async agent launched"）就不查票
- 多掛一條 Stop：主 transcript 出現 <task-notification> completed 時，用 tool-use-id
  對回原本那則 Agent tool_use、取【工單】再查三格；同一條線只點名一次（狀態檔）
- 出路改印絕對路徑：InkStoneCo/scripts/ticket 是舊複本，grep -c handback → 0
- 測試 10 → 24 條；新 14 條拿 main 的舊 hook 跑是 7 條紅
- 盤點：62 支、88 條（+1）、65 支腳本，當場數的

待總管定版（plugin.json version 未動）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-13 17:30:45 +08:00
Leo fbc56b9e59 isep-doctor 判準改成「每一個 Claude Code 自己回報有沒有載入」，不再看設定長相（inkstone/ISEP#150 → c6995） 
同一台 Mac 有 CLI 與 Desktop 內建兩個 Claude Code，讀同一份 ~/.claude 卻不一定同結論：
settings 多了 path 時 Desktop 2.1.266 忽略 inkstone marketplace、CLI 2.1.220 照常載入（c6991）。
第一版看到 path 就對整台判 ❌，在 CLI 上是假陽性。

- 逐一找 CLI（PATH）與 Desktop（最新版本，數字排序），各跑 plugin list --json，依 errors 各判各的
- 設定比對只在某一個真的報錯時當解釋＋修法，永遠不單獨判 ❌
- 查不了 ⇒ ◐、離開碼 2，不講成 ✅ 或 ❌
- test-isep-doctor.sh 離線 11 條（假 claude 可執行檔）；舊版跑這份 pass=1 fail=10
- test-isep-doctor-live.sh 實機 3 條：真的 CLI 2.1.220／Desktop 2.1.266，隔離 HOME 重現有／無 path，不動 ~/.claude
- 盤點表與 plugin.json 描述的腳本數 62→65（這棵樹上實數）

版本號待總管定。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-13 16:23:40 +08:00
Leo 8eb4c58d2d isep-doctor：講出這台的 ISEP plugin 有沒有真的載入（inkstone/ISEP#150） 
根因不是「Desktop 不跑 hook」：Desktop 1.52386.0／CC 2.1.266 內實測專案
PreToolUse hook 照擋。真正斷的是 ~/.claude/settings.json
extraKnownMarketplaces.inkstone.source 多了 path，CC 把它當 git 抓取欄位，
marketplace 被忽略 ⇒ isep@inkstone「Marketplace inkstone not found」，
59 支閘在 CLI 與 Desktop 一起失效，而且沒有任何閘講得出來。

本支從 plugin 外面查（claude plugin list --json ＋ settings 對 known_marketplaces），
點名多出的欄位並印出一行修法。迴歸測試 scripts/test-isep-doctor.sh 5/5。

假設：修 ~/.claude/settings.json 是 leo 的個人設定，由 leo 親手執行，本 commit 不動它。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-13 14:55:26 +08:00
Leo c0eec76b52 主線成員讀不到任何一條 /dependencies 時不准印出完整名單：set 不印 ✅ 並離開碼 3、refresh／adopt 保留舊快取並講出來（inkstone/ISEP#130 → c6973） 
總管 09-13 實撞：Gitea 握手逾時，hub 票 InkStoneCo#132 本身讀得到、它的 /dependencies 讀不到，
`mainline set` 仍印「✅ 成員 6 張」，底下三張前置全漏；`refresh --members` 零輸出、名單沒變。
雲端工人靠這份名單抓票，漏收＝以為抓盡＝收工，等於 v0.30.0 換個入口又停。

- collect_members：清單讀取拿不到就重讀（ISEP_MEMBER_RETRIES 預設 2、退避 2s×n）；
  仍讀不到的票記進 info["unread"]，info["complete"]＝沒有 unread 且沒被上限截斷
- set：不完整時印 ⚠️（🔴 成員不完整）＋點名讀不到的票，主線檔寫 members_complete／members_unread，
  同一條線保留舊快取成員，離開碼 3（主線本身照樣標定）
- refresh --members：完整才蓋快取並印成員張數；不完整保留舊快取並講出來；讀不到里程碑也講
- adopt：不完整時與舊快取取聯集

重現（改之前跑新測試）：F1–F5、F9–F11、F13–F14 共 11 條紅——set 印 ✅、arcrun-rag#104 漏收、
refresh --members 零輸出且把快取蓋成少兩張的名單。
修後：mainline-members-by-dependency 70/71（唯一紅的 ㊽ 在 main 上同樣紅）、repo-mirror 17/17、
gitea-fallback 31/31、focus-guard 24/24、ticket-pick 58/58、debt-worklist 47/47。
真 Gitea 唯讀跑（不寫主線檔）：InkStoneCo#65 成員 9 張、complete=True、hub #132 底下三張都收到。
沒動 InkStoneCo 的 system-dev/mainline.json。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-13 13:57:44 +08:00
Leo ec9f28d9e8 雲端工人做完一張就接下一張：佇列沒抓盡不准收工；自己帳號的票不再當成別人的（inkstone/ISEP#33 → 6924） 
leo 09-13 判定 ISEP 失敗：「不會在一條任務完成後啓動另一個 loop」。實查三個機械根因：

1. 沒有任何 Stop 閘看佇列。Routine 一次觸發＝一個 session，模型一停就結束；
   12 支 Stop 閘量的是 tool call 數／宣告句／乾回合／自寫清單，
   「做完一件、pick 還有票、寫完回報就停」全部放行。
   ⇒ 新增 hooks/queue-drain-guard.sh：跑過 ticket pick|claim|handback（或 ISEP_DRAIN=1）
   的 session，pick 有票就 exit 2 交回票號；抓盡放行；同張 3 次／讀不到 3 次／40 次上限放行並留痕。
   log 寫 TMPDIR，不靠雲端沒有的 CLAUDE_PROJECT_DIR。
2. pickable() 把指派給 claude-code 的 s/todo 當成「別人的」，而雲端工人就是 claude-code。
   09-13 實查主線 Arcrun#176＝s/todo＋指派 claude-code；09-11 run（Arcrun#86 c6917）
   就是以此判定「主線沒票」收工。⇒ 只指派給自己的 s/todo 算可抓；s/doing／Human 照擋。
3. api() 一次 TLS 握手逾時就讓 pick 離開碼 2（09-13 本機實撞，curl 同時 200）。
   ⇒ 只有 GET 對連線層失敗重試（預設 3 次，退避 2s×n）；寫入不重試。

測試：queue-drain-guard 24/24、ticket-pick 58/58（+5）、ticket-repo-arg 7/7、
handoff-writeback 49/49；members-by-dependency 56/57，唯一紅的 ㊽ 在 main 上同樣紅（macOS 暫存路徑形狀）。
數字在這棵樹上實數：62 支閘（ls hooks/*.sh）／87 條註冊（grep -c '"command":'）。
假設：工人與總管共用 claude-code 帳號維持現狀（改帳號是跨專案結構，交總管）。
版本號留 0.29.0，由總管併 main 後定版。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-13 12:37:49 +08:00
isep-hand 19face1c41 adopt 的冪等改靠「先讀 /dependencies」：真 Gitea 對重複相依回 500 不是 409（inkstone/ISEP#133） 
真 Gitea 實跑（hub＝InkStoneCo#44、子票＝ISEP#133）：第一次 POST 成功、/blocks 回 #44、
清空快取後 has 靠 /blocks 判「在」；第二次 POST 回 500——假伺服器原本猜 409，adopt 第二次會炸。
add_dependency() 改成先讀 parent 的 /dependencies，邊在就不 POST（判準是 Gitea 的事實，不是回應碼）；
假伺服器改照真的回 500；A41 56→57 條。測完 DELETE 復原（201，/blocks 空）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0178ef1fGw3XeZtpN7LaZrm4
 2026-09-07 10:46:43 +00:00
isep-hand d4bf172990 主線成員改由相依邊決定，不靠同名里程碑；adopt 別 repo 的票＝加相依到 hub 票；帳本落在 InkStoneCo/system-dev（inkstone/ISEP#133 → 6743） 
leo 2026-09-07：「拆，誰說『同名跨 repo 是 mainline 機制的一部分』，早就定了只有一個
milestone，不同 repo 用指針」。上一版 scripts/mainline 檔頭把現場的樣子（5 個同名）寫成
「既有做法」，成員也照標題跨 repo 收；總管照它做、抄進 ops-facts、還在 arcrun-rag 補建了一個同名的。

改了什麼（判準全部是 Gitea 欄位，沒有標題比對）：
- hooks/lib/mainline.py：collect_members()＝hub 里程碑裡的票＋hub 票，沿 /dependencies 邊
  （跨 repo）收下去；belongs() 要同時拿到「掛哪個 milestone」＋「誰把它當相依」才准說「不屬於」，
  只知一半回 None（閘放行）；project_roots() 給主線檔與帳本共用
- scripts/mainline：set --hub <票>、adopt 別 repo ⇒ POST 相依到 hub 票（--via 可指定成員），
  沒 hub 票時擋下並給兩條走得通的路，不建同名里程碑；has 查 /blocks；
  refresh --members 才重收（真 Gitea 25 張要 19 秒，SessionStart 成本不變）
- scripts/ticket：add_dependency() 一份（subtask 與 adopt 共用，409 冪等）；pick 主線組走成員清單，
  逾期組一個里程碑物件一組；claim 的主線判定改看相依；pickable(None) 給靠邊進來的票
- hooks/mainline-focus-guard.sh：新鮮查詢問 milestone＋/blocks，補收出路明講不要開同名里程碑
- scripts/milestone-account：帳本找家用同一把尺，退回原始碼目錄只在它有 .git（plugin 快取沒有）

測試：新 hooks/tests/mainline-members-by-dependency.test.sh 56 條（假 Gitea 照真的回 201/409）；
scripts/test-ticket-pick.sh 48→53 條（池子改用相依邊，補「同名沒邊 ⇒ 不抓」）；
既有 mainline-focus-guard／repo-mirror／gitea-fallback／idle／milestone-account／debt-worklist／
handoff-writeback 全綠。真 Gitea 唯讀實跑：set --hub inkstone/InkStoneCo#44 收到 25 張、5 個 repo，
mira#6／ISEP#130／ISEP#140／arcrun-rag#104 都在，不必新增任何邊。

版本：待總管定版（改了會被載入的 hook／scripts）。

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0178ef1fGw3XeZtpN7LaZrm4
 2026-09-07 10:40:55 +00:00
isep-hand 7cacfdcf11 一個 repo 只有一個資料夾：分身住 repo 裡面的 .worktrees/，收工由同一支閘收掉（inkstone/ISEP#147） 
leo 2026-09-07：「一個 repo 只看得到一個資料夾」「禁止這樣產出一大堆資料夾」。
根因：line-needs-own-worktree.sh 教工人開在 repo 旁邊，「收工 remove」只寫在閘訊息裡、沒機制驗，
每條線留一份 ⇒ tech_projects/ 長出 ISEP-wt-117／InkStoneCo-wt-112…一排。規則在文字裡不在機器上。

- scripts/worktree（新）：open／close／list／sweep 四個動詞。分身住 <repo>/.worktrees/<票 repo>-<N>
  （走 .git/info/exclude，不動被追蹤的檔）；「推了沒」只有這一份判準（三態：有／沒有／問不到，
  問不到不當成沒推也不收）；sweep 預設只列不動，--apply 只收「推了且乾淨」，--skip 是操作者點名。
- hooks/line-needs-own-worktree.sh：擋下時印 `scripts/worktree open`（絕對路徑，貼了就跑）；
  同一支多掛 PostToolUse Agent|Task——從【工單】認出分身，推了收、沒推點名分支＋路徑（exit 2），
  不 force、不刪。+0 支、+1 條（61 支／86 條，當場數的）。
- docs/governance/worktree-placement.md（新）＋ principles 一行：禁令與閘互指。
- 測試：line-needs-own-worktree.test.sh 77→110（G 群：閘印的 open 那行原樣跑、旁邊不多任何東西；
  H 群：PostToolUse 推了收／沒推點名／安靜的方向）；scripts/test-worktree.sh 42 條（七個分身的 fixture，
  名字照 leo 看到的那排）。舊閘跑新測試 90/110，紅的 20 條正是這次改到的行為。
- permissions-allow.json 加 worktree 四種形狀（出路在雲端被分類器擋就走不通）。
- README／plugin.json／hooks-inventory 的數字在這棵樹上實數：61 支、86 條、62 支腳本。

待總管定版（改了會被載入的東西）。沒碰 hooks/lib/mainline.py。

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0178ef1fGw3XeZtpN7LaZrm4
 2026-09-07 07:13:21 +00:00
isep-hand 49a7145e70 兩支閘改看「指令要動的那個 repo」，不看 hook 自己的環境／cwd（inkstone/ISEP#109 → comment 6629） 
① line-needs-own-worktree.sh：出路 `WORKTREE_OK=1 git -C … checkout …` 改認指令字串裡的字面前綴
   （舊版讀 hook 自己的環境變數，PreToolUse hook 跟指令不是同一個行程，那行永遠走不通）。
   判準是位置不是字：前綴必須掛在會移動 HEAD 的那條 git 指令上。
   lib/checkout_target_dir.py 加 `--escape NAME=1`；push_target_dir._classify 在 strip_env 時
   把前綴留在 verb 事件裡（find_push_target 行為不變，主線閘 10＋19 條照綠）。
② github-contact-guard.sh：remote 名在「這條指令實際會推的那個 repo」裡解（沿用 lib/push_target_dir.py
   解 cd 鏈／-C／子殼），解不出來才退回 cwd。判準仍是 remote URL 主機，不是「有 -C 就放行」。

測試：A24 59→69（E 群把閘印的那一行原樣餵回去；舊閘 3 條紅）、
      A39 14→26（payload 帶 cwd、cwd≠目標 repo；舊閘 7 條紅＝4 誤攔＋3 漏擋）。
盤點表：61 支／85 條，改判準不加閘，當場數的。
版本：待總管定版。

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0178ef1fGw3XeZtpN7LaZrm4
 2026-09-07 06:31:45 +00:00
Leo 48befe8906 雲端第一則 prompt 的主線是現在這條：兩份主線檔都不在時 refresh 去 Gitea 讀 InkStoneCo main 那份一次（inkstone/ISEP#140） 
薄殼 SessionStart 跑在 bootstrap.sh 之前，InkStoneCo/ 還沒 clone、家目錄空 ⇒ 兩份都不在 ⇒
countdown.py 退到「期限最近的 milestone」⇒ 第一則 prompt 印逾期 341 小時的舊線。機制沒壞，是順序。

- hooks/lib/mainline.py：第三個來源 fetch_gitea()（本檔唯一會打網路的函式，只有 SessionStart 的
  `mainline refresh` 叫它；load()/line() 照舊零網路）。優先序寫進檔頭：家目錄 ＞ repo 那份 ＞ Gitea 那份。
  匿名優先，匿名被拒（401/403/404）且拿得到 token 才帶 token 再問一次；讀不到回 None，逾時有上限。
- scripts/mainline refresh：兩份都不在 ⇒ fetch_gitea 一次、只寫家目錄（不 mirror）；token 拿不到不炸、不抱怨。
- hooks/tests/mainline-gitea-fallback.test.sh：31 條，假 Gitea 有 public／private／500／garbage／notitle／hang 六種回法。

假設（票上紅線寫「一律匿名不帶 token」，其前提「Gitea 匿名讀得到」實測為假）：
inkstone/InkStoneCo 在 Gitea 是 private——匿名打 raw／contents／repo API 都 404，ISEP 同端點 200。
⇒ 照字面做這張票在真環境永遠讀不到。改成匿名優先、被拒才帶 token（同一條 SessionStart 鏈上
countdown-milestone-refresh.sh 本來就帶 GITEA_TOKEN_CLAUDE_CODE 打 Gitea；D20 管的是 GitHub）。
真跑：帶 token 2.06s 讀到 inkstone/Arcrun#48；拔 token rc 0、零檔案、「現在沒有主線」。

版本：待總管定版。

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0178ef1fGw3XeZtpN7LaZrm4
 2026-09-07 06:19:39 +00:00
claude-code fef35ed03a 出貨鏈三站上 main：release-ship 前置①改看 tag 的樹、release-check 可指定版本、信標開場報「打了 tag 沒 release」（inkstone/ISEP#67） 
- hooks/lib/release_chain.py：問 Gitea 的判準一份三處用（匿名讀，D20）
- scripts/release-ship：前置①比「要建的那個 tag 的樹」裡的 plugin.json，不比工作樹／最新 tag
  （總管 09-07 在 v0.23.0 被擋的情境現在放行）；note 從 Gitea compare 生，從 plugin 快取跑也行；
  覆核改跑 release-check <那個 tag>
- scripts/release-check [vX.Y.Z]：指定版本；v0.19／0.20／0.21 依裁決標「不補」不再黃字；補法印正本絕對路徑
- hooks/lib/beacon_report.py ④：最新 tag 沒 release／main 定版沒打 tag ⇒ 一行缺站＋補法；都在安靜；
  只快取「都在」6 小時
- 測試：test-release-ship 14、test-release-check 14、信標 26→33；docs：TESTING A37/A38、盤點表、README 60 支腳本、
  白名單加 release-ship／release-check 形狀、mistakes 一條
- 沒改 plugin.json 版本號（待總管定版）

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0178ef1fGw3XeZtpN7LaZrm4
 2026-09-07 05:52:41 +00:00
Claude 1fa45cd539 Merge remote-tracking branch 'origin/feat/release-ship-the-chain' into feat/67-release-chain-on-main 2026-09-07 05:40:59 +00:00
Leo d19bf88503 雲端對 stage 的寫入有正門：scripts/stage（secret／api）只寫 youlin，白名單放固定形狀（inkstone/ISEP#137） 
09-07 三種寫入在雲端全被 auto mode 分類器擋：npx wrangler secret put、
stage-deploy-artifacts.py --confirm、curl POST 到 arcrun-yuga3bse——
白名單是逐條比前綴，複合指令與任意 curl 永遠對不上；放整類又是紅線。

- scripts/stage secret put|list|delete：直接打 CF API（不經 npx）；先 GET /accounts
  看這把 token 打得到誰，stage 的 ID 不在裡面就拒絕並印出它打得到誰；URL 永遠只帶
  1129efd7…；值只從 --from-env 讀，--value 拒收。
- scripts/stage api <METHOD> <worker>/<path>：curl 打實例，主機只會是
  *.arcrun-yuga3bse.workers.dev，別的主機拒絕；標頭與 body 走 stdin 設定檔＋管線，
  不走 argv；--bearer-env／--header-env／--data-env 從環境變數讀。
- docs/permissions-allow.json：stage 四種形狀＋Arcrun 自己那支 stage-deploy-artifacts.py
  的相對形狀（它已寫死只認 youlin 帳號 ID、不收 --account／--token，不重造）。
- scripts/test-stage.sh 45 條（假 CF 對 PUT 回 201——第一次實跑 CF 回 201 被講成失敗，
  就是這格抓的）；test-settings-allow-sync 仍 19/19。
- 真跑：探針種進 youlin arcrun-cypher-executor、CF API 獨立列到、刪掉恢復原狀；
  api GET health 200、無 Bearer POST 401、leo21c 主機拒絕零請求。
  「帶 Bearer 真寫 KBDB」缺 KBDB_INTERNAL_TOKEN 沒跑（TESTING A36 標明）。

盤點在本樹實數：hooks 61、註冊 85（都沒動）、scripts 56（＋stage、＋test-stage.sh）。
版本待總管定版。

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DTZ9QtvjY7MNxjfQbexAm7
 2026-09-07 02:31:18 +00:00
isep-hand 57219f3321 併 origin/main（#134 ticket pick／claim）解衝突：盤點數字在合併後的樹重數——61 支、85 條、54 支腳本（inkstone/ISEP#130） 
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DTZ9QtvjY7MNxjfQbexAm7
 2026-09-07 01:22:33 +00:00
isep-hand 65120a1c65 雲端要拿得到票、主線與通知：白名單住 ISEP、主線檔隨 repo 走、leo21c 讀放寫擋（inkstone/ISEP#130） 
- docs/permissions-allow.json ＋ scripts/settings-allow-sync：四個 Gitea 正門工具的權限白名單一份，
  setup script 裝完 plugin 寫一次、SessionStart 每次再對一次（只加不減、冪等）
- hooks/lib/mainline.py／scripts/mainline：家目錄沒主線就讀 InkStoneCo/system-dev/mainline.json；
  set／adopt／clear 兩份一起寫，refresh 只寫家目錄
- hooks/leo21c-write-guard.sh：唯讀 -d（tr/cut/sort…）先剪掉再判、notify_leo trigger 放行
  （與 prod-write-guard 同一份白名單）、改法段改印 09-02 起的 youlin 子網域；補第一支測試（26 條）
- prod-write-guard／main-and-prod-push-guard／kbdb-live-exam：認得 youlin 新子網域 arcrun-yuga3bse
- scripts/ticket：收件 repo 寫 inkstone/ISEP 不再 404（org 寫錯當場講）
- scripts/isep-notify：有 TELEGRAM_BOT_TOKEN／TELEGRAM_CHAT_ID 先走 Bot API 直送（雲端唯一通的路）
- 測試：A31–A35 共 79 條；README／plugin.json／hooks-inventory 數字實數（61 支、85 條、53 支腳本）

假設（記在這裡等 review）：權限規則的形狀沿用 leo 09-07 親手加、實測有效的那四條；
「分類器真的不擋」要雲端一趟 run 的 permission_denials 才驗得到，本 PR 驗不了。
版本：待總管定版（plugin.json 仍 0.22.0）。

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DTZ9QtvjY7MNxjfQbexAm7
 2026-09-07 01:17:15 +00:00
Claude 354480901a 雲端工人抓票規則做成 ticket pick／claim，規則本體是一支純函式（inkstone/ISEP#131） 
- scripts/ticket 多兩個動詞：pick（給定主線檔回一張可抓的票，主線抓盡才抓逾期里程碑，
  不抓 backlog／沒里程碑）與 claim（指派＋s/doing＋【身份】留言，一個動作；規則在寫入前再驗一次）
- 規則全是 Gitea 欄位：s/* 恰好是 {s/todo}＋沒 assignee＋沒 Human/human/*＋不是 hub＋里程碑＝主線
  · 「恰好」而非「有 s/todo」：09-07 實查 mira#6 同時掛 s/doing＋s/todo
  · hub 排除：09-07 實查 ISEP#31–35 五張 hub 掛在逾期里程碑、s/todo、沒人，但容器不是任務
- 離開碼分三種：0 有票／1 真的沒有／2 讀不到或沒主線（讀不到 ≠ 沒有）
- scripts/test-ticket-pick.sh 48 條全離線；README／plugin.json 腳本數 49→50 在本樹實數
- 版本號待總管定版（scripts/ticket 會被 plugin 載入）

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DTZ9QtvjY7MNxjfQbexAm7
 2026-09-07 01:05:30 +00:00
Claude 49dedbbb15 補上運送鏈缺的兩站：建 release ＋ 回頭覆核（inkstone/ISEP#67） 
工單的斷點是「沒有任何東西會建 release」——v0.22.0 tag 早推了，
Gitea Releases 頁卻停在 v0.18.0，對 leo 等於這一版不存在。

新增兩支獨立的站（不改任何既有閘，只補送貨鏈缺的那兩段）：

- scripts/release-ship（＝ arcrun-rag 的 release-record 站）
  把「已推的 tag」變成「leo 看得到的 release」。三個前置條件「必須在場」才放行：
  ①版本一致（重用 check-version-consistency.sh，不另立判準）②tag 真的在 Gitea
  ③release note 有內容（沒給就從 git log 自動生事實清單）。冪等；建完回頭跑
  release-check 拿收貨端覆核——送的人說成功不算。

- scripts/release-check（＝ release-check 站）
  回頭問每一段「到了嗎」，而且**問的是收貨端**（Gitea tags／releases、這個 session
  載到的 plugin.json），不聽送的人說。現行版本缺 tag 或缺 release ⇒ exit 2 並指名
  缺哪一站＋怎麼補（工單驗收 4）。判準是結構（定版 commit / tag / release 在不在），
  不是關鍵字黑名單。

- 兩支離線測試（RELEASE_*_FIXTURE，不打 Gitea）：release-check 9 項、release-ship 7 項全過。

實跑證據：release-ship v0.22.0 已在 Gitea 建起
https://git.uncle6.me/inkstone/ISEP/releases/tag/v0.22.0
release-check 覆核 v0.22.0 tag＋release 都在（收貨端事實）。

版本：新增的是 scripts/（非自動載入），本身不需升版；待總管定版隨下一版一起送出。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012656SLtw96aCxTgScH5bbK
 2026-09-05 21:01:29 +00:00
Leo dd86fef9a6 定版 v0.21.0（出貨線的實例座標雲端也拿得到） 
inkstone/Arcrun#195 已併入兩個 main（Arcrun 828fe1f／arcrun-rag 93dc247）：
出貨座標拆成「網址隨 repo 走、namespace 走環境變數」。那把 namespace 原本
只住在 ~/.arcrun/config.yaml 的 api_key——家目錄，不隨 clone 走 ⇒ 雲端拿不到。

總管實跑（乾淨環境 env -i、HOME 指空目錄、無任何 .env）：
  resolveInstanceCoordinates({instance:'youlin'})
    base ← instances.json（隨 repo）｜namespace ← 環境變數 ARCRUN_NS_YOULIN
  用那組座標 GET /webhooks/named → HTTP 200，9 支工作流

清單 9 把 → 10 把。實數確認：NEEDED 10 行、test 11/11 通過、B7/B8/B9 全綠。

🔴 這一筆是總管自己做的（平常該派工）：派出去的工人在 API 層 SSL 錯誤掛掉，
且已超過收工線，改動是清單加一行 ＋ 兩處把數同步，總管有完整驗證能力。
已依規約 touch /tmp/.solo-ok-<session_id> 留痕。

票：inkstone/ISEP#115（→ comment 5610）

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-01 16:43:00 +08:00
Leo cb310e9c72 出貨那三站的帳號也進清單：uncle6（inkstone/ISEP#115 → comment 5577） 
出貨的 installer／docsSite／mailRelay 三站，stage 與 prod 全部部署到 uncle6
（ship.targets.json 六處 accountId 去重後只有 58309bb90fd93ad6d0fe0aae99170e9d），
而本機是靠家目錄的 ~/.wrangler OAuth 登入態出貨——那個檔不隨 repo clone 走，
所以雲端會在部署當下才斷。UNCLE6_CF_API_KEY 這條路本來就存在且 active，只是沒進清單。

- NEEDED 加 UNCLE6_CF_API_KEY（住在 products/arcrun-rag/.env）。清單 8 → 9 把。
- 清單開頭那段「範圍」跟著改，否則說明與清單本身打架；
  並把「這把有沒有 Workers Scripts:Edit 沒驗」這個未知寫在旁邊，
  下一個讀清單的人不必重新發現它。
- docs/TESTING.md A26：把「清單現在是 8 把」改成 9 把，狀態表補 5577。

只加這一把。stage bundle repo 寫入權與 ARCRUN_SHIP_BASE／ARCRUN_SHIP_NS 沒碰
（comment 5577 明寫那是 leo 的裁決，不在範圍）。
值全程沒有進版控、沒有進對話（只印名字與長度）。版本號待總管定。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-01 12:35:40 +08:00
Leo 7aef9436c9 兩台全給（youlin＋geek6688），清單守則從名字改成事實（inkstone/ISEP#115 → comment 5541／5542） 
leo 2026-09-01：「youlin 和 geek6688 都全給，因為這兩個都是讓 CC 操作
一個 stage 一個 test prod，不給所有的就是受阻。」覆蓋 comment 5526 的 youlin-only。

- NEEDED 從 2 把變 8 把：youlin 五把（CF token／account id／MCP owner secret／
  stage 帳密兩把）＋ geek6688 兩把（出貨 token／account id）＋ 機器帳號 Gitea token。
  CLOUDFLARE_ACCOUNT_ID_YOULIN 是 comment 5542 才補進 .env 的，已實查在場。
  CLOUDFLARE_API_TOKEN_leo21c 沒加（leo 只點名那兩台）。
- 新增 B9：leo21c 那把住在頂層 .env，不在 polaris/mira/.env ⇒ B8 抓不到它。
  B9 比的是**值相等**不是名字——把它改名叫 CF_TOKEN_BACKUP 照樣紅，
  而黑名單會放它過去。兩條「該紅」方向都在拋棄式副本上實跑證過。
- 密碼類兩把進清單是給人拿的；credentials-map.md「密碼類憑證的用法限制」照舊：
  AI 不得把密碼打進登入欄位。這條寫在清單旁邊，下一個要加變數的人一定會看到。

順手修掉一個不是我造成的假綠：
- hooks/tests/sdd-guard-retired.test.sh 用了 mapfile，macOS 內建 bash 3.2 沒有這個內建，
  在乾淨的 origin/main 上就是離開碼 1（實驗證過），而 TESTING.md 標著「通過 8」。
  改成 while-read（同 scripts/gitea-labels-sync.sh:56 的前例）後：通過 8 ／ 失敗 0。

接基底與衝突：
- rebase 到 013a987，main 那 8 筆一筆沒掉。
- TESTING.md 兩邊都新增了 A25 ⇒ main 的 A25（sdd-guard 退役）保留原編號，
  本節改為 A26；狀態表那列跟著改。
- plugin.json 取 main 那邊（version 0.18.0 未動），六個數字在併完的樹上實數：
  61／84／7／7／2／49。
- mistakes.md 兩邊各自 append，兩條都留。

值全程沒有進版控、沒有進對話（只印名字與長度）。版本號待總管定。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-01 12:04:49 +08:00
Leo ca9ea9993b 雲端拿得到 youlin 那把 CF token，而且清單會自己跟機器對帳（inkstone/ISEP#115 → comment 5526） 
scripts/make-cloud-env.sh 的 NEEDED 只有 1 個變數，裡面從來沒有任何 CF 憑證
——雲端 `env | grep -ciE 'cloudflare|^CF_|wrangler'` 回 0 是這麼來的，不是漏設。

- NEEDED 加 CLOUDFLARE_API_TOKEN_YOULIN_CC_USE（youlin ＝ AI 的 stage）。
  leo21c 正式環境那 7 把（B 段）一把都沒動，理由寫在清單旁邊。
- 新增 scripts/test-make-cloud-env.sh（docs/TESTING.md A25，10 條）：
  A 段用假 .env 隔離跑（證明缺值會被標紅、什麼都不寫進 repo）；
  B 段拿真 .env 對帳，判準是「值出自哪個檔案」而不是名字裡有沒有某個字，
  並用一個已知住在 polaris/mira/.env 的變數自驗偵測真的會亮。
- TESTING.md B1 原本點名「加一個 GITEA_TOKEN_CLAUDE_CODE」已經過時，
  改成「① 區塊每一行都貼」。
- README／plugin.json 的 scripts 數字在自己的樹上實數：48 → 49。

值全程沒有進版控、沒有進對話（只印名字與長度）。
版本號待總管定。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-01 11:58:37 +08:00
Leo 58c3689e4b 閘教的那條出路要真的走得通（inkstone/ISEP#112） 
comment-carries-task-guard 擋下留言時教人跑 `scripts/ticket subtask …`，
而那一行跑不動。兩個獨立的原因，各自都足以害死它：

① 相對路徑對「貼上去那個人的 cwd」解析。總管的 cwd 是 InkStoneCo/，
   那裡的 scripts/ticket 是停在 08-27 之前的舊複本（grep -c subtask → 0），
   照著貼只印出它「四個動詞」的說明然後 exit 0。
② 用法是手抄的第二份，而它已經漂了：寫了 --assign 卻沒有 --next，
   正本會因為「指派了人卻沒寫 --next」直接擋下（exit 2，在打 API 之前）。

修法是拿掉可以漂的那一格，不是把兩份對齊一次：
- 路徑     scripts/ticket 的 self_path()（__file__ 的絕對路徑）
           ⇒ 印指令的人與跑指令的人是同一個檔案
- 用法     USAGE / usage_text() 一份，閘去 `ticket usage subtask --example` 現要
- 內文模板 body_template() 由 REQUIRED_SECTIONS 現生，跟檢查同源

新增動詞 `ticket usage <verb> [--example] [--parent] [--draft]`。
閘的訊息改成整塊可貼可跑：腳本絕對路徑、母票已填、內文草稿附在同一塊裡，
只剩標題／目標／驗收條件三格是機器不可能知道的。
正本叫不動時 fail-open 的只有「訊息內容」（只指路，不補一份手抄用法），
擋不擋不受影響。

測試 scripts/test-comment-carries-task-guard.sh 22 → 29 條。
新增的 ⑮–㉑ 驗的是「出路走不走得通」，不是「有沒有擋」——
⑱ 把閘 stderr 裡那塊指令原樣抽出來、只填三格、真的執行一次，
離開碼必須是 1（走到網路才停）；是 2 就代表這個病復發。
六個變異全部驗過會紅（相對路徑／閘自己抄用法／--assign 沒配 --next／
模板寫死少一段／fallback 補回手抄用法）。

版本：待總管定版（plugin update 比的是版本號不是內容）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SP7DiGMfSkWjZ15CHMbPFE
 2026-08-31 11:01:45 +00:00
claude-code 5342917f2b roster-guard 認不出真實的 subagent_type，整個環境派不出工 
Claude Code 給 plugin agent 的 subagent_type 帶前綴（isep:isep-hand），
而 agents/*.md 的 frontmatter name 沒有（isep-hand）。roster.find() 用完全相等比對
⇒ 真實派工一律被擋，而名單上的裸名字工具又不收 ⇒ 兩種寫法都派不出去。

測試沒抓到是因為 24 條全部餵手寫 payload，沒有一條用真實的 subagent_type 形狀。
補第 19 條專測這個：舊 roster.py + 新測試 → 紅；修好 → 25/25。

順手補 gate-ok 漏掉的 roster——v0.15.0 新增那支閘時沒同步逃生口清單，
所以撞上死鎖時連留痕的出口都沒有。
 2026-08-28 12:36:13 +00:00
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 156d339308 退路留言要帶「為什麼發不出去」，不是只帶閘的判定（inkstone/ISEP#93） 
2026-08-28 第一版漏了這一格，而它剛好就在實測時咬到：
閘判定 pass、Telegram 卻 404（實例上找不到 notify_leo 工作流），
退路留言貼上票之後**只看得到 pass**——真正的斷點一個字都沒進票。
⇒ 下一個人會去修閘，而斷點根本不在那裡。

把留言內文抽成 fallback_body()（獨立成一支就是為了測得到），
測試從「看原始碼有沒有那個字串」改成**真的產一份留言出來檢查**：
斷點原因、原文、身份欄三格都要在。36 條全綠。
 2026-08-28 01:06:52 +00:00
claude-code eb6c427421 跨 repo 版本清單＋結案記帳（inkstone/ISEP#84、#85）（scripts/test-release-manifest.sh） 2026-08-28 01:04:22 +00:00
claude-code c6eb269551 跨 repo 版本清單＋結案記帳（inkstone/ISEP#84、#85）（scripts/test-milestone-account.sh） 2026-08-28 01:04:20 +00:00
claude-code bc02c2645b 跨 repo 版本清單＋結案記帳（inkstone/ISEP#84、#85）（scripts/release-manifest） 2026-08-28 01:04:18 +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 ca10e1db30 跨 repo 版本清單＋結案記帳（inkstone/ISEP#84、#85）（scripts/milestone-account） 2026-08-28 01:04:16 +00:00
claude-code d301810fb6 merge main（#98 下游做完時頂層跟著關），我的那節再讓一次編號 
衝突只有 docs/TESTING.md 一列：#92 也用了 A19 ⇒ 我改成 A20，並把整節搬到 A19 後面。
（今天 main 上 A16、A17 各被佔兩次、A19 被佔兩次——編號撞是這條線的常態，
  讓號的成本比要求別人改小，所以一律我讓。）

plugin.json 的腳本數在合併後的樹上重數 40 → 43：
  main v0.13.0 那個「40」＝ `ls scripts | wc -l`（37 檔＋3 目錄），
  合併後同一算法 ＝ 43：+2 是本 PR，+1 是 #98 帶進來的 test-ticket-handoff-writeback.sh
  （#98 併進 main 時沒有回頭改這個數字）。版本號沒動（0.13.0）。
 2026-08-28 00:58:49 +00:00
claude-code 45adc10a52 併進 main（v0.12.0）並接上「主線唯一答案」（inkstone/ISEP#83） 
衝突只有 docs/TESTING.md 一處，兩邊都留：
  main 的 A16（gate-ok）／A17（未推警察）／A18（信標）原樣保留，
  我那節改編號成 A19——main 上 A16、A17 已經被 #90 與 #99 各佔一次，不動別人的。

接上 inkstone/ISEP#82 帶進來的 hooks/lib/mainline.py（不自己養第二套判斷）：
  · 有標主線 ⇒ 只排除「屬於主線那一條」的票；掛在**別條** milestone 的仍算債
    （那條線現在沒有人在推，正是它躺著的原因）
  · 沒標主線 ⇒ 退回保守做法：掛 open milestone 的一律不領，並在清單上照實說沒標
  · 別條 milestone 已逾期 ⇒ +15「答應過人家的日期已經過了」

測試 40 → 47 條（+7 條全給主線這段），並把 ISEP_COUNTDOWN_STATE_DIR 也隔離：
不然這支測試的結果會取決於「這台機器現在標了哪條主線」。

盤點數字在合併後的樹上重數：
  hooks/*.sh ＝ 54、hooks.json "command": ＝ 71（本 PR 沒新增 hook，兩個都沒變）
  scripts 一層檔案 ＝ 39（本 PR +2）⇒ plugin.json description 37→39
  版本號沒動（0.12.0，總管統一定版）
 2026-08-28 00:51:06 +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
claude-code 7871921741 把主線接進派工與注入（inkstone/ISEP#82） 
- 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    描述數字對齊；版本不動，待總管定版
 2026-08-28 00:40:05 +00:00
Claude Code 21971ea83e 現在的主線是哪一個，變成一個查得到的事實（inkstone/ISEP#82） 
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 條仍全綠
 2026-08-28 00:39:50 +00:00
claude-code 67f5f0fa5e 舊票每天有固定管道被撈出來（inkstone/ISEP#83） 
leo 2026-08-27：「現在每天都在追新的，所以要用 Routine 去消化舊的，可以有多個條件」

兩條線各用各的判準（他當場訂正的那件事）：
  緊急線＝掛 open milestone 的，用「距離目標的遠近」排
  還債線＝沒掛的那 188 張，用多條件排（事故／擋人／承諾／票齡／估工）← 本次做的

新增 scripts/debt-worklist（list／claim／forget）：
  · 撈全 org 15 個 repo 的 open issue + open PR，逐一列出當作「我查了哪些」的證明
  · 扣掉掛 open milestone 的（緊急線在管）、等 leo 的（Human／human-exec／s/stage，
    那些要催不是要領，催辦是 inkstone/ISEP#93）、已領走的
  · 每張票旁邊印出「為什麼排這裡」的分項，排錯可以指著某一項說它給太多
  · 成包只認強訊號：互相指著、或 Gitea 原生相依（母子票）。
    第一版用單向引用成包，190 張裡 121 張黏成一坨——一包沒有人領得動
  · 空清單會明講「查詢跑過了，結果是零」，不默默結束
  · claim 之後那些票不再出現在清單上，並在隔天的清單頂端交代它們關了沒

hooks/session-start-recall.sh 加一段（不打網路，只看狀態檔日期）：
  今天還沒撈過就說一句，並給出要跑的那一行。開 session 自動去撈＝輪詢，紅線擋著。

測試 scripts/test-debt-worklist.sh：40 條全離線，票上四條驗收條件各一組。
真實資料唯讀實跑過：229 張 → 可領 188 張／185 包，領走兩張後隔天清單少掉它們。
 2026-08-28 00:38:02 +00:00
claude-code f3a41fba0e 下游做完時頂層跟著關（inkstone/ISEP#92） 
票上的病：「開在頂層的票，下游做完了卻沒人回來關⋯⋯頂層票會永遠掛著，
而 leo 是看頂層的。」缺的三格是 journey 標籤、雙向連結的強制、完工回寫。

不重造既有的（票上明列）：`ticket where` 戳記＋側門閘（查票防重複）、
`comment-carries-task-guard`（留言藏任務）、Gitea 原生 issue dependency
（跨 repo 關聯的載體）——這一版全部長在它們上面。

四格，判準全部是機械事實（相依邊在不在、state 是什麼），沒有一格在猜文字：

① 雙向連結（驗收 1）：`subtask`／新別名 `handoff` 一個動作同時掛原生相依
   ＋ 在頂層票的時間軸貼一則指回下游的留言。相依邊只長在側欄，
   時間軸上什麼都沒有，跨 repo 時尤其看不出來。

② 完工回寫（驗收 2，最痛的那格）：`ticket close` 關完子票立刻問 `/blocks`
   （誰在等我），對每張還開著的頂層票貼回寫留言；下游全關的那一張再
   指派回總管＋改 s/review。**不自動關母票**——關票要有交付物、要有人看過，
   默默關掉跟默默留著是同一個病的兩面。

③ journey 標籤：`--journey <名>` 把 `j/<名>` 同時貼在母子兩端（只貼一端就
   聚不起來）。標籤不存在就擋下並指回 labels.yaml——要求標籤在場，
   不是猜哪些名字合法。labels.yaml 的 `j/` 段刻意留空：旅程怎麼切、叫什麼
   名字是方向題，不由工具代決。

④ 撈得出來（驗收 3、4）：新動詞 `ticket loose` 掃 org 的 open 票，撈
   「有下游相依、下游全關、自己還開著」的頂層票。這是 ② 的補網——
   關票的側門（直接 PATCH state=closed）是刻意放行的，漏掉的由這張網撈回來。
   不是輪詢，掛在開場／收工對帳跑一次。

實跑（2026-08-28，唯讀，沒動任何票）：245 張 open 票裡 17 張有下游相依，
其中 2 張是「下游都關了、自己還開著」——inkstone/arcrun-rag#136（已 s/review
且指派給 claude-code，正在被處理）與 inkstone/Arcrun#100（沒標籤、沒指派，
就是票上講的那種「永遠掛著」）。

測試：scripts/test-ticket-handoff-writeback.sh，49 條全綠，全程離線
（會打 API 的兩段把 api() 換成錄音機，不開票不關票不留測試票）。
回歸：A13 17/17、A4 24/24、A12 11/11 皆綠。
文件：docs/TESTING.md 新增 A16。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016ZBu4Sa1cGntKFRBYNZ6xs
 2026-08-28 00:31:35 +00:00
claude-code 45b7b81075 Merge remote-tracking branch 'gitea/main' into fix/cloud-wiring-isep90 2026-08-28 00:29:10 +00:00