@wonseok-han/confluence-sync 1.2.0 → 1.2.1

package/README.md

@@ -100,8 +100,8 @@ confluence-sync --dry-run              # 대상·상태(신규/변경/동일)
 confluence-sync                        # 변경된 문서만 갱신 (+ 신규 생성)
 
 confluence-sync --base /abs/path/docs  # 동기화 루트 지정 (env 미설정 시 필수)
-confluence-sync guide/                 # 지정 폴더만 (부모 README 자동 포함)
-confluence-sync guide/setup.md         # 단일 문서만
+confluence-sync guide/                 # 지정 폴더만
+confluence-sync guide/setup.md         # 단일 문서만 (상위 README 는 발행되지 않음)
 confluence-sync --force                # 변경 감지 무시, 전체 강제 갱신
 confluence-sync --verify               # 변경 없는 문서도 페이지 존재 확인
 confluence-sync --rebuild              # 매핑된 페이지 전부 삭제 후 재생성
@@ -114,6 +114,8 @@ confluence-sync --exclude '*-draft.md' # 제외 패턴 (반복 가능)
 - README 가 **없는** 폴더는 **Confluence 폴더**로 생성되고 그 아래로 문서가 들어갑니다 (`write:folder` 스코프 필요).
 - `README.md` 는 폴더 맨 앞, 나머지는 파일명순(숫자 prefix `01-`, `10-` … 로 순서 제어)으로 정렬되어 부모가 자식보다 먼저 생성됩니다.
 
