docuking-mcp 3.6.0 → 3.7.1

package/handlers/sync.js

@@ -1326,16 +1326,29 @@ export async function handlePullInternal(args) {
         }
 
         // ========================================
-        // [버그 수정] 로컬 파일 우선 정책
-        // 해시가 다르면 → 로컬 수정이 있다는 뜻
-        // 서버 파일로 덮어쓰지 않고 로컬 유지
-        // 다음 Push에서 로컬 → 서버로 업로드됨
+        // [v3.7.0] 최신 파일 보존 정책
+        // 해시가 다르면 → timestamp 비교해서 최신 파일 유지
+        // 로컬이 더 최신 → 로컬 유지 (다음 Push에서 업로드)
+        // 서버가 더 최신 → 서버 버전 다운로드
         // ========================================
-        console.error(`[DocuKing] 로컬 우선: ${file.path} (해시 다름 → 로컬 유지, Push 시 업로드됨)`);
-        results.push({ type: 'skip', path: file.path, reason: 'local-modified' });
-        skipped++;
-        current++;
-        continue;
+        const serverMeta = serverPathToMeta[file.path];
+        const serverUpdatedAt = serverMeta?.updatedAt ? new Date(serverMeta.updatedAt).getTime() : 0;
+        const localMtime = localStat.mtimeMs;
+
+        if (localMtime >= serverUpdatedAt) {
+          // 로컬이 더 최신 (또는 동일) → 로컬 유지
+          console.error(`[DocuKing] 로컬 최신: ${file.path} (local: ${new Date(localMtime).toISOString()}, server: ${serverMeta?.updatedAt || 'N/A'})`);
+          results.push({ type: 'skip', path: file.path, reason: 'local-newer' });
+          skipped++;
+          current++;
+          continue;
+        } else {
+          // 서버가 더 최신 → 다운로드 대상에 추가
+          console.error(`[DocuKing] 서버 최신: ${file.path} (local: ${new Date(localMtime).toISOString()}, server: ${serverMeta?.updatedAt || 'N/A'})`);
+          filesToDownload.push({ ...file, fullPath });
+          current++;
+          continue;
+        }
       } catch (e) {
         // 해시 계산 실패 시 다운로드 대상
       }
@@ -1986,17 +1999,115 @@ export async function handleStatus(args) {
     pushableFiles = localFiles; // 오너는 모든 파일 Push 가능
   }
 
+  // 서버 해시 정보 조회 (변경 감지용)
+  let serverPathToHash = {};
+  try {
+    const hashResponse = await fetch(
+      `${API_ENDPOINT}/files/hashes-for-sync?projectId=${projectId}`,
+      {
+        headers: {
+          'Authorization': `Bearer ${apiKey}`,
+        },
+      }
+    );
+    if (hashResponse.ok) {
+      const hashData = await hashResponse.json();
+      serverPathToHash = hashData.pathToHash || {};
+    }
+  } catch (e) {
+    console.error('[DocuKing] 해시 조회 실패:', e.message);
+  }
+
+  // 로컬 파일 해시 계산 + 변경 상태 비교
+  const addedFiles = [];    // 로컬에만 있음 (새 파일)
+  const modifiedFiles = []; // 해시가 다름 (수정됨)
+  const deletedFiles = [];  // 서버에만 있음 (삭제됨)
+  const unchangedFiles = []; // 동일
+
+  // 로컬 파일 해시 계산
+  const localPathToHash = {};
+  for (const file of localFiles) {
+    let fullPath;
+    // 경로에 따라 로컬 전체 경로 결정
+    if (file.startsWith('xx_') || file.startsWith('xy_') || file.startsWith('yy_') || file.startsWith('zz_')) {
+      fullPath = path.join(localPath, file);
+    } else {
+      fullPath = path.join(mainFolderPath, file);
+    }
+
+    if (fs.existsSync(fullPath)) {
+      try {
+        const content = fs.readFileSync(fullPath, 'utf-8');
+        const hash = crypto.createHash('sha256').update(content).digest('hex').substring(0, 16);
+        localPathToHash[file] = hash;
+      } catch (e) {
+        // 바이너리 파일 등은 스킵
+      }
+    }
+  }
+
+  // 비교
+  const serverPaths = Object.keys(serverPathToHash);
+  const localPaths = Object.keys(localPathToHash);
+
+  // 로컬 파일 분류
+  for (const localFile of localPaths) {
+    if (!serverPathToHash[localFile]) {
+      addedFiles.push(localFile);
+    } else if (serverPathToHash[localFile] !== localPathToHash[localFile]) {
+      modifiedFiles.push(localFile);
+    } else {
+      unchangedFiles.push(localFile);
+    }
+  }
+
+  // 서버에만 있는 파일 (삭제됨)
+  for (const serverFile of serverPaths) {
+    if (!localPathToHash[serverFile]) {
+      deletedFiles.push(serverFile);
+    }
+  }
+
   const projectNameInfo = projectName ? ` (${projectName})` : '';
   const workingFolder = isCoworker ? coworkerFolderName : 'yy_All_Docu';
