docuking-mcp 3.0.0 → 3.1.0

package/handlers/sync.js

@@ -482,33 +482,13 @@ docuking_init을 먼저 실행하세요.`,
   }
 
   // ========================================
-  // 로컬 파일 경로 목록 저장 (Pull 전에!)
-  // soft-delete에서 "로컬에 없는 파일" 판단에 사용
-  // Pull이 파일을 내려받아도 이 목록은 변하지 않음
+  // Pull 선행 제거 (2026-01-24)
   // ========================================
-  const localPathsBeforePull = new Set(filesToPush.map(f => f.serverPath));
-  console.error(`[DocuKing] Pull 전 로컬 파일 ${localPathsBeforePull.size}개 기록됨`);
-
-  // ========================================
-  // Pull 실행 (git pull && git push 패턴)
+  // 이전: Push 전에 Pull 실행 (git pull && git push 패턴)
+  // 문제: Pull이 로컬 변경사항(삭제, 수정)을 덮어씀 → 좀비 파일 부활
+  // 해결: Push는 Push만. Pull은 사용자가 별도로 호출.
   // ========================================
-  let pullResultText = '';
-  try {
-    const pullResult = await handlePullInternal({ localPath, filePath });
-    pullResultText = pullResult.text;
-  } catch (e) {
-    return {
-      content: [
-        {
-          type: 'text',
-          text: `❌ Pull 실패로 Push를 중단합니다.
-오류: ${e.message}
-
-먼저 Pull 문제를 해결한 후 다시 시도하세요.`,
-        },
-      ],
-    };
-  }
+  console.error(`[DocuKing] Push 시작 (Pull 선행 없음 - 로컬 우선)`);
 
   if (filesToPush.length === 0 && emptyFolders.length === 0) {
     return {
@@ -803,23 +783,80 @@ docuking_init을 먼저 실행하세요.`,
   }
 
   // ========================================
-  // 4. 자동 삭제 비활성화 (2026-01-17 버그 수정)
+  // 4. 인덱스 기반 삭제 전파 (2026-01-24 재구현)
   // ========================================
-  // 이전 로직: "서버에 있고 로컬에 없으면 삭제"
-  // 문제: 다른 프로젝트에서 Pull하면 서버 파일이 삭제됨
-  // 해결: 자동 삭제 제거, docuking_delete로만 명시적 삭제
-  //
-  // 삭제는 명시적으로만:
-  // - 사용자가 "이 파일 삭제해줘" 요청 시
-  // - docuking_delete MCP 도구 사용
+  // 이전 문제: "서버에 있고 로컬에 없으면 삭제" → 다른 프로젝트에서 문제
+  // 해결: 인덱스 기반으로 판단
+  // - 인덱스에 있었는데 + 로컬에 없음 = 의도적 삭제 → 서버에서도 삭제
+  // - 인덱스에 없었고 + 로컬에 없음 = 처음부터 없던 파일 → 무시
   // ========================================
   let deleted = 0;
   const deletedFilePaths = [];
   let protectedFiles = [];
 
