docuking-mcp 2.5.2 → 2.5.4

package/index.js

@@ -10,13 +10,13 @@
  * - yy_All_Docu/_Infra_Config/: 민감 정보 백업 (.env 자동 복사, 팀 공유)
  * - yy_All_Docu/_Private/     : 오너 비공개 폴더 (오너만 접근)
  * - yy_Coworker_{폴더명}/     : 협업자 폴더 (yy_All_Docu와 별도, 동기화 대상)
- * - zz_ai_1_Talk/             : AI 대화록 (킹톡)
- * - zz_ai_2_Todo/             : AI 투두 (킹투두)
- * - zz_ai_3_Plan/             : AI 플랜 (킹플랜)
+ * - zz_ai_1_Talk/             : AI 대화록 (킹톡, Push 대상)
+ * - zz_ai_2_Todo/             : AI 투두 (킹투두, Push 대상)
+ * - zz_ai_3_Plan/             : AI 플랜 (킹플랜, Push 대상)
  *
  * 접두사 규칙:
- * - yy_ : 사람용 폴더 (문서, 협업자)
- * - zz_ : AI용 폴더 (Talk, Todo, Plan)
+ * - yy_ : 사람용 폴더 (문서, 협업자) - Push 대상
+ * - zz_ai_ : AI용 폴더 (Talk, Todo, Plan) - Push 대상
  * - _   : 비공개 폴더 (본인만 접근)
  *
  * 도구:
@@ -530,7 +530,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'docuking_talk',
-        description: '의미 있는 대화 내용을 zz_ai_1_Talk/ 폴더에 기록합니다 (로컬 전용, 킹톡). AI가 중요한 논의/결정이라고 판단하거나, 사용자가 "이거 기록해줘"라고 요청할 때 사용.',
+        description: '의미 있는 대화 내용을 zz_ai_1_Talk/ 폴더에 기록합니다 (Push 대상, 킹톡). AI가 중요한 논의/결정이라고 판단하거나, 사용자가 "이거 기록해줘"라고 요청할 때 사용.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -557,7 +557,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'docuking_plan',
-        description: '작업 계획 문서를 zz_ai_3_Plan/ 폴더에 생성/업데이트합니다 (로컬 전용, 킹플랜). 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
+        description: '작업 계획 문서를 zz_ai_3_Plan/ 폴더에 생성/업데이트합니다 (Push 대상, 킹플랜). 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -626,7 +626,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'docuking_todo',
-        description: `킹투두(King Todo) - 프로젝트 공식 할일을 zz_ai_2_Todo/z_King_Todo.md에 관리합니다 (로컬 전용).
+        description: `킹투두(King Todo) - 프로젝트 공식 할일을 zz_ai_2_Todo/z_King_Todo.md에 관리합니다 (Push 대상).
 
 **AI 내장 TodoWrite와 다름!** 킹투두는 웹에 동기화되고 팀과 공유됩니다.
 
@@ -700,7 +700,7 @@ DocuKing은 문서 버전 관리 시스템입니다. Git이 코드를 관리하
 - **로컬**: 사용자의 yy_All_Docu/ 폴더 (동기화 대상)
 - **웹탐색기**: DocuKing 서버의 파일 저장소 (킹폴더)
 - **캔버스**: 선택된 파일을 시각화하는 작업 공간
-- **AI 작업 폴더**: zz_ai_1_Talk/, zz_ai_2_Todo/, zz_ai_3_Plan/ (로컬 전용)
+- **AI 작업 폴더**: zz_ai_1_Talk/, zz_ai_2_Todo/, zz_ai_3_Plan/ (Push 대상)
 
 작동 방식: 로컬 yy_All_Docu/ → Push → 킹폴더 → 캔버스에서 시각화
 
@@ -773,12 +773,12 @@ zz_ai_3_Plan/
 특정 커밋으로 되돌립니다. (웹 탐색기에서 사용 가능)
 
 ### 9. docuking_talk
