docuking-mcp 1.2.2 → 1.2.4

package/index.js

@@ -272,7 +272,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'docuking_plan',
-        description: '작업 계획 문서를 z_PlanToResult/ 폴더에 생성하거나 업데이트합니다. 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
+        description: '작업 계획 문서를 z_Plan_Result/ 폴더에 생성하거나 업데이트합니다. 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -413,10 +413,34 @@ zz_Coworker_*/
 - git 저장소 크기 최적화 (대용량 문서 제외)
 - DocuKing이 문서 버전 관리를 전담
 
+## AI 필수 작업 흐름 (매우 중요!)
+
+### MCP 서버 추가 시 (claude mcp add 명령 실행 후)
+1. \`claude mcp add docuking ...\` 명령 실행
+2. 사용자에게 "재시작 후 아래 명령을 다시 붙여넣으세요" 안내
+3. 재시작 후 \`docuking_init\` 실행
+
+### docuking_init 실행 후 (⚠️ 필수!)
+1. init 결과에서 \`DOCUKING_REPOS\` 값 확인
+2. **AI가 직접** \`~/.claude.json\` 파일을 Edit 도구로 수정:
+   - 해당 프로젝트의 \`mcpServers.docuking.env\`에 \`DOCUKING_REPOS\` 추가
+   - 기존 env에 추가하는 것이므로 DOCUKING_API_KEY는 유지
+3. 사용자에게 "재시작 후 push 가능" 안내
+
+**예시 (AI가 수행할 Edit):**
+\`\`\`json
+// ~/.claude.json의 해당 프로젝트 mcpServers.docuking.env
+{
+  "DOCUKING_API_KEY": "sk_xxx...",
+  "DOCUKING_REPOS": "{\\"경로\\":{\\"id\\":\\"프로젝트ID\\",\\"name\\":\\"이름\\"}}"
+}
+\`\`\`
+
 ## MCP 도구 목록
 
 ### 1. docuking_init
 프로젝트를 DocuKing에 연결합니다.
+**중요:** init 후 AI가 ~/.claude.json에 DOCUKING_REPOS를 추가해야 함!
 
 ### 2. docuking_push
 로컬 문서를 서버에 업로드합니다. Git의 add + commit + push를 한 번에 수행.
@@ -446,7 +470,7 @@ zz_Coworker_*/
 - 사용자가 "이거 기록해줘"라고 요청할 때
 
 ### 10. docuking_plan
-작업 계획을 \`z_PlanToResult/\` 폴더에 생성/업데이트합니다.
+작업 계획을 \`z_Plan_Result/\` 폴더에 생성/업데이트합니다.
 - 작업 시작 시 계획 생성
 - 진행하면서 단계별 결과 upsert
 - planId로 기존 계획 찾아서 업데이트
@@ -654,7 +678,7 @@ AI: (결정이 내려졌으므로 docuking_talk 호출)
     })
 \`\`\`
 
-**저장 위치:** \`z_Talk/YYYY/MM/YYYY-MM-DD_HHMM__제목.md\`
+**저장 위치:** \`z_DocuKing/z_Talk/YYYY/MM/YYYY-MM-DD_HHMM__제목.md\`
 
 ### 작업 계획 관리 (docuking_plan, docuking_done)
 
@@ -705,7 +729,7 @@ AI: docuking_done({
     })
 \`\`\`
 
-**저장 위치:** \`z_PlanToResult/YYYY/MM/YYYY-MM-DD_HHMM__제목__planId.md\`
+**저장 위치:** \`z_DocuKing/z_Plan_Result/YYYY/MM/YYYY-MM-DD_HHMM__제목__planId.md\`
 
 **핵심 가치:**
 - AI 세션이 끊겨도 (컴팩션, 세션 종료) 다음 AI가 계획 문서를 보고 이어서 작업 가능
@@ -930,7 +954,7 @@ MCP 설정에 다음을 추가하세요:
 💡 참여자는 ${folderName}/ 폴더에만 Push할 수 있습니다.
    오너의 문서는 Pull로 읽을 수 있지만 수정은 제안서 형태로 작성하세요.
 
-MCP 설정에 레포 매핑 추가 필요:
+⚠️ AI 필수 작업: ~/.claude.json의 docuking MCP env에 DOCUKING_REPOS 추가 필요
 "DOCUKING_REPOS": "${repoConfig}"`,
         },
       ],
@@ -953,7 +977,7 @@ MCP 설정에 레포 매핑 추가 필요:
 - "DocuKing에 올려줘" → 로컬 문서를 서버에 Push
 - "DocuKing에서 가져와" → 서버 문서를 로컬로 Pull
 
