jYdZddlmZddlZddlmZmZmZmZm Z m Z m Z m Z m Z ddlmZmZdZdZdZd Zd Zd Zd Zd ZdZdZej6ddj9ezdzdj9ezdzZdZej6dezdzdj9ezdzZej6ddj9ezdzej@Z!ej6ddj9ezdzZ"d#dZ#d$dZ$ d%dZ% d&dZ& d'dZ' d( d)dZ( d*dZ) d+d Z* d,d!Z+gd"Z,y)-ushot_director ↔ shot_staging visible/off-camera reconciliation helpers. 2 종류의 deterministic detector: 1. **Producer-side (description-only)** — `detect_gaze_pattern_exclusions`: shot_director 가 shot_staging 결과를 보지 못한 채 LLM emit 한 visible_entity_ids 와 비교하기 위한 lexicon-based diagnostic candidate 추출. Area #3 v1: production decision 권한 없음 (audit field 만 emit, `shot_director.py:182-201` mutation 폐기). 2. **Consumer-side hybrid (Path 1, structured + OFFSCREEN_RE gate)** — `detect_offscreen_drift_structured`: shot_staging v13 의 character_angles [].gaze_direction_kind=="looks_at_character" + gaze_target_id 와 camera_direction 의 OFFSCREEN_RE coarse gate 를 조합. blocking-eligible (`VisibleStagingDriftError` raise). 3. **Consumer-side proximity diagnostic (Path 2, NL fallback)** — `detect_offscreen_drift_proximity_diagnostic`: camera_direction NL proximity 윈도우 안 character name → drift candidate. Diagnostic only (caller-side `logger.warning`). Path 1 (structured) miss 또는 character_angles 부재 시 보조. Area #3 v1: 이전 merged drift helper 단일 함수 폐기 + Path 1/2 분리. Path 2 production blocking 권한 제거. mode= param 금지 (silent coupling 회피). ) annotationsN) AnyDictIterableListMappingOptionalSequenceSetTuple) resolve_visible_character_targetvalidate_pairing) u 올려다보u 내려다보u 응시하u 바라보u 쳐다보u 마주보u 노려보u 뒤돌아보u 돌아보)u다u는u며u면서u고u다가u면) u얼굴눈눈빛u표정u상체u 뒷모습시선u 옆얼굴u 옆모습정면).u어깨u팔u팔뚝u 팔꿈치u손u손목u 손바닥u손등u 손가락u다리u 허벅지u무릎u 정강이u발u발목u 발바닥u 발가락u등u허리u 엉덩이u 옆구리u가슴u배u골반u머리u 머리카락u이마u턱u뺨u볼u광대u 관자놀이u목u 목덜미u 후두부u 뒤통수u입u입술u혀u잇몸u이빨u귀u코u콧등u피부u살갗)u 쪽으로u쪽을u향해u향한u 향하여u쪽에u 방향으로)u고개ru눈길rr) u 클로즈업zClose-upzclose-upzClose upzclose upCUru구도u익스트림 클로즈업ECU)zoff[\-\s]?camerazoff[\-\s]?screen offscreenzout[\-\s]?of[\-\s]?framezout[\-\s]?of[\-\s]?shotu 화면\s*밖u프레임\s*밖u카메라\s*밖<z(?:|z)(?:)u&[가-힣A-Za-z][가-힣A-Za-z\s]{0,20}z(?Pu)\s*[의가]\s*(?:u 의\s*(?:z)$cttjd|}|syt|D]:}|j dj }t j|r8|cSy)ugaze verb 직전 텍스트에서 마지막 [를을] 앞 명사구 추출. "굳은 표정으로 남자 직원을 " → "남자 직원" (마지막 [을] 앞). 매칭 없으면 "". Body-part possession 차단: 매치된 명사구가 "X의 [BODY_PART]" 형태이면 SUBJECT 의 부분 묘사이지 gaze TARGET 이 아니므로 skip 하고 그 이전 매치로 fallback. 모두 body-part 면 "" 반환 (TARGET 미달). u3([가-힣A-Za-z][가-힣A-Za-z\s]{0,20})\s*[를을])listrefinditerreversedgroupstrip_BODY_PART_POSSESSION_REsearch)text_before_verbmatchesmspans Z/Users/manta/Documents/Projects/TheRoad-I1/backend/app/modules/pipeline/shot_visibility.py_last_object_targetr*sg2;;>G  g wwqz! # * *4 0   cptj|}|sy|jdjS)ugaze verb 다음 텍스트에서 첫 Y[의] FRAMING 의 Y 추출. "눈망울이 붉게 젖은 수리영의 얼굴 클로즈업" → "수리영". rwho)KOREAN_FRAMING_REr$r!r")text_after_verbr's r)_first_framing_subjectr0s1   1A  775>   !!r+c8tfdtD}|s itfStfdtD}|s itfStj }|s itfS|j dj}|r|jdnd}t}|r@|jD]-\}} |s t|dk\s||vs|j| /i} tD]} d} j| | } | dk(rtd| dz }|| }d \}}}|jD]7\}} |rt|dks| |vr|j|}||kDs2|| |}}}9| || vr|| |<| t| z} | |fS) ugaze verb 가 명시 안 된 close-up 패턴 fallback. 4-token 게이트 — 모두 매치되어야 발동: 1. close-up marker (`클로즈업` / `정면` / `구도` / CU 등) 2. gaze noun (`고개` / `시선` / `눈길` / `눈빛`) 3. framing pattern (`SUBJECT의 [얼굴/눈/...]`) 4. directional phrase (`TARGET 쪽으로/향해/...`) — TARGET 직전 30 chars 이내 character name. 예: "혜수 쪽으로 고개를 든 수리영의 얼굴 클로즈업" → close-up 마커 클로즈업, gaze noun 고개, SUBJECT 수리영, TARGET 혜수. Returns: (excluded_dict, subject_id_set). 게이트 미달 시 ({}, set()). c3&K|]}|v ywN).0r' descriptions r) z._detect_directional_pattern..sC1BAqK'1Bc3&K|]}|v ywr3r4)r5gr6s r)r7z._detect_directional_pattern..s>+Q[(+r8r-rrr)r;Nr)any_CLOSE_UP_MARKERSset _GAZE_NOUNSr.r$r!r"splititemslenadd_DIRECTIONAL_TAILSfindmaxrfind)r6 name_to_id has_close_up has_gaze_noun framing_matchwho_full subject_tokensubjectsnamesidexcludedd_phrasestartidx window_startwindowbest_idxbest_sid best_nameposs` r)_detect_directional_patternr\s$C1BCCL 35y>+>>M 35y%,,[9M 35y ""5)//1H,4HNN$R("MH#))+ID#D Q4=+@ S!, "H&""8U3Cbyq#(+L c2F,8 )Hh '--/ cs4y1}xll4(>47d hH 0 #(@%."#h-'E!'( X r+c|r|siSi}t}tj|D]}|d|j}||j d}t |}t |}|r|sD|jD]-\} } | s t| dk\s| |vs|j| /|jD]%\} } | rt| dkr| |vs| |vs!| || <'|s6t||\} } || z}| jD]\} } | |vs | || <|jD cic] \} } | |vs | | c} } Scc} } w)udescription 에서 close-up gaze 패턴이 가리키는 gaze TARGET (offscreen) 을 추출. Two paths (둘 다 고신뢰 게이트): 1. **gaze verb path** — `KOREAN_GAZE_VERB_RE` 매치 + `_KOREAN_FRAMING_NOUNS` 매치 둘 다 있어야 함. body-part possession (`X의 어깨/손/팔/...`) 은 `_last_object_target` 단계에서 skip 되어 SUBJECT 부분 묘사 false-trigger 차단 (S12_Shot13). 2. **directional path** — gaze verb 가 명시 안 된 close-up 케이스. close-up marker + gaze noun + framing + directional phrase 4-token 모두 매치 의무. TARGET 은 directional phrase 직전 30 chars 윈도우 안 character name (S12_Shot4: "혜수 쪽으로 고개를 든 수리영의 얼굴 클로즈업"). Args: description: shot 묘사 한국어 텍스트. name_to_id: {entity_name → short_id} (scene_ve 기준). Returns: {short_id → matched_name} — visible 에서 제외할 entity. 빈 dict = 패턴 미매치 / 안전. Nr<) r?KOREAN_GAZE_VERB_RErrTendr*r0rBrCrDr\)r6rIrRrOgv_matchbeforeafter target_span subject_spanrPrQ d_excluded d_subjectsnms r)detect_gaze_pattern_exclusionsrhsl4 j !HH(00=.hnn./HLLNO,)&1 -e4 , $))+ID#D Q4<+? S!,$))+ID#3t9q={"s(': $ ,>, !< "  J J!'')GC(" " * $,>>#3 K#3Rs(7JCG#3 KK Ks 1 E>Ec8|siSttj|}|siSi}t|}i}|D];}|j |xsdj } | rt | dkr7||| <=t} |rq|D]l} t| ts| j dxsdj } | rt | dkrH|j | }|s\| j|n|r|D chc](} | jdr| ddjr| *}} |D]h} t| ts| d}|dk7r| j d }t||d t|||d }|P|\}}||vsZ||vs_|| vsd|||<j|Scc} w) uPath 1 — hybrid gate (camera_direction OFFSCREEN_RE + structured gaze_target_id). Gate 1: camera_direction MUST contain explicit offscreen phrase (OFFSCREEN_RE match). Frame-internal mutual gaze 정상 (drift 아님). Gate 2: character_angles[].gaze_direction_kind == "looks_at_character" with valid gaze_target_id resolved against visible_set (Q7 dispatch helper, structural validation only — name matching X). In-frame guarantee: character_angles[].character == visible canonical_name 인 sid 는 drift 후보에서 영구 제외. Both gates required. Returns blocking-eligible drift entities. rr< characterCrNgaze_direction_kindlooks_at_charactergaze_target_idzshot_visibility.path1)where)r OFFSCREEN_RErr?getr"rC isinstancedictrD startswithisdigitrr ) visible_idscamera_directioncharacter_angles id_to_name off_matchesdrift visible_setname_to_visible_sidrQrg in_frame_sidscach_sidvisible_character_idskind target_idresolvedrPs r)!detect_offscreen_drift_structuredr<s&  |,,-=>?K  Ek"K+-nnS!'R . . 0SWq[ "%B "eM"Bb$'&&%+224BR1%))"-C!!#&#(! (Ts#QR(8(8(: [ ! #Bb$'+,D++/0I T94K L7%- H  IC{"u$},!c -#0 L9! s9-Fc\|siSttj|}|siSi}t|}i}|D];}|j |xsdj } | rt | dkr7||| <=t} |rq|D]l} t| ts| j dxsdj } | rt | dkrH|j | }|s\| j|n|D]3} td| jtz }||| j}d}d}d}|D]\}||vs|| vr |j |xsdj }|rt |dkr@|j|}||kDsW|}|}|}^||||<tt || jt z}|| j|}|D]K}||vs|| vr |j |xsdj }|rt |dkr@||vsE|||<36|S)uPath 2 — camera_direction OFFSCREEN_RE + proximity NL fallback. Diagnostic only (caller MUST log/warning, MUST NOT raise). character_angles (optional) provides in_frame_guarantee against false-positive. rr<rjrr;N)rrprr?rqr"rCrrrsrDrGrT_PROXIMITY_PRErHminr__PROXIMITY_POST)rvrwryrxrzr{r|r}rQrgr~rromwspre_textrXrYrZrPrUwe post_texts r)+detect_offscreen_drift_proximity_diagnosticrsG  |,,-=>?K  Ek"K+-nnS!'R . . 0SWq[ "%B "eM"Bb$'&&%+224BR1%))"-C!!#&# BHHJ/ 0#Brxxz2 Ce|sm3NN3'-2446D3t9q=..&CX~   'E(O  %&?(B C$RVVXb1 Ce|sm3NN3'-2446D3t9q=y !c /@ Lr+ci}|r|s|Stj|s|St}|D]J}t|ts|j dxsdj }|s:|j|L|xsdj } |D]k} t| tr| jds%|j | xsdj } | sK| | k(s| | k(rV| |vr[| |vrdnd} d| d|| <m|S)uC10 Phase 1 — visible 후보 인물 중 후행 staging 이 화면 밖/부재로 연출한 인물을 결정론적으로 식별. Hard gate (전부 필요): 1. C## 가 visible character 후보. 2. character_angles 가 non-empty (producer 가 필드를 채웠음). 3. 그 인물의 canonical name 이 character_angles[].character 에 없음. 4. 그 인물이 POV character 가 아님. 5. camera_direction 에 OFFSCREEN_RE 매치 존재. `gaze_direction_kind == "off_screen"` 은 의도적으로 사용하지 않음 — schema 상 시선 방향이지 인물 가시성 결정이 아니다 (in-frame 인물도 off_screen gaze 가능). Returns: {subject_id: reason}. reason 에 confidence 태그("named" = canonical name 이 camera_direction 에 등장 / "structural" = 구조 신호만) 를 provenance 로 포함. 다운그레이드 동작에는 영향 없음. rjrrknamed structuralzscreen_presence_reconciliation: visible candidate absent from character_angles, non-POV, camera_direction off-screen reference (confidence=r) rpr$r?rrrsrqr"rDstrrt) rvrwrxry pov_characterresult angle_namesrrpovrQrP confidences r)$detect_offscreen_referenced_subjectsrs4 F #3   / 0 EK b$ &&%+224B#   B % % 'C3$)< s#)r002  #:  ;   $(8 8Wl  %,a ) s " Mr+c|xsdj}g}|xsgD]h}t|ts|jdxsdj}|r||k(r?|j|}|sS||vsX|j |j|S)u촬영 계획(shot_staging)이 **화면 안에 세운** 등록 인물의 entity id — `detect_offscreen_referenced_subjects` 의 반대 방향. 실측(컨트리로드 2판, 2026-09-19): shot_director VE 에는 없는데 character_angles 에는 있는 등록 인물이 선택 샷 239개 중 35쌍이었다. 조립 문안(카메라 지시)은 그 인물을 화면에 세우는데 참조가 안 실려, 로봇 찰리가 **사람 뒷모습**으로 그려졌다(S60sh4·S64sh7). - 이름 → id 는 정확한 이름 조인이다(구조 필드 — 뜻 판단 아님). 호출자는 같은 이름이 둘 이상인 인물을 `id_by_name` 에서 **빼고** 넘긴다. - POV 인물(카메라가 그 사람의 눈)은 화면 밖이라 뺀다. - 정본에 없는 이름(단역·군중)은 건너뛴다. 반환 순서는 character_angles 순서, 중복 없음. rrj)r"rrrsrqappend)rx id_by_namerroutrrPeids r)staged_in_frame_character_idsrs(  B % % 'CC$"$"d# {#)r002ts{ nnT" 3c> JJsO% Jr+c 6i}|D]H\}}|xsdj}|s|s |j|tj|J|j Dcic])\}}t |dk(s|t t|+c}}Scc}}w)u(entity id, 이름) → {이름: id}. **같은 이름이 둘 이상이면 뺀다** — 어느 쪽인지 모르는 이름을 한쪽에 붙이면 남의 참조가 실린다.rr)r" setdefaultr?rDrBrCnextiter) charactersseenrrPrgidss r)unique_character_ids_by_namer;s !#D Tjb   ! 2 OOB & * *3 / 04zz| M|GBs3x1}BT#Y | MM Ms #B:B) rprrrr^r.rhrr)r%rreturnr)r/rrr)r6rrIMapping[str, str]rzTuple[Dict[str, str], set])r6rrIrrDict[str, str]) rv Sequence[str]rwrrxSequence[Dict[str, Any]]ryrrrr3) rvrrwrryrrxz"Optional[Sequence[Dict[str, Any]]]rr) rvrrwrrxrryrr Optional[str]rr)rxrrrrrrz List[str])rzIterable[Tuple[str, str]]rr)-__doc__ __future__rrtypingrrrrrr r r r app.core.gaze_directionr r_KOREAN_GAZE_STEMS_KOREAN_GAZE_TAILS_KOREAN_FRAMING_NOUNS_BODY_PART_NOUNSrEr@r>_OFFSCREEN_PHRASESrrcompilejoinr^_NAME_FRAGMENTr. IGNORECASErpr#r*r0r\rhrrrrr__all__r4r+r)rs4# UUUM "h>  !bjj SXX( ))-  XX( )*,01 ;BJJ. $  XX+ ,-/34 rzz SXX( ))D0MM &2::388,--5 0"==!= =@BLBL!BLBLTOOO/O" O  Ol<@ KKK"K9 K  K\:::/:" : ! :  :z.!! D N) N N r+