-의미 있는 대화 내용을 \`zz_ai_1_Talk/\` 폴더에 기록합니다 (로컬 전용, 킹톡).
+의미 있는 대화 내용을 \`zz_ai_1_Talk/\` 폴더에 기록합니다 (Push 대상, 킹톡).
 - AI가 중요한 논의/결정이라고 판단할 때
 - 사용자가 "이거 기록해줘"라고 요청할 때
 
 ### 10. docuking_plan
-작업 계획을 \`zz_ai_3_Plan/\` 폴더에 생성/업데이트합니다 (로컬 전용, 킹플랜).
+작업 계획을 \`zz_ai_3_Plan/\` 폴더에 생성/업데이트합니다 (Push 대상, 킹플랜).
 - 작업 시작 시 계획 생성
 - 진행하면서 단계별 결과 upsert
 - planId로 기존 계획 찾아서 업데이트
@@ -888,9 +888,9 @@ project/
 ├── yy_Coworker_devkim/               ← 참여자 "devkim"의 폴더 (별도)
 │   ├── proposal.md                   ← 여기에만 Push 가능
 │   └── revision.md                   ← 여기에만 Push 가능
-├── zz_ai_1_Talk/                     ← AI 대화록 (로컬 전용)
-├── zz_ai_2_Todo/                     ← AI 투두 (로컬 전용)
-└── zz_ai_3_Plan/                     ← AI 플랜 (로컬 전용)
+├── zz_ai_1_Talk/                     ← AI 대화록 (Push 대상)
+├── zz_ai_2_Todo/                     ← AI 투두 (Push 대상)
+└── zz_ai_3_Plan/                     ← AI 플랜 (Push 대상)
 \`\`\`
 
 **중요 규칙:**
@@ -989,7 +989,7 @@ AI: (결정이 내려졌으므로 docuking_talk 호출)
     })
 \`\`\`
 
-**저장 위치:** \`zz_ai_1_Talk/YYYY-MM-DD_HHMM__제목.md\` (플랫 구조, 로컬 전용)
+**저장 위치:** \`zz_ai_1_Talk/YYYY-MM-DD_HHMM__제목.md\` (플랫 구조, Push 대상)
 
 ### 작업 계획 관리 (docuking_plan, docuking_done)
 
@@ -1040,7 +1040,7 @@ AI: docuking_done({
     })
 \`\`\`
 
-**저장 위치:** \`zz_ai_3_Plan/YYYY-MM-DD_HHMM__제목__planId.md\` (플랫 구조, 로컬 전용)
+**저장 위치:** \`zz_ai_3_Plan/YYYY-MM-DD_HHMM__제목__planId.md\` (플랫 구조, Push 대상)
 
 **핵심 가치:**
 - AI 세션이 끊겨도 (컴팩션, 세션 종료) 다음 AI가 계획 문서를 보고 이어서 작업 가능
@@ -1116,15 +1116,15 @@ C:\\Projects\\MyApp\\
 ├── src/
 ├── package.json
 ├── yy_All_Docu/          ← 프로젝트 A와 연결 (동기화)
-├── zz_ai_1_Talk/           ← AI 대화록 (로컬 전용)
-├── zz_ai_2_Todo/           ← AI 투두 (로컬 전용)
-└── zz_ai_3_Plan/           ← AI 플랜 (로컬 전용)
+├── zz_ai_1_Talk/           ← AI 대화록 (Push 대상)
+├── zz_ai_2_Todo/           ← AI 투두 (Push 대상)
+└── zz_ai_3_Plan/           ← AI 플랜 (Push 대상)
 
 C:\\Projects\\MyWebsite\\
 ├── pages/
 ├── components/
 ├── yy_All_Docu/          ← 프로젝트 B와 연결
-└── zz_ai_*/              ← 로컬 전용 폴더들
+└── zz_ai_*/              ← AI 작업 폴더들 (Push 대상)
 \`\`\`
 
 **AI가 해야 할 일:**
@@ -1326,9 +1326,9 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
 
 폴더 구조:
 - yy_All_Docu/     : 동기화 대상 (킹폴더)
-- zz_ai_1_Talk/      : AI 대화록 (로컬 전용, 킹톡)
-- zz_ai_2_Todo/      : AI 투두 (로컬 전용, 킹투두)
-- zz_ai_3_Plan/      : AI 플랜 (로컬 전용, 킹플랜)`,
+- zz_ai_1_Talk/      : AI 대화록 (Push 대상, 킹톡)
+- zz_ai_2_Todo/      : AI 투두 (Push 대상, 킹투두)
+- zz_ai_3_Plan/      : AI 플랜 (Push 대상, 킹플랜)`,
         },
       ],
     };
@@ -1598,7 +1598,7 @@ docuking_init을 먼저 실행하세요.`,
     }
   }
 
-  if (filesToPush.length === 0) {
+  if (filesToPush.length === 0 && emptyFolders.length === 0) {
     return {
       content: [
         {
@@ -2368,10 +2368,9 @@ function collectFilesSimple(basePath, relativePath, results, excludedFiles = nul
   }
 }
 
-// 유틸: 디렉토리 재귀 탐색 (기존 호환용)
+// 유틸: 디렉토리 재귀 탐색 (기존 호환용, 현재 미사용)
 // excludedFiles: 제외된 파일 목록을 수집할 배열 (선택)
 // largeFiles: 대용량 파일 목록을 수집할 배열 (선택)
-// zz_* 폴더는 로컬 전용이므로 동기화에서 제외
 function collectFiles(basePath, relativePath, results, excludedFiles = null, largeFiles = null) {
   const fullPath = path.join(basePath, relativePath);
   const entries = fs.readdirSync(fullPath, { withFileTypes: true });
@@ -2380,11 +2379,6 @@ function collectFiles(basePath, relativePath, results, excludedFiles = null, lar
     const entryRelPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
 
     if (entry.isDirectory()) {
-      // zz_* 폴더는 로컬 전용 (AI 작업 기록 등)이므로 동기화에서 제외
-      if (entry.name.startsWith('zz_')) {
-        console.error(`[DocuKing] 제외됨: ${entryRelPath}/ (zz_* 폴더 - 로컬 전용)`);
-        continue;
-      }
       collectFiles(basePath, entryRelPath, results, excludedFiles, largeFiles);
     } else if (entry.isFile()) {
       const fileType = getFileType(entry.name);

package/package.json

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