docuking-mcp 2.0.0 → 2.0.2

package/README.md

@@ -1,29 +1,23 @@
-# docurepo-mcp
+# docuking-mcp
 
-문서용 Git - AI가 문서를 Push/Pull 할 수 있게 해주는 MCP 서버
+AI가 문서를 Push/Pull 할 수 있게 해주는 MCP 서버
 
 ## 설치
 
 ```bash
-npx docurepo-mcp
+npx docuking-mcp
 ```
 
 ## MCP 설정
 
-### Claude Code (CLI/VSCode)
-
-`~/.claude.json` 또는 프로젝트의 `.claude/settings.json`에 추가:
+### Claude Code
 
 ```json
 {
   "mcpServers": {
-    "docurepo": {
+    "docuking": {
       "command": "npx",
-      "args": ["docurepo-mcp"],
-      "env": {
-        "DOCUREPO_API_KEY": "sk_xxx",
-        "DOCUREPO_REPOS": "{\"C:/my-project\":\"project-uuid\"}"
-      }
+      "args": ["-y", "docuking-mcp"]
     }
   }
 }
@@ -36,13 +30,9 @@ npx docurepo-mcp
 ```json
 {
   "mcpServers": {
-    "docurepo": {
+    "docuking": {
       "command": "npx",
-      "args": ["docurepo-mcp"],
-      "env": {
-        "DOCUREPO_API_KEY": "sk_xxx",
-        "DOCUREPO_REPOS": "{\"C:/my-project\":\"project-uuid\"}"
-      }
+      "args": ["-y", "docuking-mcp"]
     }
   }
 }
@@ -50,68 +40,39 @@ npx docurepo-mcp
 
 ## 도구
 
-### docurepo_init
-
-프로젝트를 DocuRepo에 연결합니다.
-
-```
-docurepo_init(projectId, localPath)
-```
-
-- Z_DocuRepo/ 폴더 생성
-- 레포 매핑 추가 안내
-
-### docurepo_push
-
-Z_DocuRepo/ 폴더의 문서를 서버에 업로드합니다.
-
-```
-docurepo_push(localPath, [filePath])
-```
-
-- "피터해" 요청 시 사용
-- filePath 생략 시 전체 동기화
-
-### docurepo_pull
-
-서버에서 문서를 다운로드합니다.
-
-```
-docurepo_pull(localPath, [filePath])
-```
-
-- "피터에서 가져와" 요청 시 사용
-- filePath 생략 시 전체 동기화
-
-### docurepo_list
-
-서버에 저장된 파일 목록을 조회합니다.
-
-```
-docurepo_list(localPath)
-```
-
-## 환경변수
-
-| 변수 | 설명 |
+| 도구 | 설명 |
 |------|------|
-| DOCUREPO_API_KEY | API 키 (필수) |
-| DOCUREPO_API_ENDPOINT | API 엔드포인트 (기본: https://peeter.kr/api) |
-| DOCUREPO_REPOS | 로컬경로 → projectId 매핑 (JSON) |
-
-## 동기화 대상
+| docuking_init | 프로젝트 연결, yy_All_Docu/ 및 zz_ai_* 폴더 생성 |
+| docuking_push | yy_All_Docu/ → 서버 업로드 |
+| docuking_pull | 서버 → yy_All_Docu/ 다운로드 |
+| docuking_status | 동기화 상태 확인 |
+| docuking_list | 서버 파일 목록 조회 |
+| docuking_log | 커밋 히스토리 조회 |
+| docuking_diff | 버전 간 차이 비교 |
+| docuking_rollback | 특정 커밋으로 롤백 |
+| docuking_talk | AI 대화록 저장 (zz_ai_Talk/) |
+| docuking_plan | 작업 계획 관리 (zzz_ai_Plan/) |
+| docuking_done | 작업 완료 처리 |
+| docuking_todo | 킹투두 관리 (zz_ai_Todo/) |
+
+## 폴더 구조
 
 ```
 프로젝트/
-├── src/            ← 대상 아님
-├── 기타/           ← 대상 아님
-└── Z_DocuRepo/     ← 대상 (이 폴더만)
-    ├── 정책/
-    ├── 회의록/
-    └── 뭐든지/
+├── yy_All_Docu/              ← 동기화 대상 (Push/Pull)
+│   └── yy_Coworker_{이름}/   ← 협업자 작업 폴더
+├── zz_ai_Talk/               ← AI 대화록 (로컬 전용)
+├── zz_ai_Todo/               ← AI 투두 (로컬 전용)
+└── zzz_ai_Plan/               ← AI 플랜 (로컬 전용)
 ```
 
-**Z_DocuRepo/ 폴더만** 동기화됩니다.
+**접두사 규칙:**
+- `yy_*`: 동기화 대상
+- `zz_*`: 로컬 전용 (Push 제외)
+
+## 웹사이트
+
+https://docuking.ai
 
 ## 라이센스
 

package/index.js

@@ -8,9 +8,9 @@
  * 폴더 구조:
  * - yy_All_Docu/        : 킹폴더와 동기화 (Push/Pull 대상)
  * - yy_All_Docu/yy_{이름}/ : 협업자 폴더 (동기화 대상)
- * - zz_AI_Talk/         : AI 대화록 (로컬 전용, 킹톡)
- * - zz_AI_Todo/         : AI 투두 (로컬 전용, 킹투두)
- * - zz_AI_Plan/         : AI 플랜 (로컬 전용, 킹플랜)
+ * - zz_ai_Talk/         : AI 대화록 (로컬 전용, 킹톡)
+ * - zz_ai_Todo/         : AI 투두 (로컬 전용, 킹투두)
+ * - zzz_ai_Plan/         : AI 플랜 (로컬 전용, 킹플랜)
  *
  * 접두사 규칙:
  * - yy_* : 동기화 대상 (Push/Pull)
@@ -37,6 +37,10 @@ import crypto from 'crypto';
 // 환경변수에서 API 엔드포인트 설정 (키는 로컬 config에서 읽음)
 const API_ENDPOINT = process.env.DOCUKING_API_ENDPOINT || 'https://docuking.ai/api';
 
+// 파일 크기 제한 (50MB) - Base64 인코딩 시 66MB, 서버 제한 200MB 이내
+const MAX_FILE_SIZE_MB = 50;
+const MAX_FILE_SIZE_BYTES = MAX_FILE_SIZE_MB * 1024 * 1024;
+
 /**
  * 로컬 프로젝트의 .docuking/config.json에서 설정 읽기
  *
@@ -141,7 +145,7 @@ docuking_done({
 ### 절대 규칙
 - **작업 시작 전 반드시 \`docuking_plan\` 호출**
 - **작업 완료 후 반드시 \`docuking_done\` 호출**
-- 결과는 \`zz_AI_Plan/\`에 자동 저장됨 (로컬 전용)
+- 결과는 \`zzz_ai_Plan/\`에 자동 저장됨 (로컬 전용)
 `;
 
   try {
@@ -423,7 +427,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'docuking_talk',
-        description: '의미 있는 대화 내용을 zz_AI_Talk/ 폴더에 기록합니다 (로컬 전용, 킹톡). AI가 중요한 논의/결정이라고 판단하거나, 사용자가 "이거 기록해줘"라고 요청할 때 사용.',
+        description: '의미 있는 대화 내용을 zz_ai_Talk/ 폴더에 기록합니다 (로컬 전용, 킹톡). AI가 중요한 논의/결정이라고 판단하거나, 사용자가 "이거 기록해줘"라고 요청할 때 사용.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -450,7 +454,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'docuking_plan',
-        description: '작업 계획 문서를 zz_AI_Plan/ 폴더에 생성/업데이트합니다 (로컬 전용, 킹플랜). 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
+        description: '작업 계획 문서를 zzz_ai_Plan/ 폴더에 생성/업데이트합니다 (로컬 전용, 킹플랜). 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -519,7 +523,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'docuking_todo',
-        description: `킹투두(King Todo) - 프로젝트 공식 할일을 zz_AI_Todo/z_King_Todo.md에 관리합니다 (로컬 전용).
+        description: `킹투두(King Todo) - 프로젝트 공식 할일을 zz_ai_Todo/z_King_Todo.md에 관리합니다 (로컬 전용).
 
 **AI 내장 TodoWrite와 다름!** 킹투두는 웹에 동기화되고 팀과 공유됩니다.
 
@@ -593,7 +597,7 @@ DocuKing은 문서 버전 관리 시스템입니다. Git이 코드를 관리하
 - **로컬**: 사용자의 yy_All_Docu/ 폴더 (동기화 대상)
 - **웹탐색기**: DocuKing 서버의 파일 저장소 (킹폴더)
 - **캔버스**: 선택된 파일을 시각화하는 작업 공간
-- **AI 작업 폴더**: zz_AI_Talk/, zz_AI_Todo/, zz_AI_Plan/ (로컬 전용)
+- **AI 작업 폴더**: zz_ai_Talk/, zz_ai_Todo/, zzz_ai_Plan/ (로컬 전용)
 
 작동 방식: 로컬 yy_All_Docu/ → Push → 킹폴더 → 캔버스에서 시각화
 
@@ -628,9 +632,9 @@ DocuKing 문서 폴더는 git에서 제외해야 합니다. 코드는 git으로,
 \`\`\`gitignore
 # DocuKing 문서 폴더 (문서는 DocuKing으로 관리)
 yy_All_Docu/
-zz_AI_Talk/
-zz_AI_Todo/
-zz_AI_Plan/
+zz_ai_Talk/
+zz_ai_Todo/
+zzz_ai_Plan/
 \`\`\`
 
 **왜 gitignore에 등록해야 하나요?**
@@ -666,12 +670,12 @@ zz_AI_Plan/
 특정 커밋으로 되돌립니다. (웹 탐색기에서 사용 가능)
 
 ### 9. docuking_talk
-의미 있는 대화 내용을 \`zz_AI_Talk/\` 폴더에 기록합니다 (로컬 전용, 킹톡).
+의미 있는 대화 내용을 \`zz_ai_Talk/\` 폴더에 기록합니다 (로컬 전용, 킹톡).
 - AI가 중요한 논의/결정이라고 판단할 때
 - 사용자가 "이거 기록해줘"라고 요청할 때
 
 ### 10. docuking_plan
-작업 계획을 \`zz_AI_Plan/\` 폴더에 생성/업데이트합니다 (로컬 전용, 킹플랜).
+작업 계획을 \`zzz_ai_Plan/\` 폴더에 생성/업데이트합니다 (로컬 전용, 킹플랜).
 - 작업 시작 시 계획 생성
 - 진행하면서 단계별 결과 upsert
 - planId로 기존 계획 찾아서 업데이트
@@ -743,7 +747,7 @@ DocuKing에는 **오너(Owner)**와 **참여자(Co-worker)** 두 가지 권한
 
 **예시:**
 \`\`\`
-z_DocuKing/
+yy_All_Docu/
 ├── 정책/
 │   └── README.md  ← 오너가 작성
 ├── 기획/
@@ -757,7 +761,7 @@ z_DocuKing/
 **특징:**
 - 프로젝트에 초대받아 참여한 사람
 - **읽기**: 전체 문서 Pull 가능 (오너의 문서도 볼 수 있음)
-- **쓰기**: 자신의 폴더(\`zz_Coworker_{이름}/\`)에만 Push 가능
+- **쓰기**: 자신의 폴더(\`yy_All_Docu/yy_Coworker_{이름}/\`)에만 Push 가능
 - API Key: \`sk_cw_\`로 시작
 - 프로젝트 설정 변경 불가능
 
@@ -766,36 +770,39 @@ z_DocuKing/
 2. MCP 설정 (한 번만)
 3. 프로젝트 연결 (\`docuking_init\`)
 4. Pull로 오너의 문서 가져오기 (\`docuking_pull\`)
-5. 내 폴더에 문서 작성 (\`zz_Coworker_{이름}/\`)
+5. 내 폴더에 문서 작성 (\`yy_All_Docu/yy_Coworker_{이름}/\`)
 6. Push (\`docuking_push\`)
 
-**폴더 구조 (z_DocuKing과 zz_Coworker는 같은 레벨):**
+**폴더 구조:**
 \`\`\`
 프로젝트/
-├── src/                        ← 소스 코드 (git 관리)
-├── z_DocuKing/                 ← 오너의 문서 공간
+├── src/                              ← 소스 코드 (git 관리)
+├── yy_All_Docu/                      ← 동기화 대상 (Push/Pull)
 │   ├── 정책/
-│   │   └── README.md           ← 오너의 파일 (읽기만 가능)
-│   └── 기획/
-│       └── 요구사항.md         ← 오너의 파일 (읽기만 가능)
-└── zz_Coworker_김개발/         ← 참여자 "김개발"의 폴더 (z_DocuKing과 같은 레벨!)
-    ├── 제안서.md               ← 여기에만 Push 가능
-    └── 수정안.md               ← 여기에만 Push 가능
+│   │   └── README.md                 ← 오너의 파일 (읽기만 가능)
+│   ├── 기획/
+│   │   └── 요구사항.md               ← 오너의 파일 (읽기만 가능)
+│   └── yy_Coworker_김개발/           ← 참여자 "김개발"의 폴더
+│       ├── 제안서.md                 ← 여기에만 Push 가능
+│       └── 수정안.md                 ← 여기에만 Push 가능
+├── zz_ai_Talk/                       ← AI 대화록 (로컬 전용)
+├── zz_ai_Todo/                       ← AI 투두 (로컬 전용)
+└── zzz_ai_Plan/                       ← AI 플랜 (로컬 전용)
 \`\`\`
 
 **중요 규칙:**
-- 코워커 폴더(\`zz_Coworker_{이름}/\`)는 z_DocuKing과 같은 레벨에 생성됨
-- 참여자는 Pull로 z_DocuKing/ 폴더의 오너 문서를 볼 수 있음
+- 코워커 폴더(\`yy_Coworker_{이름}/\`)는 yy_All_Docu/ 안에 생성됨
+- 참여자는 Pull로 yy_All_Docu/ 폴더의 오너 문서를 볼 수 있음
 - 참여자는 자신의 폴더에만 Push 가능
 - \`docuking_status\`로 현재 권한과 작업 폴더 확인 가능
 
 **참여자가 오너의 파일을 수정하고 싶을 때:**
-1. Pull로 오너의 파일을 로컬에 가져옴 (z_DocuKing/에 저장됨)
+1. Pull로 오너의 파일을 로컬에 가져옴 (yy_All_Docu/에 저장됨)
 2. 내용을 참고하여 자신의 폴더에 수정 제안 작성
-   - 예: \`zz_Coworker_김개발/정책_README_수정제안.md\`로 작성 후 Push
+   - 예: \`yy_All_Docu/yy_Coworker_김개발/정책_README_수정제안.md\`로 작성 후 Push
 
 **AI가 참여자에게 안내해야 할 내용:**
-- 참여자의 작업 폴더는 \`zz_Coworker_{이름}/\` (z_DocuKing이 아님)
+- 참여자의 작업 폴더는 \`yy_All_Docu/yy_Coworker_{이름}/\`
 - 오너의 파일을 직접 수정할 수 없으므로, 제안서 형태로 작성하도록 안내
 
 ## AI 응답 가이드 (중요!)
@@ -849,7 +856,7 @@ Push 완료! 총 10개 파일 중 3개 업로드, 6개 스킵(변경 없음), 1
 ### 핵심 원칙 (AI 행동 지침)
 
 1. **프로젝트 = 폴더**: 하나의 폴더가 하나의 프로젝트
-2. **각 폴더마다 z_DocuKing/ 생성**: 여러 폴더를 각각 연결 가능
+2. **각 폴더마다 yy_All_Docu/ 생성**: 여러 폴더를 각각 연결 가능
 3. **현재 열려있는 폴더 기준**: 명령어는 현재 작업 중인 폴더에 적용
 4. **커밋 메시지 필수**: push 시 반드시 message 파라미터 포함
 5. **변경 없는 파일 자동 스킵**: 해시 비교로 변경 감지, 스킵된 파일은 결과에 명시
@@ -879,7 +886,7 @@ AI: (결정이 내려졌으므로 docuking_talk 호출)
     })
 \`\`\`
 
-**저장 위치:** \`z_DocuKing/z_Talk/YYYY-MM-DD_HHMM__제목.md\` (플랫 구조)
+**저장 위치:** \`zz_ai_Talk/YYYY-MM-DD_HHMM__제목.md\` (플랫 구조, 로컬 전용)
 
 ### 작업 계획 관리 (docuking_plan, docuking_done)
 
@@ -930,7 +937,7 @@ AI: docuking_done({
     })
 \`\`\`
 
-**저장 위치:** \`z_DocuKing/zz_Plan_Result/YYYY-MM-DD_HHMM__제목__planId.md\` (플랫 구조)
+**저장 위치:** \`zzz_ai_Plan/YYYY-MM-DD_HHMM__제목__planId.md\` (플랫 구조, 로컬 전용)
 
 **핵심 가치:**
 - AI 세션이 끊겨도 (컴팩션, 세션 종료) 다음 AI가 계획 문서를 보고 이어서 작업 가능
@@ -985,7 +992,7 @@ AI: docuking_done({
 2. 프로젝트 ID, 이름, API 키 확인 (사용자가 제공하거나 요청)
 3. \`docuking_init(projectId, projectName, apiKey, localPath)\` 호출
 4. 연결 완료 메시지 전달:
-   - "DocuKing 연결 완료! 📁 z_DocuKing/ 폴더가 생성되었습니다."
+   - "DocuKing 연결 완료! 📁 yy_All_Docu/ 폴더가 생성되었습니다."
    - "이제 'DocuKing에 올려줘' 명령을 사용할 수 있습니다."
 
 **⚠️ 매우 중요:**
@@ -998,28 +1005,28 @@ AI: docuking_done({
 **핵심 개념:**
 - **프로젝트 = 하나의 폴더**
 - 한 컴퓨터에서 여러 폴더를 각각 다른 DocuKing 프로젝트와 연결 가능
-- 각 폴더마다 \`z_DocuKing/\` 폴더가 독립적으로 생성됨
+- 각 폴더마다 \`yy_All_Docu/\` 폴더가 독립적으로 생성됨
 
 **예시:**
 \`\`\`
 C:\\Projects\\MyApp\\
 ├── src/
 ├── package.json
-└── z_DocuKing/          ← 프로젝트 A와 연결
+├── yy_All_Docu/          ← 프로젝트 A와 연결 (동기화)
+├── zz_ai_Talk/           ← AI 대화록 (로컬 전용)
+├── zz_ai_Todo/           ← AI 투두 (로컬 전용)
+└── zzz_ai_Plan/           ← AI 플랜 (로컬 전용)
 
 C:\\Projects\\MyWebsite\\
 ├── pages/
 ├── components/
-└── z_DocuKing/          ← 프로젝트 B와 연결
-
-D:\\Work\\ClientProject\\
-├── docs/
-└── z_DocuKing/          ← 프로젝트 C와 연결
+├── yy_All_Docu/          ← 프로젝트 B와 연결
+└── zz_ai_*/              ← 로컬 전용 폴더들
 \`\`\`
 
 **AI가 해야 할 일:**
 - 각 폴더에서 \`docuking_init\`을 호출하면 해당 폴더만 연결됨
-- 다른 폴더로 이동하면 해당 폴더의 \`z_DocuKing/\`가 사용됨
+- 다른 폴더로 이동하면 해당 폴더의 \`yy_All_Docu/\`가 사용됨
 - 여러 프로젝트를 동시에 관리할 수 있음을 인지하고, 현재 작업 중인 폴더 기준으로 동작
 
 **고급: DOCUKING_REPOS 환경변수 (선택사항)**
@@ -1136,12 +1143,21 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
     fs.mkdirSync(mainFolderPath, { recursive: true });
   }
 
+  // zz_ai_* 폴더도 함께 생성 (로컬 전용)
+  const aiFolders = ['zz_ai_Talk', 'zz_ai_Todo', 'zzz_ai_Plan'];
+  for (const folder of aiFolders) {
+    const folderPath = path.join(localPath, folder);
+    if (!fs.existsSync(folderPath)) {
+      fs.mkdirSync(folderPath, { recursive: true });
+    }
+  }
+
   let coworkerFolderName = null;
   let coworkerFolderPath = null;
 
   if (isCoworker) {
-    // 협업자: yy_All_Docu/yy_{이름}/ 폴더 추가 생성
-    coworkerFolderName = `yy_${coworkerName}`;
+    // 협업자: yy_All_Docu/yy_Coworker_{이름}/ 폴더 추가 생성
+    coworkerFolderName = `yy_Coworker_${coworkerName}`;
     coworkerFolderPath = path.join(mainFolderPath, coworkerFolderName);
     if (!fs.existsSync(coworkerFolderPath)) {
       fs.mkdirSync(coworkerFolderPath, { recursive: true });
@@ -1193,9 +1209,9 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
 
 폴더 구조:
 - yy_All_Docu/     : 동기화 대상 (킹폴더)
-- zz_AI_Talk/      : AI 대화록 (로컬 전용, 킹톡)
-- zz_AI_Todo/      : AI 투두 (로컬 전용, 킹투두)
-- zz_AI_Plan/      : AI 플랜 (로컬 전용, 킹플랜)`,
+- zz_ai_Talk/      : AI 대화록 (로컬 전용, 킹톡)
+- zz_ai_Todo/      : AI 투두 (로컬 전용, 킹투두)
+- zzz_ai_Plan/      : AI 플랜 (로컬 전용, 킹플랜)`,
         },
       ],
     };
@@ -1255,15 +1271,15 @@ Git처럼 무엇을 변경했는지 명확히 작성해주세요.
   const coworkerMatch = apiKey.match(/^sk_[a-f0-9]+_cw_([^_]+)_/);
   const isCoworker = !!coworkerMatch;
   const coworkerName = coworkerMatch ? coworkerMatch[1] : null;
-  const coworkerFolderName = isCoworker ? `yy_${coworkerName}` : null;
+  const coworkerFolderName = isCoworker ? `yy_Coworker_${coworkerName}` : null;
 
-  // 작업 폴더 결정: 모두 yy_All_Docu/ 사용, 협업자는 yy_All_Docu/yy_{이름}/ 에서 작업
+  // 작업 폴더 결정: 모두 yy_All_Docu/ 사용, 협업자는 yy_All_Docu/yy_Coworker_{이름}/ 에서 작업
   const mainFolderPath = path.join(localPath, 'yy_All_Docu');
   let workingPath;
   let serverPathPrefix = ''; // 서버에 저장될 때 경로 접두사
 
   if (isCoworker) {
-    // 협업자: yy_All_Docu/yy_{이름}/ 폴더에서 Push
+    // 협업자: yy_All_Docu/yy_Coworker_{이름}/ 폴더에서 Push
     workingPath = path.join(mainFolderPath, coworkerFolderName);
     serverPathPrefix = `${coworkerFolderName}/`;
 
@@ -1308,13 +1324,14 @@ docuking_init을 먼저 실행하세요.`,
         };
       }
 
