docuking-mcp 1.2.4 → 1.2.6

package/index.js

@@ -954,8 +954,18 @@ MCP 설정에 다음을 추가하세요:
 💡 참여자는 ${folderName}/ 폴더에만 Push할 수 있습니다.
    오너의 문서는 Pull로 읽을 수 있지만 수정은 제안서 형태로 작성하세요.
 
-⚠️ AI 필수 작업: ~/.claude.json의 docuking MCP env에 DOCUKING_REPOS 추가 필요
-"DOCUKING_REPOS": "${repoConfig}"`,
+⛔ [AI 즉시 수행] 아래 작업을 지금 바로 실행하세요:
+
+1. MCP 설정 파일을 Read 도구로 읽으세요:
+   - Claude Code: ~/.claude.json
+   - Cursor: ~/.cursor/mcp.json
+
+2. Edit 도구로 해당 파일의 mcpServers.docuking.env에 DOCUKING_REPOS를 추가하세요:
+   "DOCUKING_REPOS": "${repoConfig}"
+
+3. 사용자에게 "설정 완료. 재시작 후 Push/Pull 가능합니다" 안내
+
+❗ 이 작업을 수행하지 않으면 Push/Pull이 작동하지 않습니다.`,
         },
       ],
     };
@@ -977,8 +987,18 @@ MCP 설정에 다음을 추가하세요:
 - "DocuKing에 올려줘" → 로컬 문서를 서버에 Push
 - "DocuKing에서 가져와" → 서버 문서를 로컬로 Pull
 
-⚠️ AI 필수 작업: ~/.claude.json의 docuking MCP env에 DOCUKING_REPOS 추가 필요
-"DOCUKING_REPOS": "${repoConfig}"`,
+⛔ [AI 즉시 수행] 아래 작업을 지금 바로 실행하세요:
+
+1. MCP 설정 파일을 Read 도구로 읽으세요:
+   - Claude Code: ~/.claude.json
+   - Cursor: ~/.cursor/mcp.json
+
+2. Edit 도구로 해당 파일의 mcpServers.docuking.env에 DOCUKING_REPOS를 추가하세요:
+   "DOCUKING_REPOS": "${repoConfig}"
+
+3. 사용자에게 "설정 완료. 재시작 후 Push/Pull 가능합니다" 안내
+
+❗ 이 작업을 수행하지 않으면 Push/Pull이 작동하지 않습니다.`,
         },
       ],
     };
