docuking-mcp 2.1.3 → 2.2.1

package/index.js

@@ -40,6 +40,29 @@ import crypto from 'crypto';
 // 환경변수에서 API 엔드포인트 설정 (키는 로컬 config에서 읽음)
 const API_ENDPOINT = process.env.DOCUKING_API_ENDPOINT || 'https://docuking.ai/api';
 
+/**
+ * API 키에서 협업자 폴더명 추출
+ * API 키 형식: sk_프로젝트8자_cw_폴더명_랜덤48자(hex)
+ * hex는 0-9, a-f만 포함하므로 언더스코어 없음
+ * 따라서 _cw_ 이후 마지막 _ 전까지가 폴더명
+ */
+function parseCoworkerFromApiKey(apiKey) {
+  if (!apiKey) return { isCoworker: false, coworkerFolder: null };
+
+  const cwIndex = apiKey.indexOf('_cw_');
+  if (cwIndex === -1) return { isCoworker: false, coworkerFolder: null };
+
+  const afterCw = apiKey.substring(cwIndex + 4);
+  const lastUnderscore = afterCw.lastIndexOf('_');
+  if (lastUnderscore === -1) return { isCoworker: false, coworkerFolder: null };
+
+  const folderName = afterCw.substring(0, lastUnderscore);
+  return {
+    isCoworker: !!folderName,
+    coworkerFolder: folderName || null,
+  };
+}
+
 // 파일 크기 제한 (150MB) - Base64 인코딩 시 약 200MB, 서버 제한 200MB와 일치
 const MAX_FILE_SIZE_MB = 150;
 const MAX_FILE_SIZE_BYTES = MAX_FILE_SIZE_MB * 1024 * 1024;
@@ -105,13 +128,11 @@ function getAiBasePath(localPath) {
   }
 
   const apiKey = config.apiKey;
-  // 협업자 키 형식: sk_xxx_cw_폴더명_
-  const coworkerMatch = apiKey.match(/_cw_([^_]+)_$/);
+  const { isCoworker, coworkerFolder } = parseCoworkerFromApiKey(apiKey);
 
