u+i4PdZddlmZddlZddlZddlmZddlmZee jjddz Z e e ejvr"ejjde e ddZdd Z dd Zdd Zdd Zdd ZddZddZddZy)uYShared preflight helpers for G4.4 canary scripts (Wave 3 carry). All 4 metric scripts (`g4_4_double_description.py`, `g4_4_zoom_in_detail_no_new_entity.py`, `g4_4_atmosphere_no_layout_import.py`, `g4_4_view_mixing.py`) import the helpers from this module and apply them identically. The token-count script (`g4_4_token_count.py`) does NOT use these helpers — it reads prompt files, not CP, and per R3-M2 must remain CP-free (no `compute_continuity_snapshot_hash` import). Trap #1 silent-absorb ban (Wave 3 carry — G4.3 R3R4-B2 carry): - `or [] / or {}` 패턴 금지. - `data.scenes` / `t2i_variations` / `t2i_prompt` / `render_prompt_card` / `continuity_elements_used` 누락은 measurement_failures 로 적재 후 caller 가 exit 1. - `compute_continuity_snapshot_hash()` 호출 실패도 measurement_failures 로 적재 (silent skip 금지). ) annotationsN)Path)Anybackendc:ddlm}m}m}m}m}m}m}|||||||dS)uReturn the G4.4 + 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 list duplication of the 7-entry generic person nouns / 7-entry furniture layout tokens / 4-entry body-part triggers / etc. r!_CONTINUITY_FRAMING_SCOPE_OPTIONS#_CONTINUITY_FURNITURE_LAYOUT_TOKENS _CONTINUITY_GENERIC_PERSON_NOUNS'_CONTINUITY_ID_POLICY_CROSS_REF_LITERAL_CONTINUITY_REF_USAGE_VALUES_ID_BODY_PART_TRIGGERS compute_continuity_snapshot_hash)!app.core.steps.render_prompt_cardr r r r rrrr s I/Users/manta/Documents/Projects/TheRoad-I1/scripts/canary/_g4_4_common.pyrender_prompt_card_importsr"s3.O/R,L3Z(D"8,L 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. datazcp.data key missingNzcp.data not dictsceneszcp.data.scenes key missingzcp.data.scenes not list)append isinstancedictlist)cpmeasurement_failuresrrs r_load_scenes_or_failrAs R##$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 y d d lm}||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 / continuity_elements_used / 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.continuity_elements_used must be dict. - compute_continuity_snapshot_hash(rpc) must succeed (no silent skip). - t2i_variations must be present, list, AND non-empty (R3-B1 carry — empty must fail). render_prompt_cards_shz : render_prompt_card key missingNz: render_prompt_card not dictcontinuity_elements_usedz9: render_prompt_card.continuity_elements_used key missingz6: render_prompt_card.continuity_elements_used not dictr)rz: continuity hash failed: t2i_variationsz: t2i_variations key missingz: t2i_variations not listz: t2i_variations empty)rrrrr Exceptionr) scenesishirrpccerexc variationss r_validate_scene_preflightr-Xs$5(##t3se; <  $ %C c4 ##t3se8 9 !,##t3se   ' (B b$ ##t3se     )- u$##t3se7 8 '(J j$ '##t3se4 5  ##t3se1 2  - ##t3se5cU ;  sD D;D66D;c t|ddrt|j}|js3t d|t j t jd |jdd5}tj|}dddjd |jd |jd |jd |jd|jd|jddS t|d drtj|jnd}t|d drtj|jnd}t|d dt|d dt|ddt|ddt|dddS#1swYxYw#t$r>}t d |t j t jdYd}~`d}~wwxYw#t$r=}t d|t j t jdYd}~d}~wwxYw)uxConstruct pinning dict from --config JSON OR individual CLI flags. Returns dict with 7 keys (G4.4 pinning block — Override O-12): pid / scene_index_list / shot_index_list_per_scene / model_routing / prompt_source_mode / card_commit_hash / continuity_card_snapshot_hash Trap #1 — NO silent defaults; caller must run validate_pinning() afterwards. configNz.[g4_4_common] ERROR: --config file not found: filerutf-8encodingz+[g4_4_common] ERROR: --config parse error: pidscene_index_listshot_index_list_per_scene model_routingprompt_source_modecard_commit_hashcontinuity_card_snapshot_hashr7r8r9r:r;r<r=z:[g4_4_common] ERROR: failed to parse list/dict JSON args: )getattrrr/existsprintsysstderrexitopenjsonloadr%getloadsr8r9)argscfg_pathfpcfgr+r8r9s rload_pinning_from_argsrNstXt$ $ @ KZZ  HHQK sW5iim6775> #(: ;),1L)M WW_5"%''*>"? #(: ;-0WW/.  t/6 JJt,, - t8$? JJt55 6 "tUD),%> =%d,@$G#D*)Nz8[g4_4_common] ERROR: pinning missing required field(s): zF. Provide via --config or individual flags. NO silent defaults.r0r2r8z?[g4_4_common] ERROR: pinning.scene_index_list must be list[int]r9zC[g4_4_common] ERROR: pinning.shot_index_list_per_scene must be dictN)rHrArBrCrDrrr)pinningrequiredkmissings rvalidate_pinningrUsH#C(Qgkk!n &Bq(GC Fi" #   g014 8 M   g9:D A    BDs C$C$c ~t}|d}|dD]$}t|}|jt|}||j|}|4t d|dt j t jdt|tsJt d|dt|jd t j t jd|s4t d|d t j t 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. r9r8z=[g4_4_common] ERROR: pinning.scene_index_list contains scene z? but shot_index_list_per_scene has no entry. NO silent default.r0r2z7[g4_4_common] ERROR: pinning.shot_index_list_per_scene[z] must be list[int], got .u4] is empty — pinned scene must enumerate >=1 shot.) setintrHstrrArBrCrDrrtype__name__add)rQoutshot_mapr'si_int raw_shotsr(s rbuild_pinning_scene_setrbs4!$C23H()RLLV-   V,I   !%&ZZ   HHQK)T* 84 ?++,A/ZZ   HHQK 8ZZ   HHQKC GGVSX& ';*> 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.jsonz0[g4_4_common] ERROR: manifest.json not found at r0r2r3r4r5Nz0[g4_4_common] ERROR: manifest.json parse error: ) r@rArBrCrDrErFrGr%)cp_root manifest_pathrLr+s rload_cp_manifestrf3so-M    ! >o      g  6"99R=7 6 6  >se D   s6 BA<2 B<BBB C3C  Ccd}t|ddrUt|jjdd5}t j |}dddj d}|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. Nr/r3r4r5rdz;[g4_4_common] ERROR: --cp-root (or config.cp_root) requiredr0r2z*[g4_4_common] ERROR: --cp-root not found: ) r?rr/rErFrGrHrArBrCrDr@)rJ cp_root_strrLrMrds rresolve_cp_rootriHs #KtXt$ $++  # #C' # :b))B-C;ggi( dIt4  I   ;G >>  8 B   N%; :s C66C?c|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_okwr4r5N) outputrFdumprBstdoutwriterparentmkdirrE)r^rJout_pathrLs r emit_outputrzds {{c #szza4P  $dT: ]]3] 1R IIc2E!t L2 1 1s CC )returnr)rrrrr{ list | None) r&rr' int | Noner(r}rrr{r|)rJrr{r)rQrr{None)rQrr{zset[tuple[int, int]])rdrr{r)rJrr{r)r^rrJrr{r~)__doc__ __future__rrFrBpathlibrtypingr__file__resolverp _BACKEND_PATHrZpathinsertrrr-rNrUrbrfrirzrrrs"# X&&(003i? }SXX%HHOOAs=)*>.G GG G G  GT@F F(V*8 Mr