Oj+:dZddlmZddlZddlmZmZmZmZm Z m Z ddl m Z dZe jZGddeZdd Z dd Zdd ZGd d eZddZddZddZddZdZ ddZdZdZd dZ d!dZ d dZ! d"dZ"y)#u5중앙 조사 결과 → **이 샷의 sidecar**. ★고르지도 판정하지도 않는다. ## 무엇을 하나 Codex D-inert 3/3 (2026-09-01) — 「중앙 결과 → `members_from_rows` → `write_sidecar`」. 중앙 조사 CP 이 에피소드에서 **무엇을 구했나** 이 샷의 visible 그 중 **이 컷에 보이는 것** → sidecar 그 컷에 붙을 멤버들과 요구 ★★**sidecar 가 없으면 조립은 한 글자도 안 바뀐다** — 그것이 이 설계의 문이다 (`grounding_reference_bundle.attach_from_rpc` 가 멤버 키가 없으면 0 을 낸다). 그래서 중앙 CP 가 없거나 이 컷에 해당 멤버가 없으면 **아무것도 안 적는다**. ## 어느 멤버가 이 컷의 것인가 멤버는 **덮는 의무 목록**(`covers`)을 갖는다. 부모 장소 맥락 한 장이 형제 `LP01`·`LP02` 의 의무를 함께 덮을 수 있다. 그래서 — 이 컷의 visible 신원 중 하나라도 그 멤버의 `covers` 에 있으면 → 이 컷 것 ★이름으로 안 고른다. **정본 ID 로만** 본다. ) annotationsN)AnyCallableDictListOptionalSequence)grounding_entity_contractz2.202609020800ceZdZdZy)SidecarWriterErroruLsidecar 를 못 만든다. ★조용히 빈손으로 지나가지 않는다.N__name__ __module__ __qualname____doc__c/Users/manta/Documents/Projects/TheRoad-I1/backend/app/modules/pipeline/grounding_sidecar_writer.pyr r )sVrr cg}|xsdD]g}t|tr2t|jdxs|jdxsd}nt|xsd}|sW|j |it t |S)uW이 컷이 보는 **정본 ID** 들. ★모양 둘을 다 받는다(dict · 문자열).rshort_idid) isinstancedictstrgetappendsortedset)visible_entitiesoutegots rvisible_final_idsr$-st C  # # a aeeJ'<155;<"=Cag2,C  JJsO $ #c( rc Pddlm}|xsijdxsijd}|sgS|j|||}t t |}|sgS|Dcgc]8}|t |jdxsdzrt j|:c}Scc}w)u중앙 CP + 이 컷의 visible → **이 컷의 멤버들**. 없으면 빈 목록. ★못 구한 의무도 **남긴다** — 이미지 요구는 안 되지만 「무엇이 없었나」가 기록에 있어야 나중 UI 가 고칠 수 있다. rgrounding_bundle_projectiondatarowscontent_sha_of coordinate_ofcoversr)app.modules.pipeliner'rmembers_from_rowsrr$copydeepcopy) central_cpr r+r,bpr)everyseenms rmembers_for_shotr7:sG  2 " "6 * 0b 5 5f =D   n/< ! >E  !12 3D  &+ 2ec!%%//R00 MM! e 22 2s#=B#c6ddlm}|j|dy)u켠 판에서 중앙 조사 CP 가 **온전한가**. ★공개 끝점 — 아니면 선다. ★판정은 `grounding_central_acquisition` 한 곳이 한다 — 여기서 같은 규칙을 다시 적으면 두 벌이 된다. r)grounding_central_acquisitionT)requiredN)r.r9acquisition_projection)r2cas rassert_central_checkpointr=Rs Ij48rceZdZdZy)ReferenceCoordinateConflictuV한 줄에 적힌 두 좌표(`chosen.path` · `acquisition.chosen_path`)가 다르다.Nr rrrr?r?]s`rr?c.|jdxsi}t|jdxsijdxsd}t|jdxsd}|r*|r(||k7r#t|jdd|d|d |xs|S) uV고른 사진의 **하나의** 상대 경로. ★두 저장 위치를 대조한다 (Codex BLOCK 2026-09-02). CP 의 selected 줄에는 `acquisition.chosen.path` 와 `acquisition.chosen_path` 가 **둘 다** 있다(실측 · 값이 같다). 한쪽만 정본으로 택해 다른 쪽을 무시하면 둘이 갈린 날 그 차이를 아무도 못 본다. 둘 다 있으면 **같아야** 하고, 다르면 붙이기·판정 전에 선다. 한쪽만 있으면 그것을 쓴다. 둘 다 없으면 "" — selected 줄이면 `_selected` 가 「내용 해시가 없다」로 선다. acquisitionchosenpathr chosen_pathresearch_subject_idu) 의 좌표가 갈린다 — chosen.path=u · chosen_path=u8. 어느 파일을 붙일지 모르는 채 안 붙인다)rrr?)rowacqabs rresolved_reference_pathrJas ''- &BC cggh%2 * *6 2 9r:A CGGM " (b)AQ16)ww,-00YZ[Y^_U"Z \] ] 6Mrct|S)N)rJ)rFs r_chosen_rel_pathrLts "3 ''rcXddl}ddlm}t|}|sy|||z }|j sy|j }t |d5tfddD]}|j| ddd|jS#1swY|jSxYw)u고른 사진의 **내용 해시** — 대조를 지난 resolved path 의 파일 bytes 로 센다. ★한 곳. ★★★실측 (2026-09-02 1단계 live · attempt aec5ce986c4c · 유료 30): production `detail_steps` 가 `chosen.content_sha256` 칸을 읽었는데 `reference_acquisition` CP 의 chosen 에는 그 칸이 **없다**(caption·index·path·source_website_url·url). 그래서 7샷 전부 「selected 인데 내용 해시가 없다」로 실패했다. 사람 판정 (`grounding_fidelity_review`)과 canary probe 는 파일 bytes 로 셌기에 통과했고 — 그것이 「도구가 production 과 다른 입력으로 쟀다」는 결함이다. 이제 셋이 이 함수 하나를 쓴다. 파일이 없으면 "" — 붙이지 않는다. rNPathrrbc&jdS)Ni)read)fsrz$row_content_sha256..s !&&/rr) hashlibpathlibrOrLis_filesha256openiterupdate hexdigest) rFrootrUrOrelphchunkrSs @rrow_content_sha256rbxs 3 C  T SA 99;A a!137E HHUO8  ;;=  ;;=s &BB)c~ddlm}ddlm}t |}|j |rt |||z dSddS)u^고른 사진의 **좌표** — 조립(`attach_from_rpc`)이 이것으로 bytes 를 읽는다.rrNgrounding_reference_bundler)sourcerC)rVrOr.rerL SOURCE_FILEr)rFr]rOrPr^s rrow_file_coordinaterhs:E 3 Cnnsc$t*s2B.C SSPR SSrcRddlm}ddlm}||jj S)u_`chosen.path` 는 `projects//...` 상대 경로 — 그 기준은 projects_dir 의 부모.rrN)settings)rVrOapp.core.configrj projects_dirparent)rOrjs rdefault_reference_rootrns( %% & - --rcddlm}t||||}|t||||z}|syt |j ||S)u1이 컷의 sidecar 를 RPC 에 **원자적으로** 적는다. Returns: 적은 **요구 수**. 0 이면 RPC 는 **한 글자도 안 바뀐다**. ★멤버와 요구를 한 함수(`write_sidecar`)가 같이 적는다 — 두 벌로 만들면 그 둘이 어긋난 채로 굳는다. rrdr*)r.rer7outlook_members_for_shotlen write_sidecar)rpcr2r r+r,rPmemberss rwrite_for_shotrus[Fz+;.<-:40 110sAc|t|Dcgc]}|t|vs|}}|rtd|dycc}w)uR쓸 역할이 **전부 선언돼 있나**. ★아니면 provider 앞에서 선다.u선언 안 된 역할 u. — `REF_ROLE_VALUES` 는 닫힌 목록이다N)rrr )rsknownrmissings rassert_roles_declaredrsQ#3-?-Q1CJ+>q-G? $WI-[ \^ ^@s99)r Sequence[Any]return List[str]) r2Optional[Dict[str, Any]]r rr+Callable[[Dict[str, Any]], str]r,*Callable[[Dict[str, Any]], Dict[str, Any]]rList[Dict[str, Any]])r2rrNone)rFDict[str, Any]rr)rFrrr) rsrr2rr rr+rr,rrint)rsrrr) r2rrsrr+rr,rrr)rsrrz Sequence[str]rr)#r __future__rr0typingrrrrrr r.r _gcSIDECAR_WRITER_CONTRACT_VERSIONENFORCE_BY_OUTLOOK_ATTACHMENT ENFORCES_GATE RuntimeErrorr r$r7r=r?rJrLrbrhrnrurzr{rrprrrrrrs)0# @@A#311 WW 2'42%D2%O2/ 209a,a&(6T./7/%2/$C/#M /  />-(2%"0%-L%-E% #7 %(2^!.^37^r