Skip to content

confluence-mdx: reverse-sync 현재 아키텍처를 동기화합니다#1050

Open
jk-kim0 wants to merge 1 commit into
jk/docs-reverse-sync-p2-decisionsfrom
jk/docs-reverse-sync-current-architecture
Open

confluence-mdx: reverse-sync 현재 아키텍처를 동기화합니다#1050
jk-kim0 wants to merge 1 commit into
jk/docs-reverse-sync-p2-decisionsfrom
jk/docs-reverse-sync-current-architecture

Conversation

@jk-kim0

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

Copy link
Copy Markdown
Contributor

Summary

현재 구현된 reverse-sync의 snapshot-bound verification과 manifest-bound publish lifecycle을 architecture 문서에 동기화합니다.

  • 로컬 diagnostic과 원격 PageSnapshot 기반 online prepare/publish 경로를 구분합니다.
  • typed PatchPlan v2, preservation renderer, local proof, immutable run artifact의 책임과 상태를 기록합니다.
  • explicit manifest publisher의 preflight, active draft/dependency gate, version-bound PUT, postcondition을 문서화합니다.
  • CLI 명령, runtime artifact tree, safety invariant를 실제 service/module 이름에 맞춥니다.
  • OpenSpec cleanup task의 architecture 경로를 실제 파일 위치로 바로잡고 완료 처리합니다.

Verification

  • openspec validate complete-reverse-sync --strict
  • git diff --check
  • python confluence-mdx/bin/reverse_sync_cli.py --help
  • manifest 필수 artifact와 stale architecture 용어 targeted search

Stack

🤖 Generated with Codex

로컬 진단과 원격 snapshot 기반 온라인 lifecycle을 분리하여 문서화합니다.

immutable manifest, typed plan, local proof, version-bound publish와 postcondition 불변조건을 현재 구현에 맞게 반영합니다.
@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 2:41pm

Request Review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 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]` | 브랜치 대상을 온라인 검증하고 순차 발행. 첫 실패에서 중단 |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge 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 👍 / 👎.

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