memento-mcp-server 1.13.1-a0 → 1.13.1-a3

package/dist/domains/anchor/services/anchor/anchor-search-service.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Anchor Search Service
+ * 검색 관련 로직 담당
+ * Phase 1.1: anchor-manager.ts 리팩토링
+ */
+import type Database from 'better-sqlite3';
+import type { HybridSearchEngine } from '../../../search/algorithms/hybrid-search-engine.js';
+import type { VectorSearchEngine } from '../../../search/algorithms/vector-search-engine.js';
+import type { IAnchorCacheService, IAnchorSearchService, IAnchorManager, SearchOptions, SearchResult, AnchorSlot } from './anchor-interfaces.js';
+import { RelationGraph } from '../../../relation/services/relation-graph.js';
+/**
+ * Anchor Search Service 구현
+ */
+export declare class AnchorSearchService implements IAnchorSearchService {
+    private db;
+    private cacheService;
+    private hybridSearchEngine;
+    private vectorSearchEngine;
+    private queryEmbeddingService;
+    private relationGraph;
+    /**
+     * 생성자
+     */
+    constructor(cacheService: IAnchorCacheService);
+    /**
+     * RelationGraph 설정 (선택적)
+     */
+    setRelationGraph(relationGraph: RelationGraph): void;
+    /**
+     * 데이터베이스 설정
+     */
+    setDatabase(db: Database.Database): void;
+    /**
+     * 하이브리드 검색 엔진 설정
+     */
+    setHybridSearchEngine(hybridSearchEngine: HybridSearchEngine): void;
+    /**
+     * 벡터 검색 엔진 설정
+     */
+    setVectorSearchEngine(vectorSearchEngine: VectorSearchEngine): void;
+    /**
+     * 국소 검색
+     * 앵커 메모리를 기준으로 N-hop 제한 검색 수행
+     */
+    searchLocal(agentId: string, slot: AnchorSlot, query: string | undefined, hopLimit: number | undefined, options: SearchOptions | undefined, anchorMemoryId: string, anchorEmbedding: {
+        embedding: number[];
+        provider: string;
+    }, startTime: number): Promise<SearchResult>;
+    /**
+     * 1-hop 검색: 앵커와 직접적으로 유사한 메모리 검색
+     */
+    private searchOneHop;
+    /**
+     * N-hop 검색: 앵커를 기준으로 최대 N-hop까지 확장 검색
+     */
+    private searchNHop;
+    /**
+     * 쿼리 기반 필터링
+     */
+    private filterByQuery;
+    /**
+     * 전역 검색으로 Fallback
+     */
+    fallbackToGlobalSearch(query: string, options: SearchOptions | undefined, startTime: number | undefined): Promise<SearchResult>;
+    /**
+     * memory_link 테이블을 활용한 직접 연결된 메모리 조회
+     */
+    /**
+     * 연결된 메모리 조회
+     * 관계 그래프가 있으면 우선 사용, 없으면 memory_link 사용
+     */
+    private getLinkedMemories;
+    /**
+     * 관계 유형별 부스트 가중치 반환
+     */
+    private getRelationTypeBoost;
+    /**
+     * 검색 결과 랭킹 점수 계산
+     * 관계 그래프와 벡터 유사도를 결합한 하이브리드 hop 점수 계산
+     * 관계가 있는 기억에 우선순위 부여
+     */
+    private calculateRankingScore;
+    /**
+     * 코사인 유사도 계산
+     */
+    private cosineSimilarity;
+    /**
+     * 슬롯별 설정 조회
+     */
+    private getSlotConfig;
+    /**
+     * 자동 앵커 이동 점수 계산
+     */
+    calculateReanchorScore(memoryId: string, queryEmbedding?: number[], anchorEmbedding?: number[]): Promise<number>;
+    /**
+     * 앵커 주변 메모리 사용 패턴 분석
+     */
+    analyzeAnchorUsage(agentId: string, slot: AnchorSlot, anchorMemoryId: string, anchorEmbedding: {
+        embedding: number[];
+        provider: string;
+    }, queryEmbedding?: number[]): Promise<Array<{
+        memory_id: string;
+        score: number;
+        reason: string;
+    }>>;
+    /**
+     * 앵커 이동 이유 생성
+     */
+    private generateReanchorReason;
+    /**
+     * 자동 앵커 이동 실행
+     */
+    autoReanchor(agentId: string, slot: AnchorSlot, anchorManager: IAnchorManager, queryEmbedding?: number[], threshold?: number, strategy?: 'gradual' | 'immediate'): Promise<{
+        moved: boolean;
+        old_anchor: string | null;
+        new_anchor: string | null;
+        score: number;
+        reason: string;
+    }>;
+    /**
+     * 검색 후 자동 앵커 이동 체크
+     */
+    checkAndAutoReanchor(agentId: string, slot: AnchorSlot, anchorManager: IAnchorManager, queryEmbedding?: number[], autoMoveEnabled?: boolean): Promise<{
+        moved: boolean;
+        old_anchor: string | null;
+        new_anchor: string | null;
+        score: number;
+        reason: string;
+    } | null>;
+}
+//# sourceMappingURL=anchor-search-service.d.ts.map

package/dist/domains/anchor/services/anchor/anchor-search-service.d.ts.map

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