fix(harness): main checkout 안 worktree를 통째로 지우는 rm을 막는다 #11

Merged
donghyeon.kang merged 1 commits from fix/h12-nested-worktree-rm into main 2026-11-12 22:10:13 +00:00
Owner

무엇을, 왜

H12는 cwd의 main checkout도 rm -r 허용 폴더에 넣는다. 그래서 main checkout 안 worktree(.claude/worktrees/…)에서 아래 세 명령이 통과했다(docs/retro/2026-11-08.md C6).

  • rm -rf ./*: worktree 자신을 지운다.
  • rm -rf ../w2: 옆 worktree를 통째로 지운다.
  • rm -rf ../w2/src: 옆 worktree 안을 지운다.

앱은 worktree 세션의 CLAUDE_PROJECT_DIR를 main checkout으로 준다. 그래서 실제 세션이 바로 이 경우다. 이 PR은 이런 삭제를 막고, 그동안 이 빈틈을 표시하던 expectedFailure를 뗀다.

고른 방법과 버린 대안

  • 허용 폴더는 그대로 두고, 「지킬 checkout」을 따로 센다.
    • 지킬 checkout은 작업 폴더와, 그 repo에 git worktree list로 등록된 모든 worktree다.
    • /tmp와 앱 임시 작업 폴더 밖에서만 아래 두 규칙을 건다.
  • 규칙 1: checkout 자신이나 그것을 품은 폴더를 통째로 지우면 막는다.
    • worktree에서: ./*, ../w2, ..
    • main checkout에서: .claude/worktrees
  • 규칙 2: 옆 worktree 안을 지우면 막는다.
    • 옆 worktree는 이 세션 작업 폴더와 같지도 않고, 그것을 품지도 않고, 그 안에 있지도 않은 checkout이다.
    • 「이 세션 작업 폴더」는 cwd의 checkout으로 먼저 잡는다. 처음에는 프로젝트 폴더도 같이 봤다. 그러면 main checkout이 내 것이 되어 실제 세션에서 ../옆-worktree/x가 통과했다. 그래서 cwd를 먼저 보도록 고쳤다.
  • 전처럼 통과하는 것:
    • 작업 폴더 안 정리(rm -rf build 등)
    • worktree에서 main checkout 안의 worktree 밖 자리를 지우는 일(../../build)
    • main checkout 세션이 worktree 안을 치우는 일(.claude/worktrees/w/build)
    • /tmp 아래 worktree 지우기
  • 버린 대안:
    • worktree 세션에서 main checkout을 허용 폴더에서 빼기: 설계 문구에는 맞다. 하지만 지금 통과하는 일을 더 많이 막는데, 그래야 할 근거가 없다.
    • .claude/worktrees 폴더 이름으로 판정하기: 다른 곳에 둔 worktree를 놓친다.
  • 훅 동작이 바뀌므로 harness를 0.3.1로 올렸다. 문서도 고쳤다: README.md, docs/README.md 15번(설계와 다른 점), retro C6(고친 날짜).

위험과 영향

  • 판정할 때마다 git을 한 번 더 부른다(worktree list, 시간 제한 5초). rm·push처럼 걸리는 낱말이 있는 명령에서만 돈다.
  • 등록되지 않은 폴더는 지켜지지 않는다. 예: 지운 worktree가 남긴 폴더, 없는 경로.
  • 사용자 전역 ~/.claude/hooks/guard_bash.py에 같은 판정이 있어 같이 고쳤다(repo 밖).
    • 이 PR이 병합되고, claude-harness main checkout을 받고, 플러그인을 0.3.1로 올리기 전까지는 전역 훅 시험의 사본 비교 2줄이 「다름」으로 나온다.
    • 이 기계에서는 전역 훅이 H12를 맡고 플러그인은 건너뛰므로, 그동안 동작에는 영향이 없다.

검증

  • 고치기 전(RED): 새 시험을 main 훅에 돌려 실패를 먼저 봤다.
    • worktree에서 ./*
    • main checkout에서 .claude/worktrees
    • 프로젝트 폴더가 main일 때 ../w2/src
  • 고친 뒤(GREEN): 두 곳에서 scripts/check.sh 통과. harness 28·redteam 21·템플릿 11, expectedFailure 없음.
    • 원래 repo 아래 worktree
    • /tmp 아래 worktree
  • 새 규칙 두 개를 하나씩 꺼 봤다. 끌 때마다 그 규칙의 시험이 실패한다.
  • 거짓 양성 확인: 소유자 기계 세션 기록의 rm -r 647개를 옛 판정과 새 판정으로 비교했다.
    • 이 중 338개는 지금도 있는 worktree 35곳에서 실행한 명령이다.
    • 프로젝트 폴더가 없을 때와 main checkout일 때 두 번 돌렸다.
    • 바뀐 것은 이 작업의 확인 명령 1개뿐이다.
  • 전역 훅 python3 ~/.claude/hooks/tests/run_tests.py: 268개 중 사례 266개가 맞다(worktree 사례 13개 추가).
    • 틀린 2개는 위의 사본 비교다(main checkout과 플러그인 캐시 0.3.0).
    • 전역 훅과 이 브랜치의 공유 정의 45개는 AST가 같다.
  • 실제 세션에서 확인했다. 전역 훅 설치 뒤:
    • 보통 Bash 명령은 통과한다.
    • 옆 worktree 안의 없는 경로에 대한 rm -rf는 「다른 worktree 안」으로 막힌다.
    • 작업 폴더 안과 scratchpad 안의 rm -rf는 통과한다.

리뷰어가 볼 곳

  • plugins/harness/scripts/guard_bash.py의 h12_roots(mine·foreign 계산)와 H12Visitor.rm_violation의 새 두 검사
  • plugins/harness/tests/test_hooks.py의 GuardRmCheckoutTest

관련

  • docs/retro/2026-11-08.md C6
  • design-docs harness/01-harness-design.md 5.1절 H12 rm -r 줄
## 무엇을, 왜 H12는 cwd의 main checkout도 `rm -r` 허용 폴더에 넣는다. 그래서 main checkout 안 worktree(`.claude/worktrees/…`)에서 아래 세 명령이 통과했다(`docs/retro/2026-11-08.md` C6). - `rm -rf ./*`: worktree 자신을 지운다. - `rm -rf ../w2`: 옆 worktree를 통째로 지운다. - `rm -rf ../w2/src`: 옆 worktree 안을 지운다. 앱은 worktree 세션의 `CLAUDE_PROJECT_DIR`를 main checkout으로 준다. 그래서 실제 세션이 바로 이 경우다. 이 PR은 이런 삭제를 막고, 그동안 이 빈틈을 표시하던 `expectedFailure`를 뗀다. ## 고른 방법과 버린 대안 - 허용 폴더는 그대로 두고, 「지킬 checkout」을 따로 센다. - 지킬 checkout은 작업 폴더와, 그 repo에 `git worktree list`로 등록된 모든 worktree다. - /tmp와 앱 임시 작업 폴더 밖에서만 아래 두 규칙을 건다. - 규칙 1: checkout 자신이나 그것을 품은 폴더를 통째로 지우면 막는다. - worktree에서: `./*`, `../w2`, `..` - main checkout에서: `.claude/worktrees` - 규칙 2: 옆 worktree 안을 지우면 막는다. - 옆 worktree는 이 세션 작업 폴더와 같지도 않고, 그것을 품지도 않고, 그 안에 있지도 않은 checkout이다. - 「이 세션 작업 폴더」는 cwd의 checkout으로 먼저 잡는다. 처음에는 프로젝트 폴더도 같이 봤다. 그러면 main checkout이 내 것이 되어 실제 세션에서 `../옆-worktree/x`가 통과했다. 그래서 cwd를 먼저 보도록 고쳤다. - 전처럼 통과하는 것: - 작업 폴더 안 정리(`rm -rf build` 등) - worktree에서 main checkout 안의 worktree 밖 자리를 지우는 일(`../../build`) - main checkout 세션이 worktree 안을 치우는 일(`.claude/worktrees/w/build`) - /tmp 아래 worktree 지우기 - 버린 대안: - worktree 세션에서 main checkout을 허용 폴더에서 빼기: 설계 문구에는 맞다. 하지만 지금 통과하는 일을 더 많이 막는데, 그래야 할 근거가 없다. - `.claude/worktrees` 폴더 이름으로 판정하기: 다른 곳에 둔 worktree를 놓친다. - 훅 동작이 바뀌므로 harness를 0.3.1로 올렸다. 문서도 고쳤다: `README.md`, `docs/README.md` 15번(설계와 다른 점), retro C6(고친 날짜). ## 위험과 영향 - 판정할 때마다 git을 한 번 더 부른다(`worktree list`, 시간 제한 5초). rm·push처럼 걸리는 낱말이 있는 명령에서만 돈다. - 등록되지 않은 폴더는 지켜지지 않는다. 예: 지운 worktree가 남긴 폴더, 없는 경로. - 사용자 전역 `~/.claude/hooks/guard_bash.py`에 같은 판정이 있어 같이 고쳤다(repo 밖). - 이 PR이 병합되고, `claude-harness` main checkout을 받고, 플러그인을 0.3.1로 올리기 전까지는 전역 훅 시험의 사본 비교 2줄이 「다름」으로 나온다. - 이 기계에서는 전역 훅이 H12를 맡고 플러그인은 건너뛰므로, 그동안 동작에는 영향이 없다. ## 검증 - 고치기 전(RED): 새 시험을 main 훅에 돌려 실패를 먼저 봤다. - worktree에서 `./*` - main checkout에서 `.claude/worktrees` - 프로젝트 폴더가 main일 때 `../w2/src` - 고친 뒤(GREEN): 두 곳에서 `scripts/check.sh` 통과. harness 28·redteam 21·템플릿 11, expectedFailure 없음. - 원래 repo 아래 worktree - /tmp 아래 worktree - 새 규칙 두 개를 하나씩 꺼 봤다. 끌 때마다 그 규칙의 시험이 실패한다. - 거짓 양성 확인: 소유자 기계 세션 기록의 `rm -r` 647개를 옛 판정과 새 판정으로 비교했다. - 이 중 338개는 지금도 있는 worktree 35곳에서 실행한 명령이다. - 프로젝트 폴더가 없을 때와 main checkout일 때 두 번 돌렸다. - 바뀐 것은 이 작업의 확인 명령 1개뿐이다. - 전역 훅 `python3 ~/.claude/hooks/tests/run_tests.py`: 268개 중 사례 266개가 맞다(worktree 사례 13개 추가). - 틀린 2개는 위의 사본 비교다(main checkout과 플러그인 캐시 0.3.0). - 전역 훅과 이 브랜치의 공유 정의 45개는 AST가 같다. - 실제 세션에서 확인했다. 전역 훅 설치 뒤: - 보통 Bash 명령은 통과한다. - 옆 worktree 안의 없는 경로에 대한 `rm -rf`는 「다른 worktree 안」으로 막힌다. - 작업 폴더 안과 scratchpad 안의 `rm -rf`는 통과한다. ## 리뷰어가 볼 곳 - `plugins/harness/scripts/guard_bash.py`의 `h12_roots`(`mine`·`foreign` 계산)와 `H12Visitor.rm_violation`의 새 두 검사 - `plugins/harness/tests/test_hooks.py`의 `GuardRmCheckoutTest` ## 관련 - `docs/retro/2026-11-08.md` C6 - design-docs `harness/01-harness-design.md` 5.1절 H12 `rm -r` 줄
donghyeon.kang added 1 commit 2026-11-12 22:05:42 +00:00
문제: H12는 cwd의 main checkout도 rm 허용 폴더에 넣는다. 그래서
main checkout 안 worktree(.claude/worktrees/…)에서 worktree 자신
(`rm -rf ./*`), 옆 worktree(`rm -rf ../w2`), 그 안(`../w2/src`)을
지우는 것이 통과한다(docs/retro/2026-11-08.md C6). 앱은 worktree
세션의 CLAUDE_PROJECT_DIR를 main checkout으로 주므로 실제 세션이 이
경우다.

고친 방법: 허용 폴더는 그대로 두고 지킬 checkout을 따로 센다. 작업
폴더와 그 repo에 `git worktree list`로 등록된 모든 worktree다. /tmp·앱
임시 작업 폴더 밖에서는 checkout 자신이나 그것을 품은 폴더를 통째로
지우면 막는다. 이 세션 작업 폴더와 같지도, 품지도, 그 안에 있지도
않은 checkout(옆 worktree)은 그 안을 지워도 막는다. 「이 세션 작업
폴더」는 cwd의 checkout을 먼저 본다. 프로젝트 폴더를 먼저 보면 main
checkout이 내 것이 되어 옆 worktree 안이 열린다(실제 세션에서 확인).
main checkout 안 다른 자리(worktree 밖)와 main checkout 세션이
worktree 안을 치우는 일은 전처럼 통과한다.
버린 대안: worktree 세션에서 main checkout을 허용 폴더에서 빼기(설계
문구에는 맞지만 지금 통과하는 일을 더 많이 막는다. 근거 없이 넓히지
않았다), `.claude/worktrees` 이름으로 판정(다른 곳에 둔 worktree를
놓친다).

위험: 판정마다 git을 한 번 더 부른다(`worktree list`, 시간 제한
5초). 등록되지 않은 폴더(지운 worktree의 남은 폴더)는 지켜지지
않는다. /tmp 아래 worktree는 일부러 그대로 허용한다. 훅 동작이 바뀌어
harness 0.3.1로 올린다. 같은 판정이 전역 ~/.claude/hooks/guard_bash.py
에도 있어 같이 고쳤다. 이 repo가 병합되고 main checkout을 받고 플러그인을
0.3.1로 올리기 전까지 전역 훅 시험의 사본 비교 2줄은 다르다고 나온다.

검증: 새 시험을 main 훅에 돌려 실패를 먼저 봤다(worktree `./*`,
main checkout `.claude/worktrees`, 프로젝트 폴더가 main일 때
`../w2/src`). 고친 뒤 scripts/check.sh 통과(harness 28·redteam 21·
템플릿 11, expectedFailure 없음). 새 규칙 둘을 하나씩 끄면 각각 시험이
실패한다. 소유자 기계 세션 기록의 rm -r 647개를 프로젝트 폴더 없이,
또 main checkout으로 주고 옛·새 판정을 비교해 바뀐 것은 이 작업의
확인 명령 1개뿐이었다.

Refs: docs/retro/2026-11-08.md C6
donghyeon.kang merged commit 2cd6a01363 into main 2026-11-12 22:10:13 +00:00
donghyeon.kang deleted branch fix/h12-nested-worktree-rm 2026-11-12 22:10:13 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/claude-harness#11