+ u+i4xRt^RIHt^RIt^RIt^RIHt^RIHt]!] 4P4P^,R, t ] !] 4]P9d#]PP^] !] 44RRltRR ltR R ltR R ltRRltRRltRRltRRltRRltR#)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)AnybackendcV^8dQhRR/#)returndict)formats"scripts/canary/_g4_4_common.py __annotate__r "sDcF^RIHpHpHpHpHpHpHpRVRVRVRVRVRVRV/#) 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. !_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_hashrrrrrrr)!app.core.steps.render_prompt_cardrrrrrrrrs r render_prompt_card_importsr"sG ,-N-/R*,L13Z&(D "8*,L rc$V^8dQhRRRRRR/#)rcpr measurement_failureslistr list | Noner )r s"r r r As!T+rc6RV9dVPR4R#VR,p\V\4'gVPR4R#RV9dVPR4R#VR,p\V\4'gVPR4R#V#)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 isinstancer r)rrr r!s&& r _load_scenes_or_failr$As R##$9: f:D dD ! !##$67t##$@A (^F fd # ###$=> Mrc ,V^8dQhRRRRRRRRRR /#) rscener siz int | Noneshirrrrr )r s"r r r XsAGG GG G G  Grc RV9dVPRV RV R24R#VR,p\V\4'gVPRV RV R24R#RV9dVPRV RV R24R#VR,p\V\4'gVPRV RV R 24R#^R IHpV!V4R T9dTPRT RT R 24R#TR ,p\T\ 4'gTPRT RT R24R#T'gTPRT RT R24R#T# \ d&pTPRT RT R T 24Rp?R#Rp?ii;i)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 dict)rz: continuity hash failed: t2i_variationsz: t2i_variations key missingz: t2i_variations not listz: t2i_variations empty)r"r#r rr Exceptionr) r&r'r(rrpccerexc variationss &&&& r _validate_scene_preflightr4Xs$5(##t3se; <  $ %C c4 ##t3se8 9 !,##t3se   ' (B b$  ##t3se     )- u$##t3se7 8 '(J j$ ' '##t3se4 5  ##t3se1 2  - ##t3se5cU ;  s6E E2 E--E2c V^8dQhRRRR/#)rargsrrr r )r s"r r r s@@@@rc\VRR4'Ed\VP4pVP4'g5\ RV 2\ P R7\ P!^4VPRRR7;_uu_4p\P!V4pRRR4R XPR 4R TPR 4R TPR 4R TPR 4R TPR 4RTPR4RTPR4/#\VR R4'd!\P!VP4MRp\VR R4'd!\P!VP4MRpR \VR R4R XR XR \VR R4R \VR R4R\VRR4R\VRR4/# +'giEL<;i \d@p\ RT 2\ P R7\ P!^4Rp?ELRp?ii;i \d?p\ RT 2\ P R7\ P!^4Rp?LRp?ii;i)udConstruct 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_hashz:[g4_4_common] ERROR: failed to parse list/dict JSON args: )getattrrr8existsprintsysstderrexitopenjsonloadr/getloadsr@rA)r6cfg_pathfpcfgr2r@rAs& r load_pinning_from_argsrTs6tXt$$ $  @ KZZ  HHQK sW55iim6 3775> (: ; '1L)M SWW_5 #''*>"? (: ; +SWW/.  t/66 JJt,, - t8$?? JJt55 6 " wtUD),#%>=gd,@$GGD* or individual flags. NO silent defaults.r9z?[g4_4_common] ERROR: pinning.scene_index_list must be list[int]zC[g4_4_common] ERROR: pinning.shot_index_list_per_scene must be dict)r?r@rArBrCrDrE)N)rOrHrIrJrKr#rr )rVrequiredkmissings& r validate_pinningr]sH#C(Qkk!n &Bqq(GC Fi" #   g014 8 8 M   g9:D A A    BDs DDc V^8dQhRRRR/#)rrVr rzset[tuple[int, int]]r )r s"r r r s((T(.B(rc \4pVR,pVR,EF:p\V4pVP\V44pVfVPV4pVf6\ RV R2\ P R7\ P!^4\V\4'gL\ RV R\V4P R2\ P R7\ P!^4V'g6\ RV R 2\ P R7\ P!^4VFpVPV\V434K! EK= V#) 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. rAr@z=[g4_4_common] ERROR: pinning.scene_index_list contains scene z? but shot_index_list_per_scene has no entry. NO silent default.r9z7[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.) setintrOstrrHrIrJrKr#rtype__name__add)rVoutshot_mapr'si_int raw_shotsr(s& r build_pinning_scene_setrks:!$C23H())RLLV-   V,I   !%&ZZ   HHQK)T** 84 ?++,A/ZZ   HHQK 8ZZ   HHQKC GGVSX& ';*> Jrc V^8dQhRRRR/#)rcp_rootrrr r )r s"r r r 3sdtrcVR, pVP4'g5\RV 2\PR7\P!^4VP RRR7;_uu_4p\ P!V4uuRRR4# +'giR#;i \d@p\RT 2\PR7\P!^4Rp?R#Rp?ii;i) zELoad `manifest.json` under cp_root. fail-fast on missing/parse error.z manifest.jsonz0[g4_4_common] ERROR: manifest.json not found at r9r;r<r=Nz0[g4_4_common] ERROR: manifest.json parse error: ) rGrHrIrJrKrLrMrNr/)rm manifest_pathrRr2s& r load_cp_manifestrp3so-M    ! ! >o      g  6 6"99R=7 6 6 6  >se D   s6B%0B B% B" B%"B%% C/04C**C/c V^8dQhRRRR/#)rr6rrrr )r s"r r r Hs#$rcXRp\VRR4'd_\VP4PRRR7;_uu_4p\P !V4pRRR4XP R4pV'g\VRR4pV'g2\R\PR7\P!^4\V4pVP4'g5\R V 2\PR7\P!^4V# +'giL;i) uhResolve cp_root from --config or --cp-root flag. Fail-fast on missing. Trap #1 — NO silent defaults. Nr8r;r<r=rmz;[g4_4_common] ERROR: --cp-root (or config.cp_root) requiredr9z*[g4_4_common] ERROR: --cp-root not found: ) rFrr8rLrMrNrOrHrIrJrKrG)r6 cp_root_strrRrSrms& r resolve_cp_rootrtHs #KtXt$$ $++  # #C' # : :b))B-C;ggi( dIt4  I   ;G >>   8 B   N%; :s D D) c$V^8dQhRRRRRR/#)rrgr r6rrrWr )r s"r r r ds& M MT M M Mrc VPR8XdK\P!V\PR^RR7\PP R4R #\ VP4pVPPRRR7VPRRR 7;_uu_4p\P!WR^RR7R R R 4R # +'giR #;i) z2Write JSON output to args.output ('-' for stdout).-FT) ensure_asciiindent sort_keys )parentsexist_okwr<r=N) outputrMdumprIstdoutwriterparentmkdirrL)rgr6out_pathrRs&& r emit_outputrds {{c #szza4P  $dT: ]]3] 1 1R IIcE!t L2 1 1 1s )C C )__doc__ __future__rrMrIpathlibrtypingr__file__resolver| _BACKEND_PATHrcpathinsertrr$r4rTr]rkrprtrr rr rs"# X&&(003i? }SXX%HHOOAs=)*>.GT@F F(V*8 Mr