-  const statusText = `DocuKing 동기화 상태
+
+  let statusText = `DocuKing 동기화 상태
 
 **프로젝트**: ${projectId}${projectNameInfo}
 **작업 폴더**: ${workingFolder}/
 **로컬 파일**: ${localFiles.length}개
-**서버 파일**: ${serverFiles.length}개
-**Push 가능한 파일**: ${pushableFiles.length}개${permissionInfo}
+**서버 파일**: ${serverFiles.length}개${permissionInfo}`;
+
+  // 변경 사항 표시
+  const hasChanges = addedFiles.length > 0 || modifiedFiles.length > 0 || deletedFiles.length > 0;
+
+  if (hasChanges) {
+    statusText += `\n\n## 📊 변경 사항 (Push 대상)`;
+
+    if (addedFiles.length > 0) {
+      statusText += `\n\n**➕ 새 파일 (${addedFiles.length}개)**:`;
+      addedFiles.slice(0, 10).forEach(f => statusText += `\n   + ${f}`);
+      if (addedFiles.length > 10) statusText += `\n   ... 외 ${addedFiles.length - 10}개`;
+    }
+
+    if (modifiedFiles.length > 0) {
+      statusText += `\n\n**✏️ 수정됨 (${modifiedFiles.length}개)**:`;
+      modifiedFiles.slice(0, 10).forEach(f => statusText += `\n   ~ ${f}`);
+      if (modifiedFiles.length > 10) statusText += `\n   ... 외 ${modifiedFiles.length - 10}개`;
+    }
 
-## 사용 가능한 작업
+    if (deletedFiles.length > 0) {
+      statusText += `\n\n**🗑️ 삭제됨 (${deletedFiles.length}개, 로컬에 없음)**:`;
+      deletedFiles.slice(0, 10).forEach(f => statusText += `\n   - ${f}`);
+      if (deletedFiles.length > 10) statusText += `\n   ... 외 ${deletedFiles.length - 10}개`;
+    }
+
+    statusText += `\n\n💡 Push하려면: docuking_push({ localPath, message: "변경 내용" })`;
+  } else {
+    statusText += `\n\n✅ 변경 사항 없음 (동기화됨: ${unchangedFiles.length}개 파일)`;
+  }
+
+  statusText += `\n\n## 사용 가능한 작업
 - **Push**: docuking_push({ localPath, message: "..." })
 - **Pull**: docuking_pull({ localPath })
 - **목록 조회**: docuking_list({ localPath })`;
