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

package/dist/services/relation-extractor.d.ts

@@ -1,73 +0,0 @@
-/**
- * 관계 추출 메인 서비스
- * 하이브리드 방식으로 관계를 추출합니다 (규칙 기반 → LLM fallback)
- *
- * 추출 전략:
- * 1. 규칙 기반 추출 시도 (빠르고 비용 효율적)
- * 2. 규칙 기반 결과가 없거나 신뢰도가 낮으면 LLM fallback
- * 3. 타입별 관계 유형 필터링 적용
- */
-import type { RelationCandidate, IRelationExtractor, ExtractOptions } from '../types/relation.js';
-import type { MemoryItem } from '../types/index.js';
-import { RuleBasedRelationExtractor } from './rule-based-relation-extractor.js';
-import { LLMBasedRelationExtractor } from './llm-based-relation-extractor.js';
-/**
- * 관계 추출 메인 서비스
- */
-export declare class RelationExtractor implements IRelationExtractor {
-    private readonly ruleExtractor;
-    private readonly llmExtractor;
-    private readonly cache;
-    constructor(ruleExtractor?: RuleBasedRelationExtractor, llmExtractor?: LLMBasedRelationExtractor);
-    /**
-     * 새로운 기억과 기존 기억들 간의 관계를 추출합니다.
-     * 하이브리드 방식: 규칙 기반 먼저 시도, 실패 시 LLM fallback
-     *
-     * @param newMemory 새로운 기억
-     * @param existingMemories 기존 기억 목록
-     * @param options 추출 옵션
-     * @returns 관계 후보 목록
-     */
-    extractRelations(newMemory: MemoryItem, existingMemories: MemoryItem[], options?: ExtractOptions): Promise<RelationCandidate[]>;
-    /**
-     * 기억 타입에 적용 가능한 관계 유형을 반환합니다.
-     *
-     * @param memoryType 기억 타입
-     * @param requestedTypes 요청된 관계 유형 (없으면 모든 적용 가능한 타입 반환)
-     * @returns 적용 가능한 관계 유형 목록
-     */
-    private getApplicableRelationTypes;
-    /**
-     * 규칙 기반 결과와 LLM 결과를 병합합니다.
-     * 동일한 관계 (source_id, target_id, relation_type이 동일)는 중복 제거하고,
-     * 신뢰도가 높은 것을 우선합니다.
-     *
-     * @param ruleCandidates 규칙 기반 결과
-     * @param llmCandidates LLM 결과
-     * @returns 병합된 결과
-     */
-    private mergeCandidates;
-    /**
-     * 캐시 키 생성
-     * 공통 유틸리티를 사용하여 일관된 캐시 키를 생성합니다.
-     *
-     * @param newMemoryId 새로운 기억 ID
-     * @param existingMemoryIds 기존 기억 ID 목록
-     * @param options 추출 옵션
-     * @returns 캐시 키
-     */
-    private generateCacheKey;
-    /**
-     * 배치 관계 추출 (여러 기억을 묶어서 처리)
-     * 비동기 배치 처리로 성능 최적화
-     *
-     * @param newMemories 새로운 기억 목록
-     * @param existingMemories 기존 기억 목록
-     * @param options 추출 옵션 (batchSize 포함 가능)
-     * @returns 각 새로운 기억별 관계 후보 맵
-     */
-    extractRelationsBatch(newMemories: MemoryItem[], existingMemories: MemoryItem[], options?: ExtractOptions & {
-        batchSize?: number;
-    }): Promise<Map<string, RelationCandidate[]>>;
-}
-//# sourceMappingURL=relation-extractor.d.ts.map

package/dist/services/relation-extractor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"relation-extractor.d.ts","sourceRoot":"","sources":["../../src/services/relation-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,iBAAiB,EAEjB,kBAAkB,EAClB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAM9E;;GAEG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;gBAGxD,aAAa,CAAC,EAAE,0BAA0B,EAC1C,YAAY,CAAC,EAAE,yBAAyB;IAQ1C;;;;;;;;OAQG;IACG,gBAAgB,CACpB,SAAS,EAAE,UAAU,EACrB,gBAAgB,EAAE,UAAU,EAAE,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA2H/B;;;;;;OAMG;IACH,OAAO,CAAC,0BAA0B;IAclC;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IA0BvB;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;;;;;OAQG;IACG,qBAAqB,CACzB,WAAW,EAAE,UAAU,EAAE,EACzB,gBAAgB,EAAE,UAAU,EAAE,EAC9B,OAAO,CAAC,EAAE,cAAc,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAChD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;CAkC7C"}

