docuking-mcp 2.8.1 → 2.9.1

package/handlers/docs.js

@@ -1,12 +1,12 @@
 /**
  * DocuKing MCP - 문서 핸들러 모듈
- * todo, talk, plan, done
+ * todo, talk, plan, done, urgent
  */
 
 import fs from 'fs';
 import path from 'path';
 
-import { getAiBasePath } from '../lib/config.js';
+import { getAiBasePath, parseCoworkerFromApiKey, getApiKey } from '../lib/config.js';
 import { generateDateFileName, generatePlanId, findPlanFiles } from '../lib/utils.js';
 import { handlePush } from './sync.js';
 
@@ -517,3 +517,104 @@ ${artifacts.length > 0 ? `📦 산출물: ${artifacts.length}개` : ''}${pushMes
     ],
   };
 }
+
+/**
+ * docuking_urgent 구현 - 긴급 보고 (킹어전트)
+ * 협업자가 예외 상황 발견 시 xx_Urgent/에 보고
+ */
+export async function handleUrgent(args) {
+  const localPath = args.localPath || process.cwd();
+  const { title, situation, policyGap, suggestion, priority = 'medium' } = args;
+
+  if (!title || !situation) {
+    return {
+      content: [{
+        type: 'text',
+        text: '오류: title과 situation 파라미터가 필요합니다.',
+      }],
+    };
+  }
+
+  // 보고자 정보 (협업자면 폴더명, 오너면 'Owner')
+  const apiKey = getApiKey(localPath);
+  let reporter = 'Owner';
+  if (apiKey) {
+    const { isCoworker, coworkerFolder } = parseCoworkerFromApiKey(apiKey);
+    if (isCoworker && coworkerFolder) {
+      reporter = coworkerFolder;
+    }
+  }
+
+  // xx_Urgent 폴더 경로
+  const urgentBasePath = path.join(localPath, 'xx_Urgent');
+
+  // 폴더 생성
+  if (!fs.existsSync(urgentBasePath)) {
+    fs.mkdirSync(urgentBasePath, { recursive: true });
+  }
+
+  // 날짜 기반 파일명 생성
+  const { fileName, timestamp } = generateDateFileName(`${reporter}_${title}`, 'U');
+  const urgentFilePath = path.join(urgentBasePath, fileName);
+
+  // 우선순위 아이콘
+  const priorityIcons = {
+    high: '🔴',
+    medium: '🟡',
+    low: '🟢',
+  };
+  const priorityIcon = priorityIcons[priority] || '🟡';
+  const priorityText = priority === 'high' ? '긴급 (작업 중단 필요)'
+    : priority === 'medium' ? '중간 (임시 처리 후 진행)'
+    : '낮음 (참고용)';
+
+  // 마크다운 문서 생성
+  const document = `# ${priorityIcon} ${title}
+
+> 보고자: ${reporter}
+> 보고 시간: ${timestamp}
+> 우선순위: ${priorityText}
+
+---
+
+## 발생 상황
+${situation}
+
+${policyGap ? `## 정책 공백
+${policyGap}
+
+` : ''}${suggestion ? `## 제안 사항
+${suggestion}
+
+` : ''}---
+
+## 오너 처리 (아래 작성)
+
+
+
+---
+*이 문서는 협업자 AI가 자동 생성한 긴급 보고입니다.*
+*처리 완료 후 오너가 이 파일을 삭제하면 됩니다.*
+`;
+
+  // 파일 저장
+  fs.writeFileSync(urgentFilePath, document, 'utf-8');
+
+  const relativePath = path.relative(localPath, urgentFilePath).replace(/\\/g, '/');
+
+  return {
+    content: [{
+      type: 'text',
+      text: `${priorityIcon} 긴급 보고 작성 완료!
+
+📋 제목: ${title}
+👤 보고자: ${reporter}
+📁 경로: ${relativePath}
+🕐 시간: ${timestamp}
+⚡ 우선순위: ${priorityText}
+
+💡 Push하면 오너가 Pull 시 자동으로 알림을 받습니다.
+💡 오너가 정책을 업데이트하고 해당 파일을 삭제하면 처리 완료입니다.`,
+    }],
+  };
+}

package/handlers/kingcast.js

