docuking-mcp 2.3.0 → 2.5.0

package/index.js

@@ -1388,22 +1388,23 @@ Git처럼 무엇을 변경했는지 명확히 작성해주세요.
   const { isCoworker, coworkerFolder } = parseCoworkerFromApiKey(apiKey);
   const coworkerFolderName = isCoworker ? `yy_Coworker_${coworkerFolder}` : null;
 
-  // 작업 폴더 결정: 오너는 yy_All_Docu/, 협업자는 yy_Coworker_{폴더명}/ (별도 폴더)
+  // 작업 폴더 결정: 프로젝트 루트 기준 절대경로 사용
+  // 오너: yy_All_Docu/, zz_ai_*/ 폴더들 Push
+  // 협업자: yy_Coworker_{폴더명}/ 폴더만 Push
   const mainFolderPath = path.join(localPath, 'yy_All_Docu');
-  let workingPath;
-  let serverPathPrefix = ''; // 서버에 저장될 때 경로 접두사
 
-  if (isCoworker) {
-    // 협업자: yy_Coworker_{폴더명}/ 폴더에서 Push (yy_All_Docu/ 밖에 별도)
-    workingPath = path.join(localPath, coworkerFolderName);
-    serverPathPrefix = `${coworkerFolderName}/`;
+  // Push 대상 폴더 목록 (프로젝트 루트 기준)
+  let pushTargetFolders = [];
 
-    if (!fs.existsSync(workingPath)) {
-      // 폴더가 없으면 생성
-      fs.mkdirSync(workingPath, { recursive: true });
+  if (isCoworker) {
+    // 협업자: yy_Coworker_{폴더명}/ 폴더만 Push
+    const coworkerPath = path.join(localPath, coworkerFolderName);
+    if (!fs.existsSync(coworkerPath)) {
+      fs.mkdirSync(coworkerPath, { recursive: true });
     }
+    pushTargetFolders.push({ localPath: coworkerPath, serverPrefix: coworkerFolderName });
   } else {
-    // 오너: yy_All_Docu/ 폴더 사용
+    // 오너: yy_All_Docu/ 폴더 확인
     if (!fs.existsSync(mainFolderPath)) {
       return {
         content: [
@@ -1415,8 +1416,18 @@ docuking_init을 먼저 실행하세요.`,
         ],
       };
     }
-    workingPath = mainFolderPath;
-    serverPathPrefix = 'yy_All_Docu/'; // 오너도 yy_All_Docu/ 접두사 필요
+
+    // 오너 Push 대상: yy_All_Docu/ + zz_ai_*/ 폴더들
+    pushTargetFolders.push({ localPath: mainFolderPath, serverPrefix: 'yy_All_Docu' });
+
+    // zz_ai_* 폴더들 찾기
+    const rootEntries = fs.readdirSync(localPath, { withFileTypes: true });
+    for (const entry of rootEntries) {
+      if (entry.isDirectory() && entry.name.startsWith('zz_ai_')) {
+        const zzPath = path.join(localPath, entry.name);
+        pushTargetFolders.push({ localPath: zzPath, serverPrefix: entry.name });
+      }
+    }
   }
 
   // .env 파일 자동 백업: _Infra_Config/ 폴더에 복사
@@ -1525,10 +1536,12 @@ docuking_init을 먼저 실행하세요.`,
   // 파일 목록 수집
   const filesToPush = [];
   const excludedFiles = []; // 제외된 파일 목록
+  const largeFiles = [];
 
   if (filePath) {
-    // 특정 파일만
-    const fullPath = path.join(workingPath, filePath);
+    // 특정 파일만 - 첫 번째 대상 폴더에서 찾기
+    const targetFolder = pushTargetFolders[0];
+    const fullPath = path.join(targetFolder.localPath, filePath);
     if (fs.existsSync(fullPath) && fs.statSync(fullPath).isFile()) {
       const fileType = getFileType(filePath);
       if (fileType === 'excluded') {
@@ -1542,20 +1555,36 @@ docuking_init을 먼저 실행하세요.`,
         };
       }
 
-      // 서버 경로: 코워커는 yy_Coworker_{폴더명}/파일경로, 오너는 파일경로
-      const serverFilePath = serverPathPrefix + filePath;
+      // 서버 경로: 폴더prefix/파일경로 (예: yy_All_Docu/회의록/test.md)
+      const serverFilePath = `${targetFolder.serverPrefix}/${filePath}`;
       filesToPush.push({ path: filePath, serverPath: serverFilePath, fullPath, fileType });
     }
   } else {
-    // 전체 파일 - 제외된 파일 및 대용량 파일 목록도 수집
-    const largeFiles = [];
-    collectFiles(workingPath, '', filesToPush, excludedFiles, largeFiles);
+    // 전체 파일 - 모든 대상 폴더에서 수집
+    const emptyFolders = []; // 빈 폴더 목록
 
-    // 서버 경로 추가
-    for (const file of filesToPush) {
-      file.serverPath = serverPathPrefix + file.path;
-    }
+    for (const targetFolder of pushTargetFolders) {
+      if (!fs.existsSync(targetFolder.localPath)) continue;
+
+      const folderFiles = [];
+      collectFilesSimple(targetFolder.localPath, '', folderFiles, excludedFiles, largeFiles);
+
+      // 서버 경로 추가: prefix/상대경로 (예: yy_All_Docu/회의록/test.md)
+      for (const file of folderFiles) {
+        file.serverPath = `${targetFolder.serverPrefix}/${file.path}`;
+        filesToPush.push(file);
+      }
 
+      // 빈 폴더 수집
+      const folderEmptyDirs = [];
+      collectEmptyFolders(targetFolder.localPath, '', folderEmptyDirs);
+      for (const emptyDir of folderEmptyDirs) {
+        emptyFolders.push({
+          localPath: emptyDir,
+          serverPath: `${targetFolder.serverPrefix}/${emptyDir}`,
+        });
+      }
+    }
 
     // 대용량 파일 경고
     if (largeFiles.length > 0) {
@@ -1831,6 +1860,35 @@ docuking_init을 먼저 실행하세요.`,
     }
   }
 
+  // 5. 빈 폴더 생성
+  let createdEmptyFolders = 0;
+  if (typeof emptyFolders !== 'undefined' && emptyFolders.length > 0) {
+    for (const folder of emptyFolders) {
+      try {
+        const folderResponse = await fetch(`${API_ENDPOINT}/files`, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${apiKey}`,
+          },
+          body: JSON.stringify({
+            projectId,
+            path: folder.serverPath,
+            type: 'folder',
+            name: folder.localPath.split('/').pop(),
+          }),
+        });
+
+        if (folderResponse.ok) {
+          createdEmptyFolders++;
+          console.error(`[DocuKing] 빈 폴더 생성: ${folder.serverPath}`);
+        }
+      } catch (e) {
+        console.error(`[DocuKing] 빈 폴더 생성 실패: ${folder.serverPath} - ${e.message}`);
+      }
+    }
+  }
+
   // Sync 완료 알림
   try {
     await fetch(`${API_ENDPOINT}/projects/${projectId}/sync/complete`, {
@@ -1852,6 +1910,9 @@ docuking_init을 먼저 실행하세요.`,
 
   // 요약 정보
   let summary = `\n📦 커밋 메시지: "${message}"\n\n📊 처리 결과:\n   - 총 파일: ${total}개\n   - 업로드: ${successCount}개\n   - 이동: ${movedCount}개\n   - 삭제: ${deleted}개\n   - 스킵 (변경 없음): ${skippedCount}개\n   - 실패: ${failCount}개`;
+  if (createdEmptyFolders > 0) {
+    summary += `\n   - 빈 폴더 생성: ${createdEmptyFolders}개`;
+  }
   if (excludedCount > 0) {
     summary += `\n   - 제외 (압축/설치파일): ${excludedCount}개`;
   }
@@ -2018,14 +2079,15 @@ async function handlePull(args) {
       const data = await response.json();
 
       // 서버 경로에 따라 로컬 저장 위치 결정
+      // 프로젝트 루트 기준 절대경로 그대로 사용
       // - yy_All_Docu/xxx → yy_All_Docu/xxx (오너 문서)
-      // - yy_Coworker_xxx/yyy → yy_Coworker_xxx/yyy (협업자 폴더, 루트에 별도)
+      // - yy_Coworker_xxx/yyy → yy_Coworker_xxx/yyy (협업자 폴더)
+      // - zz_ai_xxx/yyy → zz_ai_xxx/yyy (AI 폴더)
       let fullPath;
-      if (file.path.startsWith('yy_All_Docu/')) {
-        // 오너 문서: yy_All_Docu/ 접두사 포함된 채로 로컬에 저장
-        fullPath = path.join(localPath, file.path);
-      } else if (file.path.startsWith('yy_Coworker_')) {
-        // 협업자 폴더: 루트에 별도 폴더로 저장
+      if (file.path.startsWith('yy_All_Docu/') ||
+          file.path.startsWith('yy_Coworker_') ||
+          file.path.startsWith('zz_ai_')) {
+        // 서버 경로 그대로 로컬에 저장
         fullPath = path.join(localPath, file.path);
       } else {
         // 기타 (구버전 호환): yy_All_Docu/ 안에 저장
@@ -2229,7 +2291,80 @@ function hasAllDocuFolder(projectPath) {
   return fs.existsSync(allDocuPath);
 }
 
-// 유틸: 디렉토리 재귀 탐색
+// 유틸: 빈 폴더 수집 (재귀)
+function collectEmptyFolders(basePath, relativePath, results) {
+  const fullPath = path.join(basePath, relativePath);
+  if (!fs.existsSync(fullPath)) return;
+
+  const entries = fs.readdirSync(fullPath, { withFileTypes: true });
+
+  // 현재 폴더가 비어있으면 (파일 없고, 하위 폴더도 없음)
+  const hasFiles = entries.some(e => e.isFile());
+  const subDirs = entries.filter(e => e.isDirectory());
+
+  if (!hasFiles && subDirs.length === 0) {
+    // 완전히 빈 폴더
+    results.push(relativePath);
+  } else {
+    // 하위 폴더 탐색
+    for (const entry of subDirs) {
+      const entryRelPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+      collectEmptyFolders(basePath, entryRelPath, results);
+    }
+  }
+}
+
+// 유틸: 디렉토리 재귀 탐색 (zz_* 제외 없음, Push용)
+// excludedFiles: 제외된 파일 목록을 수집할 배열 (선택)
+// largeFiles: 대용량 파일 목록을 수집할 배열 (선택)
+function collectFilesSimple(basePath, relativePath, results, excludedFiles = null, largeFiles = null) {
+  const fullPath = path.join(basePath, relativePath);
+  if (!fs.existsSync(fullPath)) return;
+
+  const entries = fs.readdirSync(fullPath, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const entryRelPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+
+    if (entry.isDirectory()) {
+      collectFilesSimple(basePath, entryRelPath, results, excludedFiles, largeFiles);
+    } else if (entry.isFile()) {
+      const fileType = getFileType(entry.name);
+
+      // 제외 파일은 건너뜀
+      if (fileType === 'excluded') {
+        console.error(`[DocuKing] 제외됨: ${entryRelPath} (지원하지 않는 파일 형식)`);
+        if (excludedFiles) {
+          excludedFiles.push(entryRelPath);
+        }
+        continue;
+      }
+
+      // 파일 크기 확인
+      const fileFullPath = path.join(fullPath, entry.name);
+      const stats = fs.statSync(fileFullPath);
+      const fileSizeMB = stats.size / (1024 * 1024);
+
+      // 대용량 파일은 별도 추적
+      if (stats.size > MAX_FILE_SIZE_BYTES) {
+        console.error(`[DocuKing] ⚠️ 대용량 파일 제외: ${entryRelPath} (${fileSizeMB.toFixed(1)}MB > ${MAX_FILE_SIZE_MB}MB)`);
+        if (largeFiles) {
+          largeFiles.push({ path: entryRelPath, sizeMB: fileSizeMB.toFixed(1) });
+        }
+        continue;
+      }
+
+      results.push({
+        path: entryRelPath,
+        fullPath: fileFullPath,
+        fileType,
+        sizeMB: fileSizeMB,
+      });
+    }
+  }
+}
+
+// 유틸: 디렉토리 재귀 탐색 (기존 호환용)
 // excludedFiles: 제외된 파일 목록을 수집할 배열 (선택)
 // largeFiles: 대용량 파일 목록을 수집할 배열 (선택)
 // zz_* 폴더는 로컬 전용이므로 동기화에서 제외
@@ -2378,16 +2513,24 @@ async function handleStatus(args) {
   const mainFolderPath = path.join(localPath, 'yy_All_Docu');
 
   if (isCoworker) {
-    // 협업자: yy_Coworker_{폴더명}/ 폴더에서 파일 수집 (yy_All_Docu/ 밖에 별도)
+    // 협업자: yy_Coworker_{폴더명}/ 폴더에서 파일 수집
     const coworkerPath = path.join(localPath, coworkerFolderName);
     if (fs.existsSync(coworkerPath)) {
-      collectFiles(coworkerPath, '', localFiles);
+      collectFilesSimple(coworkerPath, '', localFiles);
     }
     pushableFiles = localFiles; // 협업자는 자기 폴더의 모든 파일 Push 가능
   } else {
-    // 오너: yy_All_Docu/ 폴더에서 파일 수집
+    // 오너: yy_All_Docu/ + zz_ai_*/ 폴더에서 파일 수집
     if (fs.existsSync(mainFolderPath)) {
-      collectFiles(mainFolderPath, '', localFiles);
+      collectFilesSimple(mainFolderPath, '', localFiles);
+    }
+    // zz_ai_* 폴더들도 수집
+    const rootEntries = fs.readdirSync(localPath, { withFileTypes: true });
+    for (const entry of rootEntries) {
+      if (entry.isDirectory() && entry.name.startsWith('zz_ai_')) {
+        const zzPath = path.join(localPath, entry.name);
+        collectFilesSimple(zzPath, '', localFiles);
+      }
     }
     pushableFiles = localFiles; // 오너는 모든 파일 Push 가능
   }

package/package.json

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