본질:
- Stage 2a 시도 (LineSeg::is_in_wrap_zone 단독 판정) test_547 회귀로 revert.
  HWP5 native passage box 본문 LineSeg cs=852/sw=30184 가 false-positive 판정
  → cs/sw 만으로는 wrap zone 과 box inset 구분 불가능.
- R3 본질 채택: typeset.rs 의 wrap_around state machine 매칭 결과 (anchor ↔ wrap
  text 컨텍스트) 를 layout 시점까지 전달하는 메타데이터 채널 도입.

변경:
- src/renderer/pagination.rs: WrapAnchorRef struct + ColumnContent.wrap_anchors
  HashMap 필드 추가. clone 시 정합화.
- src/renderer/typeset.rs + pagination/state.rs: TypesetState/PaginationState 에
  current_column_wrap_anchors 필드 + flush 시 take.
- src/renderer/typeset.rs:495~ wrap_around 매칭 시 wrap_anchors 등록 + FullParagraph
  통과 (wrap_precomputed=true 인 경우).
- src/renderer/layout.rs: ColumnItemCtx.wrap_anchors 필드 + layout_column_item
  시그니처 + 3 destructure 사이트 정합화. PageItem::FullParagraph/PartialParagraph
  처리 7 호출 사이트에 ctx.wrap_anchors.get(para_index) 전달.
- src/renderer/layout/paragraph_layout.rs: 3 시그니처 (layout_paragraph,
  layout_partial_paragraph, layout_composed_paragraph) 에 wrap_anchor 인자 추가.
  wrap_precomputed 검사 3곳 (BoundingBox.x, x_base, line_cs_offset) →
  wrap_anchor.is_some() 검사로 교체.
- src/renderer/layout/{table_layout,table_partial,table_cell_content,shape_layout,
  picture_footnote}.rs: 셀/도형/각주/캡션 컨텍스트 호출 7곳에 None 전달.
- src/renderer/page_number.rs + layout/tests.rs: 테스트 ColumnContent 정합화.

검증:
- cargo build + cargo build --tests 통과
- cargo test --lib 1130 passed (test_547 PASS)
- cargo test --test issue_546 1 passed (exam_science 4페이지, Task edwardkim#546 정합)
- cargo test --test issue_554 12 passed
- cargo test 통합 31 모두 통과

본질 정정 효과:
- typeset 의 매칭 결과가 layout 시점까지 보존 — 포맷 무관 일관 처리
- layout 의 wrap zone 판정이 Paragraph IR 의존성 제거 — IR 정합화 진전

잔존 부채 (Stage 2b 영역):
- Paragraph.wrap_precomputed 필드 잔존 (typeset.rs:502 매칭 분기 조건)
- HWP3 파서 후처리 30 LOC 잔존 (mod.rs:1556~)
- Stage 2b 에서 anchor 종류 기반 분기로 교체 + IR 청산 예정

수행/구현 계획서 + 단계별 보고서 동봉.

… 부채 마무리)

본질:
- Stage 2 의 wrap_anchors 메타데이터 채널 도입 후, Paragraph.wrap_precomputed 필드
  제거 + HWP3 파서 후처리 30 LOC 청산. typeset.rs 매칭 분기를 anchor 종류 (Picture vs
  Table) 기반으로 본질화.
- HWP3 휴리스틱이 IR 에 누설되었던 wrap_precomputed 플래그를 청산. IR 의 포맷 독립성
  회복.

변경:
- src/renderer/typeset.rs:495~ 매칭 분기 본질화: anchor paragraph 의 controls 검사
  (Control::Picture / Control::Shape 안의 ShapeObject::Picture, !treat_as_char) 로
  Picture anchor 면 wrap_anchors 등록, Table anchor 면 흡수 (기존 흐름).
- src/model/paragraph.rs: wrap_precomputed 필드 제거 (struct 정의 + clone init).
- src/parser/hwp3/mod.rs: PR edwardkim#589 보완6/8 후처리 30 LOC 청산. typeset.rs + wrap_anchors
  채널로 정합 대체됨.
