From 8b86f0127b4a59edb140b739a9ab88c97c6e7c7c Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sun, 22 Nov 2026 01:37:22 +0900 Subject: [PATCH 1/3] =?UTF-8?q?fix(hooks):=20N5=EA=B0=80=20scripts/verify.?= =?UTF-8?q?sh=20=EB=AC=B4=EA=B1=B0=EC=9A=B4=20=EB=8B=A8=EA=B3=84=EB=A5=BC?= =?UTF-8?q?=20desktop=20=EC=8B=A4=ED=96=89=EC=9C=BC=EB=A1=9C=20=EB=B3=B8?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 턴 끝 알림 N5는 `ssh … gradlew …` 모양만 desktop 실행으로 본다. AGENTS.md 「검증」이 정식 진입점이라 한 `scripts/verify.sh leaf `·`scripts/verify.sh pr`(기본 호스트가 desktop)로 검증해도, `ssh desktop '… scripts/verify.sh app --on here'`로 돌려도 턴 끝이 한 번 막힌다. 알림 문구도 정식 진입점이 아니라 `:check`를 가리킨다. 고른 방법: Bash 명령에서 주석·줄 잇기·here-document 본문을 먼저 떼고, shlex로 낱말과 제어 연산자(`;`·`&&`·`||`·`|`·`&`·괄호·줄바꿈)로 나눈다. `verify.sh`로 끝나는 낱말 다음이 Gradle 단계(verify.sh run_here와 같은 leaf·pr·main·nightly·release·app·round)이면 인자를 verify.sh main과 같이 읽는다: leaf 대상, `--on`·`--log` 값, 플래그 둘, 리다이렉션. 그 밖의 인자가 있으면 verify.sh가 사용법 오류로 멈추니 세지 않는다. 호스트는 마지막 `--on`, 없으면 그 명령 앞의 `VERIFY_HOST=` 대입 → 앞선 `export VERIFY_HOST=` → (노트북만) 환경 값 → desktop이고, 빈 값은 기본값이다. `--on here`는 `ssh ` 안(원격 명령 낱말, 따옴표 원격 명령, 그 ssh가 읽는 here-document)에서만 desktop이다. `<셸> -c '…'`과 셸이 읽는 here-document는 그 셸이 도는 곳에서 읽고, 그 밖의 here-document 본문(`cat > 파일 <`에 맞춘다. 기존 gradlew 판정은 그대로 두고 새 판정을 뒤에 붙였다. 새 눈 리뷰가 줄바꿈·here-document 경계(노트북 명령과 글을 desktop 실행으로 세던 것), 대입 범위·빈 값· 사용법 오류 인자를 짚어 같은 커밋에서 고쳤다. 버린 대안: (1) 명령에 `verify.sh`가 있으면 무조건 desktop으로 본다 — `docs`·노트북 `--on here`까지 지워 알림이 사라진다. (2) verify.sh에서 단계·옵션 목록을 실행 중에 읽는다 — bash case 줄을 매번 파싱하는 것은 깨지기 쉽다. 대신 시험이 verify.sh run_here 단계 목록, main 옵션 목록과 훅 상수가 같은지 본다. 위험·한계: 셸 문법을 다 해석하지는 않는다(`$'…'` 따옴표, 중첩 명령 치환 안의 here-document 등). 잘못 세도 알림 하나가 빠지거나 더 나올 뿐, 게이트는 그대로다. `run_in_background` 실행은 시작할 때 센다(기존 gradlew 판정과 같다). 노트북 감싸개 `laptop-gate`의 `./gradlew`는 여전히 세지 않는다. 검증: python3 -m unittest discover -s scripts/tests -p test_hooks.py rc=0(37개, 1 skip은 실제 포매터 jar 시험). 기준 b2bfb9bbf의 hooks.py에 새 시험을 얹으면 rc=1(failures=20, errors=2: desktop 실행 모양이 모두 막히고 새 상수가 없다). 변이 31개(verify 분기·`--on` 무시·첫 `--on`·docs·ssh 범위·따옴표 원격·here-document 스크립트· 본문을 명령으로 읽기·줄바꿈 경계·here 판정·호스트 판정·환경 무시·원격에 환경 쓰기·자기 대입 무시·대입 범위·export·빈 값·사용법 오류 인자·대상 없는 leaf·리다이렉션·주석·줄 잇기·닫히지 않은 따옴표·`-c` 스크립트· 셸 here-document·인자 범위·ssh 호스트 확인·단계 범위·ssh 호스트 범위·ssh 옵션·문구)가 모두 시험 하나 이상을 실패시킨다. python3 scripts/check-work-docs.py rc=0, python3 scripts/check-docs.py rc=0. --- scripts/hooks/README.md | 7 +- scripts/hooks/hooks.py | 197 +++++++++++++++++++++++++++++++++++- scripts/tests/test_hooks.py | 94 +++++++++++++++++ 3 files changed, 293 insertions(+), 5 deletions(-) diff --git a/scripts/hooks/README.md b/scripts/hooks/README.md index fff6bca2..c8b77ea3 100644 --- a/scripts/hooks/README.md +++ b/scripts/hooks/README.md @@ -5,8 +5,8 @@ Claude Code가 정해진 때에 대신 실행하는 명령이다. 연결은 `.cl ```text Edit·Write 직전 ──> pre-edit ──> H13 적용된 migration이면 막는다(종료 코드 2) Edit·Write 직후 ──> post-edit ──> Java면 포맷 → N1 레이어 의존 알림, 문서면 N2 문서 검사 알림 -Bash 직후 ──> post-bash ──> desktop에서 Gradle을 돌렸으면 N5 기록을 비운다 -턴 끝 ──> stop ──> N5 Java를 고쳤는데 desktop 실행이 없으면 한 번 알린다 +Bash 직후 ──> post-bash ──> desktop에서 Gradle을 돌렸으면(scripts/verify.sh 무거운 단계) N5 기록을 비운다 +턴 끝 ──> stop ──> N5 Java를 고쳤는데 desktop 실행이 없으면 scripts/verify.sh leaf 를 한 번 알린다 ``` ## 1. 원칙 @@ -25,9 +25,10 @@ Bash 직후 ──> post-bash ──> desktop에서 Gradle을 돌렸으면 | 포맷 | PostToolUse `Edit\|Write\|MultiEdit` | `src/**/*.java`(`build/` 제외. `build-logic/`은 `src/` 밖이라 대상이 아니다)를 google-java-format으로 맞춘다. 버전은 카탈로그 `googleJavaFormat`, jar는 Gradle 캐시, 옵션은 Spotless 단계와 같게 `--skip-reflowing-long-strings --replace` | 파일이 바뀌면 「다시 읽는다」 한 줄. 문법 오류면 첫 줄들 | | N1 | 같은 때, `src/**/src/main/java/**/*.java` | registry로 그 파일의 leaf를 찾고 import를 본다: 순수성 목록(`DomainPurityArchitectureTest`, `verifyApplicationCoreDependencyPurity`와 같은 패키지), inbound의 persistence 접근, `dev.caskeleton.*`의 주인 leaf가 registry `allowed_dependencies`(전이 포함)에 있는지 | 「HARD-STOP N 의심」 줄 | | N2 | 같은 때, `*.md` | `scripts/check-work-docs.py`와 `scripts/check-docs.py`를 돌린다 | 실패 줄. 고친 문서를 가리키는 줄이 있으면 그것만 | -| N5 | Stop | 이 세션에서 Java를 고친 뒤 `ssh … gradlew …` 실행이 없으면 턴을 한 번 막고 이유를 준다 | `decision: block`, 다음 Java 편집 전까지 한 번 | +| N5 | Stop | 이 세션에서 Java를 고친 뒤 desktop 실행이 없으면 턴을 한 번 막고 `scripts/verify.sh leaf `를 가리킨다. desktop 실행으로 보는 것은 둘이다: `scripts/verify.sh`의 Gradle 단계(`leaf`·`pr`·`main`·`nightly`·`release`·`app`·`round`)를 desktop에서 돌린 것(`--on`이 없으면 기본 호스트 `${VERIFY_HOST:-desktop}`, `--on here`는 `ssh ` 안에서만), 그리고 `ssh … gradlew …`. `docs` 단계와 노트북의 `--on here`는 아니다 | `decision: block`, 다음 Java 편집 전까지 한 번 | - N5가 기억하는 것은 `.claude/hook-state/.json`이다(git이 무시한다). +- N5는 셸 문법을 다 풀지 않는다. 주석·줄 잇기·here-document 본문을 떼고 `;`·`&&`·`||`·`|`·`&`·괄호·줄바꿈으로 명령을 나눈다. here-document 본문과 `<셸> -c '…'`은 `ssh `나 셸(`bash`·`sh`·`zsh`)이 받을 때만 명령으로 읽고, 그 밖의 본문(`cat > 파일 < -c '