docuking-mcp 3.0.0 → 3.6.0

package/handlers/sync.js

@@ -46,6 +46,12 @@ import {
   updateIndexAfterSync,
   computeFileHash,
   getIndexStats,
+  // v2 추가
+  markAsDeleted,
+  wasDeletedLocally,
+  clearDeletedEntry,
+  classifyForPush,
+  classifyForPull,
 } from '../lib/index-cache.js';
 
 // 레포지토리 매핑 (메모리에 캐시)
@@ -74,6 +80,18 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
   // Co-worker 권한은 API Key 형식에서 판단
   const { isCoworker, coworkerFolder } = parseCoworkerFromApiKey(apiKey);
 
+  // 기존 config 확인 - 프로젝트 ID가 변경되면 인덱스 초기화
+  const existingConfig = getLocalConfig(localPath);
+  if (existingConfig && existingConfig.projectId && existingConfig.projectId !== projectId) {
+    // 프로젝트 ID가 변경됨 - 인덱스 파일 삭제
+    const indexPath = path.join(localPath, '.docuking', 'index.json');
+    if (fs.existsSync(indexPath)) {
+      fs.unlinkSync(indexPath);
+      console.error(`[DocuKing] 프로젝트 ID 변경 감지: ${existingConfig.projectId} → ${projectId}`);
+      console.error(`[DocuKing] 기존 인덱스 초기화됨`);
+    }
+  }
+
   // .docuking/config.json에 설정 저장
   saveLocalConfig(localPath, {
     projectId,
@@ -84,7 +102,7 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
     createdAt: new Date().toISOString(),
   });
 
-  // 폴더 생성: 오너는 yy_All_Docu/, 협업자는 yy_Coworker_{폴더명}/ (별도)
+  // 폴더 생성: 오너는 yy_All_Docu/, 협업자는 zz_Coworker_{폴더명}/ (별도)
   const mainFolderName = 'yy_All_Docu';
   const mainFolderPath = path.join(localPath, mainFolderName);
 
@@ -96,9 +114,10 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
   let coworkerFolderName = null;
   let coworkerFolderPath = null;
 
-  // AI 폴더 (오너: xy_TalkTodoPlan, 협업자: zz_TalkTodoPlan)
+  // AI 폴더 (오너: xy_TalkTodoPlan, 협업자: {폴더명}_TalkTodoPlan)
   const ownerAiFolder = 'xy_TalkTodoPlan';
-  const coworkerAiFolder = 'zz_TalkTodoPlan';
+  // 협업자 AI 폴더는 동적으로 생성 (coworkerFolder가 있을 때만)
+  const coworkerAiFolder = coworkerFolder ? `${coworkerFolder}_TalkTodoPlan` : null;
 
   // xx_ 시스템 폴더 목록 (오너 전용)
   const systemFolders = ['xx_Infra_Config', 'xx_Policy'];
