HWPX 직렬화 무손실 개선 + opengov 회귀 말뭉치 + 페이지붕괴 군집 해소 (#1586 통합 squash)

[planet6897]

개요

활성 devel 통합 브랜치의 누적 작업을 upstream/devel 기준 단일 squash 커밋으로 정리합니다. PR #1586을 대체합니다.

closes #1586

포함 작업

직렬화/렌더 무손실

• HWPX 저장 시 본문 문단의 인라인 ColumnDef(cold) 드롭 → 컨트롤 인덱스 시프트 #1584 본문 인라인 ColumnDef 드롭 수정
• HWPX 저장 시 Ruby 컨트롤 드롭 (render_control_slot arm 부재) #1587 Ruby(덧말) 직렬화 (모델/파서/serializer)
• HWPX 저장 시 선 도형(hp:line) shapeComment 드롭 (write_line 누락) #1588 선 도형 shapeComment 방출
• HWPX 저장 시 빈 문단(char_shapes=[])에 spurious (0,0) char_shape 추가 #1592 HWPX 빈 문단 spurious (0,0) 수정
• HWPX 직렬화 시 holdAnchorAndSO 드롭(1→0) → 페이지 붕괴 (IR-invisible) #1594 holdAnchorAndSO 드롭 수정 + diff_documents IR 게이트 (페이지 붕괴)
• HWPX 직렬화 시 ClickHere 필드 타입 CLICKHERE(틀림)→CLICK_HERE → 페이지 붕괴 (IR-invisible) #1595 ClickHere 필드 타입 CLICK_HERE 수정 (페이지 붕괴 지배원인, 오라클 92.5% 해소)
• HWPX generic-shape(polygon/ellipse/arc/curve) 지오메트리 직렬화 미완 → 페이지 붕괴 #1596 generic-shape(polygon/curve) 지오메트리(lineShape/fillBrush/shadow/꼭짓점) 직렬화 완성 (페이지 붕괴)
• HWPX ellipse/arc 전용 지오메트리(center/축/시작끝점) 직렬화 완성 #1598 ellipse/arc 전용 지오메트리(center/축/시작끝점) 파서+직렬화 완성 (페이지 붕괴 잔여 long-tail)

회귀 게이트/말뭉치

• [테스트] 고정 실문서 회귀 말뭉치 (opengov 대표 N건) + 스냅샷 회귀 게이트 #1564 opengov 고정 실문서 회귀 말뭉치 + 스냅샷 게이트 (가드 샘플 다수)
• serializer/hwpx roundtrip·table rustfmt 정리

조사/도구

• HWPX 재저장 시 한글에서 페이지 붕괴(29→3, IR diff=0) — 시각 무손실 갭 #1589 페이지 붕괴 군집/오라클 조사 (tools/verify_hangul_pages.py, mydocs/tech/hwpx_page_collapse_cluster.md)
• HWPX 저장 시 para0 후위 컨트롤(Bookmark/PageNum) 위치 오류 → char_shape +8 시프트 #1591 para0 북마크 hoist 조사 (순효과 0, 롤백)

#1589 페이지 붕괴 군집 — IR-invisible 직렬화 결함 4종 누적 해소

IR diff=0(게이트 PASS)인데 한글에서만 페이지가 붕괴(예 3→2, 29→3)하는 군집(~16%)을 단락 이진탐색 + 한글 오라클(PageCount)로 분해:

1. HWPX 직렬화 시 ClickHere 필드 타입 CLICKHERE(틀림)→CLICK_HERE → 페이지 붕괴 (IR-invisible) #1595 ClickHere CLICKHERE→CLICK_HERE (지배, 오라클 37/40 해소)
2. HWPX 직렬화 시 holdAnchorAndSO 드롭(1→0) → 페이지 붕괴 (IR-invisible) #1594 holdAnchorAndSO 하드코딩 "0"→IR 값 방출 (하단 앵커 개체)
3. HWPX generic-shape(polygon/ellipse/arc/curve) 지오메트리 직렬화 미완 → 페이지 붕괴 #1596 generic-shape 지오메트리 lineShape/shadow/꼭짓점 드롭 복원
4. HWPX ellipse/arc 전용 지오메트리(center/축/시작끝점) 직렬화 완성 #1598 ellipse/arc 전용 지오메트리 center/축/시작끝점 파서 미적재+직렬화 드롭 복원
   → 통제 비교 각 단계 악화 0, 잔여 표본 붕괴 미관측.

검증 (로컬, upstream/devel 기준)

• cargo test --lib → 1970 passed, 0 failed
• cargo clippy / cargo fmt --all -- --check ✅
• opengov_corpus_snapshot / hwpx_roundtrip_baseline ✅
• behind=0 (upstream/devel 최신 통합: skia raster perf perf: optimize native Skia raster replay #1577, 캡션 플로팅 이미지 HWPX: 캡션 내 플로팅 이미지 렌더링 지원 #1585 등)

비고

• 단일 squash라 task 단위 히스토리는 원본 devel 브랜치에 보존됨.

[edwardkim]

이 PR 처리 후, #1533 PR 처리를 진행하겠습니다. @planet6897 님 작업으로 0.8 버전으로 올려야 하겠습니다.
더불어 #858 에 게시된 단톡방 참여를 기대하겠습니다. 카톡을 사용하지 않으신다면 어쩔 수 없지만 말이죠!

[edwardkim]

merge 완료했습니다 (merge commit 138ebf8, origin/devel 포함 검증). 감사합니다, @planet6897!

8개 직렬화 무손실 작업을 단일 squash로 잘 정리해 주셨고, 무엇보다 'IR diff=0(게이트 PASS)인데 한글에서만 페이지 붕괴'하던 IR-invisible 결함 군집(~16%)을 한글 오라클로 분해한 접근이 인상적입니다.

검증:

• 신규 issue_1598(ellipse 지오메트리) 통과, opengov 말뭉치 스냅샷 2/2, hwpx roundtrip baseline 4/4, visual roundtrip baseline 3/3
• 전체 cargo test --tests FAILED 0건(lib 1970), fmt/clippy clean, 충돌 0건(CLEAN)

특히 #1594에서 결함을 고치는 데 그치지 않고 diff_documents에 diff_hold_anchor(prevent_page_break) 검사를 추가해 IR-invisible 갭을 게이트가 검출하도록 강화한 점이 좋습니다 — 동종 회귀 재발을 구조적으로 막습니다.

페이지 붕괴 해소(오라클 92.5%)는 한글 환경 측정이라 로컬에서는 게이트/baseline으로 간접 검증했고, 한글 오라클 권위는 작업지시자 환경에 둡니다. 좋은 작업 감사합니다!