Skip to content

refactor(reverse-sync): Sidecar 전용 매칭으로 전환 — fuzzy matching 제거#688

Merged
jk-kim0 merged 5 commits intomainfrom
feat/sidecar-pipeline-integration
Feb 12, 2026
Merged

refactor(reverse-sync): Sidecar 전용 매칭으로 전환 — fuzzy matching 제거#688
jk-kim0 merged 5 commits intomainfrom
feat/sidecar-pipeline-integration

Conversation

@jk-kim0
Copy link
Contributor

@jk-kim0 jk-kim0 commented 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

  • 244/244 pytest 통과
  • 신규 유닛 테스트 5개: child 해석 성공/실패, unmapped skip, list item 매칭/fallback
  • reverse-sync batch verify: 139/148 pass (4 fail은 기존 띄어쓰기 전이 이슈, 별도 대응 예정)

Related

🤖 Generated with Claude Code

## 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>
@vercel
Copy link

vercel bot commented Feb 12, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
querypie-docs Ready Ready Preview, Comment Feb 12, 2026 4:17pm

Request Review

block_matcher.py(138줄) 삭제 — find_mapping_by_text, find_containing_mapping 제거.
build_patches()의 3단계 매칭(sidecar → fuzzy → sub-block)을
1단계(sidecar O(1) 조회 + child 해석 + containing fallback)으로 간소화.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
child 해석 성공/실패, unmapped block skip, list item sidecar 매칭 등
리팩토링으로 추가된 5개 분기 경로에 대한 테스트 커버리지 확보.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@jk-kim0 jk-kim0 changed the title feat(reverse-sync): Sidecar mapping을 reverse-sync pipeline에 적용 refactor(reverse-sync): Sidecar 전용 매칭으로 전환 — fuzzy matching 제거 Feb 12, 2026
fuzzy matching 제거 후 변경된 패치 결과에 맞추어
expected.reverse-sync.* golden file 5개를 재생성.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…결과로 갱신

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@jk-kim0 jk-kim0 merged commit a845e7f into main Feb 12, 2026
6 of 7 checks passed
@jk-kim0 jk-kim0 deleted the feat/sidecar-pipeline-integration branch February 12, 2026 16:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant