[HWP5/변환] convert/convert_to_editable 경로 그림·페이지 손실 (KTX 27→1쪽; serialize_document 직접은 보존)

[planet6897]

배경

Task #1552 게이트 신설 과정에서, convert/convert_to_editable 경로가 일부 HWP5 문서의 그림·페이지를 손실시킴이 확인됐다. 직접 serialize_document(= export_hwp_native)는 같은 문서를 완전 보존하므로, 손실은 변환(editable) 경로에 한정된다. F1(#1554, serialize_document 자체 BinData 드롭)과 별개다.

증거 — KTX.hwp (배포용 아님, 원본 27쪽·BinData 3)

경로	KTX BinData	KTX 페이지(한글 2024)
원본	3	27
serialize_document 직접(#1552 게이트)	3 보존	27 = 27 보존
convert(convert_to_editable 경유)	0 (전 소실)	27 → 1 붕괴

convert 저장본은 한글에서 무결성 오류 없이 열리나 1쪽으로 붕괴하고 그림이 모두 사라진다.

재현

rhwp convert samples/basic/KTX.hwp /tmp/ktx.rt.hwp
# 비교: olefile 로 BinData 0 확인, 한글로 열어 1쪽 확인
# 대조: rhwp hwp5-roundtrip samples/basic/KTX.hwp  → PASS (serialize_document 직접은 보존)

의심 지점 (root-cause 필요)

convert CLI(convert_hwp)는 직접 parse_document+serialize_document 가 아니라 다음 경로를 탄다:

• rhwp::wasm_api::HwpDocument::from_bytes(별도 파서 진입) →
• convert_to_editable_native() → Document::convert_to_editable() (src/model/document.rs:346) →
• export_hwp_with_adapter() → convert_if_hwpx_source() (src/document_core/converters/hwpx_to_hwp.rs:1550, HWP 출처는 no-op) → serialize_document.

KTX 는 배포용 아님·HWP 출처이므로 어댑터는 no-op 이어야 하나 손실 발생 → wasm_api::HwpDocument 파스 경로 또는 convert_to_editable() 가 bin_data_content·페이지 구조(IR)를 변형하는지 점검 필요. DocumentCore(게이트 경로)와 IR 차이 비교가 시작점.

수용 기준

• convert 산출물이 KTX(및 유사 문서)의 BinData·페이지를 보존(한글 페이지수 원본과 일치, olefile BinData 멀티셋 보존).
• 가능하면 게이트에 convert 경로 분기(C3' 외부 페이지/배포용)를 추가하거나, 회귀 재현 케이스 등록.

분리

• F1([HWP5/직렬화] serialize_document BinData 그림 스트림 드롭 (F1, #1552 게이트 검출 9건 XFAIL 승격) #1554): serialize_document 자체 BinData 드롭(편집가능 9건). 본 이슈는 convert/editable 경로 추가 손실로 별개.

관련: #1552, #1554, PR #1553. 근거: output/poc/fidelity/report.md, mydocs/working/task_m100_1552_stage2.md.

[planet6897]

재현 불가 — 현재 devel 코드에서 해소됨 (구버전 바이너리 아티팩트)

정식 타스크 착수 전 근본원인 조사 결과, 본 이슈는 현재 devel 코드에서 재현되지 않습니다. 닫습니다.

검증 (현재 devel 빌드)

rhwp convert(= DocumentCore::from_bytes → convert_to_editable_native(no-op) → export_hwp_with_adapter → serialize_document):

파일	원본 BinData	convert 저장본 BinData	페이지(rhwp/한글)
KTX.hwp	3	3 보존	원본 27 → convert 27 (한글에서도 27=27)
exam_kor.hwp	27	27 보존	—

KTX 가 보고서의 핵심 증거(27→1쪽·이미지 전손실)였으나, 현재 코드는 이미지·페이지 모두 보존한다.

코드 근거 (HWP 출처는 손실 경로 없음)

• Document::convert_to_editable() (src/model/document.rs:346): 비배포용이면 즉시 false 반환 = no-op. KTX 는 배포용 아님.
• convert_if_hwpx_source() (src/document_core/converters/hwpx_to_hwp.rs:1550): source_format != Hwpx/Hwp3 이면 no-op. KTX 는 Hwp 출처.
• bin_data_content 재할당은 hwpx_to_hwp.rs:335(HWPX/HWP3 전용)뿐 — HWP 출처 convert 는 BinData 를 건드리지 않음.

오보의 원인

선행 조사 harness(output/poc/fidelity/)와 그에 기반한 #1552 Stage 2 귀속은 **세션 시작 시점의 구버전 바이너리(2026-06-12 빌드, 더 오래된 커밋)**로 convert 를 측정했다. 그 바이너리는 KTX 의 BinData·페이지를 떨어뜨렸으나, 현재 devel 에선 이미 보존된다. 즉 Stage 2 의 "serialize_document 보존 vs convert 손실" 비교는 fresh-gate vs stale-convert 라는 서로 다른 바이너리 비교였다(동일 빌드로는 둘 다 KTX 보존).

결론 / 영향

• 본 이슈(F2')는 현재 코드 기준 고칠 결함 없음 → close.
• F1([HWP5/직렬화] serialize_document BinData 그림 스트림 드롭 (F1, #1552 게이트 검출 9건 XFAIL 승격) #1554)은 유효하다 — [도구] HWP5 roundtrip 무손실 게이트(hwp5-roundtrip CLI) 신설 — BinData 보존·페이지수 복원 검사 #1552 게이트가 fresh 바이너리로 serialize_document 를 직접 검증해 BinData 드롭(interview 1/3·Worldcup 13/47·img-start-001 20/20 등 9건)을 검출했으며 재현된다.
• output/poc/fidelity/report.md 및 [도구] HWP5 roundtrip 무손실 게이트(hwp5-roundtrip CLI) 신설 — BinData 보존·페이지수 복원 검사 #1552 Stage 2 의 KTX/convert 수치는 구버전 바이너리 측정으로 읽어야 한다. HWP5 저장 충실도의 권위 기준은 [도구] HWP5 roundtrip 무손실 게이트(hwp5-roundtrip CLI) 신설 — BinData 보존·페이지수 복원 검사 #1552 게이트(hwp5-roundtrip)다.

재발 감시가 필요하면 rhwp hwp5-roundtrip 게이트에 convert 경로(또는 배포용→editable) 분기를 추가하는 별도 개선으로 다룰 수 있다.