@@ -329,8 +329,8 @@ git checkout -b coworker/${coworkerFolder}
   // 인프라 설정 파일 안내 (복사하지 않으므로 원본 경로 표시)
   if (infraConfigFiles.length > 0) {
     indexContent += '\n## 인프라 설정 (xx_Infra_Config/)\n';
-    indexContent += '> 아래 파일들은 복사되지 않습니다. 원본 경로에서 직접 읽으세요.\n';
-    indexContent += '> 변경 감지 시 AI가 내용을 읽고 로컬 환경에 맞게 적용해야 합니다.\n\n';
+    indexContent += '> 아래 파일들은 복사되지 않음. 원본 경로에서 직접 읽을 것.\n';
+    indexContent += '> 변경 감지 시 내용을 읽고 로컬 환경에 맞게 적용 필요.\n\n';
     for (const file of infraConfigFiles) {
       const relativePath = file.key.replace('xx_Infra_Config/', '');
       indexContent += `- xx_Infra_Config/${relativePath}\n`;
@@ -479,12 +479,12 @@ export async function executeKingcast(localPath) {
     ...changes.modified.filter(k => k.startsWith('xx_Infra_Config/')),
   ];
   if (infraChanges.length > 0) {
-    message += `\n\n🔧 인프라 설정 변경 감지 (${infraChanges.length}개):`;
+    message += `\n\n🔧 인프라 설정 변경 (${infraChanges.length}개):`;
     for (const file of infraChanges) {
       message += `\n   - ${file}`;
     }
-    message += `\n\n   👉 AI는 위 파일들을 읽고 로컬 환경에 맞게 적용하세요.`;
-    message += `\n   👉 예: .env 변수 추가/변경, 배포 설정 확인 등`;
+    message += `\n\n   → 위 파일을 읽고 로컬 환경에 맞게 적용 필요`;
+    message += `\n   → 예: .env 변수 추가/변경, 배포 설정 확인`;
   }
 
   // 정책 변경 시 경고 메시지 추가

package/handlers/sync.js

@@ -91,6 +91,12 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
   // xx_ 시스템 폴더 목록 (오너 전용)
   const systemFolders = ['xx_Infra_Config', 'xx_Policy'];
 
+  // xx_Urgent/ 폴더는 오너/협업자 모두 생성 (공용 긴급 보고 폴더)
+  const urgentFolderPath = path.join(localPath, 'xx_Urgent');
+  if (!fs.existsSync(urgentFolderPath)) {
+    fs.mkdirSync(urgentFolderPath, { recursive: true });
+  }
+
   if (isCoworker) {
     // 협업자: yy_Coworker_{폴더명}/ 폴더를 yy_All_Docu/ 밖에 별도 생성
     coworkerFolderName = `yy_Coworker_${coworkerFolder}`;
@@ -269,7 +275,7 @@ Git처럼 무엇을 변경했는지 명확히 작성해주세요.
   console.error(`[DocuKing] Push 권한: isCoworker=${isCoworker}, coworkerFolder=${coworkerFolder}, coworkerFolderName=${coworkerFolderName}`);
 
   if (isCoworker) {
-    // 협업자: yy_Coworker_{폴더명}/ 폴더만 Push
+    // 협업자: yy_Coworker_{폴더명}/ 폴더 + xx_Urgent/ 폴더 Push
     const coworkerPath = path.join(localPath, coworkerFolderName);
     console.error(`[DocuKing] 협업자 Push 대상 폴더: ${coworkerPath}`);
     if (!fs.existsSync(coworkerPath)) {
@@ -277,6 +283,13 @@ Git처럼 무엇을 변경했는지 명확히 작성해주세요.
     }
     pushTargetFolders.push({ localPath: coworkerPath, serverPrefix: coworkerFolderName });
 
+    // xx_Urgent/ 폴더도 Push 대상에 추가 (협업자도 긴급 보고 가능)
+    const urgentPath = path.join(localPath, 'xx_Urgent');
+    if (fs.existsSync(urgentPath)) {
+      pushTargetFolders.push({ localPath: urgentPath, serverPrefix: 'xx_Urgent' });
+      console.error(`[DocuKing] 협업자 xx_Urgent/ 폴더도 Push 대상에 포함`);
+    }
+
     // 협업자 폴더 내용 디버그 출력
     try {
       const entries = fs.readdirSync(coworkerPath, { withFileTypes: true });
@@ -1257,6 +1270,54 @@ export async function handlePullInternal(args) {
     console.error('[DocuKing] 킹캐스트 실행 실패:', e.message);
   }
 
+  // ========================================
+  // 킹어전트 감지 (xx_Urgent/ 폴더의 긴급 보고 확인)
+  // 오너에게만 알림 (협업자는 자기가 작성한 거니까)
+  // ========================================
+  const { isCoworker } = parseCoworkerFromApiKey(apiKey);
+  if (!isCoworker) {
+    const urgentFolderPath = path.join(localPath, 'xx_Urgent');
+    if (fs.existsSync(urgentFolderPath)) {
+      try {
+        const urgentFiles = fs.readdirSync(urgentFolderPath)
+          .filter(f => f.endsWith('.md') && !f.startsWith('.'));
+
+        if (urgentFiles.length > 0) {
+          resultText += `\n\n🚨 **긴급 보고 ${urgentFiles.length}건 있습니다!**`;
+          resultText += `\n\n협업자들이 정책 예외 상황을 보고했습니다. 확인이 필요합니다:`;
+
+          // 각 보고 파일의 제목과 우선순위 표시
+          for (const file of urgentFiles.slice(0, 5)) {
+            const filePath = path.join(urgentFolderPath, file);
+            try {
+              const content = fs.readFileSync(filePath, 'utf-8');
+              // 제목 추출 (# 으로 시작하는 첫 줄)
+              const titleMatch = content.match(/^# (.+)$/m);
+              const title = titleMatch ? titleMatch[1] : file;
+              // 보고자 추출
+              const reporterMatch = content.match(/> 보고자: (.+)$/m);
+              const reporter = reporterMatch ? reporterMatch[1] : '알 수 없음';
+
+              resultText += `\n   - ${title} (by ${reporter})`;
+            } catch (e) {
+              resultText += `\n   - ${file}`;
+            }
+          }
+
+          if (urgentFiles.length > 5) {
+            resultText += `\n   ... 외 ${urgentFiles.length - 5}건`;
+          }
+
+          resultText += `\n\n📁 경로: xx_Urgent/`;
+          resultText += `\n💡 검토 후 xx_Policy/에 정책 추가 → Push (킹캐스트로 전파)`;
+          resultText += `\n💡 처리 완료 후 해당 보고 파일 삭제 → Push`;
+        }
+      } catch (e) {
+        console.error('[DocuKing] xx_Urgent 폴더 읽기 실패:', e.message);
+      }
+    }
+  }
+
   // 내부용 객체 반환 (Push에서 사용)
   return {
     text: resultText,