docuking-mcp 1.9.2 → 2.0.1

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

@@ -1,12 +1,23 @@
 #!/usr/bin/env node
 
 /**
- * DocuKing MCP Server
+ * DocuKing MCP Server v2.0
  *
  * AI 시대의 문서 협업 플랫폼 - AI가 문서를 Push/Pull 할 수 있게 해주는 MCP 서버
  *
+ * 폴더 구조:
+ * - yy_All_Docu/        : 킹폴더와 동기화 (Push/Pull 대상)
+ * - yy_All_Docu/yy_{이름}/ : 협업자 폴더 (동기화 대상)
+ * - zz_ai_Talk/         : AI 대화록 (로컬 전용, 킹톡)
+ * - zz_ai_Todo/         : AI 투두 (로컬 전용, 킹투두)
+ * - zzz_ai_Plan/         : AI 플랜 (로컬 전용, 킹플랜)
+ *
+ * 접두사 규칙:
+ * - yy_* : 동기화 대상 (Push/Pull)
+ * - zz_* : 로컬 전용 (동기화 안 됨)
+ *
  * 도구:
- * - docuking_init: 레포 연결, Z_DocuKing/ 폴더 생성
+ * - docuking_init: 레포 연결, yy_All_Docu/ 폴더 생성
  * - docuking_push: 로컬 → 서버
  * - docuking_pull: 서버 → 로컬
  */
@@ -130,7 +141,7 @@ docuking_done({
 ### 절대 규칙
 - **작업 시작 전 반드시 \`docuking_plan\` 호출**
 - **작업 완료 후 반드시 \`docuking_done\` 호출**
-- 결과는 \`z_DocuKing/zz_Plan_Result/\`에 자동 저장됨 (플랫 구조)
+- 결과는 \`zzz_ai_Plan/\`에 자동 저장됨 (로컬 전용)
 `;
 
   try {
@@ -248,7 +259,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
     tools: [
       {
         name: 'docuking_init',
-        description: '프로젝트를 DocuKing에 연결합니다. .docuking/config.json에 설정 저장, z_DocuKing/ 폴더 생성.\n\n**필수 파라미터:**\n- projectId: 프로젝트 UUID\n- projectName: 프로젝트 이름 (표시용)\n- apiKey: API 키 (sk_xxx 형식)\n- localPath: 로컬 프로젝트 경로',
+        description: '프로젝트를 DocuKing에 연결합니다. .docuking/config.json에 설정 저장, yy_All_Docu/ 폴더 생성.\n\n**필수 파라미터:**\n- projectId: 프로젝트 UUID\n- projectName: 프로젝트 이름 (표시용)\n- apiKey: API 키 (sk_xxx 형식)\n- localPath: 로컬 프로젝트 경로',
         inputSchema: {
           type: 'object',
           properties: {
@@ -274,7 +285,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'docuking_push',
-        description: 'z_DocuKing/ 폴더의 문서를 서버에 업로드합니다. "DocuKing에 올려줘" 요청 시 사용. Git의 add + commit + push를 한 번에 수행.',
+        description: 'yy_All_Docu/ 폴더의 문서를 서버에 업로드합니다. "DocuKing에 올려줘" 요청 시 사용. Git의 add + commit + push를 한 번에 수행.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -300,7 +311,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'docuking_pull',
-        description: '서버에서 문서를 다운로드하여 z_DocuKing/ 폴더에 저장합니다. "DocuKing에서 가져와" 요청 시 사용.',
+        description: '서버에서 문서를 다운로드하여 yy_All_Docu/ 폴더에 저장합니다. "DocuKing에서 가져와" 요청 시 사용.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -412,7 +423,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'docuking_talk',
-        description: '의미 있는 대화 내용을 z_DocuKing/z_Talk/ 폴더에 기록합니다 (플랫 구조). AI가 중요한 논의/결정이라고 판단하거나, 사용자가 "이거 기록해줘"라고 요청할 때 사용.',
+        description: '의미 있는 대화 내용을 zz_ai_Talk/ 폴더에 기록합니다 (로컬 전용, 킹톡). AI가 중요한 논의/결정이라고 판단하거나, 사용자가 "이거 기록해줘"라고 요청할 때 사용.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -439,7 +450,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'docuking_plan',
-        description: '작업 계획 문서를 z_DocuKing/zz_Plan_Result/ 폴더에 생성/업데이트합니다 (플랫 구조). 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
+        description: '작업 계획 문서를 zzz_ai_Plan/ 폴더에 생성/업데이트합니다 (로컬 전용, 킹플랜). 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -508,7 +519,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'docuking_todo',
-        description: `킹투두(King Todo) - 프로젝트 공식 할일을 z_DocuKing/z_King_Todo/z_King_Todo.md에 관리합니다.
+        description: `킹투두(King Todo) - 프로젝트 공식 할일을 zz_ai_Todo/z_King_Todo.md에 관리합니다 (로컬 전용).
 
 **AI 내장 TodoWrite와 다름!** 킹투두는 웹에 동기화되고 팀과 공유됩니다.
 
@@ -579,11 +590,12 @@ DocuKing은 문서 버전 관리 시스템입니다. Git이 코드를 관리하
 
 ## 핵심 개념
 
-- **로컬**: 사용자의 z_DocuKing/ 폴더
-- **웹탐색기**: DocuKing 서버의 파일 저장소 (로컬 미러)
+- **로컬**: 사용자의 yy_All_Docu/ 폴더 (동기화 대상)
+- **웹탐색기**: DocuKing 서버의 파일 저장소 (킹폴더)
 - **캔버스**: 선택된 파일을 시각화하는 작업 공간
+- **AI 작업 폴더**: zz_ai_Talk/, zz_ai_Todo/, zzz_ai_Plan/ (로컬 전용)
 
-작동 방식: 로컬 문서 → Push → 웹탐색기 → 캔버스에서 시각화
+작동 방식: 로컬 yy_All_Docu/ → Push → 킹폴더 → 캔버스에서 시각화
 
 ## MCP 설정과 프로젝트 연결의 차이 (매우 중요!)
 
@@ -600,7 +612,7 @@ DocuKing은 문서 버전 관리 시스템입니다. Git이 코드를 관리하
 ### 프로젝트 연결 (각 폴더마다)
 - **목적**: 특정 로컬 폴더를 DocuKing 서버의 프로젝트 ID와 연결
 - **실행 방법**: \`docuking_init(projectId, localPath)\` 도구 호출
-- **결과**: 해당 폴더에 \`z_DocuKing/\` 폴더 생성 및 프로젝트 매핑 저장
+- **결과**: 해당 폴더에 \`yy_All_Docu/\` 폴더 생성 및 프로젝트 매핑 저장
 - **재시작 불필요**: MCP가 이미 작동 중이면 바로 실행 가능
 - **다중 프로젝트**: 한 컴퓨터에서 여러 폴더를 각각 다른 DocuKing 프로젝트와 연결 가능
 
@@ -615,10 +627,10 @@ DocuKing 문서 폴더는 git에서 제외해야 합니다. 코드는 git으로,
 
 \`\`\`gitignore
 # DocuKing 문서 폴더 (문서는 DocuKing으로 관리)
-*_DocuKing_*
-*_Docuking_*
-z_DocuKing/
-zz_Coworker_*/
+yy_All_Docu/
+zz_ai_Talk/
+zz_ai_Todo/
+zzz_ai_Plan/
 \`\`\`
 
 **왜 gitignore에 등록해야 하나요?**
@@ -654,12 +666,12 @@ zz_Coworker_*/
 특정 커밋으로 되돌립니다. (웹 탐색기에서 사용 가능)
 
 ### 9. docuking_talk
-의미 있는 대화 내용을 \`z_DocuKing/z_Talk/\` 폴더에 기록합니다 (플랫 구조).
+의미 있는 대화 내용을 \`zz_ai_Talk/\` 폴더에 기록합니다 (로컬 전용, 킹톡).
 - AI가 중요한 논의/결정이라고 판단할 때
 - 사용자가 "이거 기록해줘"라고 요청할 때
 
 ### 10. docuking_plan
-작업 계획을 \`z_DocuKing/zz_Plan_Result/\` 폴더에 생성/업데이트합니다 (플랫 구조).
+작업 계획을 \`zzz_ai_Plan/\` 폴더에 생성/업데이트합니다 (로컬 전용, 킹플랜).
 - 작업 시작 시 계획 생성
 - 진행하면서 단계별 결과 upsert
 - planId로 기존 계획 찾아서 업데이트
@@ -731,7 +743,7 @@ DocuKing에는 **오너(Owner)**와 **참여자(Co-worker)** 두 가지 권한
 
 **예시:**
 \`\`\`
-z_DocuKing/
+yy_All_Docu/
 ├── 정책/
 │   └── README.md  ← 오너가 작성
 ├── 기획/
@@ -745,7 +757,7 @@ z_DocuKing/
 **특징:**
 - 프로젝트에 초대받아 참여한 사람
 - **읽기**: 전체 문서 Pull 가능 (오너의 문서도 볼 수 있음)
-- **쓰기**: 자신의 폴더(\`zz_Coworker_{이름}/\`)에만 Push 가능
+- **쓰기**: 자신의 폴더(\`yy_All_Docu/yy_Coworker_{이름}/\`)에만 Push 가능
 - API Key: \`sk_cw_\`로 시작
 - 프로젝트 설정 변경 불가능
 
@@ -754,36 +766,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 응답 가이드 (중요!)
@@ -837,7 +852,7 @@ Push 완료! 총 10개 파일 중 3개 업로드, 6개 스킵(변경 없음), 1
 ### 핵심 원칙 (AI 행동 지침)
 
 1. **프로젝트 = 폴더**: 하나의 폴더가 하나의 프로젝트
-2. **각 폴더마다 z_DocuKing/ 생성**: 여러 폴더를 각각 연결 가능
+2. **각 폴더마다 yy_All_Docu/ 생성**: 여러 폴더를 각각 연결 가능
 3. **현재 열려있는 폴더 기준**: 명령어는 현재 작업 중인 폴더에 적용
 4. **커밋 메시지 필수**: push 시 반드시 message 파라미터 포함
 5. **변경 없는 파일 자동 스킵**: 해시 비교로 변경 감지, 스킵된 파일은 결과에 명시
@@ -867,7 +882,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)
 
@@ -918,7 +933,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가 계획 문서를 보고 이어서 작업 가능
@@ -973,7 +988,7 @@ AI: docuking_done({
 2. 프로젝트 ID, 이름, API 키 확인 (사용자가 제공하거나 요청)
 3. \`docuking_init(projectId, projectName, apiKey, localPath)\` 호출
 4. 연결 완료 메시지 전달:
-   - "DocuKing 연결 완료! 📁 z_DocuKing/ 폴더가 생성되었습니다."
+   - "DocuKing 연결 완료! 📁 yy_All_Docu/ 폴더가 생성되었습니다."
    - "이제 'DocuKing에 올려줘' 명령을 사용할 수 있습니다."
 
 **⚠️ 매우 중요:**
@@ -986,28 +1001,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 환경변수 (선택사항)**
@@ -1115,20 +1130,34 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
   // IDE별 자동 승인 설정 추가 (Claude Code 등)
   setupAutoApproval(localPath);
 
-  // 폴더 생성: 코워커는 zz_Coworker_{이름}/, 오너는 z_DocuKing/
-  let folderName;
-  let workingPath;
+  // 폴더 생성: 오너는 yy_All_Docu/, 협업자는 yy_All_Docu/yy_{이름}/
+  const mainFolderName = 'yy_All_Docu';
+  const mainFolderPath = path.join(localPath, mainFolderName);
 
-  if (isCoworker) {
-    folderName = `zz_Coworker_${coworkerName}`;
-    workingPath = path.join(localPath, folderName);
-  } else {
-    folderName = 'z_DocuKing';
-    workingPath = path.join(localPath, folderName);
+  // yy_All_Docu 폴더는 항상 생성
+  if (!fs.existsSync(mainFolderPath)) {
+    fs.mkdirSync(mainFolderPath, { recursive: true });
   }
 
-  if (!fs.existsSync(workingPath)) {
-    fs.mkdirSync(workingPath, { 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_Coworker_{이름}/ 폴더 추가 생성
+    coworkerFolderName = `yy_Coworker_${coworkerName}`;
+    coworkerFolderPath = path.join(mainFolderPath, coworkerFolderName);
+    if (!fs.existsSync(coworkerFolderPath)) {
+      fs.mkdirSync(coworkerFolderPath, { recursive: true });
+    }
   }
 
   // 연결 완료 안내 (오너/코워커에 따라 다른 메시지)
@@ -1140,17 +1169,18 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
           text: `DocuKing 연결 완료! (참여자)
 
 📁 프로젝트: ${projectName}
-📂 ${folderName}/ 폴더가 생성되었습니다.
+📂 yy_All_Docu/ 폴더가 생성되었습니다.
+📂 yy_All_Docu/${coworkerFolderName}/ 작업 폴더가 생성되었습니다.
 👤 참여자: ${coworkerName}
 🔑 설정 저장: .docuking/config.json
 
 참여자 사용법:
-- "DocuKing에서 가져와" → 오너의 문서를 z_DocuKing/에 Pull
-- ${folderName}/ 폴더에 문서 작성
+- "DocuKing에서 가져와" → 전체 문서를 yy_All_Docu/에 Pull
+- yy_All_Docu/${coworkerFolderName}/ 폴더에 문서 작성
 - "DocuKing에 올려줘" → 내 문서를 서버에 Push
 
-💡 참여자는 ${folderName}/ 폴더에만 Push할 수 있습니다.
-   오너의 문서는 Pull로 읽을 수 있지만 수정은 제안서 형태로 작성하세요.`,
+💡 참여자는 yy_All_Docu/${coworkerFolderName}/ 폴더에만 Push할 수 있습니다.
+   다른 문서는 Pull로 읽을 수 있지만 수정은 자기 폴더에서 작성하세요.`,
         },
       ],
     };
@@ -1162,16 +1192,22 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
           text: `DocuKing 연결 완료!
 
 📁 프로젝트: ${projectName}
-📂 z_DocuKing/ 폴더가 생성되었습니다.
+📂 yy_All_Docu/ 폴더가 생성되었습니다.
 🔑 설정 저장: .docuking/config.json
 
 이제부터 문서 관리는 DocuKing에서 시작합니다:
-- z_DocuKing/ 하위에 문서를 넣으면 DocuKing 서버로 암호화되어 저장됩니다
+- yy_All_Docu/ 하위에 문서를 넣으면 DocuKing 서버로 암호화되어 저장됩니다
 - 협업자들과 안전하게 문서를 공유할 수 있습니다
 
 사용법:
 - "DocuKing에 올려줘" → 로컬 문서를 서버에 Push
-- "DocuKing에서 가져와" → 서버 문서를 로컬로 Pull`,
+- "DocuKing에서 가져와" → 서버 문서를 로컬로 Pull
+
+폴더 구조:
+- yy_All_Docu/     : 동기화 대상 (킹폴더)
+- zz_ai_Talk/      : AI 대화록 (로컬 전용, 킹톡)
+- zz_ai_Todo/      : AI 투두 (로컬 전용, 킹투두)
+- zzz_ai_Plan/      : AI 플랜 (로컬 전용, 킹플랜)`,
         },
       ],
     };
@@ -1231,37 +1267,37 @@ Git처럼 무엇을 변경했는지 명확히 작성해주세요.
   const coworkerMatch = apiKey.match(/^sk_[a-f0-9]+_cw_([^_]+)_/);
   const isCoworker = !!coworkerMatch;
   const coworkerName = coworkerMatch ? coworkerMatch[1] : null;
-  const coworkerFolderName = isCoworker ? `zz_Coworker_${coworkerName}` : null;
+  const coworkerFolderName = isCoworker ? `yy_Coworker_${coworkerName}` : null;
 
-  // 작업 폴더 결정: 코워커는 zz_Coworker_{이름}/, 오너는 z_DocuKing/
+  // 작업 폴더 결정: 모두 yy_All_Docu/ 사용, 협업자는 yy_All_Docu/yy_Coworker_{이름}/ 에서 작업
+  const mainFolderPath = path.join(localPath, 'yy_All_Docu');
   let workingPath;
   let serverPathPrefix = ''; // 서버에 저장될 때 경로 접두사
 
   if (isCoworker) {
-    // 코워커: zz_Coworker_{이름}/ 폴더 사용 (z_DocuKing과 같은 레벨)
-    workingPath = path.join(localPath, coworkerFolderName);
+    // 협업자: yy_All_Docu/yy_Coworker_{이름}/ 폴더에서 Push
+    workingPath = path.join(mainFolderPath, coworkerFolderName);
     serverPathPrefix = `${coworkerFolderName}/`;
 
     if (!fs.existsSync(workingPath)) {
       // 폴더가 없으면 생성
       fs.mkdirSync(workingPath, { recursive: true });
-      console.log(`[DocuKing] 코워커 폴더 생성: ${coworkerFolderName}/`);
+      console.log(`[DocuKing] 협업자 폴더 생성: yy_All_Docu/${coworkerFolderName}/`);
     }
   } else {
-    // 오너: z_DocuKing/ 폴더 사용
-    const folderName = findDocuKingFolder(localPath);
-    if (!folderName) {
+    // 오너: yy_All_Docu/ 폴더 사용
+    if (!fs.existsSync(mainFolderPath)) {
       return {
         content: [
           {
             type: 'text',
-            text: `오류: DocuKing 폴더가 없습니다.
+            text: `오류: yy_All_Docu 폴더가 없습니다.
 docuking_init을 먼저 실행하세요.`,
           },
         ],
       };
     }
