ji*@^dZddlmZddlZddlZddlmZddlmZee jjddz Z e e ejvr"ejjde e ddZdd Z dd ZeZdd Zdd Zdd ZddZddZddZy)uShared preflight helpers for G4.5a canary scripts (Wave 3). All 4 metric scripts (`g4_5a_camera_frame_consistency.py`, `g4_5a_fg_bg_shared_anchor.py`, `g4_5a_primary_framing.py`, `g4_5a_view_mixing_extension.py`) import the helpers from this module and apply them identically. The token-count script (`g4_5a_token_count.py`) does NOT use these helpers — per PR4-B4 it reads prompt files, not CP, and must remain CP-free (no `compute_render_strategy_snapshot_hash` import). Trap #1 silent-absorb ban (G4.3 R3R4-B2 + G4.4 carry): - `or [] / or {}` 패턴 금지. - `data.scenes` / `t2i_variations` / `t2i_prompt` / `render_prompt_card` / `render_strategy.spatial_consistency` 누락은 measurement_failures 로 적재 후 caller 가 exit 1. - `compute_render_strategy_snapshot_hash()` 호출 실패도 measurement_failures 로 적재 (silent skip 금지). Trap #3 — CP shape `scene["render_prompt_card"]["render_strategy"]` (NOT flat). G4.2 carry — `detail_steps.py` authoritative. Trap #8 — module-level constants single source. Imports happen in `render_prompt_card_imports()` only — no inline duplication of the 9-entry close-framing keyword tuple, 7-entry interaction verb tuple, etc. PR4-B4 — token script CP-free: this module is NOT imported by `g4_5a_token_count.py`. ) annotationsN)Path)Anybackendc Lddlm}m}m}m}m}m}m}m}m }m } |||||||||| d S)uReturn the G4.5a + G4.3-cross module symbols Wave 1-A exposes. Centralised to give every canary script a single import boundary; if Wave 1-A renames a constant, only this module needs adjustment. Trap #8 carry — module-level constants direct import; NO inline tuple duplication of the 9-entry close-framing keywords / 7-entry interaction verbs / 8-entry frame-edge tokens / etc. RO-11 binding — G4.5a reuses G4.3 `_ID_BODY_PART_TRIGGERS` directly. NO `_SPATIAL_BODY_PART_TRIGGERS` alias. r _ID_BODY_PART_TRIGGERS_SPATIAL_CAMERA_HIGH_TOKENS_SPATIAL_CAMERA_HIP_TOKENS_SPATIAL_CAMERA_LOW_TOKENS _SPATIAL_FG_BG_SEPARATION_TOKENS#_SPATIAL_FRAME_EDGE_POSITION_TOKENS_SPATIAL_FRAMING_CLOSE_KEYWORDS_SPATIAL_INTERACTION_VERBS_SPATIAL_SHARED_ANCHOR_KEYWORDS%compute_render_strategy_snapshot_hash) !app.core.steps.render_prompt_cardr r r r rrrrrrr s J/Users/manta/Documents/Projects/TheRoad-I1/scripts/canary/_g4_5a_common.pyrender_prompt_card_importsr,s;   #9'B&@&@,L /+J&@+J 1 cd|vr|jdy|d}t|ts|jdyd|vr|jdy|d}t|ts|jdy|S)uValidate CP envelope shape and return scenes list (or None on failure). Caller must check None and fail-fast (sys.exit(1)) — measurement_failures is appended in-place. Trap #1 — silent-absorb ban (NO `.get(..., default)` fallback). datazcp.data key missingNzcp.data not dictsceneszcp.data.scenes key missingzcp.data.scenes not list)append isinstancedictlist)cpmeasurement_failuresrrs r_load_scenes_or_failr!XsR##$9: f:D dD !##$67t##$@A (^F fd ###$=> Mrc d|vr|jd|d|dy|d}t|ts|jd|d|dyd|vr|jd|d|dy|d}t|ts|jd|d|d yd |vr|jd|d|d y|d }t|ts|jd|d|d y d dlm}||d|vr|jd|d|dy|d} t| t s|jd|d|dy| s|jd|d|dy| S#t $r$}|jd|d|d|Yd}~yd}~wwxYw)uValidate per-scene shape — render_prompt_card / render_strategy / spatial_consistency / variations. Returns variations list when valid; None otherwise (caller continues loop). Per spec §5.3 + Trap #1 silent-absorb ban + Trap #3 CP shape: - render_prompt_card must be dict. - render_prompt_card.render_strategy must be dict. - render_prompt_card.render_strategy.spatial_consistency must be dict. - compute_render_strategy_snapshot_hash(rpc) must succeed (no silent skip). - t2i_variations must be present, list, AND non-empty (R3-B1 carry — empty must fail, never silently absorbed). render_prompt_cards_shz : render_prompt_card key missingNz: render_prompt_card not dictrender_strategyz0: render_prompt_card.render_strategy key missingz-: render_prompt_card.render_strategy not dictspatial_consistencyzD: render_prompt_card.render_strategy.spatial_consistency key missingzA: render_prompt_card.render_strategy.spatial_consistency not dictr)rz: render_strategy hash failed: t2i_variationsz: t2i_variations key missingz: t2i_variations not listz: t2i_variations empty)rrrrr Exceptionr) scenesishir rpcrsscrexc variationss r_validate_scene_preflightr2ps1(5(##t3se; <  $ %C c4 ##t3se8 9 ###t3seK L   B b$ ##t3seH I B&##t3se. /  ! "B b$ ##t3se+ ,    .c2 u$##t3se7 8 '(J j$ '##t3se4 5  ##t3se1 2  - ##t3se:3% @  s#E F"FFc  t|ddrt|j}|js3t d|t j t jd |jdd5}tj|ddddfd }|d |d |d |d|d|d|ddS t|d drtj|jnd}t|d drtj|jnd}t|d dt|ddt|ddt|ddt|dddS#1swYxYw#t$r>}t d |t j t jdYd}~&d}~wwxYw#t$r=}t d|t j t jdYd}~d}~wwxYw)uConstruct pinning dict from --config JSON OR individual CLI flags. Returns dict with 7 keys (G4.5a pinning block): pid / scene_index_list / shot_index_list_per_scene / model_routing / prompt_source_mode / card_commit_hash / render_strategy_card_snapshot_hash Trap #1 — NO silent defaults; caller must run validate_pinning() afterwards. `_DEFAULT_SENTINEL` is the only allowed default — `None` round-trip is enforced explicitly in validate_pinning(). configNz/[g4_5a_common] ERROR: --config file not found: filerutf-8encodingz,[g4_5a_common] ERROR: --config parse error: cHj|t}|turdS|S)N)get_DEFAULT_SENTINEL)keyvalcfgs r _cfg_or_nonez,load_pinning_from_args.._cfg_or_nones'''#01C"334 < 43  t/6 JJt,, - t8$? JJt55 6 "tUD),%> =%d,@$G#D*seDZZ  HHQKK  H  I# O   sI(E=;E1E=AG1E:6E== G3F??G H 3HH cd}g}|D]6}||vr|j|||}||dk(s&|j|8|r4td|dtjtjdt |dt s0td tjtjdt |d ts1td tjtjdyy) uDFail-fast on missing pinning fields. Trap #1 — NO silent defaults.rJNz9[g4_5a_common] ERROR: pinning missing required field(s): zF. Provide via --config or individual flags. NO silent defaults.r5r7rDz@[g4_5a_common] ERROR: pinning.scene_index_list must be list[int]rEzD[g4_5a_common] ERROR: pinning.shot_index_list_per_scene must be dict)rrOrPrQrRrrr)pinningrequiredmissingkvs rvalidate_pinningrbsHG  G  NN1   AJ 9R NN1   Gi" #   g014 8 N   g9:D A    Brc t}|d}|dD]:}t|}|jt|t}|tur|j|t}|tur4t d|dt jt jdt|tsJt d|dt|jd t jt jd|s4t d|d t jt jd|D]}|j|t|f =|S) uCartesian (scene_index, shot_index) tuples from pinning block. Trap #4 — pinning enumerates EXACT (si, shi) tuples. A scene_index without a corresponding shot_index_list entry (or with non-list / empty list) is a contract violation, not a silent default. rErDz>[g4_5a_common] ERROR: pinning.scene_index_list contains scene z? but shot_index_list_per_scene has no entry. NO silent default.r5r7z8[g4_5a_common] ERROR: pinning.shot_index_list_per_scene[z] must be list[int], got .u4] is empty — pinned scene must enumerate >=1 shot.)setintr=rKr>rOrPrQrRrrtype__name__add)r]outshot_mapr+si_int raw_shotsr,s rbuild_pinning_scene_setrnGsD!$C23H()RLLV.?@ ) ) V->?I ) ) !%&ZZ   HHQK)T* 84 ?++,A/ZZ   HHQK 8ZZ   HHQKC GGVSX& 'A*D Jrc|dz }|js3td|tjtjd |j dd5}t j|cdddS#1swYyxYw#t$r=}td |tjtjdYd}~yd}~wwxYw) zELoad `manifest.json` under cp_root. fail-fast on missing/parse error.z manifest.jsonz1[g4_5a_common] ERROR: manifest.json not found at r5r7r8r9r:Nz1[g4_5a_common] ERROR: manifest.json parse error: ) rNrOrPrQrRrSrTrUr))cp_root manifest_pathrYr0s rload_cp_manifestrruso-M    ! ?o      g  6"99R=7 6 6  ?u E   s6 BA<2 B<BBB C3C  Cc"d}t|ddrdt|jjdd5}t j |}dddj dt}|tur|}|s t|dd}|s0tdtjtjd t|}|js3td |tjtjd |S#1swYxYw) upResolve cp_root from --config or --cp-root flag. Fail-fast on missing. Trap #1 — NO silent defaults. Nr4r8r9r:rpz<[g4_5a_common] ERROR: --cp-root (or config.cp_root) requiredr5r7z+[g4_5a_common] ERROR: --cp-root not found: ) rMrr4rSrTrUr=r>rOrPrQrRrN)rW cp_root_strrYrAcfg_valrps rresolve_cp_rootrvs #KtXt$ $++  # #C' # :b))B-C;'')%67 + +!K dIt4  J   ;G >>  9' C   N); :s DDc|jdk(rHtj|tjdddtjj dy t |j}|jjdd|jdd 5}tj||dddd d d y #1swYy xYw) z2Write JSON output to args.output ('-' for stdout).-FrT) ensure_asciiindent sort_keys )parentsexist_okwr9r:N) outputrTdumprPstdoutwriterparentmkdirrS)rjrWout_pathrYs r emit_outputrs {{c #szza4P  $dT: ]]3] 1R IIc2E!t L2 1 1s CC )rLr)rrr rrL list | None) r*rr+ int | Noner,rr rrLr)rWrrLr)r]rrLNone)r]rrLzset[tuple[int, int]])rprrLr)rWrrLr)rjrrWrrLr)__doc__ __future__rrTrPpathlibrtypingr__file__resolver} _BACKEND_PATHrKpathinsertrr!r2objectr>rZrbrnrrrvrrrrs6# X&&(003i? }SXX%HHOOAs=)*)X0T TT T T  TvHJZ)X+\*< Mr