-  // 자동 삭제 로직 비활성화 - 아래 코드는 주석 처리
-  // "로컬에 없으면 삭제" 로직은 위험하므로 제거
-  console.error(`[DocuKing] 자동 삭제 비활성화됨 (명시적 삭제만 허용: docuking_delete 사용)`);
+  // 인덱스에서 삭제된 파일 찾기 (인덱스에 있었는데 로컬에 없는 파일)
+  const locallyDeletedFiles = [];
+  for (const indexPath of Object.keys(localIndex.files)) {
+    // Push 대상 폴더 내의 파일인지 확인
+    let isInPushTarget = false;
+    let fullPath = '';
+
+    for (const target of pushTargetFolders) {
+      if (indexPath.startsWith(target.serverPrefix)) {
+        isInPushTarget = true;
+        const relativePath = indexPath.slice(target.serverPrefix.length + 1);
+        fullPath = path.join(target.localPath, relativePath);
+        break;
+      }
+    }
+
+    if (!isInPushTarget) continue;
+
+    // 로컬에 파일이 없으면 = 삭제된 파일
+    if (!fs.existsSync(fullPath)) {
+      locallyDeletedFiles.push(indexPath);
+      console.error(`[DocuKing] 삭제 감지: ${indexPath} (인덱스에 있었으나 로컬에 없음)`);
+    }
+  }
+
+  // 삭제된 파일을 서버에서도 삭제
+  if (locallyDeletedFiles.length > 0) {
+    console.error(`[DocuKing] 서버에서 ${locallyDeletedFiles.length}개 파일 삭제 요청`);
+    try {
+      const deleteResponse = await fetch(`${API_ENDPOINT}/files/soft-delete`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'Authorization': `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+          projectId,
+          paths: locallyDeletedFiles,
+        }),
+      });
+
+      if (deleteResponse.ok) {
+        const deleteResult = await deleteResponse.json();
+        deleted = deleteResult.deleted || 0;
+        deletedFilePaths.push(...(deleteResult.deletedPaths || []));
+        protectedFiles = deleteResult.protected || [];
+
+        // 인덱스에서도 삭제
+        for (const deletedPath of locallyDeletedFiles) {
+          delete localIndex.files[deletedPath];
+        }
+
+        console.error(`[DocuKing] 서버 삭제 완료: ${deleted}개`);
+        if (protectedFiles.length > 0) {
+          console.error(`[DocuKing] 보호된 파일 (source:web): ${protectedFiles.join(', ')}`);
+        }
+      } else {
+        console.error(`[DocuKing] 서버 삭제 실패: ${await deleteResponse.text()}`);
+      }
+    } catch (e) {
+      console.error(`[DocuKing] 서버 삭제 요청 오류: ${e.message}`);
+    }
+  }
 
   // 5. 빈 폴더 생성
   let createdEmptyFolders = 0;
@@ -948,29 +985,13 @@ docuking_init을 먼저 실행하세요.`,
   }
 
   resultText += `\n\n🌐 웹 탐색기에서 커밋 히스토리를 확인할 수 있습니다: https://docuking.ai`;
-
-  // Pull 결과가 있으면 앞에 추가
-  let finalText = '';
-  if (pullResultText) {
-    // Pull에서 실제로 받은 파일이 있는 경우만 표시
-    const pullHasChanges = pullResultText.includes('다운로드 (신규):') && !pullResultText.includes('다운로드 (신규): 0개');
-    const pullHasUpdates = pullResultText.includes('업데이트 (변경됨):') && !pullResultText.includes('업데이트 (변경됨): 0개');
-
-    if (pullHasChanges || pullHasUpdates) {
-      finalText = `📥 [1단계] Pull (서버 → 로컬)\n${pullResultText}\n\n${'─'.repeat(50)}\n\n📤 [2단계] Push (로컬 → 서버)\n${resultText}`;
-    } else {
-      // Pull에서 변경 없으면 간단히 표시
-      finalText = `📥 Pull: 변경 없음 (최신 상태)\n\n📤 Push:\n${resultText}`;
-    }
-  } else {
-    finalText = resultText;
-  }
+  resultText += `\n\n💡 서버에서 파일을 받으려면 별도로 Pull을 실행하세요.`;
 
   return {
     content: [
       {
         type: 'text',
-        text: finalText,
+        text: resultText,
       },
     ],
   };
@@ -1253,9 +1274,22 @@ export async function handlePullInternal(args) {
       } catch (e) {
         // 해시 계산 실패 시 다운로드 대상
       }
+    } else {
+      // ========================================
+      // 로컬에 파일이 없는 경우
+      // 인덱스에 있었으면 = 로컬에서 삭제한 파일 → 스킵 (좀비 방지)
+      // 인덱스에 없으면 = 서버에서 새로 생성된 파일 → 다운로드
+      // ========================================
+      if (localIndex.files && localIndex.files[file.path]) {
+        console.error(`[DocuKing] 로컬 삭제 유지: ${file.path} (인덱스에 있었음 → 스킵, 다음 Push에서 서버 삭제됨)`);
+        results.push({ type: 'skip', path: file.path, reason: 'locally-deleted' });
+        skipped++;
+        current++;
+        continue;
+      }
     }
 
-    // 로컬에 파일이 없는 경우만 다운로드
+    // 인덱스에 없고 로컬에 없음 = 서버에서 새로 생성된 파일 → 다운로드
     filesToDownload.push({ ...file, fullPath });
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docuking-mcp",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "DocuKing MCP Server - AI 시대의 문서 협업 플랫폼",
   "type": "module",
   "main": "index.js",