docuking-mcp 1.4.1 → 1.6.0

package/index.js

@@ -130,7 +130,7 @@ docuking_done({
 ### 절대 규칙
 - **작업 시작 전 반드시 \`docuking_plan\` 호출**
 - **작업 완료 후 반드시 \`docuking_done\` 호출**
-- 결과는 \`z_DocuKing/z_Plan_Result/\`에 자동 저장됨
+- 결과는 \`z_DocuKing/zz_Plan_Result/\`에 자동 저장됨 (플랫 구조)
 `;
 
   try {
@@ -357,7 +357,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'docuking_talk',
-        description: '의미 있는 대화 내용을 자동으로 z_Talk/ 폴더에 기록합니다. AI가 중요한 논의/결정이라고 판단하거나, 사용자가 "이거 기록해줘"라고 요청할 때 사용.',
+        description: '의미 있는 대화 내용을 z_DocuKing/z_Talk/ 폴더에 기록합니다 (플랫 구조). AI가 중요한 논의/결정이라고 판단하거나, 사용자가 "이거 기록해줘"라고 요청할 때 사용.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -384,7 +384,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'docuking_plan',
-        description: '작업 계획 문서를 z_Plan_Result/ 폴더에 생성하거나 업데이트합니다. 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
+        description: '작업 계획 문서를 z_DocuKing/zz_Plan_Result/ 폴더에 생성/업데이트합니다 (플랫 구조). 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -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'],
+        },
+      },
     ],
   };
 });
@@ -553,12 +580,12 @@ zz_Coworker_*/
 특정 커밋으로 되돌립니다. (웹 탐색기에서 사용 가능)
 
 ### 9. docuking_talk
-의미 있는 대화 내용을 \`z_Talk/\` 폴더에 자동 기록합니다.
+의미 있는 대화 내용을 \`z_DocuKing/z_Talk/\` 폴더에 기록합니다 (플랫 구조).
 - AI가 중요한 논의/결정이라고 판단할 때
 - 사용자가 "이거 기록해줘"라고 요청할 때
 
 ### 10. docuking_plan
-작업 계획을 \`z_Plan_Result/\` 폴더에 생성/업데이트합니다.
+작업 계획을 \`z_DocuKing/zz_Plan_Result/\` 폴더에 생성/업데이트합니다 (플랫 구조).
 - 작업 시작 시 계획 생성
 - 진행하면서 단계별 결과 upsert
 - planId로 기존 계획 찾아서 업데이트
@@ -766,7 +793,7 @@ AI: (결정이 내려졌으므로 docuking_talk 호출)
     })
 \`\`\`
 
-**저장 위치:** \`z_DocuKing/z_Talk/YYYY/MM/YYYY-MM-DD_HHMM__제목.md\`
+**저장 위치:** \`z_DocuKing/z_Talk/YYYY-MM-DD_HHMM__제목.md\` (플랫 구조)
 
 ### 작업 계획 관리 (docuking_plan, docuking_done)
 
@@ -817,7 +844,7 @@ AI: docuking_done({
     })
 \`\`\`
 
-**저장 위치:** \`z_DocuKing/z_Plan_Result/YYYY/MM/YYYY-MM-DD_HHMM__제목__planId.md\`
+**저장 위치:** \`z_DocuKing/zz_Plan_Result/YYYY-MM-DD_HHMM__제목__planId.md\` (플랫 구조)
 
 **핵심 가치:**
 - AI 세션이 끊겨도 (컴팩션, 세션 종료) 다음 AI가 계획 문서를 보고 이어서 작업 가능
@@ -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,21 +2064,171 @@ 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;
 
-  // z_Talk 폴더 경로 (z_DocuKing 아래)
+  // z_Talk 폴더 경로 (z_DocuKing 아래) - 플랫 구조
   const talkBasePath = path.join(localPath, 'z_DocuKing', 'z_Talk');
 
   // 날짜 기반 파일명 생성
-  const { fileName, yearMonth, timestamp } = generateDateFileName(title);
-  const talkFolderPath = path.join(talkBasePath, yearMonth);
-  const talkFilePath = path.join(talkFolderPath, fileName);
+  const { fileName, timestamp } = generateDateFileName(title);
+  const talkFilePath = path.join(talkBasePath, fileName);
 
   // 폴더 생성
-  if (!fs.existsSync(talkFolderPath)) {
-    fs.mkdirSync(talkFolderPath, { recursive: true });
+  if (!fs.existsSync(talkBasePath)) {
+    fs.mkdirSync(talkBasePath, { recursive: true });
   }
 
   // 태그 문자열
@@ -2093,8 +2272,8 @@ ${content}
 async function handlePlan(args) {
   const { localPath, planId, title, goal, steps = [], notes } = args;
 
-  // z_Plan_Result 폴더 경로 (z_DocuKing 아래)
-  const planBasePath = path.join(localPath, 'z_DocuKing', 'z_Plan_Result');
+  // zz_Plan_Result 폴더 경로 (z_DocuKing 아래) - 플랫 구조
+  const planBasePath = path.join(localPath, 'z_DocuKing', 'zz_Plan_Result');
 
   // 기존 계획 업데이트 또는 새 계획 생성
   let targetPlanId = planId;
@@ -2120,16 +2299,15 @@ async function handlePlan(args) {
   } else {
     // 새 계획 생성
     targetPlanId = generatePlanId();
-    const { fileName, yearMonth, timestamp } = generateDateFileName(title);
-    const planFolderPath = path.join(planBasePath, yearMonth);
+    const { fileName, timestamp } = generateDateFileName(title);
 
-    if (!fs.existsSync(planFolderPath)) {
-      fs.mkdirSync(planFolderPath, { recursive: true });
+    if (!fs.existsSync(planBasePath)) {
+      fs.mkdirSync(planBasePath, { recursive: true });
     }
 
     // 파일명에 planId 포함
     const fileNameWithId = fileName.replace('.md', `__${targetPlanId}.md`);
-    planFilePath = path.join(planFolderPath, fileNameWithId);
+    planFilePath = path.join(planBasePath, fileNameWithId);
   }
 
   // 현재 시간
@@ -2244,8 +2422,8 @@ function findPlanFiles(basePath, planId) {
 async function handleDone(args) {
   const { localPath, planId, summary, artifacts = [] } = args;
 
-  // z_Plan_Result 폴더 경로 (z_DocuKing 아래)
-  const planBasePath = path.join(localPath, 'z_DocuKing', 'z_Plan_Result');
+  // zz_Plan_Result 폴더 경로 (z_DocuKing 아래) - 플랫 구조
+  const planBasePath = path.join(localPath, 'z_DocuKing', 'zz_Plan_Result');
 
   // 계획 파일 찾기
   const planFiles = findPlanFiles(planBasePath, planId);

package/package.json

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