- src/renderer/{layout.rs, pagination.rs, layout/paragraph_layout.rs}: 잔존 주석 갱신
  (Task edwardkim#460 보완6 인용 → Task edwardkim#604 Stage 2 인용).

검증:
- cargo build + cargo build --tests 통과
- cargo test --lib 1130 passed (회귀 0)
- cargo clippy --lib -- -D warnings 0건
- cargo test --test issue_546 1 passed (Task edwardkim#546 정합)
- cargo test --test issue_554 12 passed (HWP3 변환본 정합)
- cargo test 통합 31 모두 통과

IR 부채 청산:
- IR (Paragraph) 에서 wrap_precomputed 필드 제거 — 포맷 독립성 회복
- HWP3 파서가 LineSeg cs/sw 만 정합 인코딩 책임 (별도 후처리 없음)
- typeset 의 매칭 분기 = anchor 종류 기반 본질 판정 (Picture/Table)

LOC: -53 / +30 (-23 net) 소스. 단계별 보고서 동봉.

다음: Stage 3 — HWP3 파서 cs/sw 인코딩 정정 (Issue edwardkim#604 결함 본질 정정).

…결함 본질 정정)

본질:
- hwp3-sample5.hwp page 4 의 pi=75 첫 3 줄 cs=0/sw=0 결함 본질 정정.
- 원인: src/parser/hwp3/mod.rs:1399-1407 의 wrap zone pgy 범위 검사가
  `pgy >= pgy_start && pgy < pgy_end` 양방향 가드로, wrap text 문단의 첫 줄
  pgy 가 anchor 의 pgy_start 미만 인 경우 (예: 페이지 첫 문단) cs/sw=0 설정 →
  그림 좌측 (x=56.7) 에 텍스트 그려짐 → 그림과 겹침 (Issue edwardkim#604).

정정 (옵션 3a):
- src/parser/hwp3/mod.rs: pgy_start 가드 제거. pgy_end 만 검사하는 단방향 가드.
  본질: wrap text 문단의 모든 줄은 anchor 그림 우측에 정합 배치되어야 하며,
  pgy_start 미만의 줄도 wrap zone 의 일부. 그림 아래로 흘러간 줄 (cs=0 정상 줄)
  만 pgy_end 가드로 wrap zone 외 판정.

검증:
- pi=75 모든 LineSeg cs=35460, sw=15564 정합 (이전: 첫 3 줄 cs=0/sw=0)
- cargo test --lib 1130 passed (회귀 0)
- cargo test --test issue_546 (Task edwardkim#546 exam_science 4페이지 정합)
- cargo test --test issue_554 12 passed (HWP3 변환본 정합)
- cargo test 통합 31 모두 통과
- HWP3 native pages 회귀 0 (sample 16p, sample5 64p)

시각 판정:
- output/svg/task604_after/hwp3-sample5/hwp3-sample5_004.svg page 4
  x=529 (23 인스턴스, PR edwardkim#589 baseline 20 → 23 = pi=75 첫 3 줄 추가 정합)
- page 8/16/22/27 동일 정합 (cs/sw 기반 정합 분포)

본 단계의 본질적 가치:
- Issue edwardkim#604 결함 본질 정정
- HWP3 파서의 LineSeg cs/sw 인코딩 표준 정합 (mydocs/tech/document_ir_lineseg_standard.md)
- 한컴뷰어 page 4 정합 시각

다음: Stage 4 — 광범위 회귀 검증 + 시각 판정 ★ + 최종 보고서.

본 task (Document IR 표준 정합화 + HWP3 wrap zone cs/sw 인코딩 정정) 의 최종 단계.
Stage 1~3 누적 결과 광범위 검증 + 시각 판정 자료 + 최종 결과 보고서 작성.

검증:
- cargo build + cargo build --release 통과
- cargo test --lib --release 1130 passed / 0 failed / 2 ignored
- cargo test --release 통합 31 모두 통과
- cargo clippy --lib -- -D warnings 0건

회귀 영역 (모두 정합):
- HWP3 native: hwp3-sample.hwp 16p / hwp3-sample5.hwp 64p (PR edwardkim#589 baseline 동일)
- Task edwardkim#546: exam_science.hwp 4페이지 / p2 단 0 items=37
- Task edwardkim#554 (HWP3 변환본 5개): hwp3-sample-hwp5 15p / -hwpx 15p /
  hwp3-sample4-hwp5 36p / hwp3-sample5-hwp5 64p / -hwpx 64p
- 통합 테스트 svg_snapshot 6/6, issue_546/554 통과

시각 판정 자료:
- output/svg/task604_after/hwp3-sample5/hwp3-sample5_{004,008,016,022,027}.svg
- page 4 x=529 분포: PR edwardkim#589 baseline 20 → 23개 (pi=75 첫 3 줄 추가 정합)

본질 정정 누적 효과:
- Issue edwardkim#604 결함 본질 정정 (pi=75 모든 ls cs/sw 정합)
- Document IR 표준 명문화 (mydocs/tech/document_ir_lineseg_standard.md)
- IR 부채 청산 (Paragraph.wrap_precomputed 필드 제거)
- typeset 출력 메타데이터 채널 (ColumnContent.wrap_anchors) 도입
- typeset 매칭 분기 anchor 종류 (Picture vs Table) 기반 본질화
- HWP3 파서 cs/sw 인코딩 정정 (pgy 단방향 가드)
- CLAUDE.md HWP3 파서 규칙 정합 (HWP3 휴리스틱 IR 누설 청산)

LOC 합계: +76 net (소스), +1100 (문서)

잔존 별도 task 권고:
- HWP3 폰트 크기/줄간격 처리 (한컴뷰어 13pt vs HWP5 v2024 9pt 차이)
- HWP3 LineSeg vertical_pos 누적 계산
- Task edwardkim#525 본질 재검토 (wrap_anchors 도입 후 layout_wrap_around_paras dead code 가능성)

문서:
- mydocs/report/task_m100_604_report.md (최종 보고서)
- mydocs/orders/20260505.md Task edwardkim#604 entry → 완료

…% 정합화

본질:
- HWP3 의 line_spacing_ratio (보통 160%) 가 좁은 wrap zone (예: pi=75 sw=15564HU=
  207px) 안에 적용되면 줄당 19.2px 차지 → 415자 텍스트가 38 줄 = 729px 필요 (그림
  357px 초과). 한컴 자체가 HWP3 → HWP5 변환 시 줄간격 100% 로 정정 (cf.
  hwp3-sample5-hwp5-v2024.hwp lh=900 = th).
- 본 환경 rhwp 의 HWP3 native pi=75 LineSeg lh=1440 (160%) → 한컴 변환본 lh=900
  (100%) 와 불일치. 본 정정으로 wrap zone 안 라인 lh 정합화.

정정 (옵션 B-2 — wrap zone 안 라인만 적용):
- src/parser/hwp3/mod.rs:1419~ wrap zone 안 라인 (line_cs_sw.is_some() AND cs>0)
  의 LineSeg lh 를 th (text_height) 로 강제 + line_spacing 0. wrap zone 밖 라인은
  HWP3 본질 (line_spacing_ratio) 유지 — 영향 영역 최소화.
- 결과: pi=75 모든 LineSeg lh 1440 → 900 정합 (HWP5 v2024 변환본과 동일 인코딩).

검증:
- pi=75 모든 LineSeg lh=900, th=900, ls=0 정합 (HWP5 v2024 변환본 동일)
- cargo test --lib 1130 passed (회귀 0)
- cargo test --test issue_546 1 passed (Task edwardkim#546 정합)
- cargo test --test issue_554 12 passed (HWP3 변환본 정합)
- HWP3 native: hwp3-sample.hwp 16p, hwp3-sample5.hwp 64p, hwp3-sample4.hwp 40p
  (회귀 0)

본 정정의 가치:
- HWP5 v2024 변환본과 LineSeg lh 인코딩 정합 달성.
- 좁은 wrap zone 안 라인의 줄간격이 한컴 변환 메커니즘과 동일.

잔존 시각 결함 (별도 본질, 별도 task 권고):
- pi=74 그림 anchor paragraph height = 19.2px (sequential flow) vs 그림 absolute
  layer 357px → 후속 paragraph 가 그림 영역 y 안에서 시작 → 그림 위 본문 침범.
- 정정 본질 = pi=74 그림을 absolute layer (paper-relative) 로 분리 처리. 본 task
  scope 외 — layout.rs is_paper_based 검사 (vert_rel_to=Paper && horz_rel_to=Paper)
  영역 본질 변경 필요.

본질:
- Stage 5 B-2 의 lh 정합화 후 추가 검증 — 본문이 cs/sw=정합 wrap zone 안에
  표시되지만 일부 라인이 그림 영역 (sequential flow y) 에 침범. 결함의 본질 =
  paper_images z-order 가 body_node 보다 아래 layer.

정정:
- src/renderer/layout.rs: tree.root.children push 순서 정정.
  Before: paper_images → body_node (그림이 bottom layer)
  After:  body_node → paper_images (그림이 top layer)
- 본문이 sequential flow y 로 그림 영역까지 흐르더라도 그림이 위에 그려져 시각
  정합. 한컴 v2018/v2024 변환본 정합.

검증:
- cargo build + cargo test --lib 1130 passed (회귀 0)
- cargo test --test issue_546 1 passed (Task edwardkim#546 정합)
- cargo test --test issue_554 12 passed
- cargo test 통합 31 모두 통과
- HWP3 native: hwp3-sample.hwp 16p, hwp3-sample5.hwp 64p, hwp3-sample4.hwp 40p
  (회귀 0)

시각 판정:
- output/svg/task604_stage6_b/hwp3-sample5/_{004,008,016,022,027}.svg
- 사용자 시각 판정 (HWP3 native vs HWP5 변환본 비교): 거의 정합 ★

한컴 변환 메커니즘 정합 본질 (Stage 5 B-2 + Stage 6 결합):
- Stage 3: LineSeg cs/sw 정확 인코딩 (wrap zone 위치 정합)
- Stage 5 B-2: LineSeg lh 100% 줄간격 (좁은 wrap zone 안 글자 수용)
- (기존): 그림 paper-relative absolute layer (sequential flow 와 분리)
- Stage 6: 그림 top z-layer (본문 침범 시 시각 가림)

문서:
- mydocs/working/task_m100_604_stage6.md (Stage 6 단계별 보고서)

본질 (작업지시자 통찰 정합):
- Document IR 표준 정합화 = 더 큰 목적
- HWP5 v2024 변환본 정밀 분석 후 IR 표준 미명시 영역 발견:
  1. paragraph 내 LineSeg cs/sw 전환 (wrap zone 끝 시 cs=0)
  2. paragraph 간 vpos 연결 (next.vpos = prev.last.vpos + lh + ls)
- HWP3 파서 정합 인코딩으로 시각 결함 자연스럽게 정정.

Stage A — IR 표준 갱신:
- mydocs/tech/document_ir_lineseg_standard.md 갱신
- HWP5 v2024 page 4 pi=75 LineSeg 실측 데이터 표 추가
- paragraph 내 cs/sw 전환 본질 명문화
- paragraph 간 vpos 연결 알고리즘 명문화

Stage D — HWP3 파서 정합 인코딩 (src/parser/hwp3/mod.rs):
- parse_paragraph_list 외부에 acc_section_vpos, wrap_zone_end_vpos 누적 변수
- paragraphs.push 직전 후처리:
  * 페이지 break 시 vpos reset
  * Picture Square wrap anchor 검출 → wrap_zone_end_vpos = acc + total_height
  * LineSeg vpos = acc 누적 인코딩
  * paragraph 내 cs=0 전환 (vpos >= wrap_zone_end 시)
  * paragraph 간 vpos 연결
- Stage 5 B-2 (wrap zone 안 lh=th 강제) revert — HWP3 본질 (lh=1440/ls=0) 유지

검증:
- pi=75 ls[19] vpos=28800 cs=0 sw=0 (HWP5 v2024 변환본과 정합)
- cargo test --lib 1130 passed
- Task edwardkim#546 정합 (exam_science 4페이지 / items=37)
- HWP3 native 회귀: hwp3-sample 16 (0), hwp3-sample5 64→67 (+3),
  hwp3-sample4 39→40 (+1)
- Stage 7+8 시도 대비 회귀 영역 큰 폭 축소

잔존 (Stage E 영역):
- HWP3 native +3 페이지 회귀 (issue_554 test fail)
- 일부 typeset/layout vpos 처리 정합화 검증

문서:
- mydocs/working/task_m100_604_stageAD.md
- mydocs/plans/task_m100_604.md (수행계획서 본질 갱신)

본 commit 으로 Document IR 표준 정합화 본질 영역 도달.

정정 영역 (src/parser/hwp3/mod.rs):
1. is_page_break 영역 보강 — prev_para_had_flags_break + first_pgy_here=0 케이스
2. lh/ls HWP5 분리 인코딩 — lh=th, ls=th*(ratio-100)/100 (시각 줄 높이 정합)
3. break_flag → tag bit 누설 제거 — tag=0x00060000 고정
4. pgy-based column_type=Page 설정 제거 — 자연 wrap 은 typeset 책임
5. wrap zone cs/sw 정합 인코딩 — anchor 의 active_wrap_cs_sw 후속 paragraph 정합 채움
6. paper-top anchor acc_vpos reset — paper-relative + body top 영역 anchor 의 vpos=0 정합
7. line_info.break_flag 0x8001 (페이지 경계) → column_type=Page 변환

회귀 영역 (HWP5 변환본 baseline 정합):
| 파일 | baseline | 정정 결과 |
|------|---------|-----------|
| hwp3-sample.hwp | 16 | 16 |
| hwp3-sample4.hwp | HWP5 36 | 36 (paragraph 시퀀스 정합) |
| hwp3-sample5.hwp | HWP5 64 | 65 (+1 orphan, page 43 pi=1240 line 2) |
| exam_science.hwp | 4 | 4 (Task edwardkim#546 정합) |

결정적 검증:
- cargo test --lib: 1130 passed
- cargo test --test svg_snapshot: 6/6 (HWP5 native 회귀 0)
- cargo test --test issue_546: 정합
- cargo test --test issue_554: 11/12 (sample5 65 vs expect 64, sample.hwp 16 정합)

본질 정합:
- pi=74 picture page 4 / vpos=0 (HWP5 정합)
- pi=75 ls[0..18] cs=35460/sw=15564 (wrap zone 인코딩 정합)
- pi=75 ls[19..20] cs=0/sw=0 (wrap zone 끝 전환)
- sample4 page 33+34 paragraph-by-paragraph HWP5 정합

Closes part of Issue edwardkim#604 (Document IR 표준 정합화 본질 영역).

본 정정으로 sample5.hwp 64 페이지 HWP5 baseline 완전 정합 달성.

본질 정정 영역 (src/parser/hwp3/mod.rs):
- Stage A+D 후처리의 LineSeg 영역에서 line_infos[i].pgy < line_infos[i-1].pgy 검출 시 acc_vpos reset
- 본 신호는 HWP3 한글97 layout 시점에 본 line 부터 새 페이지 시작 영역
- HWP5 v2024 변환본의 paragraph 내 ls[i].vpos=0 영역 정합

검증 영역 (pi=1213 sample5):
- ls[0] vpos=72000 (HWP5 정합)
- ls[1] vpos=0 (새 페이지 reset, HWP5 정합)
- ls[2] vpos=1440 (HWP5 정합)
- ls[3] vpos=2880 (HWP5 정합)

회귀 영역 (HWP5 변환본 baseline 완전 정합):
| 파일 | baseline | 정정 결과 |
|------|---------|-----------|
| hwp3-sample.hwp | 16 | 16 |
| hwp3-sample4.hwp | HWP5 36 | 36 |
| hwp3-sample5.hwp | HWP5 64 | 64 |
| exam_science.hwp | 4 | 4 |

결정적 검증:
- cargo test --lib: 1131 passed
- cargo test --test svg_snapshot: 6/6
- cargo test --test issue_546: 정합
- cargo test --test issue_554: 12/12 (모든 fixture 정합)

Closes part of Issue edwardkim#604 (Document IR 표준 정합화 본질 영역).

- mydocs/working/task_m100_604_stageD2.md (신규): Stage D-2 영역 8개 정정 본질 + 결정적 검증
- mydocs/report/task_m100_604_report.md: §3 Stage A+D+D-2 영역 추가 (본 task 본질 영역 도달)
- mydocs/orders/20260505.md: Issue edwardkim#604 영역 11 commits + HWP3/HWP5/HWPX 3개 포맷 정합 영역 갱신

Document IR 표준 정합화 본질 영역 완전 도달:
- HWP3 / HWP5 / HWPX 3개 포맷 변환본 모두 동일 페이지 수 (16/36/64/4)
- LineSeg 영역 본질 정합 (pi=74/75/1213 HWP5 v2024 변환본 정합)
- paragraph 시퀀스 정합 (sample4 page 33+34)
- orphan 페이지 0 + 모든 회귀 영역 정합