一個 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
This commit is contained in:
isep-hand
2026-09-07 07:13:21 +00:00
parent 13b97027d1
commit 7cacfdcf11
13 changed files with 1039 additions and 27 deletions
+37 -2
View File
@@ -624,11 +624,22 @@ bash hooks/tests/parallel-lines-cap-guard.test.sh
`PostToolUse:Agent` 在**送出後 5 秒**就觸發(不是收工);
subagent **不是獨立行程**`ps` 只有一個 claude-code 行程,所以數行程數不到線)。
### A24 — 一條線要有自己的工作目錄:77
### A24 — 一條線要有自己的工作目錄:110
```
bash hooks/tests/line-needs-own-worktree.test.sh
```
**該看到**`77/77 通過`。離線,每個案例自己開**兩顆**真的 git repo +一份真的 linked worktree。
**該看到**`110/110 通過`。離線,每個案例自己開**兩顆**真的 git repo +一份真的 linked worktree +一顆本機 bare 遠端
**GH 群在守什麼**inkstone/ISEP#1472026-09-07 補):**分身住 repo 裡面,收工要被收。**
leo 在 Finder 看到 `ISEP-wt-122ship``ISEP-wt-117``ISEP-wt115``InkStoneCo-wt-112`…一排——舊版教「開在 repo 旁邊、
收工 `worktree remove`」,而 remove 只寫在閘訊息裡,沒機制驗。
G 群的測資是**閘自己印出來的 `scripts/worktree open` 那一行**(78) 擋一次、(79) 抽出、(80b) 只填票號與分支真的跑),
然後看三件事實:分身在 `<repo>/.worktrees/` 底下、**repo 旁邊的目錄清單一個都沒多**((81))、共用目錄 `git status` 乾淨((82))。
H 群餵的是 PostToolUse `Agent` 的 payload(派工單 `【工單】owner/repo#N`,總管 session):沒推 ⇒ exit 2 點名分支+路徑+推的指令、分身一根寒毛沒動((86)–(91));
推了但有未追蹤檔 ⇒ exit 2((92)–(94));推了且乾淨 ⇒ exit 0、目錄與登記都沒了、**分支還在**((95)–(98));
沒工單/沒分身/工具不是 Agent ⇒ 安靜((99)–(103),誤攔比漏擋嚴重);一單兩票各自處理((104)–(106));
環境裡的 `WORKTREE_OK=1` 是切分支的逃生門,不影響收工((107))。
修之前拿新測試跑舊閘(main 那份):**90/110,20 條紅**——㉖㉙㉚b㉚c(訊息還在教開在旁邊)+ G/H 全部;B/D/E/F 全綠。紅的正好是這次改到的行為。
**E 群在守什麼**comment 65872026-09-07 補):**閘印出來的那條出路要真的走得通。**
閘訊息教的是 `WORKTREE_OK=1 git -C … checkout …`,舊版讀的卻是 hook 自己的環境變數——PreToolUse hook
@@ -981,6 +992,28 @@ repo 那份走 TMP 底下的假薄殼。
⚠️ **「新開一個雲端 session、不跑任何指令、第一眼就是它」**這格要下一版裝進雲端才驗得到——
前提是 Cloud environment 有 `GITEA_TOKEN_CLAUDE_CODE`(本 session 有),沒有就跟 0.25.0 一樣退到舊線。
### A40 — 一個 repo 只有一個資料夾:`scripts/worktree`sweep 現場整理):42 條
```
bash scripts/test-worktree.sh
```
**該看到**`通過 42 條,失敗 0 條`。全程離線:遠端是本機 bare repo,不碰任何真的 repo。
**它守什麼**inkstone/ISEP#147):leo 在 Mac 上跑一次的整理工具。fixture 照他 09-07 在 Finder 看到的那排分身
**原樣造出來**`course_gen-ticket-3-notes``course_gen-ticket-4-handouts``ax-courses-ticket1``ISEP-wt-122ship`
`ISEP-wt-117``ISEP-wt115``InkStoneCo-wt-112`,各自處境不同:推了乾淨、沒推、髒、登記指向空氣),
外加一份新家 `.worktrees/` 裡的與一個沒人登記的孤兒目錄。
- **A dry-run**(1)(13)):每份落在對的組、沒推的印分支與推的指令、`--skip course_gen` 那兩份在「不碰」組、**目錄樹快照前後相同**。
- **B --apply**(14)(27)):只收「推了且乾淨」的 3 份+prune 空氣登記;沒推的、髒的、`--skip` 的、孤兒的一根寒毛沒動;收掉的分身**分支還在**;第二次冪等。
- **C 判準是事實不是名字**((28)–(32)):不 `--skip``course_gen-*` 照 git 的事實分組;拿掉 remote ⇒ 落在「問不到遠端」、**不當成沒推、也不收**。
- **D opencloselist**(33)(42)):open 的路徑在 `<repo>/.worktrees/`、主 repo `git status` 乾淨、`tech_projects/` 沒多任何資料夾;close 沒推 ⇒ 2 點名,推了 ⇒ 0 目錄沒了,再 close ⇒ 0 不吵。
**失敗**
- (2)(30) 紅 ⇒ **dry-run 動了東西**——leo 跑第一次「只是看看」就已經被改了現場,那是災難。
- (19)–(23) 任一紅 ⇒ 收錯東西:刪了沒推的 commit/動了 `--skip` 的 repo/碰了不明目錄。**不刪任何有未推 commit 的分身**是票上紅線。
- (28)(29) 紅 ⇒ 判準滑回看名字(`course_gen` 被當關鍵字),違反本 repo 紅線。
- (31)(32) 紅 ⇒ 把「離線」當成「沒推」——拿雜訊懲罰謹慎。
### A5 — 開票前的搜尋是跨 repo 的
```
python3 scripts/ticket where 標籤 模組化
@@ -1253,6 +1286,8 @@ B2(信標那行)/B3(setup 輸出)/B4(閘的訊息)三個畫面
| **A24 一條線要有自己的工作目錄** | isep-guard | ✅ 35/352026-08-29inkstone/ISEP#109→5391 |
| **A24 出路那一行原樣餵回去走得通+#125 A–F** | isep-hand | ✅ 77/772026-09-07inkstone/ISEP#109→6587、#125)+真路徑實跑(薄殼 cwd、`-C ISEP`:擋→印的那行→放行)+舊閘實跑 3 條紅 |
| **A39 D20 閘看 push 實際會推的 repo** | isep-hand | ✅ 26/262026-09-07inkstone/ISEP#109→6629)+真路徑實跑(薄殼 cwd:`-C InkStoneCo` 放行、裸 `git push origin` 擋)+舊閘實跑 7 條紅(4 誤攔+3 漏擋) |
| **A24 分身住 repo 裡面+收工被收(G/H 群)** | isep-hand | ✅ 110/1102026-09-07inkstone/ISEP#147)+舊閘實跑 20 條紅(訊息+G/H,B/D/E/F 全綠)+本線自己就是 dogfood(分身開在 `ISEP/.worktrees/ISEP-147`,主目錄 `git status` 乾淨) |
| **A40 sweep 現場整理(七個分身的 fixture)** | isep-hand | ✅ 42/422026-09-07inkstone/ISEP#147);**leo 的 Mac 現場**要他自己跑 `sweep ~/tech_projects`(先 dry-run)——這台機器碰不到 |
| **A26 雲端憑證清單這台拿得到** | isep-hand | ✅ 11/112026-09-01inkstone/ISEP#115→5526554155425577)+兩條「該紅」方向實跑 |
| **A16 放行的門真的打得開** | 總管 | ✅ 17/172026-08-28inkstone/ISEP#90 |
| **A17 未推警察不誤攔雲端分支** | 總管 | ✅ 10/102026-08-28inkstone/ISEP#90 |