feat(mdx-storage): Phase3 Task3.1 링크 리졸버 검증 파이프라인 정렬

[jk-kim0]

Summary

• PR docs(mdx-storage): MDX 내부 링크 → ac:link 변환 구현 계획서 #785 계획서 기준으로 link resolver/verify 파이프라인 인터페이스를 정렬합니다.
• --pages-yaml 기반 resolver 주입 경로를 verify CLI에 추가합니다.
• PageEntry, load_pages_yaml, set_current_page를 도입해 상대 경로(../) 해석 기반을 보강합니다.

Changes

• confluence-mdx/bin/mdx_to_storage/link_resolver.py
  • PageEntry dataclass 추가
  • load_pages_yaml() 추가
  • set_current_page() 추가
  • 현재 페이지 기준 상대경로(./, ../) 해석 로직 추가
• confluence-mdx/bin/mdx_to_storage/inline.py
  • convert_heading_inline(..., link_resolver=...) 지원
• confluence-mdx/bin/mdx_to_storage/emitter.py
  • emit_document(blocks, link_resolver=None) 시그니처 추가
  • heading 변환 시 resolver 전달
• confluence-mdx/bin/reverse_sync/mdx_to_storage_xhtml_verify.py
  • resolver 주입 가능한 fragment/verify 함수 시그니처 확장
  • verify_testcase_dir()에서 set_current_page(case_id) 호출
• confluence-mdx/bin/mdx_to_storage_xhtml_verify_cli.py
  • --pages-yaml 옵션 추가
  • resolver 생성 후 verify_testcase_dir(..., link_resolver=...) 전달
• confluence-mdx/bin/mdx_to_storage/__init__.py
  • PageEntry, load_pages_yaml export 추가

Test plan

• pytest -q confluence-mdx/tests/test_mdx_to_storage/test_link_resolver.py confluence-mdx/tests/test_mdx_to_storage/test_inline.py confluence-mdx/tests/test_mdx_to_storage/test_emitter.py confluence-mdx/tests/test_mdx_to_storage_xhtml_verify.py confluence-mdx/tests/test_mdx_to_storage_xhtml_verify_cli.py — 107 passed
• verify CLI --pages-yaml 옵션 전달 및 resolver 생성 검증
• set_current_page() 호출 검증 (StubResolver 테스트)
• 상대경로(../sibling) 해석 검증
• heading inline에서 link resolver 전달 검증

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
querypie-docs	Ready	Preview, Comment	Feb 16, 2026 6:19pm