docuking-mcp 2.9.1 → 2.9.2

package/handlers/docs.js

@@ -406,6 +406,28 @@ ${notes || '(없음)'}
 
   const relativePath = path.relative(localPath, planFilePath).replace(/\\/g, '/');
 
+  // 새 Plan 생성 시 Talk/Todo 자동 생성 지시
+  let autoCreateHint = '';
+  if (isNew) {
+    autoCreateHint = `
+
+---
+📝 **AI 작업 흐름 (자동 체크)**
+
+아래 항목이 아직 없다면 생성하세요:
+
+1. **Talk 기록** (이 작업의 배경/논의)
+   - 이미 작성했으면 스킵
+   - 없으면: docuking_talk 호출 (왜 이 작업을 하게 됐는지)
+
+2. **킹투두 등록** (이 작업 추적용)
+   - 이미 등록했으면 스킵
+   - 없으면: docuking_todo(action: "add", todo: "[태그] ${title}")
+
+3. **작업 완료 후**
+   - docuking_done 호출 (planId: "${targetPlanId}")`;
+  }
+
   return {
     content: [
       {
@@ -418,7 +440,7 @@ ${notes || '(없음)'}
 📊 진행률: ${progress}% (${doneCount}/${totalCount})
 
 💡 이 planId를 기억해두세요. 나중에 업데이트하거나 완료 처리할 때 필요합니다.
-💡 DocuKing에 Push하면 웹에서도 확인할 수 있습니다.`,
+💡 DocuKing에 Push하면 웹에서도 확인할 수 있습니다.${autoCreateHint}`,
       },
     ],
   };
@@ -501,6 +523,26 @@ ${artifactsMarkdown}
     pushMessage = `\n\n⚠️ DocuKing 동기화 실패: ${e.message}`;
   }
 
+  // 검증 지시 메시지
+  const validateHint = artifacts.length > 0 ? `
+
+---
+🔍 **정책 검증 필요**
+
+산출물이 xx_Policy/ 정책을 준수하는지 검증하세요:
+${artifacts.slice(0, 5).map(a => `- ${a}`).join('\n')}${artifacts.length > 5 ? `\n... 외 ${artifacts.length - 5}개` : ''}
+
+**검증 방법:**
+1. Task 도구로 서브에이전트 실행:
+   - prompt: "위 파일들이 xx_Policy/ 정책을 준수하는지 확인. 위반 시 수정하거나 docuking_urgent로 보고"
+   - subagent_type: "Explore"
+
+2. 또는 직접 xx_Policy/ 읽고 비교
+
+위반 발견 시:
+- 수정 가능하면 → 직접 수정
+- 정책 불명확하면 → docuking_urgent 호출` : '';
+
   return {
     content: [
       {
@@ -512,7 +554,7 @@ ${artifactsMarkdown}
 🕐 완료 시간: ${timestamp}
 
 📝 요약: ${summary}
-${artifacts.length > 0 ? `📦 산출물: ${artifacts.length}개` : ''}${pushMessage}`,
+${artifacts.length > 0 ? `📦 산출물: ${artifacts.length}개` : ''}${pushMessage}${validateHint}`,
       },
     ],
   };

package/handlers/sync.js

@@ -234,31 +234,6 @@ Git처럼 무엇을 변경했는지 명확히 작성해주세요.
   const projectId = projectInfo.projectId;
   const projectName = projectInfo.projectName;
 
-  // ========================================
-  // 1단계: Pull 먼저 실행 (git pull && git push 패턴)
-  // ========================================
-  let pullResultText = '';
-  try {
-    const pullResult = await handlePullInternal({ localPath, filePath });
-    pullResultText = pullResult.text;
-  } catch (e) {
-    return {
-      content: [
-        {
-          type: 'text',
-          text: `❌ Pull 실패로 Push를 중단합니다.
-오류: ${e.message}
-
-먼저 Pull 문제를 해결한 후 다시 시도하세요.`,
-        },
-      ],
-    };
-  }
-
-  // ========================================
-  // 2단계: Push 진행
-  // ========================================
-
   // Co-worker 권한은 API Key 형식에서 판단
   const { isCoworker, coworkerFolder } = parseCoworkerFromApiKey(apiKey);
   const coworkerFolderName = isCoworker ? `yy_Coworker_${coworkerFolder}` : null;
