Skip to content

confluence-mdx: compatibility artifact를 run에 결합합니다#1045

Open
jk-kim0 wants to merge 1 commit into
jk/refactor-reverse-sync-validated-patcherfrom
jk/fix-reverse-sync-compatibility-artifacts
Open

confluence-mdx: compatibility artifact를 run에 결합합니다#1045
jk-kim0 wants to merge 1 commit into
jk/refactor-reverse-sync-validated-patcherfrom
jk/fix-reverse-sync-compatibility-artifacts

Conversation

@jk-kim0

@jk-kim0 jk-kim0 commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Summary

online prepare가 남기는 flat compatibility output을 독립 복사본이 아니라 최신 immutable run을 가리키는 read-only bridge로 제한합니다.

  • reverse-sync.patched.xhtml, reverse-sync.plan.json, reverse-sync.proof.json, reverse-sync.manifest.json을 run artifact의 상대 symlink로 갱신합니다.
  • compatibility 갱신 전에 manifest run ID, page directory, target containment를 검증합니다.
  • 임시 symlink를 원자 교체하여 여러 compatibility 경로가 최신 성공 run을 가리키도록 합니다.
  • publisher fallback이 제거된 reverse-sync.manifest.path pointer를 더 이상 생성하지 않습니다.
  • offline diagnostic의 diff/result/mapping/verify 파일은 push 비대상 compatibility output으로 유지합니다.

Impact

  • online prepare 후 flat 파일과 immutable manifest candidate가 서로 달라질 수 있는 복사본 drift를 제거합니다.
  • publisher는 계속 explicit manifest_path만 사용하므로 compatibility output이 push authority를 갖지 않습니다.
  • Confluence PUT이나 production batch는 실행하지 않았습니다.

OpenSpec / stacked PR

  • 기준 change: openspec/changes/complete-reverse-sync
  • 수행 task: P0 run-backed reverse-sync.* read-only compatibility output
  • Base PR: confluence-mdx: validated patcher 경계를 분리합니다 #1044
  • 열린 PR diff를 확인했으며 같은 artifact bridge를 다루는 중복 PR은 없습니다.
  • CLI orchestration 축소와 P2 capability 확대는 이번 PR에서 제외합니다.
  • reviewer 결정과 canary 승인이 필요한 항목은 변경하지 않았습니다.

Test plan

  • push transaction/CLI focused tests — 159 passed
  • cd confluence-mdx && venv/bin/pytest -q tests/test_reverse_sync*.py — 793 passed
  • cd confluence-mdx && venv/bin/pytest -q — 1146 passed, 2 skipped
  • cd confluence-mdx/tests && make test-reverse-sync — golden 16 passed, regression 43 passed
  • cd confluence-mdx/tests && make test-convert — 21 passed
  • cd confluence-mdx/tests && make test-byte-verify — fast/splice 각각 21/21 passed
  • openspec validate complete-reverse-sync --strict
  • git diff --check

Related tickets & links

🤖 Generated with Codex

## Summary
online prepare의 flat compatibility output을 immutable run에 결합합니다.

- patched XHTML, patch plan, local proof, manifest를 상대 symlink로 노출합니다.
- compatibility output 갱신 시 page/run identity와 target 경계를 검증합니다.
- 폐기된 reverse-sync.manifest.path pointer 생성을 제거합니다.
- 최신 run 전환과 offline diagnostic 분리 계약을 테스트합니다.
- OpenSpec task와 전체 regression 결과를 갱신합니다.

🤖 Generated with Codex

Co-Authored-By: Atlas <atlas@jk.agent>
@vercel

vercel Bot commented Jul 24, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
querypie-docs Ready Ready Preview, Comment Jul 24, 2026 1:47pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant