docuking-mcp 2.14.0 → 3.1.0

package/README.md

@@ -77,18 +77,18 @@ claude mcp add docuking -s user -- docuking-mcp
 
 | 도구 | 설명 |
 |------|------|
-| docuking_init | 프로젝트 연결, yy_All_Docu/ 및 zz_ai_* 폴더 생성 |
-| docuking_push | yy_All_Docu/ → 서버 업로드 |
-| docuking_pull | 서버 → yy_All_Docu/ 다운로드 |
+| docuking_init | 프로젝트 연결, 필수 폴더 생성 |
+| docuking_push | 로컬 → 서버 업로드 |
+| docuking_pull | 서버 → 로컬 다운로드 |
 | docuking_status | 동기화 상태 확인 |
 | docuking_list | 서버 파일 목록 조회 |
 | docuking_log | 커밋 히스토리 조회 |
 | docuking_diff | 버전 간 차이 비교 |
 | docuking_rollback | 특정 커밋으로 롤백 |
-| docuking_talk | AI 대화록 저장 (zz_ai_1_Talk/) |
-| docuking_plan | 작업 계획 관리 (zz_ai_3_Plan/) |
+| docuking_talk | AI 대화록 저장 (xy_TalkTodoPlan/) |
+| docuking_plan | 작업 계획 관리 (xy_TalkTodoPlan/) |
 | docuking_done | 작업 완료 처리 |
-| docuking_todo | 킹투두 관리 (zz_ai_2_Todo/) |
+| docuking_todo | 킹투두 관리 (xy_TalkTodoPlan/z_King_Todo.md) |
 | docuking_urgent | 긴급 보고 (xx_Urgent/) |
 | docuking_delete | 서버 파일 삭제 |
 | docuking_validate | 정책 준수 검증 |
@@ -100,20 +100,17 @@ claude mcp add docuking -s user -- docuking-mcp
 ├── xx_Infra_Config/         ← 시스템 설정 (동기화 대상)
 ├── xx_Policy/               ← 정책 문서 (동기화 대상, 킹캐스트)
 ├── xx_Urgent/               ← 긴급 보고 (동기화 대상)
+├── xy_TalkTodoPlan/         ← 오너 AI 기록 (Talk+Todo+Plan 통합)
 ├── yy_All_Docu/             ← 문서 허브 (동기화 대상)
-├── yy_Coworker_{이름}/      ← 협업자 작업 폴더 (동기화 대상)
-│   ├── zz_ai_1_Talk/        ← 협업자의 AI 대화록
-│   ├── zz_ai_2_Todo/        ← 협업자의 AI 투두
-│   └── zz_ai_3_Plan/        ← 협업자의 AI 플랜
-├── zz_ai_1_Talk/            ← 오너의 AI 대화록 (동기화 대상)
-├── zz_ai_2_Todo/            ← 오너의 AI 투두 (동기화 대상)
-└── zz_ai_3_Plan/            ← 오너의 AI 플랜 (동기화 대상)
+└── yy_Coworker_{이름}/      ← 협업자 작업 폴더 (동기화 대상)
+    └── zz_TalkTodoPlan/     ← 협업자의 AI 기록
 ```
 
 **접두사 규칙:**
 - `xx_*`: 시스템/인프라 폴더
+- `xy_*`: 오너 AI 기록 폴더
 - `yy_*`: 사람용 폴더
-- `zz_ai_*`: AI용 폴더
+- `zz_*`: 협업자 AI 기록 폴더 (협업자 폴더 안에서만)
 
 ## 웹사이트
 

package/handlers/docs.js

@@ -17,11 +17,12 @@ export async function handleTodo(args) {
   const localPath = args.localPath || process.cwd();
   const { action, todo, todoId } = args;
 
-  // 협업자 여부에 따라 zz_ai 경로 결정
-  // - 오너: localPath/zz_ai_2_Todo/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_ai_2_Todo/
-  const { basePath } = getAiBasePath(localPath);
-  const todoBasePath = path.join(basePath, 'zz_ai_2_Todo');
+  // 협업자 여부에 따라 AI 폴더 경로 결정
+  // - 오너: localPath/xy_TalkTodoPlan/
+  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
+  const { basePath, isCoworker } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  const todoBasePath = path.join(basePath, aiFolder);
   const todoFilePath = path.join(todoBasePath, 'z_King_Todo.md');
 
   // 폴더 생성
@@ -182,7 +183,7 @@ export async function handleTodo(args) {
           text: `📋 킹투두 미결: 없음
 
 ✅ 완료: ${completedCount}개
-📁 전체 기록: zz_ai_2_Todo/z_King_Todo.md`,
+📁 전체 기록: ${aiFolder}/z_King_Todo.md`,
         }],
       };
     }
@@ -197,7 +198,7 @@ export async function handleTodo(args) {
 ${listText}
 
 ✅ 완료: ${completedCount}개
-📁 전체 기록: zz_ai_2_Todo/z_King_Todo.md`,
+📁 전체 기록: ${aiFolder}/z_King_Todo.md`,
       }],
     };
   }
@@ -215,10 +216,11 @@ export async function handleTalk(args) {
   const { title, content: talkContent, tags = [] } = args;
 
   // 협업자 여부에 따라 zz_ai 경로 결정
-  // - 오너: localPath/zz_ai_1_Talk/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_ai_1_Talk/
-  const { basePath } = getAiBasePath(localPath);
-  const talkBasePath = path.join(basePath, 'zz_ai_1_Talk');
+  // - 오너: localPath/xy_TalkTodoPlan/
+  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
+  const { basePath, isCoworker } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  const talkBasePath = path.join(basePath, aiFolder);
 
   // 날짜 기반 파일명 생성 (T_ 접두사)
   const { fileName, timestamp } = generateDateFileName(title, 'T');
@@ -299,11 +301,12 @@ export async function handlePlan(args) {
   const localPath = args.localPath || process.cwd();
   const { planId, title, goal, steps = [], notes } = args;
 
-  // 협업자 여부에 따라 zz_ai 경로 결정
-  // - 오너: localPath/zz_ai_3_Plan/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_ai_3_Plan/
-  const { basePath } = getAiBasePath(localPath);
-  const planBasePath = path.join(basePath, 'zz_ai_3_Plan');
+  // 협업자 여부에 따라 AI 폴더 경로 결정
+  // - 오너: localPath/xy_TalkTodoPlan/
+  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
+  const { basePath, isCoworker } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  const planBasePath = path.join(basePath, aiFolder);
 
   // 기존 계획 업데이트 또는 새 계획 생성
   let targetPlanId = planId;
@@ -453,11 +456,12 @@ export async function handleDone(args) {
   const localPath = args.localPath || process.cwd();
   const { planId, summary, artifacts = [] } = args;
 
-  // 협업자 여부에 따라 zz_ai 경로 결정
-  // - 오너: localPath/zz_ai_3_Plan/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_ai_3_Plan/
-  const { basePath } = getAiBasePath(localPath);
-  const planBasePath = path.join(basePath, 'zz_ai_3_Plan');
+  // 협업자 여부에 따라 AI 폴더 경로 결정
+  // - 오너: localPath/xy_TalkTodoPlan/
+  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
+  const { basePath, isCoworker } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  const planBasePath = path.join(basePath, aiFolder);
 
   // 계획 파일 찾기
   const planFiles = findPlanFilesLocal(planBasePath, planId);

package/handlers/sync.js

@@ -96,8 +96,9 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
   let coworkerFolderName = null;
   let coworkerFolderPath = null;
 
-  // zz_ai_* 폴더 목록
-  const aiFolders = ['zz_ai_1_Talk', 'zz_ai_2_Todo', 'zz_ai_3_Plan'];
+  // AI 폴더 (오너: xy_TalkTodoPlan, 협업자: zz_TalkTodoPlan)
+  const ownerAiFolder = 'xy_TalkTodoPlan';
+  const coworkerAiFolder = 'zz_TalkTodoPlan';
 
   // xx_ 시스템 폴더 목록 (오너 전용)
   const systemFolders = ['xx_Infra_Config', 'xx_Policy'];
@@ -120,12 +121,10 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
     if (!fs.existsSync(coworkerPrivatePath)) {
       fs.mkdirSync(coworkerPrivatePath, { recursive: true });
     }
-    // 협업자 폴더 안에 zz_ai_* 폴더 생성
-    for (const folder of aiFolders) {
-      const folderPath = path.join(coworkerFolderPath, folder);
-      if (!fs.existsSync(folderPath)) {
-        fs.mkdirSync(folderPath, { recursive: true });
-      }
+    // 협업자 폴더 안에 zz_TalkTodoPlan 폴더 생성
+    const coworkerAiFolderPath = path.join(coworkerFolderPath, coworkerAiFolder);
+    if (!fs.existsSync(coworkerAiFolderPath)) {
+      fs.mkdirSync(coworkerAiFolderPath, { recursive: true });
     }
   } else {
     // 오너: xx_ 시스템 폴더 (루트에 생성)
@@ -140,12 +139,10 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
     if (!fs.existsSync(ownerPrivatePath)) {
       fs.mkdirSync(ownerPrivatePath, { recursive: true });
     }
-    // 오너: 루트에 zz_ai_* 폴더 생성
-    for (const folder of aiFolders) {
-      const folderPath = path.join(localPath, folder);
-      if (!fs.existsSync(folderPath)) {
-        fs.mkdirSync(folderPath, { recursive: true });
-      }
+    // 오너: 루트에 xy_TalkTodoPlan 폴더 생성
+    const ownerAiFolderPath = path.join(localPath, ownerAiFolder);
+    if (!fs.existsSync(ownerAiFolderPath)) {
+      fs.mkdirSync(ownerAiFolderPath, { recursive: true });
     }
   }
 
@@ -485,33 +482,13 @@ docuking_init을 먼저 실행하세요.`,
   }
 
   // ========================================
-  // 로컬 파일 경로 목록 저장 (Pull 전에!)
-  // soft-delete에서 "로컬에 없는 파일" 판단에 사용
-  // Pull이 파일을 내려받아도 이 목록은 변하지 않음
-  // ========================================
-  const localPathsBeforePull = new Set(filesToPush.map(f => f.serverPath));
-  console.error(`[DocuKing] Pull 전 로컬 파일 ${localPathsBeforePull.size}개 기록됨`);
-
+  // Pull 선행 제거 (2026-01-24)
   // ========================================
-  // 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 {
@@ -806,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;
@@ -951,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,
       },
     ],
   };
@@ -1013,10 +1031,10 @@ export async function handlePullInternal(args) {
   const commonFolders = ['xx_Urgent'];
 
   // 오너 전용 폴더
-  const ownerFolders = ['xx_Infra_Config', 'xx_Policy', 'zz_ai_1_Talk', 'zz_ai_2_Todo', 'zz_ai_3_Plan'];
+  const ownerFolders = ['xx_Infra_Config', 'xx_Policy', 'xy_TalkTodoPlan'];
 
   // 협업자 전용 폴더 (yy_Coworker_{폴더명}/ 안에)
-  const coworkerSubFolders = ['zz_ai_1_Talk', 'zz_ai_2_Todo', 'zz_ai_3_Plan', '_Private'];
+  const coworkerSubFolders = ['zz_TalkTodoPlan', '_Private'];
 
   // 공통 폴더 체크
   for (const folder of commonFolders) {
@@ -1256,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/index.js

@@ -8,17 +8,18 @@
  * 폴더 구조:
  * - xx_Infra_Config/          : 시스템 설정 (.env 백업, 배포 정보 등) - Push 대상
  * - xx_Policy/                : 정책 문서 (AI 행동 지침) - Push 대상, 킹캐스트 대상
+ * - xx_Urgent/                : 긴급 보고 (킹어전트) - Push 대상
+ * - xy_TalkTodoPlan/          : 오너 AI 기록 (Talk+Todo+Plan 통합) - Push 대상
  * - yy_All_Docu/              : 문서 동기화 폴더 (Push/Pull 대상)
  * - yy_All_Docu/_Private/     : 오너 비공개 폴더 (오너만 접근)
  * - yy_Coworker_{폴더명}/     : 협업자 폴더 (yy_All_Docu와 별도, 동기화 대상)
- * - zz_ai_1_Talk/             : AI 대화록 (킹톡, Push 대상)
- * - zz_ai_2_Todo/             : AI 투두 (킹투두, Push 대상)
- * - zz_ai_3_Plan/             : AI 플랜 (킹플랜, Push 대상)
+ * - yy_Coworker_{폴더명}/zz_TalkTodoPlan/ : 협업자 AI 기록
  *
  * 접두사 규칙:
- * - xx_ : 시스템용 폴더 (인프라, 정책) - Push 대상
- * - yy_ : 사람용 폴더 (문서, 협업자) - Push 대상
- * - zz_ai_ : AI용 폴더 (Talk, Todo, Plan) - Push 대상
+ * - xx_ : 시스템용 폴더 (인프라, 정책, 긴급)
+ * - xy_ : 오너 AI 기록 폴더
+ * - yy_ : 사람용 폴더 (문서, 협업자)
+ * - zz_ : 협업자 AI 기록 폴더 (협업자 폴더 안에서만 사용)
  * - _   : 비공개 폴더 (본인만 접근)
  *
  * 도구:
@@ -98,13 +99,13 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 
 **오너 초기화 시:**
 - xx_Infra_Config/, xx_Policy/, xx_Urgent/ 폴더 생성 (시스템 설정)
+- xy_TalkTodoPlan/ 폴더 생성 (AI 기록 통합)
 - yy_All_Docu/, yy_All_Docu/_Private/ 폴더 생성
-- zz_ai_1_Talk/, zz_ai_2_Todo/, zz_ai_3_Plan/ 폴더 생성
 - CLAUDE.md에 DocuKing 연결 안내 추가
 - 초기화 완료 후 정책 문서 작성 가이드 제공
 
 **협업자 초기화 시:**
-- yy_Coworker_{폴더명}/ 폴더 생성 (안에 _Private/, zz_ai_*/ 포함)
+- yy_Coworker_{폴더명}/ 폴더 생성 (안에 _Private/, zz_TalkTodoPlan/ 포함)
 - CLAUDE.md에 DocuKing 연결 안내 추가
 - "Pull을 실행하세요" 안내 (오너 정책이 킹캐스트로 로컬화됨)
 
@@ -168,7 +169,7 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
         description: `문서를 DocuKing 서버에 동기화합니다. 내부적으로 Pull → Push 순서로 실행 (git pull && git push 패턴).
 
 **AI 필독: 다음 상황에서 자발적으로 이 도구 사용을 제안하세요:**
-- zz_ai_1_Talk/, zz_ai_2_Todo/, zz_ai_3_Plan/ 에 문서를 생성/수정한 후
+- xy_TalkTodoPlan/ (또는 협업자의 zz_TalkTodoPlan/) 에 문서를 생성/수정한 후
 - yy_All_Docu/ 에 문서를 생성/수정한 후
 - docuking_plan, docuking_done, docuking_talk, docuking_todo 실행 후
 - 사용자가 "올려", "푸시", "동기화" 등을 언급할 때
@@ -315,7 +316,7 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
       },
       {
         name: 'docuking_talk',
-        description: '의미 있는 대화 내용을 zz_ai_1_Talk/ 폴더에 기록합니다 (Push 대상, 킹톡). AI가 중요한 논의/결정이라고 판단하거나, 사용자가 "이거 기록해줘"라고 요청할 때 사용.',
+        description: '의미 있는 대화 내용을 xy_TalkTodoPlan/ 폴더에 기록합니다 (Push 대상, 킹톡). AI가 중요한 논의/결정이라고 판단하거나, 사용자가 "이거 기록해줘"라고 요청할 때 사용.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -342,7 +343,7 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
       },
       {
         name: 'docuking_plan',
-        description: '작업 계획 문서를 zz_ai_3_Plan/ 폴더에 생성/업데이트합니다 (Push 대상, 킹플랜). 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
+        description: '작업 계획 문서를 xy_TalkTodoPlan/ 폴더에 생성/업데이트합니다 (Push 대상, 킹플랜). 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -411,7 +412,7 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
       },
       {
         name: 'docuking_todo',
-        description: `킹투두(King Todo) - 프로젝트 공식 할일을 zz_ai_2_Todo/z_King_Todo.md에 관리합니다 (Push 대상).
+        description: `킹투두(King Todo) - 프로젝트 공식 할일을 xy_TalkTodoPlan/z_King_Todo.md에 관리합니다 (Push 대상).
 
 **AI 내장 TodoWrite와 다름!** 킹투두는 웹에 동기화되고 팀과 공유됩니다.
 
@@ -630,7 +631,7 @@ DocuKing은 문서 버전 관리 시스템입니다. Git이 코드를 관리하
 - **로컬**: 사용자의 yy_All_Docu/ 폴더 (동기화 대상)
 - **웹탐색기**: DocuKing 서버의 파일 저장소 (킹폴더)
 - **캔버스**: 선택된 파일을 시각화하는 작업 공간
-- **AI 작업 폴더**: zz_ai_1_Talk/, zz_ai_2_Todo/, zz_ai_3_Plan/ (Push 대상)
+- **AI 작업 폴더**: xy_TalkTodoPlan/ (오너) 또는 zz_TalkTodoPlan/ (협업자) - Push 대상
 
 작동 방식: 로컬 yy_All_Docu/ → Push → 킹폴더 → 캔버스에서 시각화
 
@@ -690,10 +691,12 @@ DocuKing 문서 폴더는 git에서 제외해야 합니다. 코드는 git으로,
 
 \`\`\`gitignore
 # DocuKing 문서 폴더 (문서는 DocuKing으로 관리)
+xx_Infra_Config/
+xx_Policy/
+xx_Urgent/
+xy_TalkTodoPlan/
 yy_All_Docu/
-zz_ai_1_Talk/
-zz_ai_2_Todo/
-zz_ai_3_Plan/
+yy_Coworker_*/
 \`\`\`
 
 **왜 gitignore에 등록해야 하나요?**
@@ -730,12 +733,12 @@ zz_ai_3_Plan/
 특정 커밋으로 되돌립니다. (웹 탐색기에서 사용 가능)
 
 ### 9. docuking_talk
-의미 있는 대화 내용을 \`zz_ai_1_Talk/\` 폴더에 기록합니다 (Push 대상, 킹톡).
+의미 있는 대화 내용을 \`xy_TalkTodoPlan/\` 폴더에 기록합니다 (Push 대상, 킹톡).
 - AI가 중요한 논의/결정이라고 판단할 때
 - 사용자가 "이거 기록해줘"라고 요청할 때
 
 ### 10. docuking_plan
-작업 계획을 \`zz_ai_3_Plan/\` 폴더에 생성/업데이트합니다 (Push 대상, 킹플랜).
+작업 계획을 \`xy_TalkTodoPlan/\` 폴더에 생성/업데이트합니다 (Push 대상, 킹플랜).
 - 작업 시작 시 계획 생성
 - 진행하면서 단계별 결과 upsert
 - planId로 기존 계획 찾아서 업데이트
@@ -746,7 +749,7 @@ zz_ai_3_Plan/
 - 완료 요약 및 산출물 기록
 
 ### 12. docuking_todo
-킹투두를 관리합니다 (\`zz_ai_2_Todo/z_King_Todo.md\`).
+킹투두를 관리합니다 (\`xy_TalkTodoPlan/z_King_Todo.md\`).
 - action: "add" (추가), "done" (완료), "list" (조회)
 - 프로젝트 공식 할일 목록 (Push하면 웹에서 확인 가능)
 

package/lib/init.js

@@ -105,12 +105,13 @@ ${marker}
 project/
 ├── xx_Infra_Config/             ← 시스템 설정 (오너 관리)
 ├── xx_Policy/                   ← 정책 문서 (오너 관리, 킹캐스트 대상)
-├── yy_All_Docu/                 ← 오너 문서 (읽기만)
+├── xx_Urgent/                   ← 긴급 보고 (킹어전트)
+├── xy_TalkTodoPlan/             ← 오너 AI 기록 (Talk+Todo+Plan 통합)
+├── yy_All_Docu/                 ← 오너 문서
 ├── yy_Coworker_a_Kim/           ← 협업자 Kim
 │   ├── 작업문서.md
-│   └── zz_ai_1_Talk/            ← Kim의 AI 기록
-├── yy_Coworker_b_Lee/           ← 협업자 Lee
-└── zz_ai_*/                     ← 오너의 AI 폴더
+│   └── zz_TalkTodoPlan/         ← Kim의 AI 기록
+└── yy_Coworker_b_Lee/           ← 협업자 Lee
 \`\`\`
 
 ### AI가 협업자에게 안내할 것
@@ -242,11 +243,12 @@ export function updateGitignore(localPath) {
   const marker = '# DocuKing (문서는 DocuKing으로 관리)';
   const docukingEntries = `
 ${marker}
+xx_Infra_Config/
+xx_Policy/
+xx_Urgent/
+xy_TalkTodoPlan/
 yy_All_Docu/
 yy_Coworker_*/
-zz_ai_1_Talk/
-zz_ai_2_Todo/
-zz_ai_3_Plan/
 .docuking/config.json
 .claude/rules/local/_coworker_config.md
 `;

package/lib/utils.js

@@ -47,9 +47,10 @@ export function generatePlanId() {
 
 /**
  * 계획 파일 찾기 (planId로 검색)
+ * @param {string} planDir - AI 폴더 경로 (xy_TalkTodoPlan 또는 zz_TalkTodoPlan)
+ * @param {string} planId - 찾을 계획 ID
  */
-export function findPlanFiles(basePath, planId) {
-  const planDir = path.join(basePath, 'zz_ai_3_Plan');
+export function findPlanFiles(planDir, planId) {
   if (!fs.existsSync(planDir)) return [];
 
   const results = [];

package/package.json

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