XYjb UdZddlmZddlZddlZddlZddlZddlmZm Z m Z m Z m Z m Z mZddlmZmZej$eZej*dZdZdd d d d d ddZded<ddlmZmZd$dZd%dZ e!hdZ"d&dZ#Gdde$Z% d' d(dZ&dd d)dZ' d*dZ(d+dZ)dddd ejTddd!d" d,d#Z+y)-u floor_plan_prompt — Phase 7 Step 3 / Phase 8 v2 / D6 v4 schema. 도면별 detailed t2i prompt 생성. plot-critical 시각 요소(커튼/시체 가림 등)를 LLM이 해당 도면 spec + scene segments에서 자연히 picking하도록. Phase 8 v2: schema에 ``numbered_elements`` + ``camera_recommendations`` 추가. - numbered_elements: 도면 안 가구/문/창/소품/영역 라벨에 부여한 번호 마커 매핑. - camera_recommendations: 각 background bg_id에 대한 도면 좌표계 기준 카메라 추천. D6 v4: BG_ID_RE (`^L\d{2,3}B\d{2,3}$`) 정합 + 3-layer 방어. - L1 static schema: ``bg_id`` pattern → BG_ID_RE. 옛 lowercase 패턴 (`display`, `bg_a`, hash garbage) 구조적 reject. - L2 runtime enum injection: ``run_floor_plan_prompt`` 가 ``expected_bg_ids`` 비 어있지 않으면 schema deep-copy + ``bg_id.enum=sorted(expected_bg_ids)`` 주입. LLM 출력을 정확한 set 으로 강제. - L3 validator exact-set: ``_validate_fp_prompt_extras`` 가 cam_bg == expected_bg_ids (extras + missing + duplicate) 검사. silent fallback 회로 차단. 추가: ``build_fp_user_prompt`` 가 D6 raw intent 의 ``state_label_raw`` 필드 사용 (legacy ``state_label`` fallback 유지). ``Valid bg_ids:`` block 으로 LLM 에게 정확한 ID list 명시. ) annotationsN)AnyCallableDictIterableListOptionalSet) load_prompt load_schemau,[ㄱ-ㆎ가-힣一-鿿㐀-䶿豈-﫿぀-ヿ]floor_plan_promptz5.202605201406z6.202605262300z7.202605291624z8.202606011200z9.202606011400z10.202607081930z11.202607170145)567891011zDict[str, str]PROMPT_VERSION_MAP)"SCALE_GUIDELINE_FP_PROMPT_VERSIONS V6_COMPATIBLE_FP_PROMPT_VERSIONScv|xsgDcgc]%}|jdr|jdd'c}Scc}w)u이 fp 를 참조하는 background 들의 surface_role 을 그대로 모아 반환. dedup 없이 bg 순서대로 (count 신호 보존). 빈 리스트면 분류 정보 없음 — prompt 가 보수적으로 처리한다. 코드 의미판단 0. surface_role)get)applied_backgroundsbs \/Users/manta/Documents/Projects/TheRoad-I1/backend/app/modules/pipeline/floor_plan_prompt.pyderive_fp_space_rolesrbsH&++ +A 55  nb!+  s*6c|xsgDcgc]}|s| }}|s yddlm}djdt||j D}d|dScc}w)uYuser prompt 의 {space_type_block} 채움 (selector "8" 전용) — role 신호 relay만.zNo surface-role classification is available for this floor plan's backgrounds. Treat the space type as unknown: draw conservatively from the scope and scenes, and do NOT assume an enclosed multi-room dwelling.r)Counter, c30K|]\}}|d|yw)z xN).0rolens r z*_build_space_type_block..ys!T5S'$$r!~5SszUAn upstream model classified this floor plan's backgrounds with these surface roles: zs. Decide the diagram form from these roles together with the scope and scenes (see the Space-type adaptation rule).) collectionsr!joinsorteditems) space_rolesrrolesr!listeds r_build_space_type_blockr1os{$** 1*1qQ*E 1  S $ YYTVGEN base_openingbase_structural_unitstate_overlay_plot_cuebase_persistent_fixturebase_persistent_furniturestate_overlay_transient_objectc v t|S#t$r$}td|dtt|d}~wwxYw)uselector ("5"|"6") → on-disk pack directory name. Raises ValueError on unknown selector so a typo cannot silently route to the latest pack (the entire point of the W19A versioned-load surface). z#unknown floor_plan_prompt selector z ; allowed: N)rKeyError ValueErrorr+)selectorexcs rresolve_prompt_versionr=sQ !(++ 1(>123 5  s 838ceZdZdZy)FloorPlanPromptErroruretry 한도까지 실패.N)__name__ __module__ __qualname____doc__r$rr?r?s$rDr?rc ttdt|}|Dcgc]&}|jds|jdd(} }| rdj d| Dnd} g} |D]}|jddxsd} |jd d} |jd xs|jd xsd}|jd xsg}|rd j |nd}| j d| d| d|d|dj | xsd}dj d|Dxsd}g}|D]}|jd}|jdxsdj }|jdxsdj }|j |rd|d|nd||j ||j ddj |jxsd}| t|nd}|jd|jd|jddjd|jddjd|jddjd| jd |jd!|jd"|jd#|xsdScc}w)$u도면 user prompt — scene text 무절단 inject. .replace() 사용 (.format() brace 충돌 회피, T4/T7과 동일 패턴). D6 v4: - ``Valid bg_ids:`` block 에 정확한 L##B## list inject (LLM 이 schema pattern 으로 추측하지 않게 명시적으로 보여줌). - bg detail line 은 ``state_label_raw`` (D6 raw intent 필드) 우선, 없으면 legacy ``state_label`` fallback. W19A: ``prompt_version`` selector ("5"|"6") 를 받아 versioned-load surface (prompt_loader) 로 pack 디렉토리를 pin. v5/v6 의 user_template 이 placeholder 동일하므로 동작 차이는 없지만, latest-pack auto-resolve silent shift 를 방지하기 위해 항상 pin 한다. user_templateversionbg_idr c3&K|] }d| ywz- Nr$)r%rIs rr(z'build_fp_user_prompt..s9L5Bug,Lz(none)z (unassigned)loc_idstate_label_raw state_labelapplies_to_shotsr"z - bg_id: z loc_id: z state: z applies_to_shots: c3&K|] }d| ywrLr$)r%ss rr(z'build_fp_user_prompt..s.'s $Q1q5$rMz&numbered_elements.number must be >=1: znumbered_elements[z] not a dict under v6base_layer_decisionNz&] missing base_layer_decision under v6z] invalid base_layer_decision z under v6 (allowed: )scale_guidelinezLscale_guideline missing or too short under v10 (need string >=30 chars, got z.80camera_recommendationsrIzcamera_recommendations[z] missing bg_idrwz,camera_recommendations has duplicate bg_id: z2camera_recommendations references unknown bg_ids: z0camera_recommendations missing required bg_ids: state_overlay_)use_numbered_elementsignore_numbered_elementsz].z missing or not a list under v6[z"] is not an integer under v6 (got r~rz=].use_numbered_elements references unknown numbers under v6: z@].ignore_numbered_elements references unknown numbers under v6: uI] use_numbered_elements ∩ ignore_numbered_elements non-empty under v6: zstate_overlay numbered_elements not covered by any camera_recommendations.use_numbered_elements under v6 (overlay leak candidate): )rintlensetr?any_V6_COMPATIBLE_SELECTORS enumerate isinstancedict_V6_BASE_LAYER_DECISION_ENUMr+_SCALE_GUIDELINE_SELECTORSstrr\count startswithlistbool)" fp_resultexpected_bg_idsrcnums_rawenumsidxentrydecision guidelinecams_rawc cam_bg_listbgdupscam_bgexpectedextramissing valid_numbersstate_overlay_numberscovered_state_overlaycam_idxcamfieldarritem_idxitemuse_set ignore_set unknown_useunknown_ignoreoverlapmissing_state_overlays" r_validate_fp_prompt_extrasrshX}}017RH&. @h(a-C( hD @ 4yCD N""24& 9   $ "4TF ;  11#H-JCeT**(-BCyy!67H*(-ST;;*(-Kl"6:; & (00x!1W:xK0  I "{/@/@/Dq/H2 I JD ":4& A   F?#H X E "@ P  G">vg>O P  11&.# &.(a-C( h # '/+ &.!T"A 155!67='(334DE ( h + +.%%h/LGSc4(*-gY6KLOggen!#t,.1'"UGD./'0nNHd!$-Zc5J25gYbq S??ChaI'5O#567GS!;<=J!M1K*-gY7<P>+ QQQ Q  Q 6AQctj|}|jdijdijdijdi}d|vr%d|djddt|d|d<|S) uschema deep-copy + ``camera_recommendations[].bg_id.enum`` 주입. D6 v4 L2 방어: LLM 출력을 정확한 set 으로 강제 (schema-level constraint). base_schema 는 매 호출마다 ``load_schema`` 가 새로 반환하지만, LRU 캐시 등 공유 가능성 + 같은 process 안 반복 호출 방어를 위해 deep-copy. Returns: 새 schema dict (mutation-safe). propertiesr|r,rIstringpatternz^L\d{2,3}B\d{2,3}$)typerenum)copydeepcopyrr) base_schemabg_idsschema cam_propss r_inject_bg_id_enumrs]]; 'F <$  %r * Wb  \2   ) )--i9NOL ' MrDc0|jd|k7r td|jdd||jdxsd}tj|rtd|dt |dkrtd|d t |d y ) z3 invariants: 1. fp_id matches expected 2. t2i_prompt no non-ASCII (Korean/Hanja/kana) 3. t2i_prompt >= 30 chars rWzfp_id mismatch: got z , expected t2i_promptrfloor_plan_prompt z t2i contains non-ASCII textr{z t2i too short (ryN)rr:_NON_ASCII_TEXT_REsearchr)outputexpected_fp_idt2is rvalidate_fp_prompt_outputrs zz'n,"6::g#6"9^DV W   **\ " (bC  %  00L M   3x"}  00@S ! L  rDg@r)project_config opik_metadata max_retriesbackoff_base_secsleep_fnrrccreator_corrections_blockc 8t| } ttd| } | | xsdz } ttd| } d}| t |n t }|rt | t |}ntj| }t|D]1} |d| |||d|}t|||t||| |cStd |d |d |#t$r>}|}tjd ||d z|||d z|kr|||d zzYd}~d}~wwxYw)uLLM 호출 후 schema-validated dict 반환. Phase 8 v2: ``expected_bg_ids`` 가 주어지면 ``camera_recommendations[].bg_id`` 가 그 집합의 부분집합인지 추가 검증한다(``_validate_fp_prompt_extras``). None이면 cross-field 검증만 skip하고 결과는 dict 그대로 반환. D6 v4: ``expected_bg_ids`` 비어있지 않으면 schema deep-copy 후 ``bg_id.enum = sorted(expected_bg_ids)`` 주입 (L2 방어). validator 는 exact-set 검사 (L3 방어). schema 는 매 호출 deep-copy 되므로 호출 간 mutation 누수 없음. W19A: ``prompt_version`` ("5" default | "6" opt-in) 가 prompt_loader 의 versioned-load surface 로 plumbing 된다. v5 selector 는 5.202605201406 pack 을 정확히 pin 하고 validator 도 v5 동작 verbatim 유지. v6 selector 는 6.202605262300 pack 을 pin 하고 validator 가 모든 ``numbered_elements`` entry 의 ``base_layer_decision`` enum membership 까지 추가 검증한다. systemrGrrNr )step system_prompt user_promptresponse_schemar schema_namer)rrrcz-floor_plan_prompt %s attempt %d/%d failed: %srwrz exhausted z retries: )r=r rZr rrr+rrrangerr Exceptionloggerwarningr?)rrcall_structured_fnrrrrrrrcrresolvedrrlast_errbg_setrattemptresultr<s rrun_floor_plan_promptrsP>&n5H (H =F '-2-FgxBK$(H/>/Js?+PSPUF #K@{+% ;'($' &-/+F &fn =**$$*#1 M%&6  ^,K }JxjY  ;H NN?! [# {[()Wq[9: ;s,C D4DD)rList[Dict[str, Any]]return List[str])r-Optional[List[str]]rr)r;rrr)rN)r_Dict[str, Any]rrr`rrarrbrrcrr-rrr)rrrzSet[str]rcrrNone)rrrrrr)rrrrrr)rrrrrzCallable[..., Dict[str, Any]]rOptional[Dict[str, Any]]rrrrrfloatrzCallable[[float], None]rzOptional[Iterable[str]]rcrrrrr),rC __future__rrloggingretimetypingrrrrrr r app.modules.prompt_loaderr r getLoggerr@rcompilerrZr__annotations__app.core.fp_prompt_compatrrrrrr1 frozensetrr=rr?rrrrrsleeprr$rDrrs,#  EEE>   8 $RZZ        G$&N$V ( )*  %9%'+R R-RR) R  R  R%R Rr fff f  fR)28 404.2!(, /3%'MMM6 M - M , MMM&M-MM #MMrD