Oj>6UdZddlmZddlZddlZddlmZmZmZeje Z dZ dZ ddd d dZd Zd Zd Zd Zd ZeeeefZded<eefZded<dZdZdZeeefZded<dZd!dZd"dZd#dZd#dZd$dZ dZ!dZ"Gdde#Z$d%dZ%d&dZ&y)'ur★참조 획득 — **엔티티마다 참고 사진을 찾아 온다.** GROUNDING-V2 §2-4. 사용자 설계(2026-08-30): 이미지 모델이 만들기 어려운 것은 한 번만 나와도 엔티티에 등록하고, 그 엔티티는 **검색 → 이미지 검색**을 탄다. 사전 검색은 판정이 아니라 **「무엇을 찾을지」 자료를 모으는 것**이다. VLM 은 **「우리가 찾던 종류가 맞나」만** 본다. 없으면 좁혀서 한 번 더. ★★**새로 만드는 것이 아니다.** 검색·안전 다운로드·선택 primitive 는 `search_grounded_ref` 에 이미 있고 지금은 **야외 구조물(21.915)** 만 쓴다. 이 모듈은 그 **호출 소유권을 앞으로 옮긴다** — primitive 를 복사하지 않는다. 호출자는 딱 하나여야 한다. 앞뒤 두 곳이 각각 사면 같은 것을 두 번 산다. ) annotationsN)AnyDictOptionalreference_acquisition)coarse_version ref_versionc8ddlm}ddlm}ddlm}t j }|jttj|jd|xs |j}|j|j|jfD]}}||jk(rdnd} ||j|| |} |jt| xsij!d xsd jd |jd|j|j%|xs |j&j|jdt)|t*usd |cxkr|j,ksnt/d|j,d|d|} |j| d|j0d| |j0zj|j3ddS#t"$r|jd YwxYw)u7★★**참조 신원을 지배하는 것 전부**의 해시. 한 곳에서만 만든다. 왜 한 곳인가 — 앞쪽 스텝과 `image_steps` 가 **각각 산식을 적으면** 한쪽만 고쳐진다. 그러면 팩을 바꿔도 바깥 이미지 스텝이 stale 이 안 돼 **옛 참조가 영구 봉인**된다(`image_steps` 주석에 그 사고가 적혀 있다). 접는 것: - **거친 종류 선택 팩** — 지문·스키마·좁힘 문안. 무엇을 고르는지를 지배한다 - **검색·다운로드 계약** — `search_grounded_ref` 의 brief/질의 저작 팩 - **라운드 계약** — 라운드 수·라운드당 후보 상한. 바뀌면 다른 실험이다 - **계약 버전** — 이 모듈이 무엇을 뜻하는지 ★안 접는 것: **어느 엔티티가 이 길을 타는가**(`generation_difficulty`). 그것은 대상 집합을 정할 뿐 **한 대상의 참조 산출에 기여하지 않는다** — 접으면 다른 대상의 난이도가 바뀌었다고 이미 뽑아 둔 참조가 무효가 된다. r)coarse_type_pick)search_grounded_ref)resolve_effectiveschemaprompt)kindversioncontentzutf-8rurounds 는 1..u) 의 **정수**여야 한다 (받은 값 ):N)app.modules.pipeliner r app.modules.prompt_loaderrhashlibsha256updatestrACQUISITION_CONTRACT_VERSIONencodePROMPT_PACK_VERSION SYSTEM_STEM SCHEMA_STEM NARROW_STEM PROMPT_MODULEgetFileNotFoundErrorsearch_contract_shaREF_PACK_VERSIONtypeint MAX_ROUNDS ValueError PER_ROUND_CAP hexdigest) r r roundsctpsgrrhcvstemrgotns `/Users/manta/Documents/Projects/TheRoad-I1/backend/app/modules/pipeline/reference_acquisition.pyacquisition_contract_shar:s(=?;AHHS- . 5 5 78HHW  2322B#//3??C 3??2x #C$5$5t)-r;C HHS#)39r:AA'J K !D&HHS $ $+s++--3VX7HHW F|3a6&CS^^&CS^^,-!*A '( ( AHHs!C%%&aC%%%&((.2 ;;=" =!  HHSM s.AG;;HHselectedno_match_after_retry retryableTreference_unavailabletupleKNOWN_RAW_STATUSESTERMINAL_RAW_STATUSES unverifiedverifiedrejectedKNOWN_FIDELITYz1.202609020700ct|xsijdxsijdxsd}|tvr|StS)u이 줄의 **고증 축**. ★없으면 `unverified` — 기본이 「아직 아니다」다. ★모르는 값은 `unverified` 로 접는다. 「모르는 것」이 통과가 되면 안 된다. grounding_fidelitystater)rr'rEFIDELITY_UNVERIFIEDrowr7s r9 fidelity_ofrLsD  r34:??HNB OC'3@-@@rct|xsijdxsd}|s+tt|xsijdxsd}|tk(S)u하류가 **참조로 써도 되나**. ★HITL 0 — 자동 선택(`outcome == selected`) **하나**면 된다. (아래 옛 문단은 2026-09-02 의 「두 축」 계약 기록이다 — 2026-09-03 사용자 재지시로 뒤집혔다.) ★★★`selected` 만 보면 안 된다 (Codex BLOCK 2026-09-02): 그것은 coarse 심판이 「그 종류의 사진」이라고 한 것일 뿐이다. 고증이 확인되지 않은 것을 참조로 붙이면, 사람이 못 본 사진이 그림의 근거가 된다. ★확인이 안 됐다고 **파이프라인을 막지 않는다** — 참조 **없이** 내려간다 (`reference_unavailable` 과 같은 대접). HITL 0 이 이 판의 계약이다. ★어느 칸을 보나: 소비자가 보는 것은 **접은 값**(`outcome`)이다. 그것이 없는 줄이면 raw `status` 를 접어서 본다 — 두 벌로 적지 않는다. (실측 2026-09-02: sidecar 투영 줄은 `outcome` 만 들고 있어 `status` 만 보던 판이 **verified 인 줄까지 안 붙였다**.) outcomerstatus)rr'acquisition_outcomeSTATUS_SELECTEDrJs r9usable_as_referencerRsQ sybooi(.B /C !#sybooh&?&E2"FG / !!rc$t|tvS)uK그 줄이 **끝났나**. ★「없다」와 「못 봤다」를 가른다.)rrArOs r9 is_terminalrUs v;/ //rcy)u/이 대상을 하류가 **막아야 하는가** — ★**아니다**. ★사람 대기를 만들지 않는다 (사용자 확정 2026-08-31). 못 구한 것은 `reference_unavailable` 로 남기고 **참조 없이 자동으로** 내려간다. ★★이 함수는 **늘 False** 다. 남겨 두는 까닭은 호출부가 이미 이것을 묻고 있고, 지우면 그 자리들이 각자 판단하게 되기 때문이다. 「막을지」를 묻는 자리는 여기 하나여야 나중에 정책이 또 바뀌어도 한 곳만 고친다. FrTs r9downstream_blockedrXs rc,|tk(rtStS)u하류에 넘길 **처지**. ★사람이 볼 상태를 production 에 안 만든다. selected 참조를 쓴다 reference_unavailable 참조 없이 간다 (못 구했다 · 다 못 봤다) ★`no_match_after_retry` 와 `retryable` 을 **둘 다** unavailable 로 접는다. 둘의 차이는 **기록에 그대로 남지만**, 하류는 어느 쪽이든 참조 없이 간다. )rQSTATUS_UNAVAILABLErTs r9rPrPs &8O%#%r outdoor_structure_form_referenceceZdZdZy)FrontCheckpointMissingud사는 모드인데 중앙 CP 가 없다 — 의존이 안 돈 것이지 legacy 주행이 아니다.N)__name__ __module__ __qualname____doc__rWrr9r]r]snrr]cXddlm}||r|std|dtStS)u\이 주행에서 **누가 참조를 사는가**. ★★앞뒤가 각각 사면 **같은 것을 두 번 산다.** 그래서 소유자를 한 곳으로 못박고, 소유자가 아닌 자리는 **네트워크를 0회** 쓴다. 이관 중에는 갈래가 둘이다 (Codex): - v2 이고 **앞쪽 산출이 있으면** → 앞쪽이 소유자. 야외 스텝은 그것을 **읽어서 기존 CP 모양으로 투영만** 한다 - 그 밖에는 야외 스텝이 그대로 산다 (**명시적 legacy fallback**). ★이 fallback 이 남아 있는 동안은 「이관 완료」라고 쓰지 않는다 ★`front_checkpoint_exists` 를 **명시로 받는다.** 「v2 면 앞쪽이 있겠지」로 유추하면, 앞쪽이 아직 안 돈 주행에서 야외가 조용히 아무것도 못 사고 순수 T2I 로 내려간다. r)buys_referencezgrounding_mode=u 는 중앙(reference_acquisition)이 참조를 사는 모드인데 앞쪽 CP 가 없다 — 의존 스텝이 안 돌았다. 야외 스텝은 legacy 로 사지 않는다(이중 구매 금지))app.core.grounding_modercr] OWNER_FRONT OWNER_OUTDOOR)modefront_checkpoint_existsrcs r9acquisition_ownerrisD(7d&)!$*uuv v rc>||k7rddlm}|dd|d|ddy ) u소유자가 아닌 자리에서 사려 하면 **선다**. ★조용히 지나가면 이중 구매가 되고, 그건 「몇 번 샀나」를 통째로 거짓말로 만든다. 늦게 죽는 것보다 여기서 드러나는 편이 낫다. r)AppErrorz#reference_acquisition.not_the_owneru"이 주행의 참조 소유자는 u 인데 uK 가 사려 한다 — 앞뒤가 각각 사면 같은 것을 두 번 산다i)codemessage status_codeN)app.core.errorsrk)ownerwhererks r9assert_not_buyingrrs@  ~,69%(5)T^^   r)r Optional[str]r rsr1r,returnr)rKDict[str, Any]rtr)rKrurtbool)rOrrtrv)rOrrtr)rgrrhrvrtr)rprrqrrtNone)'ra __future__rrloggingtypingrrr getLoggerr^loggerr STEP_NAMEr:rQSTATUS_NO_MATCHSTATUS_RETRYABLEALLOW_MISSING_REFERENCErZr@__annotations__rArIFIDELITY_VERIFIEDFIDELITY_REJECTEDrEFIDELITY_CONTRACT_VERSIONrLrRrUrXrPrerf RuntimeErrorr]rirrrWrr9rs(#&&   8 $  # AE:>G*7G%(G-0GV($- -o-/ACEC!0AuA#,.?*,,-A":0  %"& 2 o\oD r