[airmang]

요약

2026-11-10 점검에서 나온, 성공으로 보고하면서 내용이 달라지는 경로를 고칩니다. 커밋은 항목별로 나눴습니다.

• strip_runs_by_color가 다른 색 글을 지우던 것. 대상 색 run이 표·글상자·각주를 품고 있으면 안쪽 첫 run의 글이 비워졌습니다. run 경계를 중첩을 따라가며 잡도록 바꿨고, 대상 run이 직접 가진 글만 비웁니다. 빈 run 뒤의 다른 색 글이 지워지던 것과, 캐시 제거가 엉뚱한 문단에 걸리던 것도 함께 고쳤습니다.
• 찾아 바꾸기·부분 편집의 줄바꿈과 탭. run.replace_text, doc.text.replace, doc.replace_text_in_runs, apply_model이 "\n"을 hp:lineBreak로, 탭을 hp:tab으로 씁니다. set_text_preserving_runs가 탭을 지우던 것을 고쳤습니다.
• 내용이 바뀐 문단에 옛 줄 배치 캐시가 남던 것. apply_model, add_index_mark, add_title_mark, add_drop_cap이 고친 문단의 캐시를 지웁니다. 저장할 때는 "캐시는 읽을 때 그대로인데 문단 내용이 달라진" 문단의 캐시를 지우는 안전망을 더했습니다.
• 빈 글맵시·OLE·동영상을 저장 관문이 통과시키던 것. add_raw("textart"|"ole"|"video")로 만든, 필수 자식이 없는 요소는 이제 hp:rect처럼 저장이 거부됩니다. 이런 문서는 한/글에서 열리지 않습니다. 한/글이 저장한 정상 자료 7개는 그대로 통과하고, 빈 수식은 계속 저장됩니다.
• 주석·처리 지시문이 든 문서의 저장이 TypeError로 죽던 것.
• body_patch 연산의 테스트와 거기서 나온 결함 4건. 구역 정의를 품은 문단을 지우거나 복제·이동하던 것, 각주·글상자를 품은 문단에서 안쪽 글이 비워질 수 있던 것은 이제 거부합니다(body-op-section-settings, body-op-nested-paragraph). restyle_text가 표 안 run의 글자 모양을 바꾸던 것은 글을 직접 가진 run을 바꾸게 했습니다. body_patch.py의 테스트 실행률이 40.6%에서 95%가 됩니다.
• 기본 저장 검사의 범위를 문서에 정확히 적었습니다. 참조 무결성 검사는 기본에 넣지 않았습니다. 한/글이 저장한 자료 2개가 걸리기 때문입니다.

병합 전에 볼 것

• 저장 때 안전망의 비용. 고친 구역의 저장이 1015% 느려집니다(131 KB 양식에서 0.67초 중 0.10초). 원하지 않으면 section.py의 _remove_outlived_layout_caches 호출 한 줄을 빼면 API 수정만 남습니다. 기존 "2배 폭" 훑기는 그대로 두었습니다. 1배로 좁히면 한/글이 저장한 정상 캐시 334908개가 지워졌습니다.
• body_patch의 새 거부. 구역 첫 문단을 지우거나 복제하는 호출은 이제 오류가 납니다. python-hwpx-automation main의 평가계획·본문 편집 테스트를 이 브랜치로 돌렸을 때 실패 목록은 main 엔진으로 돌렸을 때와 같았습니다(Windows, 부분 실행).
• 화면에서의 모양은 확인하지 않았습니다. 모두 XML 수준의 확인입니다.

관련 이슈

Refs #658

변경 종류

• 버그 수정
• 기능
• 문서
• 리팩터링

체크리스트

• pytest 테스트가 통과합니다. — Windows 11에서 7,765 통과, 14 실패. 실패 14건은 이 변경 전 main에서도 같은 이름으로 실패하던 것입니다(cp949, 심볼릭 링크 권한, CRLF). Linux CI 결과는 이 PR의 체크로 확인해 주세요.
• CHANGELOG.md를 갱신했습니다(해당하는 경우).
• 문서 갱신이 필요한지 확인했습니다.

🤖 Generated with Claude Code

[airmang]

Reviewed fa58131 across nested run scanning, body operation refusal guards, text atom writing, cache lifetime tracking and open-safety checks. Exact-head CI: all 13 checks pass; Python 3.12 records 7,779 passed, 18 skipped, 1 xfailed. Locally, all 118 focused tests pass. No additional correctness defect was found in this review. Merge is held because integrating with the newer main after #676 produces a content conflict in CHANGELOG.md (confirmed by git merge-tree); please reconcile with the latest base and rerun checks. This is a COMMENT because the signed-in account owns this PR. No Hancom process or package/plugin publication was launched.