Oj]:UdZddlmZddlmZmZmZdZdZe deDZ de d<d Z de d <d Z d Zed fZde d<dZdZdZdZde d<dZde d<dZde d<dZdHdZdIdZdJdZdKdZe eiZde d<de d d Dd!Zd"e d#<dLd$Zd%d&d'd(d)d*Zd+e d,<eZde d-<d.d/d0d1d1d2Z d+e d3<e d4eDZ!de d5<d6Z"d7Z#d8Z$e"e#e$fZ%e"e"e#e#e$d9Z&d+e d:<dMd;Z'dNd<Z(dOd=Z)dOd>Z*dPd?Z+e+dPd@Z,e,dMdAZ-dQdBZ.dOdCZ/dPdDZ0dRdEZ1dSdFZ2yG)Tu엔티티 등록 계약 — **한 벌**. ★두 곳에 적으면 한쪽만 고쳐진다. Codex (2026-08-31): 「`MIN_OCCURRENCES=2` 와 `entity_steps` 의 `max_scenes=2` 가 여전히 두 상수이고, 시험이 production 소스를 정규식으로 읽습니다. 검사를 시험으로 옮겼을 뿐 **SOT 가 하나가 된 것은 아닙니다.**」 그래서 값을 **여기 한 곳**에 두고, 저빈도 필터를 부르는 자리와 chunk merge 가 **같은 이름을 소비**한다. 시험이 소스를 파싱할 일도 없어진다. ★owner→접두도 마찬가지다. `A0` schema 가 갈래를 늘리면 접두가 없어 최종 ID 발급이 **터진다** — 그래서 parity 를 검사한다. ) annotations)DictOptionalTuple) characterlocation location_partoutlookpropc#,K|] }|dk7s |yw)r N.0os d/Users/manta/Documents/Projects/TheRoad-I1/backend/app/modules/pipeline/grounding_entity_contract.py r$s1=)!Q)^A)s Tuple[str, ...]ENTITY_SYNC_OWNER_TYPES)rr r GENERIC_PROMOTION_OWNERSgrounding_chunk_adapterz3.202609012800z2.202609011200PRODUCER_CONTRACT_ACCEPTEDgrounding_producer_payloadgrounding_facet_bindinggrounding_host_context)coarse_type_label visual_briefsearch_terms_nativelanguage_lock_nativehard_to_generateviewers_would_noticeshot_binding_statusshot_appearance_idsPRODUCER_PAYLOAD_FIELDS)r JUDGE_FIELDS)rrrr surface_form SEARCH_FIELDSzscene-ct|S)u 씬 번호 → 원문 구간 id.)SEGMENT_ID_PREFIX) scene_indexs r scene_keyr+ws  ..ct|xsd}|jtsy|ttd}|j r t |SdS)u원문 구간 id → 씬 번호. ★꼴이 아니면 `None` — 짐작하지 않는다. ★이것은 **꼴 되읽기**이지 뜻 판단이 아니다. 만드는 쪽과 같은 규칙을 쓴다(위 `scene_key`). N)str startswithr)lenisdigitint) segment_idgottails rscene_index_of_keyr7|sM jB C >>+ , s$%& 'D 3t90D0r,c(g}dD]}|xsij|xsi}|jdxsdD]N}|xsijdxsijd}t|}|9||vs>|j|Pt|S)u 이 줄이 **원문 어느 씬**에 나오나. ★producer 가 적은 좌표만 본다. ★★★이름·부분문자열로 짐작하지 않는다 (사용자 절대 규칙). producer 가 `occurrences[].source_span.segment_id` 로 **구조화해 적어 둔 것**만 읽는다. 좌표가 없으면 **빈 목록**이다 — 부모가 보인다고 딸려 들어가지 않는다. ★두 자리에 적힌다: 걸러진 엔티티는 `grounding_provenance`, 장부 줄은 `source_evidence`. 둘 다 본다. )grounding_provenancesource_evidence occurrencesr source_spanr4)getr7appendsorted)entityoutholderblockrsegidxs rscene_indices_ofrFsC=2""6*0b))M*0b0AG==/52::<HC$S)C3c> 3 1> #;r,cddl}i}tD]8}|xsij|}| |dk(s|gk(r%|j|||<:|S)ureduced 행 → producer 판정 **한 덩어리**. ★중앙 helper 하나뿐이다. ★없는 칸은 **안 만든다.** 지어낸 값은 판정이 아니다. rNr.)copyr$r=deepcopy)row_copyr5kvs rproducer_payloadrNsU C $ YBOOA  9R17 "A % Jr,zDict[str, Tuple[str, ...]]KNOWN_PRODUCERS))r r c#$K|]}||f ywNrrs rrrs;91A9s)part_ofvisual_variantz&Dict[str, Tuple[Tuple[str, str], ...]]RELATION_OWNER_PAIRSc tjt|xsdd}tt |Dchc] }|D]}| c}}Scc}}w)uV그 relation 이 **닿는** 갈래들. ★목록을 손으로 다시 적지 않는다.r.r)rTr=r/tupler?) relation_typepairspairrs rrelation_sync_owner_typesrZsH $ $S)<"%=r BE u;utddu;< ==;sACLPLPO)rr r r r zDict[str, str] OWNER_PREFIXREFERENCE_SUPPORTED_OWNERSrcharacter_outlookr background)rr r r r REFERENCE_KIND_BY_OWNERc#PK|]}tj|dk(r| yw)rcN)rdr=rs rrrs+07)!""1%5)s$&BACKGROUND_LANE_OWNERSpolicybackground_sidecarcharacter_outlook_attachment)rr r r r REFERENCE_ENFORCEMENT_BY_OWNERcFtjt|xsdS)uL이 갈래의 참조를 **누가 집행하나**. 모르는 갈래면 `None`.r.)rjr=r/ owner_types renforcement_gate_ofrns ) - -c*2B.C DDr,cntvrtddttfdtDS)uV그 집행자가 맡은 갈래들. ★부르는 쪽이 목록을 다시 적지 않게.u모르는 집행자 u — c3RK|]}tj|k(r| ywrQ)rjr=)rrgates rrz%owners_enforced_by.. s-C6q266q9TA6s$')ENFORCEMENT_GATES ValueErrorrVMATERIALIZABLE_OWNER_TYPES)rqs`rowners_enforced_byrusE $$/xu=N? @C % &D d{>vc{mL55;D\N DE E)s$BctDcgc] }|tvr|}}|rtd|dtDcgc] }|tvr|}}|rtd|dycc}wcc}w)u★투영이 **다섯 갈래를 다 덮나.** 갈래가 늘면 여기서 선다. ★★그리고 **선언과 수용을 가른다** — 투영에 있다고 참조를 만드는 것이 아니다. 실제로 여는 것은 `REFERENCE_SUPPORTED_OWNERS` 이고, 그것을 넓히는 것이 곧 cutover 다. 미리 넓히면 새 producer 없이 옛 유료 경로만 켜진다(2026-08-31 에 실제로 그랬다). r}uF 가 참조 kind 투영에 없다 — 늘렸으면 여기도 적어라u 연 갈래 u 가 투영 밖이다N)rtrdrsra)rroutsides rassert_projection_covers_ownersrRs544Q224G4gYd eg g444Q224G4;wi/DEFF4 4s AAcFtjt|xsdS)u이 갈래가 **어느 참조 자리**로 가나. 모르는 갈래면 `None`. ★부르는 쪽이 `"background"` 같은 값을 손으로 적지 않게 한다. r.)rdr=r/rls rreference_kind_of_ownerrhs # & &s:+;'< ==r,c0t|}|tvr|SdS)u이 신원으로 **참조를 만들 수 있나**. 못 만들면 `None`. Returns: 만들 수 있으면 그 갈래(`"character"`/`"prop"`), 아니면 `None`. ★신원이 아닌 글자(`Pfoo`)도 `None` 이다 — 접두만 보면 지나간다. ★열려 있는 갈래(`REFERENCE_SUPPORTED_OWNERS`)만 답한다 — 투영에 있다는 것과 지금 만들 수 있다는 것은 다르다. N)owner_of_final_idra)short_idr5s rreference_owner_ofrps! H %C333==r,cddlm}|jd|jd}t |t rddl}|j|}t|jd|jdijdijd ijdijd ijd xsd }|s td |S)u다섯 갈래 — ★`grounding_a0` schema **에서** 온다. 여기 손으로 다시 적으면 A0 가 갈래를 늘려도 이쪽은 모른다. r) grounding_a0stemscontentNschema properties candidatesitemsrmenumru^A0 schema 에서 owner enum 을 못 읽었다 — 여기 손으로 적으면 두 벌이 된다) app.modules.pipeliner load_pack SCHEMA_STEM isinstancer/jsonloadsrVr= RuntimeError)a0schrr5s rownersr~s 8 ,,. !".. 1) ? ??r,ct|xsd}|syttjdD]M\}}|j |s|t |d}|s)|j s:|jsK|cSy)u신원 문자열이 **어느 갈래의 것**인가. ★못 읽으면 `None`. ★★두 가지를 **같이** 봐야 한다 (Codex 2026-08-31). ①`startswith` 만으로는 안 된다 — 접두표가 **prefix-free 가 아니다**. location "L" location_part "LP" ← `LP01` 이 `"L"` 로도 시작한다 그래서 `location` 행에 `LP01` 이 와도 통과했다. ②접두를 떼고 남은 것이 **숫자여야** 한다. `Pfoo` 도 `"P"` 로 시작하므로 접두만 보면 `prop` 으로 통과한다 — 신원이 아닌 것이 신원 자리에 앉는다. 가장 긴 접두부터 보고, 남은 것이 **한 자 이상 전부 숫자**인 첫 갈래를 돌려준다. 접두가 겹칠 때 긴 쪽이 숫자로 안 끝나면 짧은 쪽도 본다. ★**이 함수가 한 곳이다.** 부르는 쪽이 각자 접두를 비교하면 접두표가 바뀔 때 한쪽만 고쳐지고, adapter 가 제 문법을 하나 더 만들면 두 벌이 된다. r.Nc t|d S)N)r1)kvs rz#owner_of_final_id..sSAZKr,)key)r/r?r`rr0r1isasciir2)rfidrprer6s rrrsv* hn" C \//1!79 s~~c" 3s89~ DLLNt||~L9 r,N)r*Anyreturnr/)r4rrz Optional[int])r@Dict[str, Any]rz List[int])rJrrr)rWr/rr)rmr/r Optional[str])rqr/rr)rr)rNone)rr/rr)rr/rzOptional[Tuple[str, int]])rr/rr)3__doc__ __future__rtypingrrrENTITY_MIN_OCCURRENCESrtrVr__annotations__rPRODUCER_ISSUERPRODUCER_CONTRACT_VERSIONrPRODUCER_PAYLOAD FACET_BINDING HOST_CONTEXTr$r%r'r)r+r7rFrNrOrTrZr`rardrfrwrzENFORCE_BY_OUTLOOK_ATTACHMENTrrrjrnrurxr{rrrrrrrrrr,rrs" #((1,11=)1=,==-N/M ,-/H/?/AOA 0 * ( ,!7 o6"G G/ 1* //+0;9;;@<>    n&/IOH*" ! ++007)07+77* 4 >&(E24# -2, 2E C 1= E.!"G& !> >* -@.!r,