Oj-UdZddlmZddlmZddlmZeddhZde d<ed d hezZ de d <edhZ de d <dd Z ddZ ddZddZdZ d ddZ d ddZy)uArea B — entity_canon.metadata_json shape helper (전 entity_type closed shape). shape: {"location": , "visual_identity": } - prop: location=None, visual_identity={"reference_required": bool} - location: location={}, visual_identity=None - character: location=None, visual_identity=None sync (DB write 전) + consumer (render_contracts producer) 양쪽 공용 — drift 차단. Spec: docs/superpowers/specs/2026-05-13-area-b-render-contracts-design.md ) annotations)Any)AppError character location_partzfrozenset[str]_NEUTRAL_SHAPE_TYPESlocationprop_ALLOWED_ENTITY_TYPES_MARKER_ON_FAILURE_TYPESctS)u[metadata 에 **실을 값이 없는** 갈래 — `{location: None, visual_identity: None}`.rN/Users/manta/Documents/Projects/TheRoad-I1/backend/app/core/entity_metadata.pyneutral_shape_typesr%s rc |tvrdddS|S)u검증 **앞**에서 중립 모양 갈래의 metadata 를 계약 모양으로 접는다. ★실측 (2026-09-02 canary ①): `location_part` 는 계약이 중립 모양인데 프롬프트가 그 갈래에 아무 지시도 안 해 모델이 `visual_identity` 에 dict 를 지어냈다 → 검증 실패 → 3회 재시도 → `partial`(LP01·LP02·LP03). 결정적이라 다시 열어도 또 실패한다. 그 갈래엔 실을 값이 없으므로(좌표는 부모 location 이 갖고 시각 신원은 없다) 모델이 낸 것을 **버리는 것이 계약**이다 — 우회가 아니다. `character` 는 이미 같은 closed shape 로 내려간다. ★prop·location 은 **손대지 않는다** — 그 갈래는 값이 곧 SOT 다. N)r visual_identityr) entity_type metadata_jsons rnormalize_metadata_for_typer*s** T:: rcttz S)u산출 모양을 검증하고 **틀리면 안 보내는** 갈래. ★공개 끝점. ★★2026-09-01: `entity_t2i` 가 `("location","prop")` 를 손으로 적어 두어 `location_part` 만 **검증 없이** sync 까지 갔다(Codex 재현). 이 함수가 그 목록의 한 곳이다 — 갈래가 늘면 여기만 늘어난다. ★인물은 뺀다(위 주석) — 막으려는 실패가 서로 다르다. )r r rrrvalidated_entity_typesr;s !#; ;;rchddlm}t|tz }|rt dt |dy)u^★EntitySync 가 넘기는 갈래를 **여기가 다 받는지**. 안 받으면 즉사한다.r)ENTITY_SYNC_OWNER_TYPESuEntitySync 가 ul 를 넘기는데 metadata validator 가 안 받는다 — 그 loop 를 여는 순간 shape_violation 이다N).app.modules.pipeline.grounding_entity_contractrsetr AssertionErrorsorted)rmissings rassert_matches_sync_ownersr!FsI!)*-BBGfWo./R RS SrzV Rerun entity_extract / entity_t2i for this episode with Area B schema (force re-run).c v|rd|dnd}|tvr#tdd||dttdt|ts&tdd t |j |d t|j}|d d hk7rtdd t||d |d }|d }|dk(r|&tddt |j |d t|ts&tddt |j |d d|vrtdd|d |d}t |tur&tddt |j |d y|d k(rot|ts&tddt |j |d |&tddt |j |d ddl m }|||y|tvrW|)tdd|dt |j |d |)tdd|dt |j |d yy)uvnon-conforming shape 시 AppError raise. spec §3.1 contract: - metadata_json is dict; keys == {"location", "visual_identity"}; both present. - prop: location is None; visual_identity is dict; reference_required is bool. - location: location is dict; visual_identity is None. (D6 space_profile 내부 검증 통합) - character: location is None; visual_identity is None. - location_part: location is None; visual_identity is None. (중립 모양 — 제 좌표는 부모 location 이 갖고, 시각 신원은 없다) - 그 외 entity_type (outlook 등) → raise (별도 path). (short_id=)entity_metadata.shape_violationz8validate_entity_metadata_shape: unsupported entity_type z . Allowed: ub. outlook 등 다른 entity_type 은 별도 path 라 본 helper 도달 자체가 invariant 위반.codemessagez@validate_entity_metadata_shape: metadata_json must be dict, got .r rzhvalidate_entity_metadata_shape: metadata_json keys must be exactly {'location', 'visual_identity'}, got r NzIvalidate_entity_metadata_shape: prop entity must have location=None, got zSvalidate_entity_metadata_shape: prop entity must have visual_identity as dict, got reference_requiredzUvalidate_entity_metadata_shape: prop visual_identity missing reference_required fieldzJvalidate_entity_metadata_shape: prop reference_required must be bool, got zPvalidate_entity_metadata_shape: location entity must have location as dict, got zTvalidate_entity_metadata_shape: location entity must have visual_identity=None, got r)validate_location_space_profile)short_idz validate_entity_metadata_shape: z% entity must have location=None, got z, entity must have visual_identity=None, got ) r rr isinstancedicttype__name__rkeysboolapp.core.bg_state_vocabr,r) rrr-sid_hintr2locvirbrr,s rvalidate_entity_metadata_shaper9Ws  /7XL*BH//2J/(;v>S7T6UVss   mT *2M*334XJaA   }!!# $D -..2BBH,*A    #C ( )Bf ?6**.s)*<*<)=hZqJ "d#6448H4E4E3FxjPQS  r )6//7j; %& 9D 6))-c););(6115b1B1B0CH:QP  L' I , , ?66{mD//3Cy/A/A.B8*AO  >66{mD8,,-hZq:   -rc|rd|dnd}t|trd|vrtdd|dtz|d}|tdd |dtzt|trd |vrtdd |dtz|d }t |t ur-tdd t |j |dtz|S) uconsumer 진입점 — prop entity 의 SOT bool 추출 + fail-fast. stale data / invalid shape 시 friendly raise + force re-run 안내. visible_entity_details 의 prop entry 에 대해 호출. r#r$r%rr&z-Prop entity metadata_json missing or non-dictr*r'z1Prop entity metadata_json.visual_identity is Noner+zCProp metadata_json.visual_identity missing reference_required fieldzHProp metadata_json.visual_identity.reference_required must be bool, got )r.r/r_FORCE_RE_RUN_NOTEr0r3r1)rr-r5r7r8s r&get_visual_identity_reference_requiredr<s/7XL*BH mT *.?}.T2?zKN``   ( )B z2CH:QORdd   b$ #7r#A2U*A!34   ! "C Cy2Cy))*8*A79KL   JrN)return frozenset)rstr)r=None)r%)rr?rrr-r?r=r@)rrr-r?r=r3)__doc__ __future__rtypingrapp.core.errorsrr>r__annotations__r r rrrr!r;r9r<rrrrFs #$(1+1O'PnP(1//)1~1,5k]+C.C "< SDDDD DR/// /r