Oj,UdZddlmZddlmZmZmZmZmZm Z ddl m Z m Z dZ dZddd d d Zd ed <GddeZGddeZddZddZddZ ddZddZy)uU`location_part` 를 받는 sync 계약 — **순수 helper**. ★inert. 유료 0. ## 왜 순수 helper 로 먼저인가 (Codex 2026-08-31) > 「기존 query 목록을 지금 무조건 넓히면 **inert 가 아니다**.」 `EntitySyncService` 의 목록을 그냥 늘리면 **legacy CP 에서도 동작이 바뀐다**. 그래서 — ①**표식이 있을 때만** 새 길로 간다 (`is_chunk_marked`) ②legacy CP 는 **옛 길 그대로** — byte·DB 효과가 같다 ③새 길의 셈은 여기 **순수 함수**로 두고 시험으로 잠근다 ## 고치는 결함 둘 (실측) ★번호 매기기 — `short_id[0]` + `int(short_id[1:])` 라 `LP01` 이 **조용히 건너뛰어진다**. `L` counter 가 작아져 **있는 번호를 다시 발급** 할 수 있다. 오류도 안 난다. ★canon 재사용 열쇠 — 이름 단독이면 `location` 과 `location_part` 의 **같은 이름**이 조용히 충돌한다. 그리고 정본 ID 가 있는데 이름이 바뀌면 **중복이 난다**. ## 아직 안 쓰인다 `app/` 어디서도 부르지 않는다. ) annotations)AnyDictListOptionalSequenceTuple) OWNER_PREFIXsplit_final_idgrounding_v2_chunk_schema1 characters locationspropslocation_parts) characterlocationprop location_partzDict[str, str]CHUNK_OWNER_KEYSceZdZdZy)SyncKeyConflictuY두 열쇠가 **서로 다른** canon 을 가리킨다. ★임의로 고르지 않는다.N__name__ __module__ __qualname____doc__d/Users/manta/Documents/Projects/TheRoad-I1/backend/app/modules/pipeline/grounding_entity_sync_ext.pyrr.scrrceZdZdZy)UnknownChunkSchemau{표식은 **있는데** 모르는 판이다. ★조용히 옛 길로 안 간다. ★★★앞 판은 모르는 판을 legacy 로 떨어뜨렸다(내가 그걸 **의도로 시험에 적기까지 했다**). 그러면 새 CP 인데 `location_part` 가 **조용히 버려진다** — 오류도 안 나고 행만 사라진다 (Codex 재현 2026-08-31). ★가르는 자리는 **표식이 있느냐**다: 없다 → legacy. 옛 CP 라 옛 길이 맞다 있고 아는 판 → 새 길 있는데 모르는 판 → **선다**. 「무엇인지 모르는 것」을 옛 것으로 읽지 않는다 Nrrrr r"r"2s rr"c t|tsyt|vryt|j txsd}|t k7rt dtd|dt dy)u이 체크포인트가 **새 모양**인가. 표식이 없다 → `False` (legacy 길, 옛 동작 무변) 아는 판이다 → `True` ★모르는 판이다 → **`UnknownChunkSchema` 로 선다** ★모르는 판을 legacy 로 떨어뜨리면 새 CP 의 `location_part` 가 **조용히 버려진다**. 오류도 안 나고 행만 사라진다. F`u` 가 u 인데 아는 판은 ua 뿐이다 — 모르는 것을 옛 것으로 읽지 않는다. 사람이 보고 정해야 한다T) isinstancedictCHUNK_SCHEMA_MARKERstrgetCHUNK_SCHEMA_VERSIONr")cpgots r is_chunk_markedr.@sr b$ "$ bff()/R 0C "" #$F3'1G#&'; ;< < rctjDcic]}|d}}|D]J}tt|xsd}||\}}t|}t |j |d|||<L|Scc}w)u갈래별 **가장 큰 번호**. ★`owner_of_final_id` 와 **한 계약**을 쓴다. ★★옛 셈(`short_id[0]` + `int(short_id[1:])`)은 `LP01` 을 조용히 건너뛰어 `L` counter 를 작게 만들었다 — **있는 번호를 다시 발급**할 수 있다. Returns: `{접두: 최대번호}`. ★못 푸는 것은 **세지 않는다**(옛 것과 같다). rr$)r valuesr r)maxr*) short_idspoutsidr-ownernpres r seed_countersr9Ws*6)<)<)>?)>A1a4)>C?S^, ; q5!swwsA*C  J@s A4ctj|}|td|dttt |j|ddz}|||<||dS)uT다음 `short_id`. ★접두는 **계약**에서 온다 — 손으로 안 적는다.u모르는 갈래 u — r02d)r r*KeyErrorsortedint)countersr6r8r7s r next_short_idrAksi   5 !C {*5)5 9M8NOPP HLLa !A%AHSMU1S'?rc t|xsd}|r|j|}||S|jt|t|f}|g}nt|ttfs|g}|r|j Dchc] }t |} }|D cgc] } t| ddrt | | vs| "} } t| dk(r| dSt| dkDr!td|d|dt| d |d yt|dk(r|dSt|dkDrtd |d|d t|d ycc}wcc} w)uCP 의 한 줄이 DB 의 어느 canon 인가 — **short_id 가 정본** (Codex 계약 2026-09-03 06:55 · 실측 f7cc45c576c0). - incoming short_id 가 기존 행의 short_id 와 같으면 그 행(갱신). - incoming short_id 가 있는데 맞는 행이 없으면 **None(새 행)** — 이름이 같아도 **다른 short_id 를 가진 행은 남의 것**이다. 동명·동타입·서로 다른 short_id 는 합법(실측: 「흙바닥」 LP05→L03 · LP07→L02). 단, 이름이 같은 행 중 short_id 가 NULL 인 것이 **정확히 하나**면 그것을 이어받는다(legacy migration 후보). - incoming short_id 가 없으면(legacy CP) (type, name) 후보가 정확히 하나일 때만 그 행. 둘 이상이면 fail-closed — dict 로 하나를 고르지 않는다. `by_type_name` 값은 행 하나 또는 행 목록(동명 후보 전부)이어도 된다. r$Nshort_idr;rz`(z, u!)` 에 short_id 없는 canon 이 u개 — 어느 것을 u% 로 이을지 모른다(fail-closed)u legacy 줄 `(u)` 에 canon 후보가 u5개 — 이름만으로는 못 가른다(fail-closed)) r)r*r&listtupler0idgetattrlen ValueError) rC entity_typename by_short_id by_type_namer5acandsv_takencfrees r resolve_canonrTusz hn" C OOC  =H   c+.D : ;E } e} - "-!3!3!56!5A"Q%!56 ]5a:t(DAV\I\5] t9>7N t9q=[MD6)J3t9+UklokpqVWX X 5zQQx 5zA~K=4&0GE |TI JK K 7]s>EE) E7Ec0gd}t|s|S|dgzS)u이 CP 에서 읽을 **갈래 키들**. ★표식이 없으면 **옛 셋 그대로**. ★이것이 「무조건 넓히지 않는다」의 자리다 — legacy CP 는 `location_parts` 를 **아예 안 본다**. )rrrr)r.)r,legacys r owner_keysrWs% 2F 2  %& &&rN)r,rreturnbool)r2z Sequence[str]rXDict[str, int])r@rZr6r)rXr)) rCr)rJr)rKr)rLzDict[str, Any]rMzDict[Tuple[str, str], Any]rXz Optional[Any])r,rrXz List[str])r __future__rtypingrrrrrr .app.modules.pipeline.grounding_entity_contractr r r(r+r__annotations__ RuntimeErrorrr"r.r9rArTrWrrr r`s4#==L2;%$. dld  .('-' :'?L'R 'r