-  if (coworkerMatch) {
-    const folderName = coworkerMatch[1];
-    const coworkerFolderPath = path.join(localPath, `yy_Coworker_${folderName}`);
-    return { isCoworker: true, basePath: coworkerFolderPath, coworkerFolder: folderName };
+  if (isCoworker && coworkerFolder) {
+    const coworkerFolderPath = path.join(localPath, `yy_Coworker_${coworkerFolder}`);
+    return { isCoworker: true, basePath: coworkerFolderPath, coworkerFolder };
   }
 
   return { isCoworker: false, basePath: localPath, coworkerFolder: null };
@@ -121,68 +142,91 @@ function getAiBasePath(localPath) {
  * CLAUDE.md에 DocuKing MCP 작업 기록 규칙 추가
  * - 파일이 없으면 새로 생성
  * - 파일이 있으면 DocuKing 섹션이 없을 때만 추가
+ * - Talk → Todo → Plan → Done 흐름 포함
  */
 function updateClaudeMd(localPath) {
   const claudeMdPath = path.join(localPath, 'CLAUDE.md');
-  const marker = '## DocuKing AI 작업 기록 (필수)';
+  const marker = '## DocuKing 연결됨';
+  const oldMarker = '## DocuKing AI 작업 기록 (필수)';
 
   const docukingSection = `
 ---
 
 ${marker}
 
-**모든 작업은 MCP 도구로 기록한다. 예외 없음.**
-
-### 작업 시작 시 → \`docuking_plan\`
-\`\`\`
-docuking_plan({
-  localPath: "${localPath.replace(/\\/g, '\\\\')}",
-  title: "작업 제목",
-  goal: "작업 목표",
-  steps: [
-    { name: "단계1", status: "pending" },
-    { name: "단계2", status: "pending" }
-  ]
-})
-\`\`\`
-
-### 단계 완료 시 → \`docuking_plan\` (업데이트)
-\`\`\`
-docuking_plan({
-  localPath: "${localPath.replace(/\\/g, '\\\\')}",
-  planId: "기존 planId",
-  title: "작업 제목",
-  steps: [
-    { name: "단계1", status: "done", result: "결과 요약" },
-    { name: "단계2", status: "in_progress" }
-  ]
-})
-\`\`\`
-
-### 작업 완료 시 → \`docuking_done\`
-\`\`\`
-docuking_done({
-  localPath: "${localPath.replace(/\\/g, '\\\\')}",
-  planId: "planId",
-  summary: "작업 완료 요약",
-  artifacts: ["변경된/파일/경로.ts"]
-})
-\`\`\`
-
-### 절대 규칙
-- **작업 시작 전 반드시 \`docuking_plan\` 호출**
-- **작업 완료 후 반드시 \`docuking_done\` 호출**
-- 결과는 \`zz_ai_3_Plan/\`에 자동 저장됨 (로컬 전용)
+### MCP 도구
+| 도구 | 용도 |
+|------|------|
+| docuking_push | 문서 업로드 ("올려줘") |
+| docuking_pull | 문서 다운로드 ("가져와") |
+| docuking_list | 서버 파일 목록 조회 |
+| docuking_status | 동기화 상태 확인 |
+| docuking_log | 커밋 히스토리 조회 |
+| docuking_diff | 버전 간 차이 비교 |
+| docuking_rollback | 특정 커밋으로 되돌림 |
+| docuking_plan | 작업 시작 시 계획 기록 |
+| docuking_done | 작업 완료 시 결과 기록 |
+| docuking_todo | 킹투두 (프로젝트 할일) |
+| docuking_talk | 대화록 저장 |
+
+### 작업 흐름 (필수)
+
+**1단계: Talk 기록 (작업 원인/배경)**
+- 사용자 요청의 배경, 논의 내용을 먼저 기록
+- Plan을 세우기 전에 반드시 Talk로 "왜 이 작업을 하는지" 남김
+
+**2단계: Todo 등록 (할일 등록)**
+- 의미 있는 작업이면 킹투두에 등록
+- 나중에 추적/공유할 가치가 있는 작업
+
+**3단계: Plan 생성 → 작업 → Done 완료**
+- 기존대로 plan → 작업 → done
+
+### Talk 자동 기록 (docuking_talk)
+
+**다음 상황에서 AI가 자동으로 기록:**
+- 설계 방향 결정 (A vs B 선택, "왜 이렇게?")
+- 버그 원인 분석 및 해결책 논의
+- 아키텍처/구조 변경 논의
+- 사용자가 중요한 결정을 내릴 때
+- Plan을 세우게 된 원인/배경 논의
+
+### Todo 자동 등록 (docuking_todo)
+
+**다음 상황에서 AI가 자동으로 등록:**
+- 사용자가 "나중에 해야 할 것" 언급 시
+- 작업 중 발견한 추가 개선사항
+- "TODO", "FIXME" 성격의 발견 사항
+- 의미 있는 작업 시작 시 (추적용)
+
+### 규칙
+1. yy_All_Docu/ 폴더만 동기화 대상
+2. Push는 사용자 요청 시에만
+3. **Talk → Todo → Plan → Done** 순서 준수
+4. Plan 전에 반드시 Talk로 배경 기록
 `;
 
   try {
     if (fs.existsSync(claudeMdPath)) {
       // 파일이 있으면 DocuKing 섹션 존재 여부 확인
-      const content = fs.readFileSync(claudeMdPath, 'utf-8');
+      let content = fs.readFileSync(claudeMdPath, 'utf-8');
+
+      // 새 마커가 이미 있으면 스킵
       if (content.includes(marker)) {
-        // 이미 DocuKing 섹션이 있으면 스킵
         return;
       }
+
+      // 구버전 마커가 있으면 교체
+      if (content.includes(oldMarker)) {
+        // 구버전 섹션 찾아서 교체 (--- 부터 끝까지 또는 다음 --- 전까지)
+        const oldSectionStart = content.lastIndexOf('---\n\n' + oldMarker);
+        if (oldSectionStart !== -1) {
+          content = content.substring(0, oldSectionStart) + docukingSection;
+          fs.writeFileSync(claudeMdPath, content, 'utf-8');
+          return;
+        }
+      }
+
       // 섹션이 없으면 끝에 추가
       fs.appendFileSync(claudeMdPath, docukingSection, 'utf-8');
     } else {
@@ -1172,12 +1216,8 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
     };
   }
 
-  // Co-worker 권한은 API Key 형식에서 판단 (sk_xxx_cw_폴더명_)
-  // 폴더명이 비어있는 경우도 처리 (sk_xxx_cw__)
-  const coworkerMatch = apiKey.match(/^sk_[a-f0-9]+_cw_([^_]*)_/);
-  const isCoworker = !!coworkerMatch;
-  // 코워커 폴더명이 비어있으면 'default'로 기본값 설정
-  const coworkerFolder = coworkerMatch ? (coworkerMatch[1] || 'default') : null;
+  // Co-worker 권한은 API Key 형식에서 판단
+  const { isCoworker, coworkerFolder } = parseCoworkerFromApiKey(apiKey);
 
   // .docuking/config.json에 설정 저장
   saveLocalConfig(localPath, {
@@ -1344,12 +1384,8 @@ Git처럼 무엇을 변경했는지 명확히 작성해주세요.
   const projectId = projectInfo.projectId;
   const projectName = projectInfo.projectName;
 
-  // Co-worker 권한은 API Key 형식에서 판단 (sk_xxx_cw_폴더명_)
-  // 폴더명이 비어있는 경우도 처리 (sk_xxx_cw__)
-  const coworkerMatch = apiKey.match(/^sk_[a-f0-9]+_cw_([^_]*)_/);
-  const isCoworker = !!coworkerMatch;
-  // 코워커 폴더명이 비어있으면 'default'로 기본값 설정
-  const coworkerFolder = coworkerMatch ? (coworkerMatch[1] || 'default') : null;
+  // Co-worker 권한은 API Key 형식에서 판단
+  const { isCoworker, coworkerFolder } = parseCoworkerFromApiKey(apiKey);
   const coworkerFolderName = isCoworker ? `yy_Coworker_${coworkerFolder}` : null;
 
   // 작업 폴더 결정: 오너는 yy_All_Docu/, 협업자는 yy_Coworker_{폴더명}/ (별도 폴더)
@@ -2006,11 +2042,26 @@ async function handlePull(args) {
     }
   }
 
+  // 결과 요약
+  const successCount = results.filter(r => r.startsWith('✓')).length;
+  const failCount = results.filter(r => r.startsWith('✗')).length;
+
+  // 실패한 파일만 상세 표시, 성공은 개수만
+  const failedFiles = results.filter(r => r.startsWith('✗'));
+
+  let summary = `Pull 완료! (${successCount}개 성공`;
+  if (failCount > 0) {
+    summary += `, ${failCount}개 실패)`;
+    summary += `\n\n실패 목록:\n${failedFiles.join('\n')}`;
+  } else {
+    summary += ')';
+  }
+
   return {
     content: [
       {
         type: 'text',
-        text: `Pull 완료!\n\n${results.join('\n')}`,
+        text: summary,
       },
     ],
   };
@@ -2271,12 +2322,8 @@ async function handleStatus(args) {
   const projectId = projectInfo.projectId;
   const projectName = projectInfo.projectName;
 
-  // Co-worker 권한은 API Key 형식에서 판단 (sk_xxx_cw_폴더명_)
-  // 폴더명이 비어있는 경우도 처리 (sk_xxx_cw__)
-  const coworkerMatch = apiKey.match(/^sk_[a-f0-9]+_cw_([^_]*)_/);
-  const isCoworker = !!coworkerMatch;
-  // 코워커 폴더명이 비어있으면 'default'로 기본값 설정
-  const coworkerFolder = coworkerMatch ? (coworkerMatch[1] || 'default') : null;
+  // Co-worker 권한은 API Key 형식에서 판단
+  const { isCoworker, coworkerFolder } = parseCoworkerFromApiKey(apiKey);
   const coworkerFolderName = isCoworker ? `yy_Coworker_${coworkerFolder}` : null;
 
   // 권한 정보 구성

package/package.json

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