nunchi: 검토대기 LLM-judge 배치 플릿 표준화 — dry-run 기본·clear 단일 자동액션 (TM-2370 P0-c, gwakga 파일럿 완료)

[jinon86]

목표 (TM-2370 P0-c)

nunchi 검토대기 백로그를 LLM judge로 1차 분류(auto-merge / conflict-flag / human-approval)하는 배치의 플릿 표준화. gwakga 파일럿(2026-08-20)에서 설계·드라이런 완료 — 9건 분류(auto-merge 8 / human 1) 후 수동 소화, 백로그 0건 달성.

설계 요지 (파일럿 검증됨)

• 일 1회, CAP 10건/회, 24h 미만 신선 항목 불가침, flock 동시 실행 방지
• judge: claude -p(haiku) + 엄격 루브릭, 실패/파싱불가 시 fail-closed(human-approval)
• 자동 액션은 review <id> --clear 단일 종류, supersede는 제안문만 리포트에 기재
• NUNCHI_JUDGE_APPLY=1(기본 dry-run) — APPLY 전환은 fresh-approval 대상
• 적용 런 사전 DB 백업 + 변이 직전 재확인 + append-only 감사로그(judge-audit.jsonl)
• 리포트: ~/.claude/state/nunchi-review-report.md + human 항목 존재 시 플래그 파일

구현 항목

1. claude/hooks/nunchi/judge-batch.py (파일럿 스케치는 gwakga:/root/.claude/state/nunchi-judge/ 참조)
2. install-nunchi.sh에 judge cron 옵션(관리 마커+gen 스탬프 — 비관리 cron은 doctor cron-drift 경고 유발하므로 설치기 경유 필수)
3. 테스트: fake DB/judge 매트릭스(TM-2217 패턴)

오픈 퀘스천 (파일럿에서 도출)

• 중복 통합 CLI 갭: close-as-duplicate가 없음 — merge <dup_id> --into <id> 소커맨드 추가 여부 (supersede는 신규 사실을 또 삽입해 중복 증가)
• G2 강등 결정론 처리: 파일럿 9건 중 8건이 G2 강등(형제 무충돌) — LLM 없이 결정론 규칙으로 처리 가능 → haiku 비용 절감 여지
• observation TTL 경합: 형제 증거 observation이 7일 TTL로 judge 실행 전 소멸 가능 — 증거 가중치 정책 필요
• 알림 경로: 로컬 플래그+SessionStart 스냅샷으로 충분한지, 브릿지 발신 연결할지

[seoseo-ai]

착수 클레임 — dungae, 작업지시서_병행레인_20260821 레인 C (오너 설계 승인: 결정론 선처리)

지시서 권고 설계(오너 승인)대로 결정론 규칙 선처리 + 잔여만 judge로 구현 중입니다.

• 결정론 선처리의 의미: 배치 시점에 write gate의 G3 규칙(동일 observed·오픈 형제 ≥0.6 토큰 겹침)을 재실행 — 라이브 충돌 형제가 없으면 LLM 없이 clear. 파일럿의 8/9 클래스가 이것. 의미 계약 정렬을 위해 규칙을 복사하지 않고 nunchi 모듈을 임포트해 _tokens를 그대로 재사용(드리프트 원천 차단).
• 잔여(라이브 충돌 있음)만 claude -p haiku strict 루브릭 judge — 파싱 실패/실행 실패는 fail-closed(human).
• 이 PR이 scripts/validate-harness.sh 목록에 claude/hooks/nunchi/judge-batch.test.sh 1줄을 추가합니다(병행 레인 충돌 지점 공지 규칙). 현재 병행 중인 C/D/E 코드 PR은 이것뿐입니다.
• 예정 write-set: claude/hooks/nunchi/judge-batch.py(신규) + judge-batch.test.sh(신규) + scripts/install-nunchi.sh(--judge 옵션) + install-nunchi.test.sh + validate-harness.sh.
• 오픈 퀘스천 처리: merge CLI 갭·observation TTL 경합은 이 PR 범위 밖(이슈에 유지). 알림은 로컬 플래그+리포트로 제한.