confluence-mdx: reverse-sync 현재 아키텍처를 동기화합니다#1050
Conversation
로컬 진단과 원격 snapshot 기반 온라인 lifecycle을 분리하여 문서화합니다. immutable manifest, typed plan, local proof, version-bound publish와 postcondition 불변조건을 현재 구현에 맞게 반영합니다.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 96131e6f1e
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| | `reverse_sync_cli.py push <mdx>` | 원격 snapshot 기반 검증 후 확인을 거쳐 단일 manifest 발행 | | ||
| | `reverse_sync_cli.py push --manifest <manifest.json>` | 이미 검증한 immutable run을 명시적으로 발행 | | ||
| | `reverse_sync_cli.py verify --branch <branch>` | 브랜치의 변경된 한국어 MDX를 로컬 배치 진단 | | ||
| | `reverse_sync_cli.py push --branch <branch> [--dry-run]` | 브랜치 대상을 온라인 검증하고 순차 발행. 첫 실패에서 중단 | |
There was a problem hiding this comment.
Clarify branch push failure behavior
For push --branch runs, this description says the batch stops at the first failure, but run_batch continues after verification failures, version conflicts, and generic publish errors; it only breaks on postcondition_failed while later pushable pages can still be published. Operators relying on this CLI table could assume a conflict/error prevents subsequent Confluence updates when it does not, so the docs should state the actual partial-publish semantics. The repository also requires docs and implementation to stay aligned.
AGENTS.md reference: AGENTS.md:L7-L9
Useful? React with 👍 / 👎.
Summary
현재 구현된 reverse-sync의 snapshot-bound verification과 manifest-bound publish lifecycle을 architecture 문서에 동기화합니다.
PageSnapshot기반 online prepare/publish 경로를 구분합니다.PatchPlanv2, preservation renderer, local proof, immutable run artifact의 책임과 상태를 기록합니다.Verification
openspec validate complete-reverse-sync --strictgit diff --checkpython confluence-mdx/bin/reverse_sync_cli.py --helpStack
🤖 Generated with Codex