-    workingPath = path.join(localPath, folderName);
+    workingPath = mainFolderPath;
   }
 
   // 파일 목록 수집
@@ -1284,7 +1320,7 @@ docuking_init을 먼저 실행하세요.`,
         };
       }
 
-      // 서버 경로: 코워커는 zz_Coworker_{이름}/파일경로, 오너는 파일경로
+      // 서버 경로: 코워커는 yy_Coworker_{이름}/파일경로, 오너는 파일경로
       const serverFilePath = serverPathPrefix + filePath;
       filesToPush.push({ path: filePath, serverPath: serverFilePath, fullPath, fileType });
     }
@@ -1451,7 +1487,7 @@ docuking_init을 먼저 실행하세요.`,
               },
               body: JSON.stringify({
                 projectId,
-                path: file.serverPath, // 서버 경로 (코워커는 zz_Coworker_{이름}/파일경로)
+                path: file.serverPath, // 서버 경로 (코워커는 yy_Coworker_{이름}/파일경로)
                 content,
                 encoding, // 'utf-8' 또는 'base64'
                 message, // 커밋 메시지
@@ -1679,10 +1715,11 @@ async function handlePull(args) {
 
   const projectId = projectInfo.projectId;
 
-  // DocuKing 폴더 찾기 (없으면 기본값으로 생성)
-  let ownerFolderName = findDocuKingFolder(localPath);
-  if (!ownerFolderName) {
-    ownerFolderName = 'z_DocuKing';
+  // yy_All_Docu 폴더 (없으면 생성)
+  const mainFolderName = 'yy_All_Docu';
+  const mainFolderPath = path.join(localPath, mainFolderName);
+  if (!fs.existsSync(mainFolderPath)) {
+    fs.mkdirSync(mainFolderPath, { recursive: true });
   }
 
   // 파일 목록 조회
@@ -1750,17 +1787,9 @@ async function handlePull(args) {
 
       const data = await response.json();
 
-      // 서버 경로에 따라 로컬 저장 경로 결정
-      // 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);
-      }
+      // 서버 경로를 그대로 yy_All_Docu/ 아래에 저장
+      // 협업자 폴더(yy_이름/)도 yy_All_Docu/ 안에 있으므로 동일하게 처리
+      const fullPath = path.join(mainFolderPath, file.path);
 
       // 디렉토리 생성
       fs.mkdirSync(path.dirname(fullPath), { recursive: true });
@@ -1941,31 +1970,15 @@ function getFileType(fileName) {
   return 'binary';
 }
 
-// 유틸: DocuKing 폴더 찾기 (docuking 포함, 대소문자 무관)
-// .docuking (설정 폴더)는 제외
-function findDocuKingFolder(projectPath) {
-  try {
-    const entries = fs.readdirSync(projectPath, { withFileTypes: true });
-    for (const entry of entries) {
-      // .docuking은 설정 폴더이므로 제외 (숨김 폴더)
-      if (entry.name.startsWith('.')) {
-        continue;
-      }
-      if (entry.isDirectory() && entry.name.toLowerCase().includes('docuking')) {
-        return entry.name;
-      }
-    }
-  } catch (e) {
-    // 디렉토리 읽기 실패
-  }
-  return null;
+// 유틸: yy_All_Docu 폴더 존재 확인
+function hasAllDocuFolder(projectPath) {
+  const allDocuPath = path.join(projectPath, 'yy_All_Docu');
+  return fs.existsSync(allDocuPath);
 }
 
 // 유틸: 디렉토리 재귀 탐색
 // excludedFiles: 제외된 파일 목록을 수집할 배열 (선택)
-// AI 작업 기록 폴더 (공유 제외 대상)
-const AI_WORK_FOLDERS = ['z_Talk', 'z_Todo', 'z_King_Todo', 'zz_Plan_Result'];
-
+// zz_* 폴더는 로컬 전용이므로 동기화에서 제외
 function collectFiles(basePath, relativePath, results, excludedFiles = null) {
   const fullPath = path.join(basePath, relativePath);
   const entries = fs.readdirSync(fullPath, { withFileTypes: true });
@@ -1974,9 +1987,9 @@ function collectFiles(basePath, relativePath, results, excludedFiles = null) {
     const entryRelPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
 
     if (entry.isDirectory()) {
-      // AI 작업 기록 폴더는 제외 (z_Talk, z_Todo, z_King_Todo, zz_Plan_Result)
-      if (AI_WORK_FOLDERS.includes(entry.name)) {
-        console.error(`[DocuKing] 제외됨: ${entryRelPath}/ (AI 작업 기록 폴더 - 개인용)`);
+      // zz_* 폴더는 로컬 전용 (AI 작업 기록 등)이므로 동기화에서 제외
+      if (entry.name.startsWith('zz_')) {
+        console.error(`[DocuKing] 제외됨: ${entryRelPath}/ (zz_* 폴더 - 로컬 전용)`);
         continue;
       }
       collectFiles(basePath, entryRelPath, results, excludedFiles);
@@ -2056,20 +2069,20 @@ 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 ? `zz_Coworker_${coworkerName}` : null;
+  const coworkerFolderName = isCoworker ? `yy_Coworker_${coworkerName}` : null;
 
   // 권한 정보 구성
   let permissionInfo = '';
   if (isCoworker) {
     permissionInfo = `\n\n## 현재 권한: 참여자 (Co-worker)
 - 이름: ${coworkerName}
-- 읽기 권한: 전체 문서 (Pull로 z_DocuKing/ 폴더의 문서 가져오기 가능)
-- 쓰기 권한: ${coworkerFolderName}/ 폴더만 (z_DocuKing과 같은 레벨)
-- 설명: 코워커 전용 폴더에서 작업하면 자동으로 서버에 Push됩니다.`;
+- 읽기 권한: 전체 문서 (Pull로 yy_All_Docu/ 폴더의 문서 가져오기 가능)
+- 쓰기 권한: yy_All_Docu/${coworkerFolderName}/ 폴더만
+- 설명: 협업자 폴더에서 작업하면 자동으로 서버에 Push됩니다.`;
   } else {
     permissionInfo = `\n\n## 현재 권한: 오너 (Owner)
 - 읽기 권한: 전체 문서
-- 쓰기 권한: z_DocuKing/ 폴더 전체 (제한 없음)
+- 쓰기 권한: yy_All_Docu/ 폴더 전체 (제한 없음)
 - 설명: 프로젝트의 모든 폴더에 Push할 수 있습니다.`;
   }
 
@@ -2095,26 +2108,25 @@ async function handleStatus(args) {
   // 로컬 파일 목록 조회
   let localFiles = [];
   let pushableFiles = [];
+  const mainFolderPath = path.join(localPath, 'yy_All_Docu');
 
   if (isCoworker) {
-    // 코워커: zz_Coworker_{이름}/ 폴더에서 파일 수집
-    const coworkerPath = path.join(localPath, coworkerFolderName);
+    // 협업자: yy_All_Docu/yy_{이름}/ 폴더에서 파일 수집
+    const coworkerPath = path.join(mainFolderPath, coworkerFolderName);
     if (fs.existsSync(coworkerPath)) {
       collectFiles(coworkerPath, '', localFiles);
     }
-    pushableFiles = localFiles; // 코워커는 자기 폴더의 모든 파일 Push 가능
+    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);
+    // 오너: yy_All_Docu/ 폴더에서 파일 수집
+    if (fs.existsSync(mainFolderPath)) {
+      collectFiles(mainFolderPath, '', localFiles);
     }
     pushableFiles = localFiles; // 오너는 모든 파일 Push 가능
   }
 
   const projectNameInfo = projectName ? ` (${projectName})` : '';
-  const workingFolder = isCoworker ? coworkerFolderName : 'z_DocuKing';
+  const workingFolder = isCoworker ? `yy_All_Docu/${coworkerFolderName}` : 'yy_All_Docu';
   const statusText = `DocuKing 동기화 상태
 
 **프로젝트**: ${projectId}${projectNameInfo}
@@ -2252,8 +2264,8 @@ function generatePlanId() {
 async function handleTodo(args) {
   const { localPath, action, todo, todoId } = args;
 
-  // z_King_Todo 폴더 경로
-  const todoBasePath = path.join(localPath, 'z_DocuKing', 'z_King_Todo');
+  // zz_ai_Todo 폴더 경로 (로컬 전용, 킹투두)
+  const todoBasePath = path.join(localPath, 'zz_ai_Todo');
   const todoFilePath = path.join(todoBasePath, 'z_King_Todo.md');
 
   // 폴더 생성
@@ -2414,7 +2426,7 @@ async function handleTodo(args) {
           text: `📋 킹투두 미결: 없음
 
 ✅ 완료: ${completedCount}개
-📁 전체 기록: z_DocuKing/z_King_Todo/z_King_Todo.md`,
+📁 전체 기록: zz_ai_Todo/z_King_Todo.md`,
         }],
       };
     }
@@ -2429,7 +2441,7 @@ async function handleTodo(args) {
 ${listText}
 
 ✅ 완료: ${completedCount}개
-📁 전체 기록: z_DocuKing/z_King_Todo/z_King_Todo.md`,
+📁 전체 기록: zz_ai_Todo/z_King_Todo.md`,
       }],
     };
   }
@@ -2443,8 +2455,8 @@ ${listText}
 async function handleTalk(args) {
   const { localPath, title, content, tags = [] } = args;
 
-  // z_Talk 폴더 경로 (z_DocuKing 아래) - 플랫 구조
-  const talkBasePath = path.join(localPath, 'z_DocuKing', 'z_Talk');
+  // zz_ai_Talk 폴더 경로 (로컬 전용, 킹톡)
+  const talkBasePath = path.join(localPath, 'zz_ai_Talk');
 
   // 날짜 기반 파일명 생성
   const { fileName, timestamp } = generateDateFileName(title);
@@ -2496,8 +2508,8 @@ ${content}
 async function handlePlan(args) {
   const { localPath, planId, title, goal, steps = [], notes } = args;
 
-  // zz_Plan_Result 폴더 경로 (z_DocuKing 아래) - 플랫 구조
-  const planBasePath = path.join(localPath, 'z_DocuKing', 'zz_Plan_Result');
+  // zzz_ai_Plan 폴더 경로 (로컬 전용, 킹플랜)
+  const planBasePath = path.join(localPath, 'zzz_ai_Plan');
 
   // 기존 계획 업데이트 또는 새 계획 생성
   let targetPlanId = planId;
@@ -2646,8 +2658,8 @@ function findPlanFiles(basePath, planId) {
 async function handleDone(args) {
   const { localPath, planId, summary, artifacts = [] } = args;
 
-  // zz_Plan_Result 폴더 경로 (z_DocuKing 아래) - 플랫 구조
-  const planBasePath = path.join(localPath, 'z_DocuKing', 'zz_Plan_Result');
+  // 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": "1.9.2",
+  "version": "2.0.1",
   "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` 재실행하면 새 버전 적용됨