+> **경로를 지정해 동기화할 때**는 상위 `README.md` 가 **발행 대상이 아닙니다.** 자식을 붙일 부모 pageId 를 얻는 데만 쓰이고, 내용이 바뀌어 있어도 갱신하지 않습니다(`· 상위` 로 표시). 아직 페이지가 없으면 자식을 붙일 곳이 없으므로 그때는 생성합니다. 상위 문서도 갱신하려면 함께 지정하세요.
+
 ```
 docs/                      → [CONFLUENCE_PARENT_ID 또는 공간 최상위]
 ├── README.md              → 루트 페이지

package/dist/help.js

@@ -40,7 +40,10 @@ ${h('동기화 옵션:')}
   ${o('-v, --version')}     버전 출력
 
 ${h('경로 인자:')}
-  파일/폴더를 주면 그 문서만 동기화합니다(부모 README 자동 포함).
+  파일/폴더를 주면 ${bold('그 문서만')} 발행합니다.
+  상위 ${o('README.md')} 는 자식을 붙일 부모 pageId 를 얻는 데만 쓰이고 내용은 갱신되지 않습니다
+  ${dim('(아직 페이지가 없으면 자식을 붙일 곳이 없으므로 그때는 생성됩니다).')}
+  상위 문서까지 갱신하려면 함께 지정하세요.
   예)  ${o('confluence-sync 20-design')}        ${o('confluence-sync 90-glossary.md')}
 
 ${h('pull(역방향) 옵션:')}

package/dist/sync.js

@@ -122,11 +122,18 @@ async function main() {
         anchorNames: anchorTargets[rel],
         bodySlugs: docs[rel]?.bodySlugs,
     });
-    const selected = positionals.length
-        ? withParents(resolveSelection(allRel, positionals, BASE_DIR), folderIndex)
-        : allRel;
+    // 사용자가 실제로 고른 문서. 경로 인자가 없으면 전체가 대상이다.
+    const picked = positionals.length ? resolveSelection(allRel, positionals, BASE_DIR) : allRel;
+    const explicit = new Set(picked);
+    // 상위 README 를 함께 넣는 것은 **자식의 부모 pageId 를 얻기 위해서**다(발행 대상이 아니다).
+    const selected = positionals.length ? withParents(picked, folderIndex) : allRel;
     const files = sortForSync(selected);
-    const scope = positionals.length ? `선택 ${files.length}/${allRel.length}건` : `${files.length}건`;
+    /** 딸려온 상위 README 인가 — 이미 페이지가 있으면 내용은 건드리지 않는다. */
+    const isCarriedParent = (rel) => !explicit.has(rel);
+    const scope = positionals.length
+        ? `선택 ${explicit.size}/${allRel.length}건` +
+            (files.length > explicit.size ? dim(` (+상위 ${files.length - explicit.size})`) : '')
+        : `${files.length}건`;
     const ignoredNote = ignoredCount ? dim(`  (제외 ${ignoredCount})`) : '';
     console.log(`${dim('base:')} ${cyan(BASE_DIR)}\n${dim('대상:')} ${scope}${ignoredNote}`);
     // ---- 경로 헬퍼 ----
@@ -167,6 +174,12 @@ async function main() {
                     const fex = mapping[`${d}/`];
                     console.log(`  [${fex?.pageId ? gray('폴더') : green('폴더+')}] 📁 ${d}/`);
                 }
+            const ex0 = mapping[rel];
+            // 딸려온 상위 README 는 pageId 만 쓰고 지나간다 — 고르지 않은 문서를 발행하지 않는다
+            if (isCarriedParent(rel) && ex0?.pageId) {
+                console.log(`  [${gray('상위')}] ${rel}  ${dim(`(pageId #${ex0.pageId} 만 사용)`)}`);
+                continue;
+            }
             const { title, body, fm } = readDoc(BASE_DIR, rel);
             const r = render(rel, body, title);
             const hash = docHash(title, r);
@@ -193,7 +206,7 @@ async function main() {
         saveMapping(MAPPING_PATH, {});
     }
     const work = REBUILD ? {} : mapping;
-    let created = 0, updated = 0, skipped = 0, recreated = 0, relinked = 0, foldersMade = 0, linked = 0;
+    let created = 0, updated = 0, skipped = 0, recreated = 0, relinked = 0, foldersMade = 0, linked = 0, carried = 0;
     const rendered = new Map();
     const recreatedTitles = new Set(); // 이번에 재생성된 문서의 제목
     const touched = new Set(); // 이번에 발행(생성/갱신/재생성)된 문서
@@ -243,6 +256,14 @@ async function main() {
             console.error(yellow(`  ✗ 건너뜀  ${rel}  (상위 폴더 미생성)`));
             continue;
         }
+        // 딸려온 상위 README 는 자식의 부모 pageId 를 얻으려고 들어온 것이다.
+        // 이미 페이지가 있으면 내용은 건드리지 않는다 — `csync <파일>` 이 고르지 않은 문서를 발행하면 안 된다.
+        // (페이지가 아직 없으면 자식을 붙일 곳이 없으므로 아래에서 생성한다)
+        if (isCarriedParent(rel) && work[rel]?.pageId) {
+            console.log(`  ${gray('· 상위')}  ${rel}  ${dim(`(pageId #${work[rel].pageId} 만 사용)`)}`);
+            carried++;
+            continue;
+        }
         const { title, body, fm } = readDoc(BASE_DIR, rel);
         const r = render(rel, body, title);
         const hash = docHash(title, r);
@@ -332,6 +353,7 @@ async function main() {
         `  ${gray(`변경없음 ${skipped}`)}` +
         (linked ? `  ${cyan(`연결 ${linked}`)}` : '') +
         (foldersMade ? `  ${cyan(`폴더 ${foldersMade}`)}` : '') +
-        `  ${dim(`대상 ${files.length}`)}`);
+        (carried ? `  ${gray(`상위 ${carried}`)}` : '') +
+        `  ${dim(`대상 ${files.length - carried}`)}`);
 }
 main().catch((e) => { console.error(e); process.exit(1); });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wonseok-han/confluence-sync",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "type": "module",
   "description": "Confluence Cloud ↔ Markdown 양방향 동기화 CLI — 마크다운을 Confluence 페이지로 발행(push)하고, Confluence 페이지·폴더·스페이스를 마크다운으로 가져옵니다(pull).",
   "keywords": [