memento-mcp-server 1.13.1-a2 → 1.13.1-a4

package/dist/tools/recall-tool.js

@@ -1,709 +0,0 @@
-/**
- * Recall Tool - 기억 검색 도구
- * 하이브리드 검색을 통한 고성능 기억 검색
- */
-import { z } from 'zod';
-import { BaseTool } from './base-tool.js';
-import { CommonSchemas } from './types.js';
-import { isMemoryItemType } from '../types/index.js';
-import { CoreMemoryRepository } from '../repositories/core-memory-repository.js';
-import { CoreMemoryService } from '../services/core-memory-service.js';
-import { CoreMemoryCacheService } from '../services/core-memory-cache-service.js';
-import { KnowledgeVaultRepository } from '../repositories/knowledge-vault-repository.js';
-import { KnowledgeVaultService } from '../services/knowledge-vault-service.js';
-import { validateTypeParam } from '../utils/type-param-validator.js';
-import { mementoConfig } from '../config/index.js';
-import { DatabaseUtils } from '../utils/database.js';
-/**
- * Provider 필터 정규화 유틸리티
- * 빈 배열인 경우 undefined로 변환하여 모든 provider 검색을 의미
- *
- * @param providerFilter - 원본 provider 필터 (빈 배열 가능)
- * @returns 정규화된 provider 필터 (undefined 또는 비어있지 않은 배열)
- */
-function normalizeProviderFilter(providerFilter) {
-    return providerFilter && providerFilter.length > 0 ? providerFilter : undefined;
-}
-const RecallSchema = z.object({
-    // query를 optional로 변경 (조건부 필수는 refine에서 처리)
-    query: z.string().min(1, 'Query cannot be empty').optional(),
-    // 새 파라미터 추가
-    type: CommonSchemas.MemoryType.optional(), // 확장된 MemoryTypeRequest 사용
-    key: z.string().optional(),
-    agent_id: z.string().optional().default('default'),
-    // 기존 파라미터 유지
-    memory_types: z.array(CommonSchemas.MemoryType).optional(),
-    tags: z.array(z.string()).optional(),
-    privacy_scope: z.array(CommonSchemas.PrivacyScope).optional(),
-    time_from: z.string().optional(),
-    time_to: z.string().optional(),
-    pinned: z.boolean().optional(),
-    importance_min: z.number().min(0).max(1).optional(),
-    importance_max: z.number().min(0).max(1).optional(),
-    has_reflection_notes: z.boolean().optional(), // reflection_notes IS NOT NULL 필터링
-    limit: CommonSchemas.Limit,
-    vector_weight: z.number().min(0).max(1).optional(),
-    text_weight: z.number().min(0).max(1).optional(),
-    enable_hybrid: z.boolean().optional(),
-    include_metadata: z.boolean().optional(),
-    provider_filter: z.array(z.enum(['tfidf', 'lightweight', 'minilm', 'openai', 'gemini'])).optional()
-}).refine((data) => {
-    // 조건부 필수 검증
-    if (data.type === 'core' || data.type === 'vault') {
-        // query는 선택적 (없어도 됨)
-        return true;
-    }
-    else {
-        // 나머지 타입은 query 필수
-        if (!data.query) {
-            return false;
-        }
-    }
-    return true;
-}, {
-    message: "type='core' 또는 'vault'가 아닌 경우 query 파라미터는 필수입니다"
-});
-export class RecallTool extends BaseTool {
-    constructor() {
-        super('recall', '관련 기억을 검색합니다', {
-            type: 'object',
-            properties: {
-                query: {
-                    type: 'string',
-                    description: '검색 쿼리 (type이 core 또는 vault가 아닌 경우 필수)'
-                },
-                type: {
-                    type: 'string',
-                    enum: ['working', 'episodic', 'semantic', 'procedural', 'core', 'vault'],
-                    description: '단일 메모리 타입 지정 (선택사항)'
-                },
-                key: {
-                    type: 'string',
-                    description: 'Core/Vault 조회 시 특정 키 지정 (선택사항)'
-                },
-                agent_id: {
-                    type: 'string',
-                    description: '에이전트 ID (Core/Vault 조회 시 사용, 기본값: "default")'
-                },
-                memory_types: {
-                    type: 'array',
-                    items: { type: 'string', enum: ['working', 'episodic', 'semantic', 'procedural', 'core', 'vault'] },
-                    description: '기억 타입 필터 (선택사항, type 파라미터와 동시 사용 시 type 우선). core/vault는 자동으로 제거됩니다.'
-                },
-                tags: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: '태그 필터 (선택사항)'
-                },
-                privacy_scope: {
-                    type: 'array',
-                    items: { type: 'string', enum: ['private', 'team', 'public'] },
-                    description: '프라이버시 범위 필터 (선택사항)'
-                },
-                time_from: {
-                    type: 'string',
-                    description: '시작 시간 (ISO 8601 형식, 선택사항)'
-                },
-                time_to: {
-                    type: 'string',
-                    description: '종료 시간 (ISO 8601 형식, 선택사항)'
-                },
-                pinned: {
-                    type: 'boolean',
-                    description: '핀된 기억만 검색 (선택사항)'
-                },
-                importance_min: {
-                    type: 'number',
-                    minimum: 0,
-                    maximum: 1,
-                    description: '최소 중요도 (선택사항)'
-                },
-                importance_max: {
-                    type: 'number',
-                    minimum: 0,
-                    maximum: 1,
-                    description: '최대 중요도 (0-1, 선택사항)'
-                },
-                has_reflection_notes: {
-                    type: 'boolean',
-                    description: 'reflection_notes가 있는 메모리만 조회 (true: IS NOT NULL, false: IS NULL, 선택사항)'
-                },
-                limit: {
-                    type: 'number',
-                    minimum: 1,
-                    maximum: 100,
-                    default: 10,
-                    description: '최대 결과 수'
-                },
-                vector_weight: {
-                    type: 'number',
-                    minimum: 0,
-                    maximum: 1,
-                    default: 0.6,
-                    description: '벡터 검색 가중치 (선택사항)'
-                },
-                text_weight: {
-                    type: 'number',
-                    minimum: 0,
-                    maximum: 1,
-                    default: 0.4,
-                    description: '텍스트 검색 가중치 (선택사항)'
-                },
-                enable_hybrid: {
-                    type: 'boolean',
-                    default: true,
-                    description: '하이브리드 검색 사용 여부 (선택사항)'
-                },
-                include_metadata: {
-                    type: 'boolean',
-                    default: true,
-                    description: '메타데이터 포함 여부 (선택사항)'
-                },
-                provider_filter: {
-                    type: 'array',
-                    items: { type: 'string', enum: ['tfidf', 'lightweight', 'minilm', 'openai', 'gemini'] },
-                    description: '검색할 임베딩 provider 필터 (선택사항, 미지정 시 모든 provider 검색)'
-                }
-            },
-            required: [] // 조건부 필수는 런타임 검증 (RecallSchema.refine()에서 처리)
-        });
-    }
-    async handle(params, context) {
-        const startTime = Date.now();
-        this.logInfo('Recall 도구 호출됨', { params });
-        try {
-            // 파라미터 검증 및 파싱
-            const { query, type, key, agent_id, memory_types, tags, privacy_scope, time_from, time_to, pinned, importance_min, importance_max, limit, vector_weight, text_weight, enable_hybrid, include_metadata, provider_filter } = RecallSchema.parse(params);
-            // type 파라미터 롤아웃 모드 검증
-            // PRD 요구사항: Phase 1/2에서는 type 파라미터가 없으면 항상 경고/Deprecated 메시지를 띄워야 함
-            // memory_types만 있어도 경고를 띄워야 하므로, type이 없으면 항상 검증 수행
-            const typeParamMode = mementoConfig.typeParamMode;
-            const originalTypeProvided = !!type; // 원래 type 파라미터가 제공되었는지 추적
-            let validatedType = type;
-            // type 파라미터가 없는 경우 항상 검증 수행 (memory_types로 우회 불가)
-            if (!type) {
-                const typeValidation = validateTypeParam(undefined, typeParamMode, 'recall');
-                // error 모드에서는 에러 발생
-                if (!typeValidation.isValid) {
-                    throw new Error(typeValidation.message || "type 파라미터는 필수입니다.");
-                }
-                // warn/deprecate 모드에서는 경고/Deprecation 메시지 출력
-                // memory_types가 있어도 경고는 항상 출력되어야 함
-                if (typeValidation.message) {
-                    if (typeParamMode === 'warn') {
-                        this.logWarning(typeValidation.message);
-                    }
-                    else if (typeParamMode === 'deprecate') {
-                        this.logWarning(typeValidation.message);
-                    }
-                }
-                // 기본값 설정 (일관성을 위해 항상 설정)
-                // memory_types가 있어도 기본 타입을 설정하되, 나중에 memory_types를 사용할 때는 무시됨
-                if (typeValidation.defaultType) {
-                    validatedType = typeValidation.defaultType;
-                }
-            }
-            this.logInfo('파라미터 파싱 완료', {
-                query,
-                type: validatedType,
-                key,
-                agent_id,
-                memory_types,
-                tags,
-                privacy_scope,
-                limit,
-                vector_weight,
-                text_weight,
-                enable_hybrid,
-                provider_filter
-            });
-            // 데이터베이스 연결 확인
-            this.validateDatabase(context);
-            const startTime = Date.now();
-            const agentId = agent_id || 'default';
-            // type 파라미터에 따른 분기 처리
-            if (validatedType === 'core') {
-                // Core Memory 조회
-                if (query) {
-                    this.logWarning('type="core"일 때 query 파라미터는 무시됩니다', { query });
-                }
-                if (memory_types && memory_types.length > 0) {
-                    this.logWarning('type="core"일 때 memory_types 파라미터는 무시됩니다', { memory_types });
-                }
-                const coreMemoryRepository = new CoreMemoryRepository(context.db);
-                const { getCoreMemoryCache } = await import('../services/core-memory-cache-service.js');
-                const coreMemoryCache = getCoreMemoryCache();
-                const coreMemoryService = new CoreMemoryService(coreMemoryRepository, coreMemoryCache);
-                let records;
-                if (key) {
-                    // 특정 키 조회
-                    const record = await coreMemoryService.findByKey(agentId, key);
-                    records = record ? [record] : [];
-                }
-                else {
-                    // 전체 Core Memory 조회
-                    records = await coreMemoryService.findByAgentId(agentId);
-                }
-                const executionTime = Date.now() - startTime;
-                const processedResults = records.map(record => ({
-                    memory_id: record.core_id,
-                    type: 'core',
-                    key: record.key,
-                    value: record.value,
-                    always_load: record.always_load,
-                    origin_source: record.origin_source ? JSON.parse(record.origin_source) : null,
-                    created_at: record.created_at,
-                    updated_at: record.updated_at
-                }));
-                return this.createSuccessResult({
-                    items: processedResults,
-                    total_count: processedResults.length,
-                    query_time: executionTime,
-                    search_type: 'direct'
-                });
-            }
-            else if (validatedType === 'vault') {
-                // Knowledge Vault 조회
-                if (query) {
-                    this.logWarning('type="vault"일 때 query 파라미터는 무시됩니다', { query });
-                }
-                if (memory_types && memory_types.length > 0) {
-                    this.logWarning('type="vault"일 때 memory_types 파라미터는 무시됩니다', { memory_types });
-                }
-                const knowledgeVaultRepository = new KnowledgeVaultRepository(context.db);
-                const knowledgeVaultService = new KnowledgeVaultService(knowledgeVaultRepository);
-                let records;
-                if (key) {
-                    // 특정 키 조회 (활성 버전만)
-                    const record = await knowledgeVaultService.findActiveByKey(agentId, key);
-                    records = record ? [record] : [];
-                }
-                else {
-                    // 전체 Vault 조회 (활성 버전만)
-                    records = await knowledgeVaultService.findActiveByAgentId(agentId);
-                }
-                const executionTime = Date.now() - startTime;
-                const processedResults = records.map(record => ({
-                    memory_id: record.vault_id,
-                    type: 'vault',
-                    key: record.key,
-                    value: record.value,
-                    immutable: record.immutable,
-                    version: record.version,
-                    origin_source: record.origin_source ? JSON.parse(record.origin_source) : null,
-                    created_at: record.created_at,
-                    updated_at: record.updated_at
-                }));
-                return this.createSuccessResult({
-                    items: processedResults,
-                    total_count: processedResults.length,
-                    query_time: executionTime,
-                    search_type: 'direct'
-                });
-            }
-            else {
-                // 기존 memory_item 검색 로직
-                // query 필수 검증
-                if (!query) {
-                    throw new Error("query 파라미터는 필수입니다 (type='core' 또는 'vault'가 아닌 경우)");
-                }
-                // 입력 검증
-                this.validateString(query, '검색 쿼리', 1000);
-                this.validateNumber(limit, '결과 제한', 1, 100);
-                // 하이브리드 검색 엔진 확인
-                this.validateService(context.services.hybridSearchEngine, '하이브리드 검색 엔진');
-                // type과 memory_types 동시 사용 시 경고
-                // 원래 type 파라미터가 제공되었는지 확인 (기본값이 아닌 경우)
-                if (originalTypeProvided && memory_types && memory_types.length > 0) {
-                    this.logWarning('type 파라미터와 memory_types를 동시에 사용했습니다. type 파라미터를 우선 적용하고 memory_types는 무시합니다.', {
-                        type: validatedType,
-                        memory_types
-                    });
-                }
-                // memory_types 배열 전처리 ('core'/'vault' 제거)
-                // 원래 type 파라미터가 제공되었는지 확인하여 fallback 동작 보장
-                let filteredMemoryTypes = originalTypeProvided ? (validatedType ? [validatedType] : undefined) : memory_types;
-                if (filteredMemoryTypes && filteredMemoryTypes.length > 0) {
-                    const invalidTypes = filteredMemoryTypes.filter(t => t === 'core' || t === 'vault');
-                    if (invalidTypes.length > 0) {
-                        this.logWarning('memory_types 배열에서 core/vault는 memory_item 검색에 사용할 수 없습니다. 자동으로 제거합니다.', {
-                            invalid_types: invalidTypes,
-                            original_memory_types: filteredMemoryTypes,
-                            suggestion: 'Core/Vault 조회는 단일 type 파라미터를 사용하세요.'
-                        });
-                        filteredMemoryTypes = filteredMemoryTypes.filter(t => t !== 'core' && t !== 'vault');
-                        if (filteredMemoryTypes.length === 0) {
-                            throw new Error("memory_types 배열에 유효한 타입이 없습니다. 'core'와 'vault'는 memory_types에서 사용할 수 없습니다. 단일 type 파라미터를 사용하여 Core/Vault를 조회하세요.");
-                        }
-                    }
-                    // 타입 가드 적용: MemoryTypeRequest[] -> MemoryType[]
-                    const validMemoryTypes = filteredMemoryTypes.filter((t) => isMemoryItemType(t));
-                    if (validMemoryTypes.length === 0) {
-                        throw new Error("memory_types 배열에 유효한 타입이 없습니다.");
-                    }
-                    filteredMemoryTypes = validMemoryTypes;
-                }
-                // agent_id 파라미터 무시 경고
-                if (agent_id) {
-                    this.logWarning('memory_item 검색 시 agent_id 파라미터는 무시됩니다', { agent_id });
-                }
-                // 필터 객체 재구성
-                const filters = {
-                    type: filteredMemoryTypes,
-                    tags,
-                    privacy_scope,
-                    time_from,
-                    time_to,
-                    pinned,
-                    importance_min,
-                    importance_max,
-                    has_reflection_notes: params.has_reflection_notes
-                };
-                // 검색 옵션 설정
-                const vectorWeight = vector_weight ?? 0.6;
-                const textWeight = text_weight ?? 0.4;
-                const enableHybrid = enable_hybrid ?? true;
-                const includeMetadata = include_metadata ?? true;
-                // 가중치 정규화
-                const totalWeight = vectorWeight + textWeight;
-                const normalizedVectorWeight = totalWeight > 0 ? vectorWeight / totalWeight : 0.6;
-                const normalizedTextWeight = totalWeight > 0 ? textWeight / totalWeight : 0.4;
-                let searchResult;
-                try {
-                    if (enableHybrid && context.services.hybridSearchEngine.isEmbeddingAvailable()) {
-                        // 하이브리드 검색 (텍스트 + 벡터)
-                        this.logInfo('하이브리드 검색 실행', {
-                            query,
-                            vectorWeight: normalizedVectorWeight,
-                            textWeight: normalizedTextWeight
-                        });
-                        // provider_filter는 zod 스키마에서 이미 EmbeddingProvider[] 타입으로 파싱됨
-                        // 빈 배열인 경우 undefined로 처리하여 모든 provider 검색
-                        const providerFilter = normalizeProviderFilter(provider_filter);
-                        searchResult = await context.services.hybridSearchEngine.search(context.db, {
-                            query,
-                            filters,
-                            limit,
-                            vectorWeight: normalizedVectorWeight,
-                            textWeight: normalizedTextWeight,
-                            provider_filter: providerFilter
-                        });
-                    }
-                    else {
-                        // 텍스트 검색만 사용
-                        if (!context.services.searchEngine) {
-                            throw new Error('텍스트 검색 엔진을 사용할 수 없습니다');
-                        }
-                        this.logInfo('텍스트 검색 실행', { query });
-                        searchResult = await context.services.searchEngine.search(context.db, {
-                            query,
-                            filters,
-                            limit
-                        });
-                    }
-                }
-                catch (searchError) {
-                    this.logError(searchError, '검색 실행 중 오류', { query, enableHybrid });
-                    throw new Error(`검색 실행 실패: ${searchError.message}`);
-                }
-                const executionTime = Date.now() - startTime;
-                // 검색 결과 가져오기
-                const searchItems = searchResult?.items || [];
-                // Consolidation Score System 업데이트 (기능 플래그 확인)
-                if (mementoConfig.consolidationScoreEnabled && context.services.consolidationScoreService && searchItems.length > 0) {
-                    await this.updateConsolidationScoreMetadata(context.db, context.services.consolidationScoreService, context.services.writeCoalescingManager, searchItems);
-                }
-                // 결과 후처리 - searchResult가 undefined인 경우 처리
-                const processedResults = this.processSearchResults(searchItems, includeMetadata);
-                this.logInfo('검색 완료', {
-                    resultCount: processedResults.length,
-                    executionTime,
-                    searchType: enableHybrid ? 'hybrid' : 'text'
-                });
-                return this.createSuccessResult({
-                    items: processedResults,
-                    total_count: searchResult?.total_count || processedResults.length,
-                    query_time: executionTime,
-                    search_type: enableHybrid ? 'hybrid' : 'text',
-                    vector_search_available: context.services.hybridSearchEngine?.isEmbeddingAvailable() || false,
-                    filters_applied: this.getAppliedFilters(filters),
-                    search_options: {
-                        vector_weight: normalizedVectorWeight,
-                        text_weight: normalizedTextWeight,
-                        enable_hybrid: enableHybrid
-                    }
-                });
-            }
-        }
-        catch (error) {
-            this.logError(error, 'Recall 도구 실행 실패', { params });
-            // 실패 감지 훅 호출
-            const executionTime = Date.now() - startTime;
-            await this.handleFailure(error instanceof Error ? error : new Error(String(error)), params, context, executionTime);
-            // 사용자 친화적인 에러 메시지 반환
-            if (error instanceof Error) {
-                if (error.message.includes('validation')) {
-                    throw new Error(`입력 검증 실패: ${error.message}`);
-                }
-                else if (error.message.includes('database')) {
-                    throw new Error(`데이터베이스 오류: ${error.message}`);
-                }
-                else if (error.message.includes('search')) {
-                    throw new Error(`검색 오류: ${error.message}`);
-                }
-            }
-            throw error;
-        }
-    }
-    /**
-     * 검색 결과 후처리
-     */
-    processSearchResults(items, includeMetadata) {
-        return items.map(item => {
-            const processed = {
-                memory_id: item.id || item.memory_id, // 통일된 필드명 사용
-                id: item.id, // 하위 호환성을 위해 유지
-                content: item.content,
-                type: item.type,
-                importance: item.importance,
-                created_at: item.created_at,
-                final_score: item.finalScore || item.score || 0
-            };
-            if (includeMetadata) {
-                processed.last_accessed = item.last_accessed;
-                processed.pinned = item.pinned;
-                processed.tags = item.tags;
-                processed.source = item.source;
-                processed.privacy_scope = item.privacy_scope;
-                // origin_source 필드 추가 (JSON 파싱)
-                if (item.origin_source) {
-                    try {
-                        processed.origin_source = typeof item.origin_source === 'string'
-                            ? JSON.parse(item.origin_source)
-                            : item.origin_source;
-                    }
-                    catch (error) {
-                        // JSON 파싱 실패 시 원본 문자열 반환
-                        processed.origin_source = item.origin_source;
-                    }
-                }
-                // Procedural Memory 전용 필드 추가
-                if (item.type === 'procedural') {
-                    processed.task_goal = item.task_goal || null;
-                    processed.steps = item.steps || null;
-                    // reflection_notes 필드 추가 (JSON 파싱)
-                    if (item.reflection_notes) {
-                        try {
-                            // reflection_notes JSON 파싱 (문자열 → 객체/배열 변환)
-                            processed.reflection_notes = typeof item.reflection_notes === 'string'
-                                ? JSON.parse(item.reflection_notes)
-                                : item.reflection_notes;
-                        }
-                        catch (error) {
-                            // JSON 파싱 실패 시 원본 문자열 반환
-                            processed.reflection_notes = item.reflection_notes;
-                        }
-                    }
-                    else {
-                        processed.reflection_notes = null;
-                    }
-                }
-                if (item.textScore !== undefined) {
-                    processed.text_score = item.textScore;
-                }
-                if (item.vectorScore !== undefined) {
-                    processed.vector_score = item.vectorScore;
-                }
-                if (item.recall_reason) {
-                    processed.recall_reason = item.recall_reason;
-                }
-                // Consolidation Score 포함 (기능 플래그 활성화 시)
-                if (mementoConfig.consolidationScoreEnabled && item.consolidation_score !== undefined) {
-                    processed.consolidation_score = item.consolidation_score;
-                }
-            }
-            return processed;
-        });
-    }
-    /**
-     * 적용된 필터 정보 반환
-     */
-    getAppliedFilters(filters) {
-        if (!filters)
-            return {};
-        const applied = {};
-        if (filters.type && filters.type.length > 0) {
-            applied.type = filters.type;
-        }
-        if (filters.tags && filters.tags.length > 0) {
-            applied.tags = filters.tags;
-        }
-        if (filters.privacy_scope && filters.privacy_scope.length > 0) {
-            applied.privacy_scope = filters.privacy_scope;
-        }
-        if (filters.time_from) {
-            applied.time_from = filters.time_from;
-        }
-        if (filters.time_to) {
-            applied.time_to = filters.time_to;
-        }
-        if (filters.pinned !== undefined) {
-            applied.pinned = filters.pinned;
-        }
-        if (filters.importance_min !== undefined) {
-            applied.importance_min = filters.importance_min;
-        }
-        if (filters.importance_max !== undefined) {
-            applied.importance_max = filters.importance_max;
-        }
-        if (filters.has_reflection_notes !== undefined) {
-            applied.has_reflection_notes = filters.has_reflection_notes;
-        }
-        return applied;
-    }
-    /**
-     * 검색 쿼리 검증
-     */
-    validateQuery(query) {
-        if (!query || query.trim().length === 0) {
-            throw new Error('검색 쿼리는 비어있을 수 없습니다');
-        }
-        if (query.length > 1000) {
-            throw new Error('검색 쿼리가 너무 깁니다 (최대 1000자)');
-        }
-        // 특수 문자 검증
-        const dangerousPatterns = [
-            /<script/i,
-            /javascript:/i,
-            /on\w+\s*=/i
-        ];
-        for (const pattern of dangerousPatterns) {
-            if (pattern.test(query)) {
-                throw new Error('검색 쿼리에 허용되지 않는 문자가 포함되어 있습니다');
-            }
-        }
-    }
-    /**
-     * 필터 검증
-     */
-    validateFilters(filters) {
-        if (!filters)
-            return;
-        // 시간 범위 검증
-        if (filters.time_from && filters.time_to) {
-            const fromDate = new Date(filters.time_from);
-            const toDate = new Date(filters.time_to);
-            if (isNaN(fromDate.getTime()) || isNaN(toDate.getTime())) {
-                throw new Error('유효하지 않은 시간 형식입니다');
-            }
-            if (fromDate > toDate) {
-                throw new Error('시작 시간은 종료 시간보다 이전이어야 합니다');
-            }
-        }
-        // 중요도 범위 검증
-        if (filters.importance_min !== undefined && filters.importance_max !== undefined) {
-            if (filters.importance_min > filters.importance_max) {
-                throw new Error('최소 중요도는 최대 중요도보다 작거나 같아야 합니다');
-            }
-        }
-    }
-    /**
-     * Consolidation Score 메타데이터 업데이트
-     * 검색 결과로 반환된 메모리들의 recall_count, last_accessed_at, g_value 업데이트
-     * Write Coalescing을 사용하여 I/O 부하를 줄입니다.
-     *
-     * @param db 데이터베이스 연결
-     * @param consolidationScoreService Consolidation Score 서비스
-     * @param writeCoalescingManager Write Coalescing Manager (선택적)
-     * @param searchItems 검색 결과 아이템 배열
-     */
-    async updateConsolidationScoreMetadata(db, consolidationScoreService, writeCoalescingManager, searchItems) {
-        if (!searchItems || searchItems.length === 0) {
-            return;
-        }
-        try {
-            const now = new Date();
-            const nowISO = now.toISOString();
-            // 각 검색 결과에 대해 업데이트
-            for (const item of searchItems) {
-                const memoryId = item.id || item.memory_id;
-                if (!memoryId) {
-                    continue; // ID가 없으면 스킵
-                }
-                try {
-                    // 기존 메모리 정보 조회 (recall_count, last_accessed_at, g_value, created_at, type, pinned)
-                    const memory = DatabaseUtils.get(db, `SELECT 
-              recall_count, 
-              last_accessed_at, 
-              g_value, 
-              created_at, 
-              type, 
-              pinned 
-            FROM memory_item 
-            WHERE id = ?`, [memoryId]);
-                    if (!memory) {
-                        this.logWarning(`메모리를 찾을 수 없습니다: ${memoryId}`);
-                        continue;
-                    }
-                    // recall_count 증가
-                    const newRecallCount = (memory.recall_count || 0) + 1;
-                    // 경과 시간 계산 (last_accessed_at이 있으면 사용, 없으면 created_at 사용)
-                    const lastAccessedAt = memory.last_accessed_at
-                        ? new Date(memory.last_accessed_at)
-                        : new Date(memory.created_at);
-                    const timeElapsed = consolidationScoreService.calculateTimeElapsed(lastAccessedAt, new Date(memory.created_at), now);
-                    // g_value 업데이트
-                    const newGValue = consolidationScoreService.updateGValueForRecall({
-                        previousGValue: memory.g_value,
-                        timeElapsed
-                    });
-                    // consolidation_score 계산
-                    const scoreResult = consolidationScoreService.calculateScore({
-                        recallCount: newRecallCount,
-                        lastAccessedAt: now,
-                        createdAt: new Date(memory.created_at),
-                        gValue: newGValue,
-                        type: memory.type,
-                        pinned: memory.pinned === 1 || memory.pinned === true
-                    });
-                    // Write Coalescing 사용 여부 확인
-                    if (writeCoalescingManager) {
-                        // 버퍼에 추가 (주기적으로 flush됨)
-                        writeCoalescingManager.addWrite({
-                            memoryId,
-                            fields: {
-                                recall_count: newRecallCount,
-                                last_accessed_at: nowISO,
-                                g_value: newGValue,
-                                consolidation_score: scoreResult.score
-                            }
-                        });
-                    }
-                    else {
-                        // Write Coalescing이 없으면 즉시 업데이트
-                        DatabaseUtils.run(db, `UPDATE memory_item 
-               SET 
-                 recall_count = ?,
-                 last_accessed_at = ?,
-                 g_value = ?,
-                 consolidation_score = ?
-               WHERE id = ?`, [newRecallCount, nowISO, newGValue, scoreResult.score, memoryId]);
-                    }
-                }
-                catch (error) {
-                    // 개별 메모리 업데이트 실패해도 다른 메모리는 계속 업데이트
-                    this.logWarning(`메모리 업데이트 실패 (${memoryId})`, {
-                        error: error instanceof Error ? error.message : String(error)
-                    });
-                }
-            }
-        }
-        catch (error) {
-            // 전체 업데이트 실패해도 검색 결과는 정상 반환
-            this.logError(error, 'Consolidation Score 메타데이터 업데이트 실패', {
-                itemCount: searchItems.length
-            });
-        }
-    }
-}
-//# sourceMappingURL=recall-tool.js.map