docuking-mcp 2.1.2 → 2.2.0

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;
@@ -93,72 +116,117 @@ function saveLocalConfig(localPath, config) {
   fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
 }
 
+/**
+ * 협업자 여부 및 zz_ai 폴더 기본 경로 반환
+ * - 오너: localPath (루트에 zz_ai_* 폴더)
+ * - 협업자: localPath/yy_Coworker_{폴더명} (협업자 폴더 안에 zz_ai_* 폴더)
+ */
+function getAiBasePath(localPath) {
+  const config = getLocalConfig(localPath);
+  if (!config || !config.apiKey) {
+    return { isCoworker: false, basePath: localPath, coworkerFolder: null };
+  }
+
+  const apiKey = config.apiKey;
+  const { isCoworker, coworkerFolder } = parseCoworkerFromApiKey(apiKey);
+
+  if (isCoworker && coworkerFolder) {
+    const coworkerFolderPath = path.join(localPath, `yy_Coworker_${coworkerFolder}`);
+    return { isCoworker: true, basePath: coworkerFolderPath, coworkerFolder };
+  }
+
+  return { isCoworker: false, basePath: localPath, coworkerFolder: null };
+}
+
 /**
  * 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 {
@@ -1148,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, {
@@ -1174,18 +1238,12 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
     fs.mkdirSync(mainFolderPath, { recursive: true });
   }
 
-  // zz_ai_* 폴더도 함께 생성 (로컬 전용)
-  const aiFolders = ['zz_ai_1_Talk', 'zz_ai_2_Todo', 'zz_ai_3_Plan'];
-  for (const folder of aiFolders) {
-    const folderPath = path.join(localPath, folder);
-    if (!fs.existsSync(folderPath)) {
-      fs.mkdirSync(folderPath, { recursive: true });
-    }
-  }
-
   let coworkerFolderName = null;
   let coworkerFolderPath = null;
 
+  // zz_ai_* 폴더 목록
+  const aiFolders = ['zz_ai_1_Talk', 'zz_ai_2_Todo', 'zz_ai_3_Plan'];
+
   if (isCoworker) {
     // 협업자: yy_Coworker_{폴더명}/ 폴더를 yy_All_Docu/ 밖에 별도 생성
     coworkerFolderName = `yy_Coworker_${coworkerFolder}`;
@@ -1193,6 +1251,35 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
     if (!fs.existsSync(coworkerFolderPath)) {
       fs.mkdirSync(coworkerFolderPath, { recursive: true });
     }
+    // 협업자 폴더 안에 _Private/ 생성
+    const coworkerPrivatePath = path.join(coworkerFolderPath, '_Private');
+    if (!fs.existsSync(coworkerPrivatePath)) {
+      fs.mkdirSync(coworkerPrivatePath, { recursive: true });
+    }
+    // 협업자 폴더 안에 zz_ai_* 폴더 생성
+    for (const folder of aiFolders) {
+      const folderPath = path.join(coworkerFolderPath, folder);
+      if (!fs.existsSync(folderPath)) {
+        fs.mkdirSync(folderPath, { recursive: true });
+      }
+    }
+  } else {
+    // 오너: yy_All_Docu/ 안에 _Infra_Config/와 _Private/ 생성
+    const infraConfigPath = path.join(mainFolderPath, '_Infra_Config');
+    if (!fs.existsSync(infraConfigPath)) {
+      fs.mkdirSync(infraConfigPath, { recursive: true });
+    }
+    const ownerPrivatePath = path.join(mainFolderPath, '_Private');
+    if (!fs.existsSync(ownerPrivatePath)) {
+      fs.mkdirSync(ownerPrivatePath, { recursive: true });
+    }
+    // 오너: 루트에 zz_ai_* 폴더 생성
+    for (const folder of aiFolders) {
+      const folderPath = path.join(localPath, folder);
+      if (!fs.existsSync(folderPath)) {
+        fs.mkdirSync(folderPath, { recursive: true });
+      }
+    }
   }
 
   // 연결 완료 안내 (오너/코워커에 따라 다른 메시지)
@@ -1297,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_{폴더명}/ (별도 폴더)
@@ -1388,6 +1471,54 @@ docuking_init을 먼저 실행하세요.`,
         console.error(`[DocuKing] frontend/.env.local 백업 실패: ${err.message}`);
       }
     }
+
+    // package.json 파일 백업 (루트)
+    const packageJsonPath = path.join(localPath, 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+      if (!fs.existsSync(infraConfigPath)) {
+        fs.mkdirSync(infraConfigPath, { recursive: true });
+      }
+
+      const packageJsonBackupPath = path.join(infraConfigPath, 'package.json');
+      try {
+        fs.copyFileSync(packageJsonPath, packageJsonBackupPath);
+        console.error(`[DocuKing] package.json → _Infra_Config/package.json 자동 백업 완료`);
+      } catch (err) {
+        console.error(`[DocuKing] package.json 백업 실패: ${err.message}`);
+      }
+    }
+
+    // backend/package.json 파일도 백업
+    const backendPackageJsonPath = path.join(localPath, 'backend', 'package.json');
+    if (fs.existsSync(backendPackageJsonPath)) {
+      if (!fs.existsSync(infraConfigPath)) {
+        fs.mkdirSync(infraConfigPath, { recursive: true });
+      }
+
+      const backendPackageJsonBackupPath = path.join(infraConfigPath, 'backend.package.json');
+      try {
+        fs.copyFileSync(backendPackageJsonPath, backendPackageJsonBackupPath);
+        console.error(`[DocuKing] backend/package.json → _Infra_Config/backend.package.json 자동 백업 완료`);
+      } catch (err) {
+        console.error(`[DocuKing] backend/package.json 백업 실패: ${err.message}`);
+      }
+    }
+
+    // frontend/package.json 파일도 백업
+    const frontendPackageJsonPath = path.join(localPath, 'frontend', 'package.json');
+    if (fs.existsSync(frontendPackageJsonPath)) {
+      if (!fs.existsSync(infraConfigPath)) {
+        fs.mkdirSync(infraConfigPath, { recursive: true });
+      }
+
+      const frontendPackageJsonBackupPath = path.join(infraConfigPath, 'frontend.package.json');
+      try {
+        fs.copyFileSync(frontendPackageJsonPath, frontendPackageJsonBackupPath);
+        console.error(`[DocuKing] frontend/package.json → _Infra_Config/frontend.package.json 자동 백업 완료`);
+      } catch (err) {
+        console.error(`[DocuKing] frontend/package.json 백업 실패: ${err.message}`);
+      }
+    }
   }
 
   // 파일 목록 수집
@@ -2176,12 +2307,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;
 
   // 권한 정보 구성
@@ -2381,8 +2508,11 @@ function generatePlanId() {
 async function handleTodo(args) {
   const { localPath, action, todo, todoId } = args;
 
-  // zz_ai_2_Todo 폴더 경로 (로컬 전용, 킹투두)
-  const todoBasePath = path.join(localPath, 'zz_ai_2_Todo');
+  // 협업자 여부에 따라 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');
 
   // 폴더 생성
@@ -2572,8 +2702,11 @@ ${listText}
 async function handleTalk(args) {
   const { localPath, title, content, tags = [] } = args;
 
-  // zz_ai_1_Talk 폴더 경로 (로컬 전용, 킹톡)
-  const talkBasePath = path.join(localPath, 'zz_ai_1_Talk');
+  // 협업자 여부에 따라 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');
@@ -2625,8 +2758,11 @@ ${content}
 async function handlePlan(args) {
   const { localPath, planId, title, goal, steps = [], notes } = args;
 
-  // zz_ai_3_Plan 폴더 경로 (로컬 전용, 킹플랜)
-  const planBasePath = path.join(localPath, 'zz_ai_3_Plan');
+  // 협업자 여부에 따라 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;
@@ -2775,8 +2911,11 @@ function findPlanFiles(basePath, planId) {
 async function handleDone(args) {
   const { localPath, planId, summary, artifacts = [] } = args;
 
-  // zz_ai_3_Plan 폴더 경로 (로컬 전용, 킹플랜)
-  const planBasePath = path.join(localPath, 'zz_ai_3_Plan');
+  // 협업자 여부에 따라 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 = findPlanFiles(planBasePath, planId);

package/package.json

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