-      // 서버 경로: 코워커는 zz_Coworker_{이름}/파일경로, 오너는 파일경로
+      // 서버 경로: 코워커는 yy_Coworker_{이름}/파일경로, 오너는 파일경로
       const serverFilePath = serverPathPrefix + filePath;
       filesToPush.push({ path: filePath, serverPath: serverFilePath, fullPath, fileType });
     }
   } else {
-    // 전체 파일 - 제외된 파일 목록도 수집
-    collectFiles(workingPath, '', filesToPush, excludedFiles);
+    // 전체 파일 - 제외된 파일 및 대용량 파일 목록도 수집
+    const largeFiles = [];
+    collectFiles(workingPath, '', filesToPush, excludedFiles, largeFiles);
 
     // 서버 경로 추가
     for (const file of filesToPush) {
@@ -1324,6 +1341,15 @@ docuking_init을 먼저 실행하세요.`,
     if (isCoworker) {
       console.log(`[DocuKing] 코워커 Push: ${filesToPush.length}개 파일 (${coworkerFolderName}/)`);
     }
+
+    // 대용량 파일 경고
+    if (largeFiles.length > 0) {
+      console.error(`\n[DocuKing] ⚠️ 대용량 파일 ${largeFiles.length}개 제외됨 (${MAX_FILE_SIZE_MB}MB 초과):`);
+      for (const f of largeFiles) {
+        console.error(`  - ${f.path} (${f.sizeMB}MB)`);
+      }
+      console.error(`💡 대용량 파일은 Google Drive, NAS 등 별도 방법으로 공유하세요.\n`);
+    }
   }
 
   if (filesToPush.length === 0) {
@@ -1337,6 +1363,9 @@ docuking_init을 먼저 실행하세요.`,
     };
   }
 
