fix(hooks): N5가 verify.sh를 desktop 실행으로 보고 기록 본문 알림 N6를 더한다 #83
Closed
donghyeon.kang
wants to merge 1 commits from
fix/hooks-verify-sh-and-record-body into main
pull from: fix/hooks-verify-sh-and-record-body
merge into: :main
:main
:fix/verify-remote-log-header
:test/lease-value-bounds
:test/lock-contract-bounded-waits
:refactor/ratelimit-shared-bounds
:test/objectstorage-production-client-timeouts
:fix/verify-junit-summary
:fix/env-contract-nested-placeholder
:fix/notification-eligibility-and-redrive
:fix/httpclient-docs-field-match
:test/fileserver-admin-access-checks
:fix/gitignore-nested-env
:fix/check-docs-reference-rules
:fix/hooks-n5-verify-sh-n6-records
:fix/hooks-verify-sh-and-record-body
:test/compose-contract-verdict
:test/fileserver-precondition-and-policy-wiring
:ci/nfs-nightly-host-check-and-pin
:test/notification-worker-behavior
:test/mongo-tls-lane-handshake-refusal
:test/compose-smoke-judgements
:test/notification-admin-guards-cancel-branches
:claude/links-dns-probe
:docs/ledger-fixed-by-49-50
:claude/be-main-red2-minio-2
:claude/be-main-red2-compose
:claude/be-main-red2-minio
:claude/r9-b-claim-tx
:claude/w2-be-ci-perf-4
:claude/r9-review-record
:claude/r9-c-tests-build
:claude/r9-c-docs-body
:claude/r9-c-contracts
:claude/r9-compose-ops
:claude/r9-public-surface
:claude/r9-stale-names
:claude/r9-tx-timeouts
:claude/r9-env-keys
:claude/r9-arch-rules
:claude/w2-be-ci-perf-2
:claude/w2-be-ci-perf-2-wip
:claude/redteam-be-fixes-main
:claude/w2-be-ci-perf-e89fe7
:claude/redteam-be-fixes
:claude/t2a-backend-ci-451e3b
:claude/x3-messaging-library-1aa3fa
:claude/x2-grpc-library-43dd09
:claude/h3-backend-harness-34fc23
:claude/v1-vuln-fix-e089b9
:claude/i2-docs-merge-02df15
:claude/d2c-ops-docs-1-c22c9f
:claude/d2a-entry-docs-12a342
:claude/d2b-src-adr-d46d23
:claude/d2d-ops-docs-2-e40938
:claude/i1-layout-docs-merge-217f1e
:refactor/maturity-review-2026-11
:claude/t1-backend-layout-46973e
:claude/d1-docs-system-fd4a0f
:claude/integration-r9-f1bc5c
:claude/r9-g1-inbound-456713
:claude/r9-g3-migration-7ce36d
:claude/r9-g2-stomp-interceptor-f5675d
:claude/r9-g4-idempotency-c669be
:claude/manual-gap-fix-2-9b0fe2
:claude/r8-review-a-3851a7
:claude/integration-r8-a4196a
:claude/r8-f1-transport-errors-b21ebf
:claude/r8-f5-small-fixes-f40412
:claude/r8-f3-persistence-9e8157
:claude/r8-f2-arch-rules-60140e
:claude/r8-f4-idempotency-3a6a0f
:claude/manual-gap-fix-1-824a41
:claude/t4-2-manual-history-ids-9ac57c
:claude/t1-r10-review-d0ecc6
:claude/integration-r7
:claude/t5-idempotency-operation-id-9bd973
:claude/t3-error-codes-loglevel-fcf427
:claude/t1-baseline-7d623a
:claude/t2-circuit-breaker-2ff8df
:claude/t4-manual-history-ids-51889f
:claude/b3-docs-work-34a1dd
:claude/perf-assertions-fail-closed-c09414
:claude/improvement-manual-6ae516
:refactor/review-followup
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
donghyeon.kang (동현 강)
Clear assignees
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: donghyeon.kang/clean-architecture-backend-template#83
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
편집 훅 두 가지를 고치고, 루트
CLAUDE.md에 소유자 자율 운영 줄을 붙인다.ssh <desktop> … gradlew …모양만 desktop 실행으로 봤다. 그래서AGENTS.md「검증」이 정식 진입점이라 한scripts/verify.sh leaf <gradle-path>·scripts/verify.sh pr(기본 호스트 desktop)로 검증해도,ssh desktop '… scripts/verify.sh app --on here'로 돌려도 턴 끝이 한 번 막혔다. 알림 문구도<gradle-path>:check를 가리켰다. 이제verify.sh의 Gradle 단계를 desktop에서 돌린 것을 desktop 실행으로 보고, 문구는scripts/verify.sh leaf <gradle-path>를 가리킨다.docs/README.md「문서 수명과 언어」)와 「docs/vision.md는 소유자만 쓴다」가 문서에만 있고 훅·게이트가 없었다. post-edit에서 둘을 알린다(exit 0, 막지 않는다).CLAUDE.md10행에 소유자 자율 운영(2026-11-22) 요약. 결정은 권하는 안대로 바로 진행해 보고에 되돌리는 법을 적고, 메시지·예약 차례에는 새 세션 카드를 띄우지 않는다. 정본(소유자 전역 설정 「자율 운영」, project-docsREADME.md7절)만 가리킨다. 커밋a8b5b31d2, 카드 LEAD-MS-0025 C1.check-work-docs가 CLAUDE.md를 10줄로 막아 새 줄 대신 10행에 붙였다.고른 방법과 버린 대안
N5. Bash 명령에서 주석·줄 잇기·here-document 본문을 먼저 떼고, shlex로 낱말과 제어 연산자(
;·&&·||·|·&·괄호·줄바꿈)로 나눈다. 단순 명령마다 실제로 실행되는 낱말 하나만 본다: 리다이렉션을 뺀 낱말에서 대입과 감싸개(timeout·flock·env·nohup등, 값 받는 옵션과 앞 인자 수를 표로 둔다) 뒤의 낱말, 또는 셸에 준 스크립트 파일. 그 낱말이verify.sh이고 다음이 run_here의 Gradle 단계(leaf·pr·main·nightly·release·app·round)면 인자를 verify.shmain과 같이 읽는다(leaf 대상,--on·--log값, 플래그 둘, 리다이렉션). 그 밖의 인자가 있거나 leaf 대상이 registrygradle_path가 아니면 Gradle 전에 멈추니 세지 않는다. 출력에 verify.sh의 「미추적 파일이 있어 보내지 않는다」(rc 5)가 있으면 그 명령의 verify.sh도 세지 않는다. 그 낱말이gradlew면 desktop 안에서 돌 때만 센다. 호스트는 마지막--on→ 그 명령 앞VERIFY_HOST=→ 앞선export→ (노트북만) 환경 값 →desktop, 빈 값은 기본값.--on here는ssh <desktop 호스트>안에서만 desktop. ssh 원격 명령은 ssh가 보내는 대로 리다이렉션을 뺀 낱말을 이어 desktop에서 다시 읽고, 그 ssh가 읽는 here-document·<<<문자열도 desktop 스크립트다. 셸은 옵션으로-c스크립트, stdin 스크립트(-s또는 인자 없음), 스크립트 파일,-n(실행 안 함)을 가르고, 스크립트는 그 셸이 도는 곳에서 읽는다. 그 밖의 here-document 본문(cat > 파일 <<EOF,git commit -F - <<EOF,bash 파일 <<EOF)은 글로 본다.docs는 세지 않는다. 스크립트 안의 스크립트는MAX_NESTING단까지만 읽는다(깊은 ssh 중첩이 RecursionError로 훅을 죽이지 않게).verify.sh가 있으면 무조건 desktop —docs·노트북--on here까지 알림을 지운다.ssh+ 명령 글 안gradlew판정을 그대로 두고 README만 verify.sh로 좁힌다 — 커밋 메시지 본문이나 주석의ssh desktop ./gradlew를 계속 실행으로 센다.| tail·; echo rc=$?로 끝나면 rc가 0이라 돈다.N6.
.md편집마다 N2보다 먼저 본다.docs/vision.md면 「소유자만 쓴다(docs/vision.md:3-4). 되돌리고 제안만 한다」 한 줄.scripts/check-docs.py의RECORD_KINDS폴더 문서면 기준 커밋의 옛 글과 머리 블록 끝 뒤 본문을 비교한다. 기준 커밋은 verify.sh와 같은git merge-base HEAD "${VERIFY_BASE_REF:-origin/main}"이고, 그 ref가 없으면 HEAD다. 설계서·history 기록은 같아야 하고, 결정 기록(DECISION_PREFIXES)은 옛 본문이 새 본문의 앞부분이면 된다. 기준 커밋에 없는 기록(이 브랜치에서 새로 쓴 기록, 커밋했어도)과docs/reviews/는 보지 않는다. 출력은 「기록 본문 알림(N6) <경로>: … 기준 커밋(merge-base origin/main)과 n곳 다르다 …」와 바뀐 줄, 최대 5줄. N6에는 뒤에 게이트가 없으니 첫 줄은 늘 앞에 두고, N2 실패 줄이 함께 있으면 N6는 첫 줄만 낸다(N2 줄이 잘리지 않게).check-docs.py소스에서ast.literal_eval로 읽는다(복사본 없음, 그 파일을 실행하지 않음). 시험이 진짜check-docs.py의record_kind·strip_head_block과 훅 판정을 대조한다.check-docs.py를 import해 함수를 쓴다 — 편집마다 그 스크립트의 최상위 코드가 돈다. N2 시험의 가짜 스크립트처럼 최상위에서sys.exit하면 훅이 죽었다(실제로 겪음).hooks.py에 복사 — 두 벌이 갈라진다.docs/reviews/도 본다 — 리뷰 기록 규칙이 문서끼리 맞지 않아 따로 정할 일이다.위험과 영향
settings.json·check-docs.py·verify.sh는 바뀌지 않는다.$'…'따옴표, 명령 치환 안의 here-document,flock 파일 -c '…'꼴, 감싸개 표에 없는 감싸개 등). 잘못 세도 알림 하나가 빠지거나 더 나올 뿐이다. 원격 준비 실패(verify.sh rc 4)는 출력으로 가리지 못해 센다.run_in_background실행은 시작할 때 센다(기존 gradlew 판정과 같다).docs/README.md「문서 수명과 언어」)상 본문 수정이라 알린다. 이 브랜치에서 새로 쓴 계획서는 조용하다.check-docs.py가 상수 이름을 바꾸면 N6는 조용해지는데, 그때test_the_record_rules_are_the_document_checkers가 실패해 PR 단계testDocumentChecks에서 걸린다.laptop-gate의./gradlew는 여전히 N5가 세지 않는다(소유자 판단으로 넘김).검증
모두 노트북(Python·문서만 바뀜, Gradle 없음).
python3 -m unittest discover -s scripts/tests -p test_hooks.py: 커밋8b86f012737개 rc=0, 커밋9c0a7cb3d52개 rc=0, 커밋a86e00d6e61개 rc=0(1 skip = 실제 포매터 jar 시험).a86e00d6e): 9c0a7cb3d의hooks.py에 새 상수 셋만 얹고 새 시험을 돌리면 rc=1(failures=20).echo scripts/verify.sh pr,bash -n …,grep -c bash <<EOF,<<\EOF·<<'END NOTE', 커밋 메시지 본문의ssh desktop ./gradlew, registry에 없는 leaf, 거절 문구가 있는 실행을 모두 desktop 실행으로 셌고, 이 브랜치에서 커밋한 계획서 편집에 N6가 알렸다.hooks.py에 새 시험을 얹으면 rc=1(failures=20, errors=2).scripts/verify.sh leaf :domain-core,ssh desktop 'cd ~/wt && scripts/verify.sh app --on here'등 desktop 실행 모양이 모두 턴을 막았다.scripts/verify.sh leaf :domain-core,ssh desktop 'cd ~/wt && scripts/verify.sh app --on here'외 19모양. 막힘(decision: block):scripts/verify.sh docs, 노트북scripts/verify.sh pr --on here외 20모양, 글로 쓴 here-document 3모양. 기존ssh … ./gradlew시험 그대로 통과.docs/reviews/편집, 끝 빈 줄, check-docs.py 없음·상수 빠짐·리터럴 아님. 알림(rc 0,N6): 설계서 본문 한 줄, 설계서 끝 덧붙임, ADR 본문 중간,docs/vision.md, 바뀐 곳 여럿(5줄 안), N2 실패 줄과 함께(첫 줄만).<<-, 실행 낱말·감싸개·리다이렉션, ssh·셸 판정, gradlew, 거절 문구, registry, 중첩 한도, merge-base)를 하나씩 끈 사본에서 모두 rc=1(생존 0).scripts/verify.sh docs(커밋마다 깨끗한 detached worktree):8b86f0127rc=0(scripts/tests 226개),9c0a7cb3drc=0(241개),a86e00d6erc=0(250개),a8b5b31d2rc=0(250개,CLAUDE.md: 10/10). 같은 줄을 새 11행으로 넣었을 때는 rc=1(CLAUDE.md: 11 lines, limit 10).build.gradletestDocumentChecks(Exec, prCheck)가 같은python3 -m unittest discover -s scripts/tests를 돌린다. 선언 입력이 없는 Exec라 캐시로 옛 결과가 나오지 않는다.src/bootstrap/app/build.gradle·src/*.java는scripts/hooks·루트CLAUDE.md를 읽지 않는다. desktopverify.sh pr는 돌리지 않았고, PR runpr / done이 prCheck를 돈다.리뷰 반영
\EOF·공백, 셸 판정이 아무 낱말, 옛 gradlew 판정, 변이 생존 3, Gradle 전에 멈춘 verify.sh, 명령 위치 아닌 verify.sh)과 질문 둘(N6 기준 → merge-base 권고, 「실행 중」 계획서 체크 상자 → 본문 수정이라 알림이 맞음) — a86e00d6e에서 Low 6과 merge-base를 고쳤고, 체크 상자는 바꾸지 않았다. 깊은 ssh 중첩의 RecursionError는 반영 중 직접 찾아 같은 커밋에서 고쳤다.리뷰어가 볼 곳
scripts/hooks/hooks.pyran_desktop_gradle·command_words·command_word·shell_input·runs_gradle·verify_target·post_bash(N5),record_rules·base_commit·record_body·record_findings(N6),post_edit의 호출 순서.scripts/tests/test_hooks.pyTurnEndNudgeTest(새 시험 11개),RecordBodyNudgeTest(새 묶음).scripts/hooks/README.md흐름 그림·표 N5·N6 줄·한계 줄, 루트CLAUDE.md5행(훅 목록)·10행(자율 운영).관련
scripts/hooks/README.md1절(되돌릴 수 없는 것만 막는다)·3절(변이 시험).docs/README.md「문서 수명과 언어」,.claude/rules/docs.md,docs/vision.md머리.N5는 명령 안 어디에 있든 `verify.sh <단계>`를 실행으로 셌다. 그래서 `echo scripts/verify.sh pr`, `bash -n scripts/verify.sh pr`도 desktop 실행이 됐다. here-document는 명령 안 아무 낱말이나 bash·sh·zsh면 스크립트로 읽었고(`grep -c bash <<EOF`), `<<\EOF`·`<<'END NOTE'` 구분자는 못 알아 본문을 명령으로 읽었다. `ssh … gradlew`는 옛 검사 그대로 명령 글 전체에서 낱말을 찾아, 커밋 메시지 본문이나 주석의 `ssh desktop ./gradlew`도 셌다. registry에 없는 leaf 대상, 미추적 파일로 보내기를 거절한 실행(rc 5)처럼 Gradle 전에 멈춘 verify.sh도 셌다. N6는 HEAD와 비교해서, 이 브랜치에서 새로 쓰고 커밋한 기록을 다듬을 때도 「본문을 되돌린다」를 알렸다. 아직 main에 들어가지 않은 글이라 그 알림은 정당한 수정을 되돌리게 만든다. 고친 방법: - N5: 단순 명령마다 실제로 실행되는 낱말 하나만 본다. 대입과 감싸개 (timeout·flock·env·nohup 등, 값 받는 옵션과 앞 인자 수를 표로 둠) 뒤의 낱말, 셸에 준 스크립트 파일이다. 셸은 옵션을 읽어 -c 스크립트, stdin 스크립트(-s 또는 인자 없음), 스크립트 파일, -n(실행 안 함)을 가른다. ssh 원격 명령은 ssh가 보내는 대로 리다이렉션을 뺀 낱말을 이어 desktop에서 다시 읽는다. gradlew도 같은 길로 desktop 안에서 돌 때만 센다. leaf 대상은 registry gradle_path와 대조하고, 출력에 verify.sh의 거절 문구가 있으면 그 명령의 verify.sh는 세지 않는다. 스크립트 안의 스크립트는 MAX_NESTING단까지만 읽는다(깊은 ssh 중첩이 RecursionError로 훅을 죽이지 않게). - here-document 구분자 정규식이 `\WORD`와 따옴표 안 공백을 받는다. - N6: 기준 커밋을 verify.sh와 같은 `git merge-base HEAD "${VERIFY_BASE_REF:-origin/main}"`로 하고, 그 ref가 없으면 HEAD로 돌아간다. 알림 문구는 기준 커밋 이름을 적는다. 버린 대안: - README의 N5 문구를 verify.sh 경로로 좁히고 옛 gradlew 검사를 둔다 — 같은 오판이 gradlew 쪽에 남는다. - 실패한 Bash는 PostToolUse가 안 돈다고 보고 rc 5를 두지 않는다 — `| tail`·`; echo rc=$?`로 끝나면 rc가 0이라 돈다. 위험·한계: 여전히 넛지다. 원격 준비 실패(rc 4)는 출력으로 가리지 못해 센다. flock의 `-c` 꼴, 감싸개 표에 없는 감싸개는 실행으로 보지 않아 알림이 한 번 더 나올 수 있다. 「실행 중」 계획서 체크 상자 수정은 기록 규칙상 본문 수정이라 N6가 계속 알린다(이 브랜치에서 새로 쓴 계획서는 이제 조용하다). 검증(노트북, Python·문서만): - python3 -m unittest discover -s scripts/tests -p test_hooks.py: 61개 rc=0(1 skip = 실제 포매터 jar). - RED: 9c0a7cb3d의 hooks.py에 새 상수 셋만 얹고 새 시험을 돌리면 rc=1, failures=20. - 변이: 이 커밋이 더하거나 건드린 조건 41개를 하나씩 끈 사본에서 모두 rc=1(생존 0). - python3 scripts/check-docs.py, scripts/check-work-docs.py rc=0.#84로 다시 연다. 커밋 셋(8b86f0127·9c0a7cb3d·a86e00d6e)은 같고, 총괄이 더한 커밋 3 a8b5b31d2(루트
CLAUDE.md10행에 소유자 자율 운영 요약)만 뺐다. 에이전트 지침 파일에 행동 규칙을 넣는 변경은 다른 세션의 카드만으로 하지 않고 소유자 직접 지시를 받은 뒤 따로 낸다. 커밋 a8b5b31d2는 이 브랜치에 남겨 둔다.Pull request closed