OjUdZddlmZddlZddlZddlZddlZddlZ ddl m Z m Z m Z mZmZmZmZddlmZddlmZddlmZddlmZdd lmZmZmZmZmZm Z m!Z!m"Z"ejFe$Z%d Z&d Z'd Z(d Z)dZ*dZ+dZ,dZ-e'e(e)e*e+e,e-fZ.e/hdZ0de1d<e/ddhZ2de1d<dZ3de1d<dZ4de1d<dZ5de1d<dZ6de1d <d!Z7de1d"<d#Z8de1d$<d%Z9d&e1d'<d(Z:d&e1d)<d*Z;d&e1d+<d(Zde1d1<d#Z?de1d2<d3Z@de1d4<d5ZAde1d6<d7ZBde1d8<d9ZCde1d:<d;ZDde1d<<d=ZEde1d><d?ZFde1d@<dAZGde1dB<dCZHde1dD<dEZIde1dF<dGZJde1dH<e/hdIZKde1dJ<e/hdKZLde1dL<e/hdMZMde1dN<e/hdOZNde1dP<e/hdQZOde1dR<e/hdSZPde1dT<dUZQdVZRdWZSdXZTeQeReSeTfZUdYZVdZZWd[ZXdZYeVeWeXeYfZZd\Z[d]Z\dZ]e[e\e]fZ^d^Z_e jd_Zad`Zb ddaZcddbZdddcZedddZfddeZgddfZhddgZi ddhZj ddiZkddjZlddk ddlZm ddmZn ddnZo ddoZp ddpZqdqZrdrZsdsZtdtZuduZvdvZwe jdwZx ddxZydydzd{d|d}dzd~dddyd~ddd d dd{ewgddgddddyd d dzd{dwd}d{evgddddgddddyd d dzd{ergdd{esgdd{etgdd{eugddgdddddgddddZz ddZ{ ddZ|ddZ}ddkdZ~dddd ddZddZ ddZddZddZddZddZddZdddZddZ ddZddddZde1d<ddZ ddZdZdZdZ ddZ ddZ ddZ ddZdZdZddZdddddd ddZy)uG4.1 / G4.2 / G4.3 / G4.4 / G4.5a RenderPromptCard helper — single source. scene_detail _analyze_one() 직전에 호출 → 5-field deterministic card 빌드. LLM 응답 schema 에는 들어가지 않음 (CP-only top-level field). G4.2 (2026-05-04): v16 system.md 의 Rule A (camera consistency) / Rule C (owned object preservation) / Rule E (close-framing reference omission) 산문을 `background_binding.constraints` machine-readable 문자열로 lift. 관측용 `_card_metadata` envelope-sibling (lift_status + rule_source) 추가 — canonicalize_render_prompt_card() 가 hash 입력에서 제외하므로 hash 영향 0. G4.3 (2026-05-04): v17 system.md 의 4 ID-policy prose section (C## 사용 규칙 33L + 극단 클로즈업 표현 20L + 사진·포스터·화면·거울 속 인물 규칙 14L + Rule H demographic 42L = 109 lines) 을 `id_policy` 의 builder-static sub-field (face_identifiability_rule / reproduction_surface_rule / demographic_descriptor_policy) + constraints 로 lift. Area #1 (2026-05-16): body-part / close-framing face noun-list 폐기 → per-subject reference policy SOT (shot_staging v12 producer + subject_reference_policy.py helper). compute_id_policy_snapshot_hash() helper 신설 (R2-I2 carry — canary pinning block 산출용). _card_metadata.lift_status / rule_source 키 추가. G4.4 (2026-05-05): v18 system.md 의 3 continuity prose section (교차 샷 고정 요소 통합 규칙 12L + 앞쪽 참조 샷 처리 ref_usage 35L + 단일 시점 19L = 66 lines) + detail_steps.py:1555-1563 inline 9 lines = 합계 75 lines 을 `continuity_elements_used` 의 3 신규 builder-static sibling policy dicts (cross_shot_id_substitution_rule / ref_usage_constraints / view_consistency) + 7-string constraints 로 lift (G4.1 base 2 → G4.4 7). 9 module-level constants (Override O-6 / O-7 / O-12 / O-19 — single source for builder + 5 canary + unit tests). _CONTINUITY_ID_POLICY_CROSS_REF_LITERAL 는 Override O-7 paired-string substring single source (cross-card reference; Area #1 v1 → id_policy.subject_reference_policy). compute_continuity_snapshot_hash() helper 신설 (Override O-12 — canary pinning block 산출용). _card_metadata.lift_status 4 신규 key (Override O-9 정확 명) + rule_source 3 신규 key 추가. forward_zoom_targets shape 변경 0 (Override O-4). G4.5a (2026-05-05): v19 system.md 의 3 spatial-rules prose section (Rule F 33L + Rule G 41L + Rule J 50L = 124 lines) 을 `render_strategy.spatial_consistency` 신규 sibling nested dict (4 sub-key — camera_frame_rule (7 keys, RO-3 — core_principles 4-entry list 추가) / fg_bg_shared_anchor_rule (6 keys) / primary_framing_rule (5 keys + close_framing_rules 4 incl subject_reference_policy_cross_ref Area #1 / wide_medium_rules 4 incl subject_reference_policy_cross_ref Area #1) / rationale_summary) 로 lift. constraints G4.4 base 2 → G4.5a 5 strings. 9 module-level constants (PR4-B5 / RO-11 single source for builder + canary + unit tests). compute_render_strategy_snapshot_hash() helper 신설 (PR4-B4 / PR4-I2 binding — render_strategy 전체 hash, NOT narrower spatial_consistency). `_assert_spatial_consistency_shape()` + `_assert_primary_framing_rule_shape()` nested helpers (RO-9 / PR4-I5 — nested call chain). _card_metadata.lift_status key + rule_source key 추가. PR4-B6 binding: G4.1+G4.4 base 8 keys 보존, NEW sibling 추가만. PR4-B3 binding: cross-card refs ONLY in primary_framing_rule (close_framing_rules + wide_medium_rules), NOT in camera_frame_rule. PR4-B9 binding: in-module direct reference (NO self-import, NO typed-only forward declaration). Card field shape (spec §4): - render_strategy (mode / framing_scale / camera_direction / ...) - id_policy (allowed_base_entity_ids / allowed_outlook_pairs / ...) - background_binding (mode / bg_id / owned_objects / camera_reference / ...) - continuity_elements_used (fixed_elements / previous_shot_refs / forward_zoom_targets) - asset_requirements (required_refs / forbidden_refs / readiness_policy) Hash (spec §4 + spec §10 Q4 + R1-I3 + R1-I11 + R2-B1): - render_prompt_card_hash = sha256(canonical_json(card_payload))[:16] - canonical = json.dumps(sort_keys=True, ensure_ascii=False, separators=(",", ":")) - hash payload = envelope minus (`_card_metadata`, `render_prompt_card_hash`). INCLUDES schema_version + shot_key + 5 semantic fields. - 6 unordered list 정렬 (owned_objects, allowed_base_entity_ids, allowed_outlook_pairs, required_refs, forbidden_refs, fixed_elements). G3.2 sentinel coexist (spec §4.3): - card hash = shot-level upstream contract drift - G3.2 owned sentinel = variation-level t2i_prompt drift - 둘 다 cp 에 공존 — 서로 대체하지 않음. ) annotationsN)AnyDict FrozenSetListOptionalSetTuple)settings)_is_character_subject)AppError)is_reproduction_perception)SubjectReferencePolicyderive_visible_subject_ids(apply_episode_reference_policy_downgradeapply_screen_presence_downgrade*filter_subject_reference_policy_to_visible'get_subject_reference_policy_or_default(normalize_subject_reference_policy_items&serialize_subject_reference_policy_mapdirectsimplify partial_focusreframeanchored_reference close_insertnot_applicable>directional_3dcontent_surfacenon_directionalreflective_surfacetransparent_surfacezFrozenSet[str]_ALLOWED_DIRECTIONALITY_CLASSESr r"_REPRODUCTION_SURFACE_CLASSES) Asianz East Asianz South AsianzSoutheast AsianBlackzMiddle EasternHispanicLatinaLatino CaucasianzTuple[str, ...]_ID_ETHNICITY_COMPONENTS)zin his/her 20szin his/her 30szin his/her 40syoungz middle-agedelderly _ID_AGE_BANDS)z an Asian manz a young womanza figureza manza womanzan elderly figureza child _CONTINUITY_GENERIC_PERSON_NOUNS) furniturez wall positionz room layoutz same chairz same tablez same wallz same window#_CONTINUITY_FURNITURE_LAYOUT_TOKENS) third_personclose_up!_CONTINUITY_FRAMING_SCOPE_OPTIONSzoom_in_detailexact_backgroundatmosphere_reference_CONTINUITY_REF_USAGE_VALUESint*_CONTINUITY_ZOOM_FORBIDDEN_ADDITIONS_COUNT)_CONTINUITY_ZOOM_REQUIRED_PHRASINGS_COUNT+_CONTINUITY_EXACT_PERMITTED_ADDITIONS_COUNT._CONTINUITY_ATMOSPHERE_FORBIDDEN_IMPORTS_COUNT"id_policy.subject_reference_policystr'_CONTINUITY_ID_POLICY_CROSS_REF_LITERAL applies_when substitutiondouble_description_forbiddenpreserve_pose_unchangedno_repeat_after_poserationale_summary+_CONTINUITY_CROSS_SHOT_ID_SUB_REQUIRED_KEYS'_CONTINUITY_REF_USAGE_TOP_REQUIRED_KEYS scope_summaryforbidden_additionsrequired_phrasings"subject_reference_policy_cross_refrL(_CONTINUITY_REF_USAGE_ZOOM_REQUIRED_KEYSrPpermitted_additionsbackground_consistency_ruleignore_keep_handled_elsewhererL)_CONTINUITY_REF_USAGE_EXACT_REQUIRED_KEYSrPforbidden_importsrequired_handlingrL._CONTINUITY_REF_USAGE_ATMOSPHERE_REQUIRED_KEYS framing_scope_optionssingle_camera_rulethird_person_handlingclose_up_handling&focus_on_is_focus_area_not_view_switchrSprop_orientation_rulemixing_forbiddenrL*_CONTINUITY_VIEW_CONSISTENCY_REQUIRED_KEYS)lowz ground levelz quay levelz floor levelu낮은u 발 높이_SPATIAL_CAMERA_LOW_TOKENS)overheadz from abovez high angleu 위에서u 오버헤드_SPATIAL_CAMERA_HIGH_TOKENS)z hip heightz waist heightu 허리 높이_SPATIAL_CAMERA_HIP_TOKENS)chestwaistu가슴u허리flooru바닥ceilingu천장#_SPATIAL_FRAME_EDGE_POSITION_TOKENS) foreground backgroundzrear backgroundu전경u후경 _SPATIAL_FG_BG_SEPARATION_TOKENS)facinghandingdialogueholdacrossu마주u건네_SPATIAL_INTERACTION_VERBS)z shared benchz shared tablezshared surfacezthe samez across thezsingle line of sightu 같은 벤치u같은 테이블_SPATIAL_SHARED_ANCHOR_KEYWORDS>camera_frame_rulerLprimary_framing_rulefg_bg_shared_anchor_rule"_SPATIAL_CONSISTENCY_REQUIRED_KEYS>rGcore_principlesself_check_stepsrLrecommended_phrasingsforbidden_combinationsconsistency_check_summary(_SPATIAL_CAMERA_FRAME_RULE_REQUIRED_KEYS>rGrrLforbidden_phrasingsrecommended_keywordsshared_anchor_required/_SPATIAL_FG_BG_SHARED_ANCHOR_RULE_REQUIRED_KEYS>rGrrLwide_medium_rulesclose_framing_rules+_SPATIAL_PRIMARY_FRAMING_RULE_REQUIRED_KEYS>r!other_entities_appearance_options"primary_subject_only_fully_visiblerS-_SPATIAL_CLOSE_FRAMING_RULES_REQUIRED_SUBKEYS>body_part_close_up_forbidden"primary_and_secondary_both_visiblerS'fg_bg_separation_requires_shared_anchor+_SPATIAL_WIDE_MEDIUM_RULES_REQUIRED_SUBKEYSwidemediumcloseinsertbackground_ref_attachedskipped_close_framingbackground_mode_offblock_if_missingskipped_by_policy)_card_metadatarender_prompt_card_hashz [0-9a-f]{16})schema_versionshot_keyrender_strategy id_policybackground_bindingcontinuity_elements_usedasset_requirementsrender_contractsc\ddlm}m}||xsijddur|S||dS)zResolve render_strategy.framing_scale from shot_staging enum SOT. `staging_not_applicable` is a deterministic sentinel path. All other missing/invalid inputs fail through the shared framing_scale helper. r)FRAMING_MEDIUMget_framing_scale_or_raisestaging_not_applicableTz render_prompt_card.framing_scalewhere)app.core.framing_scalerrget)staging shot_inforrs W/Users/manta/Documents/Projects/TheRoad-I1/backend/app/core/steps/render_prompt_card.py!_resolve_framing_scale_for_renderrs> IO001IJdR %0 cHtt|t|diiiiidS)uAEnvelope + 5 빈 dict — 모든 builder 가 채울 ground state. scene_index shot_index)rrrrrrr)CARD_SCHEMA_VERSIONr<rs rbuild_empty_cardrs6.{+j/  $&   rcddgdgdgdgddd}d d gd gd gd dd}ddgdddgdtddddddtddgddd}|||dd S)!u,G4.5a — spec §2.2 spatial_consistency 4 sub-key assemble (builder-static). PR4-B2 binding: spec §2.2 가 ground-truth source. 4 top-level sub-keys — camera_frame_rule (7 keys, RO-3 — core_principles 4-entry list) / fg_bg_shared_anchor_rule (6 keys) / primary_framing_rule (6 keys + nested) / rationale_summary. PR4-B3 binding: cross-card refs (`subject_reference_policy_cross_ref`) are placed inside `primary_framing_rule.close_framing_rules` and `primary_framing_rule.wide_medium_rules` — NOT inside `camera_frame_rule`. PR4-B9 binding: `_CONTINUITY_ID_POLICY_CROSS_REF_LITERAL` is referenced directly in-module — NO self-import. NO typed-only forward declaration. RO-9 invariant: builder-static — 입력 무관 항상 동일 dict. 테스트 `test_spatial_consistency_4_subfields_independent_of_input` 가 강제. Area #1 (2026-05-16): cross-card ref literal value = `id_policy.subject_reference_policy`. Body-part trigger noun-list 폐기 — per-subject policy SOT (helper) 가 대체. zcamera_direction expresses a vertical camera height or viewpoint position and the scene description includes frame-edge surfacesu'elements described inside the frame must be at vertical/depth positions consistent with the camera's height — low cameras place feet/lower-body in the lower frame, overhead cameras place head/shoulders in upper frame, hip-height cameras place torso in frame with head/feet implied beyond edges)zlow cameras at ground/quay/floor level place feet and lower legs in the lower frame; chest-height frame-edge surfaces behind the subject are geometrically forbiddenzoverhead high angles from above place the top of head and shoulders in the upper-center frame; floor surfaces visible below feet at the lower frame edge are forbiddenzhip-height side cameras place torso and arms in frame; head and feet are implied beyond frame edges, not both fully visible togetherzfull body shots require either eye-level or high-angle framing where head and feet both fit; low cameras + full silhouette in one frame is forbidden)zmlow camera at ground/quay/floor level + frame-edge surface described at chest/waist height behind the subjectzXoverhead high angle + feet visible at the lower frame edge with floor visible below themzVhip-height side camera + full silhouette including head and feet visible in same framezIlow angle looking up + ceiling and floor both fully visible in same frame)zxlow observer at ground level, shoes and lower legs occupying the lower frame, upper body extending toward the upper edgezxoverhead high angle from above, the top of head and shoulders fill the upper-center frame, the floor visible around themziat hip height beside the subject, torso and arms in frame, head and lower legs implied beyond frame edgeszhlow angle looking up at the figure, ceiling lamps in the upper frame, the wall behind extending downward)z6identify the camera position phrasing (height + angle)z[list elements described inside the frame (foreground prop, body parts, background surfaces)zdverify each element's vertical/depth placement is geometrically consistent with that camera positionzIif mismatch found, adjust frame-edge description to match camera positionuT2I 모델은 카메라 위치와 frame 안 요소 vertical 좌표 모순 시 절충 합성 — 인물이 가구에 박히거나 신체 일부가 잘리거나 prop 이 떠 있는 부자연스러운 결과)rGrrrrrrLztwo characters share an interaction (dialogue / handing object / facing / co-watching) AND are described as foreground/background separated AND a shared surface or spatial anchor exists between them (bench / table / door / room)zgdescribe the shared surface or spatial anchor explicitly so both figures occupy the same physical space)z8fg/bg separation without naming the shared surface/spacezgisolated foreground hand reaching with another figure 'in the rear background' (no shared anchor named)zcone figure 'in the foreground' and another 'in the back' without naming the room/surface they share)z,shared bench / shared table / shared surfacezCthe same X they both occupy (X = bench, sofa, table, doorway, room)zacross the X from each otherzM crosses the air between them (interaction prop visually links the two)z sharing a single line of sight from the camera)zZdo the two characters share a single interaction (dialogue, handing, facing, co-watching)?z5is one foreground and the other background-separated?z4is the shared surface/space anchor explicitly named?z+if not, add one of the recommended keywordsufg/bg 분리만 묘사하면 모델이 두 인물을 다른 공간에 배치하거나 인터랙션이 끊긴 어색한 합성 — 공유 anchor 명시가 같은 물리적 공간 강제)rGrrrrrLuframing_scale ∈ {close, medium, wide, insert} from `shot_staging.framing_scale` enum (render_strategy.framing_scale, production SOT). LLM consumes the enum only; keyword classification is forbidden.z^the named primary subject (hand / face / object) is the only fully visible entity in the frame)u_partial visibility — shoulder slice / arm slice / sleeve / fingertips entering the frame edgeuFsoft background — out-of-focus silhouette via shallow depth of fielduAabsent — not rendered at all even if listed in visible_entitieszQsame character's full body and body-part close-up in the same frame (view mixing)zFtwo characters both rendered as sharp close-up faces in the same framezsee uL (subject_reference_policy SOT — policy enum 에 따라 ID/outlook 사용))rrrrSz3primary subject + secondary entities all renderableuobody-part close-up of any character is forbidden in wide/medium framing — close-up belongs in a separate shotzSif two characters are rendered fg/bg separated, also apply fg_bg_shared_anchor_rule)rrrrS)z_read framing_scale enum from render_strategy.framing_scale (do NOT infer from camera_direction)zeif close: verify only primary subject is fully visible; other entities are partial / soft bg / absentzGverify same character's full body + body-part close-up are not combinedz6if close: verify two faces are not both rendered sharpu한 shot 안 framing scale 가 일관되어야 모델이 단일 카메라 셔터로 해석. close/wide/medium 혼합은 multi-camera 합성으로 인식되어 인물 분열 / 부위 분리 / 시점 혼합 합성)rGrrrrLuRule F/G/J 의 spatial consistency 룰 통합 — camera 위치 vs frame edge 모순, fg/bg 분리 시 공유 anchor 누락, framing scale 혼합. 3 sub-rule 모두 single t2i_prompt = single camera shutter 원칙의 spatial 측면.)r{r}r|rL)rE)r{r}r|s r_build_spatial_consistency_dictrs4 "  8   #  "   /y@J 1  5 !   G' ^ B42+'>?@^^+ 6FN+ >?@^^ $  Cw?D/$< 4   rc,|ytd|DS)u`visible_entities` 안의 **인물 수**. 모르면 None (걷지 않는다). ★축 판별은 `_is_character_subject`(C## = identity 를 가진 depicted subject) 를 **그대로 쓴다.** 여기에 같은 규칙을 따로 적으면 두 곳이 따로 틀린다. Nc3VK|]!}t|trt|rd#yw)rN) isinstancerDr ).0es r z$_count_characters..s+C*QQ$)>q)A*s'))sumvisible_entitiess r_count_charactersrs+ C*C CCrcbd|d}t|tr|jdr|d|d<|S)u해당 없는 규칙의 **본문만 걷고 자리는 남긴다.** ★통째로 빼지 않는 이유: 팩 `scene_detail/*/system.md` 가 세 규칙 이름을 직접 부른다(「카드가 …를 담고 있다」). 키가 없으면 **「준다는데 없다」** 는 지금보다 나쁜 모순이 된다. ★`applies_when` 은 남긴다 — 왜 해당이 없는지 그 자리에서 읽힌다. T)rnot_applicable_reasonrGrdictr)rulereasonouts r _scoped_outrs<!'C$$((>":">2N JrcLt|txr|jdduS)u(`_scoped_out()` 이 만든 자리인가.rTrxs r_is_scoped_outrs# a  B155)9#:d#BBrct|jdxsdjstd|d|t |j hdz }|rtd|dt |d|y ) uk걷힌 자리도 **정확한 모양**이어야 한다. ★2026-08-26 Codex BLOCK-1: 카드 반환 직전 `assert_card_shape()` 가 원래 키를 요구해 **플래그 ON 이면 카드 생산이 통째로 죽었다**. 내 시험은 `build_render_strategy` 까지만 태워 그 끝점을 건너뛰었다. validator 에 이 갈래를 넣어 계약을 **명시적으로** 넓힌다 — 「해당 없음」이 계약의 일부가 된다. ★아무 dict 나 통과시키면 validator 가 있으나 마나다. 사유는 반드시 있어야 하고, 정해진 세 칸 밖은 못 넣는다. rstep.contract_violationu3 가 not_applicable 인데 사유가 비어 있다 codemessage>rGrru) not_applicable 자리에 예상 밖 키  N)rDrstripr setkeyssorted)rpathr 남은키s r_assert_scoped_out_shapers quu,-3 4 : : <*vPw   AFFH !CCI*vFy)*!E74  rcttdds|St|}|jd}t |trq|t t tfvr^t|}|t k(r#t|jdd|d|d<n"t|jdd|d|d<||d<|'|d kr"t|jd d |d |d <|S) u확정된 framing·인물 수로 **해당 없는 규칙만** 걷는다. 플래그 OFF 면 **받은 것을 그대로** 돌려준다(한 글자도 안 바뀐다). !card_spatial_rules_scoped_enabledFr|rzframing_scale=u< — wide/medium 규칙은 이 샷에 해당하지 않는다ru6 — close 규칙은 이 샷에 해당하지 않는다rr}u*이 샷의 visible_entities 에 인물이 uM명이라 두 인물 사이의 공유 anchor 규칙은 성립하지 않는다) getattrr rrr FRAMING_CLOSE FRAMING_WIDErr)spatial framing_scalecharacter_countrpfrs r_scope_spatial_rulesr6s 8@% H w-C ''( )C#t <39"93i M )'2+, 0))(*C# $ *5-. 0))**C% &'* "#"!';*5 GG. /88IJN N+O &' Jrcrttdds|S||dkDr|Sd}|Dcgc] }||vs| c}Scc}w)u 걷어낸 규칙을 **가리키는 지시**도 같이 뺀다. ★`_scope_spatial_rules` 만으로는 **걷다 만다.** `constraints[3]` 은 two characters in fg/bg separation **must** share a named surface/space anchor — see …fg_bg_shared_anchor_rule 라고 **명령형**으로 말한다. 인물이 한 명 이하인 샷에서 규칙 본문만 걷고 이 줄을 두면, 모델은 여전히 「두 인물이 …해야 한다」는 지시를 받는다. 없앤 것을 가리키는 지시가 남는 것이 더 나쁘다. ★**새 문장을 짓지 않는다.** 「해당 없음」 문구를 새로 쓰면 이 파일의 하드프롬프트가 더 는다. 해당 없는 줄은 그냥 뺀다 — 인물 한 명 샷에 그 재료는 필요가 없다. ★`render_strategy.constraints` 를 인덱스로 읽는 코드도, 이것만 따로 읽는 소비자도 없다(팩이 카드 JSON 을 통째로 읽는다). 길이가 줄어도 깨지는 자리가 없음을 확인했다. rFr,spatial_consistency.fg_bg_shared_anchor_rule)rr ) constraintsr표cs r_scope_constraintsrisM* 8@% H/A"5 8C" 3{!clA{ 33 3s 44c gdS)uG4.5a — spec §2.2 constraints 5 strings (G4.4 base 2 carry + 3 신규 spatial inline references). PR4-B6 carry: G4.4 base 2 strings 보존 — `[0] one prompt captures one still moment / [1] do not combine full-body framing and body-part close-up in one frame` 그대로. G4.5a 신규 3 strings — camera_frame_rule / fg_bg_shared_anchor_rule / primary_framing_rule 의 inline reference. RO-9 invariant: builder-static — 입력 무관 항상 동일 list. )z$one prompt captures one still momentzDdo not combine full-body framing and body-part close-up in one frameucamera position and frame-edge elements must be geometrically consistent — see render_strategy.spatial_consistency.camera_frame_ruleutwo characters in fg/bg separation must share a named surface/space anchor — see render_strategy.spatial_consistency.fg_bg_shared_anchor_ruleuframing_scale binds entity rendering — close = primary subject only fully visible, wide/medium = no body-part close-up — see render_strategy.spatial_consistency.primary_framing_rulerrr"_build_render_strategy_constraintsrs  rrc ddlm}m}|xsijdxsd}|xsijdxsd}|xs|} |xsijdxsd} |xst} |xsijdxsd} t } t }||xsijdnd}|||}|||}||xsijd d ur?t||}t|}t| |d dd| t| || |t|| d Stdd|xsijdd|xsijddt||}t|}t| |d | | | t| || |t|| d S)uIspec §4.1 — render_strategy field. Q2 (spec §10): mode 는 builder-derived (direct default). 미래에 shot_selection.recommended_strategy schema 가 생기면 그쪽이 우선. R1-I1 (no silent fallback): staging 부재는 두 분기 — (a) shot 이 staging 필수인데 부재 → AppError (silent fallback 금지). (b) shot_info 가 명시적으로 `staging_not_applicable=True` → mode='not_applicable'. `source="fallback"` 표현 전체 삭제. G4.5a (2026-05-05): spatial_consistency 신규 sibling nested dict 추가 (4 sub-key — camera_frame_rule (7 keys, RO-3 — core_principles 4-entry list 추가) / fg_bg_shared_anchor_rule (6 keys) / primary_framing_rule (5 keys + close_framing_rules 4 incl subject_reference_policy_cross_ref / wide_medium_rules 4 incl subject_reference_policy_cross_ref) / rationale_summary). constraints 2 → 5 strings 확장 (G4.4 carry 2 + 3 신규 spatial inline). 양 분기 모두에서 `spatial_consistency` 4 sub-key 는 builder-static (입력 무관) — RO-9 invariant. PR4-B2 binding: spec §2.2 ground-truth source. PR4-B3 binding: cross-card refs in primary_framing_rule only (NOT camera_frame_rule). PR4-B6 binding: G4.1+G4.4 base 8 keys 보존, NEW sibling 추가만. PR4-B9 binding: `_CONTINUITY_ID_POLICY_CROSS_REF_LITERAL` (G4.4 line ~240 defined) 직접 in-module reference — NO self-import. `_card_metadata.lift_status.spatial_*_lifted` 4 신규 key + rule_source 3 신규 key 는 build_render_prompt_card wrapper 책임 (Task 1.5). Area Frame Spatial Contract (2026-05-14): `visible_entities` (Optional List[str], default None for legacy callers) + `frame_spatial_contract` carry sibling. staging.frame_spatial_contract 가 None 이면 None pass-through, object 이면 frame_spatial_contract.validate_and_prepare 가 shape validate + constraint_id assign + visible_entities cross-check. 양 분기 (staging is None / 정상) 모두 frame_spatial_contract sibling 포함 — assert_card_shape 의 inline nullable shape check 와 정합. r)!filter_fsc_constraints_to_visiblevalidate_and_preparecamera_directionr lighting_moodprimary_subjectNframe_spatial_contractrTz/single still moment from the selected shot only)rr)r) moderr moment_lockrrperception_modespatial_consistencyrrrz>build_render_strategy: staging is required but missing (scene=r, shot=rzi). Set shot_info['staging_not_applicable']=True if intentional, otherwise upstream staging must populate.r) app.core.frame_spatial_contractrrrRENDER_MODE_DIRECTrrrrRENDER_MODE_NOT_APPLICABLErrr )segrrrr_fsc_filter_to_visible_fsc_validate_and_prepareshot_cam staging_camcam_dirlightingpmprimaryrrraw_fsc fsc_prepared _framing_na _인물_naframing_인물s rbuild_render_strategyrsX R$$%78>BH=b%%&89?RK%XG 2""?39rH  ..BB##$56<"G :;46K @G?Rw}"!!":;X\G %W.>?G,L  O !9 :d B;GYOK*+;, u1C##O##, , <자세 표현>)zvisual_world_rules.regionzvisual_world_rules.erazshot context outfit hintuRno work-specific proper nouns (character names, place names) — common nouns onlyu한 작품 내 region 표기는 일관 — 선택된 세분 ethnicity (East Asian / Southeast Asian / South Asian / Caucasian / Black / Hispanic / Latina|o / Middle Eastern) 를 작품 단위 고정) required_on_first_appearanceapplies_to_id_formstoken_count_range componentsformat_template_aformat_template_bsource_priorityscenario_dependency_banregional_consistency)uID format for visible subjects (C## bare, C##O## composite IDs, or common-noun descriptor) is determined per-subject by the id_policy per-subject policy array — see constraints[2] belowudo not use C##O## for a reproduced face inside any element flagged by id_policy.reproduction_surface_rule.applies (declared reproduction surface) — use a generic descriptor with demographic instead. NOTE: the physical photo/poster/document/picture-frame/map/key prop itself MUST use its P## ID — the generic-descriptor rule applies only to a face reproduction, not to the prop entity.uper-subject identity reference policy is provided in id_policy.subject_reference_policy[] — apply each subject's policy when emitting references: (a) id_and_outlook_required ⇒ subject must use C##O## composite ID; (b) base_id_required ⇒ subject must use bare C## only (no outlook); (c) generic_descriptor_allowed ⇒ subject must NOT use C## or C##O##, render with a common/demographic descriptor only. omitted subjects default to id_and_outlook_requireduwhen an ID is required for a subject (policy = id_and_outlook_required or base_id_required) and a C##O## (or C##) is introduced for the first time in this t2i_prompt, append a 1-2 token demographic descriptor (ethnicity + age band, or ethnicity + role hint) consistent with visual_world_rules.region — never use scenario-specific proper nouns. does not apply to generic_descriptor_allowed subjects (no ID emitted)uwhen an ID is required (policy = id_and_outlook_required or base_id_required), use the format `C##O## in <옷 1-3 단어>, ` or `C##O##, , <자세 표현>` — main characters with face refs may include this descriptor too (image inject takes precedence). does not apply to generic_descriptor_allowed subjects — those use a common/demographic descriptor with no C##/C##O##ruthis shot's perception_mode involves a reflective/projected surface — all reproduced faces use common nouns even if the source identity is knownz:a reproduced face inside any declared reproduction surfacezunregistered extraua physical photo/poster/document/picture-frame/map/key prop appearing in the scene — use its P## ID and preserve canonical content from entity_canon) allowed_base_entity_idsallowed_outlook_pairs must_use_composite_character_idsrid_use_required_whendemographic_fallback_requiredface_identifiability_rulereproduction_surface_ruledemographic_descriptor_policysubject_reference_policyr)r rrrrrrDr$rr%rr,r/rappend) r outlook_pairsrrsubject_reference_policiesr7r elemdcr8r9rrs rbuild_id_policyr@cs>*M  *M   O / &  5 .!4G $%@=Dz**+2dXR9 XX, -"c"bBhF=  4 4F+B61F=>?qB  . .GA HJ 6 !)- %x0V670]+&  TP   B7%!PCKX  $HB!"% Y $((8#9!%m!4,0 I & ,! *.&?%>)F$>"= rc| tdd|stddgdddgdS|rt|d gdd gd dS|stddgddd gdSd}|rG|j d d|j dd|j dd|j ddd}g}|r|r|j gdnA|r|s|j ddgn)|s|r|j ddgn|j dt|dt||d|dS)ugspec §4.3 — background_binding field. G3.2 R5-B4 carryover: close framing 은 owned / camera_meta / guide 3 종 모두 skip. is_close_framing 판정은 caller 책임. Hash relationship (spec §4.3): card hash 가 owned list 변경 잡고, G3.2 sentinel hash (variation-level) 가 t2i_prompt 변경 잡음. 둘은 분리된 scope — card 가 G3.2 sentinel 을 대체하지 않음. R1-I12 (Wave 4 R4 I2): bg_owned 가 None 이면 producer missing → AppError fail-fast. 명시적 [] 만 valid (= "no owned objects" 의 의도). 옛 silent `list(bg_owned or [])` 패턴은 None ≠ [] 차이를 흡수해 진단 신호 손실. G4.2 (2026-05-04): - skipped_close_framing 분기: 6 ground-truth 문구 + 4 Rule A invalidation forms 를 합쳐 5-string constraints 로 재구성 (R1-I2 / R2-B3). - background_ref_attached 분기: owned/camera 4 sub-case (A/B/C/D) 명시 — sub-case D fallback 은 "ref 있는데 owned/camera 둘 다 없음" 진단용 문구 (R1-I1) — 이전 implicit empty list 대체. - Rule A (camera) / Rule C (owned) / Rule E (close skip) prose 가 v16 system.md 에서 lift 되어 이 함수의 constraints 가 single source. - `_card_metadata.lift_status` / `rule_source` 는 envelope sibling 으로 `build_render_prompt_card()` 가 작성 (R1-B1). Nrubuild_background_binding: bg_owned is None — upstream producer (chain_bg_owned_by_shot loader) did not populate. Use explicit [] for intentionally empty (no owned objects).rnoneFuibackground_mode is off — no chain_bg reference is attached and no owned-object preservation is required)rbg_idreference_usage owned_objectscamera_reference"close_framing_skips_background_refrrT)ufthis shot uses close framing — the background reference is intentionally omitted at composition timezldescribe the close subject and its immediate surroundings without relying on the absent background referencez7use [L##: ...] block for frame-edge surface descriptionuino chain_bg is bound to this shot — describe the location freely without referencing a background imagecamera_positionr camera_height lens_hint framing_notes)rHrIrJrK)powned_objects lists all environment objects already drawn in the background reference — do not create new oneszif focusing on an owned object, declare its reference-kind via the reference_phrase_kinds sidecar (producer contract); do not enumerate forbidden phrasings herecamera_reference specifies the framing under which the background was painted — match camera_position, camera_height, and framingif deviating from the reference framing (push-in, angle shift, ECU), state the deviation explicitly so the compositor can account for the scale differencerLzuif focusing on an owned object, declare its reference-kind via the reference_phrase_kinds sidecar (producer contract)rMrNuthe chain_bg reference is attached but carries no owned-object list and no camera metadata — describe the scene freely while staying consistent with the reference image overall moodr8) r BG_MODE_OFFBG_MODE_SKIPPED_CLOSEBG_MODE_NOT_APPLICABLErextendr;BG_MODE_REF_ATTACHEDr)rCbg_ownedbg_camera_metabg_guideis_close_framingbackground_mode_oncam_refrs rbuild_background_bindingrZ}sB*N   % $27?  )6 $26   *% $27{  G-112CRH+//D'++K<+//D    KG  ' ~ D  ' R i   k %-h#.3"  rc | tdd| tdd| tdddddd d d d }d gdgdtddddddgdddddgddddd}ttd d!d"d#td$d%d&d'd( }d)d*d+d,d-d.td/d0g}t j t|t j t|t j t|||||d1S)2u- spec §4.4 / §2.2 — continuity_elements_used field. Empty policy: 빈 list 는 valid (upstream 이 명시적으로 빈 list 반환). silent fallback 차단은 caller (scene_consistency partial / violation status) 가 이미 처리. R2-B4 (spec R1-I12): None 입력은 producer missing → AppError. 명시적 [] 만 valid. `or []` silent absorb 패턴 제거. R1-I2 (lossless adapter): producer field 9개 (element_id / element_type / character_name / description / applies_to_shots / source_facts / visual_inferences / creative_decisions / confidence) 그대로 보존. drop / transform / rename 금지. derived hint 가 필요하면 별도 `_card_metadata` 키로만. R1-I7 (no truncation, full list): forward_zoom_targets 와 각 keep_elements (list[{label, kind}], Area D-next 2026-05-14) 모두 full list. cap 금지. CLAUDE.md 절대 규칙 (LLM-bound data 무절단) 적용. CLAUDE.md 절대 규칙: input 무절단 — fixed_element description 의 raw text 그대로 보존. deep copy 로 lossless 보장 (mutation 차단 + 원본 필드 모두 보존). G4.4 (2026-05-05) — Override O-6 명명 정정 (3 new sibling policy dicts): - cross_shot_id_substitution_rule (6 required keys) 신규 sibling policy dict — fixed_element 의 character_name → C##/C##O## 매핑 시 보통명사 인물 묘사 치환 + 이중 묘사 금지 + 자세 보존 + 반복 금지. - ref_usage_constraints (3 sub-key: zoom_in_detail / exact_background / atmosphere_reference, 각 5/5/4 required keys) 신규 sibling policy dict — ref_usage 별 forbidden/required wording. - view_consistency (9 required keys) 신규 sibling policy dict — single-camera rule + Focus area 의미 + prop orientation + Area #1 per-subject reference cross-ref (Override O-7 paired-string substring `_CONTINUITY_ID_POLICY_CROSS_REF_LITERAL` — value = id_policy.subject_reference_policy). - constraints G4.1 base 2 → G4.4 7 strings. Override O-4 carry: forward_zoom_targets shape 변경 절대 금지 (G4.4 lift 대상 아님). detail_steps.py:1566-1620 forward zoom prose inject 별도 mechanism, v19 LLM consumer 영향 0. Override O-9 invariant — 3 new sibling policy dicts 는 builder-static (입력 무관 항상 동일 dict). `if previous_shot_refs:` 류 truthy guard 안 배치 절대 금지 — fixed_elements=[] / previous_shot_refs=[] / forward_zoom_targets=[] 빈 입력에서도 모두 present 보장. rubuild_continuity_elements_used: fixed_elements is None — upstream producer (scene_consistency) did not populate. Use explicit [] for intentionally empty.rubuild_continuity_elements_used: previous_shot_refs is None — upstream producer (shot_dependency_t2i) did not populate. Use explicit [] for intentionally empty.ubuild_continuity_elements_used: forward_zoom_targets is None — upstream producer did not populate. Use explicit [] for intentionally empty.zfixed_elements[i].character_name maps to a C## allowed in id_policy.allowed_base_entity_ids OR a C##O## in id_policy.allowed_outlook_pairszreplace the common-noun person reference inside fixed_elements[i].description (e.g. 'An Asian man' / 'a woman' / 'a figure') with the matched C## or C##O##udo not describe the same character with both a C##/C##O## and a separate common-noun person reference in the same t2i_prompt — produces phantom extra figuresuvfixed_elements[i].description 의 자세/위치/상태 keyword 는 그대로 유지 — 인물 참조 토큰만 교체u이미 t2i_prompt 안에서 같은 인물의 자세를 묘사했다면, 같은 fixed_element description 을 별도 문장으로 반복하지 마라ufixed_element description 이 보통명사로 작성되었고 같은 인물의 C## 묘사가 t2i_prompt 에 따로 있으면 모델이 두 인물로 인식해 인원 수가 부풀려진다rFzYsame moment, same space, same primary subject; camera moved/zoomed onto a sub-region only)z!new persons not in the prior shotznew props not in the prior shotz-new background elements not in the prior shotz9new poses, gestures, or expressions not in the prior shotzdifferent moments of action)z6describe only the focused sub-region in concrete termszIexplicitly state the same environment (lighting, background) is preservedzTuse continuity tokens such as 'the same figure', 'the same room', 'the same surface'z applies per-subject; policy enum (id_and_outlook_required / base_id_required / generic_descriptor_allowed) determines C##/C##O## useuzoom_in_detail = 앞 샷의 특정 영역을 확대한 '같은 사진'. 새 정보 추가 금지 — 현재 프레임이 보여주는 부분만 정확히 묘사rOz|same room, possibly different moment or angle; background carries through, persons/actions are described fresh for this shotz?new persons, poses, expressions, actions for this shot's momentz+different camera angle within the same roomzsbackground elements established in the prior shot must remain consistent (no contradictory walls, doors, furniture)umignore/keep directives are auto-applied via reference image processing — do not echo them inside t2i_promptu같은 공간, 새 순간 — 인물·동작은 이 샷의 instantaneous moment 로 묘사하되 배경은 prior shot 과 일관rUuTdifferent room/floor/angle entirely — only mood/tone is shared with the prior shot)z$furniture layout from the prior shotz"wall positions from the prior shotz3specific architectural features from the prior shotzdescribe the new space's background directly in this shot; carry through only color tone or lighting mood (e.g. 'cool gray ambient' / 'dim warm pool')uatmosphere_reference = 분위기 reference 만, 레이아웃 reference 아님. 가구·벽 배치를 끌어오면 모델이 두 공간을 한 공간으로 합성rZr6zone t2i_prompt = one camera position. third-person full body and close-up of the same character must not be combined in a single prompt.zdescribe persons with full or partial body in frame; single-camera consistency forbids combining a partial close-up and the same character's full body in one promptzyan isolated framed area of a single subject must not coexist with that subject's full-body description in the same promptzoany framing-intent wording designates the area shown by the single camera position; it does not switch the viewu — subjects with policy = 'base_id_required' or 'generic_descriptor_allowed' must not use outlook reference (C##O## form); additionally, subjects with policy = 'generic_descriptor_allowed' must not use bare C## either — render with a common/demographic descriptor onlyuprops the character holds must face one direction only — toward camera OR toward character, not both. forbidden contradiction example: 'photo angled partly toward the camera' + 'eyes fixed on the photograph' (양방향 모순)Tusingle t2i_prompt = single camera shutter at 1/1000s. 시점 혼합은 모델이 두 카메라 합성으로 해석해 인물이 두 번 등장 또는 부위 분리r^ufixed_elements are continuity inputs derived from prior shots — treat them as binding context, not as source facts to be inventedaPwhen fixed_elements[i].character_name maps to a C## in id_policy.allowed_base_entity_ids or a C##O## in id_policy.allowed_outlook_pairs, replace the common-noun person reference inside fixed_elements[i].description with that C##/C##O## and do not also write a separate common-noun reference for the same character in the same t2i_promptuprevious_shot_refs with ref_usage='zoom_in_detail' must preserve the same moment, the same space, and the same lighting as the prior shot — no new persons, props, background elements, poses, or momentszprevious_shot_refs with ref_usage='exact_background' may freely describe this shot's persons, poses, and moment, but must keep background elements consistent with the prior shot's established roomuprevious_shot_refs with ref_usage='atmosphere_reference' must describe a new space directly — do not import furniture layout or wall positions from the prior shot, only mood/toneuone t2i_prompt = one camera position — third-person full body and close-up of the same character must not be combined in a single shot. any framing-intent wording designates the area shown by the single camera position, not a view switch (z applies per-subject)ubprops held by characters face one direction only — toward camera OR toward character, never bothfixed_elementsprevious_shot_refsforward_zoom_targetscross_shot_id_substitution_ruleref_usage_constraintsview_consistencyr)r rErr5 _copy_moduledeepcopyr\s rbuild_continuity_elements_usedresl*;  !*;  #*;  & .  9  -  B T ,3'#J6$ #;; $ODJ- 8-" ? *!! {Rr"&&G!H   ?  K B778C C B ! *O+b P  F   D 888M  O 5]1Kj'//^0DE*33D9K4LM , 5 5 % &! ,K!6,"  rvisual_identitypreserverequireduse_entity_reference visual_target single_shotz ^P[0-9]+$c || tddddlm}t|}g}|D]}t |t s$tddt |jd|jdd k7rL|jd xsd j}|r||vrvtj|stdd |d ||jd|} | s|j||jg} t|dD]F\} }| jd| d||gtd|t dgt"t$t&t(dgdH| S)u6Area B — visible prop ∩ visual_identity.reference_required=true → contract list. B-min: dimension=visual_identity, single target (prop short_id ^P[0-9]+$), single requirement, single_shot scope. card-local rc_NNN. deterministic sort by target_entity_id (lexicographic). Raises: AppError (entity_metadata.shape_violation) — stale visible_entity_details (helper get fail-fast). AppError (render_prompt_card.render_contracts_malformed) — None inputs or non-dict entries or invalid prop short_id pattern. -render_prompt_card.render_contracts_malformedznbuild_render_contracts: visible_entities / visible_entity_details must not be None. caller contract violation.rr)&get_visual_identity_reference_requiredzGbuild_render_contracts: visible_entity_details entry must be dict, got r entity_typepropshort_idrz&build_render_contracts: prop short_id z= does not match ^P[0-9]+$ pattern (B-min entity_id contract). metadata_json)rqr)startrc_03dr shot_indicesduration entity_idrole dimension operationstrengthreference_policy contract_idscopetargets requirements)r app.core.entity_metadatarnrrrrrrr_PROP_ENTITY_ID_REmatchr;sort enumerate_AREA_B_DURATION_AREA_B_TARGET_ROLE_AREA_B_DIMENSION_AREA_B_OPERATION_AREA_B_STRENGTH_AREA_B_REFERENCE_POLICY) rvisible_entity_detailscurrent_scene_indexcurrent_shot_indexrn visible_sidsprop_candidatesentrysidrbr contractsidxs rbuild_render_contractsrUs(#9#A@?  P'(L"$O'%&D$$(K$8$8#9<  99] #v - yy$*113c- !'',D?##.-q2    #z 1D:155;O:RS--2>-B1-E,FG--7L;   % % @N;;-xS->->(?'@C   sBC!1CCc g}|D]w}|jdxsg}|jdxsg}|D]D}|jd}|jd}|jd}|jd} |tk7r*tdd|d |jd d td  |tk7r*tdd|d |jd d td  |tk7r*tdd|d |jd d td  | t k7r*tdd| d |jd d t d  |D],} | jdxsd} |j d| dd.Gz|S)uArea B — schema-pass contract input 가정 + 방어적 second check. B-min: dimension=visual_identity, operation=preserve, reference_policy= use_entity_reference 조합만 honor → {"kind": "prop", "id": entity_id, "policy": "required"} emit. Raises: AppError(code="render_prompt_card.render_contracts_malformed") on unknown dimension/operation/policy (방어적 second check — validator 우회 시 consumer fail-fast). rrr}r~rrrmz7required_refs_from_render_contracts: unknown dimension z in contract rz. B-min consumer honors only rrz7required_refs_from_render_contracts: unknown operation z6required_refs_from_render_contracts: unknown strength z>required_refs_from_render_contracts: unknown reference_policy rzrrprhkindidpolicy)rrr rrrr;) rresultrrrreqdimoprrtgtrzs r#required_refs_from_render_contractsrs$&F %% "(buu^,2 C''+&C%Bwwz*HWW/0F''HQ'quu]/C.FG66G5J!M&&HQ& aeeM.B-EF66G5J!M++HP#,mAEE-4H3KL66F5IL11H,,2:]55/22O36a9GGK06B  "#(Y l Mrc t|ts tS|jd}t|ts tS|jdxsdDchc]&}t |j r t |(c}Scc}w)uq정책 manifest → **조사가 올린** short_id. ★`text_only` 쪽과 반대다. ★`extract_text_only_subjects` 는 **내리는** 목록이라 여기 못 쓴다. ★★★**구조화된 칸을 읽는다.** 전에는 `reason` 에 특정 낱말이 있는지로 뜻을 되살렸는데, 그건 저장소 계약(「글자/substring 으로 의미 판단 금지」)에 정면으로 어긋나고 **문구만 바꿔도 강제가 사라진다** (Codex). `compute_episode_reference_policy` 를 부르는 스텝이 이미 `grounding.research_required_short_ids` 로 남긴다 — 그것이 정본이다. groundingresearch_required_short_idsr)rrrrrDr)manifestgrs r_research_forced_from_policyrds| h %u  [!A a u UU#@AGRG Gq1v||~ FG  s+B c g}g}|s|S|xsdDchc]6}t|jdt|jdf8}}|du}t}|xsdD]m} t| trA|j t| jdxs| jdxsdT|j t| oddlm} m} m } m } t|Dchc]'}t|jst|)c}D]|}| |}| | || k7r|j|*| |}||j|F|r||vrM||f|vrT|j||d d d |j ||f~|rtjd t||Scc}wcc}w) uw조사가 강제한 참조를 **owner 별로** 만든다. ★이미 있는 것은 안 겹친다. ★★`text_only` 를 내리는 overlay 와 **반대 방향**이다. 그쪽은 빼는 것이고 이건 **더하는 것**이라, 그 경로를 재사용하면 아무것도 안 더해진다. ★안 보이는 엔티티에는 안 건다 — 이 컷에 없는 것의 참조를 요구하면 「없는 참조」로 막힌다. ★★★**owner 를 명시로 허용한다** (Codex). `else "prop"` 로 두면 `L##` (location)·outlook·모르는 owner 가 **prop 참조로 오분류**된다. ★★★2026-09-01 두 가지를 고쳤다 (Codex 재현) — ①**owner 를 kind 로 그대로 내지 않는다.** `reference_owner_of` 는 갈래(`location`·`outlook`)를 주는데 `required_refs` 의 kind 어휘는 `character`/`character_outlook`/`prop`/`background` 다. 그대로 내면 **없는 kind** 가 실려 하류 계약과 어긋난다. 갈래→kind 는 `reference_kind_of_owner` 한 곳이 안다. ②**정책 문이 맡은 갈래만** 받는다. 장소·장소부분은 배경 묶음이, 아웃룩은 인물 아웃룩 자리가 **이미 붙인다** — 여기서 또 required 로 올리면 같은 것이 두 벌이 된다. 안 받되 **조용히 버리지도 않는다**: `unsupported_owner` 로 낸다. rrrNrqrr)ENFORCE_BY_POLICYenforcement_gate_ofreference_kind_of_ownerreference_owner_ofrhu1grounding: 조사가 필요하다고 확정됐다)rrrruresearch_forced_refs: 정책 문 밖 owner 라 여기서는 참조를 안 만든다 %s — 장소·장소부분은 배경 묶음이, 아웃룩은 인물 아웃룩 자리가 붙인다 (`REFERENCE_ENFORCEMENT_BY_OWNER`))rDrrrradd.app.modules.pipeline.grounding_entity_contractrrrrrrr;loggerwarning)forcedalreadyrr unsupportedrhavegatevisiblerrrrrrrownerrs rresearch_forced_refsrws*!#CK  =D]] L]qSv QUU4[!1 2]D L 4 'DeG$"$ a  KKAEE*-BtBC D KKA  %v@v!Qs1vv@A"3' =/6:KK   s # &u- <   s #  Cw&  #;$   DzQS T $!B" E ;   ! J[ M,As;F<'G G)used_outlook_pairsstate_variant_charsresearch_forced_short_idsc | tdd| tdd| tdd| tdd|r|n t} g} t} |D]} t| ts$tddt | j d| j d xsd }| j d xsd }|r|sf|||f|vrot||d }|jdk(r+|| vr&| jd|dd| j||jdk(r|| vr|dk(r| jd||ddg}|r|r|jdddn|r|r|s| jd|dd| jt|| jt| | |td| D}|rt}n!|st }n|rt"}n| rt}nt }| ||ddgdS)ukspec §4.5 — asset_requirements field. Q3 (spec §10): expected refs only. 실제 AssetReadiness resolver 호출은 image stage 가 hard gate. card 는 LLM reminder. R2-B4 (spec R1-I12): visible_entities / outlook_pairs 가 None 이면 producer missing 으로 간주 → AppError. 명시적 [] 만 valid. `or []` silent absorb 패턴 제거. bg_id 는 Optional[str] 이라 None 그대로 허용 (no bg_id case = bg-mode-off / not_applicable). Area B (2026-05-13): prop required_refs 영역은 render_contracts 인자에서 파생 (required_refs_from_render_contracts via). story_critical noun matching / shot text matching 모두 폐기. render_contracts 는 명시적 [] valid, None 이면 R2-B4 fail-fast. 2026-05-10 — 24-shot deterministic ref-contract fail fix: - ``used_outlook_pairs`` (Optional[Set[(cid, oid)]]) — variation 들이 실제 사용한 (character_id, outlook_id) set. 지정되면 outlook_pairs ∩ used_outlook_pairs 만 character_outlook required 에 박음. None 이면 legacy 동작 (모든 outlook_pairs union — pre-narrow path 호환). RPC 가 후보 union 으로 over-require 하던 결함 fix. - ``state_variant_chars`` (Optional[Set[character_id]]) — staging subject_state 가 immobilized (dead/unconscious/severely_injured) 인 character_id set. 그 character 의 character_outlook required 는 제외. resolver 가 character_state ref 로 attach 하므로 character_outlook 만족 X (validator P2). None 이면 legacy. (실제 derivation = detail_steps._detect_state_variant_chars, Area #2 W5.) rubuild_asset_requirements: visible_entities is None — upstream producer did not populate. Use explicit [] for intentionally empty.rubuild_asset_requirements: outlook_pairs is None — upstream producer did not populate. Use explicit [] for intentionally empty.ubuild_asset_requirements: render_contracts is None — upstream producer did not populate. Use explicit [] for intentionally empty.u|build_asset_requirements: policy_map is None — upstream producer did not populate. Use explicit {} for no policy override.z1build_asset_requirements: outlook_pairs entry is  (expected dict) character_idr outlook_idbuild_asset_requirementsrbase_id_required characterrhrgeneric_descriptor_allowedO00character_outlookrrz&close framing skips chain_bg referencerrrc3DK|]}|jddk(yw)rrpN)r)rrs rrz+build_asset_requirements..h sGhQUU6]f4hs zfdo not imply or describe a reference image that is not listed in required_refs (no phantom references)zhif a required character_outlook ref is missing, scene image generation must block before the image stage) required_refsforbidden_refsreadiness_policyr)r rrrrrrrrr;rrRrranyREADINESS_BLOCK READINESS_NAREADINESS_SKIPPED)rr<rCrWrXrrr policy_mapr_state_variantrh_emitted_char_basespaircidoid_policy forbidden_has_prop_required readinesss rrrs^*V  *V  *V  *U  7J2suN%'H%(E$%.GDz**++;= hh~&,"hh|$*   )sCj@R.R : #=  >>/ /--'(! $'',  >>9 9  .  %< 'E#-   kt')I. >   .>    OO78HIJ  OO(!8)+,GhGG#  % #  !#% 4 ;  rcDt|Dcgc]}|c}dScc}w)z1deterministic string sort with None-tolerant key.c |dut|fS)N)rDrs rz#_sort_string_list.. sQ$YA4Grkey)r)rss r_sort_string_listr s" e$e1e$*G HH$s c<dfd }tt||S)uSkey_fields 의 값을 prefix 로 sorted (deterministic regardless of caller order).ctts$tddtjddj fdDS)Nrz_sort_dict_list: list entry is rr|c3TK|]}tj|d!yw)rN)rDr)rfds rrz._sort_dict_list.._k.. s!>:aAEE!RL):s%()rrr rrjoin)r key_fieldss`r_kz_sort_dict_list.._k sO!T".5Aw''((8: xx>:>>>rr)rDict[str, Any]returnrD)rr)rrrs ` r_sort_dict_listr s ? $u+2 &&rct|ts$tddt|jdt j |}tD]}|j|d|jd}t|tr0t|jdtrt|d|d<|jd}t|trdt|jd trt|d |d <t|jd trt|d d d g |d <|jd}t|trht|jdtrt|dddg |d<t|jdtrt|dddg |d<|jd}t|tr4t|jdtrt|dddg |d<|jd}t|trt|dg |d<|jd}t|trT|jd} t| tr3t| jdtrt| dd| d<|S)uR1-I3 + R1-I11 + R2-B1: hash 입력용 normalized payload. R1-I3: semantically unordered list 모두 정렬. R1-I11 + R2-B1 (sharpened): hash payload = entire envelope EXCEPT (`_card_metadata`, `render_prompt_card_hash`). INCLUDES schema_version + shot_key + 5 semantic fields. 결과는 hash 입력 전용 (caller 의 원본 card 는 mutate 안 함). sort 대상: - background_binding.owned_objects (string list) - id_policy.allowed_base_entity_ids (string list) - id_policy.allowed_outlook_pairs (dict list, key: character_id|outlook_id) - asset_requirements.required_refs (dict list, key: kind|id) - asset_requirements.forbidden_refs (dict list, key: kind|reason) - continuity_elements_used.fixed_elements (dict list, key: element_id|element_type) - render_contracts (dict list, key: contract_id) # Area B (2026-05-13) - render_strategy.frame_spatial_contract.constraints (dict list, key: constraint_id) # 2026-05-14 — area-frame-spatial-contract rz)canonicalize_render_prompt_card: card is rrNrrErr2r3rr)rrrrrrrrr] element_id element_typerrrrrcJt|tr|jddSdS)N constraint_idrr)rs rrz1canonicalize_render_prompt_card.. s!Jq$,=,--/B( ) bff45t <*9*+*L9+;B& ' ) *B"d bff_-t 4"1?##@B  bff-. 5#2#$&(1C$EB  / 0B"d 2662B+CT J.  lN-K M  ' (B"d&5 M?' "# & 'B"dff-. c4 Z 0F%M!'M"W"C  Nrct|}tj|dddjd}t j |j ddS)ucanonical JSON sha256[:16]. Rules (spec §4 + Open Q4 + R1-I3 + R1-I11 + R2-B1): - canonicalize_render_prompt_card() 로 list 정렬 + _card_metadata + render_prompt_card_hash 제외. - sort_keys=True → dict key order 무관. - ensure_ascii=False → 한국어 / 일본어 description 무손실 hash. - separators=(",", ":") → 공백 제거 (canonical compact form). - hash 자체는 hash payload 에 포함하지 않음 (canonicalize 가 제거). TF),:) sort_keys ensure_ascii separatorsutf-8N)rjsondumpsencodehashlibsha256 hexdigest)r canonicalrs rcompute_card_hashr* sR05IjjT* fWo  >>' " , , .s 33rct|ts$tddt|jd|j d}t|ts$tddt|jdt j|dd }tj|jd jd d S) u}G4.3 R2-I2 carry — id_policy partial canonicalize hash. canary pinning block 7 field 중 `id_policy_card_snapshot_hash` 산출용. baseline / candidate id_policy shape 동일 검증. 변동 source 차단. 산출법: sha256(json.dumps(card["id_policy"], sort_keys=True, ensure_ascii=False))[:16] R2-I2 결정 근거: G4.2 의 `compute_card_hash()` 가 envelope 전체 hash — G4.3 canary 는 id_policy 변경에만 sensitive 해야 하므로 partial hash 별도. `json` / `hashlib` 은 module top 의 import 영역에 이미 존재 (G4.1 carry). fail-fast: card 가 dict 가 아니거나 `id_policy` key 부재 / dict 아님이면 AppError raise (silent fallback 금지 — `feedback_no_silent_fallback.md` carry — `card.get("id_policy", {})` 류 패턴 절대 금지). Args: card: a RenderPromptCard envelope dict (must have "id_policy" dict). Returns: 16-char lowercase hex sha256 prefix of canonicalized id_policy field. Raises: AppError(code="step.contract_violation"): card 가 dict 아니거나 "id_policy" key 부재 또는 dict 아님. rz8compute_id_policy_snapshot_hash: card must be dict (got rrrzIcompute_id_policy_snapshot_hash: card.id_policy missing or not dict (got TFrrr!Nr") rrr rrrr#r$r&r'r%r()rrrs rcompute_id_policy_snapshot_hashr- s6 dD !*T ++,A/  %I i &*!!%i!9!9 :!=  jjdGG >>'..1 2 < < >s CCrc,t|ts$tddt|jdd|vr tddt j |ddd }tj|jd jd d S) uG4.4 Override O-12 carry — continuity_elements_used partial hash. canary pinning block 의 `continuity_card_snapshot_hash` 산출용. baseline / candidate continuity_elements_used shape 동일 검증. 변동 source 차단. 산출법: sha256(json.dumps(card["continuity_elements_used"], sort_keys=True, ensure_ascii=False))[:16] Override O-12 결정 근거: G4.2 의 `compute_card_hash()` 가 envelope 전체 hash — G4.4 canary 는 continuity_elements_used 변경에만 sensitive 해야 하므로 partial hash 별도. `_card_metadata` 는 envelope sibling 이므로 자연 제외 — 추가 strip 불필요. G4.3 `compute_id_policy_snapshot_hash` 와 동일 패턴 carry (검증 완료). `json` / `hashlib` 은 module top 의 import 영역에 이미 존재 (G4.1 carry / G4.3 carry). spec §2.2 sub-shape — Override O-12 paired with O-6 namespace. fail-fast: card 가 dict 가 아니거나 `continuity_elements_used` key 부재 시 AppError raise (silent fallback 금지 — `feedback_no_silent_fallback.md` carry / Override O-8 — `card.get(...)` 패턴 절대 금지). Args: card: a RenderPromptCard envelope dict (must have "continuity_elements_used" key). Returns: 16-char lowercase hex sha256 prefix of canonicalized continuity_elements_used field. Raises: AppError(code="step.contract_violation"): card 가 dict 아니거나 "continuity_elements_used" key 부재. rz9compute_continuity_snapshot_hash: card must be dict (got rrrzIcompute_continuity_snapshot_hash: card missing 'continuity_elements_used'TFr,r!Nr" rrr rrr#r$r&r'r%r(rrs r compute_continuity_snapshot_hashr10 sH dD !*T ++,A/  "-*-  jj '(G >>'..1 2 < < >s CCrc,t|ts$tddt|jdd|vr tddt j |ddd }tj|jd jd d S) uG4.5a (PR4-B4 / PR4-I2 binding) — render_strategy 전체 partial canonicalize hash. canary pinning block 의 `render_strategy_card_snapshot_hash` 산출용. baseline / candidate render_strategy shape 동일 검증. 변동 source 차단. 산출법: sha256(json.dumps(card["render_strategy"], sort_keys=True, ensure_ascii=False))[:16] PR4-B4 / PR4-I2 binding 결정 근거: render_strategy **전체** hash (NOT narrower spatial_consistency only). G4.5a canary 는 render_strategy 전체 변경에 sensitive — spatial_consistency 만 변경되어도 hash drift, base 7 sibling (mode / primary_subject / framing_scale / moment_lock / camera_direction / lighting_mood / perception_mode / constraints) 변경되어도 hash drift. `_card_metadata` 는 envelope sibling 이므로 자연 제외 — 추가 strip 불필요. G4.3 `compute_id_policy_snapshot_hash` + G4.4 `compute_continuity_snapshot_hash` 와 동일 패턴 carry (검증 완료). spec §5.2 + §5.3 + RO-7 + PR4-B4 + PR4-I2. fail-fast: card 가 dict 가 아니거나 `render_strategy` key 부재 시 AppError raise (silent fallback 금지 — `feedback_no_silent_fallback.md` carry / Override O-8 / PR4-B1 — `card.get("render_strategy", {})` 패턴 절대 금지). Args: card: a RenderPromptCard envelope dict (must have "render_strategy" key). Returns: 16-char lowercase hex sha256 prefix of canonicalized render_strategy field. Raises: AppError(code="step.contract_violation"): card 가 dict 아니거나 "render_strategy" key 부재. rz>compute_render_strategy_snapshot_hash: card must be dict (got rrrzEcompute_render_strategy_snapshot_hash: card missing 'render_strategy'TFr,r!Nr"r/r0s r%compute_render_strategy_snapshot_hashr3l sN dD !*T ++,A/  $*$  jj G >>'..1 2 < < >s CCrc t|ts&tddt|jd|t Dcgc] }||vs| }}|rtdd|d||d}t|t st|tr |tk7r0tdd|d t|jd td ||d }t|trd |vsd|vrtdd|t|d tr9t|d t s&t|dtrt|dt rtdd|dD]A}t||trtdd|dt||jd||djd}|tvrtdd|dtd||d}d|vrtdd|t|d|d|vrtdd||d}|qt|ts&tddt|jd|d|vsd|vrtdd |t|dtstdd!||d"jd} | tvrtdd#| dtd||d$jd%} | tvrtdd&| dtd|d'|vr=|d'} t| trt j#| stdd(| d)|t%|d*|t'|d"|t)|d+|t+|d$||jd,} t| ts&tdd-t| jd|t-| D]>\} }t|trtdd.| d/t|jd|ycc}w)0uStrict shape validator. silent fallback 차단 (feedback_no_silent_fallback). G3.2 assert_owned_sentinel_shape 패턴 mirror — 위반 시 모두 AppError. R2-B2: `_VALID_RENDER_MODES` 가 `not_applicable` 포함 — validator 가 valid 로 수용. R2-I1: schema_version 은 bool-as-int reject + 정수 strict. `render_prompt_card_hash` 가 envelope sibling 으로 존재 시 16-char lowercase hex 검증. G4.2 (2026-05-04, plan-R2-I3 + R2-I5): - 검증 대상은 `_REQUIRED_TOP_FIELDS` (lines 93-97) 의 **7 envelope contract fields**: schema_version / shot_key / render_strategy / id_policy / background_binding / continuity_elements_used / asset_requirements. spec/plan 초안에서 "5 field" 표현은 5 semantic field 의미였으나 실제 validator 는 envelope 의 schema_version + shot_key 도 함께 검증 — 정정된 표현은 "7 contract field". - `_card_metadata` (envelope sibling, G4.2 R1-B1) 는 free-form: extra-key 허용, schema 강제 X (R2-I5). canonicalize_render_prompt_card() 가 hash 입력에서 제외하므로 hash 영향 0. rz%render_prompt_card must be dict (got ) rz"render_prompt_card missing fields rrz"render_prompt_card schema_version z (type=z) != z (must be int, not bool) rrrzCrender_prompt_card.shot_key must be {scene_index, shot_index} dict z0render_prompt_card.shot_key indices must be int )rrrrrrender_prompt_card. must be dict (got rrz(render_prompt_card.render_strategy.mode z not in rzPrender_prompt_card.render_strategy missing 'spatial_consistency' (G4.5a PR4-B2) rz\render_prompt_card.render_strategy missing 'frame_spatial_contract' (opt-in nullable field) NzArender_strategy.frame_spatial_contract must be dict or None, got rrzErender_strategy.frame_spatial_contract missing reason or constraints z@render_strategy.frame_spatial_contract.constraints must be list rz+render_prompt_card.background_binding.mode rrz7render_prompt_card.asset_requirements.readiness_policy rzrender_prompt_card_hash zB must be exactly 16 lowercase hex chars (matched by [0-9a-f]{16}) rrrz6render_prompt_card.render_contracts must be list (got z$render_prompt_card.render_contracts[] must be dict (got )rrr rr_REQUIRED_TOP_FIELDSboolr<rr_VALID_RENDER_MODES!_assert_spatial_consistency_shaper_VALID_BG_MODES_VALID_READINESSrD_HASH_FORMAT_RE fullmatch_assert_id_policy_shape&_assert_background_binding_items_shape&_assert_continuity_elements_used_shape _assert_asset_requirements_shaper)rrrmissingsvskrs_moderrbb_moderphvrirs rassert_card_shaperM s. dD !*7:&&'r%2  /@.Q!4-q.G@*8 5'J   B"d:b##6"@S:S*4&R 1 12%8K7LM++0'3   j B r4  " r !*4497<   r-(# . b' ."\*C0 b& -*FugN  $q'4(.)!,?DG}--.b9  $%))&1G))*:7+F-.aw8    BB&*88=w@  &b)>&?G  r)*DDI7L   % &C #t$.$$(I$6$6#7qA  3 -s":.&&+W. #m,d3.$$)7, '(,,V4Go%*=g[I)*!E74   " # ' '(: ;B !!*I&!1 2!E7<  !D( + ,"c"/*C*CB*G..rf5GGLgO D-u5*40D+EuM*40J+KUS$T*>%?G $ %B b$ *R))*"UG5  " 1!T".:1#> G,,-Rw8 MAs O8 O8ct|ts)tdd|dt|jd|t |D]D\}}t|t rtdd|d|dt|jd|d| y) Nrr6 must be list (got r5r[z] must be str (got : )rrr rrrrD)vnamerrLits r_assert_str_listrU s a *%dV,Q(()E74  12"c".)$q4 H--.bbA rct|ts)tdd|dt|jd|t |D]\}}t|t s/tdd|d|dt|jd|d| |D]9}||vstdd|d|d |d t|jd| y) Nrr6rOr5rrPr8rQz] missing required key (have keys ) rrr rrrrrr)rRrS required_keysrrLrTrs r_assert_dict_list_with_keysrY s a *%dV,Q(()E74  12"d#.)$q4 H--.bbA A{2-dV1QC8 e<rwwy0A/B"UGMrrr)r)r*r,)r7r8r9zDict[str, Tuple[str, ...]]"_ID_POLICY_SUB_FIELD_REQUIRED_KEYScd|vrtdd|t|dd|d|vrtdd|t|ddd | tj D]\}}||vrtdd |d |||}t |t s)tdd |dt|jd||D]6}||vstdd |d|dt|jd|d|vrtdd|t|ddd| |d}d|vrtdd|d|vrtdd||d}|jd}t |t s&tddt|jd|dD]P} | |vrtdd | d!|t|| d"| |t|| d#k(s?tdd$| d%|y&)'uTid_policy strict shape — G4.1 base 2 field + 3 dict sub-fields + Area #1 subject_reference_policy list[dict]. G4.1 carry: allowed_base_entity_ids (list[str]) + allowed_outlook_pairs (list[dict] with character_id+outlook_id). dict sub-fields (`_ID_POLICY_SUB_FIELD_REQUIRED_KEYS` single source): - face_identifiability_rule: 4 keys - reproduction_surface_rule: 3 keys - demographic_descriptor_policy: 3 keys (components nested 검증 별도) + demographic_descriptor_policy.components 의 ethnicity / gender / age_band 가 non-empty list[str] 검증. Area #1 (2026-05-16): subject_reference_policy list[dict] — 별도 case (loop 와 분리). Full semantic validation (enum / duplicate / unknown subject) 은 상위 normalize_subject_reference_policy_items() 에서 끝남. 여기서는 card-level structural validation 만 (defense in depth). free-form keys (strict 검증 X): role_hint_from_outfit / format_template_a / format_template_b / source_priority / scenario_dependency_ban / regional_consistency / token_count_range. r2rz?render_prompt_card.id_policy missing 'allowed_base_entity_ids' rz!id_policy.allowed_base_entity_idsr3z=render_prompt_card.id_policy missing 'allowed_outlook_pairs' zid_policy.allowed_outlook_pairs)rrrXrz%render_prompt_card.id_policy missing z (G4.3 R2-B3) zrender_prompt_card.id_policy.r7r5z missing required key rWr:z/step.contract_violation.id_policy.field_missingzJrender_prompt_card.id_policy missing 'subject_reference_policy' (Area #1) rC) subject_id policy_typerrr8applies_to_surfacesurender_prompt_card.id_policy.reproduction_surface_rule must not contain 'applies_to_surfaces' field (Area C migration regression — SOT is shot_staging.directionality_class) sourcez{render_prompt_card.id_policy.reproduction_surface_rule must not contain 'source' debug field (must live in _card_metadata) r9r,zXrender_prompt_card.id_policy.demographic_descriptor_policy.components must be dict (got )r%r&r'zNrender_prompt_card.id_policy.demographic_descriptor_policy.components missing rz3id_policy.demographic_descriptor_policy.components.rzFrender_prompt_card.id_policy.demographic_descriptor_policy.components.z must be non-empty list N) r rUrYrZrrrrrrrrlen) rrsub_field_namerX sub_fieldr repro_ruleddpcompcomp_keys rrArA s.!**--2G5   $%+Ub(*++0'3    "#)4 *L)Q)Q)S%  #.;%(ug? ~& )T*.3N3CD!!%i!9!9 :"UGE A !277GH001uL!).."234Bug?%*T@"+B88=w@    %&,G /0J **67  :*1169   , -C 77< D dD !*004T 0C0C/DBugO  8 4 .**2Qug?   NA( L  tH~ ! #.""*+CE7L 8rcLd|vrtdd|t|dd|y)z-background_binding.owned_objects (list[str]).rErz>render_prompt_card.background_binding missing 'owned_objects' rz background_binding.owned_objectsN)r rU)rrs rrBrBr sBb *##('+   ??r) r r character_name descriptionapplies_to_shots element_scope source_factsvisual_inferencescreative_decisions confidence)rr ref_usage)rrrjc t|ts&tddt|jd|t t }t |j}||ks-t||z }tdd|dt|d|tttd}|jD]\}}||}t|ts)tdd|d t|jd|t |} t |j} | | krnt| | z }tdd|d |d t| d|y ) uG4.4 nested helper — ref_usage_constraints strict shape validator (Override O-5 superset). spec §2.2 sub-shape: ref_usage_constraints 는 dict with 3 sub-keys (zoom_in_detail / exact_background / atmosphere_reference). 각 sub-key 는 dict with 4-5 required keys per spec §2.2. Override O-5: strict required-keys subset (`EXPECTED <= returned_keys`) — extra keys 허용 (G4.5 forward-compat). rzTrender_prompt_card.continuity_elements_used.ref_usage_constraints must be dict (got r5rz\render_prompt_card.continuity_elements_used.ref_usage_constraints missing required sub-keys  (have r6zBrender_prompt_card.continuity_elements_used.ref_usage_constraints.r7z missing required keys rWN) rrr rrrrNrrrTrYr]r) rur expected_top returned_toprE nested_specssub_keyrhnestedexpectedreturneds r#_assert_ref_usage_constraints_shaper| s b$ *R))*"UG5  >?Lrwwy>L L ( 45*C)76,#7"85'C  CE NL *//1G&$'.--4I6 L112"UG= x=v{{}%H$X01G.--4I5Li|F8,<+=RwH 2rc dD]}||vstdd|d|t|ddt|t|d d t|t|d d t|d |vrtdd||d }t |t s&tddt|jd|tt}t|j}||ks-t||z }tdd|dt|d|d|vrtdd|t|d|d|vrtdd||d}t |t s&tddt|jd|tt}t|j} || ks-t|| z }tdd|dt| d||d} tt } | | k7rtdd| d| d||d} | dust| t"ur)tddt| jd| d|d |vrtdd!|t%|d d"|y#)$ucontinuity_elements_used.fixed_elements (R1-I2 10-field per item — Area #4 element_scope) + previous_shot_refs (scene_index/shot_index/ref_usage) + forward_zoom_targets (scene_index/shot_index/description). G4.4 (2026-05-05) — Override O-5 + O-6 carry: 3 new sibling policy dicts strict 검증 추가 (cross_shot_id_substitution_rule / ref_usage_constraints / view_consistency). Override O-5 strict required-keys subset (`EXPECTED <= returned_keys`). extra keys 허용 (G4.5 forward-compat). spec §2.2 sub-shape — Override O-7 paired-string substring 검증은 builder 에서 hardcoded literal 로 보장; assert helper 는 key presence 만 검증. framing_scope_options 만 list equality (정확 2 entry sequence 강제) — view_consistency 의 다른 free-form key 와 차별. mixing_forbidden 은 bool True (NOT bool int subclass — G3.2 / G4.3 trap carry). r]r^r_rz4render_prompt_card.continuity_elements_used missing rrr]z'continuity_elements_used.fixed_elementsr\r^z+continuity_elements_used.previous_shot_refsr_z-continuity_elements_used.forward_zoom_targetsr`zjrender_prompt_card.continuity_elements_used missing 'cross_shot_id_substitution_rule' (G4.4 Override O-6) z^render_prompt_card.continuity_elements_used.cross_shot_id_substitution_rule must be dict (got r5zbrender_prompt_card.continuity_elements_used.cross_shot_id_substitution_rule missing required keys rWraz`render_prompt_card.continuity_elements_used missing 'ref_usage_constraints' (G4.4 Override O-6) rbz[render_prompt_card.continuity_elements_used missing 'view_consistency' (G4.4 Override O-6) zOrender_prompt_card.continuity_elements_used.view_consistency must be dict (got zSrender_prompt_card.continuity_elements_used.view_consistency missing required keys r_zcrender_prompt_card.continuity_elements_used.view_consistency.framing_scope_options must be exactly z (got reTzjrender_prompt_card.continuity_elements_used.view_consistency.mixing_forbidden must be bool True (got type=z value=rzBrender_prompt_card.continuity_elements_used missing 'constraints' z$continuity_elements_used.constraintsN)r rY_FIXED_ELEMENT_REQUIRED_KEYS _PREVIOUS_SHOT_REF_REQUIRED_KEYS_FORWARD_ZOOM_REQUIRED_KEYSrrrrrrMrrr|rfrr5r:rU) rrrcsr expected_csr returned_csrrEvc expected_vc returned_vcfso expected_fsomfs rrCrC sZ(N B;.Je1UG% N  12     56    !"71 )2*I'   . /C c4 *S **+2eW6  BCLsxxz?L L ( 45*I)<|(<'=RwH  b(*??DgG  (+B(CUK#*::?B    B b$ *R))*"UG5  @AKbggi.K ; &{23*:)<{(;'>EYG ,-Rw8   " #C c4 *S **+2eW6  c &PRWX388: =M= LG. 'y|0D/ERwP ;<(C(.!N334Bug?  3( B.Q?AB&&+W .   !C c4 *S **+2eW6  c &NPUV388: ;|K;lJG. 'y|0D/ERwP ;<(C(.!N334Bug?  3( B.Q?AB&&+W .   Crc ht|ts&tddt|jd|t |j }t|ks1tt|z }tdd|dt|d||d}t|ts&tddt|jd|t |j }t|ks1tt|z }tdd |dt|d||d }t|ts&tdd t|jd|t|d k7rtdd t|d||d}t|ts&tddt|jd|t|rt|d|nSt |j }t|ks1tt|z }tdd|dt|d|t|d|y)u?G4.5a (RO-9 / PR4-I5 binding) — render_strategy.spatial_consistency nested validator helper. Nested call chain (RO-9 / PR4-I5): `assert_card_shape() inline rs_mode region` → `_assert_spatial_consistency_shape(card)` → `_assert_primary_framing_rule_shape(sc["primary_framing_rule"])` (further nested, NOT sibling — PR4-I5 disambiguation). spec §2.2 가 ground-truth source. 4 top-level sub-key (PR4-B2): - camera_frame_rule (7 keys, RO-3 — core_principles 4-entry list) - fg_bg_shared_anchor_rule (6 keys) - primary_framing_rule (6 keys + nested) → further nested call to _assert_primary_framing_rule_shape() (RO-9 / PR4-I5) - rationale_summary (str) PR4-B3 binding: cross-card refs (`subject_reference_policy_cross_ref`) are validated inside `_assert_primary_framing_rule_shape()`, NOT here in `camera_frame_rule`. Override O-30 carry (G4.4): strict required-keys subset (`EXPECTED <= returned_keys`, set superset, NOT equality). extra keys 허용 (G4.5b/c forward-compat). rzIrender_prompt_card.render_strategy.spatial_consistency must be dict (got r5rzMrender_prompt_card.render_strategy.spatial_consistency missing required keys rsr{z[render_prompt_card.render_strategy.spatial_consistency.camera_frame_rule must be dict (got z_render_prompt_card.render_strategy.spatial_consistency.camera_frame_rule missing required keys rzkrender_prompt_card.render_strategy.spatial_consistency.camera_frame_rule.core_principles must be list (got zzrender_prompt_card.render_strategy.spatial_consistency.camera_frame_rule.core_principles must have exactly 4 entries (got u,) — RO-3 binding (v19 line 170-175 carry) r}zbrender_prompt_card.render_strategy.spatial_consistency.fg_bg_shared_anchor_rule must be dict (got rzfrender_prompt_card.render_strategy.spatial_consistency.fg_bg_shared_anchor_rule missing required keys r|N)rrr rrrrr~rrrrarrrr) scr sc_returnedrErrcpfb fb_returneds rr<r<s6 b$ * $R 1 12"UG=  bggi.K .+ =;kIJ*))0 2 ,-Rw8   !C c4 *S **+2eW6  sxxz?L 4 D 4| C *;;B)D -.b9    B b$ *R))*"UG5   2w!|* #By)"   & 'B b$ *R))*"UG5  b %SUZ["'')n ?;N?+MG.FFMYO#K01E7< 'r*@'A5Irrrcd|vrtdd|t|ddt|d|vrtdd|t|dd t|y ) zUasset_requirements.required_refs (kind/id/policy) + forbidden_refs (kind/reason).rrz>render_prompt_card.asset_requirements missing 'required_refs' rz asset_requirements.required_refsr\rz?render_prompt_card.asset_requirements missing 'forbidden_refs' z!asset_requirements.forbidden_refsN)r rY_REQUIRED_REF_KEYS_FORBIDDEN_REF_KEYS)rrs rrDrDsb *##('+    ?*(  r!*$$)7,    +) r)rrrname_by_short_idepisode_reference_policyc| t|ng}t||}t||||||d<t||}d|d|}|d}nd|vrt dd | |d}t |}t ||| }|ed d lm}|t||jdxsd|jdxsg|xsi|jd}|rt||| }|Cd dl m }||jD cic] \}} ||vr|| }!}} |!rt||!| }t!|||}"t#|"}#t%|||||#|d<t'|| | | | | |d<t)||||d<t+||t-|t-|}$t/|$t-|t-||$|d<t1|||| | |||$|"t3| |d<|dd}%|%t4t6fvrd }&n(|%t8t:fvrd!}&nt d"d#|%d$|d%|d& d d |&d d d d d d d d d d d d d'd(d)d*d+d,d-d.d/d/d/d0d0d0d1 d2|d3<t=|d4|d5|d& |Scc} }w)6uqSingle entry point — _analyze_one() 가 한 번 호출. 각 builder 는 독립적이므로 순서 무관. 호출 직후 assert_card_shape 로 self-check. 2026-05-10 — used_outlook_pairs / state_variant_chars 두 인자는 asset_requirements 의 character_outlook required_refs narrow 용 (24 shot deterministic ref-contract fail fix). LLM input 용 wide RPC build 시 두 인자 모두 None (legacy union), cp 저장용 narrow RPC build 시 LLM 응답 후 산출한 값 전달. id_policy.allowed_outlook_pairs 는 그대로 전체 후보 union 보존 (LLM 가 outfit 선택 시 후보 인지 필요). Area B (2026-05-13): visible_entity_details 는 build_render_contracts producer 진입점. None → 빈 list (legacy/test fixture 호환). 명시적 [] valid. 폐기된 노운 매칭 필터의 shot text 인자 모두 제거. Nr)rrrrrrzrender_prompt_card:sz.shotr:z>step.contract_violation.subject_reference_policy.field_missingzCshot_staging v12 missing required field 'subject_reference_policy' rrr)$detect_offscreen_referenced_subjectsrrcharacter_angles pov_character) visible_idsrr id_to_namer)extract_text_only_subjects)visible_subject_idsr)rr<rrr=r)rCrTrUrVrWrXrr~r)rrrrr) rr<rCrWrXrrrrrrrTFrz2build_render_prompt_card: background_binding.mode zI is not a recognized mode for _card_metadata.lift_status assembly (scene=rr) rule_a_lifted rule_c_lifted rule_e_lifted rule_h_liftedid_policy_composite_lifted#id_policy_close_framing_face_lifted%id_policy_reproduction_surface_lifted,continuity_cross_shot_id_substitution_lifted'continuity_ref_usage_constraints_lifted"continuity_view_consistency_liftedcontinuity_constraints_extendedspatial_camera_frame_lifted"spatial_fg_bg_shared_anchor_liftedspatial_primary_framing_liftedspatial_constraints_extendedACEHu9C## 사용 규칙 — 참조 이미지 연동 (v17:32-64)u&극단 클로즈업 표현 (v17:66-85)uA사진·포스터·화면·거울 속 인물 규칙 (v17:133-146)z-v20/scene_detail/system.md#continuity-sectionz.v20/scene_detail/system.md#spatial-consistency) camera_rule owned_ruleclose_skip_ruledemographic_rulecomposite_id_ruleclose_framing_face_ruler8r`ref_usage_ruleview_consistency_ruler{r}r|) lift_status rule_sourcerzbuild_render_prompt_card(s_sh)rrrrr rr$app.modules.pipeline.shot_visibilityrrrr!app.core.episode_reference_policyrrrrrr@rZrerr<rrrrOrPrQrSrM)'rrrrrr<rrrCrTrUrVrWrXr]r^r_rrrrr_vedrr where_srp raw_srp_items visible_basesr_offscreen_refrrr _text_onlyr policy_arrayrrIrs' rbuild_render_prompt_cardrsh)?(J #$PR   KD3 9g'* D 8KO'{m5 EI #7 2Q..7[:   :; ./?@M ?}IM >}-$[[);<B$[[);<B'-2!++o6   ;~YM +P ''? @ F F H HsAm# F H  DzM:)J :*EL')''#/ D ":h~,<-"D  (F%:L1(D #$ .)# ,z?   $z? 0D !9)&6--/)#? $#& "D .'(0G; 566 +-AB B *DWKP%gj\<  ""!*!*.3759<@7;26/3 ,026.2,0- 4" #!\'O T @@@ AAAG% 3?D @ *;-s:,aH Kw sI)rOptional[Dict[str, Any]]rrrrD)rr<rr<rr)rr)rOptional[List[str]]r Optional[int])rrrrDrr)rrrr:)rrrrDrrDrNone)rrr Optional[str]rrrr)r List[str]rrrr)rr) rrrrrrrrrrrr)rrrrrList[Dict[str, Any]]) rrr<List[Dict[str, str]]rrrrr=rrr)rCrrTrrUrrVrrWr:rXr:rr)r]rr^rr_rrr) rrrrrr<rr<rr)rrrr<rr<rr)rrrr)rzSet[str])rrr<rrCrrWr:rXr:rOptional[Set[Tuple[str, str]]]rOptional[Set[str]]rrrz!Dict[str, SubjectReferencePolicy]rrrr)r List[Any]rr)rrrrrr)rrrr)rrrrD)r)rrrrDrr)rRrrSrDrrDrr) rRrrSrDrXtuplerrDrr)rrrrDrr)rrrrDrr)rtrrrDrr)rrrrDrr)rrrrDrr)rrrrDrr)rrrrDrr).rr<rr<rrrrrrr<rrrrrrCrrTrrUrrVrrWr:rXr:r]rr^rr_rrrrrrzOptional[List[Dict[str, Any]]]rzOptional[Dict[str, str]]rrrr)__doc__ __future__rcopyrcr&r#loggingre _re_moduletypingrrrrrr r app.core.configr rr app.core.errorsr app.core.perception_moder!app.core.subject_reference_policyrrrrrrrr getLoggerrrrrRENDER_MODE_SIMPLIFYRENDER_MODE_PARTIAL_FOCUSRENDER_MODE_REFRAMERENDER_MODE_ANCHORED_REFERENCERENDER_MODE_CLOSE_INSERTrr; frozensetr$__annotations__r%r,r/r0r2r5r:r=r?rArBrErMrNrTrYr]rfrhrjrkrprsryrzr~rrrrrrrrFRAMING_INSERT_VALID_FRAMINGrSrPrOrQr=rrrr>rcompiler?r9rrrrrrrrrrrrr@rZrerrrrrrrrrrrrrrrrrr*r-r1r3rMrUrYrZrArBrrrr|rCrr<rrrDrrrrrs KX# CCC$C$?      8 $!+!5)-,.G78&3<=31:;1~ -/ " 05 / 8#_6!?1o34*C312)3234+S467.70T'S@+_<' =(/>)?C. ?*O </O0_/O 8#_ 5 //O 4 "6?@6"N.259#}}(}  }  }  }7},}+}2}" 2#}$%}HI ' )'.B'"Qh4$-D`9Dx<DFMd( &+47 H""&!B"$>0_D" *  $N J??"? ?Dcc"c cL]]"] ]@{J{J"{J {J|.(p:>.2>B26 :>CQQQ  Q  Q  Q(Q#Q&Q QQ-QQQQ )!Q"-#Q$/%Q&7'Q(,)Q0;1Q8/9QB7CQDEQr