Task #639: 한컴 호환 — cover-style 페이지 자동 쪽번호 미표시 (closes #639)

[planet6897]

Summary

• Task 한컴 호환: cover-style 페이지 (items=1 + 완전한 Table + tac=false) 자동 쪽번호 미표시 #639 (closes) — cover-style 페이지 (items=1 + 완전한 Table + tac=false) 자동 쪽번호 미표시 한컴 호환 fix
• Task 한컴 호환: aift.hwp 페이지 2, 3 (큰 표만 있는 cover-style) 쪽번호 미표시 메커니즘 분석 #637 분석에서 도출된 결정적 룰의 코드 구현 — 174 샘플 중 aift.hwp 페이지 2, 3 만 영향 (한컴 PDF 미표시와 일치)
• 코드 변경: src/renderer/typeset.rs (+29) + src/renderer/pagination/engine.rs (+29) + integration tests (+99)
• 회귀 위험 0 확정 (cargo test 1139+76 PASS, clippy 0 warning)

Note: 본 PR 는 Task #637 분석 PR (#640) 의 분석 도구/문서를 base 로 한 fix PR. PR #640 이 먼저 머지되면 본 PR diff 는 Task #639 커밋 5개만 남게 됨 (GitHub 자동 dedup). 단독 머지도 가능 (분석 + fix 함께).

핵심 발견 — 두 페이지네이션 경로 존재

rhwp 의 페이지네이션은 두 경로 양분:

• `TypesetEngine::typeset_section` (기본 main path, src/renderer/typeset.rs)
• `Paginator::paginate_with_measured` (RHWP_USE_PAGINATOR=1 fallback, src/renderer/pagination/engine.rs)

`render_page_svg_native` → `build_page_tree` → `find_page` 경로는 TypesetEngine 사용.
페이지 단위 derived state (page_hide 등) 변경 시 양쪽 동일하게 적용 필수.

구현 룰

```rust
// finalize_pages 내부, 기존 PageHide 적용 직후
if page.page_hide.is_none() && Self::is_cover_style_page(page, paragraphs) {
page.page_hide = Some(crate::model::control::PageHide {
hide_page_num: true,
..Default::default()
});
}

fn is_cover_style_page(page: &PageContent, paragraphs: &[Paragraph]) -> bool {
if page.column_contents.len() != 1 { return false; }
let items = &page.column_contents[0].items;
if items.len() != 1 { return false; }
let (para_idx, ctrl_idx) = match &items[0] {
PageItem::Table { para_index, control_index } => (*para_index, *control_index),
_ => return false,
};
let Some(para) = paragraphs.get(para_idx) else { return false; };
let Some(Control::Table(t)) = para.controls.get(ctrl_idx) else { return false; };
!t.common.treat_as_char
}
```

`page.page_hide.is_none()` 가드로 기존 PageHide 컨트롤 우선. 매칭 시 `hide_page_num=true` 만 설정.

검증

신규 통합 테스트 (5건)

테스트	페이지 구성	결과
`test_639_aift_page2_cover_style_no_page_number`	items=1, Table 35×27, tac=false	PASS (footer 글리프 0)
`test_639_aift_page3_cover_style_no_page_number`	items=1, Table 14×17, tac=false	PASS (footer 글리프 0)
`test_639_aift_page1_shows_page_number`	items=2 (회귀 가드)	PASS (footer 글리프 3)
`test_639_aift_page6_shows_page_number`	items=18 (회귀 가드)	PASS (footer 글리프 3)
`test_639_aift_page74_tac_true_table_shows_page_number`	items=1 + tac=true (회귀 가드)	PASS (footer 글리프 4)

검출 패턴: SVG 의 `<text y="1079.16" font-size="10">` 글리프 카운트.

174 샘플 룰 매칭 재확인

```
Total pages matching rule (items=1 + Table + tac=false): 2
aift.hwp page 2
aift.hwp page 3
```

Task #637 사전 조사 결과와 정확 일치. 174 샘플 중 영향 페이지 2 만.

전체 회귀 검증

• `cargo test --release`: 1139 lib + 76+ 통합 테스트 PASS, 0 failed
• `cargo clippy --release`: warning 0
• aift.hwp 페이지 카운트 77 무변화

회귀 위험 평가

항목	영향
라운드트립	0 (page_hide 는 렌더 시점 derived state)
HWPX 호환성	0 (파서 변경 없음)
페이지 분할	0 (페이지 카운트 무변화)
header/footer	0 (hide_page_num 만 설정)
PageNumberAssigner	0 (page_hide 와 page_number 별도)
다른 173 샘플	0 (전수 조사 0건 매칭)

메모리 룰 준수

• rule_not_heuristic: 명시적 비트/카운트 조합 (`treat_as_char=false + items=1 + 단일 단 + 완전 Table`). 휴리스틱 임계값 미도입.
• essential_fix_regression_risk: cargo test sweep + 174 샘플 전수 조사로 회귀 0 확정.
• pdf_not_authoritative: IR 기반 검증 (page_hide → SVG footer 글리프).

Test plan

• cargo build --release 통과
• cargo test --release 1139+76 PASS, 0 failed
• cargo clippy --release warning 0
• Stage 1 RED 5건 → Stage 2 GREEN 5건 전환
• 174 샘플 룰 매칭 = aift p2, p3 만 (Task 한컴 호환: aift.hwp 페이지 2, 3 (큰 표만 있는 cover-style) 쪽번호 미표시 메커니즘 분석 #637 일치)
• aift.hwp 페이지별 footer 글리프 확인 (p1=3, p2=0, p3=0, p4=0, p5=0, p6=3, p74=4)
• aift.hwp 페이지 카운트 77 무변화

산출물 (mydocs/)

• `plans/task_m100_639.md` (수행계획서)
• `plans/task_m100_639_impl.md` (구현계획서)
• `working/task_m100_639_stage1.md` (Stage 1 RED)
• `working/task_m100_639_stage2.md` (Stage 2 GREEN)
• `working/task_m100_639_stage3.md` (Stage 3 회귀 검증)
• `report/task_m100_639_report.md` (최종 보고서)

🤖 Generated with Claude Code

[planet6897]

PR #640 supersede 확정

작업지시자 결정 (α — 분석+fix 함께 머지) 에 따라 PR #640 (Task #637 분석) 을 close 하고
본 PR 로 통합. 본 PR 머지 시:

• closes 한컴 호환: cover-style 페이지 (items=1 + 완전한 Table + tac=false) 자동 쪽번호 미표시 #639 (fix issue)
• closes 한컴 호환: aift.hwp 페이지 2, 3 (큰 표만 있는 cover-style) 쪽번호 미표시 메커니즘 분석 #637 (이미 issue 자체는 close 되어있음, PR 통합으로 분석 docs도 머지)

10 커밋 (5 task637 + 5 task639) 단일 머지로 한컴 호환 cover-style fix 완료.