@@ -498,6 +473,35 @@ docuking_init을 먼저 실행하세요.`,
     }
   }
 
+  // ========================================
+  // 로컬 파일 경로 목록 저장 (Pull 전에!)
+  // soft-delete에서 "로컬에 없는 파일" 판단에 사용
+  // Pull이 파일을 내려받아도 이 목록은 변하지 않음
+  // ========================================
+  const localPathsBeforePull = new Set(filesToPush.map(f => f.serverPath));
+  console.error(`[DocuKing] Pull 전 로컬 파일 ${localPathsBeforePull.size}개 기록됨`);
+
+  // ========================================
+  // Pull 실행 (git pull && git push 패턴)
+  // ========================================
+  let pullResultText = '';
+  try {
+    const pullResult = await handlePullInternal({ localPath, filePath });
+    pullResultText = pullResult.text;
+  } catch (e) {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `❌ Pull 실패로 Push를 중단합니다.
+오류: ${e.message}
+
+먼저 Pull 문제를 해결한 후 다시 시도하세요.`,
+        },
+      ],
+    };
+  }
+
   if (filesToPush.length === 0 && emptyFolders.length === 0) {
     return {
       content: [
@@ -734,16 +738,21 @@ docuking_init을 먼저 실행하세요.`,
   // 단, 협업자 폴더(yy_Coworker_*)는 삭제하지 않음 (오너가 협업자 파일을 삭제하면 안됨)
   // 기존 hard delete(delete-batch) → soft delete(soft-delete)로 변경
   // 3일 후 크론잡에서 hard delete 수행
