fix(reverse-sync): sidecar_lookup.py 코드 리뷰 반영#687
Merged
Conversation
## Description
- `load_sidecar_mapping()`: 빈 YAML 파일에 대한 방어 코드 추가 (`or {}`)
- `generate_sidecar_mapping()`: 미사용 변수 `SKIP_TYPES`, `NO_MDX_XPATHS` 제거
- `_count_child_mdx_blocks()`: 미사용 파라미터 4개 제거 (`xhtml_mappings`, `child_ids`, `mdx_blocks`, `normalize_mdx_to_plain`)
- 테스트 파일명을 `test_reverse_sync_sidecar_lookup.py`로 변경 (기존 네이밍 규칙 준수)
- 미사용 import `from unittest.mock import patch` 제거
- 빈 YAML 파일 edge case 테스트 추가
## Added/updated tests?
- [x] Yes — 빈 YAML 파일 테스트 1개 추가 (241/241 전체 통과)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
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
sidecar_lookup.py코드 리뷰에서 발견된 이슈 수정Changes
load_sidecar_mapping()yaml.safe_load() or {})generate_sidecar_mapping()SKIP_TYPES,NO_MDX_XPATHS제거_count_child_mdx_blocks()test_sidecar_lookup.py→test_reverse_sync_sidecar_lookup.pyunittest.mock.patch제거Test plan
Related tickets & links
🤖 Generated with Claude Code