docuking-mcp 3.1.0 → 3.6.0

package/README.md

@@ -102,15 +102,15 @@ claude mcp add docuking -s user -- docuking-mcp
 ├── xx_Urgent/               ← 긴급 보고 (동기화 대상)
 ├── xy_TalkTodoPlan/         ← 오너 AI 기록 (Talk+Todo+Plan 통합)
 ├── yy_All_Docu/             ← 문서 허브 (동기화 대상)
-└── yy_Coworker_{이름}/      ← 협업자 작업 폴더 (동기화 대상)
-    └── zz_TalkTodoPlan/     ← 협업자의 AI 기록
+└── zz_Coworker_{이름}/      ← 협업자 작업 폴더 (동기화 대상)
+    └── {이름}_TalkTodoPlan/ ← 협업자의 AI 기록
 ```
 
 **접두사 규칙:**
 - `xx_*`: 시스템/인프라 폴더
 - `xy_*`: 오너 AI 기록 폴더
-- `yy_*`: 사람용 폴더
-- `zz_*`: 협업자 AI 기록 폴더 (협업자 폴더 안에서만)
+- `yy_*`: 오너 문서 폴더
+- `zz_*`: 협업자 폴더
 
 ## 웹사이트
 

package/handlers/docs.js

@@ -19,9 +19,9 @@ export async function handleTodo(args) {
 
   // 협업자 여부에 따라 AI 폴더 경로 결정
   // - 오너: localPath/xy_TalkTodoPlan/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
-  const { basePath, isCoworker } = getAiBasePath(localPath);
-  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  // - 협업자: localPath/zz_Coworker_{폴더명}/{폴더명}_TalkTodoPlan/
+  const { basePath, isCoworker, coworkerFolder } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? `${coworkerFolder}_TalkTodoPlan` : 'xy_TalkTodoPlan';
   const todoBasePath = path.join(basePath, aiFolder);
   const todoFilePath = path.join(todoBasePath, 'z_King_Todo.md');
 
@@ -211,15 +211,16 @@ ${listText}
 /**
  * docuking_talk 구현 - 대화록 자동 저장
  */
-export async function handleTalk(args) {
+// [deprecated] docuking_talkplan으로 대체됨
+async function handleTalk(args) {
   const localPath = args.localPath || process.cwd();
   const { title, content: talkContent, tags = [] } = args;
 
-  // 협업자 여부에 따라 zz_ai 경로 결정
+  // 협업자 여부에 따라 AI 폴더 경로 결정
   // - 오너: localPath/xy_TalkTodoPlan/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
-  const { basePath, isCoworker } = getAiBasePath(localPath);
-  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  // - 협업자: localPath/zz_Coworker_{폴더명}/{폴더명}_TalkTodoPlan/
+  const { basePath, isCoworker, coworkerFolder } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? `${coworkerFolder}_TalkTodoPlan` : 'xy_TalkTodoPlan';
   const talkBasePath = path.join(basePath, aiFolder);
 
   // 날짜 기반 파일명 생성 (T_ 접두사)
@@ -297,15 +298,16 @@ function findPlanFilesLocal(basePath, planId) {
 /**
  * docuking_plan 구현 - 작업 계획 생성/업데이트
  */
-export async function handlePlan(args) {
+// [deprecated] docuking_talkplan으로 대체됨
+async function handlePlan(args) {
   const localPath = args.localPath || process.cwd();
   const { planId, title, goal, steps = [], notes } = args;
 
   // 협업자 여부에 따라 AI 폴더 경로 결정
   // - 오너: localPath/xy_TalkTodoPlan/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
-  const { basePath, isCoworker } = getAiBasePath(localPath);
-  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  // - 협업자: localPath/zz_Coworker_{폴더명}/{폴더명}_TalkTodoPlan/
+  const { basePath, isCoworker, coworkerFolder } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? `${coworkerFolder}_TalkTodoPlan` : 'xy_TalkTodoPlan';
   const planBasePath = path.join(basePath, aiFolder);
 
   // 기존 계획 업데이트 또는 새 계획 생성
@@ -452,15 +454,16 @@ ${notes || '(없음)'}
 /**
  * docuking_done 구현 - 작업 완료 처리
  */
-export async function handleDone(args) {
+// [deprecated] docuking_talkplan으로 대체됨
+async function handleDone(args) {
   const localPath = args.localPath || process.cwd();
   const { planId, summary, artifacts = [] } = args;
 
   // 협업자 여부에 따라 AI 폴더 경로 결정
   // - 오너: localPath/xy_TalkTodoPlan/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
-  const { basePath, isCoworker } = getAiBasePath(localPath);
-  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  // - 협업자: localPath/zz_Coworker_{폴더명}/{폴더명}_TalkTodoPlan/
+  const { basePath, isCoworker, coworkerFolder } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? `${coworkerFolder}_TalkTodoPlan` : 'xy_TalkTodoPlan';
   const planBasePath = path.join(basePath, aiFolder);
 
   // 계획 파일 찾기
@@ -564,6 +567,216 @@ ${artifacts.length > 0 ? `📦 산출물: ${artifacts.length}개` : ''}${pushMes
   };
 }
 
+/**
+ * docuking_talkplan 구현 - 톡투플 통합 도구
+ *
+ * 흐름:
+ * 1. 대화 시작 → 문서 생성 (tpId 반환)
+ * 2. 대화 진행 → 내용 누적 (축약 없이 그대로)
+ * 3. 체크포인트 생기면 → 구현 계획 추가 (체크박스)
+ * 4. 작업 완료 → 해당 항목 완료 마킹
+ */
+export async function handleTalkPlan(args) {
+  const localPath = args.localPath || process.cwd();
+  const { tpId, title, append, checkpoint, markDone } = args;
+
+  // 협업자 여부에 따라 AI 폴더 경로 결정
+  const { basePath, isCoworker, coworkerFolder } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? `${coworkerFolder}_TalkTodoPlan` : 'xy_TalkTodoPlan';
+  const talkPlanBasePath = path.join(basePath, aiFolder);
+
+  // 폴더 생성
+  if (!fs.existsSync(talkPlanBasePath)) {
+    fs.mkdirSync(talkPlanBasePath, { recursive: true });
+  }
+
+  // 현재 시간
+  const now = new Date();
+  const timestamp = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')} ${String(now.getHours()).padStart(2, '0')}:${String(now.getMinutes()).padStart(2, '0')}`;
+  const timeOnly = `${String(now.getHours()).padStart(2, '0')}:${String(now.getMinutes()).padStart(2, '0')}`;
+
+  let targetTpId = tpId;
+  let talkPlanFilePath;
+  let isNew = false;
+
+  // 기존 문서 찾기 또는 새로 생성
+  if (tpId) {
+    // tpId로 기존 문서 찾기
+    const files = findTalkPlanFiles(talkPlanBasePath, tpId);
+    if (files.length === 0) {
+      return {
+        content: [{
+          type: 'text',
+          text: `오류: tpId '${tpId}'에 해당하는 톡투플 문서를 찾을 수 없습니다.`,
+        }],
+      };
+    }
+    talkPlanFilePath = files[0];
+  } else {
+    // 새 문서 생성
+    if (!title) {
+      return {
+        content: [{
+          type: 'text',
+          text: '오류: 새 문서 생성 시 title이 필요합니다.',
+        }],
+      };
+    }
+    isNew = true;
+    targetTpId = generatePlanId();
+    const { fileName } = generateDateFileName(title, 'TP');
+    const fileNameWithId = fileName.replace('.md', `__${targetTpId}.md`);
+    talkPlanFilePath = path.join(talkPlanBasePath, fileNameWithId);
+  }
+
+  let content;
+
+  if (isNew) {
+    // 새 문서 생성
+    content = `# ${title}
+
+> TalkPlan ID: \`${targetTpId}\`
+> 생성: ${timestamp}
+> 최종 업데이트: ${timestamp}
+
+---
+
+## 대화 기록
+
+[${timeOnly}]
+${append || '(대화 시작)'}
+
+---
+
+## 구현 계획
+
+(아직 없음)
+
+---
+*이 문서는 AI 대화에서 자동 생성되었습니다.*
+`;
+  } else {
+    // 기존 문서 읽기
+    content = fs.readFileSync(talkPlanFilePath, 'utf-8');
+
+    // 최종 업데이트 시간 갱신
+    content = content.replace(/> 최종 업데이트: .+/, `> 최종 업데이트: ${timestamp}`);
+
+    // 내용 누적 (append)
+    if (append) {
+      // "## 구현 계획" 바로 위에 추가
+      const planSectionMatch = content.match(/\n---\n\n## 구현 계획/);
+      if (planSectionMatch) {
+        const insertPos = content.indexOf(planSectionMatch[0]);
+        content = content.slice(0, insertPos) +
+          `\n[${timeOnly}]\n${append}\n` +
+          content.slice(insertPos);
+      }
+    }
+
+    // 체크포인트 추가 (checkpoint)
+    if (checkpoint) {
+      // 기존 체크포인트 수 세기
+      const checkboxPattern = /- \[[ x]\] \d+\./g;
+      const existingCheckboxes = content.match(checkboxPattern) || [];
+      const nextNum = existingCheckboxes.length + 1;
+
+      // "(아직 없음)" 제거
+      content = content.replace(/\(아직 없음\)\n?/, '');
+
+      // "---\n*이 문서는" 바로 위에 체크포인트 추가
+      const footerMatch = content.match(/\n---\n\*이 문서는/);
+      if (footerMatch) {
+        const insertPos = content.indexOf(footerMatch[0]);
+        content = content.slice(0, insertPos) +
+          `- [ ] ${nextNum}. ${checkpoint}\n` +
+          content.slice(insertPos);
+      }
+    }
+
+    // 완료 마킹 (markDone)
+    if (markDone !== undefined) {
+      const doneNumbers = Array.isArray(markDone) ? markDone : [markDone];
+      for (const num of doneNumbers) {
+        // "- [ ] N." 패턴을 "- [x] N." 로 변경 + 완료 시간 추가
+        const pattern = new RegExp(`- \\[ \\] ${num}\\.(.+?)(\n|$)`);
+        const match = content.match(pattern);
+        if (match) {
+          const taskText = match[1].trim();
+          content = content.replace(pattern, `- [x] ${num}. ${taskText} ✓${timeOnly}\n`);
+        }
+      }
+    }
+  }
+
+  // 파일 저장
+  fs.writeFileSync(talkPlanFilePath, content, 'utf-8');
+
+  const relativePath = path.relative(localPath, talkPlanFilePath).replace(/\\/g, '/');
+
+  // 응답 메시지 구성
+  let actionDesc = [];
+  if (isNew) actionDesc.push('문서 생성');
+  if (append && !isNew) actionDesc.push('대화 누적');
+  if (checkpoint) actionDesc.push(`체크포인트 추가`);
+  if (markDone !== undefined) {
+    const nums = Array.isArray(markDone) ? markDone : [markDone];
+    actionDesc.push(`#${nums.join(', #')} 완료 마킹`);
+  }
+
+  // 현재 미완료 체크포인트 목록 추출
+  const pendingPattern = /- \[ \] (\d+)\. (.+?)(\n|$)/g;
+  const pendingItems = [];
+  let match;
+  while ((match = pendingPattern.exec(content)) !== null) {
+    pendingItems.push({ num: match[1], task: match[2].trim() });
+  }
+
+  let pendingInfo = '';
+  if (pendingItems.length > 0) {
+    pendingInfo = `\n\n📋 미완료 항목:\n${pendingItems.map(p => `  #${p.num}: ${p.task}`).join('\n')}`;
+  }
+
+  return {
+    content: [{
+      type: 'text',
+      text: `✓ 톡투플 ${actionDesc.join(', ')}!
+
+🆔 TalkPlan ID: ${targetTpId}
+📁 경로: ${relativePath}
+🕐 시간: ${timestamp}${pendingInfo}
+
+💡 이 tpId를 기억하세요. 다음에 업데이트할 때 필요합니다.`,
+    }],
+  };
+}
+
+/**
+ * 톡투플 파일 찾기 (tpId로 검색)
+ */
+function findTalkPlanFiles(basePath, tpId) {
+  const results = [];
+
+  if (!fs.existsSync(basePath)) {
+    return results;
+  }
+
+  function searchDir(dirPath) {
+    const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(dirPath, entry.name);
+      if (entry.isDirectory()) {
+        searchDir(fullPath);
+      } else if (entry.isFile() && entry.name.includes(`__${tpId}.md`)) {
+        results.push(fullPath);
+      }
+    }
+  }
+
+  searchDir(basePath);
+  return results;
+}
+
 /**
  * docuking_urgent 구현 - 긴급 보고 (킹어전트)
  * 협업자가 예외 상황 발견 시 xx_Urgent/에 보고

package/handlers/kingcast.js

@@ -142,7 +142,7 @@ function localizeContent(content, config) {
   }
 
   const coworkerFolder = config.coworkerFolder || '';
-  const coworkerFolderName = `yy_Coworker_${coworkerFolder}`;
+  const coworkerFolderName = `zz_Coworker_${coworkerFolder}`;
 
   // 변수 치환
   let localized = content;
@@ -225,22 +225,22 @@ function updateLocalRules(localPath, currentFiles, changes, config) {
 - 프로젝트: ${projectName}
 - 역할: 협업자
 - 협업자 폴더명: ${coworkerFolder}
-- 작업 폴더: yy_Coworker_${coworkerFolder}/
+- 작업 폴더: zz_Coworker_${coworkerFolder}/
 - 권장 브랜치: coworker/${coworkerFolder}
 - 최종 동기화: ${new Date().toISOString()}
 
 ## DocuKing 문서 작업 범위
 
-※ 아래는 DocuKing 동기화 대상 폴더(yy_All_Docu/, yy_Coworker_*/, zz_ai_*/)에만 해당
+※ 아래는 DocuKing 동기화 대상 폴더(yy_All_Docu/, zz_Coworker_*/)에만 해당
 ※ 코드 파일(src/, backend/, frontend/ 등)은 자유롭게 수정 가능
 
 ### 킹푸시 가능한 영역
-- \`yy_Coworker_${coworkerFolder}/\` 폴더 안의 모든 파일
+- \`zz_Coworker_${coworkerFolder}/\` 폴더 안의 모든 파일
 
 ### 읽기만 가능한 영역
 - \`yy_All_Docu/\` - 오너의 문서
-- \`yy_Coworker_*/\` - 다른 협업자의 문서
-- \`zz_ai_*/\` - 오너의 AI 기록
+- \`zz_Coworker_*/\` - 다른 협업자의 문서
+- \`xy_TalkTodoPlan/\` - 오너의 AI 기록
 
 ### 주의: 위 폴더들은 수정해도 Pull하면 원본으로 덮어씌워짐
 - 수정이 필요하면 자기 폴더에 사본을 만들거나 오너에게 연락하세요