i%&JUdZddlmZddlZddlmZmZmZehdZ de d<Gdd e Z dd Z ejd Zejd Zdd ZejdZddZehdZde d<eddhZde d<Gdde ZddddZy)u/D6 controlled vocab — bg_id regex + state_class enum + format helper + location space_profile validator. spec: docs/superpowers/specs/2026-05-09-deterministic-bg-id-and-catalog-lineage.md §4.1, §4.3, §4.4 plan: docs/superpowers/plans/2026-05-09-d6-deterministic-bg-id-and-catalog-lineage-implementation.md T1, T2-fix LLM 은 bg_id 를 만들 수 없음. master_plan post-processing 에서 코드가 부여. 두 정규식이 다른 step (raw vs assigned) 에 적용: - BG_ID_RE: code-assigned (`L09B01` uppercase) — strict. - LLM_INTENT_ID_RE: LLM raw intent (fp_id 등 lowercase snake) — strict. location.space_profile (entity_canon.metadata_json) 의 controlled vocab + 검증: - LOCATION_SPACE_KEY_VOCAB: allowed_space_keys 의 enum. - validate_location_space_profile: shape + enum 검증. fail-fast. ) annotationsN)AnyDict FrozenSet> busyquietnormalarrival busy_exit intrusion ransacked blood_scene clean_afterevidence_displaydream_or_vision_statezFrozenSet[str]STATE_CLASS_ENUMceZdZdZy)StateClassErroru?state_class 가 enum 밖 — fail-fast (nearest-match 안 함).N__name__ __module__ __qualname____doc__M/Users/manta/Documents/Projects/TheRoad-I1/backend/app/core/bg_state_vocab.pyrr)sIrrcR|tvrtd|dttdy)uRaise StateClassError if state_class is not in STATE_CLASS_ENUM. LLM prompt 에 enum 강제. 위반 시 master_plan retry. nearest-match 시도하면 drift 의 silent path 가 열리므로 fail-fast. z state_class z not in enum (size=uR). LLM prompt 의 enum 강제 violation 또는 nearest-match 시도 — fail-fast.N)rrlen) state_classs rvalidate_state_classr -sA **;/)mainyardofficestairskitchenrooftopexteriorLOCATION_SPACE_KEY_VOCAB single_space multi_spaceLOCATION_SPACE_KIND_VOCABceZdZdZy)SpaceProfileErroru>location.space_profile shape 또는 enum 위반 — fail-fast.Nrrrrr=r=sHrr=)r.c |rd|nd}t|ts#t|dt|j|j d}t|tst|d||j d}t|tst|d||j d}|t vr t|d|d tt |j d }t|tr|st|d ||Dcgc]}t|tr|}}|r5t|d |d |Dcgc]}t|jc}d|Dcgc] }|tvs |} }| r t|d| dtt|dk(r|dgk7rt|d||dk(r*|j d} | | |vrt|d| d||Scc}wcc}wcc}w)u`metadata_json.location.space_profile` shape 검증 + 정규화 dict 반환. spec §4.3: D6 의 SOT. master_plan 후처리 의 normalize_space_key 가 본 shape 에 의존. 누락/invalid 시 모든 bg_id 부여 fail → silent default '{}' 차단. invariants: - metadata_json: dict - metadata_json["location"]["space_profile"]: dict - kind: LOCATION_SPACE_KIND_VOCAB - allowed_space_keys: non-empty list, subset of LOCATION_SPACE_KEY_VOCAB - single_space → allowed_space_keys == ["main"] - multi_space → default_space_key in allowed_space_keys Returns: 검증 통과한 space_profile dict (호출자가 store/forward 가능). z location locationz metadata_json not a dict: z- metadata_json.location missing or not dict: space_profilez; metadata_json.location.space_profile missing or not dict: kindz space_profile.kind z not in allowed_space_keysz> space_profile.allowed_space_keys must be non-empty list, got zP space_profile.allowed_space_keys must contain only strings, got non-str items: z (types: )zJ space_profile.allowed_space_keys contains keys outside controlled vocab: z. vocab=r9r1z; single_space requires allowed_space_keys == ['main'], got r:default_space_keyzU multi_space requires default_space_key in allowed_space_keys, got default_space_key=z , allowed=) isinstancedictr=typergetr;sortedliststrr8) metadata_jsonr.where loc_blockprofilerBallowedk non_str_items invalid_keys default_keys rvalidate_location_space_profilerVs )1i| $jE mT *g0m1D1M1M0N O  !!*-I i &gB9- P  mmO,G gt $gPQXP[ \   ;;v D ,,g)$&AZ:[9\ ]  kk./G gt $GgST[S^ _  !(B1z!S/AQMBg""/!2)*78-QQ  -89 <  'Lw!!3K*KAwLLg!!-/456 8   ~'fX"5gPQXPY Z   }kk"56  +W"<#'))4z'L  N3C 9LsG(%G(<G-& G24G2)rrLreturnNone)r'r-r(r-rWrL)r.rLrWr-)rMrr.rLrWzDict[str, Any])r __future__rretypingrrr frozensetr__annotations__r&rr compileBG_ID_RELLM_INTENT_ID_REr)r+r0r8r;r=rVrrrras# ''$- . $. JjJ  & 2::+ , 2::56+02::m,2,56,.-6~}6U,V>VI ILNDr