feat(reverse-sync): Sidecar mapping lookup 모듈 및 유닛 테스트 추가#685
Merged
Conversation
jk-kim0
force-pushed
the
feat/sidecar-lookup-in-reverse-sync
branch
from
b81e9fb to
34aff15
Compare
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
## Description - `bin/reverse_sync/sidecar_lookup.py` 모듈 신규 추가 - `mapping.yaml` 파일 로드 (`load_sidecar_mapping`) - MDX block index → SidecarEntry 역인덱스 구축 (`build_mdx_to_sidecar_index`) - xhtml_xpath → BlockMapping 인덱스 구축 (`build_xpath_to_mapping`) - 2-hop 조회: MDX index → SidecarEntry → BlockMapping (`find_mapping_by_sidecar`) - XHTML + MDX로부터 mapping.yaml 생성 (`generate_sidecar_mapping`) - `tests/test_sidecar_lookup.py` 유닛 테스트 38개 추가 - 각 함수별 단위 테스트 + 실제 테스트 케이스 기반 통합 테스트 - 2-hop 조회 전체 경로 검증 ### Background #682에서 forward converter가 `var/<page_id>/mapping.yaml` sidecar 파일을 생성하도록 구현 완료. 이 모듈은 해당 sidecar 파일을 로드하고 인덱스를 구축하여, reverse-sync pipeline에서 O(1) 블록 매칭을 가능하게 하는 기반 모듈입니다. 실제 reverse-sync pipeline 적용은 후속 PR에서 진행합니다. ## Added/updated tests? - [x] Yes — 38개 유닛 테스트 추가 (240/240 전체 통과) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
jk-kim0
force-pushed
the
feat/sidecar-lookup-in-reverse-sync
branch
from
34aff15 to
83cb91d
Compare
jk-kim0
changed the title
2 tasks
jk-kim0
added a commit
that referenced
this pull request
Feb 12, 2026
## Summary
- `sidecar_lookup.py` 코드 리뷰에서 발견된 이슈 수정
- 미사용 코드 제거, 방어 코드 추가, 테스트 파일명 규칙 준수
## Changes
| 항목 | 변경 |
|---|---|
| `load_sidecar_mapping()` | 빈 YAML 파일 방어 (`yaml.safe_load() or {}`) |
| `generate_sidecar_mapping()` | 미사용 `SKIP_TYPES`, `NO_MDX_XPATHS` 제거 |
| `_count_child_mdx_blocks()` | 미사용 파라미터 4개 제거 |
| 테스트 파일 | `test_sidecar_lookup.py` →
`test_reverse_sync_sidecar_lookup.py` |
| 테스트 import | 미사용 `unittest.mock.patch` 제거 |
| 테스트 추가 | 빈 YAML 파일 edge case |
## Test plan
- [x] 241/241 pytest 통과
- [x] 기존 동작 변경 없음
## Related tickets & links
- #685 (원본 PR)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
jk-kim0
added a commit
that referenced
this pull request
Feb 12, 2026
## Description - `build_patches()`에 sidecar 직접 조회(O(1))를 primary 매칭으로 추가합니다. - Sidecar로 parent mapping을 찾은 후, child 해석을 통해 개별 자식 매핑으로 정확히 대응합니다. - Child 해석 실패 시 (list/table 블록 등) 기존 fuzzy matching으로 자연스럽게 fallback합니다. - `run_verify()`에서 `generate_sidecar_mapping()`으로 on-the-fly sidecar를 생성하여 `build_patches()`에 전달합니다. ### 매칭 흐름 1. Phase 1: Sidecar 직접 조회 → parent일 경우 child 해석 (4단계: 완전 일치, 공백 무시, 리스트 마커 제거) 2. Phase 2: Fuzzy matching fallback (`find_mapping_by_text()`) 3. Phase 3: Sub-block 분리 매칭 (list item, table row, containing mapping) ### 기존 동작과의 호환성 - `mdx_to_sidecar`, `xpath_to_mapping` 파라미터는 Optional (None이면 기존 fuzzy matching만 사용) - 기존 `build_patches()` 호출부는 변경 없이 동작 ## Related tickets & links - #685, #687 (sidecar_lookup.py 모듈) ## Added/updated tests? - [x] No, and this is why: 기존 241개 pytest + 16개 reverse-sync 통합 테스트가 모두 통과하여 회귀 없음 확인 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
3 tasks
jk-kim0
added a commit
that referenced
this pull request
Feb 12, 2026
## Summary
- `block_matcher.py` 삭제 (138줄) — `find_mapping_by_text()`,
`find_containing_mapping()` 제거
- `build_patches()` 매칭을 3단계(sidecar → fuzzy → sub-block)에서 **1단계(sidecar
O(1) 조회)** 로 간소화
- Child 해석 실패 시 fuzzy fallback 대신 **parent mapping을 containing block으로
직접 사용**
- `build_list_item_patches()`, `build_table_row_patches()`도 sidecar 기반으로
전환
### 매칭 흐름 (변경 후)
```
BlockChange(index=N)
→ Sidecar 직접 조회 (O(1))
→ children 있으면: child 해석 시도 (collapse_ws → 공백무시 → 리스트마커제거)
→ 성공: child xpath로 patch
→ 실패: parent를 containing block으로 사용
→ children 없으면: 직접 patch
→ Sidecar에 없으면:
→ list 블록: build_list_item_patches (sidecar parent → child 해석)
→ markdown table: build_table_row_patches (sidecar parent → containing)
→ 그 외: skip
```
### 변경 파일
| 파일 | 변경 |
|------|------|
| `patch_builder.py` | signature 필수화, 메인 루프 재작성, sub-함수 sidecar 전환 |
| `block_matcher.py` | **삭제** (-138줄) |
| `test_reverse_sync_cli.py` | fuzzy 테스트 2개 삭제, sidecar 파라미터 추가, **신규 5개
테스트** |
| `test_reverse_sync_e2e.py` | sidecar 생성 추가 |
### 전체 LOC 변화
- 삭제: 244줄 (block_matcher.py + fuzzy 분기 + fuzzy 테스트)
- 추가: 362줄 (sidecar 분기 + 유닛 테스트 5개)
- 순 증가: +118줄 (테스트 247줄 포함, 프로덕션 코드는 -129줄)
## Test plan
- [x] 244/244 pytest 통과
- [x] 신규 유닛 테스트 5개: child 해석 성공/실패, unmapped skip, list item 매칭/fallback
- [x] reverse-sync batch verify: 139/148 pass (4 fail은 기존 띄어쓰기 전이 이슈, 별도
대응 예정)
## Related
- #685 sidecar_lookup.py 모듈
- #687 sidecar_lookup.py 코드 리뷰 반영
🤖 Generated with [Claude Code](https://claude.com/claude-code)
---------
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
bin/reverse_sync/sidecar_lookup.py모듈 신규 추가 — mapping.yaml 로드, 인덱스 구축, 2-hop 조회tests/test_sidecar_lookup.py유닛 테스트 38개 추가Background
#682에서 forward converter가
var/<page_id>/mapping.yamlsidecar 파일을 생성하도록 구현 완료.이 모듈은 해당 sidecar 파일을 로드하고 인덱스를 구축하여,
reverse-sync pipeline에서 기존 7단계 fuzzy text matching을 O(1) 직접 조회로 교체할 수 있는 기반 모듈입니다.
이 PR의 범위
sidecar_lookup.py모듈 + 유닛 테스트만reverse_sync_cli.py,patch_builder.py)에 실제 적용은 후속 PR에서 진행주요 함수
load_sidecar_mapping()List[SidecarEntry]build_mdx_to_sidecar_index()build_xpath_to_mapping()find_mapping_by_sidecar()generate_sidecar_mapping()Test plan
Related tickets & links
🤖 Generated with Claude Code