confluence-mdx: folder 저장 및 MDX 변환을 지원합니다 - #1051
Merged
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 9f48c8ae48
ℹ️ 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".
jk-kim0
added a commit
that referenced
this pull request
Jul 27, 2026
Confluence page 계층의 folder를 저장하고 MDX landing page로 변환할 수 있도록 지원합니다. - page와 folder를 구분하는 typed content tree와 cursor pagination을 구현합니다. - folder 직계 자식 목록, navigation, generated output manifest를 생성합니다. - unsupported content type과 folder reverse sync를 안전하게 차단합니다. - OpenSpec 계약과 fetch 및 conversion 회귀 테스트를 추가합니다. 🤖 Generated with Codex Co-Authored-By: Atlas <atlas@jk.agent>
10 tasks
## Summary ephemeral container에서 manifest persistence와 atomic replace를 함께 보장합니다. - profile manifest를 전용 directory로 이동하고 directory 단위로 bind mount합니다. - 개별 file mount의 mount point 교체 위험을 OpenSpec 계약에 반영합니다. - Compose mount와 profile별 baseline 경로를 회귀 테스트로 검증합니다. 🤖 Generated with Codex
jk-kim0
force-pushed
the
jk/feat-confluence-folder-mdx
branch
from
July 27, 2026 08:58
d5fada8 to
42dff22
Compare
## Summary 공유 output root에서 sync profile 간 현재 출력 경로 충돌을 생성 전에 차단합니다. - full-all이 모든 profile catalog를 먼저 갱신한 뒤 변환하도록 순서를 조정합니다. - sibling catalog의 출력 계획과 겹치는 경로를 preflight에서 거부합니다. - 소유권 이전, stable collision, 실행 순서를 회귀 테스트와 OpenSpec 계약에 반영합니다. 🤖 Generated with Codex
jk-kim0
added a commit
that referenced
this pull request
Jul 28, 2026
## Summary QM Confluence Space의 전체 page/folder 계층과 다국어 문서를 최신 상태로 동기화하고, 표시용 영어 제목과 canonical route를 독립적으로 유지합니다. - MCP Access Control, MCP Server, Audit MCP folder와 하위 문서를 ko/en/ja에 추가합니다. - MongoDB / Document DB Privilege Type Mapping과 운영 로그 수집 가이드를 추가합니다. - Premium Support 이메일과 navigation 순서를 최신 Confluence와 맞춥니다. - `current`가 아닌 child를 fetch, catalog, navigation에서 제외합니다. - content ID 기반 slug override를 도입해 정확한 영어 breadcrumb와 기존 public route를 함께 보존합니다. - `Web Client로 쿠버네티스 클러스터 접속하기`의 영어 제목을 `Connecting to Kubernetes Clusters with Web Client`로 복원하면서 경로는 `web-client`로 유지합니다. - typed catalog와 QM manifest, OpenSpec 계약 및 회귀 테스트를 갱신합니다. ## Test plan - [x] `confluence-mdx/bin/fetch_cli.py --remote --attachments` - [x] `confluence-mdx/bin/fetch_cli.py --local --sync-code qm` - [x] QM 전체 변환 315개 성공 및 manifest 경로 유지 확인 - [x] `confluence-mdx/bin/convert_all.py --verify-translations` - [x] `pytest -q tests/test_fetch_folders.py tests/test_convert_all_folders.py` (`26 passed`) - [x] `pytest -q -k 'not test_sample_page'` (`1,187 passed, 1 deselected`) - [x] 변경 문서 22건 Skeleton MDX 비교 - [x] `npm run build -- --webpack` (953 URLs) - [x] `openspec validate confluence-folder-mdx --strict` - [x] `git diff --check` ## Notes - tracked `confluence-mdx/var/pages.qcp.yaml`이 0바이트여서 current cross-profile preflight가 YAML `null`을 거부합니다. QM 전체 변환 검증에서는 이 빈 sibling catalog만 일시적으로 제외한 뒤 원상 복원했으며 QCP 파일은 변경하지 않았습니다. - `tests/test_unused_attachments.py::TestRealData::test_sample_page`는 로컬 실제 데이터에 미사용 첨부파일 1개가 있다고 가정하지만 현재 `var/1060306945`에서는 0개를 반환합니다. 이번 변경과 연결된 테스트는 모두 통과했으며 해당 환경 의존 assertion만 제외해 전체 suite를 재검증했습니다. ## Related tickets & links - #1051 🤖 Generated with Codex Co-Authored-By: Atlas <atlas@jk.agent> --------- Co-authored-by: Atlas <atlas@jk.agent>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Confluence page 계층에서 누락되던 folder를 원본 API 응답으로 저장하고, 직계 자식 목록을 제공하는 MDX landing page로 변환합니다.
문제 현상
구현 내용
var/{folder_id}/folder.v2.yaml과children.v2.yaml에 저장합니다._meta.ts생성을convert_all.py로 일원화하고 manifest가 소유한 stale output을 전체 변환 성공 후 삭제합니다.var/convert-manifests/에 보존하고 directory bind mount로 atomic replace를 지원합니다.full-all에서 모든 profile catalog를 먼저 갱신하고, profile 간 current output path 충돌을 생성 전에 차단합니다.기대 효과
--remote실행 시 Confluence의 page/folder 계층 변경을 catalog와 generated MDX에 반영합니다.Test plan
confluence-mdx/venv/bin/python -m pytest -q— 1,182 passed, 4 skippedconfluence-mdx/tests/run-tests.sh --type convert --log-level warning과 동일한 convert loop — 21 passedopenspec validate confluence-folder-mdx --strictopenspec validate complete-reverse-sync --strictconfluence-mdx/venv/bin/python -m compileall -q confluence-mdx/bin confluence-mdx/tests/test_fetch_folders.py confluence-mdx/tests/test_convert_all_folders.pybash -n confluence-mdx/scripts/entrypoint.shgit diff --check2167636017remote smoke test — 로컬 Atlassian 인증 정보가 없어 실행하지 못했습니다.Related tickets & links
🤖 Generated with Codex
Co-Authored-By: Atlas atlas@jk.agent