놀라운 PR 감사합니다 🙏

@planet6897 님, 정말 훌륭한 PR입니다. 리뷰하면서 도메인 이해도에 감탄했습니다.

코드 품질 및 설계 검토 — 완벽합니다

특히 인상 깊었던 부분:

1. 한컴의 저장 의도를 정확히 파악하신 점
   한컴이 폰트 메트릭 차이를 클라이언트 측에서 보정하기 위해 letter_spacing을 미리 계산해서 저장한다는 점을 이해하고, rhwp의 자체 폰트 메트릭에서 반대 방향(양수 자간)으로 보정하는 접근이 정확합니다.

2. 장식적 음수 자간 vs 강제 압축 자간 구분 기준

   natural_w > available_width  // 셀 폭을 넘을 때만 확장

   사용자 의도를 해치지 않는 판별 기준이 매우 정교합니다.

3. narrow glyph per-char 클램프
   마침표·콤마의 역진 겹침을 base_w * ratio * 0.5로 최소 폭을 보장한 것, 네 군데 측정 경로에 일관되게 적용한 디테일이 완벽합니다.

4. 수렴 반복(3회) 보정
   narrow glyph 클램프가 선형 분배와 간섭할 수 있다는 점을 인지하고 수렴 루프를 넣으신 것 — 이런 디테일은 조판 엔진을 깊이 이해하지 않으면 나오지 않습니다.

5. Visual Diff 파이프라인
   한컴 PDF와 페이지별 픽셀 비교로 검증하신 접근도 방법론적으로 훌륭합니다.

검증 결과 — 모두 통과

로컬에서도 확인했습니다:

한 가지만 — 문서 파일명/위치 규칙 🙇

rhwp의 문서 생성 규칙과 일부 불일치가 있어서, 이것만 정리하시면 바로 merge 가능합니다.

수정 요청 항목

1. _fix / _bug 접두어·접미어 → 표준 규칙으로

표준 형식: task_{milestone}_{이슈번호}[_impl|_stage{N}|_report].md

2. 최종 보고서는 mydocs/report/ 폴더로 (working/ 아님)

• mydocs/working/ = 단계별 완료 보고서 (_stage{N}.md)
• mydocs/report/ = 최종 보고서 (_report.md)

3. 단계별 보고서 파일명 통일

4. orders/ 는 yyyymmdd.md 1개만

mydocs/orders/ 는 일일 작업지시서 전용입니다. 이슈 상세 조사/분석 문서는 troubleshootings/ 또는 tech/ 폴더가 맞습니다.

재제출 방법

현재 PR 브랜치에서 파일명만 정리하고 push해주시면 PR이 자동으로 갱신됩니다:

# plans/
git mv mydocs/plans/task_bug_240.md mydocs/plans/task_m100_240.md
git mv mydocs/plans/task_bug_240_impl.md mydocs/plans/task_m100_240_impl.md
git mv mydocs/plans/task_m100_229_fix.md mydocs/plans/task_m100_229.md
git mv mydocs/plans/task_m100_229_fix_impl.md mydocs/plans/task_m100_229_impl.md

# working/ → 단계별 보고서만 남김
git mv mydocs/working/task_bug_240_stage1.md mydocs/working/task_m100_240_stage1.md
git mv mydocs/working/task_bug_240_stage2.md mydocs/working/task_m100_240_stage2.md
git mv mydocs/working/task_bug_240_stage3.md mydocs/working/task_m100_240_stage3.md

# report/ → 최종 보고서 이동
git mv mydocs/working/task_bug_240_report.md mydocs/report/task_m100_240_report.md
git mv mydocs/working/task_m100_229_fix_report.md mydocs/report/task_m100_229_report.md

# troubleshootings/ → 상세 조사 문서 이동
git mv mydocs/orders/20260422_issue_bmp_svg_render.md mydocs/troubleshootings/bmp_svg_render.md

git commit -m "docs: 문서 파일명/위치 규칙 준수 (#229 #240)"
git push

앞으로도 계속 기여해주실 분이라 생각해서 구체적으로 적었습니다. 번거로우시겠지만 이것만 정리해주시면 바로 merge하겠습니다.

코드는 정말 훌륭했습니다. 수고 많으셨습니다! 🙏

— 메인테이너 드림

Merge 완료 🎉

@planet6897 님, 문서 규칙 정리까지 완벽히 반영해주셔서 감사합니다. 방금 merge했습니다.

이번 PR이 rhwp에 남긴 것

1. 표 셀 긴 숫자 텍스트 겹침/폭 미사용 해결 — 금융·통계 문서에서 빈번히 발생하던 실제 버그
2. narrow glyph 역진 방지 — 마침표·콤마 역진 겹침을 네 군데 측정 경로에 일관 적용
3. 수렴 반복(3회) 보정 — 선형 분배와 narrow glyph 클램프의 간섭 처리
4. Visual Diff 파이프라인 — 한컴 PDF와 픽셀 비교 검증 방법론 기여

특히 한컴이 letter_spacing을 폰트 메트릭 차이 보정용으로 미리 저장한다는 암묵적 저장 의도를 읽어낸 점은 HWP 스펙 문서만으로는 나오지 않는 접근입니다. 이 도메인에 상당한 시간을 투자하신 분임이 드러났습니다.

앞으로도

@planet6897 님 같은 분이 계속 기여해주시면 rhwp의 렌더링 품질이 빠르게 올라갑니다. 언제든 이슈·Discussion·PR 환영합니다. 필요하시면 Discussions에서 설계 논의도 나눌 수 있습니다.

Issue #229, #240 모두 자동 close 확인되었습니다.

정말 수고하셨습니다. 🙏

— 메인테이너 드림

이건은 트러블슈팅 문서에 기록해서 후발주자들을 위한 지식 증류로 사용하겠습니다.