docuking-mcp 1.1.0 → 1.2.1

package/index.js

@@ -396,6 +396,23 @@ DocuKing은 문서 버전 관리 시스템입니다. Git이 코드를 관리하
 2. 프로젝트 연결은 각 폴더마다 (폴더별로 다른 프로젝트 ID)
 3. 이미 MCP가 작동 중이면 재시작 없이 바로 프로젝트 연결 가능
 
+## .gitignore 설정 (중요!)
+
+DocuKing 문서 폴더는 git에서 제외해야 합니다. 코드는 git으로, 문서는 DocuKing으로 분리 관리합니다.
+
+\`\`\`gitignore
+# DocuKing 문서 폴더 (문서는 DocuKing으로 관리)
+*_DocuKing_*
+*_Docuking_*
+z_DocuKing/
+zz_Coworker_*/
+\`\`\`
+
+**왜 gitignore에 등록해야 하나요?**
+- 문서와 코드의 버전 관리를 분리
+- git 저장소 크기 최적화 (대용량 문서 제외)
+- DocuKing이 문서 버전 관리를 전담
+
 ## MCP 도구 목록
 
 ### 1. docuking_init
@@ -515,7 +532,7 @@ z_DocuKing/
 **특징:**
 - 프로젝트에 초대받아 참여한 사람
 - **읽기**: 전체 문서 Pull 가능 (오너의 문서도 볼 수 있음)
-- **쓰기**: 자신의 폴더(\`Co-worker/{이름}/\`)에만 Push 가능
+- **쓰기**: 자신의 폴더(\`zz_Coworker_{이름}/\`)에만 Push 가능
 - API Key: \`sk_cw_\`로 시작
 - 프로젝트 설정 변경 불가능
 
@@ -524,39 +541,37 @@ z_DocuKing/
 2. MCP 설정 (한 번만)
 3. 프로젝트 연결 (\`docuking_init\`)
 4. Pull로 오너의 문서 가져오기 (\`docuking_pull\`)
-5. 내 폴더에 문서 작성 (\`Co-worker/{이름}/\`)
+5. 내 폴더에 문서 작성 (\`zz_Coworker_{이름}/\`)
 6. Push (\`docuking_push\`)
 
-**폴더 구조:**
+**폴더 구조 (z_DocuKing과 zz_Coworker는 같은 레벨):**
 \`\`\`
-z_DocuKing/
-├── 정책/
-│   └── README.md  ← 오너의 파일 (읽기만 가능)
-├── 기획/
-│   └── 요구사항.md  ← 오너의 파일 (읽기만 가능)
-└── Co-worker/
-    └── 김개발/  ← 참여자 "김개발"의 폴더
-        ├── 제안서.md  ← 여기에만 Push 가능
-        └── 수정안.md  ← 여기에만 Push 가능
+프로젝트/
+├── src/                        ← 소스 코드 (git 관리)
+├── z_DocuKing/                 ← 오너의 문서 공간
+│   ├── 정책/
+│   │   └── README.md           ← 오너의 파일 (읽기만 가능)
+│   └── 기획/
+│       └── 요구사항.md         ← 오너의 파일 (읽기만 가능)
+└── zz_Coworker_김개발/         ← 참여자 "김개발"의 폴더 (z_DocuKing과 같은 레벨!)
+    ├── 제안서.md               ← 여기에만 Push 가능
+    └── 수정안.md               ← 여기에만 Push 가능
 \`\`\`
 
 **중요 규칙:**
-- 참여자가 오너의 폴더를 Pull해서 가지고 있어도, Push할 때는 자동으로 자신의 폴더만 필터링됨
-- 참여자가 다른 폴더에 Push 시도 시 오류 메시지 표시
-- \`docuking_status\`로 현재 권한 확인 가능
+- 코워커 폴더(\`zz_Coworker_{이름}/\`)는 z_DocuKing과 같은 레벨에 생성됨
+- 참여자는 Pull로 z_DocuKing/ 폴더의 오너 문서를 볼 수 있음
+- 참여자는 자신의 폴더에만 Push 가능
+- \`docuking_status\`로 현재 권한과 작업 폴더 확인 가능
 
 **참여자가 오너의 파일을 수정하고 싶을 때:**
-1. 오너의 파일을 Pull해서 로컬에 가져옴 (예: \`정책/README.md\`)
-2. 로컬에서 수정함 (로컬 파일이므로 수정 가능)
-3. Push 시도 → ❌ 오류 발생: "협업자는 Co-worker/{이름}/ 폴더에만 Push할 수 있습니다"
-4. **해결 방법**: 수정한 내용을 자신의 폴더에 새 파일로 작성
-   - 예: \`정책/README.md\`를 수정했다면
-   - → \`Co-worker/김개발/정책_README_수정제안.md\`로 작성 후 Push
+1. Pull로 오너의 파일을 로컬에 가져옴 (z_DocuKing/에 저장됨)
+2. 내용을 참고하여 자신의 폴더에 수정 제안 작성
+   - 예: \`zz_Coworker_김개발/정책_README_수정제안.md\`로 작성 후 Push
 
 **AI가 참여자에게 안내해야 할 내용:**
-- 참여자가 Push를 요청하면, 파일이 \`Co-worker/{이름}/\` 폴더 안에 있는지 확인
-- 다른 폴더에 있는 파일을 Push하려고 하면, 오류 메시지를 명확히 설명하고 해결 방법 제시
-- 오너의 파일을 수정하고 싶다면, 자신의 폴더에 제안서 형태로 작성하도록 안내
+- 참여자의 작업 폴더는 \`zz_Coworker_{이름}/\` (z_DocuKing이 아님)
+- 오너의 파일을 직접 수정할 수 없으므로, 제안서 형태로 작성하도록 안내
 
 ## AI 응답 가이드 (중요!)
 
@@ -942,24 +957,42 @@ Git처럼 무엇을 변경했는지 명확히 작성해주세요.
   const projectId = projectInfo.projectId;
   const projectName = projectInfo.projectName;
 
-  // DocuKing 폴더 찾기
-  const folderName = findDocuKingFolder(localPath);
-  if (!folderName) {
-    return {
-      content: [
-        {
-          type: 'text',
-          text: `오류: DocuKing 폴더가 없습니다.
-docuking_init을 먼저 실행하세요.`,
-        },
-      ],
-    };
-  }
-  const docuKingPath = path.join(localPath, folderName);
-
   // Co-worker 권한은 API Key 형식에서 판단 (sk_xxx_cw_이름_)
   const coworkerMatch = API_KEY.match(/^sk_[a-f0-9]+_cw_([^_]+)_/);
-  const allowedPathPrefix = coworkerMatch ? `Co-worker/${coworkerMatch[1]}/` : null;
+  const isCoworker = !!coworkerMatch;
+  const coworkerName = coworkerMatch ? coworkerMatch[1] : null;
+  const coworkerFolderName = isCoworker ? `zz_Coworker_${coworkerName}` : null;
+
+  // 작업 폴더 결정: 코워커는 zz_Coworker_{이름}/, 오너는 z_DocuKing/
+  let workingPath;
+  let serverPathPrefix = ''; // 서버에 저장될 때 경로 접두사
+
+  if (isCoworker) {
+    // 코워커: zz_Coworker_{이름}/ 폴더 사용 (z_DocuKing과 같은 레벨)
+    workingPath = path.join(localPath, coworkerFolderName);
+    serverPathPrefix = `${coworkerFolderName}/`;
+
+    if (!fs.existsSync(workingPath)) {
+      // 폴더가 없으면 생성
+      fs.mkdirSync(workingPath, { recursive: true });
+      console.log(`[DocuKing] 코워커 폴더 생성: ${coworkerFolderName}/`);
+    }
+  } else {
+    // 오너: z_DocuKing/ 폴더 사용
+    const folderName = findDocuKingFolder(localPath);
+    if (!folderName) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `오류: DocuKing 폴더가 없습니다.
+docuking_init을 먼저 실행하세요.`,
+          },
+        ],
+      };
+    }
+    workingPath = path.join(localPath, folderName);
+  }
 
   // 파일 목록 수집
   const filesToPush = [];
@@ -967,7 +1000,7 @@ docuking_init을 먼저 실행하세요.`,
 
   if (filePath) {
     // 특정 파일만
-    const fullPath = path.join(docuKingPath, filePath);
+    const fullPath = path.join(workingPath, filePath);
     if (fs.existsSync(fullPath) && fs.statSync(fullPath).isFile()) {
       const fileType = getFileType(filePath);
       if (fileType === 'excluded') {
@@ -981,52 +1014,21 @@ docuking_init을 먼저 실행하세요.`,
         };
       }
 
-      // 참여자인 경우 경로 체크
-      if (allowedPathPrefix) {
-        const normalizedPath = filePath.toLowerCase();
-        const normalizedPrefix = allowedPathPrefix.toLowerCase();
-        if (!normalizedPath.startsWith(normalizedPrefix)) {
-          return {
-            content: [
-              {
-                type: 'text',
-                text: `오류: 협업자는 ${allowedPathPrefix} 폴더에만 Push할 수 있습니다.\n\n요청한 파일: ${filePath}\n허용된 경로: ${allowedPathPrefix}\n\n💡 참고: 오너의 파일을 로컬에서 수정하셨다면, 수정 내용을 ${allowedPathPrefix} 폴더에 새 파일로 작성해주세요.\n예: 정책/README.md를 수정했다면 → ${allowedPathPrefix}정책_README_수정제안.md`,
-              },
-            ],
-          };
-        }
-      }
-
-      filesToPush.push({ path: filePath, fullPath, fileType });
+      // 서버 경로: 코워커는 zz_Coworker_{이름}/파일경로, 오너는 파일경로
+      const serverFilePath = serverPathPrefix + filePath;
+      filesToPush.push({ path: filePath, serverPath: serverFilePath, fullPath, fileType });
     }
   } else {
     // 전체 파일 - 제외된 파일 목록도 수집
-    collectFiles(docuKingPath, '', filesToPush, excludedFiles);
-
-    // 참여자인 경우 허용된 경로의 파일만 필터링
-    if (allowedPathPrefix) {
-      const normalizedPrefix = allowedPathPrefix.toLowerCase();
-      const filteredFiles = filesToPush.filter(file => {
-        const normalizedPath = file.path.toLowerCase();
-        return normalizedPath.startsWith(normalizedPrefix);
-      });
+    collectFiles(workingPath, '', filesToPush, excludedFiles);
 
-      if (filteredFiles.length === 0) {
-        return {
-          content: [
-            {
-              type: 'text',
-              text: `Push할 파일이 없습니다.\n\n협업자는 ${allowedPathPrefix} 폴더에만 Push할 수 있습니다.\n\n현재 폴더 구조를 확인하고, 해당 폴더에 파일을 배치한 후 다시 시도해주세요.`,
-            },
-          ],
-        };
-      }
-
-      // 필터링된 파일로 교체
-      filesToPush.length = 0;
-      filesToPush.push(...filteredFiles);
+    // 서버 경로 추가
+    for (const file of filesToPush) {
+      file.serverPath = serverPathPrefix + file.path;
+    }
 
-      console.log(`[DocuKing] 협업자 권한: ${filteredFiles.length}개 파일만 Push (${allowedPathPrefix})`);
+    if (isCoworker) {
+      console.log(`[DocuKing] 코워커 Push: ${filesToPush.length}개 파일 (${coworkerFolderName}/)`);
     }
   }
 
@@ -1135,7 +1137,7 @@ docuking_init을 먼저 실행하세요.`,
               },
               body: JSON.stringify({
                 projectId,
-                path: file.path,
+                path: file.serverPath, // 서버 경로 (코워커는 zz_Coworker_{이름}/파일경로)
                 content,
                 encoding, // 'utf-8' 또는 'base64'
                 message, // 커밋 메시지
@@ -1300,11 +1302,10 @@ async function handlePull(args) {
   const projectId = projectInfo.projectId;
 
   // DocuKing 폴더 찾기 (없으면 기본값으로 생성)
-  let folderName = findDocuKingFolder(localPath);
-  if (!folderName) {
-    folderName = 'z_DocuKing';
+  let ownerFolderName = findDocuKingFolder(localPath);
+  if (!ownerFolderName) {
+    ownerFolderName = 'z_DocuKing';
   }
-  const docuKingPath = path.join(localPath, folderName);
 
   // 파일 목록 조회
   let files = [];
@@ -1370,7 +1371,18 @@ async function handlePull(args) {
       }
 
       const data = await response.json();
-      const fullPath = path.join(docuKingPath, file.path);
+
+      // 서버 경로에 따라 로컬 저장 경로 결정
+      // zz_Coworker_{이름}/으로 시작하면 해당 폴더에, 아니면 z_DocuKing/에 저장
+      let fullPath;
+      const coworkerPrefixMatch = file.path.match(/^(zz_Coworker_[^/]+)\//);
+      if (coworkerPrefixMatch) {
+        // 코워커 폴더 파일: 프로젝트 루트에 zz_Coworker_{이름}/ 폴더로 저장
+        fullPath = path.join(localPath, file.path);
+      } else {
+        // 오너 폴더 파일: z_DocuKing/ 폴더에 저장
+        fullPath = path.join(localPath, ownerFolderName, file.path);
+      }
 
       // 디렉토리 생성
       fs.mkdirSync(path.dirname(fullPath), { recursive: true });
@@ -1625,20 +1637,20 @@ async function handleStatus(args) {
   const coworkerMatch = API_KEY.match(/^sk_[a-f0-9]+_cw_([^_]+)_/);
   const isCoworker = !!coworkerMatch;
   const coworkerName = coworkerMatch ? coworkerMatch[1] : null;
-  const allowedPathPrefix = isCoworker ? `Co-worker/${coworkerName}/` : null;
+  const coworkerFolderName = isCoworker ? `zz_Coworker_${coworkerName}` : null;
 
   // 권한 정보 구성
   let permissionInfo = '';
   if (isCoworker) {
     permissionInfo = `\n\n## 현재 권한: 참여자 (Co-worker)
 - 이름: ${coworkerName}
-- 읽기 권한: 전체 문서 (제한 없음)
-- 쓰기 권한: ${allowedPathPrefix} 폴더만
-- 설명: 다른 폴더의 파일을 Pull해서 가지고 있어도, Push할 때는 자동으로 ${allowedPathPrefix} 폴더의 파일만 Push됩니다.`;
+- 읽기 권한: 전체 문서 (Pull로 z_DocuKing/ 폴더의 문서 가져오기 가능)
+- 쓰기 권한: ${coworkerFolderName}/ 폴더만 (z_DocuKing과 같은 레벨)
+- 설명: 코워커 전용 폴더에서 작업하면 자동으로 서버에 Push됩니다.`;
   } else {
     permissionInfo = `\n\n## 현재 권한: 오너 (Owner)
 - 읽기 권한: 전체 문서
-- 쓰기 권한: 전체 문서 (제한 없음)
+- 쓰기 권한: z_DocuKing/ 폴더 전체 (제한 없음)
 - 설명: 프로젝트의 모든 폴더에 Push할 수 있습니다.`;
   }
 
@@ -1662,29 +1674,35 @@ async function handleStatus(args) {
   }
 
   // 로컬 파일 목록 조회
-  const folderName = findDocuKingFolder(localPath);
-  const docuKingPath = folderName ? path.join(localPath, folderName) : null;
   let localFiles = [];
-  if (docuKingPath && fs.existsSync(docuKingPath)) {
-    collectFiles(docuKingPath, '', localFiles);
-  }
+  let pushableFiles = [];
 
-  // 참여자인 경우 Push 가능한 파일만 필터링
-  let pushableFiles = localFiles;
-  if (allowedPathPrefix) {
-    const normalizedPrefix = allowedPathPrefix.toLowerCase();
-    pushableFiles = localFiles.filter(file => {
-      const normalizedPath = file.path.toLowerCase();
-      return normalizedPath.startsWith(normalizedPrefix);
-    });
+  if (isCoworker) {
+    // 코워커: zz_Coworker_{이름}/ 폴더에서 파일 수집
+    const coworkerPath = path.join(localPath, coworkerFolderName);
+    if (fs.existsSync(coworkerPath)) {
+      collectFiles(coworkerPath, '', localFiles);
+    }
+    pushableFiles = localFiles; // 코워커는 자기 폴더의 모든 파일 Push 가능
+  } else {
+    // 오너: z_DocuKing/ 폴더에서 파일 수집
+    const folderName = findDocuKingFolder(localPath);
+    const docuKingPath = folderName ? path.join(localPath, folderName) : null;
+    if (docuKingPath && fs.existsSync(docuKingPath)) {
+      collectFiles(docuKingPath, '', localFiles);
+    }
+    pushableFiles = localFiles; // 오너는 모든 파일 Push 가능
   }
 
   const projectNameInfo = projectName ? ` (${projectName})` : '';
+  const workingFolder = isCoworker ? coworkerFolderName : 'z_DocuKing';
   const statusText = `DocuKing 동기화 상태
 
 **프로젝트**: ${projectId}${projectNameInfo}
+**작업 폴더**: ${workingFolder}/
 **로컬 파일**: ${localFiles.length}개
-**서버 파일**: ${serverFiles.length}개${allowedPathPrefix ? `\n**Push 가능한 파일**: ${pushableFiles.length}개 (${allowedPathPrefix})` : ''}${permissionInfo}
+**서버 파일**: ${serverFiles.length}개
+**Push 가능한 파일**: ${pushableFiles.length}개${permissionInfo}
 
 ## 사용 가능한 작업
 - **Push**: docuking_push({ localPath, message: "..." })

package/package.json

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