,j8dZddlmZddlZddlZddlmZddlmZeje Z ddZ ddZ ddZdd Zdd Z dd Z dd Z dd Z ddZy)uG4.6 Wave A1 RC-C — entity reference 보호 룰. low_freq_skip 의 deterministic protection cascade (모두 generic, 시나리오 의존 0건): - variant pole / variant_self (RO-1) — character-character + identity/transformation 관계의 second-participant 만 (possession prop / location-location 은 제외) - is_base_for_variant — RelationFact 기반 base 측 보호 - pipeline manifest cascade — scene_director / shot_validator / shot_director + scene_detail rescue (force/retry 시 보강) — production data 만 읽음 - count > 1 — frequency 자체 이전 iter 의 keyword-based protection 은 제거됨 — 보호 판정은 graph (RelationFact) + pipeline manifest signal 만으로 derive. ) annotationsN)Path)Anyc|sgSt|tr|Dcgc] }t|c}St|tr tj|}t|tr|Dcgc] }t|c}St|tr'|jDcgc] }t|c}St|gSgScc}w#tj t f$r|gcYSwxYwcc}wcc}w)uS`EntityCanon.stable_traits` 는 JSON 문자열 (또는 이미 list). 양쪽 지원.) isinstanceliststrjsonloadsJSONDecodeError TypeErrordictvalues)rawtparsedvs P/Users/manta/Documents/Projects/TheRoad-I1/backend/app/core/entity_protection.py _parse_traitsrs  #t #$1A$$#s ZZ_F fd #$*+FqCFF+ + fd #$*MMO4OqCFO4 4F } I%$$i0 5L ,4s"CC(C)C.C&%C&cDddlm}t|j|z dz dz |z |z dz }|j sy t j |jdS#t jtf$r!}tjd ||Yd}~yd}~wwxYw) ucheckpoint manifest loader. 부재 시 None (caller 가 union 시 무시). PRO-5: settings.projects_dir 절대경로 사용 (process cwd 비의존). rsettings checkpointsepisodes manifest.jsonNutf-8encodinguMentity_protection._load_cp(%s): manifest 파싱 실패 — %s — None 반환) app.core.configrr projects_direxistsr r read_textr OSErrorloggerwarning) project_id episode_idstep_idrcp_pathexcs r_load_cpr+,s ) X " "#  $ %'1 24> ?AH I   >> zz'++W+=>>  ' * [ S  s$A%%B>BBcB|rd|vr|jddS|xsdS)uHC##O## composite → C## base. C## / L## / P## / O## bare 는 그대로.Or)split)short_ids r_short_id_baser1Ds(%-#/8>># q !WTVWct}t||d}|r`|jdijdgxsgD]7}|jdgxsgD]}|jt |9t||d}|r{|jdijdgxsgD]R}|jdgxsgD]7}|jdgxsgD]}|jt |9Tt||d}|r{|jdijdgxsgD]R}|jdgxsgD]7}|jd gxsgD]}|jt |9Tt||d } | r| jdijdgxsgD]}|jd gxsgD]}|jt ||jd xsi} | jd xsi} | jdgxsgD]A} t | t s| jd} | s(|jt | C|S)umpipeline manifest cascade — short_id 집합 union. sources (모두 manifest-driven, union): - scene_director.data.scenes[].present_entity_ids - shot_validator.data.scenes[].shots[].character_ids (RO-1) - shot_director.data.scenes[].shots[].visible_entity_ids (production schema) - scene_detail rescue — visible_entities + render_prompt_card.asset_requirements.required_refs[].id (force/retry 시 보강) DB EntityEpisodeLink.t2i_appearance_count 기반 source 는 의도적으로 제외 (Codex iter2 BLOCKING — count >= 1 보호는 low_freq_skip 정책 자체를 무력화). scene_directordatascenespresent_entity_idsshot_validatorshots character_ids shot_directorvisible_entity_ids scene_detailvisible_entitiesrender_prompt_cardasset_requirements required_refsid)setr+getaddr1rr)r&r' short_ids director_cpscsidsv_cpshsdir_cpsd_cprpc asset_reqrefrids r_collect_required_entity_idsrRIsu%I:z3CDK//&"-11(B?E2EBvv2B7=2= nS12>F Z-= >E ))FB'++Hb9?R?BffWb)/R/66/26<"4CI G^*CI K /CI Jr2cddlm}ddlm}ddlm}ddlm}m}t|j|z dz dz |z dz d z } | js tS tj| jd j!d xsij!d xsg} ddlm} t| |||} |j-|j/|j0|k(|j2dk(j5Dcgc]}|j6| vr|}}|d|D}|Dcic]&}|j8s|j6|j8(}}t}| D]}t;|t<s|j!d|j!d}}|||t?|t?||vrX||j!dxsg||j!dD]$}||vs|jAtC||&|S#t"$r*} t$j'd| tcYd} ~ Sd} ~ wwxYwcc}wcc}w)ue선택 샷의 촬영 계획(shot_staging)이 **화면 안에 세운** 등록 인물 short_id (2026-09-19, Codex 지적 — 참조를 붙이는 명단과 만드는 명단이 같아야 한다). 스틸 조립은 이 인물에게 참조를 붙인다(`still_recipe_service._staged_in_frame`). 실측: 셰퍼드·재판관이 촬영 계획엔 있고 VE 엔 없어 **참조가 아예 없었다** — 붙일 것이 없으면 이름만 실린다. ★이름 조인은 스틸 조립과 **같은 함수**다(`staged_in_frame_character_ids` — POV 제외 · 동명 제외). 배경 전용 여부는 가르지 않는다 — 넓게 잡아도 샷 그림은 안 망가지지만(그 샷에 안 붙을 뿐) **참조 생성 요금은 든다**. 실측(컨트리로드 2판)에서 이 출처로 새로 생기는 참조는 2장(셰퍼드·재판관). rrrV)tag_of)staged_in_frame_character_idsunique_character_ids_by_namerr shot_stagingrrrr5r9u5entity_protection: shot_staging 을 못 읽었다: %sN)active_episode_canon_ids characterc3TK|] }|j|jxsdf"yw)r.N)rBname).0rjs r z(_staged_in_frame_sids..s%.-&+qvv|es&( scene_index shot_indexcharacter_angles pov_character)"rrrZrWr[rm$app.modules.pipeline.shot_visibilityrnrorr r!rCr r r"rD Exceptionr$r%app.core.entity_identityrqr^r_r& entity_typerarBr0rrintrEr )rbr&r' selected_tagsrrWrmrnropathr9r*rqactiverjchars id_by_name sid_by_idrhssishieids rr]r]sQ).= && '* 4} D % &(6 79H ID ;;=u DNNGN<=AA&IG +(* B )"j*E FF HH[ ! VK**j8++{:< SU    446>    ..-&+.--J+0?5aAJJqzz!5I?EC !T" %% &l(;C :s2wC(A(V 0()/Ro&(CiIcN+, (  JE NPSTu  @s1A H I8I I I)IIIc|Dcic]}|d|jd}}i}|D]&}|j|dgj|(t}|D]}|jddvr|j|dg} t | dkr;t | D]V\} } | | dzdD]F} |j| d d k7r|j| d d k7r3|j | d HX|Scc}w) uRO-1 narrowed — character-character + relation_family in {identity, transformation} 의 second participant 집합 (variant 측 canon_id). `build_visual_dependency_graph` 의 generic deps 는 possession (character→prop) + location-location 도 dependency 로 만들어 variant_self 가 너무 넓어짐 (Codex iter2 IMPORTANT). 이 helper 는 RO-1 의 의도인 'variant pole 자체 보호' 만 정확히 반영. relations 는 [{id, relation_family}], participants 는 [{relation_id, canon_id}]. rBr~ relation_idrelation_family)identitytransformationNcanon_idrr)rD setdefaultappendrClen enumeraterE) entities relations participantsrj entity_types rel_partsp variant_polesrelpartsip1p2s rcompute_variant_pole_idsrs" u%EArAEFm ##BzN3{B##BzN3{B!!"Z.1$&  +EsC?cP|jdd}|dvry|dkDry|ry|ry|ryy)udeterministic protection cascade — skip 조건 모두 만족 시 True. 보호 발동 (return False) 우선순위: - location/outlook entity_type — helper 진입 시 False (caller 가 이미 skip) - count > 1 — frequency 자체로 충분 - is_base_for_variant — variant pole 의 base 측 - is_variant_self — character-character identity/transformation variant 자체 (RO-1) - required_by_pipeline — manifest 4-source cascade union 안 위 조건 모두 안 걸리면 skip (return True). r~r.)locationoutlookFrT)rD)rjcountis_base_for_variantis_variant_selfrequired_by_pipelineetypes rshould_skip_low_freqr;s?$ EE- $E '' qy r2)rrreturnz list[str])r&r r'r r(r rz dict | None)r0r rr )r&r r'r rset[str])rbrr&r r'r rzdict[str, str]) rbrr&r r'r rrCrr)r list[dict]rrrrrr) rjrrrrboolrrrrrr)__doc__ __future__rr loggingpathlibrtypingr getLogger__name__r$rr+r1rRrTrkr]rrr2rrs #    8 $&0X 1h68 88*-88v@ @@*-@>A@ @F""%/"?I" "J       r2