라운드트립 렌더 회귀 수정: IrDiff 0인데 렌더 노드 누락/변위 (render-diff XFAIL 20건)

[planet6897]

배경

Task #1499 에서 신설한 render-diff 렌더 기하 정합성 게이트(tests/visual_roundtrip_baseline.rs)가
samples/hwpx 전수 측정에서 20건의 라운드트립 렌더 회귀를 검출했다. 모두
hwpx-roundtrip 기준 IrDiff 0(구조 보존) 인데도 라운드트립(parse→serialize→reparse)이
렌더 결과(렌더 노드 삽입/삭제, bbox 변위)를 바꾼다. 현재 XFAIL 로 등록되어 게이트를
통과시키고 있으며, 본 이슈에서 개별 수정 → baseline 승격을 목표로 한다.

측정 데이터: output/poc/task1499/geom_inventory.tsv, 보고서 mydocs/report/task_m100_1499_report.md.

우선 수정 후보 (단순 문서)

샘플	증상 (IrDiff 0)
el-school-001.hwpx	임베디드 Image 노드 1→0 누락 (render del=1)
143E433F503322BD33.hwpx	render ins=1 del=5
expense_report.hwpx	render del=4
hy-002.hwpx	render del=1, 변위 603px
2026_oss_rst.hwpx	render del=1, 변위 459px
exam_social-p1.hwpx	render del=13
footnote-01.hwpx	render del=35, 변위 613px
shape-001.hwpx	도형 Path 변위 6.8px
hwpx-h-01.hwpx	Image 변위 514px

복합 실문서 (ORACLE_UNFIT, 후순위)

exam_social, exam-kor-2p/3p/4p, exam_kor, aift, k-water-rfp, [2027] 온새미로 1 본교재,
해외직접투자 보도자료 ff×3 — 표·그림·도형·다단 혼합으로 변동 폭이 큼.

작업 방향

• el-school-001 의 임베디드 이미지 누락이 가장 명확한 출발점 (단일 페이지, del=1, 원인 격리 용이).
• rhwp render-diff <sample.hwpx> 로 재현, export-render-tree 로 누락 노드 타입 확인.
• 수정 후 해당 샘플을 visual_roundtrip_baseline.rs XFAIL 에서 제거 → baseline 승격
  (xfail_entries_still_pass_promote 가 자동 알림).

관련

• Task HWPX 라운드트립 시각 정합성 게이트 신설 (render-diff) #1499 (게이트 신설)
• mydocs/manual/render_diff_command.md

[planet6897]

종결 — 회귀 해소 확인 (devel 30931679 기준 재검증)

본 이슈가 타깃한 20건 라운드트립 렌더 회귀가 중간 직렬화/페이지네이션 정정(#1567, #1637 등)으로 사실상 해소되어 종결합니다.

전수 게이트 현황

• cargo test --test visual_roundtrip_baseline → 3 테스트 전부 통과
• VISUAL_XFAIL: 20건 → 1건(opengov/36392900, 변위 1.32px)만 잔존

우선 후보 el-school-001 직접 검증 (export-render-tree 노드 카운트)

측정	값
원본 Image 노드	1
라운드트립 Image 노드	1 (누락 없음)
render-diff 원본↔라운드트립	PASS (최대 변위 0.00px, 구조 불일치 0)

이슈가 지목한 "임베디드 Image 노드 1→0 누락(del=1)"이 더 이상 재현되지 않음. 표 후보(143E433F…, expense_report 등) 및 hy-002/2026_oss_rst/footnote-01 등 변위 계열도 baseline 승격 완료.

잔존분

opengov/36392900 1건은 노드 누락이 아니라 변위 드리프트(1.32px) 이며, base serializer 와 동일(라운드트립 고유 결함 아님)하여 본 이슈(render 노드 누락/변위 회귀)와 성격이 다름. 별도 이슈로 분리 추적 권장.

→ 본 이슈 종결.