claude-session-continuity-mcp 1.9.3 → 1.9.4

package/dist/hooks/session-end.d.ts

@@ -3,5 +3,10 @@
  * SessionEnd Hook (Stop 이벤트) - 세션 종료 시 자동 저장
  *
  * Claude Code 세션 종료 시 자동으로 컨텍스트를 저장합니다.
+ *
+ * Stop 이벤트 입력 필드:
+ * - session_id, cwd, permission_mode, hook_event_name, stop_hook_active
+ * - transcript_path: JSONL 파일 경로 (전체 대화 기록)
+ * - last_assistant_message: 마지막 assistant 메시지 텍스트
  */
 export {};

package/dist/hooks/session-end.js

@@ -3,9 +3,15 @@
  * SessionEnd Hook (Stop 이벤트) - 세션 종료 시 자동 저장
  *
  * Claude Code 세션 종료 시 자동으로 컨텍스트를 저장합니다.
+ *
+ * Stop 이벤트 입력 필드:
+ * - session_id, cwd, permission_mode, hook_event_name, stop_hook_active
+ * - transcript_path: JSONL 파일 경로 (전체 대화 기록)
+ * - last_assistant_message: 마지막 assistant 메시지 텍스트
  */
 import * as fs from 'fs';
 import * as path from 'path';
