성능 벤치마크: bench CLI 서브커맨드 (대용량 처리 성능 계량)

[planet6897]

배경

대용량 HWP/HWPX 처리 성능을 재현 가능한 수치로 계량할 자산이 없다(현재 render-diff/
hwpx-roundtrip 가 ms 를 부수적으로 찍을 뿐 단계별 분리 없음).

제안

rhwp bench 서브커맨드 신설.

• 단계별 계측: parse(바이트→IR) · layout/paginate · render · serialize_hwpx(저장).
• 파일별 size/페이지수 + 단계별 median(ms) + total. 워밍업 후 N회 반복.
• 인간 가독 표 + --tsv 출력.
• --batch DIR 전수 / 파일 인자.

산출

• bench 명령 + help/매뉴얼(cli_commands.md) 동기화.
• 성능 측정 보고서(mydocs/report) — 단일 머신 명시, 상대·재현 강조(절대수치 단정 회피).

[postmelee]

PR #1538 머지로 해결되어 이슈를 닫습니다.

반영 내용:

• rhwp bench CLI 추가
• parse/layout/render/serialize 단계별 median(ms) 계측
• 파일별 크기/쪽수/단계별 시간/total 출력
• --batch 폴더 전수 처리
• --tsv 결과 산출
• 자동화 신뢰성을 위해 입력 파일 처리 실패, render 실패, TSV 쓰기 실패를 non-zero exit로 처리

머지 정보:

• PR: Task #1537: bench — 단계별 처리 성능 계측 CLI 서브커맨드 #1538
• merge commit: d8e792f
• latest PR head: 10ed345

검증:

• GitHub Actions latest head 기준 Build & Test, CodeQL, Render Diff 통과
• 로컬 검증: fmt, diff check, clippy, release build, bench 성공/실패/TSV 실패 스모크 통과

PR body의 closes #1537가 자동 close로 연결되지 않아 수동으로 close합니다.