docuking-mcp 2.14.0 → 3.0.0

package/README.md

@@ -77,18 +77,18 @@ claude mcp add docuking -s user -- docuking-mcp
 
 | 도구 | 설명 |
 |------|------|
-| docuking_init | 프로젝트 연결, yy_All_Docu/ 및 zz_ai_* 폴더 생성 |
-| docuking_push | yy_All_Docu/ → 서버 업로드 |
-| docuking_pull | 서버 → yy_All_Docu/ 다운로드 |
+| docuking_init | 프로젝트 연결, 필수 폴더 생성 |
+| docuking_push | 로컬 → 서버 업로드 |
+| docuking_pull | 서버 → 로컬 다운로드 |
 | docuking_status | 동기화 상태 확인 |
 | docuking_list | 서버 파일 목록 조회 |
 | docuking_log | 커밋 히스토리 조회 |
 | docuking_diff | 버전 간 차이 비교 |
 | docuking_rollback | 특정 커밋으로 롤백 |
-| docuking_talk | AI 대화록 저장 (zz_ai_1_Talk/) |
-| docuking_plan | 작업 계획 관리 (zz_ai_3_Plan/) |
+| docuking_talk | AI 대화록 저장 (xy_TalkTodoPlan/) |
+| docuking_plan | 작업 계획 관리 (xy_TalkTodoPlan/) |
 | docuking_done | 작업 완료 처리 |
-| docuking_todo | 킹투두 관리 (zz_ai_2_Todo/) |
+| docuking_todo | 킹투두 관리 (xy_TalkTodoPlan/z_King_Todo.md) |
 | docuking_urgent | 긴급 보고 (xx_Urgent/) |
 | docuking_delete | 서버 파일 삭제 |
 | docuking_validate | 정책 준수 검증 |
@@ -100,20 +100,17 @@ claude mcp add docuking -s user -- docuking-mcp
 ├── xx_Infra_Config/         ← 시스템 설정 (동기화 대상)
 ├── xx_Policy/               ← 정책 문서 (동기화 대상, 킹캐스트)
 ├── xx_Urgent/               ← 긴급 보고 (동기화 대상)
+├── xy_TalkTodoPlan/         ← 오너 AI 기록 (Talk+Todo+Plan 통합)
 ├── yy_All_Docu/             ← 문서 허브 (동기화 대상)
-├── yy_Coworker_{이름}/      ← 협업자 작업 폴더 (동기화 대상)
-│   ├── zz_ai_1_Talk/        ← 협업자의 AI 대화록
-│   ├── zz_ai_2_Todo/        ← 협업자의 AI 투두
-│   └── zz_ai_3_Plan/        ← 협업자의 AI 플랜
-├── zz_ai_1_Talk/            ← 오너의 AI 대화록 (동기화 대상)
-├── zz_ai_2_Todo/            ← 오너의 AI 투두 (동기화 대상)
-└── zz_ai_3_Plan/            ← 오너의 AI 플랜 (동기화 대상)
+└── yy_Coworker_{이름}/      ← 협업자 작업 폴더 (동기화 대상)
+    └── zz_TalkTodoPlan/     ← 협업자의 AI 기록
 ```
 
 **접두사 규칙:**
 - `xx_*`: 시스템/인프라 폴더
+- `xy_*`: 오너 AI 기록 폴더
 - `yy_*`: 사람용 폴더
-- `zz_ai_*`: AI용 폴더
+- `zz_*`: 협업자 AI 기록 폴더 (협업자 폴더 안에서만)
 
 ## 웹사이트
 

package/handlers/docs.js

@@ -17,11 +17,12 @@ export async function handleTodo(args) {
   const localPath = args.localPath || process.cwd();
   const { action, todo, todoId } = args;
 
-  // 협업자 여부에 따라 zz_ai 경로 결정
-  // - 오너: localPath/zz_ai_2_Todo/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_ai_2_Todo/
-  const { basePath } = getAiBasePath(localPath);
-  const todoBasePath = path.join(basePath, 'zz_ai_2_Todo');
+  // 협업자 여부에 따라 AI 폴더 경로 결정
+  // - 오너: localPath/xy_TalkTodoPlan/
+  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
+  const { basePath, isCoworker } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  const todoBasePath = path.join(basePath, aiFolder);
   const todoFilePath = path.join(todoBasePath, 'z_King_Todo.md');
 
   // 폴더 생성
@@ -182,7 +183,7 @@ export async function handleTodo(args) {
           text: `📋 킹투두 미결: 없음
 
 ✅ 완료: ${completedCount}개