package/dist/services/relation-extractor.js

@@ -1,231 +0,0 @@
-/**
- * 관계 추출 메인 서비스
- * 하이브리드 방식으로 관계를 추출합니다 (규칙 기반 → LLM fallback)
- *
- * 추출 전략:
- * 1. 규칙 기반 추출 시도 (빠르고 비용 효율적)
- * 2. 규칙 기반 결과가 없거나 신뢰도가 낮으면 LLM fallback
- * 3. 타입별 관계 유형 필터링 적용
- */
-import { isApplicableRelationType, MEMORY_TYPE_RELATION_MAP } from '../types/relation.js';
-import { RuleBasedRelationExtractor } from './rule-based-relation-extractor.js';
-import { LLMBasedRelationExtractor } from './llm-based-relation-extractor.js';
-import { CacheService } from './cache-service.js';
-import { logger } from '../utils/logger.js';
-import { CacheKeyGenerator } from '../utils/cache-key-generator.js';
-import { CONFIDENCE, LIMITS, CACHE } from '../constants/relation-constants.js';
-/**
- * 관계 추출 메인 서비스
- */
-export class RelationExtractor {
-    ruleExtractor;
-    llmExtractor;
-    cache;
-    constructor(ruleExtractor, llmExtractor) {
-        this.ruleExtractor = ruleExtractor ?? new RuleBasedRelationExtractor();
-        this.llmExtractor = llmExtractor ?? new LLMBasedRelationExtractor();
-        // 캐시: 1000개 항목, 7일 TTL
-        this.cache = new CacheService(CACHE.EXTRACTION_SIZE, CACHE.EXTRACTION_TTL_MS);
-    }
-    /**
-     * 새로운 기억과 기존 기억들 간의 관계를 추출합니다.
-     * 하이브리드 방식: 규칙 기반 먼저 시도, 실패 시 LLM fallback
-     *
-     * @param newMemory 새로운 기억
-     * @param existingMemories 기존 기억 목록
-     * @param options 추출 옵션
-     * @returns 관계 후보 목록
-     */
-    async extractRelations(newMemory, existingMemories, options) {
-        if (existingMemories.length === 0) {
-            return [];
-        }
-        const method = options?.method ?? 'hybrid';
-        const minConfidence = options?.minConfidence ?? CONFIDENCE.MIN_RULE_BASED;
-        const immediate = options?.immediate ?? false;
-        // 타입별 관계 유형 필터링
-        const applicableTypes = this.getApplicableRelationTypes(newMemory.type, options?.relationTypes);
-        if (applicableTypes.length === 0) {
-            return [];
-        }
-        // 캐시 키 생성 (즉시 처리인 경우에만 캐싱)
-        if (immediate) {
-            const cacheKey = this.generateCacheKey(newMemory.id, existingMemories.map(m => m.id), options);
-            const cached = this.cache.get(cacheKey);
-            if (cached) {
-                logger.debug('관계 추출 캐시 히트', { cacheKey });
-                return cached;
-            }
-        }
-        // 관계 유형 필터링이 포함된 옵션 생성
-        // MiniLM 기반 후보 필터링을 위해 candidateLimit 기본값 설정
-        const extractOptions = {
-            ...options,
-            relationTypes: applicableTypes,
-            candidateLimit: options?.candidateLimit ?? LIMITS.LLM_CANDIDATE_DEFAULT // MiniLM 필터링을 위한 기본값
-        };
-        // 추출 방법에 따라 분기
-        if (method === 'rule') {
-            return await this.ruleExtractor.extractRelations(newMemory, existingMemories, extractOptions);
-        }
-        if (method === 'llm') {
-            // LLM만 사용하는 경우, LLM이 사용 가능한지 확인
-            if (!this.llmExtractor.isAvailable()) {
-                throw new Error('LLM 서비스가 사용 불가능합니다. 규칙 기반 추출을 사용하거나 API 키를 설정해주세요.');
-            }
-            return await this.llmExtractor.extractRelations(newMemory, existingMemories, extractOptions);
-        }
-        // hybrid 방식: 규칙 기반 먼저 시도
-        const ruleCandidates = await this.ruleExtractor.extractRelations(newMemory, existingMemories, extractOptions);
-        // 규칙 기반 결과 평가
-        const hasHighConfidenceResults = ruleCandidates.some(c => c.confidence >= minConfidence);
-        const hasAnyResults = ruleCandidates.length > 0;
-        // 규칙 기반 결과가 충분하면 반환
-        if (hasHighConfidenceResults) {
-            logger.info('규칙 기반 추출 성공', {
-                relationCount: ruleCandidates.length,
-                memoryId: newMemory.id
-            });
-            const filtered = ruleCandidates.filter(c => c.confidence >= minConfidence);
-            // 캐시 저장 (즉시 처리인 경우에만)
-            if (immediate) {
-                const cacheKey = this.generateCacheKey(newMemory.id, existingMemories.map(m => m.id), options);
-                this.cache.set(cacheKey, filtered);
-            }
-            return filtered;
-        }
-        // 규칙 기반 결과가 없거나 신뢰도가 낮으면 LLM fallback
-        if (!hasAnyResults || !hasHighConfidenceResults) {
-            // LLM이 사용 가능한지 확인
-            if (!this.llmExtractor.isAvailable()) {
-                logger.info('LLM 서비스가 사용 불가능하여 규칙 기반 결과 반환', { memoryId: newMemory.id });
-                return ruleCandidates;
-            }
-            logger.info('규칙 기반 결과 부족, LLM fallback 시도', {
-                ruleCandidateCount: ruleCandidates.length,
-                memoryId: newMemory.id
-            });
-            try {
-                const llmCandidates = await this.llmExtractor.extractRelations(newMemory, existingMemories, extractOptions);
-                // LLM 결과와 규칙 기반 결과 병합 (중복 제거)
-                const mergedCandidates = this.mergeCandidates(ruleCandidates, llmCandidates);
-                const filtered = mergedCandidates.filter(c => c.confidence >= minConfidence);
-                logger.info('LLM fallback 완료', {
-                    totalRelations: filtered.length,
-                    memoryId: newMemory.id
-                });
-                // 캐시 저장 (즉시 처리인 경우에만)
-                if (immediate) {
-                    const cacheKey = this.generateCacheKey(newMemory.id, existingMemories.map(m => m.id), options);
-                    this.cache.set(cacheKey, filtered);
-                }
-                return filtered;
-            }
-            catch (error) {
-                logger.error('LLM fallback 실패, 규칙 기반 결과 반환', {
-                    error: error instanceof Error ? error.message : String(error),
-                    memoryId: newMemory.id
-                });
-                return ruleCandidates;
-            }
-        }
-        return ruleCandidates;
-    }
-    /**
-     * 기억 타입에 적용 가능한 관계 유형을 반환합니다.
-     *
-     * @param memoryType 기억 타입
-     * @param requestedTypes 요청된 관계 유형 (없으면 모든 적용 가능한 타입 반환)
-     * @returns 적용 가능한 관계 유형 목록
-     */
-    getApplicableRelationTypes(memoryType, requestedTypes) {
-        const defaultTypes = MEMORY_TYPE_RELATION_MAP[memoryType];
-        if (!requestedTypes) {
-            return defaultTypes;
-        }
-        // 요청된 타입 중에서 적용 가능한 타입만 필터링
-        return requestedTypes.filter(type => isApplicableRelationType(memoryType, type));
-    }
-    /**
-     * 규칙 기반 결과와 LLM 결과를 병합합니다.
-     * 동일한 관계 (source_id, target_id, relation_type이 동일)는 중복 제거하고,
-     * 신뢰도가 높은 것을 우선합니다.
-     *
-     * @param ruleCandidates 규칙 기반 결과
-     * @param llmCandidates LLM 결과
-     * @returns 병합된 결과
-     */
-    mergeCandidates(ruleCandidates, llmCandidates) {
-        const merged = new Map();
-        // 규칙 기반 결과 추가
-        for (const candidate of ruleCandidates) {
-            const key = `${candidate.source_id}:${candidate.target_id}:${candidate.relation_type}`;
-            merged.set(key, candidate);
-        }
-        // LLM 결과 추가 (중복이면 신뢰도가 높은 것으로 교체)
-        for (const candidate of llmCandidates) {
-            const key = `${candidate.source_id}:${candidate.target_id}:${candidate.relation_type}`;
-            const existing = merged.get(key);
-            if (!existing || candidate.confidence > existing.confidence) {
-                merged.set(key, candidate);
-            }
-        }
-        // 신뢰도 내림차순 정렬
-        return Array.from(merged.values()).sort((a, b) => b.confidence - a.confidence);
-    }
-    /**
-     * 캐시 키 생성
-     * 공통 유틸리티를 사용하여 일관된 캐시 키를 생성합니다.
-     *
-     * @param newMemoryId 새로운 기억 ID
-     * @param existingMemoryIds 기존 기억 ID 목록
-     * @param options 추출 옵션
-     * @returns 캐시 키
-     */
-    generateCacheKey(newMemoryId, existingMemoryIds, options) {
-        return CacheKeyGenerator.generateRelationExtractionKey(newMemoryId, existingMemoryIds, {
-            method: options?.method,
-            minConfidence: options?.minConfidence,
-            candidateLimit: options?.candidateLimit,
-            relationTypes: options?.relationTypes,
-            immediate: options?.immediate
-        });
-    }
-    /**
-     * 배치 관계 추출 (여러 기억을 묶어서 처리)
-     * 비동기 배치 처리로 성능 최적화
-     *
-     * @param newMemories 새로운 기억 목록
-     * @param existingMemories 기존 기억 목록
-     * @param options 추출 옵션 (batchSize 포함 가능)
-     * @returns 각 새로운 기억별 관계 후보 맵
-     */
-    async extractRelationsBatch(newMemories, existingMemories, options) {
-        const results = new Map();
-        // 배치 크기를 옵션에서 가져오거나, 환경 변수에서 가져오거나, 기본값 사용
-        const batchSize = options?.batchSize ??
-            (process.env.RELATION_EXTRACT_BATCH_SIZE ? parseInt(process.env.RELATION_EXTRACT_BATCH_SIZE, 10) : LIMITS.BATCH_SIZE_DEFAULT);
-        const batches = [];
-        // 배치로 나누기
-        for (let i = 0; i < newMemories.length; i += batchSize) {
-            batches.push(newMemories.slice(i, i + batchSize));
-        }
-        // 각 배치 처리 (병렬 처리)
-        for (const batch of batches) {
-            const promises = batch.map(memory => this.extractRelations(memory, existingMemories, {
-                ...options,
-                immediate: true // 배치 처리 시 캐싱 활성화
-            }));
-            const batchResults = await Promise.all(promises);
-            for (let i = 0; i < batch.length && i < batchResults.length; i++) {
-                const memory = batch[i];
-                const result = batchResults[i];
-                if (memory && result) {
-                    results.set(memory.id, result);
-                }
-            }
-        }
-        return results;
-    }
-}
-//# sourceMappingURL=relation-extractor.js.map