+  // 중요: localPathsBeforePull 사용 (Pull 전에 수집한 목록)
+  //       processedLocalPaths는 Pull로 내려받은 파일도 포함하므로 사용 금지
   let deleted = 0;
   const deletedFilePaths = [];
   let protectedFiles = []; // source: 'web' 파일 (보호됨)
   if (serverAllPaths.length > 0 && !isCoworker) {
     // 코워커가 아닌 경우에만 삭제 수행 (오너 전용)
     // yy_Coworker_*로 시작하는 경로는 삭제 대상에서 제외
+    // localPathsBeforePull: Pull 전에 수집한 로컬 파일 목록 (좀비 파일 방지)
     const pathsToDelete = serverAllPaths.filter(p =>
-      !processedLocalPaths.has(p) && !p.startsWith('yy_Coworker_')
+      !localPathsBeforePull.has(p) && !p.startsWith('yy_Coworker_')
     );
 
+    console.error(`[DocuKing] soft-delete 대상: ${pathsToDelete.length}개 (서버에만 있고 Pull 전 로컬에 없던 파일)`);
+
     if (pathsToDelete.length > 0) {
       try {
         // soft-delete API 호출 (deleted_at 설정, 3일 후 hard delete)
@@ -943,6 +952,65 @@ export async function handlePullInternal(args) {
 
   const projectId = projectInfo.projectId;
 
+  // Co-worker 권한은 API Key 형식에서 판단
+  const { isCoworker, coworkerFolder } = parseCoworkerFromApiKey(apiKey);
+
+  // ========================================
+  // 필수 폴더 체크 & 생성 (init 이후 추가된 폴더들)
+  // ========================================
+  const createdFolders = [];
+
+  // 공통 필수 폴더
+  const commonFolders = ['xx_Urgent'];
+
+  // 오너 전용 폴더
+  const ownerFolders = ['xx_Infra_Config', 'xx_Policy', 'zz_ai_1_Talk', 'zz_ai_2_Todo', 'zz_ai_3_Plan'];
+
+  // 협업자 전용 폴더 (yy_Coworker_{폴더명}/ 안에)
+  const coworkerSubFolders = ['zz_ai_1_Talk', 'zz_ai_2_Todo', 'zz_ai_3_Plan', '_Private'];
+
+  // 공통 폴더 체크
+  for (const folder of commonFolders) {
+    const folderPath = path.join(localPath, folder);
+    if (!fs.existsSync(folderPath)) {
+      fs.mkdirSync(folderPath, { recursive: true });
+      createdFolders.push(folder);
+      console.error(`[DocuKing] 누락 폴더 생성: ${folder}/`);
+    }
+  }
+
+  if (isCoworker) {
+    // 협업자: yy_Coworker_{폴더명}/ 안에 하위 폴더 체크
+    const coworkerFolderName = `yy_Coworker_${coworkerFolder}`;
+    const coworkerBasePath = path.join(localPath, coworkerFolderName);
+
+    // 협업자 루트 폴더
+    if (!fs.existsSync(coworkerBasePath)) {
+      fs.mkdirSync(coworkerBasePath, { recursive: true });
+      createdFolders.push(coworkerFolderName);
+    }
+
+    // 협업자 하위 폴더
+    for (const subFolder of coworkerSubFolders) {
+      const subFolderPath = path.join(coworkerBasePath, subFolder);
+      if (!fs.existsSync(subFolderPath)) {
+        fs.mkdirSync(subFolderPath, { recursive: true });
+        createdFolders.push(`${coworkerFolderName}/${subFolder}`);
+        console.error(`[DocuKing] 누락 폴더 생성: ${coworkerFolderName}/${subFolder}/`);
+      }
+    }
+  } else {
+    // 오너: 루트에 폴더 체크
+    for (const folder of ownerFolders) {
+      const folderPath = path.join(localPath, folder);
+      if (!fs.existsSync(folderPath)) {
+        fs.mkdirSync(folderPath, { recursive: true });
+        createdFolders.push(folder);
+        console.error(`[DocuKing] 누락 폴더 생성: ${folder}/`);
+      }
+    }
+  }
+
   // yy_All_Docu 폴더 (없으면 생성)
   const mainFolderName = 'yy_All_Docu';
   const mainFolderPath = path.join(localPath, mainFolderName);
@@ -1127,6 +1195,14 @@ export async function handlePullInternal(args) {
    - 스킵 (변경 없음): ${skipped}개
    - 실패: ${failed}개`;
 
+  // 누락 폴더 생성 알림
+  if (createdFolders.length > 0) {
+    resultText += `\n\n📁 누락 폴더 생성됨 (${createdFolders.length}개):`;
+    createdFolders.forEach(f => {
+      resultText += `\n   + ${f}/`;
+    });
+  }
+
   // 다운로드된 파일 목록
   const downloadedFiles = results.filter(r => r.type === 'download');
   if (downloadedFiles.length > 0) {
@@ -1274,7 +1350,6 @@ export async function handlePullInternal(args) {
   // 킹어전트 감지 (xx_Urgent/ 폴더의 긴급 보고 확인)
   // 오너에게만 알림 (협업자는 자기가 작성한 거니까)
   // ========================================
-  const { isCoworker } = parseCoworkerFromApiKey(apiKey);
   if (!isCoworker) {
     const urgentFolderPath = path.join(localPath, 'xx_Urgent');
     if (fs.existsSync(urgentFolderPath)) {
@@ -1566,3 +1641,176 @@ export async function handleStatus(args) {
     ],
   };
 }
+
+/**
+ * docuking_delete 구현 - 서버 파일 삭제
+ */
+export async function handleDelete(args) {
+  const localPath = args.localPath || process.cwd();
+  const { paths, force = false } = args;
+
+  if (!paths || paths.length === 0) {
+    return {
+      content: [{
+        type: 'text',
+        text: '오류: 삭제할 파일 경로(paths)가 필요합니다.',
+      }],
+    };
+  }
+
+  // 로컬 config에서 API 키 읽기
+  const apiKey = getApiKey(localPath);
+  if (!apiKey) {
+    return {
+      content: [{
+        type: 'text',
+        text: '오류: API 키를 찾을 수 없습니다. 먼저 docuking_init을 실행하세요.',
+      }],
+    };
+  }
+
+  // 프로젝트 정보 조회
+  const projectInfo = getProjectInfo(localPath);
+  if (projectInfo.error) {
+    return {
+      content: [{
+        type: 'text',
+        text: projectInfo.error,
+      }],
+    };
+  }
+
+  const projectId = projectInfo.projectId;
+
+  // Co-worker 권한 체크
+  const { isCoworker, coworkerFolder } = parseCoworkerFromApiKey(apiKey);
+
+  // 협업자는 자기 폴더만 삭제 가능
+  if (isCoworker) {
+    const coworkerPrefix = `yy_Coworker_${coworkerFolder}/`;
+    const invalidPaths = paths.filter(p => !p.startsWith(coworkerPrefix) && !p.startsWith('xx_Urgent/'));
+    if (invalidPaths.length > 0) {
+      return {
+        content: [{
+          type: 'text',
+          text: `오류: 협업자는 자기 폴더(${coworkerPrefix})와 xx_Urgent/만 삭제할 수 있습니다.
+삭제 불가: ${invalidPaths.join(', ')}`,
+        }],
+      };
+    }
+  }
+
+  // 오너도 협업자 폴더는 삭제 금지
+  if (!isCoworker) {
+    const coworkerPaths = paths.filter(p => p.startsWith('yy_Coworker_'));
+    if (coworkerPaths.length > 0 && !force) {
+      return {
+        content: [{
+          type: 'text',
+          text: `오류: 협업자 폴더는 삭제할 수 없습니다.
+대상: ${coworkerPaths.join(', ')}
+
+정말 삭제하려면 force: true 옵션을 사용하세요. (권장하지 않음)`,
+        }],
+      };
+    }
+  }
+
+  // soft-delete API 호출
+  try {
+    const deleteResponse = await fetch(`${API_ENDPOINT}/files/soft-delete`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${apiKey}`,
+      },
+      body: JSON.stringify({
+        projectId,
+        paths,
+        source: 'mcp-delete', // 명시적 삭제 요청 표시
+      }),
+    });
+
+    if (!deleteResponse.ok) {
+      const error = await deleteResponse.text();
+      return {
+        content: [{
+          type: 'text',
+          text: `오류: 삭제 실패 - ${error}`,
+        }],
+      };
+    }
+
+    const result = await deleteResponse.json();
+    const deleted = result.deleted || 0;
+    const deletedPaths = result.deletedPaths || [];
+    const protectedFiles = result.protected || [];
+
+    let resultText = `✓ 삭제 완료!
+
+📊 처리 결과:
+   - 삭제됨: ${deleted}개 (3일 후 영구 삭제)
+   - 보호됨: ${protectedFiles.length}개`;
+
+    if (deletedPaths.length > 0) {
+      resultText += `\n\n🗑️ 삭제된 파일:`;
+      deletedPaths.slice(0, 20).forEach(p => {
+        resultText += `\n   ✗ ${p}`;
+      });
+      if (deletedPaths.length > 20) {
+        resultText += `\n   ... 외 ${deletedPaths.length - 20}개`;
+      }
+    }
+
+    if (protectedFiles.length > 0) {
+      resultText += `\n\n🛡️ 보호된 파일 (웹에서 생성됨):`;
+      protectedFiles.slice(0, 10).forEach(p => {
+        resultText += `\n   🔒 ${p}`;
+      });
+    }
+
+    resultText += `\n\n💡 삭제된 파일은 3일 후 영구 삭제됩니다.
+💡 복구가 필요하면 3일 이내에 docuking_rollback을 사용하세요.`;
+
+    // 로컬 파일도 삭제
+    let localDeleted = 0;
+    for (const serverPath of deletedPaths) {
+      try {
+        let localFilePath;
+        if (serverPath.startsWith('xx_') ||
+            serverPath.startsWith('yy_All_Docu/') ||
+            serverPath.startsWith('yy_Coworker_') ||
+            serverPath.startsWith('zz_ai_')) {
+          localFilePath = path.join(localPath, serverPath);
+        } else {
+          localFilePath = path.join(localPath, 'yy_All_Docu', serverPath);
+        }
+
+        if (fs.existsSync(localFilePath)) {
+          fs.unlinkSync(localFilePath);
+          localDeleted++;
+        }
+      } catch (e) {
+        console.error(`[DocuKing] 로컬 파일 삭제 실패: ${serverPath} - ${e.message}`);
+      }
+    }
+
+    if (localDeleted > 0) {
+      resultText += `\n\n📁 로컬 파일도 ${localDeleted}개 삭제됨`;
+    }
+
+    return {
+      content: [{
+        type: 'text',
+        text: resultText,
+      }],
+    };
+  } catch (e) {
+    return {
+      content: [{
+        type: 'text',
+        text: `오류: ${e.message}`,
+      }],
+    };
+  }
+}