-📁 전체 기록: zz_ai_2_Todo/z_King_Todo.md`,
+📁 전체 기록: ${aiFolder}/z_King_Todo.md`,
         }],
       };
     }
@@ -197,7 +198,7 @@ export async function handleTodo(args) {
 ${listText}
 
 ✅ 완료: ${completedCount}개
-📁 전체 기록: zz_ai_2_Todo/z_King_Todo.md`,
+📁 전체 기록: ${aiFolder}/z_King_Todo.md`,
       }],
     };
   }
@@ -215,10 +216,11 @@ export async function handleTalk(args) {
   const { title, content: talkContent, tags = [] } = args;
 
   // 협업자 여부에 따라 zz_ai 경로 결정
-  // - 오너: localPath/zz_ai_1_Talk/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_ai_1_Talk/
-  const { basePath } = getAiBasePath(localPath);
-  const talkBasePath = path.join(basePath, 'zz_ai_1_Talk');
+  // - 오너: localPath/xy_TalkTodoPlan/
+  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
+  const { basePath, isCoworker } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  const talkBasePath = path.join(basePath, aiFolder);
 
   // 날짜 기반 파일명 생성 (T_ 접두사)
   const { fileName, timestamp } = generateDateFileName(title, 'T');
@@ -299,11 +301,12 @@ export async function handlePlan(args) {
   const localPath = args.localPath || process.cwd();
   const { planId, title, goal, steps = [], notes } = args;
 
-  // 협업자 여부에 따라 zz_ai 경로 결정
-  // - 오너: localPath/zz_ai_3_Plan/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_ai_3_Plan/
-  const { basePath } = getAiBasePath(localPath);
-  const planBasePath = path.join(basePath, 'zz_ai_3_Plan');
+  // 협업자 여부에 따라 AI 폴더 경로 결정
+  // - 오너: localPath/xy_TalkTodoPlan/
+  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
+  const { basePath, isCoworker } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  const planBasePath = path.join(basePath, aiFolder);
 
   // 기존 계획 업데이트 또는 새 계획 생성
   let targetPlanId = planId;
@@ -453,11 +456,12 @@ export async function handleDone(args) {
   const localPath = args.localPath || process.cwd();
   const { planId, summary, artifacts = [] } = args;
 
-  // 협업자 여부에 따라 zz_ai 경로 결정
-  // - 오너: localPath/zz_ai_3_Plan/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_ai_3_Plan/
-  const { basePath } = getAiBasePath(localPath);
-  const planBasePath = path.join(basePath, 'zz_ai_3_Plan');
+  // 협업자 여부에 따라 AI 폴더 경로 결정
+  // - 오너: localPath/xy_TalkTodoPlan/
+  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
+  const { basePath, isCoworker } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  const planBasePath = path.join(basePath, aiFolder);
 
   // 계획 파일 찾기
   const planFiles = findPlanFilesLocal(planBasePath, planId);

package/handlers/sync.js

@@ -96,8 +96,9 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
   let coworkerFolderName = null;
   let coworkerFolderPath = null;
 
-  // zz_ai_* 폴더 목록
-  const aiFolders = ['zz_ai_1_Talk', 'zz_ai_2_Todo', 'zz_ai_3_Plan'];
+  // AI 폴더 (오너: xy_TalkTodoPlan, 협업자: zz_TalkTodoPlan)
+  const ownerAiFolder = 'xy_TalkTodoPlan';
+  const coworkerAiFolder = 'zz_TalkTodoPlan';
 
   // xx_ 시스템 폴더 목록 (오너 전용)
   const systemFolders = ['xx_Infra_Config', 'xx_Policy'];
@@ -120,12 +121,10 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
     if (!fs.existsSync(coworkerPrivatePath)) {
       fs.mkdirSync(coworkerPrivatePath, { recursive: true });
     }
-    // 협업자 폴더 안에 zz_ai_* 폴더 생성
-    for (const folder of aiFolders) {
-      const folderPath = path.join(coworkerFolderPath, folder);
-      if (!fs.existsSync(folderPath)) {
-        fs.mkdirSync(folderPath, { recursive: true });
-      }
+    // 협업자 폴더 안에 zz_TalkTodoPlan 폴더 생성
+    const coworkerAiFolderPath = path.join(coworkerFolderPath, coworkerAiFolder);
+    if (!fs.existsSync(coworkerAiFolderPath)) {
+      fs.mkdirSync(coworkerAiFolderPath, { recursive: true });
     }
   } else {
     // 오너: xx_ 시스템 폴더 (루트에 생성)
@@ -140,12 +139,10 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
     if (!fs.existsSync(ownerPrivatePath)) {
       fs.mkdirSync(ownerPrivatePath, { recursive: true });
     }
-    // 오너: 루트에 zz_ai_* 폴더 생성
-    for (const folder of aiFolders) {
-      const folderPath = path.join(localPath, folder);
-      if (!fs.existsSync(folderPath)) {
-        fs.mkdirSync(folderPath, { recursive: true });
-      }
+    // 오너: 루트에 xy_TalkTodoPlan 폴더 생성
+    const ownerAiFolderPath = path.join(localPath, ownerAiFolder);
+    if (!fs.existsSync(ownerAiFolderPath)) {
+      fs.mkdirSync(ownerAiFolderPath, { recursive: true });
     }
   }
 
@@ -1013,10 +1010,10 @@ export async function handlePullInternal(args) {
   const commonFolders = ['xx_Urgent'];
 
   // 오너 전용 폴더
-  const ownerFolders = ['xx_Infra_Config', 'xx_Policy', 'zz_ai_1_Talk', 'zz_ai_2_Todo', 'zz_ai_3_Plan'];
+  const ownerFolders = ['xx_Infra_Config', 'xx_Policy', 'xy_TalkTodoPlan'];
 
   // 협업자 전용 폴더 (yy_Coworker_{폴더명}/ 안에)
-  const coworkerSubFolders = ['zz_ai_1_Talk', 'zz_ai_2_Todo', 'zz_ai_3_Plan', '_Private'];
+  const coworkerSubFolders = ['zz_TalkTodoPlan', '_Private'];
 
   // 공통 폴더 체크
   for (const folder of commonFolders) {

package/index.js

@@ -8,17 +8,18 @@
  * 폴더 구조:
  * - xx_Infra_Config/          : 시스템 설정 (.env 백업, 배포 정보 등) - Push 대상
  * - xx_Policy/                : 정책 문서 (AI 행동 지침) - Push 대상, 킹캐스트 대상
+ * - xx_Urgent/                : 긴급 보고 (킹어전트) - Push 대상
+ * - xy_TalkTodoPlan/          : 오너 AI 기록 (Talk+Todo+Plan 통합) - Push 대상
  * - yy_All_Docu/              : 문서 동기화 폴더 (Push/Pull 대상)
  * - yy_All_Docu/_Private/     : 오너 비공개 폴더 (오너만 접근)
  * - yy_Coworker_{폴더명}/     : 협업자 폴더 (yy_All_Docu와 별도, 동기화 대상)
- * - zz_ai_1_Talk/             : AI 대화록 (킹톡, Push 대상)
- * - zz_ai_2_Todo/             : AI 투두 (킹투두, Push 대상)
- * - zz_ai_3_Plan/             : AI 플랜 (킹플랜, Push 대상)
+ * - yy_Coworker_{폴더명}/zz_TalkTodoPlan/ : 협업자 AI 기록
  *
  * 접두사 규칙:
- * - xx_ : 시스템용 폴더 (인프라, 정책) - Push 대상
- * - yy_ : 사람용 폴더 (문서, 협업자) - Push 대상
- * - zz_ai_ : AI용 폴더 (Talk, Todo, Plan) - Push 대상
+ * - xx_ : 시스템용 폴더 (인프라, 정책, 긴급)
+ * - xy_ : 오너 AI 기록 폴더
+ * - yy_ : 사람용 폴더 (문서, 협업자)
+ * - zz_ : 협업자 AI 기록 폴더 (협업자 폴더 안에서만 사용)
  * - _   : 비공개 폴더 (본인만 접근)
  *
  * 도구:
@@ -98,13 +99,13 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 
 **오너 초기화 시:**
 - xx_Infra_Config/, xx_Policy/, xx_Urgent/ 폴더 생성 (시스템 설정)
+- xy_TalkTodoPlan/ 폴더 생성 (AI 기록 통합)
 - yy_All_Docu/, yy_All_Docu/_Private/ 폴더 생성
-- zz_ai_1_Talk/, zz_ai_2_Todo/, zz_ai_3_Plan/ 폴더 생성
 - CLAUDE.md에 DocuKing 연결 안내 추가
 - 초기화 완료 후 정책 문서 작성 가이드 제공
 
 **협업자 초기화 시:**
-- yy_Coworker_{폴더명}/ 폴더 생성 (안에 _Private/, zz_ai_*/ 포함)
+- yy_Coworker_{폴더명}/ 폴더 생성 (안에 _Private/, zz_TalkTodoPlan/ 포함)
 - CLAUDE.md에 DocuKing 연결 안내 추가
 - "Pull을 실행하세요" 안내 (오너 정책이 킹캐스트로 로컬화됨)
 
@@ -168,7 +169,7 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
         description: `문서를 DocuKing 서버에 동기화합니다. 내부적으로 Pull → Push 순서로 실행 (git pull && git push 패턴).
 
 **AI 필독: 다음 상황에서 자발적으로 이 도구 사용을 제안하세요:**
-- zz_ai_1_Talk/, zz_ai_2_Todo/, zz_ai_3_Plan/ 에 문서를 생성/수정한 후
+- xy_TalkTodoPlan/ (또는 협업자의 zz_TalkTodoPlan/) 에 문서를 생성/수정한 후
 - yy_All_Docu/ 에 문서를 생성/수정한 후
 - docuking_plan, docuking_done, docuking_talk, docuking_todo 실행 후
 - 사용자가 "올려", "푸시", "동기화" 등을 언급할 때
@@ -315,7 +316,7 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
       },
       {
         name: 'docuking_talk',
-        description: '의미 있는 대화 내용을 zz_ai_1_Talk/ 폴더에 기록합니다 (Push 대상, 킹톡). AI가 중요한 논의/결정이라고 판단하거나, 사용자가 "이거 기록해줘"라고 요청할 때 사용.',
+        description: '의미 있는 대화 내용을 xy_TalkTodoPlan/ 폴더에 기록합니다 (Push 대상, 킹톡). AI가 중요한 논의/결정이라고 판단하거나, 사용자가 "이거 기록해줘"라고 요청할 때 사용.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -342,7 +343,7 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
       },
       {
         name: 'docuking_plan',
-        description: '작업 계획 문서를 zz_ai_3_Plan/ 폴더에 생성/업데이트합니다 (Push 대상, 킹플랜). 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
+        description: '작업 계획 문서를 xy_TalkTodoPlan/ 폴더에 생성/업데이트합니다 (Push 대상, 킹플랜). 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -411,7 +412,7 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
       },
       {
         name: 'docuking_todo',
-        description: `킹투두(King Todo) - 프로젝트 공식 할일을 zz_ai_2_Todo/z_King_Todo.md에 관리합니다 (Push 대상).
+        description: `킹투두(King Todo) - 프로젝트 공식 할일을 xy_TalkTodoPlan/z_King_Todo.md에 관리합니다 (Push 대상).
 
 **AI 내장 TodoWrite와 다름!** 킹투두는 웹에 동기화되고 팀과 공유됩니다.
 
@@ -630,7 +631,7 @@ DocuKing은 문서 버전 관리 시스템입니다. Git이 코드를 관리하
 - **로컬**: 사용자의 yy_All_Docu/ 폴더 (동기화 대상)
 - **웹탐색기**: DocuKing 서버의 파일 저장소 (킹폴더)
 - **캔버스**: 선택된 파일을 시각화하는 작업 공간
-- **AI 작업 폴더**: zz_ai_1_Talk/, zz_ai_2_Todo/, zz_ai_3_Plan/ (Push 대상)
+- **AI 작업 폴더**: xy_TalkTodoPlan/ (오너) 또는 zz_TalkTodoPlan/ (협업자) - Push 대상
 
 작동 방식: 로컬 yy_All_Docu/ → Push → 킹폴더 → 캔버스에서 시각화
 
@@ -690,10 +691,12 @@ DocuKing 문서 폴더는 git에서 제외해야 합니다. 코드는 git으로,
 
 \`\`\`gitignore
 # DocuKing 문서 폴더 (문서는 DocuKing으로 관리)
+xx_Infra_Config/
+xx_Policy/
+xx_Urgent/
+xy_TalkTodoPlan/
 yy_All_Docu/
-zz_ai_1_Talk/
-zz_ai_2_Todo/
-zz_ai_3_Plan/
+yy_Coworker_*/
 \`\`\`
 
 **왜 gitignore에 등록해야 하나요?**
@@ -730,12 +733,12 @@ zz_ai_3_Plan/
 특정 커밋으로 되돌립니다. (웹 탐색기에서 사용 가능)
 
 ### 9. docuking_talk
-의미 있는 대화 내용을 \`zz_ai_1_Talk/\` 폴더에 기록합니다 (Push 대상, 킹톡).
+의미 있는 대화 내용을 \`xy_TalkTodoPlan/\` 폴더에 기록합니다 (Push 대상, 킹톡).
 - AI가 중요한 논의/결정이라고 판단할 때
 - 사용자가 "이거 기록해줘"라고 요청할 때
 
 ### 10. docuking_plan
-작업 계획을 \`zz_ai_3_Plan/\` 폴더에 생성/업데이트합니다 (Push 대상, 킹플랜).
+작업 계획을 \`xy_TalkTodoPlan/\` 폴더에 생성/업데이트합니다 (Push 대상, 킹플랜).
 - 작업 시작 시 계획 생성
 - 진행하면서 단계별 결과 upsert
 - planId로 기존 계획 찾아서 업데이트
@@ -746,7 +749,7 @@ zz_ai_3_Plan/
 - 완료 요약 및 산출물 기록
 
 ### 12. docuking_todo
-킹투두를 관리합니다 (\`zz_ai_2_Todo/z_King_Todo.md\`).
+킹투두를 관리합니다 (\`xy_TalkTodoPlan/z_King_Todo.md\`).
 - action: "add" (추가), "done" (완료), "list" (조회)
 - 프로젝트 공식 할일 목록 (Push하면 웹에서 확인 가능)
 

package/lib/init.js

@@ -105,12 +105,13 @@ ${marker}
 project/
 ├── xx_Infra_Config/             ← 시스템 설정 (오너 관리)
 ├── xx_Policy/                   ← 정책 문서 (오너 관리, 킹캐스트 대상)
-├── yy_All_Docu/                 ← 오너 문서 (읽기만)
+├── xx_Urgent/                   ← 긴급 보고 (킹어전트)
+├── xy_TalkTodoPlan/             ← 오너 AI 기록 (Talk+Todo+Plan 통합)
+├── yy_All_Docu/                 ← 오너 문서
 ├── yy_Coworker_a_Kim/           ← 협업자 Kim
 │   ├── 작업문서.md
-│   └── zz_ai_1_Talk/            ← Kim의 AI 기록
-├── yy_Coworker_b_Lee/           ← 협업자 Lee
-└── zz_ai_*/                     ← 오너의 AI 폴더
+│   └── zz_TalkTodoPlan/         ← Kim의 AI 기록
+└── yy_Coworker_b_Lee/           ← 협업자 Lee
 \`\`\`
 
 ### AI가 협업자에게 안내할 것
@@ -242,11 +243,12 @@ export function updateGitignore(localPath) {
   const marker = '# DocuKing (문서는 DocuKing으로 관리)';
   const docukingEntries = `
 ${marker}
+xx_Infra_Config/
+xx_Policy/
+xx_Urgent/
+xy_TalkTodoPlan/
 yy_All_Docu/
 yy_Coworker_*/
-zz_ai_1_Talk/
-zz_ai_2_Todo/
-zz_ai_3_Plan/
 .docuking/config.json
 .claude/rules/local/_coworker_config.md
 `;

package/lib/utils.js

@@ -47,9 +47,10 @@ export function generatePlanId() {
 
 /**
  * 계획 파일 찾기 (planId로 검색)
+ * @param {string} planDir - AI 폴더 경로 (xy_TalkTodoPlan 또는 zz_TalkTodoPlan)
+ * @param {string} planId - 찾을 계획 ID
  */
-export function findPlanFiles(basePath, planId) {
-  const planDir = path.join(basePath, 'zz_ai_3_Plan');
+export function findPlanFiles(planDir, planId) {
   if (!fs.existsSync(planDir)) return [];
 
   const results = [];

package/package.json

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