Task #1552: HWP5 roundtrip 무손실 게이트(hwp5-roundtrip CLI) 신설

[planet6897]

개요

hwpx-roundtrip에 대응하는 HWP5 동일포맷 roundtrip 무손실 게이트를 신설합니다 (closes #1552).
serialize_document(= export_hwp_native, HWP5 저장하기)가 IR 뼈대뿐 아니라 BinData 그림 스트림·페이지수·CFB 구조까지 보존하는지 자동 검사하고 회귀로 고정합니다.

동기

HWPX/HWP5 무손실 4단계 검증(IR·텍스트·한글 재열림·한글 PDF) 결과 IR diff=0이 무손실을 보장하지 않음이 실증됨:

• serialize_document가 일부 BinData 그림 스트림을 통째 드롭(F1) — IR diff·텍스트는 통과라 자동검사가 못 잡음.

검사 항목 (C1~C5)

#	검사	잡는 결함
C1	IR 뼈대 diff(diff_documents)	구조 손실
C2	BinData 보존(decompressed 내용 멀티셋)	그림 스트림 드롭(F1)
C3	페이지수 복원(DocumentCore)	페이지 변형
C4	CFB 구조(필수 스트림+섹션 수)	구조 회귀
C5	2-round 안정성	비결정성

구현

• CLI rhwp hwp5-roundtrip <파일|--batch 폴더> [-o] → inventory.tsv(17컬럼) + .rt.hwp + 하드 실패 시 종료 코드 1
• 회귀 테스트 tests/hwp5_roundtrip_baseline.rs — samples/*.hwp 전수, 신규 샘플 자동 포함. out_of_scope()로 HWP3·배포용 자동 제외, XFAIL 9건(F1) 봉인
• 매뉴얼 mydocs/manual/hwp5_roundtrip_baseline.md

측정 (samples/*.hwp 319건, 27.5s)

• A(PASS)=297, B(xfail)=9(F1 BinData 드롭), 자동 제외=13(HWP3 10 + 배포용 3)
• cargo test --test hwp5_roundtrip_baseline 3 passed, 단위 14 passed, clippy 클린

손실 원인 분리 (게이트 신설의 가치)

선행 조사는 convert(= convert_to_editable 경유)로 측정해 KTX 27→1쪽 붕괴·이미지 전손실을 관측했으나, 본 게이트는 serialize_document를 직접 테스트하여 KTX는 보존(3/3 이미지, 27=27쪽) 임을 확인 — F2(KTX 붕괴)는 serialize_document가 아니라 convert_to_editable 경로 결함으로 규명됨.

후속 (별도 이슈)

• F1: serialize_document BinData 드롭 수정(xfail 9건 승격)
• F2': convert_to_editable/convert 경로 이미지·페이지 손실
• F3: HWPX serializer 컨트롤 슬롯 8유닛 시프트

주의

게이트 통과 = 구조+BinData+페이지(rhwp 자기일관) 보존이며 시각 충실도 보장 아님. C3는 외부 한글-only 붕괴는 미검출(한글 harness 보조).

🤖 Generated with Claude Code

---

추가: Task #1554 — F1 BinData 고아 스트림 드롭 수정 (closes #1554)

본 PR에 #1554 수정 커밋이 포함됨. 위 "후속(별도 이슈) F1"을 본 PR에서 함께 해결.

• 원인: storage_id 충돌이 아니라 대응 HWPTAG_BIN_DATA 레코드 없는 고아 /BinData 스트림 — 파서가 레코드 기준으로만 적재해 저장 시 통째 드롭(IR diff=0이라 false PASS).
• 수정(src/parser/mod.rs): collect_extra_streams가 직렬화기 재생성 대상(bin_data_content 기반) /BinData 경로만 제외하고, 고아 스트림은 extra_streams로 원본 바이트 보존. serialized_bin_name 헬퍼로 직렬화기 명명 규칙 미러링(중복 없이 선별).
• 결과: 영향 9건(img-start-001 20/20 ~ interview 1/3) BinData 전수 보존 → tests/hwp5_roundtrip_baseline.rs XFAIL 9건 baseline 승격(목록 비움). cargo test --test hwp5_roundtrip_baseline 통과, clippy 무경고.
• 보고서: mydocs/report/task_m100_1554_report.md

[planet6897]

#1558 로 대체합니다 — #1552(roundtrip 게이트)와 #1554(BinData 고아 스트림 드롭 수정)를 stream/devel 기준 단일 squash 커밋으로 통합. 본 PR은 close.