증상

Task #517 이 도입한 Layout 리팩터링 측정·재현 인프라 (env-var 기반 진단 로깅 + 회귀 비교 스크립트) 가 stream/devel 에 누락. Phase 2~4 본질 정정의 검증 도구가 부재하여, 이후 layout 계열 회귀 디버깅 시 동일 인프라를 재구축해야 하는 상황.

회귀 메커니즘

Task #517 의 코드/스크립트 (9c16a1b4 Stage 1·2) 는 local/devel 에 정상 머지되었으나, devel (= stream/devel) 으로의 승격이 일어나지 않음. 이슈 #618 (Task #519) 와 동일한 묶음 머지 a7e43f9 (Task #517/#518/#519/#520/#521/#523/#528) 누락 패턴.

$ git merge-base --is-ancestor 9c16a1b4 stream/devel
NOT in stream/devel

누락 항목 (stream/devel 기준)

정량 증거

$ git grep -n "layout_debug_enabled\|RHWP_LAYOUT_DEBUG" stream/devel -- src/
(0 matches)

$ git ls-tree stream/devel -- scripts/svg_regression_diff.sh
(empty)

수정 방향

Task #517 의 원 commit 9c16a1b4 (Layout 리팩터링 Phase 1 — 디버그 인프라 + 회귀 검증 도구) 을 stream/devel 기준으로 cherry-pick 재적용.

• 코드 변경: paragraph_layout.rs +32 줄 (env-var-checked → 기본 동작 변경 없음)
• 신규 스크립트: scripts/svg_regression_diff.sh (+154 줄)
• 신규 매뉴얼: mydocs/manual/svg_regression_diff.md (+85 줄)

회귀 방지

#618 issue 본문 권고대로, 묶음 머지 a7e43f9 의 다른 task (#518) 도 동일 누락 상태 → 별도 이슈로 분리 등록 (#518: "Layout 리팩터링 Phase 2 line_break_char_idx 다중화 — devel 미머지").

참고

• 원 이슈: Layout 리팩터링 Phase 1: 디버그 인프라 + 회귀 검증 도구 #517 (CLOSED)
• 원 fix 커밋: 9c16a1b4 (Task Layout 리팩터링 Phase 1: 디버그 인프라 + 회귀 검증 도구 #517: Layout 리팩터링 Phase 1 — 디버그 인프라 + 회귀 검증 도구)
• 묶음 머지: a7e43f9 (Merge local/devel: Task Layout 리팩터링 Phase 1: 디버그 인프라 + 회귀 검증 도구 #517/Layout 리팩터링 Phase 2: line_break_char_idx 다중화 (ls[2..] break 사용) #518/그림(Picture) 회전·뒤집기(flip) 속성이 SVG 렌더링에 적용되지 않음 #519/exam_science.hwp 문제7: inline 도형(tac=true, wrap=TopAndBottom)이 다음 문단 라인에 그려져 텍스트와 겹침 #520/exam_eng p2 18번 답안지 위치가 박스 하단에 너무 가까움 — 그림(BehindText) 의 vertical extent 가 paragraph height 에 미반영 #521/exam_science 페이지 1 → 2 누적 vpos drift: 문제 6번 <보기>/답안이 다음 페이지로 밀림 #523/옛한글 PUA → KS X 1026-1:2007 자모 변환 (HncPUAConverter 정합) — exam_kor 17p 고어 미렌더 #528)
• 동일 패턴 선행 사례: Picture flip/rotation 누락 회귀 — Task #519 정정이 devel 에 미머지 #618 (Task 그림(Picture) 회전·뒤집기(flip) 속성이 SVG 렌더링에 적용되지 않음 #519 누락) → PR fix: Picture flip/rotation 누락 회귀 정정 (Task #519 재적용, closes #618) #620