@@ -110,8 +129,8 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
   }
 
   if (isCoworker) {
-    // 협업자: yy_Coworker_{폴더명}/ 폴더를 yy_All_Docu/ 밖에 별도 생성
-    coworkerFolderName = `yy_Coworker_${coworkerFolder}`;
+    // 협업자: zz_Coworker_{폴더명}/ 폴더를 yy_All_Docu/ 밖에 별도 생성
+    coworkerFolderName = `zz_Coworker_${coworkerFolder}`;
     coworkerFolderPath = path.join(localPath, coworkerFolderName);
     if (!fs.existsSync(coworkerFolderPath)) {
       fs.mkdirSync(coworkerFolderPath, { recursive: true });
@@ -121,7 +140,7 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
     if (!fs.existsSync(coworkerPrivatePath)) {
       fs.mkdirSync(coworkerPrivatePath, { recursive: true });
     }
-    // 협업자 폴더 안에 zz_TalkTodoPlan 폴더 생성
+    // 협업자 폴더 안에 {폴더명}_TalkTodoPlan 폴더 생성
     const coworkerAiFolderPath = path.join(coworkerFolderPath, coworkerAiFolder);
     if (!fs.existsSync(coworkerAiFolderPath)) {
       fs.mkdirSync(coworkerAiFolderPath, { recursive: true });
@@ -244,11 +263,11 @@ Git처럼 무엇을 변경했는지 명확히 작성해주세요.
 
   // Co-worker 권한은 API Key 형식에서 판단
   const { isCoworker, coworkerFolder } = parseCoworkerFromApiKey(apiKey);
-  const coworkerFolderName = isCoworker ? `yy_Coworker_${coworkerFolder}` : null;
+  const coworkerFolderName = isCoworker ? `zz_Coworker_${coworkerFolder}` : null;
 
   // 작업 폴더 결정: 프로젝트 루트 기준 절대경로 사용
-  // 오너: yy_All_Docu/, zz_ai_*/ 폴더들 Push
-  // 협업자: yy_Coworker_{폴더명}/ 폴더만 Push
+  // 오너: xx_*/ + xy_*/ + yy_All_Docu/ 폴더들 Push
+  // 협업자: zz_Coworker_{폴더명}/ 폴더만 Push
   const mainFolderPath = path.join(localPath, 'yy_All_Docu');
 
   // Push 대상 폴더 목록 (프로젝트 루트 기준)
@@ -258,7 +277,7 @@ Git처럼 무엇을 변경했는지 명확히 작성해주세요.
   console.error(`[DocuKing] Push 권한: isCoworker=${isCoworker}, coworkerFolder=${coworkerFolder}, coworkerFolderName=${coworkerFolderName}`);
 
   if (isCoworker) {
-    // 협업자: yy_Coworker_{폴더명}/ 폴더 + xx_Urgent/ 폴더 Push
+    // 협업자: zz_Coworker_{폴더명}/ 폴더 + xx_Urgent/ 폴더 Push
     const coworkerPath = path.join(localPath, coworkerFolderName);
     console.error(`[DocuKing] 협업자 Push 대상 폴더: ${coworkerPath}`);
     if (!fs.existsSync(coworkerPath)) {
@@ -294,13 +313,17 @@ docuking_init을 먼저 실행하세요.`,
       };
     }
 
-    // 오너 Push 대상: xx_*/ + yy_All_Docu/ + zz_ai_*/ 폴더들
+    // 오너 Push 대상: xx_*/ + xy_*/ + yy_All_Docu/ 폴더들
     pushTargetFolders.push({ localPath: mainFolderPath, serverPrefix: 'yy_All_Docu' });
 
-    // xx_*, zz_ai_* 폴더들 찾기
+    // 특수폴더 패턴으로 Push 대상 폴더 찾기
+    // 특수폴더: xx_*, xy_TalkTodoPlan, yy_All_Docu, zz_Coworker_*
     const rootEntries = fs.readdirSync(localPath, { withFileTypes: true });
     for (const entry of rootEntries) {
-      if (entry.isDirectory() && (entry.name.startsWith('xx_') || entry.name.startsWith('zz_ai_'))) {
+      if (entry.isDirectory() && (
+        entry.name.startsWith('xx_') ||
+        entry.name === 'xy_TalkTodoPlan'
+      )) {
         const folderPath = path.join(localPath, entry.name);
         pushTargetFolders.push({ localPath: folderPath, serverPrefix: entry.name });
       }
@@ -482,33 +505,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 {
@@ -724,7 +727,7 @@ docuking_init을 먼저 실행하세요.`,
               },
               body: JSON.stringify({
                 projectId,
-                path: file.serverPath, // 서버 경로 (코워커는 yy_Coworker_{폴더명}/파일경로)
+                path: file.serverPath, // 서버 경로 (코워커는 zz_Coworker_{폴더명}/파일경로)
                 content,
                 encoding, // 'utf-8' 또는 'base64'
                 message, // 커밋 메시지
@@ -803,23 +806,122 @@ docuking_init을 먼저 실행하세요.`,
   }
 
   // ========================================
-  // 4. 자동 삭제 비활성화 (2026-01-17 버그 수정)
+  // 4. 인덱스 기반 삭제 전파 (v2: 2026-01-24 강화)
   // ========================================
-  // 이전 로직: "서버에 있고 로컬에 없으면 삭제"
-  // 문제: 다른 프로젝트에서 Pull하면 서버 파일이 삭제됨
-  // 해결: 자동 삭제 제거, docuking_delete로만 명시적 삭제
-  //
-  // 삭제는 명시적으로만:
-  // - 사용자가 "이 파일 삭제해줘" 요청 시
-  // - docuking_delete MCP 도구 사용
+  // 3-way 비교:
+  // - 인덱스에 있음 + 로컬에 없음 + 서버에 있음 = 로컬 삭제 → 서버도 삭제
+  // - 인덱스에 있음 + 로컬에 없음 + 서버 수정됨 = 충돌 (로컬 삭제 vs 서버 수정)
+  // - 인덱스에 없음 + 로컬에 없음 + 서버에 있음 = 다른 곳에서 생성 → 무시
+  // - source: 'web' 파일은 삭제 보호
   // ========================================
   let deleted = 0;
   const deletedFilePaths = [];
   let protectedFiles = [];
+  const conflicts = [];
+
+  // 인덱스에서 삭제된 파일 찾기 (인덱스에 있었는데 로컬에 없는 파일)
+  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)) {
+      const serverMeta = serverPathToMeta[indexPath];
+      const indexEntry = localIndex.files[indexPath];
 
-  // 자동 삭제 로직 비활성화 - 아래 코드는 주석 처리
-  // "로컬에 없으면 삭제" 로직은 위험하므로 제거
-  console.error(`[DocuKing] 자동 삭제 비활성화됨 (명시적 삭제만 허용: docuking_delete 사용)`);
+      // 서버에 없으면 이미 삭제됨 → 스킵
+      if (!serverMeta) {
+        console.error(`[DocuKing] 이미 삭제됨: ${indexPath}`);
+        // deletedFiles 기록 정리
+        clearDeletedEntry(localIndex, indexPath);
+        continue;
+      }
+
+      // source: 'web' 파일은 삭제 보호
+      if (serverMeta.source === 'web') {
+        console.error(`[DocuKing] 삭제 보호 (source:web): ${indexPath}`);
+        protectedFiles.push(indexPath);
+        continue;
+      }
+
+      // 서버가 수정되었는지 확인 (충돌 감지)
+      const serverModified = serverMeta.hash !== (indexEntry.serverHash || indexEntry.hash);
+      if (serverModified) {
+        console.error(`[DocuKing] ⚠️ 충돌: ${indexPath} (로컬 삭제 vs 서버 수정)`);
+        conflicts.push({
+          path: indexPath,
+          type: 'delete-vs-modify',
+          localAction: 'delete',
+          serverHash: serverMeta.hash,
+        });
+        // 충돌 시에도 로컬 우선 정책으로 삭제 진행 (경고만 출력)
+      }
+
+      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 || []));
+
+        // 인덱스에서 삭제 처리 (v2: markAsDeleted 사용)
+        for (const deletedPath of locallyDeletedFiles) {
+          const entry = localIndex.files[deletedPath];
+          markAsDeleted(localIndex, deletedPath, entry?.hash);
+        }
+
+        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}`);
+    }
+  }
+
+  // 충돌 경고 출력
+  if (conflicts.length > 0) {
+    console.error(`\n[DocuKing] ⚠️ ${conflicts.length}개 충돌 발생 (로컬 우선 정책으로 처리됨):`);
+    for (const c of conflicts) {
+      console.error(`  - ${c.path}: ${c.type}`);
+    }
+    console.error('');
+  }
 
   // 5. 빈 폴더 생성
   let createdEmptyFolders = 0;
@@ -851,12 +953,13 @@ docuking_init을 먼저 실행하세요.`,
   }
 
   // ========================================
-  // 로컬 인덱스 업데이트 및 저장
+  // 로컬 인덱스 업데이트 및 저장 (v2)
   // ========================================
-  if (syncedFiles.length > 0) {
-    updateIndexAfterSync(localIndex, syncedFiles, deletedFilePaths);
+  if (syncedFiles.length > 0 || deletedFilePaths.length > 0) {
+    // syncType: 'push'로 lastPush 타임스탬프 업데이트
+    updateIndexAfterSync(localIndex, syncedFiles, deletedFilePaths, { syncType: 'push' });
     if (saveIndex(localPath, localIndex)) {
-      console.error(`[DocuKing] 로컬 인덱스 업데이트: ${syncedFiles.length}개 파일`);
+      console.error(`[DocuKing] 로컬 인덱스 업데이트: ${syncedFiles.length}개 동기화, ${deletedFilePaths.length}개 삭제`);
     }
   }
 
@@ -948,29 +1051,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,
       },
     ],
   };
@@ -1012,8 +1099,8 @@ export async function handlePullInternal(args) {
   // 오너 전용 폴더
   const ownerFolders = ['xx_Infra_Config', 'xx_Policy', 'xy_TalkTodoPlan'];
 
-  // 협업자 전용 폴더 (yy_Coworker_{폴더명}/ 안에)
-  const coworkerSubFolders = ['zz_TalkTodoPlan', '_Private'];
+  // 협업자 전용 폴더 (zz_Coworker_{폴더명}/ 안에)
+  // AI 폴더는 {폴더명}_TalkTodoPlan 형식 (coworkerFolder 기반 동적 생성)
 
   // 공통 폴더 체크
   for (const folder of commonFolders) {
@@ -1026,8 +1113,9 @@ export async function handlePullInternal(args) {
   }
 
   if (isCoworker) {
-    // 협업자: yy_Coworker_{폴더명}/ 안에 하위 폴더 체크
-    const coworkerFolderName = `yy_Coworker_${coworkerFolder}`;
+    // 협업자: zz_Coworker_{폴더명}/ 안에 하위 폴더 체크
+    const coworkerFolderName = `zz_Coworker_${coworkerFolder}`;
+    const coworkerSubFolders = [`${coworkerFolder}_TalkTodoPlan`, '_Private'];
     const coworkerBasePath = path.join(localPath, coworkerFolderName);
 
     // 협업자 루트 폴더
@@ -1176,10 +1264,9 @@ export async function handlePullInternal(args) {
     const serverMeta = serverPathToMeta[folder.path];
     let fullPath;
     if (folder.path.startsWith('xx_') ||
-        folder.path.startsWith('yy_All_Docu/') ||
+        folder.path.startsWith('xy_TalkTodoPlan') ||
         folder.path.startsWith('yy_All_Docu') ||
-        folder.path.startsWith('yy_Coworker_') ||
-        folder.path.startsWith('zz_ai_')) {
+        folder.path.startsWith('zz_Coworker_')) {
       fullPath = path.join(localPath, folder.path);
     } else {
       fullPath = path.join(mainFolderPath, folder.path);
@@ -1209,10 +1296,9 @@ export async function handlePullInternal(args) {
   for (const file of files_only) {
     let fullPath;
     if (file.path.startsWith('xx_') ||
-        file.path.startsWith('yy_All_Docu/') ||
+        file.path.startsWith('xy_TalkTodoPlan') ||
         file.path.startsWith('yy_All_Docu') ||
-        file.path.startsWith('yy_Coworker_') ||
-        file.path.startsWith('zz_ai_')) {
+        file.path.startsWith('zz_Coworker_')) {
       fullPath = path.join(localPath, file.path);
     } else {
       fullPath = path.join(mainFolderPath, file.path);
@@ -1253,9 +1339,51 @@ export async function handlePullInternal(args) {
       } catch (e) {
         // 해시 계산 실패 시 다운로드 대상
       }
+    } else {
+      // ========================================
+      // 로컬에 파일이 없는 경우 (v2 좀비 방지 강화)
+      // 1. files에 있음 = 로컬에서 삭제한 파일 → markAsDeleted 후 스킵
+      // 2. deletedFiles에 있음 = 이미 삭제 표시됨 → 서버 변경 확인 후 처리
+      // 3. 둘 다 없음 = 서버에서 새로 생성된 파일 → 다운로드
+      // ========================================
+
+      // Case 1: files에 아직 있음 (첫 Pull 시점)
+      if (localIndex.files && localIndex.files[file.path]) {
+        console.error(`[DocuKing] 로컬 삭제 감지: ${file.path} → deletedFiles에 기록`);
+        // deletedFiles에 기록
+        const entry = localIndex.files[file.path];
+        markAsDeleted(localIndex, file.path, entry.hash);
+        results.push({ type: 'skip', path: file.path, reason: 'locally-deleted' });
+        skipped++;
+        current++;
+        continue;
+      }
+
+      // Case 2: deletedFiles에 있음 (이전에 삭제 표시됨)
+      const deleted = wasDeletedLocally(localIndex, file.path);
+      if (deleted.isDeleted) {
+        // 서버가 수정되었는지 확인
+        if (serverHash === deleted.entry.lastHash) {
+          // 서버 변경 없음 → 스킵 (좀비 방지)
+          console.error(`[DocuKing] 좀비 방지: ${file.path} (로컬 삭제 유지)`);
+          results.push({ type: 'skip', path: file.path, reason: 'zombie-prevention' });
+        } else {
+          // 서버가 수정됨 → 충돌! (로컬 삭제 vs 서버 수정)
+          console.error(`[DocuKing] ⚠️ 충돌: ${file.path} (로컬 삭제 vs 서버 수정) → 서버 버전 다운로드`);
+          // 충돌 시 서버 버전 다운로드 (사용자가 결정할 수 있도록)
+          filesToDownload.push({ ...file, fullPath, conflict: true });
+          current++;
+          continue;
+        }
+        skipped++;
+        current++;
+        continue;
+      }
+
+      // Case 3: 둘 다 없음 = 새 파일
     }
 
-    // 로컬에 파일이 없는 경우만 다운로드
+    // 인덱스에 없고 로컬에 없음 = 서버에서 새로 생성된 파일 → 다운로드
     filesToDownload.push({ ...file, fullPath });
   }
 
@@ -1403,12 +1531,17 @@ export async function handlePullInternal(args) {
   }
 
   // ========================================
-  // 로컬 인덱스 업데이트 및 저장
+  // 로컬 인덱스 업데이트 및 저장 (v2)
   // ========================================
+  // Pull 중 발견된 삭제 파일들도 인덱스에 기록됨 (markAsDeleted 호출됨)
+  // 따라서 syncedFiles가 0이어도 인덱스가 변경되었을 수 있음
+  if (saveIndex(localPath, localIndex)) {
+    console.error(`[DocuKing] 로컬 인덱스 업데이트 (lastPull 갱신)`);
+  }
   if (syncedFiles.length > 0) {
-    updateIndexAfterSync(localIndex, syncedFiles, []);
+    updateIndexAfterSync(localIndex, syncedFiles, [], { syncType: 'pull' });
     if (saveIndex(localPath, localIndex)) {
-      console.error(`[DocuKing] 로컬 인덱스 업데이트: ${syncedFiles.length}개 파일`);
+      console.error(`[DocuKing] 로컬 인덱스: ${syncedFiles.length}개 파일 동기화됨`);
     }
   }
 
@@ -1490,9 +1623,9 @@ export async function handlePullInternal(args) {
         // 서버 경로에 따라 로컬 경로 결정
         let fullPath;
         if (deletedFile.path.startsWith('xx_') ||
-            deletedFile.path.startsWith('yy_All_Docu/') ||
-            deletedFile.path.startsWith('yy_Coworker_') ||
-            deletedFile.path.startsWith('zz_ai_')) {
+            deletedFile.path.startsWith('xy_TalkTodoPlan') ||
+            deletedFile.path.startsWith('yy_All_Docu') ||
+            deletedFile.path.startsWith('zz_Coworker_')) {
           fullPath = path.join(localPath, deletedFile.path);
         } else {
           fullPath = path.join(mainFolderPath, deletedFile.path);
@@ -1516,6 +1649,10 @@ export async function handlePullInternal(args) {
           deletedLocallyPaths.push(deletedFile.path);
           console.error(`[DocuKing] 로컬 삭제 (서버에서 삭제됨): ${deletedFile.path}`);
 
+          // 인덱스에서도 제거 (v2)
+          removeIndexEntry(localIndex, deletedFile.path);
+          clearDeletedEntry(localIndex, deletedFile.path);
+
           // 빈 폴더 정리
           const parentDir = path.dirname(fullPath);
           try {
@@ -1529,6 +1666,8 @@ export async function handlePullInternal(args) {
           }
         } else {
           console.error(`[DocuKing] 로컬 유지 (로컬 수정이 최신): ${deletedFile.path}`);
+          // 다음 Push에서 부활할 것이므로 deletedFiles에서 제거
+          clearDeletedEntry(localIndex, deletedFile.path);
         }
       } catch (e) {
         console.error(`[DocuKing] 삭제 동기화 실패: ${deletedFile.path} - ${e.message}`);
@@ -1780,7 +1919,7 @@ export async function handleStatus(args) {
 
   // Co-worker 권한은 API Key 형식에서 판단
   const { isCoworker, coworkerFolder } = parseCoworkerFromApiKey(apiKey);
-  const coworkerFolderName = isCoworker ? `yy_Coworker_${coworkerFolder}` : null;
+  const coworkerFolderName = isCoworker ? `zz_Coworker_${coworkerFolder}` : null;
 
   // 권한 정보 구성
   let permissionInfo = '';
@@ -1822,21 +1961,24 @@ export async function handleStatus(args) {
   const mainFolderPath = path.join(localPath, 'yy_All_Docu');
 
   if (isCoworker) {
-    // 협업자: yy_Coworker_{폴더명}/ 폴더에서 파일 수집
+    // 협업자: zz_Coworker_{폴더명}/ 폴더에서 파일 수집
     const coworkerPath = path.join(localPath, coworkerFolderName);
     if (fs.existsSync(coworkerPath)) {
       collectFilesSimple(coworkerPath, '', localFiles);
     }
     pushableFiles = localFiles; // 협업자는 자기 폴더의 모든 파일 Push 가능
   } else {
-    // 오너: xx_*/ + yy_All_Docu/ + zz_ai_*/ 폴더에서 파일 수집
+    // 오너: xx_*/ + xy_*/ + yy_All_Docu/ 폴더에서 파일 수집
     if (fs.existsSync(mainFolderPath)) {
       collectFilesSimple(mainFolderPath, '', localFiles);
     }
-    // xx_*, zz_ai_* 폴더들도 수집
+    // 특수폴더들도 수집: xx_*, xy_TalkTodoPlan
     const rootEntries = fs.readdirSync(localPath, { withFileTypes: true });
     for (const entry of rootEntries) {
-      if (entry.isDirectory() && (entry.name.startsWith('xx_') || entry.name.startsWith('zz_ai_'))) {
+      if (entry.isDirectory() && (
+        entry.name.startsWith('xx_') ||
+        entry.name === 'xy_TalkTodoPlan'
+      )) {
         const folderPath = path.join(localPath, entry.name);
         collectFilesSimple(folderPath, '', localFiles);
       }
@@ -1914,7 +2056,7 @@ export async function handleDelete(args) {
 
   // 협업자는 자기 폴더만 삭제 가능
   if (isCoworker) {
-    const coworkerPrefix = `yy_Coworker_${coworkerFolder}/`;
+    const coworkerPrefix = `zz_Coworker_${coworkerFolder}/`;
     const invalidPaths = paths.filter(p => !p.startsWith(coworkerPrefix) && !p.startsWith('xx_Urgent/'));
     if (invalidPaths.length > 0) {
       return {
@@ -1929,7 +2071,7 @@ export async function handleDelete(args) {
 
   // 오너도 협업자 폴더는 삭제 금지
   if (!isCoworker) {
-    const coworkerPaths = paths.filter(p => p.startsWith('yy_Coworker_'));
+    const coworkerPaths = paths.filter(p => p.startsWith('zz_Coworker_'));
     if (coworkerPaths.length > 0 && !force) {
       return {
         content: [{
@@ -2005,9 +2147,9 @@ export async function handleDelete(args) {
       try {
         let localFilePath;
         if (serverPath.startsWith('xx_') ||
-            serverPath.startsWith('yy_All_Docu/') ||
-            serverPath.startsWith('yy_Coworker_') ||
-            serverPath.startsWith('zz_ai_')) {
+            serverPath.startsWith('xy_TalkTodoPlan') ||
+            serverPath.startsWith('yy_All_Docu') ||
+            serverPath.startsWith('zz_Coworker_')) {
           localFilePath = path.join(localPath, serverPath);
         } else {
           localFilePath = path.join(localPath, 'yy_All_Docu', serverPath);