@@ -1137,30 +1157,6 @@ docuking_init을 먼저 실행하세요.`,
     };
   }
 
-  // 파일 업로드 (진행률 표시)
-  const results = [];
-  const total = filesToPush.length;
-  let current = 0;
-  let skipped = 0;
-
-  // 시작 안내 메시지 출력 (AI가 사용자에게 전달할 수 있도록)
-  console.error(`[DocuKing] Push 시작: ${total}개 파일`);
-  console.error(`[DocuKing] 💡 실시간 진행상황은 DocuKing 웹(https://docuking.ai)에서 확인하세요`);
-
-  // Sync 시작 알림 (웹에서 프로그레스바 표시용)
-  try {
-    await fetch(`${API_ENDPOINT}/projects/${projectId}/sync/start`, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'Authorization': `Bearer ${API_KEY}`,
-      },
-      body: JSON.stringify({ totalFiles: total }),
-    });
-  } catch (e) {
-    console.error('[DocuKing] Sync 시작 알림 실패:', e.message);
-  }
-
   // 서버에서 파일 해시 조회 (변경 감지용)
   let serverFileHashes = {};
   try {
@@ -1181,36 +1177,82 @@ docuking_init을 먼저 실행하세요.`,
     console.error('[DocuKing] 파일 해시 조회 실패:', e.message);
   }
 
+  // ★ 변경된 파일만 필터링 (업로드 전에 미리 계산)
+  const changedFiles = [];
+  const unchangedFiles = [];
+
   for (const file of filesToPush) {
+    let fileHash;
+    let content;
+    let encoding = 'utf-8';
+
+    if (file.fileType === 'binary') {
+      const buffer = fs.readFileSync(file.fullPath);
+      fileHash = crypto.createHash('sha256').update(buffer).digest('hex');
+      content = buffer.toString('base64');
+      encoding = 'base64';
+    } else {
+      content = fs.readFileSync(file.fullPath, 'utf-8');
+      fileHash = crypto.createHash('sha256').update(content, 'utf-8').digest('hex');
+    }
+
+    if (serverFileHashes[file.path] === fileHash) {
+      unchangedFiles.push(file.path);
+    } else {
+      changedFiles.push({ ...file, content, encoding, fileHash });
+    }
+  }
+
+  const totalLocal = filesToPush.length;
+  const totalChanged = changedFiles.length;
+  const totalUnchanged = unchangedFiles.length;
+
+  // ★ 변경된 파일이 없으면 즉시 반환
+  if (totalChanged === 0) {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `변경된 파일이 없습니다.
+
+📊 로컬 파일: ${totalLocal}개
+✓ 서버와 동일: ${totalUnchanged}개
+⊘ 변경 필요: 0개
+
+이미 모든 파일이 서버와 동기화되어 있습니다.`,
+        },
+      ],
+    };
+  }
+
+  // ★ 변경된 파일만 업로드 (AI에게 명확히 알림)
+  console.error(`[DocuKing] 변경 감지 완료: 전체 ${totalLocal}개 중 ${totalChanged}개만 업로드`);
+  console.error(`[DocuKing] 💡 실시간 진행상황은 DocuKing 웹(https://docuking.ai)에서 확인하세요`);
+
+  // Sync 시작 알림 (변경된 파일 수만 전달)
+  try {
+    await fetch(`${API_ENDPOINT}/projects/${projectId}/sync/start`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${API_KEY}`,
+      },
+      body: JSON.stringify({ totalFiles: totalChanged }),
+    });
+  } catch (e) {
+    console.error('[DocuKing] Sync 시작 알림 실패:', e.message);
+  }
+
+  // 파일 업로드 (변경된 파일만)
+  const results = [];
+  let current = 0;
+
+  for (const file of changedFiles) {
     current++;
-    const progress = `${current}/${total}`;
+    const progress = `${current}/${totalChanged}`;
 
     try {
-      // 파일 해시 계산 (변경 감지)
-      let fileHash;
-      let content;
-      let encoding = 'utf-8';
-
-      if (file.fileType === 'binary') {
-        // 바이너리 파일은 Base64로 인코딩
-        const buffer = fs.readFileSync(file.fullPath);
-        fileHash = crypto.createHash('sha256').update(buffer).digest('hex');
-        content = buffer.toString('base64');
-        encoding = 'base64';
-      } else {
-        // 텍스트 파일은 UTF-8
-        content = fs.readFileSync(file.fullPath, 'utf-8');
-        fileHash = crypto.createHash('sha256').update(content, 'utf-8').digest('hex');
-      }
-
-      // 변경 감지: 서버에 같은 해시가 있으면 스킵
-      if (serverFileHashes[file.path] === fileHash) {
-        const resultText = `${progress} ⊘ ${file.path} (변경 없음)`;
-        results.push(resultText);
-        console.log(resultText);
-        skipped++;
-        continue;
-      }
+      const { content, encoding, fileHash } = file;
 
       // 재시도 로직 (최대 3회)
       let lastError = null;
@@ -1325,17 +1367,16 @@ docuking_init을 먼저 실행하세요.`,
 
   const successCount = results.filter(r => r.includes('✓')).length;
   const failCount = results.filter(r => r.includes('✗')).length;
-  const skippedCount = skipped; // 이미 계산된 스킵 개수 사용
   const excludedCount = excludedFiles.length;
 
-  // 요약 정보
-  let summary = `\n📦 커밋 메시지: "${message}"\n\n📊 처리 결과:\n   - 총 파일: ${total}개\n   - 업로드: ${successCount}개\n   - 스킵 (변경 없음): ${skippedCount}개\n   - 실패: ${failCount}개`;
+  // 요약 정보 (★ 변경된 파일만 업로드했음을 명확히 표시)
+  let summary = `\n📦 커밋 메시지: "${message}"\n\n📊 처리 결과:\n   - 로컬 파일: ${totalLocal}개\n   - 변경 없음 (스킵): ${totalUnchanged}개\n   - 변경 감지: ${totalChanged}개\n   - 업로드 성공: ${successCount}개\n   - 업로드 실패: ${failCount}개`;
   if (excludedCount > 0) {
     summary += `\n   - 제외 (압축/설치파일): ${excludedCount}개`;
   }
 
   // 상세 결과를 표시 (Git처럼)
-  let resultText = `✓ Push 완료!${summary}`;
+  let resultText = `✓ Push 완료! (변경된 ${totalChanged}개 파일만 업로드)${summary}`;
 
   // 업로드된 파일이 있으면 상세 목록 표시
   if (successCount > 0) {
@@ -1343,12 +1384,6 @@ docuking_init을 먼저 실행하세요.`,
     resultText += `\n\n📤 업로드된 파일 (${successCount}개):\n${uploadedFiles.map(r => `   ${r.replace(/^\d+\/\d+ /, '')}`).join('\n')}`;
   }
 
-  // 스킵된 파일이 있으면 표시
-  if (skippedCount > 0) {
-    const skippedFiles = results.filter(r => r.includes('⊘'));
-    resultText += `\n\n⏭️  스킵된 파일 (${skippedCount}개, 변경 없음):\n${skippedFiles.map(r => `   ${r.replace(/^\d+\/\d+ /, '')}`).join('\n')}`;
-  }
-
   // 실패한 파일이 있으면 표시
   if (failCount > 0) {
     const failedFiles = results.filter(r => r.includes('✗'));

package/package.json

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