j#2UdZddlmZddlmZddlmZmZmZdZ de d<dZ de d <d Z de d <e e e e hZd e d <dZde d<dZde d<GddeZedGddZd#dZd$dZd%dZdddd d&dZd'd Zgd!Zy")(uanu_v2.gemini_evidence_freshness_checker — task-2641 신규 helper. 회장 verbatim 12 (2026-05-23) §10 1:1 박제: Gemini fresh evidence 판정 = ``PR current HEAD SHA == Gemini review commit_id`` (spec §3.1). task-2640 사고 박제 (spec §3.1): - 회장 review id=4350214991 state=COMMENTED · body 빈 문자열 → ``gemini-code-assist[bot]`` author 가 아니므로 Gemini review 로 인정 0 - PR HEAD 변경 후 fresh Gemini review commit_id 미도착 → STALE - STALE 자동 감지 → 1차 OWNER nudge 발사 → fail 시 CHAIR_UI_FALLBACK_REQUIRED 본 모듈 책임 (spec §3.1, task md §회장 verbatim 12 #10): - 입력: pr_number / current_head_sha / github_api callable - 출력: FreshnessResult enum (FRESH / STALE / NO_REVIEW) - PR HEAD 와 Gemini review commit_id 정합 검증 one-way isolation: anu_v2/ 외부 import 금지. live cokacdir / gh CLI 호출 0 (github_api 는 호출자가 inject; regression mock 가능). ) annotations) dataclass)AnyCallableFinalFRESHz Final[str] RESULT_FRESHSTALE RESULT_STALE NO_REVIEWRESULT_NO_REVIEWzFinal[frozenset[str]] ALL_RESULTSzgemini-code-assist[bot]GEMINI_BOT_LOGINlOz Final[int]CHAIR_REVIEW_ID_BLOCKED_FIXTUREceZdZdZy)FreshnessCheckerErroruB입력 schema 위반 (head SHA 형식 / github_api 호출 결과).N)__name__ __module__ __qualname____doc__J/home/jay/workspace/scripts/../anu_v2/gemini_evidence_freshness_checker.pyrr-sLrrT)frozencNeZdZUdZded<ded<ded<ded<ded <ded <y ) FreshnessResultucheck_gemini_evidence_fresh 결과 객체. fields: - status: ``FRESH`` / ``STALE`` / ``NO_REVIEW`` - pr_number: 평가된 PR 번호 - current_head_sha: PR 의 실측 HEAD (입력 그대로, lower 정규화) - gemini_commit_id_observed: 관측된 가장 최근 Gemini review commit_id (``NO_REVIEW`` 시 None) - reviews_inspected: 검사한 review 항목 수 (진단용) - reason: 분류 사유 (진단용) strstatusint pr_numbercurrent_head_sha str | Nonegemini_commit_id_observedreviews_inspectedreasonN)rrrr__annotations__rrrrr1s*  KN)) Krrct|trt|dk7rtd||j }t d|Drtd||S)N(z)head must be 40-char hex SHA string, got c3$K|]}|dv yw0123456789abcdefNr.0cs r z"_normalise_head..Ms 811& & 8z"head must be 40-char hex SHA, got ) isinstancerlenrlowerany)headlowereds r_normalise_headr7Gsf dC CIO#7x @  jjlG 8 88#0 9   Nrcnt|tsy|jdxs|jdxsi}t|tsy|jdxs|jdxsd}t|tsy|j j t j k(S)u회장 verbatim §1/§2: PR Review comment 는 Gemini trigger 가 아니지만, *Gemini bot 이 직접 post 한 review* 는 commit_id 추출용으로 검사한다. 빈 body / 회장 본인 review 등은 author login 으로 자동 배제. Fuserauthorloginname)r1dictgetrstripr3r)reviewr9r;s r_is_gemini_reviewrBTs fd # ::f  ;H!5 ;D dD ! HHW  7&!1 7RE eS ! ;;=   $4$:$:$< <.ms!P!!+="=!Pr0)r1r>r?rr3r2r4)rArDcid_norms r_extract_commit_idrHesg fd # ;'C6::l+CI i %Y H 8}c!Px!PP Orz(/repos/{owner}/{repo}/pulls/{pr}/reviewsr=)reviews_path_templateownerrepoc t|trt|ts|dkr tdt |}|j |xsd|xsd|} |d|}|tt||d dd St|ts!td t|jg} |D]-} t| st| } | | j| /| s&tt||d t|d t d S| d} | |k(r%tt"||| t|d|d dd Stt$||| t|d|d dd| d dd S#t $r} td|d| | d } ~ wwxYw)uGemini fresh evidence 판정. spec §3.1 1:1. Args: pr_number: 평가 대상 PR 번호 (positive int). current_head_sha: 실측 PR HEAD SHA (40-char hex). github_api: ``Callable[(method, path), payload]`` — REST 호출 추상화. regression mock 가능. reviews_path_template: reviews endpoint template. {owner}/{repo}/{pr} 치환. spec §2.6 1:1 — gh api 또는 동등 안전 경로. owner: GitHub owner (없을 시 빈 문자열 — github_api 가 처리). repo: GitHub repo (없을 시 빈 문자열). Returns: FreshnessResult — status (FRESH/STALE/NO_REVIEW) + commit_id observed. Raises: FreshnessCheckerError: 입력 schema 위반. rz pr_number must be a positive intOWNERREPO)rJrKprGETz!github_api invocation failed for z: Nu+github_api returned None — no review data)rr r!r#r$r%z$reviews payload must be a list, got zno Gemini bot review (author=z) with valid commit_id foundz0Gemini latest review commit_id matches PR HEAD (z...)z PR HEAD (z(...) != latest Gemini review commit_id (u...) — STALE)r1rboolrr7format Exceptionrr listtyperrBrHappendr2rr r )r r! github_apirIrJrK head_normpathpayloadexcgemini_commit_idsrAcidlatest_commit_ids rcheck_gemini_evidence_freshrars6 i %It)D UV#$FGG 01I ' 'w ^V  ( D UD) #&&*@    gt $#24=3I3I2J K  $&& (  ( ;   % & #&&*!'l/0@/AB((  ),9$&&6!'lB9Ra=/QUV   ""2g, "1 '*2A./~ ?  q #/xr# A  s E F)E;;FcDt|tsy|jdxs|jdxsd}t|tsy|j j dk7ry|jd}t|tsy|j dk(S)u회장 verbatim §1/§2/§3 — PR-backed issue comment body="/gemini review" 만 trigger 로 인정. spec §2.1 / §2.2 1:1 박제: - comment.kind == "issue_comment" (NOT "review_comment" / "review") - comment.body.strip() == "/gemini review" - author 가 owner allowlist 안 (호출자 enforce) task-2640 사고 박제: 회장 review id=4350214991 state=COMMENTED · empty body → kind="review" + body="" → False. Fkind comment_typer= issue_commentbodyz/gemini review)r1r>r?rr@r3)commentrcrfs ris_gemini_trigger_commentrhs gt $ ;;v  C'++n"= CD dC  zz|. ;;v D dC  ::<+ ++r) r r r rrrrrrarhN)r5rreturnr)rArrirS)rArrir")r rr!rrYzCallable[[str, str], Any]rIrrJrrKrrir)rgrrirS)r __future__r dataclassesrtypingrrrr r&r r frozensetrrr RuntimeErrorrrr7rBrHrarh__all__rrrrps(#!''# j"" j"***%.