+  // 총 용량 계산
+  const totalSizeMB = filesToPush.reduce((sum, f) => sum + (f.sizeMB || 0), 0);
+
   // 파일 업로드 (진행률 표시)
   const results = [];
   const total = filesToPush.length;
@@ -1344,7 +1373,7 @@ docuking_init을 먼저 실행하세요.`,
   let skipped = 0;
 
   // 시작 안내 메시지 출력 (AI가 사용자에게 전달할 수 있도록)
-  console.error(`[DocuKing] Push 시작: ${total}개 파일`);
+  console.error(`[DocuKing] Push 시작: ${total}개 파일 (총 ${totalSizeMB.toFixed(1)}MB)`);
   console.error(`[DocuKing] 💡 실시간 진행상황은 DocuKing 웹(https://docuking.ai)에서 확인하세요`);
 
   // Sync 시작 알림 (웹에서 프로그레스바 표시용)
@@ -1392,8 +1421,14 @@ docuking_init을 먼저 실행하세요.`,
   for (const file of filesToPush) {
     current++;
     const progress = `${current}/${total}`;
+    const sizeInfo = file.sizeMB >= 1 ? ` (${file.sizeMB.toFixed(1)}MB)` : '';
     processedLocalPaths.add(file.serverPath);
 
+    // 1MB 이상 파일은 업로드 시작 시 로그 출력 (사용자가 진행 상황 파악 가능)
+    if (file.sizeMB >= 1) {
+      console.error(`[DocuKing] ${progress} 업로드 중: ${file.path}${sizeInfo}`);
+    }
+
     try {
       // 파일 해시 계산 (변경 감지)
       let fileHash;
@@ -1475,7 +1510,7 @@ docuking_init을 먼저 실행하세요.`,
               },
               body: JSON.stringify({
                 projectId,
-                path: file.serverPath, // 서버 경로 (코워커는 zz_Coworker_{이름}/파일경로)
+                path: file.serverPath, // 서버 경로 (코워커는 yy_Coworker_{이름}/파일경로)
                 content,
                 encoding, // 'utf-8' 또는 'base64'
                 message, // 커밋 메시지
@@ -1966,8 +2001,9 @@ function hasAllDocuFolder(projectPath) {
 
 // 유틸: 디렉토리 재귀 탐색
 // excludedFiles: 제외된 파일 목록을 수집할 배열 (선택)
+// largeFiles: 대용량 파일 목록을 수집할 배열 (선택)
 // zz_* 폴더는 로컬 전용이므로 동기화에서 제외
-function collectFiles(basePath, relativePath, results, excludedFiles = null) {
+function collectFiles(basePath, relativePath, results, excludedFiles = null, largeFiles = null) {
   const fullPath = path.join(basePath, relativePath);
   const entries = fs.readdirSync(fullPath, { withFileTypes: true });
 
@@ -1980,7 +2016,7 @@ function collectFiles(basePath, relativePath, results, excludedFiles = null) {
         console.error(`[DocuKing] 제외됨: ${entryRelPath}/ (zz_* 폴더 - 로컬 전용)`);
         continue;
       }
-      collectFiles(basePath, entryRelPath, results, excludedFiles);
+      collectFiles(basePath, entryRelPath, results, excludedFiles, largeFiles);
     } else if (entry.isFile()) {
       const fileType = getFileType(entry.name);
 
@@ -1993,10 +2029,25 @@ function collectFiles(basePath, relativePath, results, excludedFiles = null) {
         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: path.join(fullPath, entry.name),
+        fullPath: fileFullPath,
         fileType, // 'text' 또는 'binary'
+        sizeMB: fileSizeMB, // 진행률 표시용
       });
     }
   }
@@ -2057,7 +2108,7 @@ async function handleStatus(args) {
   const coworkerMatch = apiKey.match(/^sk_[a-f0-9]+_cw_([^_]+)_/);
   const isCoworker = !!coworkerMatch;
   const coworkerName = coworkerMatch ? coworkerMatch[1] : null;
-  const coworkerFolderName = isCoworker ? `yy_${coworkerName}` : null;
+  const coworkerFolderName = isCoworker ? `yy_Coworker_${coworkerName}` : null;
 
   // 권한 정보 구성
   let permissionInfo = '';
@@ -2252,8 +2303,8 @@ function generatePlanId() {
 async function handleTodo(args) {
   const { localPath, action, todo, todoId } = args;
 
-  // zz_AI_Todo 폴더 경로 (로컬 전용, 킹투두)
-  const todoBasePath = path.join(localPath, 'zz_AI_Todo');
+  // zz_ai_Todo 폴더 경로 (로컬 전용, 킹투두)
+  const todoBasePath = path.join(localPath, 'zz_ai_Todo');
   const todoFilePath = path.join(todoBasePath, 'z_King_Todo.md');
 
   // 폴더 생성
@@ -2414,7 +2465,7 @@ async function handleTodo(args) {
           text: `📋 킹투두 미결: 없음
 
 ✅ 완료: ${completedCount}개
-📁 전체 기록: zz_AI_Todo/z_King_Todo.md`,
+📁 전체 기록: zz_ai_Todo/z_King_Todo.md`,
         }],
       };
     }
@@ -2429,7 +2480,7 @@ async function handleTodo(args) {
 ${listText}
 
 ✅ 완료: ${completedCount}개
-📁 전체 기록: zz_AI_Todo/z_King_Todo.md`,
+📁 전체 기록: zz_ai_Todo/z_King_Todo.md`,
       }],
     };
   }
@@ -2443,8 +2494,8 @@ ${listText}
 async function handleTalk(args) {
   const { localPath, title, content, tags = [] } = args;
 
-  // zz_AI_Talk 폴더 경로 (로컬 전용, 킹톡)
-  const talkBasePath = path.join(localPath, 'zz_AI_Talk');
+  // zz_ai_Talk 폴더 경로 (로컬 전용, 킹톡)
+  const talkBasePath = path.join(localPath, 'zz_ai_Talk');
 
   // 날짜 기반 파일명 생성
   const { fileName, timestamp } = generateDateFileName(title);
@@ -2496,8 +2547,8 @@ ${content}
 async function handlePlan(args) {
   const { localPath, planId, title, goal, steps = [], notes } = args;
 
-  // zz_AI_Plan 폴더 경로 (로컬 전용, 킹플랜)
-  const planBasePath = path.join(localPath, 'zz_AI_Plan');
+  // zzz_ai_Plan 폴더 경로 (로컬 전용, 킹플랜)
+  const planBasePath = path.join(localPath, 'zzz_ai_Plan');
 
   // 기존 계획 업데이트 또는 새 계획 생성
   let targetPlanId = planId;
@@ -2646,8 +2697,8 @@ function findPlanFiles(basePath, planId) {
 async function handleDone(args) {
   const { localPath, planId, summary, artifacts = [] } = args;
 
-  // zz_AI_Plan 폴더 경로 (로컬 전용, 킹플랜)
-  const planBasePath = path.join(localPath, 'zz_AI_Plan');
+  // zzz_ai_Plan 폴더 경로 (로컬 전용, 킹플랜)
+  const planBasePath = path.join(localPath, 'zzz_ai_Plan');
 
   // 계획 파일 찾기
   const planFiles = findPlanFiles(planBasePath, planId);

package/package.json

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

package/DEPLOY_TASK.md

@@ -1,33 +0,0 @@
-# MCP 패키지 배포 작업지시
-
-## 작업 개요
-docurepo-mcp 패키지 v1.0.5를 npm에 배포
-
-## 변경 사항
-- Push 시 Sync 상태 API 호출 추가
-  - 시작: `POST /projects/:id/sync/start` (totalFiles 전달)
-  - 진행: `POST /projects/:id/sync/progress` (5개마다)
-  - 완료: `POST /projects/:id/sync/complete`
-
-## 배포 절차
-
-### 1. npm 로그인 확인
-```bash
-cd c:\2025_Project\docurepo\docurepo-mcp
-npm whoami
-```
-- 로그인 안되어 있으면: `npm login`
-
-### 2. 패키지 배포
-```bash
-npm publish
-```
-
-### 3. 배포 확인
-```bash
-npm view docurepo-mcp version
-```
-- 1.0.5가 나오면 성공
-
-## 완료 후
-- 사용자가 `npx docurepo-mcp` 재실행하면 새 버전 적용됨