docuking-mcp 2.5.7 → 2.7.0

package/handlers/docs.js

@@ -0,0 +1,519 @@
+/**
+ * DocuKing MCP - 문서 핸들러 모듈
+ * todo, talk, plan, done
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+import { getAiBasePath } from '../lib/config.js';
+import { generateDateFileName, generatePlanId, findPlanFiles } from '../lib/utils.js';
+import { handlePush } from './sync.js';
+
+/**
+ * docuking_todo 구현 - 킹투두 (단일 파일 누적)
+ */
+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');
+  const todoFilePath = path.join(todoBasePath, 'z_King_Todo.md');
+
+  // 폴더 생성
+  if (!fs.existsSync(todoBasePath)) {
+    fs.mkdirSync(todoBasePath, { recursive: true });
+  }
+
+  // 파일이 없으면 헤더와 함께 생성
+  if (!fs.existsSync(todoFilePath)) {
+    const header = `# TODO 목록
+
+> 날짜 1개 = 등록일 (진행중) / 날짜 2개 = 등록일/완료일 (완료)
+
+---
+
+`;
+    fs.writeFileSync(todoFilePath, header, 'utf-8');
+  }
+
+  // 파일 읽기
+  let content = fs.readFileSync(todoFilePath, 'utf-8');
+
+  // 현재 TODO 번호 찾기 (가장 큰 번호)
+  const todoPattern = /^(\d+)\. /gm;
+  let maxId = 0;
+  let match;
+  while ((match = todoPattern.exec(content)) !== null) {
+    const id = parseInt(match[1], 10);
+    if (id > maxId) maxId = id;
+  }
+
+  const now = new Date();
+  const month = String(now.getMonth() + 1).padStart(2, '0');
+  const day = String(now.getDate()).padStart(2, '0');
+  const dateStr = `${month}.${day}`;
+
+  if (action === 'add') {
+    if (!todo) {
+      return {
+        content: [{ type: 'text', text: '오류: todo 파라미터가 필요합니다.' }],
+      };
+    }
+
+    const newId = maxId + 1;
+
+    // todo에서 태그와 키워드, 설명 분리
+    // 형식: "[태그] 키워드 - 설명" 또는 "[태그] 키워드"
+    let tag = '';
+    let keyword = '';
+    let description = '';
+
+    const tagMatch = todo.match(/^\[([^\]]+)\]\s*/);
+    if (tagMatch) {
+      tag = tagMatch[1];
+      const rest = todo.slice(tagMatch[0].length);
+      const descSplit = rest.split(/\s*[-–]\s*/);
+      keyword = descSplit[0].trim();
+      description = descSplit.slice(1).join(' - ').trim();
+    } else {
+      // 태그 없이 입력된 경우
+      const descSplit = todo.split(/\s*[-–]\s*/);
+      keyword = descSplit[0].trim();
+      description = descSplit.slice(1).join(' - ').trim();
+    }
+
+    // 킹투두 형식으로 작성
+    let newTodo;
+    if (tag) {
+      newTodo = `${newId}. ⚙️ **[${tag}] ${keyword}** ${dateStr}\n`;
+    } else {
+      newTodo = `${newId}. ⚙️ **${keyword}** ${dateStr}\n`;
+    }
+
+    if (description) {
+      newTodo += `       ${description}\n`;
+    }
+    newTodo += '\n';
+
+    // 파일 끝에 추가
+    fs.appendFileSync(todoFilePath, newTodo, 'utf-8');
+
+    return {
+      content: [{
+        type: 'text',
+        text: `✓ 킹투두에 등록했습니다!
+
+📝 #${newId}: ${tag ? `[${tag}] ` : ''}${keyword}${description ? ` - ${description}` : ''}
+📅 등록: ${dateStr}
+
+💡 완료 시: docuking_todo(action: "done", todoId: ${newId})`,
+      }],
+    };
+  }
+
+  if (action === 'done') {
+    if (!todoId) {
+      return {
+        content: [{ type: 'text', text: '오류: todoId 파라미터가 필요합니다.' }],
+      };
+    }
+
+    // 해당 번호의 TODO 찾아서 ⚙️ -> ✅ 변경 및 날짜 추가
+    const todoLinePattern = new RegExp(`^(${todoId}\\. )⚙️( \\*\\*.*\\*\\* )(\\d+\\.\\d+)(.*)$`, 'm');
+    const matched = content.match(todoLinePattern);
+
+    if (!matched) {
+      // 이미 완료된 항목인지 확인
+      const completedPattern = new RegExp(`^${todoId}\\. ✅`, 'm');
+      if (completedPattern.test(content)) {
+        return {
+          content: [{ type: 'text', text: `킹투두 #${todoId}는 이미 완료 상태입니다.` }],
+        };
+      }
+      return {
+        content: [{ type: 'text', text: `오류: 킹투두 #${todoId}를 찾을 수 없습니다.` }],
+      };
+    }
+
+    // ⚙️ -> ✅ 변경 + 완료 날짜 추가 (등록일/완료일)
+    const updatedContent = content.replace(
+      todoLinePattern,
+      `$1✅$2$3/${dateStr}$4`
+    );
+
+    fs.writeFileSync(todoFilePath, updatedContent, 'utf-8');
+
+    // 완료된 TODO 내용 추출
+    const keywordMatch = matched[2].match(/\*\*(.+)\*\*/);
+    const todoKeyword = keywordMatch ? keywordMatch[1] : '';
+
+    return {
+      content: [{
+        type: 'text',
+        text: `✓ 킹투두 #${todoId} 완료!
+
+✅ ${todoKeyword}
+📅 완료: ${dateStr}`,
+      }],
+    };
+  }
+
+  if (action === 'list') {
+    // 미완료(⚙️) TODO 추출
+    const pendingPattern = /^(\d+)\. ⚙️ \*\*(.+)\*\* (\d+\.\d+)/gm;
+    const pendingTodos = [];
+    let listMatch;
+    while ((listMatch = pendingPattern.exec(content)) !== null) {
+      pendingTodos.push({ id: listMatch[1], keyword: listMatch[2], date: listMatch[3] });
+    }
+
+    // 완료된(✅) TODO 수 세기
+    const completedCount = (content.match(/^(\d+)\. ✅/gm) || []).length;
+
+    if (pendingTodos.length === 0) {
+      return {
+        content: [{
+          type: 'text',
+          text: `📋 킹투두 미결: 없음
+
+✅ 완료: ${completedCount}개
+📁 전체 기록: zz_ai_2_Todo/z_King_Todo.md`,
+        }],
+      };
+    }
+
+    const listText = pendingTodos.map(t => `  #${t.id}: ${t.keyword} (${t.date})`).join('\n');
+
+    return {
+      content: [{
+        type: 'text',
+        text: `📋 킹투두 미결: ${pendingTodos.length}개
+
+${listText}
+
+✅ 완료: ${completedCount}개
+📁 전체 기록: zz_ai_2_Todo/z_King_Todo.md`,
+      }],
+    };
+  }
+
+  return {
+    content: [{ type: 'text', text: '오류: action은 add, done, list 중 하나여야 합니다.' }],
+  };
+}
+
+/**
+ * docuking_talk 구현 - 대화록 자동 저장
+ */
+export async function handleTalk(args) {
+  const localPath = args.localPath || process.cwd();
+  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');
+
+  // 날짜 기반 파일명 생성 (T_ 접두사)
+  const { fileName, timestamp } = generateDateFileName(title, 'T');
+  const talkFilePath = path.join(talkBasePath, fileName);
+
+  // 폴더 생성
+  if (!fs.existsSync(talkBasePath)) {
+    fs.mkdirSync(talkBasePath, { recursive: true });
+  }
+
+  // 태그 문자열
+  const tagString = tags.length > 0 ? `\n태그: ${tags.map(t => `#${t}`).join(' ')}` : '';
+
+  // 마크다운 문서 생성
+  const document = `# ${title}
+
+> 기록 시간: ${timestamp}${tagString}
+
+---
+
+${talkContent}
+
+---
+*이 문서는 AI와의 대화에서 자동 생성되었습니다.*
+`;
+
+  // 파일 저장
+  fs.writeFileSync(talkFilePath, document, 'utf-8');
+
+  const relativePath = path.relative(localPath, talkFilePath).replace(/\\/g, '/');
+
+  return {
+    content: [
+      {
+        type: 'text',
+        text: `✓ 대화록 저장 완료!
+
+📝 제목: ${title}
+📁 경로: ${relativePath}
+🕐 시간: ${timestamp}${tags.length > 0 ? `\n🏷️  태그: ${tags.join(', ')}` : ''}
+
+💡 DocuKing에 Push하면 웹에서도 확인할 수 있습니다.`,
+      },
+    ],
+  };
+}
+
+/**
+ * 계획 파일 찾기 유틸 (로컬 버전)
+ */
+function findPlanFilesLocal(basePath, planId) {
+  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(`__${planId}.md`)) {
+        results.push(fullPath);
+      }
+    }
+  }
+
+  searchDir(basePath);
+  return results;
+}
+
+/**
+ * docuking_plan 구현 - 작업 계획 생성/업데이트
+ */
+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');
+
+  // 기존 계획 업데이트 또는 새 계획 생성
+  let targetPlanId = planId;
+  let isNew = !planId;
+  let planFilePath;
+  let existingContent = null;
+
+  if (planId) {
+    // 기존 계획 찾기
+    const planFiles = findPlanFilesLocal(planBasePath, planId);
+    if (planFiles.length === 0) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `오류: planId '${planId}'에 해당하는 계획을 찾을 수 없습니다.`,
+          },
+        ],
+      };
+    }
+    planFilePath = planFiles[0];
+    existingContent = fs.readFileSync(planFilePath, 'utf-8');
+  } else {
+    // 새 계획 생성
+    targetPlanId = generatePlanId();
+    const { fileName, timestamp } = generateDateFileName(title, 'P');
+
+    if (!fs.existsSync(planBasePath)) {
+      fs.mkdirSync(planBasePath, { recursive: true });
+    }
+
+    // 파일명에 planId 포함
+    const fileNameWithId = fileName.replace('.md', `__${targetPlanId}.md`);
+    planFilePath = path.join(planBasePath, fileNameWithId);
+  }
+
+  // 현재 시간
+  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 stepsMarkdown = steps.length > 0
+    ? steps.map((step, i) => {
+        const statusIcon = step.status === 'done' ? '✅' : step.status === 'in_progress' ? '🔄' : '⬜';
+        const resultText = step.result ? ` → ${step.result}` : '';
+        return `${i + 1}. ${statusIcon} ${step.name}${resultText}`;
+      }).join('\n')
+    : '(단계 미정의)';
+
+  // 진행률 계산
+  const doneCount = steps.filter(s => s.status === 'done').length;
+  const totalCount = steps.length;
+  const progress = totalCount > 0 ? Math.round((doneCount / totalCount) * 100) : 0;
+
+  // 마크다운 문서 생성
+  let document;
+  if (isNew) {
+    document = `# ${title}
+
+> Plan ID: \`${targetPlanId}\`
+> 생성: ${timestamp}
+> 상태: 진행 중 (${progress}%)
+
+---
+
+## 목표
+${goal || '(목표 미정의)'}
+
+## 진행 단계
+${stepsMarkdown}
+
+## 노트
+${notes || '(없음)'}
+
+---
+
+## 진행 기록
+- ${timestamp}: 계획 생성
+
+---
+*이 문서는 AI 작업 계획에서 자동 생성되었습니다.*
+`;
+  } else {
+    // 기존 문서 업데이트 (진행 기록에 추가)
+    const updateEntry = `- ${timestamp}: 계획 업데이트 (진행률 ${progress}%)`;
+
+    // 기존 내용에서 섹션 업데이트
+    document = existingContent
+      .replace(/> 상태: .+/, `> 상태: 진행 중 (${progress}%)`)
+      .replace(/## 진행 단계\n[\s\S]*?(?=\n## )/, `## 진행 단계\n${stepsMarkdown}\n\n`)
+      .replace(/## 진행 기록\n/, `## 진행 기록\n${updateEntry}\n`);
+
+    if (notes) {
+      document = document.replace(/## 노트\n[\s\S]*?(?=\n---\n\n## 진행 기록)/, `## 노트\n${notes}\n\n`);
+    }
+  }
+
+  // 파일 저장
+  fs.writeFileSync(planFilePath, document, 'utf-8');
+
+  const relativePath = path.relative(localPath, planFilePath).replace(/\\/g, '/');
+
+  return {
+    content: [
+      {
+        type: 'text',
+        text: `✓ 작업 계획 ${isNew ? '생성' : '업데이트'} 완료!
+
+📋 제목: ${title}
+🆔 Plan ID: ${targetPlanId}
+📁 경로: ${relativePath}
+📊 진행률: ${progress}% (${doneCount}/${totalCount})
+
+💡 이 planId를 기억해두세요. 나중에 업데이트하거나 완료 처리할 때 필요합니다.
+💡 DocuKing에 Push하면 웹에서도 확인할 수 있습니다.`,
+      },
+    ],
+  };
+}
+
+/**
+ * docuking_done 구현 - 작업 완료 처리
+ */
+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');
+
+  // 계획 파일 찾기
+  const planFiles = findPlanFilesLocal(planBasePath, planId);
+  if (planFiles.length === 0) {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `오류: planId '${planId}'에 해당하는 계획을 찾을 수 없습니다.`,
+        },
+      ],
+    };
+  }
+
+  const planFilePath = planFiles[0];
+  let content = fs.readFileSync(planFilePath, 'utf-8');
+
+  // 현재 시간
+  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 artifactsMarkdown = artifacts.length > 0
+    ? artifacts.map(a => `- ${a}`).join('\n')
+    : '(없음)';
+
+  // 완료 섹션 추가
+  const completionSection = `
+
+## ✅ 완료
+> 완료 시간: ${timestamp}
+
+### 요약
+${summary}
+
+### 산출물
+${artifactsMarkdown}
+`;
+
+  // 상태 업데이트 및 완료 섹션 추가
+  content = content
+    .replace(/> 상태: .+/, `> 상태: ✅ 완료`)
+    .replace(/---\n\*이 문서는 AI 작업 계획에서 자동 생성되었습니다.\*/, `${completionSection}\n---\n*이 문서는 AI 작업 계획에서 자동 생성되었습니다.*`);
+
+  // 진행 기록에 완료 추가
+  content = content.replace(/## 진행 기록\n/, `## 진행 기록\n- ${timestamp}: ✅ 작업 완료\n`);
+
+  // 파일 저장
+  fs.writeFileSync(planFilePath, content, 'utf-8');
+
+  const relativePath = path.relative(localPath, planFilePath).replace(/\\/g, '/');
+
+  // Plan 완료 시 자동으로 킹푸시 실행 (문서 동기화)
+  let pushResult = null;
+  let pushMessage = '';
+  try {
+    pushResult = await handlePush({
+      localPath,
+      message: `Plan 완료: ${summary.substring(0, 50)}${summary.length > 50 ? '...' : ''}`,
+    });
+    pushMessage = '\n\n📤 DocuKing 자동 동기화 완료!';
+  } catch (e) {
+    pushMessage = `\n\n⚠️ DocuKing 동기화 실패: ${e.message}`;
+  }
+
+  return {
+    content: [
+      {
+        type: 'text',
+        text: `✅ 작업 완료 처리됨!
+
+🆔 Plan ID: ${planId}
+📁 경로: ${relativePath}
+🕐 완료 시간: ${timestamp}
+
+📝 요약: ${summary}
+${artifacts.length > 0 ? `📦 산출물: ${artifacts.length}개` : ''}${pushMessage}`,
+      },
+    ],
+  };
+}

package/handlers/index.js

@@ -0,0 +1,34 @@
+/**
+ * DocuKing MCP - 핸들러 통합 모듈
+ */
+
+// 동기화 핸들러
+export {
+  handleInit,
+  handlePush,
+  handlePull,
+  handlePullInternal,
+  handleList,
+  handleStatus,
+} from './sync.js';
+
+// 버전 관리 핸들러
+export {
+  handleLog,
+  handleDiff,
+  handleRollback,
+} from './version.js';
+
+// 문서 핸들러
+export {
+  handleTodo,
+  handleTalk,
+  handlePlan,
+  handleDone,
+} from './docs.js';
+
+// 킹캐스트 핸들러
+export {
+  executeKingcast,
+  handleKingcastStatus,
+} from './kingcast.js';