+import * as readline from 'readline';
 import Database from 'better-sqlite3';
 function detectWorkspaceRoot(cwd) {
     let current = cwd;
@@ -30,12 +36,10 @@ function getDbPath(cwd) {
 function detectProject(cwd) {
     const workspaceRoot = detectWorkspaceRoot(cwd);
     const appsDir = path.join(workspaceRoot, 'apps');
-    // apps/ 하위인지 확인
     if (cwd.startsWith(appsDir + path.sep)) {
         const relative = path.relative(appsDir, cwd);
         return relative.split(path.sep)[0];
     }
-    // apps/ 외부 하위 프로젝트 (hackathons/ 등)
     if (cwd !== workspaceRoot) {
         let current = cwd;
         while (current !== workspaceRoot && current !== path.parse(current).root) {
@@ -52,97 +56,107 @@ function detectProject(cwd) {
             current = path.dirname(current);
         }
     }
-    // 워크스페이스 루트 (모노레포 포함) → 폴더명 반환
     return path.basename(workspaceRoot);
 }
-function extractLastWork(transcript) {
-    // 마지막 assistant 메시지들에서 의미있는 요약 추출 (역순)
-    const assistantMessages = transcript.filter(m => m.role === 'assistant');
-    for (let i = assistantMessages.length - 1; i >= Math.max(0, assistantMessages.length - 5); i--) {
-        const content = assistantMessages[i].content;
-        if (!content || content.length < 10)
-            continue;
-        // 전략 1: "✅ 작업 완료" 또는 "## Summary" 등 요약 섹션 추출
-        const summaryPatterns = [
-            /✅\s*(.+?)(?:\n\n|\n(?=[#*-]))/s,
-            /(?:##?\s*(?:Summary|변경\s*사항|작업\s*완료|결과))\s*\n([\s\S]+?)(?:\n\n|\n(?=##))/i,
-        ];
-        for (const pattern of summaryPatterns) {
-            const match = content.match(pattern);
-            if (match?.[1]) {
-                const summary = match[1].replace(/\n/g, ' ').replace(/\s+/g, ' ').trim().slice(0, 200);
-                if (summary.length > 10)
-                    return summary;
-            }
-        }
-        // 전략 2: 볼드 텍스트(**...**) 추출 — 핵심 내용이 담겨 있는 경우 많음
-        const boldMatches = content.match(/\*\*(.+?)\*\*/g);
-        if (boldMatches && boldMatches.length > 0) {
-            const cleaned = boldMatches
-                .map(b => b.replace(/\*\*/g, ''))
-                .filter(b => b.length > 5 && b.length < 100)
-                .slice(0, 3);
-            if (cleaned.length > 0)
-                return cleaned.join('; ').slice(0, 200);
-        }
-        // 전략 3: 첫 줄이 의미있는 텍스트인 경우
-        const firstLine = content.split('\n').find(line => {
-            const trimmed = line.trim();
-            return trimmed.length > 10 && !trimmed.startsWith('#') && !trimmed.startsWith('```');
-        });
-        if (firstLine) {
-            const trimmed = firstLine.trim().slice(0, 200);
-            if (trimmed.length > 10)
-                return trimmed;
+/**
+ * 단일 텍스트(last_assistant_message 등)에서 의미있는 요약 추출
+ */
+function extractSummaryFromText(content) {
+    if (!content || content.length < 10)
+        return '';
+    // 전략 1: ✅ 또는 ## Summary 등 요약 섹션
+    const summaryPatterns = [
+        /✅\s*(.+?)(?:\n\n|\n(?=[#*-]))/s,
+        /(?:##?\s*(?:Summary|변경\s*사항|작업\s*완료|결과))\s*\n([\s\S]+?)(?:\n\n|\n(?=##))/i,
+    ];
+    for (const pattern of summaryPatterns) {
+        const match = content.match(pattern);
+        if (match?.[1]) {
+            const summary = match[1].replace(/\n/g, ' ').replace(/\s+/g, ' ').trim().slice(0, 200);
+            if (summary.length > 10)
+                return summary;
         }
     }
-    return 'Session work completed';
+    // 전략 2: 볼드 텍스트(**...**) 추출
+    const boldMatches = content.match(/\*\*(.+?)\*\*/g);
+    if (boldMatches && boldMatches.length > 0) {
+        const cleaned = boldMatches
+            .map(b => b.replace(/\*\*/g, ''))
+            .filter(b => b.length > 5 && b.length < 100)
+            .slice(0, 3);
+        if (cleaned.length > 0)
+            return cleaned.join('; ').slice(0, 200);
+    }
+    // 전략 3: 첫 의미있는 줄
+    const firstLine = content.split('\n').find(line => {
+        const trimmed = line.trim();
+        return trimmed.length > 10 && !trimmed.startsWith('#') && !trimmed.startsWith('```');
+    });
+    if (firstLine) {
+        const trimmed = firstLine.trim().slice(0, 200);
+        if (trimmed.length > 10)
+            return trimmed;
+    }
+    return '';
 }
-function extractSessionSummary(transcript) {
-    const nextTasks = [];
-    const modifiedFiles = new Set();
-    // last_work: 개선된 다중 전략 추출
-    const lastWork = extractLastWork(transcript);
-    // 최근 메시지 분석
-    const recentMessages = transcript.slice(-30);
-    for (const msg of recentMessages) {
-        const content = msg.content;
-        // 파일 수정 추출 (Edit, Write 도구 결과에서) — 폴백용
-        const filePatterns = [
-            /(?:edited|modified|updated|created|wrote|수정|생성|변경)\s+[`"]?([^\s`"]+\.[a-z]+)/gi,
-            /file[:\s]+[`"]?([^\s`"]+\.[a-z]+)/gi,
-        ];
-        for (const pattern of filePatterns) {
-            let match;
-            while ((match = pattern.exec(content)) !== null) {
-                if (match[1] && !match[1].includes('...')) {
-                    modifiedFiles.add(match[1]);
+/**
+ * transcript_path (JSONL)에서 마지막 N개의 assistant 메시지 읽기
+ * 전체 파일을 메모리에 올리지 않고 스트림으로 처리
+ */
+async function readRecentAssistantMessages(transcriptPath, maxMessages = 5) {
+    if (!fs.existsSync(transcriptPath))
+        return [];
+    const messages = [];
+    try {
+        const fileStream = fs.createReadStream(transcriptPath, { encoding: 'utf-8' });
+        const rl = readline.createInterface({ input: fileStream, crlfDelay: Infinity });
+        for await (const line of rl) {
+            if (!line.trim())
+                continue;
+            try {
+                const entry = JSON.parse(line);
+                if (entry.type === 'assistant' || entry.role === 'assistant') {
+                    // JSONL 형식에 따라 content 추출
+                    const content = typeof entry.message?.content === 'string'
+                        ? entry.message.content
+                        : Array.isArray(entry.message?.content)
+                            ? entry.message.content
+                                .filter((b) => b.type === 'text')
+                                .map((b) => b.text)
+                                .join('\n')
+                            : '';
+                    if (content.length > 10) {
+                        messages.push(content);
+                    }
                 }
             }
+            catch { /* skip malformed lines */ }
         }
-        if (msg.role === 'assistant') {
-            // 다음 할 일 추출
-            const nextPatterns = [
-                /(?:next|todo|remaining|다음|남은|해야|예정)[:\s]*([^.!?\n]+)/gi,
-                /(?:should|need to|필요|권장|추천)[:\s]*([^.!?\n]+)/gi,
-            ];
-            for (const pattern of nextPatterns) {
-                let match;
-                while ((match = pattern.exec(content)) !== null) {
-                    if (match[1]) {
-                        const task = match[1].trim().slice(0, 100);
-                        if (task.length > 5)
-                            nextTasks.push(task);
-                    }
-                }
+    }
+    catch { /* file read error */ }
+    // 마지막 N개만 반환
+    return messages.slice(-maxMessages);
+}
+/**
+ * 다음 할 일 추출 (텍스트에서)
+ */
+function extractNextTasks(content) {
+    const nextTasks = [];
+    const nextPatterns = [
+        /(?:next|todo|remaining|다음|남은|해야|예정)[:\s]*([^.!?\n]+)/gi,
+        /(?:should|need to|필요|권장|추천)[:\s]*([^.!?\n]+)/gi,
+    ];
+    for (const pattern of nextPatterns) {
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+            if (match[1]) {
+                const task = match[1].trim().slice(0, 100);
+                if (task.length > 5)
+                    nextTasks.push(task);
             }
         }
     }
-    return {
-        lastWork,
-        nextTasks: [...new Set(nextTasks)].slice(0, 5),
-        modifiedFiles: [...modifiedFiles].slice(0, 10)
-    };
+    return nextTasks;
 }
 async function main() {
     try {
@@ -154,61 +168,78 @@ async function main() {
         const cwd = input.cwd || process.cwd();
         const project = detectProject(cwd);
         const dbPath = getDbPath(cwd);
-        // 디버그 로그: 실제 전달되는 데이터 구조 확인
+        // 디버그 로그
         const debugLogPath = path.join(path.dirname(dbPath), 'session-end-debug.log');
         const inputKeys = Object.keys(input);
-        const transcriptInfo = input.transcript
-            ? `${input.transcript.length} messages (assistant: ${input.transcript.filter(m => m.role === 'assistant').length})`
-            : 'NO TRANSCRIPT';
-        const debugLine = `[${new Date().toISOString()}] project=${project} keys=[${inputKeys.join(',')}] transcript=${transcriptInfo}\n`;
+        const lastMsgLen = input.last_assistant_message?.length || 0;
+        const debugLine = `[${new Date().toISOString()}] project=${project} keys=[${inputKeys.join(',')}] transcript_path=${input.transcript_path || 'none'} last_msg_len=${lastMsgLen}\n`;
         fs.appendFileSync(debugLogPath, debugLine);
         if (!fs.existsSync(dbPath)) {
             console.log('[SessionEnd] No DB found, skipping');
             process.exit(0);
         }
         const db = new Database(dbPath);
-        // transcript 유효성 검사: assistant 메시지가 2개 미만이면 의미 없는 세션
-        if (input.transcript) {
-            const assistantCount = input.transcript.filter(m => m.role === 'assistant').length;
-            if (assistantCount < 2) {
-                console.log(`[SessionEnd] Skipping empty session for ${project} (${assistantCount} assistant messages)`);
+        // === last_work 추출 ===
+        let lastWork = '';
+        let nextTasks = [];
+        // 소스 1: last_assistant_message (Stop 이벤트에서 직접 제공)
+        if (input.last_assistant_message) {
+            lastWork = extractSummaryFromText(input.last_assistant_message);
+            nextTasks = extractNextTasks(input.last_assistant_message);
+        }
+        // 소스 2: transcript_path에서 마지막 assistant 메시지들 읽기 (소스 1 실패 시)
+        if (!lastWork && input.transcript_path) {
+            const recentMessages = await readRecentAssistantMessages(input.transcript_path);
+            for (let i = recentMessages.length - 1; i >= 0; i--) {
+                lastWork = extractSummaryFromText(recentMessages[i]);
+                if (lastWork)
+                    break;
+            }
+            // next tasks도 마지막 메시지에서 추출
+            if (recentMessages.length > 0) {
+                nextTasks = extractNextTasks(recentMessages[recentMessages.length - 1]);
+            }
+        }
+        // 소스 3: 레거시 transcript 배열 (이전 버전 호환)
+        if (!lastWork && input.transcript) {
+            const assistantMsgs = input.transcript.filter(m => m.role === 'assistant');
+            if (assistantMsgs.length < 2) {
+                console.log(`[SessionEnd] Skipping empty session for ${project}`);
                 db.close();
                 process.exit(0);
             }
+            for (let i = assistantMsgs.length - 1; i >= Math.max(0, assistantMsgs.length - 5); i--) {
+                lastWork = extractSummaryFromText(assistantMsgs[i].content);
+                if (lastWork)
+                    break;
+            }
         }
-        // transcript에서 세션 요약 추출
-        const summary = input.transcript
-            ? extractSessionSummary(input.transcript)
-            : { lastWork: 'Session ended', nextTasks: [], modifiedFiles: [] };
-        // active_context에서 PostToolUse가 실시간 저장한 파일 목록 병합
-        let realtimeFiles = [];
+        // === modified_files: active_context에서 PostToolUse가 실시간 저장한 파일 목록 ===
+        let modifiedFiles = [];
         try {
             const activeCtx = db.prepare('SELECT recent_files FROM active_context WHERE project = ?').get(project);
             if (activeCtx?.recent_files) {
-                realtimeFiles = JSON.parse(activeCtx.recent_files);
-                const mergedFiles = [...new Set([...realtimeFiles, ...summary.modifiedFiles])].slice(0, 15);
-                summary.modifiedFiles = mergedFiles;
+                modifiedFiles = JSON.parse(activeCtx.recent_files);
             }
         }
         catch { /* active_context may not exist */ }
-        // transcript가 없거나 last_work를 추출 못한 경우, modified_files로 요약 생성
-        const emptyWorkPatterns = ['Session ended', 'Session work completed', 'Session started', ''];
-        if (emptyWorkPatterns.includes(summary.lastWork) && realtimeFiles.length > 0) {
-            const fileNames = realtimeFiles.slice(0, 5).map(f => path.basename(f)).join(', ');
-            summary.lastWork = `Modified files: ${fileNames}`;
+        // last_work 폴백: 파일 목록 기반
+        if (!lastWork && modifiedFiles.length > 0) {
+            const fileNames = modifiedFiles.slice(0, 5).map(f => path.basename(f)).join(', ');
+            lastWork = `Modified files: ${fileNames}`;
         }
-        // 빈 세션 저장 방지: last_work도 없고 파일도 없으면 skip
-        if (emptyWorkPatterns.includes(summary.lastWork)) {
+        // 빈 세션 skip
+        if (!lastWork) {
             console.log(`[SessionEnd] Skipping empty session for ${project} (no meaningful last_work)`);
             db.close();
             process.exit(0);
         }
-        // 중복 저장 방지: 최근 60초 이내 같은 프로젝트의 동일한 last_work가 있으면 skip
+        // 중복 저장 방지: 최근 60초 이내 동일 last_work
         const recentDup = db.prepare(`
       SELECT id FROM sessions
       WHERE project = ? AND last_work = ? AND timestamp > datetime('now', '-60 seconds')
       LIMIT 1
-    `).get(project, summary.lastWork);
+    `).get(project, lastWork);
         if (recentDup) {
             console.log(`[SessionEnd] Skipping duplicate session for ${project}`);
             db.close();
@@ -218,17 +249,17 @@ async function main() {
         db.prepare(`
       INSERT INTO sessions (project, last_work, next_tasks, modified_files)
       VALUES (?, ?, ?, ?)
-    `).run(project, summary.lastWork, JSON.stringify(summary.nextTasks), JSON.stringify(summary.modifiedFiles));
+    `).run(project, lastWork, JSON.stringify([...new Set(nextTasks)].slice(0, 5)), JSON.stringify(modifiedFiles.slice(0, 15)));
         // 활성 컨텍스트 업데이트
         db.prepare(`
       INSERT OR REPLACE INTO active_context (project, current_state, recent_files, updated_at)
       VALUES (?, ?, ?, datetime('now'))
-    `).run(project, summary.lastWork, JSON.stringify(summary.modifiedFiles));
+    `).run(project, lastWork, JSON.stringify(modifiedFiles.slice(0, 15)));
         db.close();
         console.log(`[SessionEnd] Saved session for ${project}`);
-        console.log(`  Last work: ${summary.lastWork.slice(0, 50)}...`);
-        console.log(`  Modified files: ${summary.modifiedFiles.length}`);
-        console.log(`  Next tasks: ${summary.nextTasks.length}`);
+        console.log(`  Last work: ${lastWork.slice(0, 80)}`);
+        console.log(`  Modified files: ${modifiedFiles.length}`);
+        console.log(`  Next tasks: ${nextTasks.length}`);
         process.exit(0);
     }
     catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-session-continuity-mcp",
-  "version": "1.9.3",
+  "version": "1.9.4",
   "description": "Session Continuity for Claude Code - Never re-explain your project again",
   "type": "module",
   "main": "dist/index.js",