fix(reverse_sync): roundtrip verifier 정규화를 추가합니다

[jk-kim0]

Description

bin/reverse-sync verify --branch=split/ko-proofread-20260221-administrator-manual-general 실행 시 발생하는 verify diff의 원인을 조사하고, roundtrip verifier에 누락된 정규화를 추가합니다.

목표

verifier 정규화를 정비하여, MDX 교정이 실질적으로 Confluence XHTML 수정으로 이어지는지 검증 가능하게 합니다.

불일치 현상 및 원인

현재 브랜치에서 정규화를 전부 비활성화하면 45건 중 8건 FAIL (총 diff 23줄)이 발생합니다.

#	패턴	diff 줄	파일 수	원인	적용 정규화
1	테이블 셀 패딩	10	1	FC의 컬럼 폭 계산과 improved.mdx의 수동 패딩이 다름 (maintenance.mdx)	_normalize_table_cell_padding (기존)
2	리스트 항목 선행 이중 공백 (* → * )	4	2	FC가 XHTML NavigableString의 선행 공백을 보존하여 * text 출력 (api-token.mdx, custom-attribute.mdx)	_normalize_consecutive_spaces_in_text (기존)
3	<br/> 앞 공백 (.<br/> ↔ . <br/>)	6	2	FC의 인라인 요소 결합 시 <br/> 앞뒤 공백 처리 차이 (integrating-with-event-callback.mdx, setting-up-multi-factor-authentication.mdx)	_normalize_br_space (기존)
4	빈 <li> 번호 (12.)	1	1	FC가 이미지만 포함된 <li>를 번호만 있는 항목으로 출력하지만, improved.mdx에서는 제거됨 (integrating-with-email.mdx)	_normalize_empty_list_items (기존, 이 PR에서 정규식 개선)
5	trailing 빈 줄	2	2	FC 블록 사이 빈 줄 수 차이, 또는 empty list item 제거 후 남은 빈 줄 (identity-providers.mdx, user-management.mdx)	_normalize_consecutive_blank_lines (이 PR에서 신규 추가), _normalize_blank_line_after_br (이 PR에서 신규 추가)

변경 내용

roundtrip_verifier.py:

• _normalize_empty_list_items: 빈 줄 치환(^([ \t]+)\d+\.\s*$ → '') → 줄째 제거(^[ \t]+\d+\.\s*\n → '')로 개선 — 기존 정규식은 빈 줄을 남겨서 연속 빈 줄 문제를 유발
• _normalize_consecutive_blank_lines 추가: 3개 이상 연속 개행 → 2개로 정규화
• _normalize_blank_line_after_br 추가: <br/> 뒤 빈 줄 제거

test_reverse_sync_roundtrip_verifier.py:

• _normalize_empty_list_items 단위 테스트 3건
• _normalize_consecutive_blank_lines 단위 테스트 3건
• _normalize_blank_line_after_br 단위 테스트 3건
• verify_roundtrip 통합 테스트 3건 (각 패턴이 정규화로 PASS되는지 검증)

검증

943 pytest passed
42 reverse-sync bug tests passed
45/45 verify passed (split/ko-proofread-20260221-administrator-manual-general)

Added/updated tests?

• Yes — 단위 테스트 9건 + 통합 테스트 3건 추가

Additional notes

• 테이블 셀 CJK 패딩 원인인 FC len() → _display_width() 수정은 별도 PR #975로 분리하여 머지 완료 (174줄 → 10줄로 감소)
• 테이블 셀 패딩은 _normalize_table_cell_padding으로 공백 차이를 무시하는 것이 올바른 접근

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
querypie-docs	Ready	Preview, Comment	Apr 3, 2026 0:30am