@crewx/memory 0.1.23-rc.9 → 0.1.23-rc.91

package/dist/src/engine.js

@@ -3,18 +3,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CATEGORIES = exports.MemoryEngine = void 0;
+exports.CATEGORIES = exports.MemoryEngine = exports.SUMMARIZE_LOCK_STALE_MS = exports.SUMMARIZER_FAILURE_THRESHOLD = void 0;
 exports.getMemoryConfig = getMemoryConfig;
 exports.createMemoryEngine = createMemoryEngine;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
 const child_process_1 = require("child_process");
 const nanoid_1 = require("nanoid");
 const js_yaml_1 = __importDefault(require("js-yaml"));
 const parser_1 = require("./parser");
 const knowledge_core_1 = require("@crewx/knowledge-core");
 const CREWX_CLI = process.env.CREWX_CLI || 'npx crewx';
+exports.SUMMARIZER_FAILURE_THRESHOLD = 3;
+const SUMMARIZER_HEALTH_FILE = '.summarizer-health.json';
+const FIND_RESULT_LIMIT = 50;
+exports.SUMMARIZE_LOCK_STALE_MS = 10 * 60 * 1000;
 function parseCrewxResponse(raw) {
     const responseMatch = raw.match(/📄 Response:\s*─+\s*([\s\S]*?)(?=📁 Working Directory|$)/);
     if (responseMatch?.[1]) {
@@ -75,6 +78,7 @@ function getMemoryConfig() {
 }
 class MemoryEngine {
     constructor(config = {}) {
+        this.searchIndexCache = new Map();
         const yamlConfig = getMemoryConfig();
         this.dataDir =
             config.dataDir ??
@@ -103,7 +107,7 @@ class MemoryEngine {
         this.summarizerTimeout =
             config.summarizerTimeout ??
                 (yamlConfig.summarizer_timeout != null ? Number(yamlConfig.summarizer_timeout) : undefined) ??
-                60000;
+                480000;
         this.searcherTimeout =
             config.searcherTimeout ??
                 (yamlConfig.searcher_timeout != null ? Number(yamlConfig.searcher_timeout) : undefined) ??
@@ -115,12 +119,59 @@ class MemoryEngine {
     getEntriesDir(agentId) {
         return path_1.default.join(this.getAgentDir(agentId), 'entries');
     }
+    getEntryFilesFingerprint(agentId) {
+        const entriesDir = this.getEntriesDir(agentId);
+        if (!fs_1.default.existsSync(entriesDir))
+            return { files: [], fingerprint: '' };
+        const files = fs_1.default.readdirSync(entriesDir)
+            .filter((file) => file.endsWith('.md'))
+            .sort();
+        const fingerprint = files.map((file) => {
+            const stat = fs_1.default.statSync(path_1.default.join(entriesDir, file));
+            return `${file}\u0000${stat.size}\u0000${stat.mtimeMs}`;
+        }).join('\u0001');
+        return { files, fingerprint };
+    }
+    buildSearchIndex(agentId, files) {
+        const entriesDir = this.getEntriesDir(agentId);
+        const entries = files.map((file) => {
+            const raw = fs_1.default.readFileSync(path_1.default.join(entriesDir, file), 'utf-8');
+            const { data, content: body } = (0, parser_1.parseFrontmatter)(raw);
+            return { ...data, file, body };
+        });
+        return (0, knowledge_core_1.createSearchIndex)(entries, { summary: 3, tags: 2, body: 1 });
+    }
+    getSearchIndex(agentId) {
+        const snapshot = this.getEntryFilesFingerprint(agentId);
+        const cached = this.searchIndexCache.get(agentId);
+        if (cached?.fingerprint === snapshot.fingerprint) {
+            return { files: snapshot.files, index: cached.index };
+        }
+        const index = this.buildSearchIndex(agentId, snapshot.files);
+        this.searchIndexCache.set(agentId, { fingerprint: snapshot.fingerprint, index });
+        return { files: snapshot.files, index };
+    }
+    invalidateSearchIndex(agentId) {
+        this.searchIndexCache.delete(agentId);
+    }
+    createFindActionContext(agentId, keyword, results) {
+        return {
+            commandId: 'memory.find',
+            params: { agentId, query: keyword },
+            resultTags: [...new Set(results.flatMap((entry) => entry.tags ?? []))].slice(0, 3),
+            resultIds: results.slice(0, 3).map((entry) => entry.id),
+            resultCount: results.length,
+        };
+    }
     getSummaryPath(agentId) {
         return path_1.default.join(this.getAgentDir(agentId), 'summary.md');
     }
     getDirtySummaryPath(agentId) {
         return path_1.default.join(this.getAgentDir(agentId), '.dirty-summary');
     }
+    getSummarizeLockPath() {
+        return path_1.default.join(this.dataDir, '.summarize.lock');
+    }
     ensureDir(dir) {
         if (!fs_1.default.existsSync(dir)) {
             fs_1.default.mkdirSync(dir, { recursive: true });
@@ -162,6 +213,50 @@ class MemoryEngine {
         this.ensureDir(this.getAgentDir(agentId));
         fs_1.default.writeFileSync(this.getDirtySummaryPath(agentId), String(Date.now()), 'utf-8');
     }
+    getSummarizerHealthPath() {
+        return path_1.default.join(this.dataDir, SUMMARIZER_HEALTH_FILE);
+    }
+    readSummarizerHealth() {
+        try {
+            const raw = fs_1.default.readFileSync(this.getSummarizerHealthPath(), 'utf-8');
+            const parsed = JSON.parse(raw);
+            return {
+                consecutiveFailures: typeof parsed.consecutiveFailures === 'number' ? parsed.consecutiveFailures : 0,
+                notified: Boolean(parsed.notified),
+            };
+        }
+        catch {
+            return { consecutiveFailures: 0, notified: false };
+        }
+    }
+    writeSummarizerHealth(state) {
+        this.ensureDir(this.dataDir);
+        fs_1.default.writeFileSync(this.getSummarizerHealthPath(), JSON.stringify(state), 'utf-8');
+    }
+    recordSummarizerFailure() {
+        const state = this.readSummarizerHealth();
+        state.consecutiveFailures += 1;
+        if (state.consecutiveFailures >= exports.SUMMARIZER_FAILURE_THRESHOLD && !state.notified) {
+            this.notifySummarizerDegraded(state.consecutiveFailures);
+            state.notified = true;
+        }
+        this.writeSummarizerHealth(state);
+    }
+    recordSummarizerSuccess() {
+        const state = this.readSummarizerHealth();
+        if (state.consecutiveFailures === 0 && !state.notified)
+            return;
+        this.writeSummarizerHealth({ consecutiveFailures: 0, notified: false });
+    }
+    notifySummarizerDegraded(streakCount) {
+        try {
+            (0, child_process_1.execSync)(`${CREWX_CLI} notify "AI memory summarization keeps failing — falling back to mechanical summaries" --level=warning --body="callSummarizer(agent=${this.summarizerAgent}) failed ${streakCount} times in a row, so summarization switched to the fallback (mechanical) path."`, { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'], timeout: 15000 });
+        }
+        catch (e) {
+            const err = e;
+            console.error(`[memory] failed to send summarizer-health notify: ${err.message}`);
+        }
+    }
     loadAllEntries(agentId) {
         const entriesDir = this.getEntriesDir(agentId);
         if (!fs_1.default.existsSync(entriesDir))
@@ -172,7 +267,7 @@ class MemoryEngine {
             const raw = fs_1.default.readFileSync(path_1.default.join(entriesDir, file), 'utf-8');
             const { data, content } = (0, parser_1.parseFrontmatter)(raw);
             const bodyText = content.replace(/^#[^\n]*\n*/m, '').trim();
-            const hasBody = Boolean(bodyText) && bodyText !== '(상세 내용을 여기에 추가)';
+            const hasBody = Boolean(bodyText) && bodyText !== '(Add details here)';
             const entry = data;
             entries.push({ ...entry, file, hasBody });
         }
@@ -217,16 +312,17 @@ class MemoryEngine {
         });
         const filename = `${id}.md`;
         const filepath = path_1.default.join(this.getEntriesDir(agentId), filename);
-        const body = options.body ?? '(상세 내용을 여기에 추가)';
+        const body = options.body ?? '(Add details here)';
         const content = `${frontmatter}\n\n# ${summary}\n\n${body}\n`;
         fs_1.default.writeFileSync(filepath, content, 'utf-8');
-        console.log(`✅ 저장 완료: data/${agentId}/entries/${filename}`);
+        this.invalidateSearchIndex(agentId);
+        console.log(`✅ Saved: data/${agentId}/entries/${filename}`);
         console.log(`   ID: ${id}`);
-        console.log(`   Tags: ${tags.join(', ') || '(없음)'}`);
+        console.log(`   Tags: ${tags.join(', ') || '(none)'}`);
         console.log(`   Category: ${category}`);
         try {
             this.markSummaryDirty(agentId);
-            console.log(`   📝 summary.md 갱신 예약됨`);
+            console.log(`   📝 summary.md update scheduled`);
         }
         catch (_e) {
         }
@@ -252,11 +348,11 @@ class MemoryEngine {
         }
         const cutoff24h = new Date(Date.now() - this.shortTermHours * 60 * 60 * 1000).toISOString();
         const shortTermEntries = entries.filter((e) => this.toEntryTimestamp(e) >= cutoff24h);
-        console.log(`# ${agentId} 기억 요약\n`);
+        console.log(`# ${agentId} memory summary\n`);
         const summaryLastUpdated = fs_1.default.existsSync(summaryPath)
             ? (0, parser_1.parseFrontmatter)(fs_1.default.readFileSync(summaryPath, 'utf-8')).data.last_updated ?? '-'
             : '-';
-        console.log(`> ${entries.length}건 | 토픽 ${topics.length}개 | 갱신: ${summaryLastUpdated}`);
+        console.log(`> ${entries.length} items | topics ${topics.length} items | updated: ${summaryLastUpdated}`);
         if (options.full) {
             const byCat = {};
             for (const entry of entries) {
@@ -278,7 +374,7 @@ class MemoryEngine {
                     return bImp - aImp;
                 return this.toEntryTimestamp(b).localeCompare(this.toEntryTimestamp(a));
             });
-            console.log(`## 🔥 최근 작업 (24h)\n`);
+            console.log(`## 🔥 last Task (24h)\n`);
             for (const e of sortedShortTerm) {
                 const star = e.important ? '⭐ ' : '';
                 console.log(`- ${star}[${e.id}] ${e.summary} (${this.getPrimaryTag(e)})`);
@@ -302,7 +398,7 @@ class MemoryEngine {
                         const diffDays = Math.max(1, Math.floor((newest.getTime() - oldest.getTime()) / msPerDay) + 1);
                         const toMD = (d) => `${String(d.getMonth() + 1).padStart(2, '0')}/${String(d.getDate()).padStart(2, '0')}`;
                         console.log('---');
-                        console.log(`📋 토픽 요약 (${toMD(oldest)} ~ ${toMD(newest)}, ${diffDays}일간)\n`);
+                        console.log(`📋 Topic summary (${toMD(oldest)} ~ ${toMD(newest)}, ${diffDays} days)\n`);
                     }
                 }
                 console.log(summaryBody.trim());
@@ -310,7 +406,7 @@ class MemoryEngine {
             else {
                 for (const tag of topics.sort()) {
                     const count = entries.filter((e) => this.getPrimaryTag(e) === tag).length;
-                    console.log(`- **${tag}** (${count}건)`);
+                    console.log(`- **${tag}** (${count} items)`);
                 }
             }
         }
@@ -343,15 +439,15 @@ class MemoryEngine {
                 byCategory[category] = [];
             byCategory[category].push(entry);
         }
-        let md = `# ${agentId} 메모리\n\n`;
+        let md = `# ${agentId} memory\n\n`;
         md += `> Last Updated: ${today}\n`;
         md += `> Total: ${entries.length} memories\n\n`;
-        md += `## 🔥 최근 ${this.recentDays}일\n\n`;
+        md += `## 🔥 Last ${this.recentDays} days\n\n`;
         if (recent.length === 0) {
-            md += `(없음)\n\n`;
+            md += `(none)\n\n`;
         }
         else {
-            md += `| ID | 날짜 | 카테고리 | 요약 | 상세 |\n`;
+            md += `| ID | Date | Category | Summary | Details |\n`;
             md += `|----|------|----------|------|------|\n`;
             for (const entry of recent) {
                 const detailIcon = entry.hasBody ? '📄' : '-';
@@ -359,47 +455,43 @@ class MemoryEngine {
             }
             md += `\n`;
         }
-        md += `## 🏷️ 카테고리별\n\n`;
+        md += `## 🏷️ By category\n\n`;
         for (const [category, items] of Object.entries(byCategory).sort()) {
-            md += `- **${category}**: ${items.length}건\n`;
+            md += `- **${category}**: ${items.length} items\n`;
         }
         const olderCount = entries.length - recent.length;
         const oldestDate = entries[entries.length - 1]?.date ?? '-';
         const newestDate = entries[0]?.date ?? '-';
-        md += `\n## 📊 통계\n\n`;
-        md += `- 전체: ${entries.length}건 (${oldestDate} ~ ${newestDate})\n`;
-        md += `- 최근 ${this.recentDays}일: ${recent.length}건\n`;
+        md += `\n## 📊 Stats\n\n`;
+        md += `- Total: ${entries.length} items (${oldestDate} ~ ${newestDate})\n`;
+        md += `- Last ${this.recentDays} days: ${recent.length} items\n`;
         if (olderCount > 0)
-            md += `- ${this.recentDays}일 이전: ${olderCount}건\n`;
+            md += `- Older than ${this.recentDays} days: ${olderCount} items\n`;
         return md;
     }
     topic(agentId, topicName) {
         const entries = this.loadAllEntries(agentId);
         const filtered = entries.filter((e) => this.getPrimaryTag(e) === topicName);
         if (filtered.length === 0) {
-            console.log(`토픽 '${topicName}'에 해당하는 기억이 없습니다.`);
+            console.log(`No memories found for topic '${topicName}'.`);
             return;
         }
-        console.log(`## 📂 토픽: ${topicName} (${filtered.length}건)\n`);
+        console.log(`## 📂 Topic: ${topicName} (${filtered.length} items)\n`);
         for (const entry of filtered) {
             console.log(`### [${entry.date}] ${entry.summary}`);
-            console.log(`- 파일: data/${agentId}/entries/${entry.file}`);
-            console.log(`- 카테고리: ${entry.category ?? '-'}`);
-            console.log(`- 태그: ${(entry.tags ?? []).join(', ') || '-'}`);
+            console.log(`- File: data/${agentId}/entries/${entry.file}`);
+            console.log(`- Category: ${entry.category ?? '-'}`);
+            console.log(`- Tags: ${(entry.tags ?? []).join(', ') || '-'}`);
             console.log('');
         }
     }
     recent(agentId, days = 30) {
-        const entries = this.loadAllEntries(agentId);
-        const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000)
-            .toISOString()
-            .slice(0, 10);
-        const filtered = entries.filter((e) => e.date >= cutoff);
+        const filtered = this.getRecentEntries(agentId, days);
         if (filtered.length === 0) {
-            console.log(`최근 ${days}일 내 기억이 없습니다.`);
+            console.log(`No memories found in the last ${days} days.`);
             return;
         }
-        console.log(`## 🔥 최근 ${days}일 (${filtered.length}건)\n`);
+        console.log(`## 🔥 Last ${days} days (${filtered.length} items)\n`);
         for (const entry of filtered) {
             const detailIcon = entry.hasBody ? ' 📄' : '';
             const timestamp = String(entry.date).includes('T')
@@ -408,44 +500,75 @@ class MemoryEngine {
             console.log(`[${entry.id}] [${timestamp}] [${entry.category ?? '-'}] ${entry.summary}${detailIcon}`);
         }
     }
-    find(agentId, keyword) {
-        const entriesDir = this.getEntriesDir(agentId);
-        if (!fs_1.default.existsSync(entriesDir)) {
-            console.log('기억이 없습니다.');
-            return;
+    getRecentEntries(agentId, days = 30, opts = {}) {
+        const entries = this.loadAllEntries(agentId);
+        const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000)
+            .toISOString()
+            .slice(0, 10);
+        const filtered = entries.filter((e) => this.resolveRecentDate(agentId, e).slice(0, 10) >= cutoff);
+        if (!opts.includeBody)
+            return filtered;
+        return filtered.map((e) => ({
+            ...e,
+            body: this.readEntryBody(agentId, e.file),
+        }));
+    }
+    resolveRecentDate(agentId, entry) {
+        const updated = this.toDateString(entry.updated);
+        if (updated)
+            return updated;
+        const createdAt = this.toDateString(entry['created_at']);
+        if (createdAt)
+            return createdAt;
+        const date = this.toDateString(entry.date);
+        if (date)
+            return date;
+        try {
+            const filePath = path_1.default.join(this.getEntriesDir(agentId), entry.file);
+            return fs_1.default.statSync(filePath).mtime.toISOString();
         }
-        const files = fs_1.default.readdirSync(entriesDir).filter((f) => f.endsWith('.md'));
-        const entries = [];
-        for (const file of files) {
-            const content = fs_1.default.readFileSync(path_1.default.join(entriesDir, file), 'utf-8');
-            const { data, content: body } = (0, parser_1.parseFrontmatter)(content);
-            const entry = data;
-            entries.push({ ...entry, file, body });
+        catch {
+            return '';
         }
-        if (entries.length === 0) {
-            console.log('기억이 없습니다.');
+    }
+    toDateString(value) {
+        if (value &&
+            typeof value === 'object' &&
+            typeof value.toISOString === 'function') {
+            return value.toISOString();
+        }
+        return typeof value === 'string' ? value : '';
+    }
+    readEntryBody(agentId, file) {
+        try {
+            const raw = fs_1.default.readFileSync(path_1.default.join(this.getEntriesDir(agentId), file), 'utf-8');
+            const { content } = (0, parser_1.parseFrontmatter)(raw);
+            return content.replace(/^#[^\n]*\n*/m, '').trim();
+        }
+        catch {
+            return '';
+        }
+    }
+    find(agentId, keyword) {
+        const { files, index } = this.getSearchIndex(agentId);
+        if (files.length === 0) {
+            console.log('No memories found.');
             return;
         }
-        const kcEntries = entries;
-        const results = (0, knowledge_core_1.searchEntries)(kcEntries, keyword, { summary: 3, tags: 2, body: 1 });
+        const indexedResults = index.search(keyword, FIND_RESULT_LIMIT + 1);
+        const truncated = indexedResults.length > FIND_RESULT_LIMIT;
+        const results = indexedResults.slice(0, FIND_RESULT_LIMIT);
         if (results.length === 0) {
-            console.log(`'${keyword}' 관련 기억을 찾을 수 없습니다.`);
+            console.log(`No related memories found for '${keyword}'.`);
             return;
         }
-        console.log(`## 🔍 검색 결과: "${keyword}" (${results.length}건, BM25 점수순)\n`);
+        const limitNote = truncated ? `, top ${FIND_RESULT_LIMIT}` : '';
+        console.log(`## 🔍 Search results: "${keyword}" (${results.length} items${limitNote}, sorted by BM25 score)\n`);
         for (const entry of results) {
-            const score = entry._score != null ? ` [${entry._score}점]` : '';
+            const score = entry._score != null ? ` [${entry._score}pts]` : '';
             console.log(`[${entry.id}] [${entry.date}] [${this.getPrimaryTag(entry)}]${score} ${entry.summary}`);
         }
-        const resultTags = [...new Set(results.flatMap(e => e.tags ?? []))].slice(0, 3);
-        const resultIds = results.slice(0, 3).map(e => e.id);
-        const findCtx = {
-            commandId: 'memory.find',
-            params: { agentId, query: keyword },
-            resultTags,
-            resultIds,
-            resultCount: results.length,
-        };
+        const findCtx = this.createFindActionContext(agentId, keyword, results);
         const findActions = (0, knowledge_core_1.generateNextActions)(findCtx);
         const findBlock = (0, knowledge_core_1.formatActions)(findActions);
         if (findBlock)
@@ -470,7 +593,7 @@ class MemoryEngine {
                         const raw = fs_1.default.readFileSync(path_1.default.join(entriesDir, e.file), 'utf-8');
                         const { content: rawContent } = (0, parser_1.parseFrontmatter)(raw);
                         const body = rawContent.replace(/^#[^\n]*\n*/m, '').trim();
-                        if (body !== '(상세 내용을 여기에 추가)')
+                        if (body !== '(Add details here)')
                             content = body;
                     }
                     catch (_err) {
@@ -494,10 +617,10 @@ class MemoryEngine {
                 filters.push(`category=${options.category}`);
             if (options.tag)
                 filters.push(`tag=${options.tag}`);
-            console.log(`조건에 맞는 기억이 없습니다. (${filters.join(', ') || '전체'})`);
+            console.log(`No memories match the filters. (${filters.join(', ') || 'all'})`);
             return;
         }
-        console.log(`## 📋 목록: ${agentId} (${filtered.length}건)\n`);
+        console.log(`## 📋 List: ${agentId} (${filtered.length} items)\n`);
         for (const entry of filtered) {
             console.log(`[${entry.id}] [${entry.date}] [${this.getPrimaryTag(entry)}] ${entry.summary}`);
         }
@@ -518,7 +641,7 @@ class MemoryEngine {
     stats(agentId) {
         const entries = this.loadAllEntries(agentId);
         if (entries.length === 0) {
-            console.log('기억이 없습니다.');
+            console.log('No memories found.');
             return;
         }
         const byCategory = {};
@@ -532,15 +655,15 @@ class MemoryEngine {
                 byTag[tag] = (byTag[tag] ?? 0) + 1;
             }
         }
-        console.log(`# ${agentId} 통계 (${entries.length}건)\n`);
-        console.log(`## 카테고리별`);
+        console.log(`# ${agentId} Stats (${entries.length} items)\n`);
+        console.log(`## By category`);
         for (const [cat, count] of Object.entries(byCategory).sort((a, b) => b[1] - a[1])) {
-            console.log(`  ${cat}: ${count}건`);
+            console.log(`  ${cat}: ${count} items`);
         }
-        console.log(`\n## 태그 Top 20`);
+        console.log(`\n## Top 20 Tags`);
         const sortedTags = Object.entries(byTag).sort((a, b) => b[1] - a[1]).slice(0, 20);
         for (const [tag, count] of sortedTags) {
-            console.log(`  ${tag}: ${count}건`);
+            console.log(`  ${tag}: ${count} items`);
         }
         const topCategories = Object.entries(byCategory).sort((a, b) => b[1] - a[1]).map(t => t[0]);
         const statsCtx = {
@@ -557,7 +680,7 @@ class MemoryEngine {
     tags(agentId) {
         const entries = this.loadAllEntries(agentId);
         if (entries.length === 0) {
-            console.log('기억이 없습니다.');
+            console.log('No memories found.');
             return;
         }
         const byTag = {};
@@ -568,18 +691,18 @@ class MemoryEngine {
         }
         const sortedTags = Object.entries(byTag).sort((a, b) => b[1] - a[1]);
         if (sortedTags.length === 0) {
-            console.log('태그가 없습니다.');
+            console.log('No tags found.');
             return;
         }
-        console.log(`## 🏷️ 전체 태그 (${sortedTags.length}개)\n`);
+        console.log(`## 🏷️ All tags (${sortedTags.length} items)\n`);
         for (const [tag, count] of sortedTags) {
-            console.log(`  ${tag}: ${count}건`);
+            console.log(`  ${tag}: ${count} items`);
         }
     }
     get(agentId, memoryId) {
         const entriesDir = this.getEntriesDir(agentId);
         if (!fs_1.default.existsSync(entriesDir)) {
-            console.log('기억이 없습니다.');
+            console.log('No memories found.');
             return;
         }
         const files = fs_1.default.readdirSync(entriesDir).filter((f) => f.endsWith('.md'));
@@ -591,10 +714,10 @@ class MemoryEngine {
                 const d = data;
                 console.log(`## 📄 ${d.summary}\n`);
                 console.log(`- ID: ${d.id}`);
-                console.log(`- 날짜: ${d.date}`);
-                console.log(`- 카테고리: ${d.category ?? '-'}`);
-                console.log(`- 태그: ${(d.tags ?? []).join(', ') || '-'}`);
-                console.log(`- 파일: data/${agentId}/entries/${file}`);
+                console.log(`- Date: ${d.date}`);
+                console.log(`- Category: ${d.category ?? '-'}`);
+                console.log(`- Tags: ${(d.tags ?? []).join(', ') || '-'}`);
+                console.log(`- File: data/${agentId}/entries/${file}`);
                 console.log(`\n---\n`);
                 console.log(content.trim());
                 const graphPath = path_1.default.join(this.getAgentDir(agentId), 'graph.json');
@@ -611,7 +734,7 @@ class MemoryEngine {
                                 nodeMap[n.id] = n;
                             });
                             console.log(`\n---\n`);
-                            console.log(`## 🔗 연관 기억 (${relatedEdges.length}개)\n`);
+                            console.log(`## 🔗 Related memories (${relatedEdges.length} items)\n`);
                             for (const edge of relatedEdges) {
                                 const otherId = edge.from === memoryId ? edge.to : edge.from;
                                 const other = nodeMap[otherId];
@@ -638,12 +761,12 @@ class MemoryEngine {
                 return;
             }
         }
-        console.log(`ID '${memoryId}'를 찾을 수 없습니다.`);
+        console.log(`ID '${memoryId}' not found.`);
     }
     update(agentId, memoryId, options = {}) {
         const entry = this.findEntryById(agentId, memoryId);
         if (!entry) {
-            console.log(`❌ ID '${memoryId}'를 찾을 수 없습니다.`);
+            console.log(`❌ ID '${memoryId}' not found.`);
             process.exit(1);
         }
         const { filePath, data, content } = entry;
@@ -664,11 +787,12 @@ class MemoryEngine {
         else if (options['no-important']) {
             delete newData['important'];
         }
-        const newBody = options.body ?? existingBody ?? '(상세 내용을 여기에 추가)';
+        const newBody = options.body ?? existingBody ?? '(Add details here)';
         const newFrontmatter = (0, parser_1.stringifyFrontmatter)(newData);
         const newContent = `${newFrontmatter}\n\n# ${String(newData['summary'])}\n\n${newBody}\n`;
         fs_1.default.writeFileSync(filePath, newContent, 'utf-8');
-        console.log(`✅ 수정 완료: ${entry.file}`);
+        this.invalidateSearchIndex(agentId);
+        console.log(`✅ Updated: ${entry.file}`);
         console.log(`   ID: ${memoryId}`);
         if (options.summary)
             console.log(`   Summary: ${String(newData['summary'])}`);
@@ -677,28 +801,29 @@ class MemoryEngine {
         if (options.tags)
             console.log(`   Tags: ${newData['tags'].join(', ')}`);
         if (options.body)
-            console.log(`   Body: (업데이트됨)`);
+            console.log(`   Body: (updated)`);
     }
     delete(agentId, memoryId, options = {}) {
         const entry = this.findEntryById(agentId, memoryId);
         if (!entry) {
-            console.log(`❌ ID '${memoryId}'를 찾을 수 없습니다.`);
+            console.log(`❌ ID '${memoryId}' not found.`);
             process.exit(1);
         }
         if (!options.force) {
-            console.log(`⚠️  삭제 대상: [${entry.data.id}] ${entry.data.summary}`);
-            console.log(`   파일: ${entry.file}`);
-            console.log(`\n--force 옵션을 추가하면 삭제됩니다.`);
-            console.log(`예: memory delete ${agentId} ${memoryId} --force`);
+            console.log(`⚠️  Delete target: [${entry.data.id}] ${entry.data.summary}`);
+            console.log(`   File: ${entry.file}`);
+            console.log(`\nAdd --force to delete it.`);
+            console.log(`Example: memory delete ${agentId} ${memoryId} --force`);
             return;
         }
         fs_1.default.unlinkSync(entry.filePath);
-        console.log(`🗑️  삭제 완료: ${entry.file}`);
+        this.invalidateSearchIndex(agentId);
+        console.log(`🗑️  Deleted: ${entry.file}`);
         console.log(`   ID: ${memoryId}`);
         console.log(`   Summary: ${entry.data.summary}`);
         try {
             this.markSummaryDirty(agentId);
-            console.log(`   📝 summary.md 갱신 예약됨`);
+            console.log(`   📝 summary.md update scheduled`);
         }
         catch (_e) {
         }
@@ -707,27 +832,27 @@ class MemoryEngine {
         const entry1 = this.findEntryById(agentId, memoryId1);
         const entry2 = this.findEntryById(agentId, memoryId2);
         if (!entry1) {
-            console.log(`❌ ID '${memoryId1}'를 찾을 수 없습니다.`);
+            console.log(`❌ ID '${memoryId1}' not found.`);
             process.exit(1);
         }
         if (!entry2) {
-            console.log(`❌ ID '${memoryId2}'를 찾을 수 없습니다.`);
+            console.log(`❌ ID '${memoryId2}' not found.`);
             process.exit(1);
         }
         const body1 = entry1.content.replace(/^#[^\n]*\n*/m, '').trim();
         const body2 = entry2.content.replace(/^#[^\n]*\n*/m, '').trim();
         const mergedSummary = options.summary ?? `${entry1.data.summary} + ${entry2.data.summary}`;
-        const mergedBody = `## 병합된 기억 1 (${entry1.data.id}, ${entry1.data.date})
+        const mergedBody = `## Merged memory 1 (${entry1.data.id}, ${entry1.data.date})
 ${entry1.data.summary}
 
-${body1 !== '(상세 내용을 여기에 추가)' ? body1 : '(상세 없음)'}
+${body1 !== '(Add details here)' ? body1 : '(No details)'}
 
 ---
 
-## 병합된 기억 2 (${entry2.data.id}, ${entry2.data.date})
+## Merged memory 2 (${entry2.data.id}, ${entry2.data.date})
 ${entry2.data.summary}
 
-${body2 !== '(상세 내용을 여기에 추가)' ? body2 : '(상세 없음)'}`;
+${body2 !== '(Add details here)' ? body2 : '(No details)'}`;
         const mergedTags = [
             ...new Set([...(entry1.data.tags ?? []), ...(entry2.data.tags ?? [])]),
         ];
@@ -749,10 +874,11 @@ ${body2 !== '(상세 내용을 여기에 추가)' ? body2 : '(상세 없음)'}`;
         fs_1.default.writeFileSync(filepath, newContent, 'utf-8');
         fs_1.default.unlinkSync(entry1.filePath);
         fs_1.default.unlinkSync(entry2.filePath);
-        console.log(`🔀 병합 완료!`);
-        console.log(`   새 ID: ${newId}`);
-        console.log(`   새 파일: ${filename}`);
-        console.log(`   병합된 기억: [${memoryId1}] + [${memoryId2}]`);
+        this.invalidateSearchIndex(agentId);
+        console.log(`🔀 Merge complete!`);
+        console.log(`   New ID: ${newId}`);
+        console.log(`   New file: ${filename}`);
+        console.log(`   Merged memory: [${memoryId1}] + [${memoryId2}]`);
         console.log(`   Summary: ${mergedSummary}`);
     }
     buildFallbackSummary(entries) {
@@ -778,7 +904,7 @@ ${body2 !== '(상세 내용을 여기에 추가)' ? body2 : '(상세 없음)'}`;
             const oldest = dates[0];
             const newest = dates[dates.length - 1];
             const rangeLabel = oldest && newest ? `, ${toMD(oldest)}~${toMD(newest)}` : '';
-            body += `## ${topic} (${items.length}건${rangeLabel})\n`;
+            body += `## ${topic} (${items.length} items${rangeLabel})\n`;
             for (const e of items)
                 body += `- [${e.date}] ${e.summary}\n`;
             for (const e of items)
@@ -788,22 +914,26 @@ ${body2 !== '(상세 내용을 여기에 추가)' ? body2 : '(상세 없음)'}`;
         return body;
     }
     callSummarizer(prompt) {
-        const tmpFile = path_1.default.join(os_1.default.tmpdir(), `memory-summarizer-${Date.now()}.txt`);
         try {
-            fs_1.default.writeFileSync(tmpFile, prompt, 'utf-8');
-            const result = (0, child_process_1.execSync)(`${CREWX_CLI} q "${this.summarizerAgent} $(cat '${tmpFile}')"`, { encoding: 'utf-8', timeout: this.summarizerTimeout, stdio: ['pipe', 'pipe', 'pipe'] });
-            return parseCrewxResponse(result);
-        }
-        catch (_e) {
+            const result = (0, child_process_1.execSync)(`${CREWX_CLI} q "${this.summarizerAgent}"`, {
+                encoding: 'utf-8',
+                timeout: this.summarizerTimeout,
+                stdio: ['pipe', 'pipe', 'pipe'],
+                input: prompt,
+            });
+            const parsed = parseCrewxResponse(result);
+            this.recordSummarizerSuccess();
+            return parsed;
+        }
+        catch (e) {
+            const err = e;
+            const reason = err.code === 'ETIMEDOUT' || err.killed
+                ? `timed out after ${this.summarizerTimeout}ms`
+                : err.message;
+            console.error(`[memory] callSummarizer failed (agent=${this.summarizerAgent}), falling back to raw entry list: ${reason}`);
+            this.recordSummarizerFailure();
             return null;
         }
-        finally {
-            try {
-                fs_1.default.unlinkSync(tmpFile);
-            }
-            catch (_e) {
-            }
-        }
     }
     generateSummary(agentId, options = {}) {
         const allEntries = this.loadAllEntries(agentId);
@@ -861,13 +991,13 @@ ${body2 !== '(상세 내용을 여기에 추가)' ? body2 : '(상세 없음)'}`;
             for (const entry of newItems) {
                 const importantTag = entry.important ? ' [important]' : '';
                 p += `- [${entry.id}] [${entry.date}] [${this.getPrimaryTag(entry)}]${importantTag} ${entry.summary}`;
-                if (entry.body && entry.body !== '(상세 내용을 여기에 추가)') {
+                if (entry.body && entry.body !== '(Add details here)') {
                     p += ` — ${entry.body.slice(0, 200)}`;
                 }
                 p += ` (file: entries/${entry.file})\n`;
             }
             p += `\n## Instructions:\n`;
-            p += `- Group by topic, each topic as ## heading with entry count and date range, e.g. "## mcp-http (4건, 01/28~02/14)"\n`;
+            p += `- Group by topic, each topic as ## heading with entry count and date range, e.g. "## mcp-http (4 items, 01/28~02/14)"\n`;
             p += `- Write concise Korean summary per topic (2-5 sentences)\n`;
             p += `- After each topic summary, list relevant entry file links as "→ [entries/filename](entries/filename)"\n`;
             p += `- Highlight key decisions, insights, and action items\n`;
@@ -917,76 +1047,141 @@ ${body2 !== '(상세 내용을 여기에 추가)' ? body2 : '(상세 없음)'}`;
     summarize(agentId, options = {}) {
         const entries = this.loadAllEntries(agentId);
         if (entries.length === 0) {
-            console.log('기억이 없습니다.');
+            console.log('No memories found.');
             return;
         }
-        console.log(`📝 요약 생성 시작 (${entries.length}개 엔트리)\n`);
+        console.log(`📝 Starting summary generation (${entries.length} items entries)\n`);
         const result = this.generateSummary(agentId, { force: options.force });
         if (result.status === 'up-to-date') {
-            console.log('✅ summary.md 최신 상태입니다.');
+            console.log('✅ summary.md is up to date.');
         }
         else if (result.status === 'fallback') {
-            console.log(`📋 폴백 요약 생성 완료 (AI 호출 실패)`);
+            console.log(`📋 Fallback summary generated (AI call failed)`);
         }
         else if (result.status === 'updated') {
-            console.log(`🤖 요약 완료 (${result.newEntries}건 반영)`);
+            console.log(`🤖 Summary complete (${result.newEntries} items applied)`);
+        }
+        console.log(`   File: data/${agentId}/summary.md`);
+        console.log(`   entries: ${result.entryCount} items`);
+    }
+    isSummarizeLockStale(lockPath) {
+        let content;
+        try {
+            content = fs_1.default.readFileSync(lockPath, 'utf-8');
+        }
+        catch {
+            return true;
+        }
+        const pidMatch = content.match(/^pid=(\d+)/m);
+        const pid = pidMatch ? Number(pidMatch[1]) : NaN;
+        if (Number.isFinite(pid)) {
+            try {
+                process.kill(pid, 0);
+                return false;
+            }
+            catch (e) {
+                const err = e;
+                if (err.code === 'ESRCH')
+                    return true;
+            }
+        }
+        try {
+            const stat = fs_1.default.statSync(lockPath);
+            return Date.now() - stat.mtimeMs > exports.SUMMARIZE_LOCK_STALE_MS;
+        }
+        catch {
+            return true;
+        }
+    }
+    acquireSummarizeLock() {
+        const lockPath = this.getSummarizeLockPath();
+        const content = `pid=${process.pid}\nmtime=${new Date().toISOString()}\n`;
+        try {
+            const fd = fs_1.default.openSync(lockPath, 'wx');
+            fs_1.default.writeSync(fd, content);
+            fs_1.default.closeSync(fd);
+            return true;
+        }
+        catch (e) {
+            const err = e;
+            if (err.code !== 'EEXIST')
+                throw err;
+        }
+        if (!this.isSummarizeLockStale(lockPath)) {
+            return false;
+        }
+        fs_1.default.writeFileSync(lockPath, content, 'utf-8');
+        return true;
+    }
+    releaseSummarizeLock() {
+        try {
+            fs_1.default.unlinkSync(this.getSummarizeLockPath());
+        }
+        catch {
         }
-        console.log(`   파일: data/${agentId}/summary.md`);
-        console.log(`   엔트리: ${result.entryCount}개`);
     }
     summarizeDirty() {
         if (!fs_1.default.existsSync(this.dataDir)) {
-            console.log(`💡 디바운스 cron 등록:`);
+            console.log(`💡 Register debounce cron:`);
             console.log(`npx cron add "*/1 * * * *" "npx memory summarize-dirty" --mode command --name "memory-debounce"`);
             return;
         }
-        const agentDirs = fs_1.default
-            .readdirSync(this.dataDir, { withFileTypes: true })
-            .filter((entry) => entry.isDirectory())
-            .map((entry) => entry.name);
-        for (const agentId of agentDirs) {
-            const dirtyPath = this.getDirtySummaryPath(agentId);
-            if (!fs_1.default.existsSync(dirtyPath))
-                continue;
-            try {
-                const result = this.generateSummary(agentId);
-                if (result.status === 'updated') {
-                    console.log(`🤖 ${agentId} summary.md 갱신 (${result.newEntries}건 반영)`);
-                }
-                else if (result.status === 'fallback') {
-                    console.log(`📋 ${agentId} 폴백 요약 생성 완료 (AI 호출 실패)`);
-                }
-                else if (result.status === 'up-to-date') {
-                    console.log(`✅ ${agentId} summary.md 최신 상태입니다.`);
+        if (!this.acquireSummarizeLock()) {
+            console.log(`⏭️  summarize-dirty is already running (lock held) — skipping this run.`);
+            return;
+        }
+        try {
+            const agentDirs = fs_1.default
+                .readdirSync(this.dataDir, { withFileTypes: true })
+                .filter((entry) => entry.isDirectory())
+                .map((entry) => entry.name);
+            for (const agentId of agentDirs) {
+                const dirtyPath = this.getDirtySummaryPath(agentId);
+                if (!fs_1.default.existsSync(dirtyPath))
+                    continue;
+                try {
+                    const result = this.generateSummary(agentId);
+                    if (result.status === 'updated') {
+                        console.log(`🤖 ${agentId} summary.md updated (${result.newEntries} items applied)`);
+                    }
+                    else if (result.status === 'fallback') {
+                        console.log(`📋 ${agentId} Fallback summary generated (AI call failed)`);
+                    }
+                    else if (result.status === 'up-to-date') {
+                        console.log(`✅ ${agentId} summary.md is up to date.`);
+                    }
+                    else if (result.status === 'empty') {
+                        console.log(`ℹ️  ${agentId} has no memories to summarize.`);
+                    }
+                    fs_1.default.unlinkSync(dirtyPath);
                 }
-                else if (result.status === 'empty') {
-                    console.log(`ℹ️  ${agentId} 요약할 기억이 없습니다.`);
+                catch (e) {
+                    console.error(`❌ ${agentId} summary.md update failed: ${e.message}`);
                 }
-                fs_1.default.unlinkSync(dirtyPath);
-            }
-            catch (e) {
-                console.error(`❌ ${agentId} summary.md 갱신 실패: ${e.message}`);
             }
         }
-        console.log(`💡 디바운스 cron 등록:`);
+        finally {
+            this.releaseSummarizeLock();
+        }
+        console.log(`💡 Register debounce cron:`);
         console.log(`npx cron add "*/1 * * * *" "npx memory summarize-dirty" --mode command --name "memory-debounce"`);
     }
     search(agentId, query) {
         const entries = this.loadAllEntries(agentId);
         if (entries.length === 0) {
-            console.log('기억이 없습니다.');
+            console.log('No memories found.');
             return;
         }
         const memoryList = entries
             .map((e) => `[${e.id}] [${e.date}] [${this.getPrimaryTag(e)}] ${e.summary}`)
             .join('\n');
-        const task = `기억 목록:\n${memoryList}\n\n질문: "${query}"`;
+        const task = `Memory list:\n${memoryList}\n\nQuestion: "${query}"`;
         try {
-            console.log(`🔍 "${query}" 검색 중... (${this.searcherAgent})\n`);
+            console.log(`🔍 "${query}" searching... (${this.searcherAgent})\n`);
             const result = (0, child_process_1.execSync)(`${CREWX_CLI} q "${this.searcherAgent} ${task.replace(/"/g, '\\"').replace(/\n/g, ' ')}"`, { encoding: 'utf-8', timeout: this.searcherTimeout, stdio: ['pipe', 'pipe', 'pipe'] });
             const parsed = parseCrewxResponse(result);
             if (parsed) {
-                console.log(`## 🧠 시맨틱 검색 결과\n`);
+                console.log(`## 🧠 Semantic search results\n`);
                 console.log(parsed);
             }
             else {
@@ -996,12 +1191,12 @@ ${body2 !== '(상세 내용을 여기에 추가)' ? body2 : '(상세 없음)'}`;
         catch (error) {
             const err = error;
             if (err.code === 'ETIMEDOUT' || err.killed) {
-                console.log('검색 실패: 시간 초과 (최대 5분)');
+                console.log('Search failed: timed out (max 5 minutes)');
             }
             else {
-                console.log('검색 실패:', err.message);
+                console.log('Search failed:', err.message);
             }
-            console.log('\n💡 Tip: find 명령으로 키워드 검색을 시도해보세요.');
+            console.log('\n💡 Tip: try keyword search with the find command.');
         }
     }
 }