nj!,UdZddlmZddlmZmZdZded<dZded<d Z ded <d Z ded <d Z ded<dZ ded<e ee e e e hZded<dZded<dZded<dZded<e hdZded<GddeZd&dZd&d Zd&d!Zd&d"Zd'd#Zgd$Zy%)(u?utils.ci_watch_handoff_schema — task-2642 CI_WATCH_HANDOFF JSON v1 schema. 회장 verbatim (2026-05-23 19:38 KST): ANU 는 CI/Gemini 를 직접 기다리지 않는다. PR open 이후 대기/감시/자동수렴은 반드시 bot 또는 watcher task 에 위임한다. 본 helper 책임 (system_ci_watch_handoff_runner_spec_260523.md §2 + 정책 spec §4/§5): - 12 필수 필드 1:1 박제 (pr_number / head_sha / branch / expected_files / forbidden_paths / watcher_owner / max_watch_minutes / poll_interval_seconds / gemini_nudge_policy / auto_remediation_policy / callback_on_terminal_state / terminal_states) - 5 terminal_states enum (MERGE_READY / CHAIR_REQUIRED / GEMINI_EXTERNAL_TRIGGER_STALE / CI_FAILED_NON_REMEDIABLE / LOOP_BOUNDARY) - validate_handoff(): contract 위반 시 SchemaError raise one-way isolation: utils/ 외부 import 0. live cokacdir / gh CLI 호출 0. frozen anchor: ANCHOR-1: 12 필수 필드 1:1 박제 (회장 verbatim §4) ANCHOR-2: 5 terminal_states enum (회장 verbatim §5) ANCHOR-3: gemini_nudge_policy.max_nudges_per_pr_head <= 1 hard limit (회장 verbatim §9, PR #144 NUDGE_HARD_LIMIT_PER_PR_HEAD 정합) ANCHOR-4: auto_remediation_policy.allow_severities ⊆ {medium, style, quality, non-critical-high} (회장 verbatim §8 watcher 책임) ) annotations)AnyFinalz utils.ci_watch_handoff_schema.v1z Final[str]SCHEMA MERGE_READYTERMINAL_MERGE_READYCHAIR_REQUIREDTERMINAL_CHAIR_REQUIREDGEMINI_EXTERNAL_TRIGGER_STALE&TERMINAL_GEMINI_EXTERNAL_TRIGGER_STALECI_FAILED_NON_REMEDIABLE!TERMINAL_CI_FAILED_NON_REMEDIABLE LOOP_BOUNDARYTERMINAL_LOOP_BOUNDARYzFinal[frozenset[str]]ALL_TERMINAL_STATES) pr_numberhead_shabranchexpected_filesforbidden_paths watcher_ownermax_watch_minutespoll_interval_secondsgemini_nudge_policyauto_remediation_policycallback_on_terminal_stateterminal_stateszFinal[tuple[str, ...]]REQUIRED_FIELDSxz Final[int]DEFAULT_MAX_WATCH_MINUTES<DEFAULT_POLL_INTERVAL_SECONDS>non-critical-highstylemediumquality#ALLOWED_AUTO_REMEDIATION_SEVERITIESceZdZdZy) SchemaErroru3CI_WATCH_HANDOFF JSON 의 schema / contract 위반.N)__name__ __module__ __qualname____doc__4/home/jay/workspace/utils/ci_watch_handoff_schema.pyr)r)Ms=r/r)cVt|txrt|t xr|dkDSNr isinstanceintboolvalues r0_is_positive_intr9Qs' eS ! O*UD*A&A OeaiOr/cVt|txrt|t xr|dk\Sr2r3r7s r0_is_non_negative_intr;Us' eS ! P*UD*A&A PeqjPr/cjt|txr"t|dkDxrtd|DS)Nrc3DK|]}t|txr|ywNr4str.0xs r0 z,_is_non_empty_string_list..]s8Q 1c"(q(8 )r4listlenallr7s r0_is_non_empty_string_listrIYs45$ 9 JN 9 8%8 8r/cJt|txrtd|DS)Nc3DK|]}t|txr|ywr>r?rAs r0rDz._is_string_list_allow_empty..bs$+%& 1c q +rE)r4rFrHr7s r0_is_string_list_allow_emptyrLas* eT " s+*/+(r/c t|ts!tdt|jt Dcgc] }||vs| }}|rtd||d}t |s td|d}t|trt|dk7r td|j}td|Dr td |d }t|tr|js td |d }t|s td |d}t|s td|d} t| tr| js td|d} t | s td|d} t | s td|d} t| ts tdd| vst| dts td| jdd} t!| s td| dkDr td| jdd}|dk7r td |d!}t|ts td"d|vst|dts td#|jd$g}t|t"s td%|D]8}t|tr |t$vstd&|d't't$|d(}t|ts td)|d*}t|t"r|s td+|D](}|t(vs td,|d't't(t|}||d<|Scc}w)-usCI_WATCH_HANDOFF JSON 의 contract 검증 + 정규화. Args: handoff: 검증 대상 dict (12 필수 필드 포함). Returns: 정규화된 handoff dict (head_sha lower). Raises: SchemaError: 12 필수 필드 누락 / 타입 위반 / 5 terminal_states enum 위반 / nudge hard limit 위반 / severity 화이트리스트 위반. zhandoff must be dict, got zmissing required fields: rzpr_number must be positive intr(z#head_sha must be 40-char hex stringc3$K|]}|dv yw)0123456789abcdefNr.)rBcs r0rDz#validate_handoff..s :11& & :sz-head_sha must be 40-char hex (a-f / 0-9 only)rzbranch must be non-empty stringrz4expected_files must be non-empty list[non-empty str]rz+forbidden_paths must be list[non-empty str]rz&watcher_owner must be non-empty stringrz&max_watch_minutes must be positive intrz*poll_interval_seconds must be positive intrz gemini_nudge_policy must be dictenabledz(gemini_nudge_policy.enabled must be boolmax_nudges_per_pr_headzCgemini_nudge_policy.max_nudges_per_pr_head must be non-negative intucgemini_nudge_policy.max_nudges_per_pr_head must be <= 1 (회장 verbatim §9 nudge 1회 hard limit)on_403reportuPgemini_nudge_policy.on_403 must be 'report' (회장 verbatim §8 NUDGE_403 path)rz$auto_remediation_policy must be dictz,auto_remediation_policy.enabled must be boolallow_severitiesz5auto_remediation_policy.allow_severities must be listzCauto_remediation_policy.allow_severities contains invalid severity z ; allowed=rz'callback_on_terminal_state must be boolrz&terminal_states must be non-empty listz&terminal_states contains invalid enum )r4dictr)typer*rr9r@rGloweranystriprIrLr6getr;rFr'sortedr)handoffkmissingprhead head_normrrrrmwmpisgnp max_nudgesrUarp severitiessevcbtermsterm normalizeds r0validate_handoffrpgs gt $(g)?)?(@ A  *>QQg-=q>G>5gY?@@  B B :;; : D dC CIO?@@ I : ::IJJ X F fc "&,,.;<<-.N $^ 4PQQ/0O & 7GHHO,M mS )1D1D1FBCC % &C C BCC ) *C C FGG ' (C c4 <==:c)nd#CDEE115J  + Q  A~ :  WWXx (F  ^   + ,C c4 @AA:c)nd#CHII+R0J j$ 'QRR#s#s2U'U7*=>?A  - .B b$ CDD % &E eT "%BCC * *8A!"5679 gJ&Jz }?s M%M%) rrr r rrrrr r"r'r)rpN)r8rreturnr6)r_rrqrX)r- __future__rtypingrrr__annotations__rr r rr frozensetrrr r"r' ValueErrorr)r9r;rIrLrp__all__r.r/r0rxs2#8 7$1j0&665T& T0J!:J%4 4-6.) .* +'  ),:+,.z.>G7>#%: >*>PQ pf r/