docuking-mcp 1.5.0 → 1.6.0

package/index.js

@@ -451,6 +451,33 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ['localPath', 'planId', 'summary'],
         },
       },
+      {
+        name: 'docuking_todo',
+        description: '할일을 z_DocuKing/z_Todo/z_Todo.md 파일에 추가하거나 완료 표시합니다. 단일 파일에 계속 누적되어 전체 작업 히스토리가 됩니다. 논의 후 할일이 생기면 바로 등록하세요.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            localPath: {
+              type: 'string',
+              description: '로컬 프로젝트 경로',
+            },
+            action: {
+              type: 'string',
+              enum: ['add', 'done', 'list'],
+              description: 'add: 할일 추가, done: 완료 표시, list: 목록 조회',
+            },
+            todo: {
+              type: 'string',
+              description: '할일 내용 (add 시 필수)',
+            },
+            todoId: {
+              type: 'number',
+              description: '할일 번호 (done 시 필수)',
+            },
+          },
+          required: ['localPath', 'action'],
+        },
+      },
     ],
   };
 });
@@ -958,6 +985,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return await handlePlan(args);
       case 'docuking_done':
         return await handleDone(args);
+      case 'docuking_todo':
+        return await handleTodo(args);
       default:
         throw new Error(`Unknown tool: ${name}`);
     }
@@ -2035,6 +2064,157 @@ function generatePlanId() {
   return id;
 }
 
+// docuking_todo 구현 - 할일 추가/완료/조회 (단일 파일 누적)
+async function handleTodo(args) {
+  const { localPath, action, todo, todoId } = args;
+
+  // z_Todo 폴더 경로
+  const todoBasePath = path.join(localPath, 'z_DocuKing', 'z_Todo');
+  const todoFilePath = path.join(todoBasePath, 'z_Todo.md');
+
+  // 폴더 생성
+  if (!fs.existsSync(todoBasePath)) {
+    fs.mkdirSync(todoBasePath, { recursive: true });
+  }
+
+  // 파일이 없으면 헤더와 함께 생성
+  if (!fs.existsSync(todoFilePath)) {
+    const header = `# TODO 목록
+
+> 이 파일은 모든 할일을 누적 기록합니다.
+> - [ ] 미완료 / - [x] 완료 (완료 시 날짜 추가)
+
+---
+
+`;
+    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 dateStr = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')}`;
+  const timeStr = `${String(now.getHours()).padStart(2, '0')}:${String(now.getMinutes()).padStart(2, '0')}`;
+
+  if (action === 'add') {
+    if (!todo) {
+      return {
+        content: [{ type: 'text', text: '오류: todo 파라미터가 필요합니다.' }],
+      };
+    }
+
+    const newId = maxId + 1;
+    const newTodo = `${newId}. - [ ] ${todo} (${dateStr})\n`;
+
+    // 파일 끝에 추가
+    fs.appendFileSync(todoFilePath, newTodo, 'utf-8');
+
+    return {
+      content: [{
+        type: 'text',
+        text: `✓ TODO 추가 완료!
+
+📝 #${newId}: ${todo}
+📅 등록: ${dateStr} ${timeStr}
+
+💡 완료 시: docuking_todo(action: "done", todoId: ${newId})`,
+      }],
+    };
+  }
+
+  if (action === 'done') {
+    if (!todoId) {
+      return {
+        content: [{ type: 'text', text: '오류: todoId 파라미터가 필요합니다.' }],
+      };
+    }
+
+    // 해당 번호의 TODO 찾아서 완료 표시
+    const todoLinePattern = new RegExp(`^(${todoId}\\. - \\[)( )(\\].*)$`, 'm');
+    const matched = content.match(todoLinePattern);
+
+    if (!matched) {
+      return {
+        content: [{ type: 'text', text: `오류: TODO #${todoId}를 찾을 수 없습니다.` }],
+      };
+    }
+
+    // [ ] -> [x] 변경 + 완료 날짜 추가
+    const updatedContent = content.replace(
+      todoLinePattern,
+      `$1x$3 ✓${dateStr}`
+    );
+
+    fs.writeFileSync(todoFilePath, updatedContent, 'utf-8');
+
+    // 완료된 TODO 내용 추출
+    const todoContent = matched[0].replace(/^\d+\. - \[ \] /, '').replace(/ \(\d{4}-\d{2}-\d{2}\)$/, '');
+
+    return {
+      content: [{
+        type: 'text',
+        text: `✓ TODO #${todoId} 완료!
+
+✅ ${todoContent}
+📅 완료: ${dateStr} ${timeStr}`,
+      }],
+    };
+  }
+
+  if (action === 'list') {
+    // 미완료 TODO만 추출
+    const pendingPattern = /^(\d+)\. - \[ \] (.+)$/gm;
+    const pendingTodos = [];
+    let listMatch;
+    while ((listMatch = pendingPattern.exec(content)) !== null) {
+      pendingTodos.push({ id: listMatch[1], content: listMatch[2] });
+    }
+
+    // 완료된 TODO 수 세기
+    const completedCount = (content.match(/- \[x\]/g) || []).length;
+
+    if (pendingTodos.length === 0) {
+      return {
+        content: [{
+          type: 'text',
+          text: `📋 미완료 TODO: 없음
+
+✅ 완료된 TODO: ${completedCount}개
+📁 전체 기록: z_DocuKing/z_Todo/z_Todo.md`,
+        }],
+      };
+    }
+
+    const listText = pendingTodos.map(t => `  #${t.id}: ${t.content}`).join('\n');
+
+    return {
+      content: [{
+        type: 'text',
+        text: `📋 미완료 TODO: ${pendingTodos.length}개
+
+${listText}
+
+✅ 완료된 TODO: ${completedCount}개
+📁 전체 기록: z_DocuKing/z_Todo/z_Todo.md`,
+      }],
+    };
+  }
+
+  return {
+    content: [{ type: 'text', text: '오류: action은 add, done, list 중 하나여야 합니다.' }],
+  };
+}
+
 // docuking_talk 구현 - 대화록 자동 저장
 async function handleTalk(args) {
   const { localPath, title, content, tags = [] } = args;

package/package.json

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