-MCP 설정에 레포 매핑 추가 필요:
+⚠️ AI 필수 작업: ~/.claude.json의 docuking MCP env에 DOCUKING_REPOS 추가 필요
 "DOCUKING_REPOS": "${repoConfig}"`,
         },
       ],
@@ -1058,16 +1082,47 @@ docuking_init을 먼저 실행하세요.`,
       filesToPush.push({ path: filePath, serverPath: serverFilePath, fullPath, fileType });
     }
   } else {
-    // 전체 파일 - 제외된 파일 목록도 수집
-    collectFiles(workingPath, '', filesToPush, excludedFiles);
-
-    // 서버 경로 추가
-    for (const file of filesToPush) {
-      file.serverPath = serverPathPrefix + file.path;
-    }
-
     if (isCoworker) {
+      // 코워커: 본인 폴더만 수집
+      collectFiles(workingPath, '', filesToPush, excludedFiles);
+
+      // 서버 경로 추가
+      for (const file of filesToPush) {
+        file.serverPath = serverPathPrefix + file.path;
+      }
       console.log(`[DocuKing] 코워커 Push: ${filesToPush.length}개 파일 (${coworkerFolderName}/)`);
+    } else {
+      // 오너: z_DocuKing/ + 모든 zz_Coworker_*/ 폴더 수집
+      const docuKingFolderName = findDocuKingFolder(localPath);
+
+      // 1. z_DocuKing/ 폴더 수집
+      if (docuKingFolderName) {
+        const docuKingPath = path.join(localPath, docuKingFolderName);
+        const docuKingFiles = [];
+        collectFiles(docuKingPath, '', docuKingFiles, excludedFiles);
+
+        for (const file of docuKingFiles) {
+          file.serverPath = file.path; // 오너 폴더는 서버 경로 = 파일 경로
+          filesToPush.push(file);
+        }
+      }
+
+      // 2. 모든 zz_Coworker_*/ 폴더 수집
+      const coworkerFolders = findCoworkerFolders(localPath);
+      for (const cwFolder of coworkerFolders) {
+        const cwPath = path.join(localPath, cwFolder);
+        const cwFiles = [];
+        collectFiles(cwPath, '', cwFiles, excludedFiles);
+
+        for (const file of cwFiles) {
+          file.serverPath = `${cwFolder}/${file.path}`; // 코워커 폴더명 포함
+          file.path = `${cwFolder}/${file.path}`; // 로컬 경로도 폴더명 포함
+          file.fullPath = path.join(cwPath, file.path.replace(`${cwFolder}/`, ''));
+          filesToPush.push(file);
+        }
+      }
+
+      console.log(`[DocuKing] 오너 Push: ${filesToPush.length}개 파일 (z_DocuKing/ + ${coworkerFolders.length}개 코워커 폴더)`);
     }
   }
 
@@ -1588,10 +1643,29 @@ function getFileType(fileName) {
   return 'binary';
 }
 
-// 유틸: DocuKing 폴더 찾기 (docuking 포함, 대소문자 무관)
+// 유틸: DocuKing 폴더 찾기
+// 우선순위: z_DocuKing > Z_DocuKing > 기타 docuking 포함 폴더
 function findDocuKingFolder(projectPath) {
   try {
     const entries = fs.readdirSync(projectPath, { withFileTypes: true });
+
+    // 1순위: z_DocuKing 또는 Z_DocuKing (정확한 이름)
+    for (const entry of entries) {
+      if (entry.isDirectory() && (entry.name === 'z_DocuKing' || entry.name === 'Z_DocuKing')) {
+        return entry.name;
+      }
+    }
+
+    // 2순위: z_ 또는 Z_로 시작하고 docuking 포함
+    for (const entry of entries) {
+      if (entry.isDirectory() &&
+          (entry.name.startsWith('z_') || entry.name.startsWith('Z_')) &&
+          entry.name.toLowerCase().includes('docuking')) {
+        return entry.name;
+      }
+    }
+
+    // 3순위: docuking 포함하는 아무 폴더 (하위 호환)
     for (const entry of entries) {
       if (entry.isDirectory() && entry.name.toLowerCase().includes('docuking')) {
         return entry.name;
@@ -1603,6 +1677,22 @@ function findDocuKingFolder(projectPath) {
   return null;
 }
 
+// 유틸: 모든 zz_Coworker_* 폴더 찾기
+function findCoworkerFolders(projectPath) {
+  const folders = [];
+  try {
+    const entries = fs.readdirSync(projectPath, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory() && entry.name.startsWith('zz_Coworker_')) {
+        folders.push(entry.name);
+      }
+    }
+  } catch (e) {
+    // 디렉토리 읽기 실패
+  }
+  return folders;
+}
+
 // 유틸: 디렉토리 재귀 탐색
 // excludedFiles: 제외된 파일 목록을 수집할 배열 (선택)
 function collectFiles(basePath, relativePath, results, excludedFiles = null) {
@@ -1872,8 +1962,8 @@ function generatePlanId() {
 async function handleTalk(args) {
   const { localPath, title, content, tags = [] } = args;
 
-  // z_Talk 폴더 경로
-  const talkBasePath = path.join(localPath, 'z_Talk');
+  // z_Talk 폴더 경로 (z_DocuKing 아래)
+  const talkBasePath = path.join(localPath, 'z_DocuKing', 'z_Talk');
 
   // 날짜 기반 파일명 생성
   const { fileName, yearMonth, timestamp } = generateDateFileName(title);
@@ -1926,8 +2016,8 @@ ${content}
 async function handlePlan(args) {
   const { localPath, planId, title, goal, steps = [], notes } = args;
 
-  // z_PlanToResult 폴더 경로
-  const planBasePath = path.join(localPath, 'z_PlanToResult');
+  // z_Plan_Result 폴더 경로 (z_DocuKing 아래)
+  const planBasePath = path.join(localPath, 'z_DocuKing', 'z_Plan_Result');
 
   // 기존 계획 업데이트 또는 새 계획 생성
   let targetPlanId = planId;
@@ -2077,8 +2167,8 @@ function findPlanFiles(basePath, planId) {
 async function handleDone(args) {
   const { localPath, planId, summary, artifacts = [] } = args;
 
-  // z_PlanToResult 폴더 경로
-  const planBasePath = path.join(localPath, 'z_PlanToResult');
+  // z_Plan_Result 폴더 경로 (z_DocuKing 아래)
+  const planBasePath = path.join(localPath, 'z_DocuKing', 'z_Plan_Result');
 
   // 계획 파일 찾기
   const planFiles = findPlanFiles(planBasePath, planId);

package/package.json

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