package/dist/services/relation-extractor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"relation-extractor.js","sourceRoot":"","sources":["../../src/services/relation-extractor.ts"],"names":[],"mappings":"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"}

package/dist/services/relation-graph.d.ts

@@ -1,275 +0,0 @@
-/**
- * 관계 그래프 서비스
- * 기억 간의 관계를 저장하고 관리하는 서비스
- *
- * 주요 기능:
- * - 관계 추가/삭제/조회
- * - 순환 참조 감지 (DFS)
- * - N-hop 관계 탐색 (BFS)
- * - 신뢰도 갱신
- * - 캐싱 계층 (L1: MemoryCache 10분, L2: PersistentCache 7일)
- * - 배치 삽입 최적화
- */
-import Database from 'better-sqlite3';
-import type { MemoryRelation, RelationMetadata, GetRelationsOptions, GetRelatedMemoriesOptions, AddRelationOptions, IRelationGraph } from '../types/relation-graph.js';
-import type { RelationType } from '../types/relation.js';
-/**
- * 관계 그래프 서비스
- */
-export declare class RelationGraph implements IRelationGraph {
-    private db;
-    private l1Cache;
-    private l2Cache;
-    private cacheKeyIndex;
-    constructor(db: Database.Database);
-    /**
-     * 관계 추가
-     * UNIQUE 제약 검증 및 순환 참조 감지를 수행합니다.
-     *
-     * 트랜잭션 내에서 실행하여 순환 참조 감지와 관계 추가를 원자적으로 처리합니다.
-     * 이를 통해 경쟁 조건을 방지하고 일관성을 보장합니다.
-     *
-     * @param sourceId 소스 기억 ID
-     * @param targetId 타겟 기억 ID
-     * @param relationType 관계 유형
-     * @param options 추가 옵션
-     * @returns 추가된 관계 ID
-     */
-    addRelation(sourceId: string, targetId: string, relationType: RelationType, options?: AddRelationOptions): Promise<number>;
-    /**
-     * 관계 추가 내부 로직
-     * 기존 관계 확인 및 새 관계 추가를 수행합니다.
-     *
-     * @param sourceId 소스 기억 ID
-     * @param targetId 타겟 기억 ID
-     * @param relationType 관계 유형
-     * @param confidence 신뢰도
-     * @param metadata 메타데이터
-     * @param metadataJson 메타데이터 JSON 문자열
-     * @param updateOnConflict 충돌 시 업데이트 여부
-     * @param allowCyclic 순환 참조 허용 여부
-     * @returns 관계 ID
-     */
-    private addRelationInternal;
-    /**
-     * 관계 추가 에러 처리
-     * 동시성 문제로 인한 UNIQUE constraint 에러를 처리합니다.
-     *
-     * @param error 발생한 에러
-     * @param sourceId 소스 기억 ID
-     * @param targetId 타겟 기억 ID
-     * @param relationType 관계 유형
-     * @param confidence 신뢰도
-     * @param metadata 메타데이터
-     * @param updateOnConflict 충돌 시 업데이트 여부
-     * @returns 관계 ID 또는 에러를 throw
-     */
-    private handleRelationAddError;
-    /**
-     * 관계 입력 검증
-     *
-     * @param sourceId 소스 기억 ID
-     * @param targetId 타겟 기억 ID
-     */
-    private validateRelationInput;
-    /**
-     * 순환 참조 확인
-     * 트랜잭션 내에서 호출되는 경우 중첩 트랜잭션을 방지합니다.
-     * 트랜잭션 상태를 확인합니다.
-     *
-     * @param sourceId 소스 기억 ID
-     * @param targetId 타겟 기억 ID
-     * @param relationType 관계 유형
-     */
-    private checkForCyclicRelation;
-    /**
-     * 메타데이터 준비
-     *
-     * @param options 추가 옵션
-     * @param allowCyclic 순환 참조 허용 여부
-     * @returns 준비된 메타데이터
-     */
-    private prepareMetadata;
-    /**
-     * 기존 관계 조회
-     *
-     * @param sourceId 소스 기억 ID
-     * @param targetId 타겟 기억 ID
-     * @param relationType 관계 유형
-     * @returns 기존 관계 정보 또는 null
-     */
-    private findExistingRelation;
-    /**
-     * 기존 관계 처리
-     *
-     * @param existing 기존 관계 정보
-     * @param sourceId 소스 기억 ID
-     * @param targetId 타겟 기억 ID
-     * @param relationType 관계 유형
-     * @param confidence 신뢰도
-     * @param metadata 메타데이터
-     * @param updateOnConflict 충돌 시 업데이트 여부
-     * @returns 관계 ID
-     */
-    private handleExistingRelation;
-    /**
-     * 새 관계 추가
-     *
-     * @param sourceId 소스 기억 ID
-     * @param targetId 타겟 기억 ID
-     * @param relationType 관계 유형
-     * @param confidence 신뢰도
-     * @param metadataJson 메타데이터 JSON 문자열
-     * @param allowCyclic 순환 참조 허용 여부
-     * @returns 추가된 관계 ID
-     */
-    private insertNewRelation;
-    /**
-     * 순환 참조 플래그 업데이트
-     *
-     * @param relationId 관계 ID
-     */
-    private updateCyclicFlag;
-    /**
-     * 관계 조회
-     *
-     * @param memoryId 기억 ID
-     * @param options 조회 옵션
-     * @returns 관계 목록
-     */
-    getRelations(memoryId: string, options?: GetRelationsOptions): Promise<MemoryRelation[]>;
-    /**
-     * 관련 기억 조회 (N-hop 관계 탐색)
-     * BFS 알고리즘을 사용하여 N-hop 관계를 탐색합니다.
-     *
-     * @param memoryId 시작 기억 ID
-     * @param options 탐색 옵션
-     * @returns 관련 기억 ID 목록과 hop 거리
-     */
-    getRelatedMemories(memoryId: string, options?: GetRelatedMemoriesOptions): Promise<Array<{
-        memory_id: string;
-        hop_distance: number;
-        relation_path: Array<{
-            source_id: string;
-            target_id: string;
-            relation_type: RelationType;
-        }>;
-    }>>;
-    /**
-     * 관계 삭제
-     *
-     * @param sourceId 소스 기억 ID
-     * @param targetId 타겟 기억 ID
-     * @param relationType 관계 유형
-     * @returns 삭제 성공 여부
-     */
-    removeRelation(sourceId: string, targetId: string, relationType: RelationType): Promise<boolean>;
-    /**
-     * 신뢰도 갱신
-     *
-     * @param sourceId 소스 기억 ID
-     * @param targetId 타겟 기억 ID
-     * @param relationType 관계 유형
-     * @param newConfidence 새로운 신뢰도
-     * @param reason 갱신 이유
-     * @returns 갱신 성공 여부
-     */
-    updateConfidence(sourceId: string, targetId: string, relationType: RelationType, newConfidence: number, reason?: string): Promise<boolean>;
-    /**
-     * 순환 참조 감지 (DFS)
-     *
-     * 트랜잭션 내에서 실행하여 경쟁 조건을 방지합니다.
-     * 순환 참조 감지 중에 다른 프로세스/스레드에서 관계가 추가되는 것을 방지합니다.
-     * 트랜잭션 격리 수준을 사용합니다.
-     *
-     * 성능 최적화:
-     * - 최대 탐색 깊이 제한 (기본값: 10)
-     * - 대규모 그래프에서 무한 루프 방지
-     *
-     * @param sourceId 소스 기억 ID
-     * @param targetId 타겟 기억 ID
-     * @param relationType 관계 유형
-     * @param maxDepth 최대 탐색 깊이 (기본값: 10)
-     * @returns 순환 참조 여부
-     */
-    /**
-     * 순환 참조 감지 내부 로직 (트랜잭션 없이 실행)
-     *
-     * @param sourceId 소스 기억 ID
-     * @param targetId 타겟 기억 ID
-     * @param relationType 관계 유형
-     * @param maxDepth 최대 탐색 깊이
-     * @returns 순환 참조 여부
-     */
-    private detectCycleInternal;
-    /**
-     * 순환 참조 감지 (공개 메서드)
-     * 트랜잭션을 자동으로 관리합니다.
-     *
-     * @param sourceId 소스 기억 ID
-     * @param targetId 타겟 기억 ID
-     * @param relationType 관계 유형
-     * @param maxDepth 최대 탐색 깊이 (기본값: 10)
-     * @returns 순환 참조 여부
-     */
-    detectCycle(sourceId: string, targetId: string, relationType: RelationType, maxDepth?: number): Promise<boolean>;
-    /**
-     * 캐시 키 생성
-     * 공통 유틸리티를 사용하여 일관된 캐시 키를 생성합니다.
-     *
-     * @param memoryId 기억 ID
-     * @param options 조회 옵션
-     * @returns 캐시 키
-     */
-    private generateCacheKey;
-    /**
-     * 캐시 키를 인덱스에 추가
-     * 정확한 캐시 무효화를 위해 사용
-     *
-     * @param memoryId 기억 ID
-     * @param cacheKey 캐시 키
-     */
-    private addCacheKeyToIndex;
-    /**
-     * 캐시 무효화
-     * 특정 메모리 ID와 관련된 캐시를 정확하게 무효화합니다.
-     *
-     * 최적화 전략:
-     * 1. 캐시 키 인덱스를 우선 사용하여 O(1) 접근으로 정확한 캐시 키 삭제
-     * 2. 인덱스가 없는 경우에만 패턴 기반 삭제 수행 (fallback)
-     *
-     * 성능 고려사항:
-     * - 인덱스가 있는 경우: O(n) where n = 해당 memoryId의 캐시 키 수
-     * - 인덱스가 없는 경우: O(m) where m = 전체 캐시 키 수 (최악의 경우)
-     * - 일반적으로 인덱스가 있으므로 효율적
-     *
-     * @param memoryId 기억 ID
-     */
-    private invalidateCache;
-    /**
-     * 배치 관계 추가
-     * 여러 관계를 한 번에 추가하여 성능을 최적화합니다.
-     *
-     * @param relations 추가할 관계 목록
-     * @returns 배치 처리 결과 (성공한 관계 ID 목록 및 실패한 관계 정보)
-     */
-    addRelationsBatch(relations: Array<{
-        source_id: string;
-        target_id: string;
-        relation_type: RelationType;
-        confidence?: number;
-        metadata?: RelationMetadata;
-    }>): Promise<{
-        insertedIds: number[];
-        failed: Array<{
-            source_id: string;
-            target_id: string;
-            relation_type: RelationType;
-            error: string;
-        }>;
-        total: number;
-        success: number;
-        failedCount: number;
-    }>;
-}
-//# sourceMappingURL=relation-graph.d.ts.map

package/dist/services/relation-graph.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"relation-graph.d.ts","sourceRoot":"","sources":["../../src/services/relation-graph.ts"],"names":[],"mappings":"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"}