inkstone/ISEP
2
0
Fork 0
Code Issues 34 Pull Requests 4 Actions Packages Projects Releases 33 Wiki Activity
209 Commits 93 Branches 35 Tags
7cacfdcf1114c5118021997672d8bf077faf3ac8
Commit Graph

5 Commits

Author SHA1 Message Date
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 95c6fee199 worktree 閘：heredoc 的 body 是資料不是指令，並把 inkstone/ISEP#125 的驗收表 A–F 寫成測試 
#125 缺陷 D／E（09-02 兩次實地命中）：用 heredoc 寫一份內含 `cd <目錄> && git checkout X` 示範的
說明文件，整條指令沒有 git 操作卻被擋。沿用 lib/strip_heredoc.py（D20 閘同一支）先剝 body 再解析。
A–F 六條照票上期望值進 hooks/tests/（A–E 0、F 2）。
(76) 把 tokenize 層「換行被當空白吞掉」寫成已知邊界測試（舊閘同樣 exit=0，漏擋不是誤攔，與 (53) 同層，另報）。
A24：69→77。

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0178ef1fGw3XeZtpN7LaZrm4
 2026-09-07 06:35:28 +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 358f67abf3 閘認得出「動的是哪個 repo」，不再拿 cwd 當答案（inkstone/ISEP#109 → comment 5398） 
line-needs-own-worktree.sh 擋 `cd <別的 repo> && git checkout` 時擋對了，但訊息
指的是 payload 的 cwd 那個 repo，不是指令真正動的那個。comment 5398 實測：

    指令：cd .../matrix/arcrun && git checkout fix/library-lifecycle-187
    舊版：目錄：.../InkStoneCo   它現在在：feat/ticket-bell-webhook
                    ↑ 動的是 matrix/arcrun，講的卻是 InkStoneCo

🔴 照著那個訊息做的人，會在 InkStoneCo 開一份用不到的 worktree，真正要隔離的
matrix/arcrun 沒開到——而他以為自己隔離好了。**一道閘給錯下一步比不擋更糟。**
而 `cd X && git checkout` 正是這條線最常出現的寫法（本票的來由那次就是它）。

沒有另寫一支解析器：hooks/lib/push_target_dir.py 2026-08-23 已經替 git push 解過
同一題（inkstone/ISEP#30 comment 3949），多層 cd 鏈與「子殼的 cd 不外洩」都算過了。
本輪只把那支的動詞與「要不要去掉 env 前綴」變成參數（兩個都有預設值，push 那條路
一個 byte 都沒變，42 條既有測試重跑全綠），新增的 lib/checkout_target_dir.py 只放
checkout 專屬的兩件事：哪些形狀不動 HEAD、-C 贏過 cd 的優先序。

新增的一條性質（不是順手，是本票要的）：目錄解不出來就放行。
`cd $VAR`／`cd -`／引號壞掉時回 "?"，閘直接 exit 0。寧可漏擋，也不要指著錯的
repo 叫人去開 worktree——猜一個回去等於原地打轉。

實測：
- hooks/tests/line-needs-own-worktree.test.sh 35 條 → 59 條（新增 D 群 24 條）
  正向：cd 認出 A／-C 認出 B／兩者都在時 -C 贏／相對 cd／相對 -C 接在 cd 之後／
        從 worktree cd 回共用目錄／子殼不外洩
  反向（不該擋）：cd 到非 repo、cd 進自己的 worktree、cd $VAR、cd -、還原檔案
  已知邊界也釘成測試：`);` 中間沒空白時 tokenize 會斷在那裡 ⇒ 漏擋（不是指錯）。
  那層是 push_target_dir 的 tokenizer，動它會連帶改到推 main 那道閘的偵測範圍，
  本票不動，另報。
- 推 main 那三套（共用被改到的 lib）：10/10、19/19、13/13
- 實地打票上那條害過我們的指令：現在印的是 matrix/arcrun，worktree 指令也是它的

plugin.json 0.16.1 → 0.16.2 並重跑 vendor-to-shell.py（版本沒動＝沒人吃得到）。

⚠️ 留痕：hooks/lib/checkout_target_dir.py 是用 Bash heredoc 寫的，因為 sdd-guard
對 ISEP 的 .py 是結構性永遠在響——這個 repo 根本沒有 system-dev/docs/3-specs，
而 hooks/lib/ 已經住了 9 支 .py。範圍就這一支新檔，沒有動那道閘（另報）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-29 21:31:42 +08:00
Leo f69ea11a58 一條線一份自己的工作目錄，同時跑的線有上限（inkstone/ISEP#109 → comment 5391） 
兩支新閘，兩個方向的測試都有：

line-needs-own-worktree.sh（PreToolUse: Bash，35 條測試）— 治本那半
  一條線想在共用的工作目錄裡切分支就擋，叫它開自己的 worktree。
  判準是 git 自己回答的兩個問題（會不會動 HEAD／是不是主工作目錄），
  不靠任何人登記。擋下來時順手 prune 掉指向空氣的登記。
  實測：products/arcrun-rag 清掉 4 筆、ISEP 清掉 13 筆，
  還在的 worktree 與分支一根寒毛都沒動。

parallel-lines-cap-guard.sh（PreToolUse: Agent|Task，33 條測試）— 治標那半
  同時在跑的線超過上限（預設 3）就派不出下一條，訊息列出現在有哪幾條。
  條數是從 harness 自己寫的 subagents/*.meta.json ＋ 主 transcript 的完工通知
  數出來的，不是計數器 —— 沒有任何東西要人去減，所以不會永久卡死。

三個機械前提是實測的，不是推測的：
  · SubagentStop 在實測 session 裡一次都沒觸發（不能拿它當減法）
  · PostToolUse:Agent 在送出後 5 秒就觸發（不是收工）
  · subagent 不是獨立行程（ps 只有一個 claude-code 行程）
  · Agent 的原生 isolation:"worktree" 只做頂層 repo，
    而 products/ matrix/ 是 gitignore 掉的子 repo，worktree 裡根本沒有它們
    ⇒ 原生那條路解不了這張票的問題

盤點數字在自己的樹上重數：62 支 / 85 條（main 上的 60/82 沒算到這兩支）。

🔴 版本沒動 = 沒有人吃得到。這條分支沒有定版，
   plugin.json 仍是 0.16.1（版本一致性檢查要求它等於最新 tag）。
   合併時要跟著一個新版本號，不然這兩支閘到不了任何人手上。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-29 20:52:13 +08:00