2j dZddlmZddlZddlmZddlmZmZm Z m Z m Z m Z m Z ddlmZej eZdZidd d d d d ddddddddddddddddddd d!d"d#d$d%d&d'd(d)id*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;dd?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdW Zd ZdZdZdZdXZdXZdFZdFZd ZdYZdZZd[Z d\Z!d0Z"dZ+daZ,d d hZ-d hZ.ddhZ/dhZ0dZ1dbZ2dcZ3ddZ4dZ5deZ6dZ7dZ8dZ9dJZ:dZ;d*ZdfZ?d4Z@d6ZAddgZBd2ZCedheCdiiZDdjZEddkZFddlZGddmZH ddnZIddoZJdpZKe'e)dqZLdrZMddsZNddtZOe>f dduZPddvZQddwZRddxZSddyZT ddzZU dd{ZV dd|ZWdddddd}d}dd}ddddd}dd~dd}d}ddddd ddZXddZY ddZZ ddZ[ ddZ\ ddZ] ddZ^ ddZ_ ddZ` ddZaddZbddd}dddd}ddd}d ddZcdddd ddZddddddZedddddZf dd}d ddZgddZhddZiddZj d ddZk ddZl d ddZm ddZn dddd ddZodddZp d ddZq ddZrddZsddZtdddddddddddd}d}d}ddddddddddd ddZu ddZv ddZwddZxddddd}e1d ddZye1d}d}f ddZze1dd}d ddZ{e1f ddZ|e}hdZ~ddZd}d ddZdhZde5ddd ddZ ddZ ddZ ddZdd dd„Z ddÄZddĄZdZddƜ ddDŽZe5f ddȄZ d dɄZdd}ddʜ d d˄Ze3ddddΜ d dτZy( u#still_recipe — 스틸 프롬프트 조립·참조 규칙 (2026-07-13 레시피 이식). s39 `_build_prompt` + s40 `stage_stills` 참조 조립의 production 이식(순수 로직 — 파일/DB/LLM 없음, 서비스 어댑터는 still_recipe_service). 참조 규칙 (s40/s41 실증): - bgonly 샷: [플레이트만] + NO PEOPLE 절 + 자세 정본 절 생략(인물 유도 방지) - prev 샷: [플레이트 + prev **선정본**(_sel) + 엔티티] + usage_en 절 (콘티 없음) - 일반 샷: [플레이트 + 경량 콘티 + 엔티티] 텍스트 안전망 (전부 범용 계약, prompts/_base/still_recipe 팩): head(TIME OF DAY lock) → SHOT TEXT → LOCATION lock → CONTINUES/usage(prev) → 자세 정본 → REALIZE → EXPRESSION_REALISM → PROP_ORIENTATION → MOVEMENT/FIGURES → CARRIED → PEOPLE(traits 병기)/NO PEOPLE → no_text. 실험의 `_soften`(고어 치환)·국가 하드코딩 head 는 이식하지 않는다 — world_anchor 는 호출자가 프로젝트 데이터에서 파생해 주입(빈 문자열 허용). ) annotationsNPath)AnyDictListOptionalSequenceSetTuple) load_prompt still_recipe1z1.2026071323002z2.2026071600303z3.2026071602004z4.2026071623205z5.2026071711006z6.2026071921407z7.2026072015508z8.2026072115109z9.20260721154010z10.20260722112011z11.20260722023712z12.20260727053713z13.20260806233014z14.20260806234215z15.20260807120016z16.20260812183317z17.20260813031018z18.20260813112119z19.20260813144020z20.20260814130021z21.20260814170022z22.20260818010023z23.20260825155524z24.20260825211526z26.20260827052027z27.20260827052528z28.20260827062029z29.20260827140030z30.20260827170031z31.20260827190032z32.20260827191033z33.20260827230034z34.20260827234035z35.202608280010z36.202608281230z37.202608281500z38.202608281501z39.202608281530z40.202608281531z41.202608282130z25.202608270230z44.202609201830z45.202609201831z42.202609201620z43.202609201621) 3637383940412544454243r6r8r9r:r;r2r3r4r5zgpt-image-2.5-sunburst1536x864bgfirst_full_v3r7cRddlm}tt|ddrtSt S)uq이번 판의 cine 팩 — 연출 재료를 넘길 때만 v24 다. ★플래그가 꺼졌는데 selector 를 올리면 안 된다: 팩 문자열이 스텝 지문에 들어가 있어(`image_steps`) **완주본이 전량 재실행**된다. 스템 본문이 같아도 그렇다 — 지문이 보는 것은 바이트가 아니라 버전 문자열이다. rsettings"still_cine_stage_direction_enabledF)app.core.configrBboolgetattr#CINE_STAGE_DIRECTION_PROMPT_VERSIONCINE_TRANSFORM_PROMPT_VERSIONrAs W/Users/manta/Documents/Projects/TheRoad-I1/backend/app/modules/pipeline/still_recipe.pycine_pack_selectorrJhs%) GHBE JK22 ((camera_frame_clause_no_dir"camera_frame_clause_no_dir_compactr1c|rtStS)u`naturalism_clause` 가 **실제로 읽는** 팩 selector (감사 P1-A). ★조립과 지문의 **단일 출처**다. `broll_variation_stem` 과 같은 모양이되 스템 이름은 두 갈래가 같아서 selector 만 돌려준다. Args: version_selector: `still_guidance_selector()` 결과 — grok 백엔드에서만 채워지고 nb2 에서는 빈 문자열이다. )!NATURALISM_COMPACT_PROMPT_VERSIONNATURALISM_PROMPT_VERSIONversion_selectors rInaturalism_packrSs2B -,*,rKc|rdnd}|tfS)ub 롤 변주 절이 **실제로 쓰는** (스템 이름, 팩 selector). ★조립과 지문의 **단일 출처**다. 종전에는 갈라져 있었다: 조립은 `grok_stem_version()` 으로 nb2=v17 / grok=v22 를 골랐는데, 지문(`image_steps`)은 `STILL_COMPACT_PROMPT_VERSION` ("17")을 **박아** 접었다. 그래서 grok 갈래에서는 컴팩트 판 바이트를 고쳐도 지문이 안 움직여 완주한 샷이 clean skip 한다 — 고친 문안이 그림에 안 닿는다. `camera_frame_stem` 이 같은 결함을 이미 한 번 겪었다. Args: version_selector: `still_guidance_selector()` 의 결과. grok 백엔드에서만 채워지고 nb2 에서는 빈 문자열이다. Returns: `(스템 이름, 그 스템을 로드할 팩 selector)`. 두 판은 **본문이 다르다** — grok 은 8,000B 상한 때문에 짧아야 한다. #broll_composition_variation_compactbroll_composition_variation)BROLL_VARIATION_PROMPT_VERSION)rRstems rIbroll_variation_stemrYs&6F 1. / //rKc|rtSdS)u백엔드 → 컴팩트 갈림 신호. **조립과 지문이 같이 부른다.** 이 값이 `grok_stem_version` 의 유일한 입력이다. 종전에는 조립 쪽 (`still_recipe_service`)이 제 안에서 직접 만들었고 지문 쪽은 그 값을 아예 몰랐다 — 두 자리가 갈리면 조립은 새 스템을 쓰고 지문은 옛 값을 접는 **조용한 clean skip** 이 난다. )STILL_COMPACT_PROMPT_VERSION) grok_backends rIstill_guidance_selectorr^s,8 '?R?rKcLt|t}|rt|tfSd|fS)u$CAMERA & FRAME 절이 **실제로 쓰는** (스템 이름, 팩 selector). ★조립과 지문의 **단일 출처**다 (2026-08-27 Codex 재지적). 처음에는 지문이 base 스템만 접어 grok 의 컴팩트 문안 수정이 누락됐다. 그 다음엔 **둘 다 접어** 반대편을 열었다 — nb2 설정 그대로 컴팩트 바이트만 고쳐도 nb2 완주 샷이 mismatch 로 다시 산다. 안 쓰는 스템은 접으면 안 된다. ★`still_image_backend` 가 이미 지문에 있다는 것은 **두 백엔드의 지문이 서로 다르다**는 뜻일 뿐, 안 쓰는 스템이 기여하지 않는다는 뜻이 아니다 — 내가 그걸 근거로 썼다가 틀렸다. Returns: `(스템 이름, 그 스템을 로드할 팩 selector)`. camera_frame_clause)grok_stem_versionCAMERA_FRAME_PROMPT_VERSIONCAMERA_FRAME_NO_DIR_STEMS"CAMERA_FRAME_NO_DIR_PROMPT_VERSION)rRomit_camera_directionsels rIcamera_frame_stemrgs7$ ,.I JC*#.24 4 # %%rKc|rtS|S)ugrok 조립에서만 컴팩트 스템으로 가른다 — **갈림의 단일 지점**. 조건은 하나뿐이다: `version_selector` 가 실려 있는가. 그 값은 still_recipe_service 가 `still_image_backend == "grok2"` 일 때만 채우고 nb2 에서는 빈 문자열이다. 비어 있으면 `default`(기존 스템 버전)를 그대로 돌려주므로 **nb2 조립은 바이트 동일**이다 — 이미 완주한 에피소드의 지문을 흔들지 않는다는 것이 이 함수가 지키는 계약이고, 시험이 그것을 잠근다 (tests/unit/test_grok_compact_stems_backend_split.py). 왜 필요한가: xAI 이미지 모델의 텍스트 상한은 8,000바이트다(모델이 스스로 선언하고 초과 요청은 400 으로 거부된다). 롤 하나가 상한을 넘으면 그 롤이 죽고, 롤 하나가 죽으면 샷 전체가 죽는다(multiroll_select 가 예외를 그대로 올린다). 컴팩트 지도 절(v17)만으로는 −1,752B 라 모자란다. )STILL_GROK_STEM_VERSION)rRdefaults rIraras'7 "CGCrK)drawn_mark_clauseprop_orientationnaturalism_clauseexpression_realism realize_stillimmobile_physics)rormzk7900|drawn_mark_clause,prop_orientation,naturalism_clause,expression_realism,realize_still,immobile_physicscddlm}|ddjtzdzdjdt t j DzS)u`덜어내기 정책의 현재 서명 — 값에서 뽑는다(손으로 올리는 버전 아님).rGROK_TEXT_BYTE_LIMIT|,c30K|]\}}|d|yw)=N).0kvs rI z-grok_shed_policy_signature..)s'I G-1Aqs!A3Z Gs)!app.modules.llm.grok_image_clientrsjoinGROK_SHED_ORDERsortedGROK_SHED_STEM_SELECTORitemsrrs rIgrok_shed_policy_signaturer$s]F#$A &/)B B HHI &'>'D'D'F GII IJrKc ddlm}dfd  t|rnd}|r||vr|Sfd|tDDcgc] }|r||vr| }}|rt |t SdS#t$rdY`wxYwcc}w)u{이 프롬프트에 **문자 그대로 들어 있는** 그 절의 문안. 없으면 "". ★왜 1순위 판만 보면 안 되나 (2026-09-18 컨트리로드 실측). 조립은 절을 `guidance_version or prompt_version` 판으로 렌더한다. grok 이 **주 백엔드**면 guidance=컴팩트(v17)라 1순위 판으로 찾으면 맞는다. 그런데 nb2 가 주 백엔드이고 grok 이 **안전 사다리의 교차 백엔드**로 불릴 때는 프롬프트에 v1/3/4/5 판 문안이 들어 있어 컴팩트 문자열이 **하나도 안 맞고**, 한 절도 못 덜어낸 채 상한에 걸려 그 단계가 통째로 죽었다 (S71sh13: 라벨까지 8,653B > 8,000B, 덜어냄 0개 — 다른 판으로도 찾으면 두 절이 빠져 라벨까지 7,729B 로 들어간다. 아래 수치는 모두 라벨 포함 총량). 그래서 1순위가 안 맞으면 **그 스템을 가진 나머지 판**의 문안으로도 찾는다. - 판 목록은 디스크에서 읽는다 — 조립 쪽 팩 선택을 여기 다시 적으면 두 자리가 갈린다. - 지우는 것은 언제나 **프롬프트에 문자 그대로 있는 문안**이다. - 후보가 여럿이면 **가장 긴 것** — 짧은 판이 긴 판의 부분일 때 가운데만 도려내 남은 글이 망가지는 것을 막는다. ★못 읽는 판·모르는 selector 여도 **선진 않는다** — 1순위만 건너뛰고 다른 판으로 계속 찾는다(예외를 올리면 덜어내기가 아니라 롤이 죽는다). ★한계 두 가지 — 넘겨짚지 말 것 (Codex 리뷰 2026-09-18): ① 1순위가 **부분 문자열로** 맞으면 그대로 1순위를 지운다. 다른 판이 `1순위 + 덧글` 한 덩어리로 실렸다면 앞부분만 잘린다. 「가장 긴 것」은 fallback 끼리만 걸리는 보호다. ② 옛 판에는 절이 **합쳐져** 있는 것이 있다(`realize_still` v1 안에 인물 실체 절 본문). 지금 조립은 realize 를 v37/v38 로만 싣지만, 그런 판을 싣는 경로가 생기면 덜어낼 후보가 아닌 절까지 함께 빠진다. r)pack_versions_with_stemcd tt|jS#t$rYywxYw)Nversionr[)r _MODULEstrip Exception)rrXs rI_textz!_clause_present_in.._textOs2 wg>DDF F  s # //r[c38K|]}|k7r |ywNrx)ryr{rprimary_versions rIr|z%_clause_present_in..]s% DO# !HDs)key)rstrreturnr)app.modules.prompt_loaderrresolve_prompt_versionrrmaxlen) promptrXprimary_selectorrprimarytothersrrs ` @@rI_clause_present_inr-s@B 01AB)8eO$RG7f$ 5gtD  a f   $*3v3 1r1  s A/ B/ A=<A=c dd}|||z|kr|gfS|}g}tD]}|||z|kr||fSt||tj||}|s:d|z|vr|j d|zdd}n1|dz|vr|j |dzdd}n|j |dd}|j |||fS)uxAI 텍스트 상한에 맞춰 일반 규칙 절만 덜어낸다. Args: prompt: 조립이 끝난 롤 프롬프트. extra_bytes: 프롬프트 밖에서 상한에 함께 세어지는 바이트(참조 라벨). limit: 상한(바이트). version_selector: 덜어낼 절을 렌더할 **1순위** 팩. 안 맞으면 `_clause_present_in` 이 그 스템을 가진 다른 판으로도 찾는다 (조립 팩이 다른 사다리 교차 백엔드 경로). Returns: (맞춘 프롬프트, 덜어낸 스템 이름 목록). 상한 안이면 원본과 빈 목록. 상한을 넘는 롤은 그대로 두면 롤이 죽고 롤이 죽으면 샷이 죽는다 (multiroll_select 가 예외를 그대로 올린다). 그림이 아예 없는 것보다 일반 규칙 문안 몇 절이 빠진 그림이 낫다는 판단이고, 무엇을 덜었는지는 호출부가 반드시 기록한다(조용한 손실 금지). c6t|jdS)Nutf-8)rencode)texts rI_bzfit_grok_prompt.._b~s4;;w'((rK r[)rrrint)rrrgetreplaceappend) r extra_byteslimitrRroutshedrXrs rIfit_grok_promptrfs0) &zK5(rz CD c7[ E )  9"  # ' '.> ?   D=C ++ftmR3C F]c !++dVmR3C++dB*C D 9rKc n t|S#t$r td|dttdwxYw)Nz-unknown still_recipe prompt version selector z (known: ))PROMPT_VERSION_MAPKeyError ValueErrorr)selectors rIrrsK !(++  ;l)F+=$>#?q B   s )4c:ddlm}|tt|S)uH레시피 팩의 **내용** 해시 — judge_pack_content_hash 와 동형 (#77-A). 버전 문자열 스탬프는 팩 내용이 바뀌어도 안 움직일 수 있다 — 실제 로드 디렉토리의 bytes 해시를 config_hash 에 접어, 팩만 올린 재실행이 whole-step clean skip 되던 구멍을 막는다.r)pack_dir_content_hash)rrrr)rrs rIrecipe_pack_content_hashrs @ *@*J KKrKc<ddlm}|tt||S)u<레시피 팩 안 **한 스템**의 내용 해시 (2026-08-13 Codex R2). 소비 범위가 스템 하나인 절(b 변주·몸-지지)은 스템 bytes 만 지문에 접는다 — 디렉토리 전체 해시는 동거 스템(컴팩트 지도 절·identity 등) 개정까지 전량 재생성을 일으킨다.r)pack_stem_content_hash)rrrr)rrXrs rIrecipe_stem_content_hashrs" A !'14 99rKcixsijD]"\}}|xsijd}|s||<$dfd }|S)u entity_lookup → short id(C##/O##) 를 UUID 로 푸는 callable. `extract_outfit_assignments(..., norm_uuid=...)` 에 그대로 넣는 정본이다. 호출부마다 다시 짜면 **재는 쪽과 도는 쪽이 같이 틀린다** — 2026-08-29 에 이 자리가 `unknown outlook_id` 로 7샷 중 5샷을 죽였고, 그때 원인은 entity_lookup 에 outlook canon 이 안 실린 것이었다(episode link 누락). 무료 preflight 가 **같은 함수**를 불러야 그 결함을 미리 잡는다. short_idcXt|tr|sy|vr|Sj|Sr) isinstancerr)r{ entity_lookup short_to_uuids rI _norm_uuidz+build_short_id_resolver.._norm_uuids0!S! H  ##rK)r{rr Optional[str])rr)r_eid_e_sidrrs` @rIbuild_short_id_resolverrsR%'M"(b//1bb~~j) "&M$ 2 $ rKc :ddl}|siS |j|}t|tsddt |j iSi}g}|D]p}|t|ts(|jdt |j ?|jd}|St|ts(|jdt |j |D]} t| ts(|jd t | j ;| jd xsd } | jd xsd } | s| s|jd {|| } || } | s|jd| | s|jd| |j| tj| s|r%ddjtt|iS|jDcic] \}}t!|dkDs|t|"}}}|rd|j#|diS|jDcic]\}}|t%t'|c}}S#|j$r}dd|icYd}~Sd}~wwxYwcc}}wcc}}w)ut2i_variations_json[*].outfit_assignments → {char_uuid: outlook_uuid}. production shape(Codex 2차 리뷰 B1): VE 에는 outlook 이 실리지 않고 배정은 여기(short id C##/O##)에만 있다. norm_uuid 는 short→UUID 정규화 callable(불일치=None). variation 간 상이 배정은 임의 first 선택 금지 — {"__conflict__": <상세 json>} 반환(호출자 fail-closed). 3차 리뷰 M3: '배정 자체가 없음'(={})과 'SOT 존재하나 손상/미해결'을 구분 — malformed JSON·unknown character_id/outlook_id 는 {"__invalid__": <사유>} 반환(호출자 fail-closed, base 얼굴로 조용한 degrade 금지). rN __invalid__zjson_decode_error: zroot must be list, got zvariation must be dict, got outfit_assignmentsz%outfit_assignments must be list, got zassignment must be dict, got character_idr[ outlook_idzempty assignment objectzunknown character_id: zunknown outlook_id: ; r __conflict__F) ensure_ascii)jsonloadsJSONDecodeErrorrlisttype__name__dictrr setdefaultsetaddr~rrrdumpsnextiter)raw_variations_json norm_uuid_json variationsexcper_charinvalidvar assignmentsaraw_cidraw_oidcidoidco conflictss rIextract_outfit_assignmentsrs   <[[!45 j$ ' )$z*:*C*C)DE   "HG ; #t$ NN.tCy/A/A.BC  gg23   +t, NN7 $--.0  Aa&3DG4D4D3EFeeN+1rGeeL)/RG789G$CG$C!7{CD!5g[AB   SU + / / 4)#LtyyG )=>??*2..*:I*:$!Qc!fqjF1I*:II IE JKK)1)9 :)9AAtDG} )9 ::o  <!4SE:;; 의상 composite > base.rz composite::Nr)eidsid state_sidsoutlook_by_eidscene_ref_image_maprols rIresolve_char_ref_keyr#s~ sj o!!%( 3--J   C B 3%q%)<<C5"&& !! rKcg}g}|D]Y}|xsijd}|s||vr|j||jddvsD||vsI|j|[||fS)u0(input_image_ids 전체, entity 전용 reference_image_ids) 분리. Codex 2차 리뷰 H5: reference_image_ids 는 visible entity/prop 구조 lineage 전용 — plate/conti/prev 를 넣으면 pipeline_graph 가 거짓 reference edge 를 만든다. 실첨부 전체는 input 채널에만. asset_idrole) character_refprop_ref)rr) attached_refs input_ids entity_idsraids rIpartition_lineage_idsr8szIJ wBmmJ'  i    S ! 55=9 9 z !   c " j  rKFedit)run_fn roll_prompts roll_refsref_role_metadataroll_ref_metadataparallel_rolls judge_flip flip_prioritycritique_selected_prompt_onlyjudge_prompt_headerfix_rejudge_fncomposition_critique_fnmake_fix_gen_fn fix_ref_gatefix_missing_texts repair_methodstill_regen_textswinner_gate_applicablegate_reroll_enabledgate_rejudge_fngate_reroll_allow_fngate_rejudge_identitygate_regen_textsc$ | ddlm}$|$} ||}%|||n|%}&d4fd }'i}(|||(d<|||(d<|||(d<|||(d<|rd |(d <|rd |(d <|||(d <|rd |(d <|||(d<|||(d<|||(d<|r5d |(d<|xsi})|)jdd|(d<|)jdd|(d<|dk(rO||(d<|%|(d<|xsi}*|*jdd|(d<|*jdd|(d<|*jdd|(d<| d5id|d|d|d |d!|%d"|d#| r|ndd$| r|&ndd%| d&| d'| d'd(| d(d)| d)d*| jd*dd+jjd,| d-|d.|d/| d0|!d1|"d2|#d3|'|(S)6u단일/A·B branch 공용 multiroll 실행 (Codex 74ebf365 B1). 계약: gen callable 은 branch 당 **1회** 생성해 gen_fn/fix_gen_fn 양쪽에 동일 객체 전달(critique ON 에서 미정의 참조 금지 — NameError 실행 차단 실측의 재발 방지, 모듈 헬퍼로 추출해 실행 경로를 유닛 테스트로 잠근다). records=durable persist(rec_key 단위). make_fix_gen_fn (2026-08-13 G+G46): 제공 시 fix i2i 만 **별도 gen** (branch 당 1회 생성)으로 가른다 — 사용자 확정 "수정은 Grok": 롤 생성 (nb2)과 수정 편집(grok)의 백엔드가 다른 구성의 이음새다. None(default) =기존 계약(gen 재사용) byte-identical. still-variants(2026-07-17) kwargs 는 **미사용 시 전달 자체를 생략** — OFF 경로의 기존 run_fn 호출·지문·record shape 를 그대로 유지한다 (Codex 설계 리뷰 R6/R7 조건). Nr)run_multiroll_selectcD|j<jyr)datasave)recrec_keyrecordss rI_persistz#run_branch_select.._persists # W rKrrrrTrr r r r r rr missing_headr[fix_missing_head missing_tailfix_missing_tail regenerater regen_gen_fn regen_head regen_tailregen_faults_headertagr labeled_refsout_stemgen_fnjudge_fn critique_fn fix_gen_fn roll_countcritique_enabledfix_headfix_tail fix_label fix_ref_labelrecordextra_fingerprintrrrrrrpersist_record_fn)rDict[str, Any]rNonerx)%app.modules.pipeline.multiroll_selectrrr)+ branch_tag branch_refsr r.rr! make_gen_fnr0r1r3r4 judge_textsr:rrrrrrr r r r r rrrrrrrrrrrrrgenfix_genr"variant_kwargs_mt_rts+ ` ` rIrun_branch_selectrHPsz~ & j !C'6'B # &(N)5~&&/{#$.?*+$.?*++/'('+|$ *7'$:>67&0C,-!+9'(*4K01*.~&%2-0WW^R-H)*-0WW^R-H)*  $*7' *-~&%2'*ww|R'@|$'*ww|R'@|$03 !21',-     !         $4K /7D  * Z( Z( k* &"ooor:' (||() *,+ , 6- .0/ 0(1 223 445 6*7 8# ; rKc|jdry|jds|jdsy|jd}t|tr%|jdr|jddk(Sy) u수리 단계 산출(fix i2i/재생성 후보)이 최종 `_sel` 이 됐는가 — 자산 provenance(exact 호출 태그·생성 모델·prompt_used·fix_applied)의 **단일 판정** (2026-08-13 Codex GG46 R1 BLOCK-2). 종전에는 소비처마다 `fix_prompt` **존재**로 판정해, 재판정(fix rejudge)에서 수정본이 **져서** 원본 롤이 최종인 샷도 fix 호출에 링크되고 fix_applied=True 로 남았다(반대로 이겼을 땐 모델·프롬프트 기록이 롤 것). 계약: · 재평가 record 가 있으면 그 승부가 SOT — winner=="B"(수정본). · 없으면 legacy(수리 산출 무판정 확정) — 수리 프롬프트가 있으면 채택. · 수리 시도 자체가 없으면(fix_skipped 포함) False. fix_skippedF fix_prompt regen_prompt fix_rejudgewinnerBT)rrr)r9rejudges rI fix_stage_wonrQsgzz-  JJ| $ >(Bjj'G'4 W[[%:{{8$++ rKct|r:|jddk(r|jdn|jd}|r|S|jdxsi}|jd}|j|xs|S)uB최종 asset prompt_used — 실제 생성에 쓰인 프롬프트 (리뷰 NARROW-4). 수리 산출이 최종이면(`fix_stage_won`) 최종 bytes 를 만든 프롬프트는 수리 프롬프트다 — 롤 프롬프트를 실으면 모델·지시가 다른 호출의 산물로 오독된다(Codex GG46 R1 BLOCK-2 — Grok fix 에서 교차 모델로 드러났지만 nb2 fix 도 같은 결함이었다). 그 외에는 변형 모드=선정 라벨의 roll_prompts 전문(시각 접근 provenance 보존), legacy/결손= base 그대로 (기존 값 불변). repair_moder'rLrKrselected)rQr)r9 base_prompt repair_promptrprfs rIeffective_prompt_usedrXs}Vzz-(L8 JJ~ &L)   N # )rB **Z C 66#; %+%rKct|r|jddk(rdnd}||S|jdxsdjj}|r|d|SdS)u?승자 branch record → 최종 산출을 만든 exact 호출 태그 (Codex H2). 수리 산출이 최종이면(`fix_stage_won` — 재평가 승부 반영) 수리 호출 태그('{branch}_fix'/'{branch}_regen'), 아니면 '{branch}_{selected 소문자}' (run_multiroll_select 태그 관례). 종전의 fix_prompt 존재 판정은 재판정에서 진 fix 의 호출로 최종 자산을 잇는 거짓 링크였다 (Codex GG46 R1 BLOCK-2). selected 결손이면 빈 문자열 — resolver 는 exact miss 를 None 으로 반환(거짓 링크 금지). rSr'_regen_fixrTr[_)rQrrlower)r?r9suffixrfs rIwinner_exact_multiroll_tagr_ssV$jj7<G( fX&& ::j ! 'R . . 0 6 6 8C$'j\3% /R/rKc0|s|sy|std|dy)u$(DEPRECATED — 2026-07-16 복잡 구조물=A/B 재설계로 생산처 소멸) direct_seed 샷 장소 권위 결정 — classify prev 판정이 SOT. 서비스 live 분기는 제거됨; 함수는 보존만(삭제 금지 원칙). Codex f7c81336 BLOCKING-1: prev_tag(classify SOT)가 있으면 mode 는 prev_only 로 **고정** — prev asset 결손은 seed_only 로의 조용한 정책 전환이 아니라 ValueError(fail-closed, 샷 실패 격리). bg_only 는 classify 가 prev 를 무효화하는 경로라 seed_only. seed_onlyu+direct_seed prev_only 요구(classify prev=uN)인데 prev 선정본/primary 결손 — seed_only 전환 금지(fail-closed) prev_onlyr)prev_tagprev_sel_existsbg_onlys rI$decide_direct_seed_location_ref_moderg2s5h 9(DU U   rKc6|s|ry|r|r|rdSdS|ry|s|rdSdS)ui스틸 플레이트 처리 모드 결정 (재리뷰 HIGH-2 — caller 조건의 순수 함수 분리). - "bg_late_select": bg_only(콘티 없음) 즉석 VLM 판정 — flag ON + 플레이트 실재 시에만 (기존 계약). - "reconcile": 콘티형 샷(non-bg·non-prev) 권위/콘티 플레이트 reconciliation — flag ON **또는** complex_ab 면 플레이트 mapping 이 비어 있어도 호출(R1 배선 완성: 재개 시 mapping 소실이 권위 해석을 건너뛰던 누락 차단). flag OFF 일반 샷 = legacy 유지. - "none": lane/맵 플레이트/그 외. nonebg_late_select reconcilerx)plate_select_on complex_abrf prev_used lane_used is_map_plate plate_presents rIplate_flow_moderrKs?*L=  6< *j;EvErKc|r|jdxsd}|rt|jstd|d|r)t |t |k7rtd|d|dt||jdxsifS|rYt|}|jstd |d |)t |t |k7rtd |d |d|d fS|d fS)u콘티형 샷의 스틸 플레이트 해석 — 권위 기록 우선 (R1 선행 고정). Codex 설계 리뷰 BLOCKING-1: 스틸 시점 재판정은 콘티가 그려진 플레이트 와 다른 플레이트를 스틸에 붙여 A/B 가 '콘티 유무' 외 변수를 비교하게 만든다. 콘티(+A/B 양 브랜치)와 스틸은 정확히 같은 plate path 를 소비해야 한다. - authority_entry 존재: 그 plate_path 가 SOT — 파일 결손·콘티가 다른 플레이트로 생성된 경우 = ValueError(fail-closed, 상류 재실행 필요). - authority_entry 부재(판정 비대상/flag 조합): **콘티가 그려진 플레이트가 SOT** (배치 리뷰 BLOCKING-2 — current mapping 이 비어도 콘티 플레이트로 해석, 결손·불일치=fail-closed). - 콘티 기록도 없으면 현재 배정 유지 (콘티 생략 샷). plate_pathr[u,plate authority 기록 플레이트 결손: u& — shot_conti_light 재실행 필요uDplate authority 와 콘티 생성 플레이트 불일치 (authority=z / conti=u') — shot_conti_light 재실행 필요r9u#콘티 생성 플레이트 결손: u* — 상류 배경/콘티 재실행 필요NuJ콘티 생성 플레이트와 현재 배정 플레이트 불일치 (conti=z / assigned=u+) — 상류 배경/콘티 재실행 필요)rris_filerr)authority_entryconti_plate_path current_platepcps rIresolve_conti_plate_authorityr{ls:(    - 3Q)>qeD44  $4 5Q ?S *:);<44  Aw++H5;;; " #zz|56F5IJ88   $]);s2w)F*+< G88  4x $ rKc|s tSt}|xsgD]S}|xsijd}t|jdxsg}|s9||vs>||vsC|j|U|S)uprev 참조 샷에서 캐릭터 참조를 제외할 정본 자세 인물 short_id. E2E6 피드백 ④ (2026-07-16): pose_canon(LLM 가동성 판정 SOT)이 현재 샷과 prev 샷을 **모두** 커버하는 인물 — prev 스틸이 이미 자세·외형 LOCK 이라 별도 캐릭터 참조는 이중 참조 충돌(S12sh9 실측). short_id 미해소(None)면 제외하지 않는다(참조 유지=안전측, 글자 매칭 금지). character_short_idshots)rrr) pose_canonr,rdrpcrcovs rIlocked_pose_short_idsrsr u ECBxRnn12"&&/'R( 3#:(c/ GGCL  JrKc t||dS)uR샷 VE, 비면 같은 씬 선택 샷 VE 합집합 fallback (실험 공통 규칙).r)ve_ids_for_shot_ex) ve_by_keyrs rIve_ids_for_shotrs i -a 00rKc|j|xsg}|r t|dfSt}|jD]&\\}}}||dk(s|j |xsg(t |dfS)ug`ve_ids_for_shot` + **확정 배정인지** 여부. 두 번째 값 False = 샷 자체의 VE 가 없어 같은 씬 다른 샷에서 끌어온 추측이다. 호출자는 이걸로 PEOPLE 절의 배타 조항을 붙일지 결정한다 — 추측에 "never anyone else" 를 붙이면 정답을 배제한다(실측 S11sh3, 팩 v14 주석 참조). TrF)rrrrupdater)rrids scene_unionsi_shir{s rIrrsw --  "C Cy$EK"* TA Q<   qwB '+ +  %%rKcddl}ddlm}t|t|frd|St|t t fr+d|jt |jSd|S)u~참조 원본의 신원 — 라벨·순서에 기대지 않는 접합 키. 라벨로 맞출 수 없다: `_attach` 는 이름(`김선영`)을 쓰고 `build_still_refs` 는 서식을 입힌 문안(`CHARACTER REFERENCE — 김선영: …`)을 쓴다. 순서로도 못 맞춘다: `handled_by` 갈래는 char_refs 의 부분집합만 싣는다. 원본 자체는 두 자리가 같은 객체를 주고받으므로 신원이 어긋날 수 없다. ★`id()` 를 쓰지 않는다 — 중간에 바이트를 갈아 끼우는 자리가 있다 (`outdoor_site_layout_step.py:357`·`visual_continuity_anchor_step.py:490`). rNrzpath:zsha256:zrepr:) hashlibpathlibrrrbytes bytearraysha256 hexdigest)srcr_Ps rIref_source_keyrsc"#Ry!se}#y)*c 3==?@AA 3'?rKr[) lane_sketch lane_seedlane_direct_seedstructure_seedseed_bgprompt_versiongeom_authority handled_byprev_people_ruleframing_scale_ownedplatec |t| }| B| tvrtd| d|| td| td|| td| 3| tvrtd| d| td|| td||r[|X| tvrtd| d g}|K|rd tt fnd |f\}}|j tt|| j|f|1|j ttd | j|f|r|S||j t|||fttd| j}ttd| j}|D](\}}|j |j||f*|D](\}}|j |j||f*|Sg}|3|1|j ttd| j|f| 3|1|j ttd| j| f| 1|j ttd | j| f|r||j t|||f| rdttdtt j}|D]2\}}|s || vs|j |j||f|S|S|`|j t|||f| rt|r|j ttdtt j|fn3|1|j ttd| j|fttd| j}ttd| j}|D](\}}|j |j||f*|D](\}}|j |j||f*|S)uO 라벨드 참조 조립 — (라벨, 이미지 소스[Path|bytes]) 순서 리스트. char_refs/prop_refs = [(이름, 소스)]. bgonly 는 플레이트 외 전부 제외. prev 샷은 콘티 없음(분류 단계 배제) — prev_sel 이 있으면 conti 는 무시, 플레이트도 제외(E2E6 ⑦: prev=배경 SOT, refs=[prev+엔티티]). geom_authority (2026-08-07, 팩 v15): 좁고 복잡한 실내만 참. prev 샷에도 콘티를 **함께** 붙여 공간 기하를 준다(상세는 해당 분기 주석). 기본값 False = 기존 조립 byte-identical. handled_by (2026-08-07, 분류 팩 v4): 그 순간 물건을 다루고 있는 사람. bgonly 샷에서 그 사람의 참조 **한 장만** 손 전용 라벨로 싣는다. 빈 문자열 = 기존 조립 byte-identical. ★E2E6 ⑦ 스코프 = **non-lane 경로 한정** (Codex 배치 리뷰 CONTRACT-2 명시): lane 샷은 사용자 설계 v2(2026-07-14)의 명시 결정대로 prev 가 있어도 스케치(+seed)를 유지한다(아래 lane 분기 — 스케치=배치 SOT, prev=연속성 추가 참조). lane 의 장소 권위 단일화(location_ref_mode prev_only/seed_only)는 outdoor_frame_mode(피드백 ③) 구현에서 통합 예정 — 여기서 암묵 제거하지 않는다. lane_sketch(Stage D, v2+ 팩 전용): 야외 lane 샷 — 플레이트/photo canon 참조 0, [마커 스케치(+lane_seed 구조물 룩)] + prev + 엔티티. prev 가 있어도 스케치 유지(설계 v2: 레인 스틸 참조에 prev **추가**). bgonly lane 샷도 스케치(+seed)는 유지 — 구조물 룩·배치 SOT. structure_seed(2026-07-16 복잡 구조물=A/B, v4 팩 전용): 플레이트와 **공존**하는 STRUCTURE LOOK — A/B 양 브랜치와 bg_only 에 공통 부착 (관할=structure_look_clause tie-break). prev 샷은 미부착(prev=배경· 구조물 look SOT — 권위 이중화 금지, Codex R6) — prev_sel 과 동시 전달 = ValueError. seed_bg(2026-07-17 seed-bg 승격, v5 팩 전용): 플레이트 producer 가 구조적으로 없는 structure_plate 그룹 — seed 가 LOCATION+구조물 단일 권위로 **정확히 1회** 부착 (Codex 조건 1: STRUCTURE LOOK 이중 첨부 금지 → structure_seed/plate 와 상호 배타). bg_only=seed_bg 만, prev 샷=미부착(prev-only). still_recipe vuK 팩에는 seed-bg 단일 권위 계약이 없음 — seed_bg 는 v5 전용u~seed_bg 는 단일 권위 — plate/structure_seed 와 동시 부착 금지 (Codex 조건 1: 동일 seed 이중 첨부 차단)uDseed_bg 는 prev 샷에 부착 금지 — prev-only (Codex 조건 4)u(seed_bg 와 lane 참조는 상호 배타u_ 팩에는 플레이트 공존 STRUCTURE LOOK 계약이 없음 — structure_seed 는 v4 전용uwstructure_seed 는 prev 샷에 부착 금지 — prev 가 배경·구조물 look SOT (Codex R6 권위 이중화 금지)uustructure_seed 와 lane 참조는 상호 배타 — 복잡 구조물 샷은 lane 스케치 경로를 쓰지 않는다uK 팩에는 lane 라벨이 없음 — lane_sketch/direct_seed 는 v2+ 전용sketch_label_lane sketch_labelr seed_label char_label prop_labelname plate_label seed_bg_labelhandled_char_labelconti_label_geom conti_label) r_SEED_BG_PACKSr_STRUCTURE_LOOK_PACKS_LANE_LABEL_PACKS LANE_SKETCH_LABEL_PROMPT_VERSIONrr rr_prev_label_stemformatGEOM_AUTHORITY_PROMPT_VERSION)rfrcontiprev_sel char_refs prop_refsrrrrrrrrrrresolvedrefs_sk_stem_sk_verrrrr hand_labels rIbuild_still_refsrs|&n5H  /  01==    :L   V   "i&;GH H! !6 6  01SS   H   "i&;C #3 8M !2 2  0199   "'%'(HIK-;X,F Hg KKWh%,..3eg{D   KKWl%-//4uw C  K   KK!(,<=xH ! \855:UW  \855:UW "ID# KK***5s; <#"ID# KK***5s; <# D X- - B H H J   x/ /!)++057G = ! , A G G I      KK!(,<=xH  $-.1345:EG ' cDJ.KK!2!2!2!=s CD '  h(8 98 D  e/ KK/25789>     - B H H J   WlHEKKMJWlHEKKMJ c Z&&D&1378 c Z&&D&1378 KrK)rrrc td  tddfd }|||dfS)u.A/B 두 브랜치 refs 를 **한 곳에서** 조립 — (refs_a, refs_b). Codex R6: 브랜치별 개별 조립은 B 브랜치에서 seed/팩 라벨이 누락되는 드리프트를 허용한다 — 두 브랜치는 콘티 유무 **만** 다르고 플레이트· seed·엔티티·팩(라벨)은 동일해야 비교가 순수하다. A/B 는 eligible (person-visible·no-prev) 샷 전용 — bg_only/prev 는 호출 금지. 배치 리뷰 BLOCKING-2: 복잡 구조물(structure_seed) A/B 는 LOCATION 플레이트 필수 — plate=None 이면 합의된 A=plate+seed+conti / B=plate+seed 가 아니라 seed-only 비교가 된다 (ValueError). seed-bg 그룹(v5, Codex 조건 1)은 seed_bg 가 LOCATION 권위 — plate/structure_seed 와 상호 배타(가드=build_still_refs). NuK복잡 구조물 A/B 는 LOCATION 플레이트 필수 — plate=None 금지u4A/B 는 LOCATION 권위(plate 또는 seed_bg) 필수c ,td|d S)NF) rfrrrrrrrr)r) branch_contirrrrrrs rI_branchz%build_ab_branch_refs.._branchs+))  rK)rOptional[Path]rList[Tuple[str, Any]]rc)rrrrrrrrs` ````` rIbuild_ab_branch_refsrsU.!em Y   }OPP    5>74= ((rKzclose-upz medium shotz wide shotzinsert close-up on a detail)closemediumwideinsertz points toz reaches forz looks towardz moves toward) points_to reaches_for looks_toward moves_towardrec t|tsyddlm}m}g}t |j dxsdj}|r|s|jd|tj t |j dxsd}|r|jd||j d}t|tr{g} |j d xsgD]8} t| tst | j d xsdj} |j t | j d xsdxsd gd} |j t | j d xsdxsd gd} | r| r| s| d| d| }tj t | j dxsd}t | j dxsdj}|r |r |d|d|z }| j|;| r&|jddj| zdzg}|j dxsgD]&}t|tst |j dxsdj}|sD|}t |j dxsdjjd}|r |d|dz }t |j dxsdjjd}|r|d|z }t |j dxsdjjd}|r|d|z }|j|)|r&|jd dj|zdz|syt|t|xr|!\}}tt |t#|d"j|#jS)$ushot_staging CP 1샷 엔트리 → CAMERA/FRAME 절 (fix1, 2026-07-19). E2E9 S19sh4 실측: staging 엔 camera_direction·frame_spatial_contract· framing_scale·key_bg_elements(구도·스케일 SOT)가 실재하는데 스틸 base 프롬프트에 구조적으로 누락 — 무콘티 브랜치(C/D)·prev 샷·배경 제거 변형에서 구도 정보가 0 이 되어 원근·스케일 붕괴(CCTV 거대화)가 남. 구조화 필드의 결정론 렌더링만 수행(zone/depth/gesture enum → NL 구절 — 글자 의미 판단 없음). staging 부재/유효 필드 0 = "" (보강 절이라 fail-safe — 스틸 자체를 막지 않는다). 절 헤더·스케일 계약 문구는 프롬프트 팩 v6 camera_frame_clause 스템 SOT. r[r) DEPTH_PHRASES ZONE_PHRASEScamera_direction - CAMERA: framing_scale- FRAMING SCALE: frame_spatial_contract constraintslabel screen_zoneN depth_planez in the z of the frame, gesture_actiongesture_target_label,  z- FRAME LAYOUT: r.key_bg_elementselementstatez (r orientationu — camera_usez ; used as z- KEY BACKGROUND ELEMENTS: r rbody)rrapp.core.frame_spatial_contractrrrrrr_FRAMING_SCALE_PHRASES_GESTURE_PHRASESr~rstriprgrEr rr)stagingrRrerrlinescamscalefscplacedrrzonedepthseggesturegtlbg_lineselrrrrrXrfs rIbuild_camera_frame_clausers gt $KE gkk,-3 4 : :   Rwa= C"&&/526<<>EEcJ  U;-( (C -34::<CCCH  Z |, ,C%3& 2TYYx5HH3NO "5J6=9<1>?ID# &s+ YYu   eg rKcNt|xrt|xr t| S)u이 샷이 **실제로 마커 스케치로 나가는가** — 한 곳에서만 정한다. ★[2026-09-18 컨트리로드] 같은 판단이 두 곳에 따로 적혀 있었다: camera_frame_en / framing_scale_en … `lane_used` 만 봄 lane_ref_mode … `lane_used and not (lane_chain and bg_only)` 그래서 **체인이면서 배경 전용**인 lane 샷에서 스케일 줄만 남고 lane 모드는 꺼져, `build_still_prompt` 의 「framing_scale_en 은 lane 샷 전용」 계약에 걸려 **scene_image_pipeline 이 통째로 죽었다**(242샷 중 121에서 정지). 체인+배경 전용 lane 샷은 플레이트(장소 사진)가 되살아나 붙으므로 스케치 잠금 문안이 거짓이 된다 — 그래서 그 샷은 스케치 샷이 아니다(종전 `lane_ref_mode` 의 판단 그대로다). 카메라·스케일 절도 같은 판단을 따른다. )rE)ro lane_chainrfs rIlane_sketch_moderss$  ? GD$4$FgGGrKct|tsytjt |jdxsd}|syt t dttd|jS)ulane 샷용 — typed `framing_scale` **한 줄만** 절로 싼다 (B-2b). `build_camera_frame_clause` 와 같은 값(`_FRAMING_SCALE_PHRASES`)을 쓰되 **스케일 한 줄만** 낸다. CAMERA 산문·FRAME LAYOUT·KEY BACKGROUND ELEMENTS 는 배치라 마커 스케치가 SOT 이고, 여기서 같이 주면 권위가 이중화된다(이 파일 2083 의 상호 배타 가드가 그 계약이다). typed 값이 없으면 "" — 그러면 호출부는 라벨도 옛 판 그대로 둔다. 새 라벨은 「FRAMING SCALE 줄이 스케일을 갖는다」고 말하는데, 그 줄이 없는 채 라벨만 바꾸면 **가리킬 값이 없는 지시**가 되기 때문이다. r[rframing_scale_clauserr) rrrrrr rrFRAMING_SCALE_PROMPT_VERSIONr)rrs rIbuild_framing_scale_clausersl gt $ " & & GKK ( .B/ 1E  '&'CD  (  eg rKct|tsyt|jdxsdj }|syt t dttd|j S)u.shot_staging CP 1샷 엔트리 lighting_mood → LIGHTING & MOOD 절 (E2E10 fix⑤, 2026-07-21). E2E10 실측: 붉은 원 계열(bgonly) 샷 프롬프트에 조명·무드 절 부재 (TIME OF DAY 1줄뿐) + 오브젝트 재질·질감 서술 부재 → 평면 낙서화 (S12sh18/S18sh10/S25sh5). 조명 SOT=shot_staging.lighting_mood — scene_still.lighting_json 은 v4 파이프라인 미저작(E2E10 192행 전부 '{}' 실측)이라 소비 대상이 아니다. 결정론 조립만 수행(저작된 NL 문장을 절로 감쌈 — 글자 의미 판단 없음). 절 헤더·재질 사실감 계약 문구=팩 v8 lighting_mood_clause 스템 SOT. staging 부재/빈값 = "" (보강 절이라 fail-safe — 스틸 자체를 막지 않는다, camera_frame 관례 동일). r[ lighting_moodlighting_mood_clause- LIGHTING & MOOD: r) rrrrrr rrLIGHTING_MOOD_PROMPT_VERSION)rmoods rIbuild_lighting_mood_clauser sg gt $ w{{?+1r 2 8 8 :D  '&'CD"4& )  eg rKc v|syttdtt|tj S)u캐릭터 identity 참조 역할 한정 절 (2026-08-12 차렷/증명사진 대응). 인물 시트(정면 응시 참조)의 포즈·시선·구도가 스틸로 전이되는 경로를 역할 한정 문장으로 차단한다 — 참조는 동일성(얼굴·헤어·체격·복장) 전용, 포즈·시선의 권위는 본 프롬프트의 CAMERA/동작 서술. 절 문구=팩 v16 identity_ref_role_clause 스템 SOT. has_char_refs=False(캐릭터 참조 미첨부 샷)면 "" — 참조가 없는 샷에 이 절이 나가면 존재하지 않는 이미지를 가리키는 거짓 문장이 된다. 호출자 계약(unit 테스트 test_still_recipe 가 잠근다): 절은 **본문 캐릭터 참조(char_label "CHARACTER REFERENCE — …")가 실리는 조건** (char_refs 비어 있지 않음 AND not bg_only)에서만 참을 전달한다. ★의도된 예외(Codex HIGH-4 명문화) — bg_only+handled_by 샷이 싣는 "HAND OWNER REFERENCE" 1장은 이 절의 대상이 아니다: 절의 지시 대상 (CHARACTER REFERENCE images)이 그 샷에 존재하지 않아 절이 나가면 거짓 문장이고, 손 라벨 스템은 자체 역할 한정문(얼굴·몸·복장 반입 금지, 손목·전완 너머 금지)을 이미 내장한다. r[identity_ref_role_clauser)r rrraIDENTITY_ROLE_PROMPT_VERSIONr) has_char_refsrRs rIbuild_identity_ref_role_clausers;*  +& .0L MO  eg rKc ~| S)u마감 절을 roll(t2i) 프롬프트에 붙일까 — **끝 단계에만 준다.** 2026-08-27 사용자 결정(뒤 결정이 앞 결정을 덮는다): 앞: "roll 에 언제나 붙이는 쪽으로 가" 뒤: 표를 보고 「이거 보면 제대로 구현이 안되었는데?」 → 「끝 단계 한 곳」, 재생성은 안 한다 ## 무엇을 막고 무엇을 연 것인가 두 실패를 나란히 적는다 — 한쪽만 보고 고치면 반대편이 되살아난다. cine ON 인데 roll 도 마감을 받는다 성공 샷 **100%** 포기·기각이면 마감이 아무 데도 없다 611 중 **2** (0.3%) 앞의 것이 이 판의 표적이다. 뒤의 것은 **열어 둔 채 기록으로 드러낸다** — 사용자가 재생성을 물리셨다("어차피 후보들 중에서 판단할거아냐"). 자산 record 의 `cine_transform.finish_owner` 가 그 자리를 말한다. ★일반 실패는 이 갈래가 아니다 — `:5208` 이 `StillCineTransformIncomplete` 를 올려 스텝을 안 닫고 resume 이 실패한 변환만 다시 시도한다. 확정 원본 fallback 은 포기·기각 둘뿐이다. ## 왜 중복이 해로운가 (앞 판단을 뒤집는 근거) 앞에서는 「마감 절이 CAMERA·layout 권위를 안 건드리니 두 번 가도 무해하다」고 봤다. 그런데 **이 절이 다루는 것이 바로 미지정 선택지**고, 최종 i2i 단계가 하는 일도 그것이다. 같은 선택을 두 단계가 각자 하면 앞 단계가 이미 고른 것을 뒤 단계가 다시 고른다 — 「끝 단계가 정한다」는 계약이 서지 않는다. 사용자 지적의 뜻이 이것이다. ## 지출 조건이 바뀌면 조립 바이트가 바뀌고, `compute_input_fingerprint` 가 프롬프트를 직접 접으므로(`multiroll_select.py:722`) cine ON 으로 완주한 샷은 롤부터 다시 산다. 각도 권위를 걷은 팩(v33)과 **같은 판에** 넣어 한 번만 치게 했다. ## grok_backend 를 남겨 둔 이유 호출부 둘(조립·지문)이 같은 축으로 판정하는지 시험이 AST 로 대조한다. 인자를 지우면 그 대조가 무의미해진다. rxr]cine_ons rIshould_attach_cinematic_finishrs\ ;rKcdttdt|xstj S)u시네마틱 마감 절 (2026-08-13 사용자 지시) — 전 스틸 프롬프트 공통. CAMERA 계약(스테이징 권위)은 불변 — 미지정 선택지의 영화적 실현만 지시한다. ★빈 selector 를 받으면 `CINEMATIC_FINISH_PROMPT_VERSION` 으로 간다. 종전 기본값은 컴팩트 지도 팩 selector 였고 호출부는 `_guidance` 를 넘겼는데, nb2 백엔드에서 그 값이 **빈 문자열**이라 `resolve_prompt_ version("")` 이 ValueError 를 냈다. 그래서 이 절은 grok 백엔드에서만 불릴 수 있었다 — 마감을 붙일지는 백엔드가 아니라 **최종 i2i 가 그 마감을 하느냐**로 갈려야 한다. cinematic_finishr)r rrCINEMATIC_FINISH_PROMPT_VERSIONrrQs rIbuild_cinematic_finish_clauser s2 #&  ? ?A  eg rKc@t||s|S|dztzS)u마감 절을 t2i 프롬프트 끝에 붙인다 — **조립까지 여기서 한다.** 가르는 것과 붙이는 것을 한 자리에 둔 이유는 시험이다. 조건만 함수로 빼고 조립을 호출부에 남겨 두면, 시험이 조건은 재면서 **나가는 문안은 한 번도 안 태운다** — 붙이는 줄이 통째로 빠져도 초록이다 (2026-08-27 Codex 지적). 붙일 조건은 [[should_attach_cinematic_finish]] 를 보라. rr)rr)rr]rs rIattach_cinematic_finishr s) *%w 8 F?:< < D D FDE  " z"5";";"=!>?@ *+;+A+A+C*DEF  ' YYu   eg V4v rKcpt|\}}tt|t|j S)uMb 롤 구도 변주 절 (2026-08-13 사용자 결정: 2롤 ab, b=영화적 구도 변주). 이 절이 실린 후보만 **카메라를 다시 세울** 수 있다 — 각도와 높이 두 축 뿐이다. 장소·인물·순간과 CAMERA & FRAME 의 프레임(subject scale · screen placement · key background elements), SHOT TEXT 직설 프레이밍은 불변이다 (2026-08-28 감사 P0-B). Args: version_selector: `still_guidance_selector()` 결과. 스템과 팩은 `broll_variation_stem()` 이 정한다 — 지문과 같은 출처다. r)rYr rrr)rRrXrfs rIbuild_broll_variation_clauser#[s4%%56ID# 5c:  egrKct|dkr|Dcic]}||c}S|dzt|z}t|Dcic]\}}||dk(r|n|c}}Scc}wcc}}w)u2롤 ab 변주 프롬프트 맵 (2026-08-13 사용자 확정 — 전 백엔드·전 경로). 첫 롤=기준(base 그대로), 나머지 롤=구도 변주 절 동반 — a 와 b 가 같은 구도·앵글로 수렴하지 않게 하는 구조 재료. labels 1개면 base 그대로. ★스템·팩은 `broll_variation_stem()` 이 정한다 — 지문과 같은 출처다. 종전에는 여기서 `grok_stem_version()` 으로 직접 골랐고 지문은 딴 상수를 봤다(2026-08-28 감사 P0-B 에서 합쳤다).r<rr)rr# enumerate)rUlabelsrRlnris rIbuild_ab_roll_prompt_mapr)ns 6{Q*01&BK&11  !=" Cv& &EAr AF[+& 2 s AAc|sytt}|r0ttd|dj |j Sttd|j S)uprev 스틸 인물 계승 스코프 절 (#119③) — 렌더 완문을 돌려준다. cast_known=False(앵커 인물 명단을 모름) = 빈 문자열 → 레거시 무조건 잠금 스템 그대로(조립 byte-identical). 겹침이 있으면 그 인물들만 의상 잠금, 겹침 0 이면 "그 사진의 인물은 이 샷에 없다" 명문 — S64sh4 실측(앵커 인물 외모·의상이 다른 인물에게 복제) 대응.r[prev_people_rule_sharedr)r shared_namesprev_people_rule_noner)rPREV_CAST_SCOPE_PROMPT_VERSIONr rr~r)r, cast_knownr{s rIbuild_prev_people_ruler0s[ =>A .<0227%' : w 7 C I I KKrKcg}|D]}}t|jdxsdj}|s2t|jdxsdj}|j|r d|d|dnd|d|syt t dt t j}|d zd j|zS) u&저작 공급된 원어 문안 렌더 (#119②) — 빈 목록=빈 문자열. 머리말 스템 + 한 줄에 하나. 문안 저작은 저작 모듈 소유 — 여기는 렌더만. ★**면(`surface_native`)을 요구하지 않는다** (2026-08-27 Codex BLOCK). 저작 팩 v2 부터 그 칸을 안 받는데(면을 정하려니 통칭이 필요했고 샷마다 갈려 같은 장소가 다른 곳처럼 보였다) 이 함수가 여전히 그것을 **필수로** 걸러, **v2·v3 산출이 통째로 버려지고 있었다.** 저작이 성공해도 문안이 한 줄도 안 나가고, 그 샷은 전면 금지 판으로 갔다. 면이 있으면 옛 모양(`- 면: "문안"`)으로, 없으면 문안만 낸다 — 옛 records 를 읽는 자리가 남아 있다. text_nativer[surface_native- z: ""z- "signage_sectionrr) rrrrr rrSIGNAGE_SECTION_PROMPT_VERSIONr~) inscriptionsrxrsurfaceheads rIbuild_signage_sectionr<s E 155'-2.446 aee,-34::< r'#dV1-D6mL   "& *, -.3UW  $;5) ))rKc|r.ttdtt|j Sttd|j S)uprev 스틸 라벨 — people_rule 이 있으면 인물 스코프 명시 v21 스템, 없으면 레거시 스템 그대로(byte-identical).prev_label_castr people_rule prev_labelr)r rrr.r)rr@s rIrrsI &*+IJ#%&+UW - w h ? E E GGrKrxT) world_anchor prev_usage_en pose_clauses movement_en figures_en carried_enr char_namesnonhuman_nameschar_names_exact lane_ref_modestructure_seed_attached seed_bg_mode chain_bg_modeplate_attachedcamera_frame_enframing_scale_enrconduct_versionidentity_role_enr signage_enrguidance_versionc  &'|r|dvrtd||r|tvrtd|d|r$|tvrtd|d|r td|r&|tvrtd|d|s|r td|r |r td |r |r td |r |s td |r|s|s|s|r td t |xs|'d?'fd }|rd}n{|r |d|}nm|r.t t dt tj}n=|r |d}n2|s.t t dt tj}nd}|d||xsdd|d|d|zg}|r|j|d|r|j||r|j||r|j||r|r>|jt t dt t|jn|j|d|r=|jt t dt t| j|s9|r7|jd!j||j|d"|rtnt&d?&fd# } |j| d$| xsgD!cgc]5}!t!|!jst!|!j7}"}!t#|"xrt%|"t%| xsgk\}#|r| r|#s.|j| d%|j|d&|"rT|jt t d't |rt&nt(d(j|")j|j|d*|rt |xs|}$|sA|jt t d+t t+|j|jt t d,|$j|sF|jt t d-t t-|t.j|r|jd.|z| r|jd/| z| r|jd0| z| rt0}%|jt t d1t |%| 2j|r>| s<|s:|s8|jt t d3t |%j| r|rt2j5d4| |r)|j|d5d6j| 7n|jt t d8t |xst6d6j| 9jnZ|rA|jt t d:t |xst8jn|j|d;|r|j||r|j||jt t |rdj|Scc}!w)@us39 _build_prompt ①~⑭ 조립 순서 이식. char_names = ["이름 (traits...)"] — entity_canon.stable_traits 병기는 호출자가 수행. world_anchor 예: " — contemporary ..., 2026" (프로젝트 데이터 파생, 하드코딩 금지). lane_ref_mode(Stage D HIGH-3, v3+ 팩 전용): ""=기존(LOCATION PHOTOGRAPH), "sketch"=레인1(사진 참조 0 — 스케치=배치 SOT+텍스트 저작), "seed"=레인2(STRUCTURE LOOK 사진=구조물 SOT). prev_used 샷은 prev 문장이 그대로 location authority (lane 여부 무관). structure_seed_attached(2026-07-16 복잡 구조물=A/B, v4 팩 전용): 플레이트와 공존하는 STRUCTURE LOOK 관할·tie-break 절 주입 (structure_look_clause — 구조물=seed 우선, 주변·시간·조명=플레이트 우선). lane_ref_mode 와 상호 배타. framing_scale_en(B-2b, 2026-08-28): lane 샷에만 실리는 **스케일 한 줄** (build_framing_scale_clause 렌더 완문). `camera_frame_en` 과 상호 배타이고 lane 밖에서는 거부한다. 비면 조립 byte-identical. ★짝이 되는 라벨 교체(`build_still_refs(framing_scale_owned=True)`)와 **같이** 켜야 한다 — 옛 라벨은 스케치가 camera framing 권위라고 말한다. camera_frame_en(fix1, 2026-07-19): build_camera_frame_clause 렌더 완문 — 비면 조립 byte-identical(기존 팩 무변경). lane 샷은 마커 스케치가 배치 SOT 라 상호 배타(이중 권위 금지). chain_bg_mode(2026-07-27 리뷰 F1, BGFIRST2 체인 저작 전용): Step2 는 재투영/채색 배경본을 **첫 참조**로 받고 LOCATION PHOTOGRAPH 는 어디에도 첨부되지 않는다 — 체인 저작 base 는 prev_used=False·lane_ref_mode="" 이라 기본 fallback 문구("the attached LOCATION PHOTOGRAPH shows the exact spot.")가 그대로 나가 존재하지 않는 이미지를 가리켰다(v3 에서 lane 샷에 대해 한 번 제거된 모순의 체인 경로 재발). 배경본을 장소 권위로 명시하는 스템으로 교체한다. 다른 권위 모드와 상호 배타이며, False(기본)면 조립 byte-identical. )sketchseedzunknown lane_ref_mode ruN 팩에는 lane location authority 가 없음 — lane_ref_mode 는 v3+ 전용uT 팩에는 structure_look 계약이 없음 — structure_seed_attached 는 v4 전용u;structure_seed_attached 와 lane_ref_mode 는 상호 배타uP 팩에는 seed-bg 단일 권위 계약이 없음 — seed_bg_mode 는 v5 전용ukseed_bg_mode 는 단일 권위 — lane_ref_mode/structure_seed_attached 와 상호 배타 (Codex 조건 3)ucamera_frame_en 과 lane_ref_mode 는 상호 배타 — lane 샷은 마커 스케치가 배치 SOT (구도 권위 이중화 금지)unframing_scale_en 과 camera_frame_en 은 상호 배타 — 스케일 줄은 둘 중 한 곳에서만 나간다udframing_scale_en 은 lane 샷 전용 — 그 밖에서는 camera_frame_en 이 스케일을 갖는다uchain_bg_mode 는 단일 권위(첫 참조=배경본) — prev_used/lane_ref_mode/seed_bg_mode/structure_seed_attached 와 상호 배타cFtt|fdi|jS)Nr)r rr)rkwrs rI_pzbuild_still_prompt.._pT s#7DA(AbAGGIIrKz8the attached PREVIOUS SHOT STILL shows this exact place.location_lock_lane_location_lock_chain_bgrlocation_lock_seed_bglocation_lock_text_onlyz6the attached LOCATION PHOTOGRAPH shows the exact spot. still_headzas the scene text implies)rB time_of_dayz#SHOT TEXT (authoritative, Korean): LOCATION (lock): u The shot takes place here — structure_look_clausecontinues_clause_castr?continues_clauseprev_usage_clauserrrpcVtt|tjS)Nrr rrr)r _realize_sels rI_realizez$build_still_prompt.._realize s% T*<8::?%' BrKro human_formrn nonhuman_castr)rnamesrlrmrksupport_stillness_clausezMOVEMENT (follow exactly): u+FIGURES — size & depth (follow exactly): uUCARRIED STATE (persist exactly — must match the neighbouring shots of this scene): handled_object_clause)rhandlerhandled_object_framinguYstill_recipe: bg_only 와 인물 배정이 충돌 — 배정을 따른다 (char_names=%s) people_clauser)rHpeople_clause_scene)rrHno_people_clauseno_people_fallbackno_text no_text_noner)rrrr)r_LANE_LOCATION_PACKSrrrr r CHAIN_BG_LOCATION_PROMPT_VERSIONr!TEXT_ONLY_LOCATION_PROMPT_VERSIONrr. PREV_USAGE_CLAUSE_PROMPT_VERSIONr~REALIZE_COMPACT_PROMPT_VERSIONREALIZE_PROMPT_VERSIONrrEr$NONHUMAN_CAST_COMPACT_PROMPT_VERSIONNONHUMAN_CAST_PROMPT_VERSIONrSra SUPPORT_STILLNESS_PROMPT_VERSIONHANDLED_OBJECT_PROMPT_VERSIONloggerinfoPEOPLE_SCENE_PROMPT_VERSIONNO_PEOPLE_PROMPT_VERSIONTEXT_POLICY_GROK_PROMPT_VERSIONTEXT_POLICY_PROMPT_VERSION)( shot_desc place_texttime_of_day_enrBrfrnrCrDrErFrGrrHrIrJrKrLrMrNrOrPrQrrRrSrrTrrUr[loc_tailpartsrjn _nonhuman _all_nonhuman_cv _hand_selrirs( @@rIbuild_still_promptrst.@@1-1BCDD/CC^,-D D   !6 6  01MM  M   /  01BB  3M = N  O B    9  ]l6M S  &&6&H.IHJ F  +M?;<  -*02  %'  -.  .*13  %'  E  B*>R*>A3q6<<>Q*>IR OOI#j>NB:O(OM j LL,/ 0 LL01 2  LL.?@Euw H  R,-.  %& Z $ LLjn&/? ++-./4eg 7 ;;u SSs [ ([ ct|ts|S|jd}|dk(ry|dk(r)|jd}|s tdt |S|S)uT배경 공유 계획(B-3, 2026-07-19)의 prev/배경 결정 — 상위 권위. 계획 없음=classify 판정 유지(fail-safe). ref_plan=="background"= prev 미사용(계획이 '이 샷은 배경 기준' 확정). ref_plan=="prev"=계획 앵커로 override — 앵커 결손=ValueError(조용한 강등 금지, 샷 격리). ref_plan backgroundNprevprev_anchor_tagu-share_plan prev 앵커 결손 — fail-closed)rrrrr)classify_prev_tag shot_planrWanchors rIapply_share_plan_prevrm sb i &  z "B \ V|01LM M6{ rKcB|xr| xr| xr| xr | xr| xr| S)uBGFIRST2 체인 대상 판정 — **일반 콘티 샷만** (순수 로직). 사용자 확정(2026-07-20): 콘티 사용 샷만 교체, 비콘티 샷(prev/bgonly/ lane)은 기존 유지. 복잡 구조물(structure seed·seed-bg·complex A/B) 파이프는 2026-07-16 사용자 확정 별도 계약이라 제외 — BGFIRST2 실증 (S19sh4/S22sh2/S8sh4)도 전부 일반 콘티 샷. rx) conti_presentrfrnrormrLseed_bg_attacheds rIbgfirst_eligibler sR$  !K !M !M !N  ! ( '  ! ! rKcNt|tsyg}t|jdxsdj }|r|j |t }|jdxsgD]}t|tst|jdxsdj }t|jdxsdj }|r||vrs|j||j |rd|d|nd|dj|S) u장소 사실 — 절제 블록 (2026-07-26 사용자: "너무 디테일하게 넣으면 안 돼"). 싣는 것: layout_narration_en 1단락 + items 의 kind/name_en. 빼는 것: - placement_en — 배치 권위는 첨부 콘티의 선이다. 텍스트로 또 주면 이중 권위가 되어 구도가 흔들린다. - code/evidence/inferred/zone_labels_en — 감사 필드이거나 narration 과 중복. - excluded_transient_elements — 금지 대상 열거는 오히려 프라이밍 이다(outdoor_marker_map.build_geometry_text_lines 의 구조 토큰 비노출과 같은 계열). 코드는 데이터 직렬화만 한다 — 의미 판단 없음. spec 은 `Any` 다 — 실호출은 체크포인트 원본(무타입)이라 dict 가 아닌 값([] / None)이 실제로 들어온다. Dict 로 좁히면 아래 isinstance 가정이 항상 참이 되어 정적 검사기가 가드를 죽은 코드로 읽는다(Optional 로는 None 만 덮여 [] 를 못 담는다). r[layout_narration_enrkindname_enr4: r) rrrrrrrrr~)specr narrationseenitrrs rIbuild_place_facts_blockr s* dD !EDHH239r:@@BI YUDhhw%2%"d# 266&>'R(..0266)$*+113tt|   Dr$r$(4&kB& 99U rK)rPrplace_facts_blockworld_facts_block lane_fillrc t|} |re|js td|js tdttd| jd|d|d|dg} n.ttd | jd|d|d|dg} |r| j ||r| j ||re| j d |z| j d |z| j ttd tt jn<| j ttd tt jdj| S)uStep1 재투영 프롬프트 — 정본 bg_prompt 조립 순서. head(무인+콘티 카메라 권위·플레이트=재질/간판 소스·재투영 계약) → SHOT TEXT → LOCATION(lock) → TIME OF DAY(lock) → CAMERA/FRAME 절 (fix1 렌더 완문, 부재=생략) → LIGHTING & MOOD 절(fix⑤, 부재=생략) → tail(16:9 빈 실사 배경). lane_fill (2026-07-26 확정 흐름): 참조 이미지 0 으로 콘티 자체를 편집하는 lane 경로. head/tail 스템이 bg_fill_* 로 바뀌고 장소·world 사실 블록이 **필수**가 된다 — 둘 중 하나라도 비면 무국적 배경을 조용히 만들게 되므로 ValueError(fail-closed). 기본값 False 는 기존 조립과 byte-identical. uylane_fill 인데 place_facts_block 이 비어 있음 — 장소 사실 없이 배경을 만들지 않는다 (fail-closed)uzlane_fill 인데 world_facts_block 이 비어 있음 — 지역·시대 없이 배경을 만들지 않는다 (fail-closed) bg_fill_headrz/SHOT TEXT this background must serve (Korean): rbTIME OF DAY (lock): rbg_reproject_headzTHINGS AT THIS PLACE: u1WORLD FACTS (creator-confirmed — always true): bg_fill_tailbg_reproject_tailr)rrrr rrrr~) rrrrPrrrrrrrs rIbuild_bgfirst_bg_promptr s2&n5H &&(L !&&(L   B H H J=i[ I | ,">"2! 4   ,h @@E=i[ I | ,">"2! 4   _%  %&  .1BBC @  !  [ ^**,-.3UW 6  [ (**,-.3UW 6 ;;u rKc|rdt|}}n!|rdtt}}n dt|}}tt||j dz|zS)uStep2 인물 삽입 프롬프트 — 정본 final_prompt: stage_head(배경 EXACTLY 유지·스케치=인물 배치만·선 잔류 금지) + base 스틸 전문. mannequin=True (2026-07-26 확정 흐름): 배경본의 회색 마네킹을 실제 인물로 교체하는 계약 스템(stage_head_mannequin)을 쓴다 — 위치·크기· 자세·방향 유지, 미러 금지, 마네킹/스케치 선 잔류 0. lane 체인의 Step1 은 마네킹을 **보존한 채** 배경만 실사화하므로(bg_fill_head "do not turn them into people"), 이 교체 계약이 없으면 회색 마네킹이 최종 스틸까지 살아남는다. 스템 교체이지 덧붙임이 아닌 이유: v7 stage_head 는 ①"배경을 EXACTLY 유지"(=마네킹 유지로 읽힌다)와 ②"SECOND attached image (LAYOUT SKETCH)"(lane 은 conti=None 이라 그 참조 자체가 없다)를 품고 있어, 앞에 절을 덧대면 두 문장이 그대로 남아 서로 싸운다. geom_authority=True (2026-08-07, 팩 v15): 좁고 복잡한 실내 — `stage_head_geom` 으로 교체한다. v7 stage_head 는 "Ignore the sketch's background lines" 를 품고 있어 덧대면 두 지시가 싸운다. 교체본은 배경의 조작 장치·좌석·거울을 세고 같은 수·같은 자리로 유지하게 하며, 스케치의 배경선을 인물과 구조의 관계를 읽는 데 쓰게 한다. 실물 대조가 근거다 — 배경본은 핸들 1개인데 인물 삽입 뒤 림이 이중이 됐다. mannequin 과 겹치면 mannequin 이 이긴다: 마네킹 교체는 그 자체가 배경을 고쳐 쓰는 계약이라 "배경을 그대로 두라"와 양립하지 않는다. 마네킹 경로는 lane 체인 전용이고 lane 은 이 판별 대상이 아니다. base 스틸 프롬프트 전문은 세 경로 모두 그대로 유지한다 — 자세 정본· 조명·표정 사실감·소품 계약을 잃지 않는다. 기본값(False)은 기존 산출과 byte-identical. stage_head_mannequinstage_head_geom stage_headrr)rrr rr)rUr mannequinrrXrs rIbuild_bgfirst_final_promptr skH "$:>$J   "#@ A&'=n'MhGT84::<    rK)rentity_label_versionrcFt|}t|}ttd|j|fg} |K|rdttfnd|f\} } | j tt| | j|fttd|j} ttd|j} |D](\}}| j | j ||f*|D](\}}| j | j ||f*| S)uStep2 참조 조립 — [SHOT BACKGROUND, LAYOUT SKETCH, 엔티티]. bg/sketch 라벨=팩 v7 정본 스템, 엔티티 라벨=샷의 기본 팩(v1 — eligibility 가 일반 콘티 샷만 허용하므로 다른 selector 불가)과 동일 포맷 — 무콘티 후보(B)와 엔티티 라벨이 정확히 일치해야 비교가 순수. conti=None (2026-07-26 확정 흐름): LAYOUT SKETCH 슬롯을 생략한다 — lane 체인의 배경본은 이미 마네킹 배치와 장소를 담고 있어 콘티가 중복이고, 선 그림을 참조로 넣으면 스케치 선 잔류 위험이 있다. 비-lane 호출(conti 실재)의 참조 순서·라벨은 불변이다. bg_labelrsketch_label_geomrrrr)rr rrrrr)bgrrrrrrr ent_resolvedrsk_stemsk_verrrrrs rIbuild_bgfirst_refsrQ s+*&n5H)*>?L Wj( ; A A CRH#D  ! #$A B D$2H#=  '6 : @ @ BE J |55:UW|55:UW c Z&&D&1378 c Z&&D&1378 KrKcXt|}ttd|jS)u2택1 중립 판정 헤더 — 기본 헤더('generated from this')는 체인/무콘티 후보가 서로 다른 참조·프롬프트로 생성되므로 거짓(HIGH-6 계약 연속). judge_headerr)rr rr)rrs rIload_bgfirst_judge_headerr s& &n5H w A G G IIrK>rbgonlyno_plateczt|tr|sy|jdry|jdtvS)u콘티 스텝이 구조적 비대상으로 선언한 샷 여부 (E2E10 결함 1호 fix). shot_conti_light 모듈 계약: "콘티 부재가 스틸을 막지 않는다 — 플레이트 없는 샷은 skipped_reason='no_plate'". BGFIRST2 정책 대상은 '콘티 사용 샷'만(사용자 확정 2026-07-20) — 콘티 스텝이 스스로 대상 외로 선언한 샷 (no_plate/prev/bgonly)은 fail-closed 가 아니라 기존 경로 유지. E2E10 실측: 야외 prev_shot_ref 그룹·lane none 의 no_plate 10샷 fail-closed + prev 앵커 부재 연쇄 4샷(skipped=prev 인데 prev_sel=None → prev_used= False 로 정책 대상 오판정). entry 부재/비정형(non-dict)/생성 error/ 미지 사유는 여전히 정책 대상 → bgfirst_conti_defect fail-closed (Codex BLOCKING 계약). error 는 skipped_reason 보다 우선 — 손상·stale CP 에서 구조적 skip 에 가려 legacy 로 무음 하강하지 않는다 (Codex NARROW 재리뷰). Ferrorskipped_reason)rrrBGFIRST_STRUCTURAL_SKIPS) conti_entrys rIbgfirst_structural_skipr s8 k4 ( w ??+ ,0H HHrK)chain_lane_prevc"|s|sy|ry| xr| S)utBGFIRST full 대상 판정 (E2E10 fix④ — 사용자 확정 "콘티=무조건 배경 우선 전면화", 순수 로직). 콘티가 실재하는 전 샷 = 체인 대상: complex(structure seed)·seed-bg· no_plate(콘티 팩 v3 저작) 전부 포함 — bgfirst_eligible(v2 계약)과 달리 구조물 파이프도 체인으로 편입한다(Step1 에 STRUCTURE LOOK 3번째 참조·위치 권위 해석은 서비스 담당). 비콘티 샷(prev/bgonly/lane)은 확정 레시피대로 기존 유지. chain_lane_prev (2026-07-25 사용자 확정 — 야외 케이스1 스펙 E·F): lane(마커 스케치 콘티) 샷과 prev 지휘 샷도 체인 편입. 실측 근거: lane 샷은 배경 권위가 아예 없어 같은 장소 일반 샷과 다른 장소로 그려졌고(S15sh1 vs S15sh5), prev 지휘 샷은 구도가 다른 직전 스틸을 재투영 없이 참조만 해 장소가 재현되지 않았다. 배경 권위 해석(prev 스틸/groupbg)과 조립 통일은 서비스 담당. bg_only 는 계속 제외 (콘티 자체가 없다). default False = 기존 경로 byte-identical. FTrx)rrfrnrors rIbgfirst_eligible_fullr s!2m= *]*rK)rBrlocation_detail_enscene_evidencec t|}ttd|jd|d|g}|tvr|xsdjrC|j ttd|jd|jz|Dcgc]'}|xsdjs|j)} }| rK|j ttd|jdzdj d | Dz|jd |d ttd ttjgd j |Scc}w)uno_plate 그룹의 장소 단위 배경(groupbg) 프롬프트 (fix③④). head(무인+콘티=공간 근거·사진 신조) → THE LOCATION(장소 lock+world anchor) → [v11+ LOCATION DETAIL(loc 서술/traits) → SCENE EVIDENCE (share 그룹 원문 인용 — 장소 사실만)] → TIME OF DAY → tail(16:9 샷 중립 실사 배경). **샷 특정 정보(SHOT TEXT/카메라) 불포함** — 같은 장소의 모든 샷이 재사용하는 그룹 공용 배경이라 특정 샷 카메라에 묶지 않는다 (샷별 카메라는 Step1 재투영이 담당). E2E11 ③ 실측: 장소 근거가 place_en 1문장+콘티뿐이라 감식 현장 groupbg 가 허허벌판 시멘트 바닥으로 렌더 — 가용 근거(loc description/ visual_traits·share 그룹 evidence 인용)를 코드 조립으로 주입한다. 빈 입력=절 생략(dangling 금지), v10 이하=kwargs 무시(byte-identical). groupbg_headrz THE LOCATIONrr[groupbg_detail_headrgroupbg_evidence_headc3&K|] }d| yw)r4Nrx)ryqs rIr|z'build_groupbg_prompt.. s"DDF |nBzl3 E..  $" + + - LL2H%')//1234  &4I^R7H!'')^I  LL4h%'">'2 3 = = ? DD Es B B ct|xrE|duxr?t|txr-|jdxr|xrt|txrd|vS)u&(era R2 BLOCK-1) 조사 미성립 시 기존 groupbg 보존 여부 — 순수 판정. True 조건 전부: era ON · 이번 방문 조사 산출 없음 · outcome 이 "실패"(비대상 아님) · 기존 파일 정상 · 이전 meta 에 era_research_sha 존재(=원래 era 로 만든 배경). 보존은 현재 계약 검증을 미루는 것이라 호출측은 걷기 끝 미봉인(StillEraPreserveIncomplete)과 반드시 짝지어 쓴다 — 보존만 하고 봉인하면 진짜 drift 가 낡은 배경 아래 영구 동결. Nfailedera_research_sha)rErrr)era_onera_metaoutcomefile_ok prev_metas rIera_preserve_appliesr sf  ,8t# , w % ,*1++h*? ,  ,"9d3 , ) +  --rKcj|r|jd|k(sy|}|jd|k7|fS)ugroupbg 재사용 결정 — (regenerate, fp). 계약(서비스 인라인 블록을 순수 함수로 추출): - 파일 결손 or meta(팩·모델·계약·group_sig·context_sig) 불일치 = 멤버 무관 재생성 - meta 일치 = **canonical origin 입력(현재 상류 SOT 기준) 지문 대조** — Codex 3차 리뷰: origin 이 already_done 으로 skip 되는 partial resume 에서 follower 가 origin 의 현재 place/time/콘티 bytes drift 를 감지하지 못하던 창 봉합. fingerprint_fn 은 호출측이 canonical origin 기준(자기 자신 or record.origin_tag 의 현재 입력)으로 구성한다 — follower 자기 값 지문 금지(멤버별 진동 차단). meta)TNinput_fingerprintr)prev_recrrfingerprint_fnfps rIdecide_groupbg_reuser0 s<&  V,4  B <<+ , 2B 66rK)current_group_sigcbt|jdxsdxs|}|ro|m|jdxsijd}|||k7rtd|d|xsijdxsg}||k7r|r||vrtd|d ||k(ri|d|iS||}i|d|iS) ucanonical origin 입력 해석 (Codex 재리뷰 NARROW-1 + 3·4차 NARROW). fresh run 은 그룹의 story-순 최초 샷(origin) 콘티·장소로 생성한다. partial resume 에서도 지문 대조·재생성이 전부 **origin 의 현재 상류 SOT 입력** 기준이어야 실행 형태와 무관하게 픽셀/lineage/감사값이 동일하다(3차 리뷰: 과거 record 복원만으로는 origin 의 현재 place/time/콘티 bytes drift 를 follower resume 이 감지 못함). 계약: - **group_sig 변경 = fail-closed** (4차 리뷰): share 그룹이 재저작돼 멤버 구성이 바뀌면(old origin 이탈·더 이른 멤버 추가 포함) 과거 origin 을 보존해 재생성하는 것도, 트리거 샷을 조용히 승격하는 것도 fresh-equivalence 를 깨므로 record 리셋 재실행을 명시 요구. origin_tag ∉ 현재 그룹 tags(레코드 손상)도 동일. - origin_tag = prev_rec.origin_tag(있으면 보존) else 현재 tag — follower 를 새 origin 으로 조용히 승격하지 않는다. - 자기 자신이 origin = current_inputs 가 canonical. - 타 origin = origin_lookup_fn(origin_tag) 이 **현재** authoritative maps(classify/콘티)에서 해석 — 해석 실패는 lookup 이 ValueError (fail-closed, 원 origin 재실행 요구). follower 자기 값은 절대 사용하지 않는다. 반환: {place_text, time_of_day_en, conti_path, conti_asset_id, origin_tag} origin_tagr[r group_siguJgroupbg share 그룹 재구성 감지(group_sig 변경) — 과거 origin(um) 보존/승격 모두 fresh-equivalence 위반이라 fail-closed. groupbg record 리셋 후 재실행 필요tagsgroupbg origin(uN)이 현재 그룹 tags 에 없음 — record 손상/드리프트, fail-closed)rrr) rr,current_inputsorigin_lookup_fnrrprev_sigrrs rI resolve_groupbg_canonical_originrI s@X\\,/526=#J%1LL(.B33K@  H0A$A$&WW  "'R,,V4:  *D*@!*.:: S4.4,44 +H 1h 1 j 11rKc|r t|nd}|-|jr|jjdkrt d|d|dt |t r|jst d|d|S)u/canonical 콘티 소스 검증 (Codex 4차 NARROW-2) — 생성 전 fail-closed. 파일 실재+비어있지 않음+asset UUID(SOT) 필수 — Path.exists() 만으로 디렉터리/0-byte/asset 결손이 통과해 감사 edge 가 과거 UUID 로 남던 창 봉합. 반환=검증된 Path. Nrru4) 콘티 파일 무효(부재/디렉터리/0-byte): u — fail-closeduA) 콘티 asset UUID 결손 — lineage SOT 미해결, fail-closed)rrustatst_sizerrrr) conti_pathconti_asset_idrrys rIvalidate_groupbg_conti_sourcer~ s'ZDAy qvvx'7'71'<j\*"~%5 7   ~s +0D0D0Fj\*1 1   HrKc"|s td|gS)uwgroupbg lineage 입력 검증 — 근거 콘티 UUID 실재 필수 (fail-closed, bgfirst_require_input_ids 관례).u5groupbg 근거 콘티 asset 미해결 — fail-closedrc)rs rIgroupbg_require_input_idsr s PQQ  rKlane_conti_only)conti_attachedc|dddddtfvrtd||tk(r|sttd|r |rdd gSd gS|g}|r|jd |S) uMfinal still 의 직접 첨부(actual_attached) lineage 역할 목록 (Codex HIGH-3 — false direct edge 방지, 순수 로직). 체인 승: final 의 실제 refs=[bgfirst_bg, conti, entities] — conti/ bgfirst_bg 만. 위치 권위·STRUCTURE LOOK 은 Step1 중간 bg 의 input edge 가 소유한다(직접 첨부 아님). 무콘티 승: B 후보 refs=[위치 권위(+STRUCTURE LOOK), entities] — 권위 종류별 role + seed(실재 시). authority_kind="prev" (2026-07-25, 케이스1 스펙 E·F): prev 지휘 샷 체인. 무콘티 후보가 없어 B=현행 prev 경로 그대로이므로, 무콘티 승 시 role 은 prev_still(+콘티 실재 시 conti) — 서비스가 현행 조립과 동일한 첨부를 재현한다. authority_kind="canon_master" (동): lane 샷 체인 — 콘티(마커 스케치) 가 본 장소 실사가 곧 위치 권위다. 무콘티 승 시 그 사진이 직접 참조. conti_attached (2026-07-26): 체인 승 final 이 콘티를 **실제로** 참조 하는지. 확정 흐름의 lane 체인은 Step2 참조에서 콘티를 빼므로 False — 이때 direct role 은 bgfirst_bg 뿐이고 콘티 UUID 는 중간 bgfirst_bg 의 input edge 에만 남는다(conti → bgfirst_bg → final). True 로 두면 존재하지 않는 direct edge 가 생긴다. rgroupbgrr canon_masterzunknown authority_kind uj 는 체인 단독 경로 — chain_won=False 는 도달 불가 조합 (거짓 lineage 대신 fail-closed)r bgfirst_bgr)LANE_CONTI_ONLYrr) chain_wonauthority_kindrLrrs rIbgfirst_winner_lineager s:Iv~2>2DEFF( G G  *8&L|nL  C #$ JrKcTttdt|jS)unStep1 3번째 참조(STRUCTURE LOOK) 관할 절 — complex 샷 체인 편입 (fix④). 팩 v9 스템 SOT.bg_reproject_seed_clauserrh)rs rIbuild_bgfirst_seed_clauser s( +&~6  egrKc|xsi}|jdrd|dS|jdr d|ddS||jsd|jddS|jd sy y) uBGFIRST 정책 대상 샷의 콘티 산출 결함 사유 (없으면 None). Codex 리뷰 1 (BLOCKING): flag ON 에서 정책 대상(일반 콘티 샷)이 콘티 실패/파일 결손/asset 결손이면 legacy 무콘티 생성으로 조용히 하강하지 않는다 — 호출자는 사유로 mark_failed (fail-closed). 비대상(prev/ bgonly/lane/complex)은 이 판정을 타지 않는다. ru콘티 생성 실패: ru콘티 미생성(skipped=rNu콘티 파일 결손( image_pathru7콘티 asset_id 결손 — lineage 없이 진행 금지)rru)rrentrys rIbgfirst_conti_defectr s  2E yy'g'788 yy!"*51A+B*C1EE!3!3!5&uyy'>&ACC 99Z H rK) seed_asset_id seed_attachedrc|s td|tk(r|s|ttd|d|g}n|std|d||g}|r|s td|j||S)uStep1 lineage 입력 검증 — conti/plate UUID **둘 다** 실재 필수. Codex 재리뷰 1 (HIGH): plate UUID 미해결(row 부재·조회 예외로 None) 상태에서 bg asset·성공 record 를 영속하면 불완전 lineage 가 성공으로 고착된다 — 등록 **전** ValueError 로 샷 fail-closed (warning-only fail-open 금지). 반환=[conti, plate] 고정 순서. seed_attached (fix④ full — complex 샷 체인 편입): STRUCTURE LOOK 을 3번째 참조로 첨부한 경우 seed UUID 도 실재 필수 → [conti, plate, seed]. default False=기존 2 UUID byte-identical. authority_kind=LANE_CONTI_ONLY (2026-07-26 확정 흐름): 외부 사진이 아예 없는 lane 체인 — 플레이트 UUID 요구를 **이 모드에서만** 면제 하고 [conti] 만 반환한다. 콘티 UUID 는 여전히 필수(불완전 lineage 를 성공 record 로 영속 금지 원칙 유지). 다른 kind 는 기존 fail-closed. u.bgfirst 콘티 asset 미해결 — fail-closedu* 인데 플레이트 입력이 공급됨 (u*) — 참조 0 계약 위반 (fail-closed)u%bgfirst 플레이트 asset 미해결(u3) — 불완전 lineage 영속 금지 (fail-closed)uXbgfirst STRUCTURE LOOK asset 미해결 — 불완전 lineage 영속 금지 (fail-closed))rr r)rplate_asset_idrtrrrrs rIbgfirst_require_input_idsr s2 IJJ( Z3"#$<IK 7 |D66 ~..  =! JrKr  bgfirst_step1)model asset_typerchainc |t|} d| i} || } | /|| | t|| || _|dd| _d| _| S|| |||dd}d|_||| t|| |S)uStep1 재투영 배경을 intermediate ImageAsset 으로 idempotent 등록. asset_type/role/chain (fix③④ full): groupbg(장소 단위 공유 배경)도 동일 upsert 계약으로 등록 — default=기존 bgfirst_bg byte-identical. Codex 리뷰 2 (BLOCKING): 캡처 큐는 이 서비스에 generation_context 가 없어 no-op 이고, 있어도 UUID generated 경로로 등록해 recipe 경로 조회와 어긋난다 — recipe 경로 기준 **명시 upsert** 가 lineage SOT. register_intermediate_assets 와 동일 주입 계약: 기존 row 는 lineage/ prompt/model 을 현재 값으로 갱신(재생성 후 stale edge 잔존 차단), 신규는 생성. input_ids=bgfirst_require_input_ids 산출([conti, plate] — 호출 전 검증 완료 계약). 재리뷰 2 (NARROW): fresh/existing 모두 is_intermediate=True 정규화(캔버스 필터/접기 — 이 전용 recipe 경로는 bgfirst_bg 중간물 단일 용도). 반환=asset. rN)rrriT)relrrr)rrgeneration_model prompt_usedis_intermediate)bg_pathrrrel_fnfind_asset_by_rel new_asset annotate_fnrrrrr!rexistingassets rIregister_bgfirst_bg_assetr,* s: W C#U+D %H 44 ? %*!%fu~#'   Jefu~ E!E DDO$ LrK)rr)rRrrr)rRrrTuple[str, str])r]rErr)rRrrerErr-)rRrrjrrr)rrrXrrrrr) rrrrrrrRrrzTuple[str, List[str]])rrrr)rrrXrrr)rr<)rrrrrr<) rrrrrzDict[str, Dict[str, Any]]rDict[str, str]rr<rr)rSequence[Dict[str, Any]]rzTuple[List[str], List[str]])Jr?rr@Sequence[Tuple[str, Any]]r rr.rrrr!rrArr0rr1rr3rr4rErBr.r:r<rrrrrrrrrrrrEr rEr rr rEr rr rrrrrrrErrrrrrrrErrErrrrrrrrrzTuple[Any, Dict[str, Any]])r9r<rrE)r9r<rUrrr)r?rr9r<rr)rdrrerErfrErr)rlrErmrErfrErnrErorErprErqrErr)rvOptional[Dict[str, Any]]rwrrxrrz/Tuple[Optional[Path], Optional[Dict[str, Any]]])rr/r,rrdrrzSet[str])r Dict[Tuple[int, int], List[str]]rTuple[int, int]r List[str])rr2rr3rzTuple[List[str], bool])rrrr)"rfrErrrrrrrr0rr0rrrrrrErrrrrrrrErrrrrrErr)rrrrrr0rr0rrrrrrrz3Tuple[List[Tuple[str, Any]], List[Tuple[str, Any]]])r[)rr1rRrrerErr)rorErrErfrErrE)rr1rr)r rErRrrr)r]rErrErrE)rrr]rErrErr)rRrrrrrrr)rUrr& Sequence[str]rRrrr.)r,r5r/rErr)r8r/rr)rrr@rrr)rJs$#BBB1   8 $ t t  t t t( )t4 5t@ AtL MtV Wtd etr st| }tJ Kt` at| }tL MtV Wtj ktt utJ KtZ [tp qtH It` atl mtp qtt utH ItR Stb ctn otr stB CtJ Kt~ @      ,  :  g tn !$ $$( &*"$(   $'+$ ""& "& "&#"!%!$(! $ !%  #Juc 2# 1# #$( %)!# $$( $ #' !%'+# ) !=A"& ,00@&&59&&6D4.4: .8 J62z9 0 00 0 0  0f L 92M;&M;M;M;`  *  #  ( *!+! !N"! */##'!!$) % $!% W[[+[ [  [  [[[[[[[ [&[ [ !["#[()[*+[,-[./[01[2$(3[45[67[8!9[:;[<=[>?[@A[BC[H!I[LM[NO[PQ[TU[VW[X Y[|0& &),&&000+00(   2FFF F  F  FFF FB0-0$0" 0 5 0f(  .1/16E11&/&6E&&&:#' $"%)" !&-a a a  a  a ) a)a aaa#aaaaa$%a,-a./aT&*"+) +) +)) +) ) +) # +)+)+)9+)b +  "" @Bi%*i %i9<i"i iXH&2824+.H "$ "%'"$) kggg g  g  ggg ggggg !g(")g./g01g2"3g45g67gDEgFGgJKgLMgNOgTUgZ[g`agbcgjkgl mgT $'@     " 8%Z0III I  I  IIIII I\1 1111 1  1t1 # - - -) - ) -  ----b1JJJ%%CDI8" +++ +  +  + +D5 $&333 3  3  3"3 3lEE"E E6- -'-& -  -  - -.77 7 7  7>37 2222 22# 22 0 2222j       4$ ,,," ,  ,  ,`6)8$(!0!0"0 0 ! 0  000x(" 1 1 1 1  1  111 11 1 1 1rK