confluence-mdx: reverse-sync 대체 계획 문서를 추가합니다

[jk-kim0]

요약

• 기존 reverse-sync phase 계획 문서를 대체하는 새 replacement plan을 유지·확장합니다.
• 기존 계획/리뷰/cleanup 문서 3개에 superseded 안내를 두고, 새 plan을 기준 문서로 삼습니다.
• 이번 업데이트에서는 visible segment 기반 planner 방향과 실제 코드 분해 초안까지 함께 문서화했습니다.

이번 PR에서 합의/반영된 핵심 방향

• capability registry naming을 유지합니다.
• planner / strategy / proof 3계층 분리를 실제 코드 정리의 중심축으로 둡니다.
• table은 지원 확대보다 boundary 명시와 verifier normalization 보정을 우선합니다.
• pages.yaml는 reverse-sync 관점에서 reference metadata catalog로 유지합니다.
• verifier taxonomy는 Accept / Review / Block / Error 중심으로 더 세부적으로 분류합니다.
• text-bearing block은 visible segment -> edit sequence -> XHTML node operation 흐름을 목표 설계로 채택하되, apply 계층은 기존 patch/DOM/sidecar 체계를 유지합니다.

핵심 변경

• confluence-mdx/docs/plans/2026-04-25-reverse-sync-replacement-plan.md
  • 현재 코드 기준의 기준선 정리
  • capability registry 중심 계획
  • planner / strategy / proof 3계층 제안
  • table boundary, verifier taxonomy, fixture inventory 정리 방향 제안
  • visible segment planner와 XHTML node operation 계층 추가
  • 초기 모듈 분해 초안 추가
  • 초기 함수 시그니처 초안 추가
  • 초기 테스트 파일 배치안 추가
• 기존 plan 문서 3개
  • superseded 상태 및 대체 문서 링크 추가

초기 코드 분해 초안

• planner types
  • confluence-mdx/bin/reverse_sync/planner_types.py
• visible planner
  • confluence-mdx/bin/reverse_sync/visible_planner.py
• node operation 모델
  • confluence-mdx/bin/reverse_sync/node_operations.py
• lowering 계층
  • confluence-mdx/bin/reverse_sync/operation_lowering.py
• strategy dispatcher
  • confluence-mdx/bin/reverse_sync/strategy_dispatcher.py
• strategy 모듈
  • confluence-mdx/bin/reverse_sync/strategies/{list,text_block,preserved_anchor,container,table}_strategy.py

리뷰 포인트

1. VisibleEditSequence를 planner의 표준 산출물로 두는 방향이 적절한지
2. visible segment -> edit sequence -> XHTML node operation 흐름을 paragraph / heading / list의 공통 planning 언어로 삼는 것이 적절한지
3. lowering 계층과 strategy 계층의 책임 경계를 이 정도로 나누는 것이 적절한지
4. sidecar/template-preserving fallback을 apply 이전 전략 계층에 남겨두는 방식이 적절한지
5. 제안한 테스트 파일 배치가 planner / lowering / strategy / proof 분리를 반영하기에 충분한지

검증

• 문서 변경만 수행했습니다.
• 코드/테스트 실행은 하지 않았습니다.

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
querypie-docs	Ready	Preview, Comment	Apr 26, 2026 5:02am