package/index.js

@@ -43,6 +43,7 @@ import {
   handlePull,
   handleList,
   handleStatus,
+  handleDelete,
 } from './handlers/sync.js';
 
 import {
@@ -192,7 +193,11 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
       },
       {
         name: 'docuking_pull',
-        description: '서버에서 문서를 다운로드합니다. "DocuKing에서 가져와" 요청 시 사용.\n\n**킹캐스트**: Pull 후 xx_Policy/, xx_Infra_Config/ 폴더 변경이 감지되면 자동으로 .claude/rules/local/에 로컬화됩니다.',
+        description: `서버에서 문서를 다운로드합니다. "DocuKing에서 가져와" 요청 시 사용.
+
+**킹캐스트 포함**: Pull 후 xx_Policy/, xx_Infra_Config/ 폴더 변경이 감지되면 자동으로 .claude/rules/local/에 로컬화됩니다. 오너가 정책을 수정하고 Push하면, 협업자가 Pull할 때 자동으로 정책이 전파됩니다.
+
+**긴급 보고 알림**: Pull 후 xx_Urgent/ 폴더에 파일이 있으면 "긴급 보고 N건 있습니다" 알림을 표시합니다.`,
         inputSchema: {
           type: 'object',
           properties: {
@@ -509,6 +514,35 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
           required: ['localPath', 'title', 'situation'],
         },
       },
+      {
+        name: 'docuking_delete',
+        description: `서버에서 파일/폴더를 직접 삭제합니다.
+
+**사용 시점:**
+- 로컬에서 삭제한 파일이 Push 후에도 서버에 남아있을 때
+- 서버에만 존재하는 불필요한 파일을 정리할 때
+- "서버에서 삭제해줘", "킹폴더에서 지워줘" 요청 시
+
+**권한:**
+- 오너: xx_*/, yy_All_Docu/, zz_ai_*/ 삭제 가능
+- 협업자: yy_Coworker_{본인}/ 내부만 삭제 가능
+
+**주의:** 삭제는 soft-delete로 처리되며, 3일 후 완전 삭제됩니다.`,
+        inputSchema: {
+          type: 'object',
+          properties: {
+            localPath: {
+              type: 'string',
+              description: '로컬 프로젝트 경로 (설정 파일에서 projectId 찾음)',
+            },
+            path: {
+              type: 'string',
+              description: '삭제할 파일/폴더 경로 (서버 기준). 예: "yy_All_Docu/old_file.md"',
+            },
+          },
+          required: ['localPath', 'path'],
+        },
+      },
       {
         name: 'docuking_validate',
         description: `코드가 정책을 준수하는지 검증합니다 (킹밸리데이트).
@@ -803,6 +837,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return await handleTodo(args);
       case 'docuking_urgent':
         return await handleUrgent(args);
+      case 'docuking_delete':
+        return await handleDelete(args);
       case 'docuking_validate':
         return await handleValidate(args);
       default:

package/package.json

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