confluence-mdx: reverse-sync lifecycle 가이드를 갱신합니다

[jk-kim0]

Summary

repository의 reverse-sync skill과 CLI help를 현재 offline diagnostic / online manifest publish lifecycle에 맞춥니다.

• offline verify/debug가 diagnostic이며 push_eligible=false임을 명확히 합니다.
• push --dry-run, inline publish, explicit push --manifest의 차이를 설명합니다.
• immutable run artifact, manifest integrity, preflight, postcondition, --yes 경계를 문서화합니다.
• batch schema v1의 partial success, exit code, not_attempted, resume_manifests를 추가합니다.
• 지원 상태와 stable reason code, canary 이전 production batch 금지를 반영합니다.
• 존재하지 않는 var/pages.yaml과 --xhtml 안내를 현재 pages.qm.yaml, --page-id, --page-dir로 수정합니다.
• branch mode에서 이전에는 조용히 무시되던 --page-id와 --page-dir를 fail-fast로 거부합니다.

OpenSpec

• 기준 change: openspec/changes/complete-reverse-sync
• 완료: .agents/skills/reverse-sync/SKILL.md의 current lifecycle/artifact 경로 동기화
• accepted spec 승격과 historical plan archive는 canary/P1 완료 후 별도로 남습니다.

Safety impact

• offline pass를 publish 가능한 proof로 오해하지 않도록 합니다.
• flat compatibility artifact를 publisher 입력으로 안내하지 않습니다.
• --yes가 safety gate를 우회한다는 오해를 막습니다.
• branch에서 적용되지 않는 page option을 성공한 것처럼 보이지 않고 실행 전에 차단합니다.

Test plan

• 전체 Python test: 1117 passed, 2 skipped
• reverse-sync Python test: 794 passed
• make test-reverse-sync: golden 16 passed, regression 43 passed
• openspec validate complete-reverse-sync --strict
• stale pages.yaml/--xhtml reference search
• git diff --check
• Python compileall

Stack

• Base: confluence-mdx: reverse-sync capability 차단 사유를 정규화합니다 #1036
• Batch report: confluence-mdx: reverse-sync batch 결과 계약을 명시합니다 #1035
• Explicit manifest publish: confluence-mdx: reverse-sync manifest push를 명시화합니다 #1034
• Typed plan: confluence-mdx: reverse-sync typed plan 경계를 도입합니다 #1033
• Strict provenance identity: confluence-mdx: reverse-sync target identity를 엄격하게 검증합니다 #1032
• Input/dependency gates: confluence-mdx: reverse-sync 입력 정합성을 검증합니다 #1031
• Strict proof: confluence-mdx: reverse-sync local proof를 엄격하게 검증합니다 #1030
• Publisher foundation: confluence-mdx: reverse-sync push 안전성을 강화합니다 #1029
• 선행 PR merge 후 base를 순차적으로 main으로 변경할 수 있습니다.

🤖 Generated with Codex

Co-Authored-By: Atlas atlas@jk.agent

[vercel]

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

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