@@ -2016,13 +2127,19 @@ export async function handleStatus(args) {
  */
 export async function handleDelete(args) {
   const localPath = args.localPath || process.cwd();
-  const { paths, force = false } = args;
+  const { force = false } = args;
+
+  // path (단수) 또는 paths (복수) 둘 다 지원
+  let paths = args.paths;
+  if (!paths && args.path) {
+    paths = [args.path]; // 단수를 배열로 변환
+  }
 
   if (!paths || paths.length === 0) {
     return {
       content: [{
         type: 'text',
-        text: '오류: 삭제할 파일 경로(paths)가 필요합니다.',
+        text: '오류: 삭제할 파일 경로(path 또는 paths)가 필요합니다.',
       }],
     };
   }

package/index.js

@@ -200,9 +200,23 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
         name: 'docuking_pull',
         description: `서버에서 문서를 다운로드합니다. "DocuKing에서 가져와" 요청 시 사용.
 
-**킹캐스트 포함**: Pull 후 xx_Policy/, xx_Infra_Config/ 폴더 변경이 감지되면 자동으로 .claude/rules/local/에 로컬화됩니다. 오너가 정책을 수정하고 Push하면, 협업자가 Pull할 때 자동으로 정책이 전파됩니다.
+**⚠️ 최신 파일 보존 정책 (AI 필독)**
 
-**긴급 보고 알림**: Pull 후 xx_Urgent/ 폴더에 파일이 있으면 "긴급 보고 N건 있습니다" 알림을 표시합니다.`,
+Pull 시 로컬과 서버 파일이 다르면 **timestamp를 비교**합니다:
+- **로컬이 더 최신** → 로컬 유지 (다음 Push에서 서버로 업로드)
+- **서버가 더 최신** → 서버 버전 다운로드
+
+이렇게 하면:
+- 로컬에서 작업한 최신 파일이 서버의 과거 버전으로 덮어쓰이지 않음
+- 서버에서 다른 사람이 수정한 최신 파일은 로컬로 내려옴
+
+**좀비 방지**: 로컬에서 삭제한 파일은 서버에서 다시 내려오지 않습니다.
+
+---
+
+**킹캐스트**: Pull 후 xx_Policy/, xx_Infra_Config/ 변경 감지 시 .claude/rules/local/에 자동 로컬화.
+
+**긴급 보고 알림**: xx_Urgent/ 폴더에 파일이 있으면 "긴급 보고 N건 있습니다" 표시.`,
         inputSchema: {
           type: 'object',
           properties: {
@@ -234,7 +248,17 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
       },
       {
         name: 'docuking_status',
-        description: '로컬과 서버의 동기화 상태를 확인합니다. 사용자 권한(오너/참여자), 변경/추가/삭제된 파일 목록 표시.',
+        description: `로컬과 서버의 동기화 상태를 확인합니다. git status와 유사.
+
+**표시 내용:**
+- 사용자 권한 (오너/협업자)
+- 로컬에만 있는 파일 (Added) → Push 시 서버에 업로드
+- 내용이 다른 파일 (Modified) → Push 시 서버에 업로드
+- 서버에만 있는 파일 (Deleted) → Pull 시 로컬로 다운로드
+
+**사용 시점:**
+- Push/Pull 전에 변경 사항 확인
+- "무슨 파일이 바뀌었지?" 확인할 때`,
         inputSchema: {
           type: 'object',
           properties: {

package/lib/init.js

@@ -158,20 +158,22 @@ project/
     if (fs.existsSync(claudeMdPath)) {
       let content = fs.readFileSync(claudeMdPath, 'utf-8');
 
-      if (content.includes(marker)) {
-        return;
-      }
-
-      if (content.includes(oldMarker)) {
-        const oldSectionStart = content.lastIndexOf('---\n\n' + oldMarker);
-        if (oldSectionStart !== -1) {
-          content = content.substring(0, oldSectionStart) + docukingSection;
-          fs.writeFileSync(claudeMdPath, content, 'utf-8');
-          return;
-        }
+      // 기존 DocuKing 섹션 모두 삭제 후 새로 추가
+      // 패턴: "---\n\n## DocuKing" 으로 시작하는 섹션 찾아서 끝까지 삭제
+      const docukingPatterns = [
+        /---\n\n## DocuKing 연결됨[\s\S]*$/,
+        /---\n\n## DocuKing AI 작업 기록[\s\S]*$/,
+        /## DocuKing 연결됨[\s\S]*$/,
+        /## DocuKing AI 작업 기록[\s\S]*$/,
+      ];
+
+      for (const pattern of docukingPatterns) {
+        content = content.replace(pattern, '');
       }
 
-      fs.appendFileSync(claudeMdPath, docukingSection, 'utf-8');
+      // 끝에 새 섹션 추가
+      content = content.trimEnd() + '\n' + docukingSection;
+      fs.writeFileSync(claudeMdPath, content, 'utf-8');
     } else {
       const newContent = `# Project Instructions
 

package/package.json

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