_jJUdZddlmZddlZddlZddlmZmZmZm Z m Z m Z ddl m Z mZejeZdZded<d Zded <d Zd Zd ZdZded<dZded<dZdZe eefZdqdZdrdZ dsdZ dtdZ!dd dudZ"dvdZ#dwdZ$ddd dxd Z%dyd!Z&dzd"Z' d{d#Z(d|d$Z)d}d%Z*d~d&Z+dd'Z,dd(Z-d)Z.d*Z/d+Z0d,Z1dd-Z2dd.Z3dd/Z4dd0Z5dd1Z6dd2Z7dd3Z8 dd4Z9 dd5Z: dd6Z;dd7Z< dd8Z=d9d: dd;Z>gd<Z?d=ed><d?Z@d@edA<dBZAd@edC<dDZBd@edE<ddF ddGZCdHZDdedI<dJZEdedK<dLZFdedM<dNZGdedO<dPZHdedQ<ddRZIddSZJddTZKddUZL ddVZMddWZNdXZOdedY<ddZZP dd[ZQd\ZRded]<d^ZSded_< d dd`ZTddaZU ddbZVddcZW dddZX ddeZY d ddfZZ d ddgZ[dhdhdhdidididjZ\ddkZ] ddlZ^ddmZ_ ddnZ` ddoZa ddpZby)uMW21B-W8 (2026-06-12) — outdoor_site_layout deterministic core. B-run 피드백 "가는 방향/멀어짐 구분 못함" 의 production fix. ablation 실측 (spike_gallery 21~24절): 텍스트 위치 구절이 지배 변수, top-down 이미지는 ref 채널로 무력 → 좌표는 **텍스트 생성의 입력** 으로만 쓴다 (FP→VLM→T2I 패턴). 이 모듈은 순수 deterministic 영역만 담는다: - seed 탐지 (LLM 0): selected shot × outdoor(background_classify ``is_indoor == false`` structured) × staging ``character_angles`` 2인+. 제외는 전부 structured 조인 — zoom continuity 멤버 (shot_dependency_t2i ``ref_usage == "zoom_in_detail"`` pair), 1인 이동(frame_spatial_contract ``gesture_action == "moves_toward"`` enum). 이동 동사 regex / 단어 의미 판별 절대 금지. - layout 좌표 validator: **shape/범위만** (의미 게이트 없음 — 의미는 visual canary. Codex W21B_W8 ⓔ). - 카메라-인물 거리/방향 deterministic 공간 요약 (LLM2 입력). - revised prompt 토큰 audit (W-C1 ``revised_prompt_new_tokens`` 재사용 + 기존 토큰 누락 검사 — entity ID 불변 계약). - prompt override 명시적 priority merge: custom > zoom > site > original (custom 은 별도 분기 선행 승리, original 은 override 부재). LLM IO 는 ``outdoor_site_layout_provider`` 가 담당. 작문 품질은 deterministic 테스트 비대상 — canary + 육안 gate. 설계: docs/w21b-w8-outdoor-site-layout-production-brief-20260612/ (Codex W21B_W8_SITE_LAYOUT_DESIGN_REVIEW=APPROVED_WITH_NARROW_SCOPE). ) annotationsN)AnyDictListOptionalSetTuple)extract_entity_tokensrevised_prompt_new_tokensintSCHEMA_VERSIONDEFAULT_GROUP_CAPzoom_in_detail moves_toward characterfloat COORD_MINgY@ COORD_MAXzoom_continuity_anchoroutdoor_site_layoutstrc|d|S)N:) scene_index shot_indexs c/Users/manta/Documents/Projects/TheRoad-I1/backend/app/modules/pipeline/outdoor_site_layout_plan.py shot_hint_keyr!:s]!J< ((ct}|xsgD]f}|jdxsgD]L}|jd}t|ts%|s(|jddus<|j |Nh|S)ubackground_classify building_groups → ``is_indoor == false`` loc_id 집합. structured field 조인만 — label/summary 텍스트는 보지 않는다.membersloc_id is_indoorF)setget isinstanceradd)background_classify_groupsoutgmr%s r outdoor_loc_idsr/AssEC ' -2 -y!'R'AUU8_F&#&6aeeK6HE6Q(. Jr"czi}|xsijD]I\}}t|tr|jddk7r+|jd}|s?||vrdn|||<Ki}|xsijD]?\}} t|tr| |xs t vr'|j| }|s;|||<A|S)uB (2026-07-02) — scene_index → outdoor primary location 의 entity UUID. scene_director.primary_location(L## short_id)이 outdoor 집합(background_ classify is_indoor==false)에 속하고 entity_lookup 역매핑(entity_type== 'location' AND short_id 일치)이 존재할 때만 매핑. structured field 조인만 — 이름/라벨 텍스트는 보지 않는다. 역매핑 충돌(같은 short_id 2+)은 제외(결정론). entity_typelocationshort_idN)itemsr)dictr(r r') primary_location_by_sceneoutdoor_loc_sids entity_lookup sid_to_uuiduidentsidr,sipls r primary_location_uuid_by_scener?Ns-/K"(b//1S#t$ (>*(L ggj! #&+#543 C2C,299;B"c"b1A1JSU&K oob! CG < Jr"cht|tsy|xsij|}|r ||xsivr|Sy)uB — VE 에 location 이 없어 history lookup 을 놓친 outdoor 샷의 primary location UUID fallback. history 에 실재하는 entry 가 있을 때만 반환.N)r)r r()rprimary_loc_uuid_by_scenelocation_scene_historyr:s r %resolve_outdoor_history_fallback_uuidrCls> k3 ' $ * / / NN @ !*SU.>> ?  $$ +#'N19-t*%-T3T=d;O6P   r"ct}|xsgD]}|jd|jd}}t|trt|tsF|jdxsgD]}|jdtk7r|jd|jd}}|j ||ft|tsbt|tss|j ||f|S)ushot_dependency_t2i dependencies 에서 zoom_in_detail pair 의 양쪽 (zoom + source) shot key 집합 — site seed 제외 신호 (이중 재작문 방지; merge 우선순위가 2차 방어).rr location_refsrT)r'r(r)r REF_USAGE_ZOOMr*) dependenciesr,rHr=shirefsrc_sisrc_shis r zoom_member_shotsrasC!r!''-(#'',*?C"c"*S#*> 77?+1r1Cww{#~5!ggm4cggl6KGF GGRI &#&:gs+C)* 2 " Jr"c|jdxsg}t|dk7ry|jdxsijdxsg}td|DS)u1인 + 이동 — structured enum 조인만 (frame_spatial_contract constraint: target_kind == character AND gesture_action == moves_toward).character_anglesr Fframe_spatial_contract constraintsc3K|]6}|jdtk(xr|jdtk(8yw) target_kindgesture_actionN)r(TARGET_KIND_CHARACTERGESTURE_MOVES_TOWARD).0cs r z3_staging_is_single_figure_moving..sFA m 55 < EE" #'; ; <s<>)r(lenany)staginganglesres r _staging_is_single_figure_movingrrsh[[+ , 2F 6{a;;78>BCCMRXVXK  r")r6single_shot_lane_enabledci}g}i} |xsi} t|D]} t|| D]} | | f} tfd|j| xsgD}d}|s|r| j| }|r |vr|g}d}|sT|j| xsi}d| d| }| |vr|j|dd|jdxsg}t|}|d kr"|s t |r|j|d dt|d kDr|j|d ||d d|d }|j |gj| |jd}t t|txr|jdxsg}|d k(rdn|d krdnd||||jd||d|jddufd|d kDfd|fdtd|DffDcgc] \}}|r| c}}d| | <||| fScc}}w)useed: outdoor selected shot → {loc_id: [shot_key…]}. 반환: (groups, skipped, seed_meta). **legacy(single_shot_lane_enabled=False, default)**: v1 그대로 — outdoor × character_angles 2인+ frame-visible location 만. byte-identical. **broad single-shot lane(single_shot_lane_enabled=True, 4a fix 2026-07-01, Codex 합의)**: 사용자 요구 "한샷이라도 구도/복잡이면 실내외 무조건 마네킹" — 복잡샷이 seed 에서 조용히 탈락하지 않게 넓게 연다(판정은 judge/QC fail-closed). - figure_count>=1 이면 단일 figure 샷도 seed(2인+ 요구 제거). - location source: frame_visible(VE 에 L##) → 없으면 primary_location fallback (scene_director.primary_location, outdoor 일 때만). location_source 기록. - ★코드는 free-text(camera_direction 등) 의미판정 안 함 — 구조필드 존재/count/ enum 만. seed_meta 에 why_candidate/구조 signal 기록(judge/과발동 튜닝 SOT). - figure 0 = no_figure skip(마네킹 대상 아님). skipped 진단(silent drop 금지): zoom_continuity_member / single_figure_moving (legacy 만) / no_figure(broad) / multiple_outdoor_locations. c3,K|] }|vs| ywNr)rktok outdoor_locss r rmz$detect_site_seeds..s 9c\>Q 9s  frame_visibleprimary_locationSshzoom_continuity_member)shotreasonrcsingle_figure_movingr multiple_outdoor_locationsr)r~r locationschosenrdresingle_shot_outdoor_no_figure"single_shot_outdoor_figure_present"cross_shot_or_multi_figure_present framing_scaleNgaze_directionc3>K|]}|jdyw)gaze_direction_kindNr()rkas r rmz$detect_site_seeds..7s/JBHQAEE"78&s) why_candidatelocation_source location_id figure_countrcharacter_angle_countframe_spatial_contract_present!available_structural_signal_names) sortedr(appendrnrr setdefaultrQr)r5ro) selected_map ve_by_shotstaging_by_shotrx zoom_membersr6rsgroupsskipped seed_meta_plr=r]keylocsr_plcrplabelrqrr_fsc _fsc_present_n_presents ` r detect_site_seedsrs<(*F$&G/1I # )rC\",r*+Cs)C *s 3 9r 9D.O4 wwr{DL0 6D&8O%))#.4"Gt2cUOEl"9QRS[[!34:Fv;La/7@AW'XY4y1}!:!%"1g   !WF   fb ) 0 0 5;;78D4&JDHH],C,IrLL8Dq7H3BNQRBR>C#2% ,!(_!=)52>)'++o*Fd*RS+\A-=>1<@)3/JBH/J,JK ,6,<2x " ,6IcN_,#L 7I %%6s#Hct|ttfxr6t|dk(xr&t d|Dxrt d|DS)Nrc3nK|]-}t|ttfxrt|t /ywrv)r)r rrQrkvs r rmz_is_point..Gs0WQVA 1sEl+GJq$4G0GGQVs35c3^K|]%}tt|cxkxr tknc'ywrv)rrrrs r rmz_is_point..Hs"BEq U1X222Es+-)r)listtuplernall)values r _is_pointrCsQ54-( C J!O C WQVW W C BEB B r"c ng}t|tsdgS|jd}t|ts|j dnt |D]\}}|xsijd}t|tr|rt d|Ds|j d|d|xsijd}|lt|rx|j d|d |jd }t|tr|s|j d nt |D]\}}t |xsijd xsgD]\} } t| jd ts|j d|d| dt| jds|j d|d| d| jd} | t| r|j d|d| d|jd} t| tr| s|j d|St | D]{\}} t| xsijd ts|j d|ddD]9}t| xsij|r"|j d|d|d;}|S)ushape/좌표 범위만 검증 — 의미 게이트 없음 (Codex ⓔ). Returns: violation 문자열 목록 (빈 목록 = 통과).zlayout must be an object landmarkszlandmarks must be a listpointsc32K|]}t|ywrvrrkps r rmz'validate_site_layout..ZsE&, ! fz landmarks[z&]: points must be [x,y] pairs in 0-100 faces_towardz.]: faces_toward must be [x,y] in 0-100 or nullfiguresz figures must be a non-empty list positionsrzfigures[z ].positions[z]: shot_index must be intposz]: pos must be [x,y] in 0-100 moving_towardz/]: moving_toward must be [x,y] in 0-100 or nullcamerasz cameras must be a non-empty listzcameras[)rlook_atz]: z must be [x,y] in 0-100) r)r5r(rr enumeraterrr )layout violationsrilmrftrfigj pos_entrymtrcamfields r validate_site_layoutrLsJ fd #*++ ;'I i &45y)EArhB^^H-Ffd+6E&,EB!!Jqc1W"XY(/B~im!! #QRT*jj#G gt $G<=(FAs )39"//+*F*L" M 9!)-- "=sC%%<sB[&\] u!56%%<sB_&`a]]?3>)B-%%"1#\!4cd!N)jj#G gt $G<=  (FAssybool;SA!!HQC/H"IJ+ #)!78%%3ug=T&UV,) r"c|jdxsgDchc]2}t|jdtr|jd4}}t||z Scc}w)Nrr)r(r)r r')rmember_shot_indicesrpresents r camera_missing_shotsrsi ::i(.B..C cggl+S 1  .  " #g -- s7Actjt|dt|dz t|dt|dz S)Nrr )mathhypotr)rbs r _distrs= ::eAaDkE!A$K/qtuQqT{1J KKr"ct|dt|dz t|dt|dz f}t|dt|dz t|dt|dz f}tj|xsd}tj|xsd}|d|dz|d|dzz ||zz }|dkDry|dkryy) u카메라 시선축 기준 프레임 좌/우/중앙 — 2D 외적 부호 (순수 기하). 화면 좌표 관례: 시선축 기준 반시계(외적 양수)=왼쪽.rr ?g?leftgɿrightcenterrrr)cam_posrpointaxisrelaxis_nrel_ncrosss r _frame_siders '!* gaj 1 153DuWUVZGX3X YD q?U71:. .eAh%PQ BS0S TC ZZ  %#F JJ  #E !Ws1v Q#a& 0 0Ve^ DE t| u} r"c  tj|xsd}tj|xsd}|d|dz|d|dzz||zz }tjtjt dt d|S)Nrrr g)rrdegreesacosmaxmin)v1v2n1n2dots r _angle_betweenrsv R CB R CB a52a5=2a52a5= (R"W 5C << #dCSM":; <@g$@c|d|ddf}tt|D]E}t|dzt|D](}t||||}||dkDs|||||f}*G|S)uG점 집합의 최장 쌍 = landmark 의 주축 segment (순수 기하).rrr r)rangernr)rbestrrrs r _extent_segmentr s| 1Ivbz3 'D 3v; q1uc&k*AfQi+A47{q 6!9a0+ Kr"cXt|dt|dt|dt|df\}}}}||z ||z }}tj||xsd} d} |D]C} tt| d|z |zt| d|z |zz | z } t | | } E| S)u점들이 주축 a→b 무한직선에서 벗어난 최대 수직거리 = landmark 의 '폭' (순수 기하). extent/width = 종횡비 → 경로성 판정에 쓴다.rr rr)rrrabsr) rrraxaybxbydxdydenomwrrs r _max_perp_widthrs1Q4[%!+uQqT{E!A$KGNBB "Wb2gB JJr2  %#E A  qtr!R'51;+;r*AA BU J 1I Hr"c jt|dt|d}}t|d|z t|d|z }}||z||zz}|dk(r t||Stdtdt|d|z |zt|d|z |zz|z }t||||zz|||zzfS)Nrr rr)rrrr) rrrr rvxvyseg_len2ts r _point_segment_distrs 1Q4[%!+B 1Q4[2 uQqT{R/BBwb H1}Q{ CSE!A$K",2eAaDkB6F"5LLPXXYZA R!b&["q2v+. //r"ct|dkryd}tt|D]S}||\}}||dzt|z\}}|t|t|zt|t|zz z }Ut|dz S)Nrr @)rnrrr )rsrx1y1x2y2s r _polygon_arear$s 6{Q A 3v; BQ#f+-.B U2Yr "U2Yr%: ::  q6C<r"ctt|xsd}td|D|z td|D|z fS)Nr c38K|]}t|dywrNrrs r rmz_centroid..,Vad Vc38K|]}t|dywr Nr(rs r rmz_centroid..r)r*)rnsum)rns r _centroidr/s@ F qA ,V, ,q 0 ,V, ,q 0 22r"c t|ddt|dd}}t|ddt|dd}}||z ||z }}tj||xsd}||z ||z f}|d|d f} ||f|| fS)u카메라 시선축 forward 단위벡터 + 화면-우 단위벡터 (순수 기하). right = (f[1], -f[0]) — 화면-우 양수 컨벤션 (좌표 산술, spike sh6 검증). 이 프레임으로 점을 투영하면 depth(near→far)+lateral(좌(-)→우(+))이 나온다.rrr rrr) camerapxpylxlyfxfyr.frs r _cam_axesr9s 6%=# $eF5M!,<&=B 6)$Q' (%y0A!0D*EB "Wb2gB 2r!cA aaA qTAaD5ME 8Q r"ct|\\}}}}t|d|z t|d|z }}||dz||dzz||dz||dzzfS)u:점을 카메라 프레임에 투영 → (depth, lateral).rr )r9r)r1rr2r3r8rrrs r _projectr;so"6*HRa 58_r !5q?R#7B !9rAaDy "uQx-"uQx-"? ??r"c tfd|jdxsgDd}|4t|jdrt|jdsy|d|d}}g}|jdxsgD]}tfd|jdxsgDd}|t|jdsH|j|jd xs|jd xsd |jd |dt ||d|jd +t|jd r|jd ndd|sy|j d|dd}|xsd} ddg} |jdxsgD cgc]*} | jdrt d| dDr| ,} } g} | D]]} | jd xs| jdxsd}| d}t|dk\r t|nd\}}}||tt|||dz nd}|| jddk(s|tk\ro|tk\rft ||t ||kDr||}}| jd |d!t|||| d"t|||| d#| j|||d$td%|Dt|z }td&|Dt|z }| jd |d't||||f| d#`| D cgc]} | jdd(k(s| }} | jd)t|D]\}}|d |jd r d*|d d+nd,z}d |d't|||d| |dk(rd-nd,zg}|dkDr2|ddkDr*|dkDr%|d|z }|jd.|d/d0d|z d1d2|d }|[t!|dt!|ddz t!|d3t!|dd3z f}d4t|||| g}d}| D]} t!| d5dt!| d6dz t!| d5d3t!| d6d3z f} t#|| }!t%|!d7|!z t&kslt)|d| d6| d5t*ks| d }|jd8t-|n|D]I}"|"|us|"d  t ||"dt |d|"dd9zkDs3|jd:|"d Kd}#|D]} | jd xs| jd}||k(r-| d}td;|Dt|z }td<|Dt|z }|t!|ddz |t!|dd3z f}$t#||$d=k\st/|}%|# |%|#dkDs|%|f}#|#r |jd>t-|#d3|jd?j1|| jd?j1|d#z t|d3kDr(|d@|d}'}&| jdA|&d dB|'d dCdDj1| Scc} wcc} w)Eulayout 좌표 → 해당 shot 의 **프레임 기준 지형+인물 요약** (순수 계산, LLM 0). 카메라 또는 인물 위치가 없으면 None. R2 사용자 피드백: "길의 방향(왼쪽→오른쪽인지)·정류장 위치 같은 지형을 설명하면서 방향을 알려줘야 모델이 제대로 안다" — landmark 가 프레임에서 어떻게 놓이고, 이동 인물의 경로가 무엇을 따라 어느 쪽으로 가며 무엇으로는 가지 않는지를 좌표 산술로만 서술한다 (의미 추론 0). 좌/우는 layout 카메라 기준 — LLM1 이 staged screen zone 재현을 강제받고 step 이 `layout_side_conflicts` 로 검증한다 (충돌 시 retry+진단).c3LK|]}|jdk(s|ywrNrrkrlrs r rmz-build_shot_spatial_summary..$U/q1553F*3T/$$rNrrrc3LK|]}|jdk(s|ywr>rrkrrs r rmz-build_shot_spatial_summary..&$ X21aeeL6IZ6WQ2rArr figure_idfigure entity_tokenr)rrGrdistancerc |dS)NrHr)es r z,build_shot_spatial_summary..6sq}r"rrrHrzSHOT u SCENE GEOGRAPHY (computed from the site-layout coordinates, frame-relative from this shot's camera — source of truth for where things are, which way paths run, figure depth and relative size):rrc32K|]}t|ywrvrrs r rmz-build_shot_spatial_summary..Hs$H.d.#QU1Q4[#r*c38K|]}t|dywr,r(rs r rmz-build_shot_spatial_summary..erTr*z : at the areazFIGURES: ()ru! — NEAREST figure to the camerazabout z.1fzLx as far from the camera as the nearest figure, so they must appear roughly .2fz.2cqtcr*c38K|]}t|dywr,r(rs r rmz-build_shot_spatial_summary..r[r*gN@zNOT heading into ; rzDEPTH CONTRACT: z is farther than z7 and must read visibly smaller and deeper in the frame. )nextr(rrrsortrrnr rr_ELONGATED_MIN_EXTENT_PATH_MIN_ASPECTrr-rrrr_FOLLOW_MAX_ANGLEr_FOLLOW_MAX_OFFSETrr$join)(rrr1rlookentriesrrtrue_nearest_drlinesrr elongatedrptsrrextentaspectcxcyarea_landmarksrankrJnamepartsratiormove_vec move_partsfollowed_labelaxis_vecangother not_into_bestto_area area_sizerrs( ` r build_shot_spatial_summaryr~ sUFJJy)/R/U F~Yvzz%'896::V_K`Aa5M6)#4TG%'Gzz)$** X ,22 X    IimmE.B$C WWW%I)=IGGN3U#gy'78}}_-9)--89']]?;?C  +  LL,L- QZ +N%#I  |  EZZ ,222r FF8 $H2h<$H!H 2')Iw=266$<=:l/23x1}s+BS 1f=>]FSa3S9 9PS  = FF6Nf $//F>N4NWa 5!#44!1 LLUG2<qR[3\2]^&waCDAG    u11= >.#..S9B.#..S9B LLUG9\'4"b9%U$VVWX -6$-I9Rv&0Hb9NI LLW%az!%%:Or!N"3!4A6UWXi WdAeHi PQ R6:ai2R I  !8* )nq.@ jMN2E LLs $//2U{3.?@88    >be uQuXa['995A<%PQRWPXYZP[J\;\]HRr9=>@J"N!"S'!*-bgaj0AA!"S'!*-bgaj0AAC$Xx8US[)->>+AeHbgr#wGK]]%'[N%%(;Inr)rkrlr]s r rmz.composition_guide_shot_keys..s$ R31quu\7Jc7QQ3rArNrrc3LK|]}|jdk(s|ywr>r)rkrr]s r rmz.composition_guide_shot_keys..s%U6q!%% :MQT:T6rArrrc3&K|] \}}| ywrvrrkr_s r rmz.composition_guide_shot_keys..s.gdagsc36K|]\}}|xr|kDywrvr)rkrrecedingrs r rmz.composition_guide_shot_keys..s"EWkax)A M)Ws) r!r_r(rrrrnrro)r member_keys summary_keysselectedr=r1rrgrrd_posrrrr]s @@r composition_guide_shot_keysrst$!HC S ! 5  R 9-33 R   >6::e+ Or"c "i}|D](\}}|j|gj||f*g}t|D]O}t||d}d}t|D],\}}|j||dk(rdnd|dk(rdn|||d|}.Q|S)uadmitted guide 샷들을 **same scene_index** 그룹으로 묶어 shot_index 순으로 정렬한 뒤 각 샷의 continuity mode/anchor_source/admitted_order 를 산출한다 (순수 — LLM/좌표 0). option C (사용자 정정 + Codex 합의): 같은 장소·같은 scene 의 admitted 샷들을 하나의 연속성 그룹으로 보고 - 첫 admitted 샷 = ``mode='sketch'`` — 구도 스케치(마네킹 브리프)로 구도를 deliberately 확립하고, 그 결과 프레임이 나머지의 연속성 anchor 가 된다 (이 샷은 직전에 참조할 같은-그룹 완성 프레임이 없다). - 이후 admitted 샷 = ``mode='continuity_anchor'`` + ``anchor_source`` = 같은 그룹의 직전 admitted 샷 키 — 생성 시점에 그 샷의 현재-run 완성 프레임을 연속성 anchor 로 쓴다 (사전 스케치 미생성). **다른 scene 으로는 체이닝하지 않는다** — 같은 location 이 에피소드 후반에 다시 등장해도 무관한 시퀀스를 연결하지 않기 위함 (Codex 합의: same scene + same location + admitted 로 좁게). Returns (입력 순서 무관, scene/shot 정렬 순): [{"key": (si, shi), "mode": "sketch"|"continuity_anchor", "anchor_source": (psi, pshi)|None, "scene_index": si, "admitted_order": int}] — caller 가 location_id 와 합쳐 group_id 부여. c |dSNr rks r rKz.composition_continuity_chain..QqTr"rLNrsketchcontinuity_anchor)rmode anchor_sourceradmitted_order)rrrr) admitted_keysby_scener=r]r,r$prevorderrs r composition_continuity_chainrs0*,H CB#**B95! "CX">:"&#G,JE3 JJ$)QJ4G).!!"'  D- Jr"ct|rt|dk\syt|dt|d}}d}t|}t|D]}t||dt||d}}t||dz|zdt||dz|zd} } ||kD| |kDk7s_|||z | |z z| |z xsdz z} | |kDs}| }|S)uray-casting 내부 판정 (순수 좌표 산술, 3점 미만 폴리곤은 항상 False). 3-stage 필수화(2026-07-02) enclosure 관계용 — 경계 위 점의 미세 판정은 중요치 않다(불확실하면 관계 서술을 생략하는 쪽이 안전, Codex 합의).rFrr g& .>)rrnrr) ptpolyxyinsider.rr r!r"r#x_crosss r _point_in_polygonr%s bMc$i1n A<r!uqA F D A 1XtAwqz"E$q'!*$5BtQUaK(+,eD!a%14Ea4H.IB FQ AFrBw/BG3DEEG{#  Mr"c|jd}|jdxsgD]}|jdxsddk7r|jdxsgDcgc]}t|s|}}t|dks t||se|jdxs|jdxsd }t|rt||sd |d cSd |d cSycc}w)ufigure↔area-landmark 위상 관계 구절 (순수 폴리곤 산술만, 자유문장 파싱 0). figure centroid 가 area landmark polygon 내부이고 카메라는 그 밖이면 스케치가 인물을 개방 지면으로 끌어내는 오류(카메라-피사체 사이 경계면 관계 손실)를 막는 generic 관계를 서술한다. 라벨은 데이터 label 그대로(템플릿 시나리오 토큰 0). 둘 다 내부면 'inside'만, 불확실(비폴리곤/판정 불가)이면 빈 문자열 = 서술 생략.rrrOrVrrrrNz a mapped areaz, INSIDE the mapped area 'u' while the camera is OUTSIDE that area — keep the figure within that area; if that area's boundary or opening is visible, show it between the camera and the figurez, inside the mapped area ''r)r(rrnr)r1fig_posrrrrrkrs r _enclosure_relation_phraser9sjjGjj%++ FF6N $f / 66(+1r1C1Qilq1C s8a<0#> wB266$<B? W &7&E0801 2,E7!44, Ds C+Cg4@) half_fov_degc  !tjdrtjdsyjd}d.fd }d/fd }g}|jdxsgD]}|jdxsgDcgc]}t|s|} }| s4tt| \} } | d krR|jd xs|jd xsd } |jd xsd} | dk(r|| nd}|| |jd}|j | | | | ||f|j d|sd|dS|dd|ddc }| z xsd!d0 !fd }d1fd }g}|D]`\} } } } }}| dk(r&d|vr"|j d| d|| d|d5|j d| d|| d|| | ||d bg}|jd xsgD]}|jd!xsgD]}|jd|k7st|jds2t|d\}}|d krJ|jd"}|j ||t|r|nd|dfg}|rtt d#|D}t|d$D]Q\}}}}||xsdz }|d%nd}t||}|j d&||d|||d'|d(d)||d Sd|dd*d+g}||z }|r|j d,||z }d-j|Scc}w)2u.layout + 한 카메라 → 그 카메라뷰의 layout/depth/figure 배치 brief (좌표 산술만). structure 는 near→far depth ordering + 화면 좌/우, figure 는 상대 스케일만 서술한다. 카메라 좌표 부재 시 None. (shared-model 가이드 image edit 프롬프트 입력.)rrNrrct|dkryt|\}}}t |\}}t |\}}t||z t||z } }| d|zk\ry|d| zk\ryy)ug장축 화면방향(좌표 산술): 최장 쌍을 카메라에 투영 → horizontal/receding/diagonal.rrz< (runs roughly horizontally across the frame, left to right)zC (recedes into the distance, a strong near-to-far perspective line)z# (runs diagonally across the frame))rnr r;r ) rrrrd0l0d1l1dddlr1s r _axis_dirz'compute_camera_brief.._axis_dirasy v;?!&)1a&!$B&!$BR"Ws27|B R<Q R<X4r"ct|syt t|\}}t |\}}||z ||z }}t|dkrt|dkryt|t|k\r |dkrdnd}n |dkrdnd}d|S) ufaces_toward open_vec(=ft−centroid)을 카메라 프레임에 투영 → 개방/전면 방향구. W-A(2026-07-03): 구조물 개방면 방향이 brief 어디에도 없어 스케치가 개방면을 임의 방향(인접 도로를 등지는 등)으로 그리던 결함 — 지배 성분(깊이 vs 좌우)으로 4방향 산술 서술. 순수 좌표 산술, 라벨/의미판정 0. faces_toward 부재/무효/영벡터 → 빈 문자열(구 layout 하위호환 = 방향구 생략).rgư>rztoward the cameraz1away from the camera, into the depth of the frametoward the left of frametoward the right of framez; its open/front side faces )rr;r/r ) rkrd_cl_cd_fl_frrrr1s r _faces_phrasez+compute_camera_brief.._faces_phraseos}FIcN3SFB'SsC#IB r7T>c"gn r7c"g +-6'L 35q&.4 -dV44r"r?rrNz a structurerOrVrrc |dSNrrrs r rKz&compute_camera_brief..sQqTr"rLz#The eye-level camera view for shot z'. (no landmarks in front of the camera)rrrc4|z z }|dkrdS|dkrdSdS)N(\? foregroundq= ףp? midground backgroundr)rrdminspans r _bandz#compute_camera_brief.._bands- X  4x|XQXkX<Xr"c tjtj|t|d}| dzkry|dzkDryy)NgMbP?g?rrznear centre of frame)rratan2r)lateralrryrs r _screenz%compute_camera_brief.._screensHll4::gs5$/?@A ,$ $- # #.%r" horizontallyrQz : in the z, spanning across the framerRz, rrrc3*K|] \}}}}| ywrvrrs r rmz'compute_camera_brief..s5*JAq!Qa*c |dSrrrs r rKz&compute_camera_brief..s1r"z* (in motion, moving deeper into the scene)z - a figure: z, about rYzx the nearest figure's sizeuKeep the horizon a single LEVEL, roughly horizontal line across the frame — do not tilt or slant it; this is an eye-level shot.z(Visible structures, ordered near to far:z#Figures (featureless markers only):r^)r List[Any]returnr)rkrrrrr)rrrr)rrrrrr) rr(r;r/rr`rrrre)"r1rrr]rrr4rrrkrrrrOrfacesdmaxrrri fig_depthsrrlatr fig_linesnearestfposscalemvencr,rrs"` ` @@r compute_camera_briefrVs fjj' (Yvzz)7L-M **\ "C 55,<>Ejj%++66(+1r1C1Qilq1C !&)C.9w C< w@266$<@=vvf~'!%y~Rc266.#9: eWeT4?@, JJ>J" 5cU;88 9q!eBilJD$ 4K CDY&E490wtT5 6>n4 LLUG9U5\N2MeWTUV X LLUG9U5\N"WWe5L4MdVTYSZZ[\ ^5:79Jzz)$**%++Auu\"c)155<1Hfah/FAsCx'B   q#Yr]rahO P,+I5*55 &z~ F AsBqxC(EAC=UWB-VT6BC   uQxj73?*;8+8SED E !G .cU!4 >2  C 5LC 89 y 99S>WDs MM))n)xr)r)rrrr)rrr)rrrrzList[Tuple[int, int, int, int]]_BIRDSEYE_AREA_PALETTE)rrrzTuple[int, int, int]_BIRDSEYE_EDGE)r<r_BIRDSEYE_FIGURE)(rr_BIRDSEYE_CAMERA)rc &g}d}|jdxsgD]}|jdxsgDcgc])}t|rt|dt|dg+}}|sN|jd}|dk(r1t|dk\r#|j d|t t dt|d k\rKt|ttz}|j d |t |t t d |dz }|j d |d dt t dg} |jdxsgD]} || jd|k7rt| jds5t| jdsP| j | jdt| ddt| ddgt| ddt| ddgdg} |jdxsgD]} | jdxsgD]}||jd|k7rt|jds5|jd} | j |jdt|ddt|ddgt| rt| dt| dgnd dttg|| | t tt tdScc}w)ulayout 좌표 → 결정론 top-down set-map 그리기 spec (순수 데이터, PIL/LLM 0). ★재배선 v2(2026-06-29) 에서 **미사용** — PIL birdseye 경로(literal 좌표 렌더 → 셸터가 도로 위 같은 좌표 품질 노출)를 라벨 마커 항공뷰(T2I base + I2I 블로킹)로 교체했다. 삭제하지 않고 보존(다른 소비/회귀 참조 가능). 새 경로는 ``build_aerial_base_prompt`` / ``build_shot_blocking_prompt`` 를 쓴다. 색은 area 등장 index 로 generic 배정 (시나리오 토큰 0). ``shot_index`` 지정 시 그 샷의 카메라+figure 위치만 (단일 카메라뷰 가이드의 명확성). landmark 는 고정 장소이므로 항상 전부. **글자/라벨 필드 없음** — provider 렌더가 텍스트를 그리지 않게(모델 입력) spec 자체에 인간 가독 라벨을 담지 않는다. serialize-가능 → 해시.rrrr rOrPr)shaperedgerpolygon)rrfillrrNrrrr)rrrrrr)rrr) coord_rangerrr figure_color camera_color) r(rrrnrrrrrrrr)rrrarea_idxrrrkrOrrrlrfgrs r build_clean_birdseye_specrs')IHjj%++)/R/B/1IaLad U1Q4[)/ B vvf~ 6>c#h!m    Cn9MN P X])(S9O5P*PQD   yC&*4j$~:NP Q MH   !S!Wd>>RS U,$%'G ZZ " (b (  !aeeL&9Z&G  QUU5\ "yy1A'B NNeeL1ahqk*E!E(1+,>?!!I,q/2E!I,q/4JK  )%'Gjj#)r) $**A%!%% *=*KQUU5\*'B NNeeL1ahqk*E!E(1+,>?%.r]$)A<r!u">8<   +*"9--.-.  WBs.LgA@_GRID_LOgP@_GRID_HIABCDEFGHIJKLMNOPQRSTUVWXYZ_FIGURE_LETTERSg(@_CAMERA_AIM_EPSg?_CAMERA_DEDUP_EPSc|tkrdn |tkDrdnd}|tkrdn |tkDrdnd}|dk(r|dk(ry|d|jdd jd d S) u0-100 좌표 → 9-cell grid 라벨 (top/middle/bottom × left/centre/right) — 순수 3분할 산술 (셀 경계 generic, 의미판정 0).rrcentretopbottommiddle-zmiddle-rz-centre)rrreplace)rrcolrows r _grid_cellr;shL&!h,wHCx<%!h,hHC h3(?U!C5> ! !)R 0 8 8B GGr"c6ddddj|xsddS)Nza long line/edgeza filled zone/areaza small fixed marker)rPrVrrza zoner)rOs r _shape_wordr Es&&0D+ --0SX-FGr"c|jdxsgDcgc]}t|s|}}|sy|jddk(rZt|dk\rLt|ddt|ddzdz t|dd t|dd zdz fS|jdd k(r"t|ddt|dd fSt |Scc}w) uUlandmark 대표점 (순수 기하): line=양끝 중점, point=그 점, area=centroid.rNrOrPrrrrr r)r(rrnrr/)rrrks r _landmark_anchorr Jsvvh'-2- ?-)A,1-C ?  vvf~CHMs1vay!E#b'!*$55<s1vay!E#b'!*$55<> > vvf~ c!fQi %Aq "233 S> @s C!C!cddtd}}}t|dD]Z\}}t|}|t||}||ks&|t |j dxs|j dxsd|}}}\||fS) upos 에 가장 가까운 환경 landmark → (1-based 번호, label). 번호는 base 의 원형 숫자와 정렬한다 (enumerate 순서 동일). 없으면 (0, "the set").rzthe setinfr startrrN an element)rrr rrr() rrbest_i best_labelbest_drrrrs r _nearest_landmarkrWs"#IuU|JF9A.2 R  9  #qM v:3rvvgF"&&,F,G!'JF / : r"c:g}|jdxsgD]}|jdxsgD]f}|jd|k7st|jds2|jd}|j|dt|r|ndf|S)uW이 샷에 위치가 있는 figure 들 → [(pos, moving_toward|None)] (순수 조인).rrrrrN)r(rr)rrr,rrrs r _figures_at_shotrfs<>Cjj#)r) $**Auu\"j0 !%%,8O'B JJ% " "4@ A  +* Jr"c|d|d}}t|dt|dz t|dt|dz }}|t krdn |tkDrdnd}|tkDrdn |t krd nd}d jd ||fDxsd }t||j d xsg\} } |d| d| dS)uk카메라 pos→look_at 방향을 화면어 + 가장 가까운 환경 원 번호로 서술 (좌표 산술).rrrr zupward (toward the top)zdownward (toward the bottom)rz to the rightz to the leftz and c3&K|] }|s| ywrvrrs r rmz%_camera_aim_phrase..}s.&QAq&szacross the planrz, toward circle rWz) and the lettered figures)rrrerr() r1rrrfrrrhaimninls r _camera_aim_phraserusu vi0C 47^eCFm +U47^eCFm-KB&(O+;&; ",.,@ (b/ 00-b ,,.1a&. . C2CC tVZZ %<%B CFBU"2$b,F GGr"u The ATTACHED image is a TOP-DOWN INTERIOR FLOOR PLAN of the building that stands on this site — a STRUCTURAL REFERENCE ONLY, not the drawing to edit. Draw the aerial site plan described above as a fresh image. Where that building appears on the site, keep its footprint size, shape, proportions and its door/window openings consistent with the attached floor plan. Do NOT copy the floor plan's text, numbers, colours, furniture symbols or line style into the aerial site plan.BUILDING_FP_AERIAL_GUIDANCEc Tgd}t|jdxsgdD]`\}}|jdxs|jdxsd}|jd|d |d t|jd d b|jd dj |S)uStage A — location 공통 빈 항공뷰 base 프롬프트 (환경=원형 숫자, 엔티티/카메라 제외). generic — landmark label 만 데이터서 흘러들고 시나리오 토큰 0. group 공통.)uDraw a CLEAN top-down COLOUR aerial SITE PLAN of ONE outdoor location — a flat schematic blueprint-style map seen straight from directly above (flat colour fills + clean outlines), NOT a photograph and NOT a realistic 3D render: no photo texture, no harsh shadows, no perspective.zLay the elements out physically sensibly: any structure built beside a long path/road runs PARALLEL alongside it, never on top of or across it; any water/coast and road stay separated along the shoreline.zThis is a SHARED EMPTY SET map reused by every camera shot. Draw each fixed ENVIRONMENT element below as a flat schematic shape AND mark it with a small CIRCLE containing its NUMBER at the element's location:rr rrrNrz - circle z: rWrOz).uDraw NO named characters, NO people, NO props and NO camera. The ONLY text in the image is the single DIGIT inside each numbered circle — no other words, letters or labels.r^)rr(rr re)rrirrrs r build_aerial_base_promptr!s E6::k28bB2w?266$<?< y2eWB{266&>/J.K2NOC LL  99U r"c |jdxsg}g}tt||D]p\}\}}|ttk\rnVt|}t ||\} } d|dt |d| d| d } |r| dt |z } |jd| zd zrd j|xsd } |d } d | dt | dt||dS)uStage B — 공통 base 위 I2I 블로킹 프롬프트: 엔티티=원형 글자, 카메라 1개. base set 보존 강제. generic — 위치는 grid + 환경 원 상대, 인물은 익명 글자(이름 누출 0).rzcircle z: a figure at the z of the plan, beside circle rWrXz, moving toward the z - rRr^z - (none)ruThe attached image is the SHARED empty site-plan base for this location: the numbered circles mark the fixed environment. KEEP the whole base EXACTLY as it is — same layout, shapes, numbered circles, colours, proportions and orientation; do NOT redraw, move, recolour or restyle anything. ADD on top, for THIS ONE shot only: 1) ENTITIES — for each, draw a small CIRCLE containing a CAPITAL LETTER at its position (these lettered circles are NEW; the numbered circles stay unchanged): uQ 2) THE CAMERA — exactly ONE camera: a clearly recognizable CAMERA icon at the zY of the plan, with a BOLD direction ARROW and a translucent triangular view-CONE opening z~, so the shot's viewpoint and aim are unmistakable. Add NO text other than the existing numbers and these new capital letters.) r(rrrnrrrrrer)rr1rr ent_linesidxrrletterrrclause ent_blockcposs r build_shot_blocking_promptr)s'  ;'-2II#$4VZ$HIYc2 #o& &  %"3 2BF8#5j#6F5GH##%$bA/ ,Z_,=> >F6)C/0J )$5 I %=D \ +[ t  ((:66(J'KLU U Vr"uThe attached image is a TOP-DOWN diagram of one outdoor location seen from directly above: numbered circles mark fixed environment elements. If the diagram also contains lettered circles, those mark the figures present in this shot, and a camera icon with a view-cone shows the camera position and the direction it looks. Read it ONLY to understand which elements are in shot and their relative placement. Now draw a ROUGH eye-level STORYBOARD COMPOSITION SKETCH of what THAT camera sees — a clean MONOCHROME pencil/marker line-art storyboard frame, NOT a finished render and NOT a top-down map. Use a normal horizontal EYE-LEVEL viewpoint, never a bird's-eye. Lay out the frame exactly by this depth / left-right brief: {brief} If the brief states a figure is INSIDE a mapped area while the camera is OUTSIDE that area, keep the figure within that area as seen from the camera; if the area's boundary or opening is visible, draw it between the camera and the figure — do NOT relocate the figure outside its area. If the brief states which way a structure's open or front side faces, draw that structure opening exactly that way relative to the camera — never mirror or flip its orientation. Keep real-world human scale throughout: a doorway reads as adult height, a bench seat as knee height, a road as wider than a car. If figures are present, size every structure against them; with no figure, still keep adult-human proportions — never shrink a structure into a miniature or toy-sized box. Draw ONLY the environment elements the diagram and the brief list — do NOT add any structure or object that is not in them, and never draw a second copy of a listed structure. Draw each figure as a simple featureless mannequin/placeholder at its mapped screen position and depth. Draw environment elements as simple line shapes only. This sketch defines ONLY framing, placement, depth and viewpoint — do NOT invent materials, colours, style, architecture, faces or surface finish. The diagram's NUMBERED circles, LETTERED circles, the camera icon, view-cone and arrow are spatial annotations only — do NOT copy ANY of them into the sketch. The output must contain NO numbers, letters, circles, arrows, labels or text anywhere._BLOCKING_SKETCH_SYSTEMuQ The attached image is a TOP-DOWN diagram of one outdoor location seen from directly above: numbered circles mark fixed environment elements. If the diagram also contains lettered circles, those mark the figures present in this shot, and a camera icon with a view-cone shows the camera position and the direction it looks. Read it ONLY to understand which elements are in shot and their relative placement. Now draw a ROUGH STORYBOARD COMPOSITION SKETCH of what THAT camera sees — a clean MONOCHROME pencil/marker line-art storyboard frame, NOT a finished render and NOT a top-down map. Draw it from the exact CAMERA ANGLE and viewpoint the FRAMING brief below describes (eye-level, a high or steep overhead angle, a low angle, etc.); do NOT default to a level eye-level view when the brief calls for a different angle. FRAMING / SET GEOMETRY (source of truth for the camera angle, viewpoint, depth, left-right placement and which elements are in frame): {brief} If the framing brief states a figure is INSIDE a mapped area while the camera is OUTSIDE that area, keep the figure within that area as seen from the camera; if the area's boundary or opening is visible, draw it between the camera and the figure — do NOT relocate the figure outside its area. If the brief states which way a structure's open or front side faces, draw that structure opening exactly that way relative to the camera — never mirror or flip its orientation. Keep real-world human scale throughout: a doorway reads as adult height, a bench seat as knee height, a road as wider than a car. Size every structure against the mannequin figures — never shrink a structure into a miniature or toy-sized box. Draw ONLY the environment elements the diagram and the brief list — do NOT add any structure or object that is not in them, and never draw a second copy of a listed structure. BODY POSE AND ACTION of each figure (source of truth for posture, gesture and which way each body faces — draw the bodies EXACTLY like this, do NOT default to a plain standing pose): {pose} Draw every PERSON as a posed artist's wooden MANNEQUIN — a smooth featureless articulated mannequin (clear ball joints at shoulders, elbows, hips and knees; no clothing; no face) posed EXACTLY in the posture and action stated above, so the body POSE, stance and limb positions are unambiguous. Construct each mannequin's head with the LOOMIS METHOD (a sphere with the side plane sliced flat, a vertical centerline and a horizontal brow line) so the head's facing direction is explicit. Place each figure at its mapped screen position and depth. Draw environment elements as simple line shapes only. When the sources conflict: the FRAMING brief governs camera angle, depth and left-right placement; the POSE lines govern each body's posture, action and orientation; the top-down diagram governs only relative set placement. This sketch fixes ONLY framing, placement, depth, viewpoint and body pose — it does NOT define identity, clothing, faces, materials, colours, architecture or surface finish, which come from the final character and background references, not this sketch; do NOT invent any of them. The diagram's NUMBERED circles, LETTERED circles, the camera icon, view-cone and arrow are spatial annotations only — do NOT copy ANY of them into the sketch. The output must contain NO numbers, letters, circles, arrows, labels or text anywhere._POSED_SKETCH_SYSTEMc|r9|jr)tj|xsd|jStj|xsdS)u0Stage C — 블로킹(or base) ref + 좌표 산술 camera brief (+선택 pose brief) → 카메라뷰 스케치 프롬프트. pose_brief(자세/동작 SOT) 있으면 posed mannequin 프롬프트, 없으면 (pose LLM 실패 degrade / 다른 소비) 기존 featureless 프롬프트(byte-identical).z (no brief))briefpose)r-)rr+formatr*) camera_brief pose_briefs r build_blocking_sketch_promptr2+sX j&&(#**.,Z5E5E5G+I I " ) ) 0L ) MMr"cJ|xsijdxsg}g}|D]o}t|tst|jdxsdj }t|jdxsdj j }|r|j dk(s|dk(rt|jdxsdj xsd}t|jd xsdj }t|jd xsdj }t|jd xsdj } t|jd xsdj } |d |g} |r$|j dk7r| j || r&| j dvr| j d| | r'| j dk7r| j d| |rS|j jdr|tddj n|} | r| j d| |j ddj| zdzr|sydj|S)ustructured pose brief(figures[])를 Stage C 스케치용 텍스트 블록으로 렌더(순수). 자세 확정(body_posture != unknown) + confidence medium/high 인 figure 만 포함한다. 하나도 없으면 None → step 이 fail-closed(가이드 미부착) 해서 generic standing 마네킹 재발(무-가이드보다 나쁜 오염)을 막는다(Codex 가드). 슬롯/동작은 generic role·동작만 (이름/의상/색/소품 고유명사는 스키마/프롬프트 단계에서 차단).r body_posturer confidenceunknownlowslotza figure limb_actionhead_body_orientationcontact_or_supportinteraction_target_rolez is none)r=rzresting on/against z engaging zfacing NrQr]rRr^) r(r)r5rrrr startswithrnre) pose_resultfigsrir8postureconfr8limborientsupporttargetrsos r render_pose_brief_textrH7sC  2 " "9 - 3DE !T" aeeN+1r288:155&,"-335;;='--/Y6$%- 155=&B'--/=:155'-2.446QUU239r:@@Baee017R8>>@QUU45;<BBD6gY'( DJJLF* LL  w}}l: LL.wi8 9 flln. LL9VH- . 39<<>3L3L4s9~'--/ &  wqc]+ TDIIe,,s2334  99U r"cTtfd|jdxsgDdS)Nc3K|]N}|jdk(r8t|jdrt|jdr|Pyw)rrrNr(rr?s r rmz#_camera_for_shot..ksK F/q EE, : - quuU| $1553C)D /sAAr)r_r()rrs `r _camera_for_shotrLgs6  FFJJy)/R/ F  r"ctt|D]^}t|dzt|D]A}||||}}t|d|dtkDst|d|dtkDs@y`y)u:카메라 목록에 좌표가 사실상 동일하지 않은(non-identical geometry) 쌍이 하나라도 있으면 True. _CAMERA_DEDUP_EPS 는 좌표 중복 제거용 기술 tolerance — '다른 앵글/ 연출'이라는 의미 단정이 아니다 (그 판단은 judge route). 순수 기하, 의미판정 0.r rrTF)rrnrr)rrrrrs r _cameras_non_identicalrNrsy3w< q1uc'l+A1:wqzqAah%),==Qy\1Y<8;LL ,! r"ct||}t|}|dk(rdn|dk(rdnd}td|D}d}t||}||r|D cgc]\}} t ||d} }} | D cgc] } | dkDs |  } } | rSt | t | } } | | z xsd}| D chc]} | | z |z d krdn| | z |z d krdnd  }} t|}||||d Scc} }wcc} wcc} w) uper-shot 구조 signal (순수 좌표) — judge 입력 + Stage B 트리거. 이름/토큰 누출 0. entity_count_bucket(none/single/multiple), depth_planes(figure 가 점유하는 카메라 depth band 수 0-3), has_motion.rr=r singlemultiplec3*K|] \}}|du ywrvr)rkrrs r rmz*shot_complexity_signals..s62Rt^rrrrrr)entity_count_bucket entity_count depth_planes has_motion)rrnrorLr;rr)rrr@r.bucketrVplanesr1rrdepthsrrrrbandss r shot_complexity_signalsr[s1 FJ /D D AAvVQHJF666J F fj 1F d9=>vsA(63'*>#/Vq3w!V/ Vc&k$D4K'CDJPRJPQt8t+d2Q!"TT 1D 81aAJP RZF%  ?/RsC1 C$<C$'#C)c@tdjdxsgD}i}|D]D\}}t|||vst|s"|j |gj ||fFg}t |D]}t ||d}t|dkr#fd|DD cgc]} | | } } t| sI|dkrO|j |||dd ||D cic]\} } t| | t| c} } d |Scc} wcc} } w) ucross-shot continuity **결정론 후보** (좌표/구조만, 의미판정 0). member_keys(이 location 그룹의 selected 멤버)를 scene_index 로 묶어, 각 scene 서브그룹이 (a) summary 존재 + valid 카메라 member 2+ (b) 카메라가 non-identical geometry 1쌍+ (좌표 중복 제외) (c) layout 에 공통 landmark 1+ 면 후보. 단일샷 복잡도/의미는 판단하지 않는다 (judge route + signal). anchor = shot_index 최소 멤버. Returns: [{"scene_index", "member_keys":[(si,shi)..], "anchor_key":(si,shi), "cameras_non_identical":bool, "landmark_count":int, "per_shot":{hint_key: signals}}]. c3K|]5}|jdxsgDcgc]}t|s|c}rd7ycc}wwrr NrKrkrrs r rmz0shared_model_candidate_groups..F1bx(.B. @.!9Q.rr"rLrc3<K|]\}}t|ywrv)rL)rkrr]rs r rmz0shared_model_candidate_groups..sPfa,VS9sr rT)rr anchor_keycameras_non_identicallandmark_countper_shot) r-r(r!rLrrrrnrNr[) rrrrfrr=r]r,r$rlcamsm_sim_shis ` r shared_model_candidate_groupsrksVJJ{+1r1N*,HC S !\ 16Fvs6S   B ' . .Cy 9!#CX">: w=1 + 구조 복잡 신호(multiple figures OR depth_planes>=2 OR has_motion). 최종 attach 여부는 judge route(single_shot_complexity) + _evaluate 가 결정한다. ★broad=True (4a fix 2026-07-01, Codex 합의): is_complex 구조 게이트를 **제거**하고 figure>=1 이면 모두 candidate 로 올린다(사용자 "한샷이라도 구도/복잡이면 무조건 마네킹" — 좁은 구조 prefilter 는 frame_spatial_contract 없는 복잡 구도샷[S15/S19]을 구조적으로 누락). 복잡/구도 판정은 downstream shared-model judge 가 camera_direction/frame 구조 필드로 결정(코드 free-text 파싱 0). is_complex 는 signal 로 계속 계산해 per_shot 에 남기되 candidate 여부 게이트로는 쓰지 않는다. broad=False = 기존 게이트(byte-identical). cross-shot 후보와 동일 shape 로 반환(step 루프 공용) + is_single_shot=True. c3K|]5}|jdxsgDcgc]}t|s|c}rd7ycc}wwr^rKr_s r rmz4single_shot_complexity_candidates..r`rarrTrr rSrQrUrrVFT)rrrdrerfis_single_shotrg) r'r-r(rr!rLr[r rQr) rrr exclude_keysbroadexcluderfr,r=r]sig is_complexs r !single_shot_complexity_candidatesrtsH0#ceGJJ{+1r1N!#C+&C 9   S ! 5 , %fc2SWW^49:Q>  GG) *j 8 +377>*/a0A5 +CGGL)*  Z  I;s)%*,"&r3/5  )': Jr"c|jddk(ryt|jdxsddk\ry|rd|vryy) uStage B(블로킹) 권고 (순수) — 구조 신호(다수 figure or depth_planes≥2) OR judge reasons 에 figure 배치 연속성 플래그. False = 단순 구도 → base→C 직행(B 생략).rSrQTrUrrfigure_placement_continuityF)r(r )signals judge_reasonss r shot_blocking_recommendedry sH {{()Z7 7;;~ & +!,16-G r"rr) upper_left middle_left lower_left upper_right middle_right lower_rightc<i}|xsijdxsijdxsg}|D]h}tj|jdxsd}|jd}|s?|jdtk(sX|s[||t|<j|S)ustaging frame_spatial_contract → {entity_token(C##): "left"|"right"}. target_kind=character + target_id 있는 constraint 만 (deterministic 조인).rdre screen_zoner target_idrg)r( _ZONE_SIDErir)rpr,rerlrrFs r staged_sides_for_shotr$sCMr&&'?@FBKKMZ`^`K ~~aeeM28b9{# AEE-(,AAf#CF   Jr"cf|sgStfd|jdxsgDd}|4t|jdrt|jdsgSg}|jdxsgD]}|jd}|r|jt|nd}|s5tfd|jd xsgDd}|t|jdszt |d|d|d} | d k7s| |k7s|j ||| d |S) ulayout 카메라 기준 인물 좌/우가 staged screen_zone 과 다른 항목. 조인 키 = figure.entity_token ↔ constraint.target_id (C##). 충돌은 caller 가 LLM1 retry 신호 + diagnostic 으로 쓴다 (lateral SOT=staging).c3LK|]}|jdk(s|ywr>rr?s r rmz(layout_side_conflicts..>r@rArNrrrrGc3LK|]}|jdk(s|ywr>rrCs r rmz(layout_side_conflicts..JrDrArr)rrG staged_side layout_side)r_r(rrrr) rr staged_sidesr1 conflictsrtokenexpectedractuals ` r layout_side_conflictsr2s?  UFJJy)/R/U F~Yvzz%'896::V_K`Aa &(Izz)$**'38<##CJ/d  X ,22 X    IimmE.B$C VE]F9,=y?OP X &H"4   ( %'%  +& r"ci}t||}|rt||d<t|t|z }|rt||d<|S)uentity ID 불변 계약 — 신규 토큰 도입(W-C1 audit 재사용) + 기존 토큰 누락 둘 다 위반. 비어있지 않으면 caller 는 revised 를 폐기하고 diagnostic 기록 (비차단). new_tokensmissing_tokens)r rr )originalrevisedr,rmissings r revised_prompt_token_violationsr]sS!#C*8W=J":.L#H-0Eg0NNG &w  Jr"ci}t|t|zD](}i}i}i}t|j|ft|j|ffD]\}}|s |jdxsij D]X\} } t | } | || <||| <|jdxsijt | } | K| |t | <Z|s|j|xsi} |j|xsi} t|}||| jdxs| jd|||d||<+|S)uimage-phase prompt override 의 **명시적 priority merge** — custom > zoom > site > original (Codex ⓒ). custom_prompt 는 소비자의 별도 분기가 이 merge 이전에 승리하고, original 은 override 부재(빈 맵)다 — 이 함수는 zoom/site 두 단계만 (shot, variation_index) 단위로 합친다: 같은 index 는 zoom 이 승리, site 는 빈 index 만 채운다. entry shape 는 zoom ``source_overrides`` 와 호환 (revised{int: str} / provenance{str: {...}} / group_id) + ``prompt_source`` / ``prompt_source_by_index`` stamp — override 적용 로그가 출처를 기록한다. 둘 다 빈 맵이면 빈 맵 (소비자 no-op, default 경로 byte-identical). r provenancegroup_id)rrr prompt_sourceprompt_source_by_index)r'PROMPT_SOURCE_SITEr(PROMPT_SOURCE_ZOOMr4r rr)zoom_overridessite_overridesmergedrrrsource_by_index source_labelentryvipromptprov zoom_entry site_entry first_idxs r merge_prompt_overridesrns` -/F>"S%88"$02 *, !3!3C!8 9 !3!3C!8 9$ L%$yy39r@@B FW$ &2# ,/52::3r7C#*.Js2w' C $  #'',2 #'',2 L $"z2PjnnZ6P,Y7&5  s -9: Mr"ct|||dS)N)schema_versionrprompt_overrides diagnostics)r)rrrs r build_manifestrs ),"  r"c g}t}|jdxsgD]}|jds|jdd|jdxsgDD]\}}t|trt|ts(|j|jdd||fN||j|tvr)|j|jdd|d|d |j t |||jd xsiD]}||vs|jd |d |S) u_조인 무결성만 — 의미 게이트 없음. override key 는 멤버 shot 이어야 한다.rrzgroup without location_idc32K|]}t|ywrv)r)rkr.s r rmz)validate_site_manifest..sF*EQa*Er member_shotsz: invalid member shot z : member Sr|z not a selected shotrzprompt_overrides[z] is not a group member shot)r'r(rr)r r*r!)manifestrrrr-r=r]rs r validate_site_manifestrsO JEK \\( # )r )uu]#   9 :F!%%*?*E2*EFGBb#&jc.B!!QUU=%9$::PRTVYQZP]"^_,**2su55!!uu]+,Jrd"SEAUV OOM"c2 3G*||./525 k !    1#6RS T6 r")rr rr rr)r+List[Dict[str, Any]]rSet[str])r6Dict[int, str]r7rr8Dict[str, Dict[str, Any]]rr)r Optional[int]rArrBDict[str, Any]r Optional[str])rrrrr7rr6rrRrrSrQrTrrUrQrVrQrLrQrWrrNrrDrQrOptional[Dict[str, Any]])r\rr Set[ShotKey])rprrrQ)rDict[int, Set[int]]rzDict[ShotKey, List[str]]rDict[ShotKey, Dict[str, Any]]rxrrrr6zOptional[Dict[int, str]]rsrQrzTTuple[Dict[str, List[ShotKey]], List[Dict[str, Any]], Dict[ShotKey, Dict[str, Any]]])rrrrQ)rrr List[str])rrrSet[int]rr)rrrrrr)rrrrrrrr)rTuple[float, float]rrrr) rrrrrrrrrr)rrrr)rrrzTuple[Any, Any, float])rrrrrrrr)rrrrrrrr)rrrr)rrrr)r1rrzDTuple[Tuple[float, float], Tuple[float, float], Tuple[float, float]])r1rrrrr)rrrr rr)rrr List[ShotKey]rrrr)rrrr)rrrrrrQ)r1rrrrrrr)r1rrrrrrr)rrrrrr)rrrrrr)rOrrr)rrrzOptional[Tuple[float, float]])rrrrrzTuple[int, str])rrrr rz/List[Tuple[List[float], Optional[List[float]]]])r1rrrrr)rrrr)rrr1rrr rrrv)r0rr1rrr)r?rrr)rrrr rr)rrrrQ)rrrr rr)rrrrrrrr)NF) rrrrrrrozOptional[Set[ShotKey]]rprQrr)rwrrxzOptional[List[str]]rrQ)rprrDict[str, str])rrrr rrrr)rrrrrzDict[str, List[str]])rrrrrr)rrrrrrrr)rrrrrr)c__doc__ __future__rloggingrtypingrrrrrr 2app.modules.pipeline.visual_continuity_anchor_planr r getLogger__name__loggerr__annotations__rr[rjrirrrrr ShotKeyr!r/r?rCrXrarrrrrrrrrrrrarbrcrdr rrr$r/r9r;r~rrrrrrrrrrrrrrrrr r rrrrr!r)r*r+r2rHrLrNr[rkrtryrrrrrrrrr"r rs8# 88   8 $3!%# 5 5-* S/) -- <   . +   < 444 4 . 4  4444444#444n& *;?%*i&%i&)i&3 i&  i&  i& 8i&#i&Zi&^6r. .19. .L  =,A  02 @f f(+ffX2 222 2p( ((h( %(2@<NR| |$2|EJ||D;7(7$6)6&6)6&6<@C C+8CC`%%335HG     (+ 4  H$,S2 V  V$2 V@C V VNY!R.Yc0h48 N N#0 N N%` (+  (+<. ... .j,0 ; ;;;) ;  ;  ;~CG   ,?   &vGG % %%!% %V ".1.1.#.h   /    %r"