XjI UdZddlmZddlZddlZddlmZmZmZm Z ddl m Z eje Zgdgdgdgd gd gd gd gd gdd Zded<ddgddgddgdZded<dZdZegdZegdZegdZej0dZej0d Zd'd!Z d(d"Z d)d#Z d*d$Z d+d%Zd,d&Z y)-uframe_spatial_contract — opt-in shot 의 화면 좌표/방향 SOT helper. Spec: docs/superpowers/specs/2026-05-14-frame-spatial-contract-design.md 5 함수 (caller 분리): - find_frame_spatial_contract_violations(batch_shots): shot_staging producer 가 retry hint 형성용 violation list 반환. raise X. - validate_and_prepare(contract, visible_entities): render_prompt_card 가 constraint_id 부여 + cross-check. invalid 시 AppError raise. - validate_echoes(card, result): scene_detail post-validation 이 per- variation echo set 검증. violations list 반환. raise X (caller retry 판단). - phrase_diagnostic(t2i_prompt, constraints): soft warning data 반환. raise X. - _format_retry_hint(fsc_violations): retry hint formatter (orientation pattern mirror). ) annotationsN)AnyDictListOptional)AppError)z upper-leftztop-leftz upper left)z upper-centerz top-centerz upper center)z upper-rightz top-rightz upper right)z middle-leftz center-leftz middle leftz left side)z middle-centercentermiddle)z middle-rightz center-rightz middle rightz right side)z lower-leftz bottom-leftz lower left)z lower-centerz bottom-centerz lower center)z lower-rightz bottom-rightz lower right) upper_left upper_center upper_right middle_left middle_center middle_right lower_left lower_center lower_rightzDict[str, List[str]] ZONE_PHRASES foregroundfront midgroundz middle ground backgroundback)rrr DEPTH_PHRASESfsc_)movement_directionpoints_to_anchorlooks_to_anchorshared_space_relationrequired_background_positionprimary_subject_isolation) characterpropr)none points_to reaches_for looks_toward moves_towardz ^C\d{2,3}$z ^P\d{2,3}$c g}|xsgD]j}|jd}|jd}|jd}|:t|ts|j||dd`|jd}|tvr|j||d|d|jd }t|t rt |d k(r|j||d dt |tkDr|j||d t |d t|D]W\}} t| ts|j|||dd.| jd} | jdd} | jdd} | jd} | jd}| jd}| jdd}| tvr|j|||d| dn| dk(r1tj| xsds|j|||d| dnW| dk(r1tj| xsds|j|||d| dn!| dk(r| dk7r|j|||d | dt| tr| js|j|||d!d| tvr|j|||d"| d|t vr|j|||d#|d|t"vr|j|||d$|d|d%k7r6t|tr|js|j|||d&d|d%k(s,|xsdjsB|j|||d'dZm|S)(u7shot_staging producer: violation list 반환 (raise X). scene_index shot_indexframe_spatial_contractcontract_not_dict)r+r,reasonr/invalid_reason_enum)r+r,r/value constraintsrconstraints_empty_or_not_listconstraints_max_3_exceeded)r+r,r/countconstraint_not_dict)r+r,constraint_idxr/ target_kind target_idlabel screen_zone depth_planegesture_actiongesture_target_labelinvalid_target_kind)r+r,r7r/r1r#'target_kind_character_id_shape_mismatch)r+r,r7r/r9r$"target_kind_prop_id_shape_mismatchr"target_kind_background_id_nonempty label_emptyinvalid_screen_zoneinvalid_depth_planeinvalid_gesture_actionr%.gesture_target_label_empty_for_non_none_action-gesture_target_label_nonempty_for_none_action)get isinstancedictappend _VALID_REASONlistlen_FSC_MAX_CONSTRAINTS enumerate_VALID_TARGET_KIND_CHARACTER_ID_REmatch _PROP_ID_REstrstriprr_VALID_GESTURE_ACTION) batch_shotsoutshotsishicontractr/r2idxctktidr;zonedepthgagtls U/Users/manta/Documents/Projects/TheRoad-I1/backend/app/core/frame_spatial_contract.py&find_frame_spatial_contract_violationsri?s "C!r! XXm $hh|$8845   (D) JJrH[\ ] h'  & JJrH]!') *ll=1 +t,K0@A0E JJrHgh i  { 2 2 JJr">[IY[ \ ,FCa& 2STW&;=>}%B%% R(CEE'2&E55'DEE-(E'(B%%.3C++ 2STW&;bJK{"+;+A+A#)+L 2STW&O^acdvk&7&7 r&B 2STW&JY\^_|#r  2STW&JY\^_uc*u{{} 2STW&356<' 2STW&;dLMM) 2STW&;eMN.. 2STW&>MN<C)=#))+JJrX[*Z \]r?)rJ)ras rh _sort_keyz'validate_and_prepare.._sort_keys EE- $ EE+r " (b EE'2  $" EE- $ * EE- $ * EE"B ' -2 EE(" - 3  rj)keyz.duplicate_constraint (same 7-tuple sort key): r8r9r:r;r<r=r>r?zinvalid target_kind zlabel is emptyzinvalid screen_zone zinvalid depth_plane zinvalid gesture_action r%z:gesture_target_label is empty but gesture_action != 'none'z>gesture_target_label is non-empty but gesture_action == 'none'r#z2target_kind=character requires C## target_id (got )z)render_prompt_card.fsc_cross_check_failedz target_id z not in visible_entities (r$z-target_kind=prop requires P## target_id (got rz5target_kind=background requires empty target_id (got constraint_id03d)r/r2)raDict[str, Any])rrKrLtype__name__rJrNrOrPrQrorladdrRrXrSrrrYrWrTrUrVrM_FSC_ID_PREFIX)r_rpr/r2rysorted_constraints seen_keysrakrqprepared_constraintsr`rbrcr;rdrerfrgs rhvalidate_and_preparers%1B   h %10h1H1H0II`a  \\( #F,,}-3K ]"5HL   a &'K./Q UU= !eeK$*w%2,,.uu]#m$ UU# $ee*B/ ' ' @%9"#@B B @#35 5 | # @%9$#BD D  % @%9%#CE E * * @%z$phrase_diagnostic..|sDm1 ,mc3&K|]}|v ywrrrs rhrz$phrase_diagnostic..}sF~!A-~rr|)r| label_missing zone_missing depth_missing)lowerrJrrboolanyrM) t2i_promptr2r[rar;rdre zone_variantsdepth_variants label_present zone_present depth_presentrs @rhphrase_diagnosticrns !#C$"++-L  B w%2,,.uu]#m$$((r2 &**5"5U =(= DmDD F~FF ,= JJ!"!7%2!2$0 0%2!2   Jrjcpgd}|D]}|jd}|jd}|jd}|jd}d|d|}| |d|d z }d }d |vr d |d d }nd|vr d|dd }n d|vr d|dd }|jd|d||dj|S)u[retry hint formatter — shot_staging.py:_format_retry_hint orientation pattern mirror.)r:r:uK[재시도 — 직전 응답의 frame_spatial_contract 가 다음 위반을u6 포함했습니다. 수정해서 재출력하세요:]r+r,r7r/Sz Shotz constraint[]r:r1z (got r{r9z (target_id=r5z (count=z - z:  )rJrMjoin) fsc_violationslinesrr]r^r`rsnlocsuffixs rh_format_retry_hintrs E  UU= !eeL!ee$%eeHo"U3%  ? \#a( (C a<aj^1-F A #AkN#5Q7F \' |1-F tC53%x01%& 99U rj)rZList[Dict[str, Any]]returnr)r_Optional[Dict[str, Any]]rpzOptional[List[str]]rr)r_rrpz List[str]rr)rr~rr~rr)rrWr2rrr)rrrrW)!__doc__ __future__rloggingretypingrrrrapp.core.errorsr getLoggerrrmr__annotations__rrrQ frozensetrNrSrYcompilerTrVrirsrrrrrrjrhrso# ,,$   8 $ FGFTAUEGF & "  )0(' #  BC!"fg2::m,bjj' K\3-&3-)3-3-lMC&MCMCMC`  6%4rj