Skip to content

fix(reverse-sync): frontmatter 제외 비교 및 마크다운 링크 정규화로 verify 실패 수정#650

Merged
jk-kim0 merged 1 commit intomainfrom
jk/fix-verify-frontmatter-and-link-normalize
Feb 10, 2026
Merged

fix(reverse-sync): frontmatter 제외 비교 및 마크다운 링크 정규화로 verify 실패 수정#650
jk-kim0 merged 1 commit intomainfrom
jk/fix-verify-frontmatter-and-link-normalize

Conversation

@jk-kim0
Copy link
Copy Markdown
Contributor

@jk-kim0 jk-kim0 commented Feb 10, 2026

Summary

  • frontmatter 제외 비교: run_verify()에서 roundtrip 비교 전 양쪽 MDX의 frontmatter를 strip하여, forward converter가 주입하는 confluenceUrl 등 메타데이터 차이로 인한 false FAIL 제거
  • 마크다운 링크 정규화: _normalize_mdx_to_plain()[text](url) → text 규칙 추가하여, html_block 테이블 내 링크가 포함된 텍스트도 XHTML get_text()와 올바르게 매핑되도록 수정

근본 원인

Issue 원인 수정
confluenceUrl frontmatter diff forward converter가 page.v1.yaml에서 읽어 무조건 삽입 → reverse-sync 패칭 범위 밖 _strip_frontmatter() 헬퍼로 비교 전 제거
html_block 테이블 패치 누락 _normalize_mdx_to_plain()[text](url) 패턴을 제거하지 않아 XHTML plain text와 불일치 → 매핑 실패 링크 제거 정규식 추가

변경 파일

  • confluence-mdx/bin/reverse_sync_cli.py_strip_frontmatter() 헬퍼 추가, run_verify() 비교 전 strip 적용, _normalize_mdx_to_plain() 링크 정규화 추가
  • confluence-mdx/tests/test_reverse_sync_cli.py — 4개 테스트 추가

Test plan

  • pytest tests/test_reverse_sync_cli.py — 37 passed
  • pytest tests/ — 175 passed, 1 pre-existing e2e failure (unrelated)
  • reverse_sync_cli.py verify --branch jk/fix-typo-and-grammar --limit 5 실행하여 실제 verify 결과 확인

🤖 Generated with Claude Code

verify가 두 가지 원인으로 FAIL하던 문제를 수정:
1. forward converter가 주입하는 confluenceUrl frontmatter 차이 → 비교 전 frontmatter strip
2. html_block 테이블 내 마크다운 링크가 정규화되지 않아 매핑 실패 → 링크 제거 규칙 추가

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Feb 10, 2026

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

Project Deployment Actions Updated (UTC)
querypie-docs Ready Ready Preview, Comment Feb 10, 2026 0:55am

Request Review

@jk-kim0 jk-kim0 self-assigned this Feb 10, 2026
@jk-kim0 jk-kim0 merged commit eba53d1 into main Feb 10, 2026
7 checks passed
@jk-kim0 jk-kim0 deleted the jk/fix-verify-frontmatter-and-link-normalize branch February 10, 2026 13:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant