memento-mcp-server 1.11.1 → 1.12.0-a

package/dist/database/migration/migrations/005-relation-engine-schema.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Migration: 005 - Relation Engine Schema
+ * Description: Create memory_relation and relation_type_registry tables for semantic relation engine
+ * Version: 5.0
+ * Date: 2025-01-XX
+ */
+import type Database from 'better-sqlite3';
+import type { Migration } from '../types.js';
+/**
+ * Relation Engine Schema Migration
+ *
+ * This migration:
+ * 1. Creates memory_relation table for storing semantic relations between memories
+ * 2. Creates relation_type_registry table for managing relation types
+ * 3. Creates indexes for performance optimization
+ * 4. Inserts initial relation types (CAUSES, DEPENDS_ON, FOLLOWS, CONTRASTS_WITH, REFERENCES, BELONGS_TO)
+ * 5. Migrates existing memory_link data to memory_relation
+ */
+export declare class RelationEngineSchemaMigration implements Migration {
+    version: string;
+    name: string;
+    description: string;
+    /**
+     * Load SQL file content
+     */
+    private loadSQLFile;
+    /**
+     * Execute SQL script
+     * Removes transaction commands (BEGIN TRANSACTION, COMMIT) as MigrationRunner manages transactions
+     */
+    private executeSQL;
+    /**
+     * Check if table exists
+     */
+    private tableExists;
+    /**
+     * Check if index exists
+     */
+    private indexExists;
+    /**
+     * Check if column exists in table
+     */
+    private columnExists;
+    /**
+     * Map old memory_link relation_type to new memory_relation relation_type
+     */
+    private mapRelationType;
+    /**
+     * Validate before migration
+     */
+    validateBefore(db: Database.Database): Promise<void>;
+    /**
+     * Execute migration (Up)
+     */
+    up(db: Database.Database): Promise<void>;
+    /**
+     * Rollback migration (Down)
+     */
+    down(db: Database.Database): Promise<void>;
+    /**
+     * Validate after migration
+     */
+    validateAfter(db: Database.Database): Promise<void>;
+}
+//# sourceMappingURL=005-relation-engine-schema.d.ts.map

package/dist/database/migration/migrations/005-relation-engine-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"005-relation-engine-schema.d.ts","sourceRoot":"","sources":["../../../../src/database/migration/migrations/005-relation-engine-schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAM7C;;;;;;;;;GASG;AACH,qBAAa,6BAA8B,YAAW,SAAS;IAC7D,OAAO,SAAS;IAChB,IAAI,SAA4B;IAChC,WAAW,SAA2F;IAEtG;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAsBlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B1D;;OAEG;IACG,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAkE9C;;OAEG;IACG,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBhD;;OAEG;IACG,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAsH1D"}

package/dist/database/migration/migrations/005-relation-engine-schema.js

@@ -0,0 +1,295 @@
+/**
+ * Migration: 005 - Relation Engine Schema
+ * Description: Create memory_relation and relation_type_registry tables for semantic relation engine
+ * Version: 5.0
+ * Date: 2025-01-XX
+ */
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { DependencyValidator } from '../dependency-validator.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Relation Engine Schema Migration
+ *
+ * This migration:
+ * 1. Creates memory_relation table for storing semantic relations between memories
+ * 2. Creates relation_type_registry table for managing relation types
+ * 3. Creates indexes for performance optimization
+ * 4. Inserts initial relation types (CAUSES, DEPENDS_ON, FOLLOWS, CONTRASTS_WITH, REFERENCES, BELONGS_TO)
+ * 5. Migrates existing memory_link data to memory_relation
+ */
+export class RelationEngineSchemaMigration {
+    version = '5.0';
+    name = 'relation-engine-schema';
+    description = 'Create memory_relation and relation_type_registry tables for semantic relation engine';
+    /**
+     * Load SQL file content
+     */
+    loadSQLFile(filename) {
+        const filePath = join(__dirname, filename);
+        return readFileSync(filePath, 'utf-8');
+    }
+    /**
+     * Execute SQL script
+     * Removes transaction commands (BEGIN TRANSACTION, COMMIT) as MigrationRunner manages transactions
+     */
+    executeSQL(db, sql) {
+        // MigrationRunner가 트랜잭션을 관리하므로 SQL에서 트랜잭션 명령 제거
+        let cleanedSQL = sql
+            // BEGIN TRANSACTION 제거
+            .replace(/BEGIN\s+TRANSACTION\s*;/gi, '')
+            // COMMIT 제거
+            .replace(/COMMIT\s*;/gi, '')
+            // PRAGMA foreign_keys 명령은 유지 (트랜잭션 외부에서도 작동)
+            .trim();
+        // 빈 줄 제거 및 정리
+        cleanedSQL = cleanedSQL
+            .split('\n')
+            .map(line => line.trim())
+            .filter(line => line.length > 0)
+            .join('\n');
+        if (cleanedSQL.length > 0) {
+            db.exec(cleanedSQL);
+        }
+    }
+    /**
+     * Check if table exists
+     */
+    tableExists(db, tableName) {
+        const result = db.prepare(`
+      SELECT name FROM sqlite_master 
+      WHERE type='table' AND name=?
+    `).get(tableName);
+        return !!result;
+    }
+    /**
+     * Check if index exists
+     */
+    indexExists(db, indexName) {
+        const result = db.prepare(`
+      SELECT name FROM sqlite_master 
+      WHERE type='index' AND name=?
+    `).get(indexName);
+        return !!result;
+    }
+    /**
+     * Check if column exists in table
+     */
+    columnExists(db, tableName, columnName) {
+        const columns = db.prepare(`PRAGMA table_info(${tableName})`).all();
+        return columns.some(col => col.name === columnName);
+    }
+    /**
+     * Map old memory_link relation_type to new memory_relation relation_type
+     */
+    mapRelationType(oldType) {
+        const mapping = {
+            'cause_of': 'CAUSES',
+            'derived_from': 'DEPENDS_ON',
+            'contradicts': 'CONTRASTS_WITH'
+            // 'duplicates'는 새로운 관계 유형으로 처리하지 않음 (제거)
+        };
+        return mapping[oldType] || null;
+    }
+    /**
+     * Validate before migration
+     */
+    async validateBefore(db) {
+        // Check if memory_item table exists (required for foreign key)
+        if (!this.tableExists(db, 'memory_item')) {
+            throw new Error('memory_item table does not exist. Cannot proceed with migration.');
+        }
+        // Check if migration has already been applied
+        if (this.tableExists(db, 'memento_schema_version')) {
+            const version = db.prepare(`
+        SELECT version FROM memento_schema_version WHERE version = ?
+      `).get('5.0');
+            if (version) {
+                throw new Error('Migration 005 has already been applied. Current schema version: 5.0');
+            }
+        }
+        // Check if memory_relation table already exists (should not exist)
+        if (this.tableExists(db, 'memory_relation')) {
+            throw new Error('memory_relation table already exists. Migration may have been partially applied.');
+        }
+        // Check if relation_type_registry table already exists (should not exist)
+        if (this.tableExists(db, 'relation_type_registry')) {
+            throw new Error('relation_type_registry table already exists. Migration may have been partially applied.');
+        }
+    }
+    /**
+     * Execute migration (Up)
+     */
+    async up(db) {
+        // 1. Load and execute SQL script
+        const sqlScript = this.loadSQLFile('005-relation-engine-schema.sql');
+        this.executeSQL(db, sqlScript);
+        // 2. Migrate existing memory_link data to memory_relation
+        if (this.tableExists(db, 'memory_link')) {
+            const memoryLinks = db.prepare(`
+        SELECT source_id, target_id, relation_type, created_at
+        FROM memory_link
+      `).all();
+            const insertStmt = db.prepare(`
+        INSERT INTO memory_relation (source_id, target_id, relation_type, confidence, created_at, updated_at, metadata)
+        VALUES (?, ?, ?, ?, ?, ?, ?)
+      `);
+            let migratedCount = 0;
+            for (const link of memoryLinks) {
+                const newRelationType = this.mapRelationType(link.relation_type);
+                // 매핑되지 않은 관계 유형은 건너뜀 (예: 'duplicates')
+                if (!newRelationType) {
+                    continue;
+                }
+                // 기본 신뢰도는 0.7, 메타데이터에 마이그레이션 정보 추가
+                const metadata = JSON.stringify({
+                    extraction_method: 'migration',
+                    migration_source: 'memory_link',
+                    original_relation_type: link.relation_type,
+                    migrated_at: new Date().toISOString()
+                });
+                try {
+                    insertStmt.run(link.source_id, link.target_id, newRelationType, 0.7, // default confidence
+                    link.created_at, link.created_at, // updated_at = created_at initially
+                    metadata);
+                    migratedCount++;
+                }
+                catch (error) {
+                    // UNIQUE 제약 위반 시 무시 (이미 존재하는 관계)
+                    if (error instanceof Error && error.message.includes('UNIQUE')) {
+                        continue;
+                    }
+                    throw error;
+                }
+            }
+            console.log(`[Migration 005] Migrated ${migratedCount} relations from memory_link to memory_relation`);
+        }
+        // Note: Schema version is recorded by MigrationRunner, not here
+        // MigrationRunner.recordVersion() will be called after successful migration
+    }
+    /**
+     * Rollback migration (Down)
+     */
+    async down(db) {
+        // Drop indexes first
+        const indexes = [
+            'idx_memory_relation_source',
+            'idx_memory_relation_target',
+            'idx_memory_relation_type',
+            'idx_memory_relation_confidence',
+            'idx_memory_relation_source_type',
+            'idx_memory_relation_target_type',
+            'idx_relation_type_registry_category'
+        ];
+        for (const indexName of indexes) {
+            db.exec(`DROP INDEX IF EXISTS ${indexName}`);
+        }
+        // Drop tables
+        db.exec('DROP TABLE IF EXISTS memory_relation');
+        db.exec('DROP TABLE IF EXISTS relation_type_registry');
+        // Remove schema version record
+        db.prepare('DELETE FROM memento_schema_version WHERE version = ?').run('5.0');
+    }
+    /**
+     * Validate after migration
+     */
+    async validateAfter(db) {
+        // Verify memory_relation table exists
+        if (!this.tableExists(db, 'memory_relation')) {
+            throw new Error('memory_relation table was not created');
+        }
+        // Verify relation_type_registry table exists
+        if (!this.tableExists(db, 'relation_type_registry')) {
+            throw new Error('relation_type_registry table was not created');
+        }
+        // Verify memory_relation table structure (check columns)
+        const relationColumns = db.prepare(`PRAGMA table_info(memory_relation)`).all();
+        const relationColumnNames = relationColumns.map(col => col.name);
+        const requiredRelationColumns = [
+            'id',
+            'source_id',
+            'target_id',
+            'relation_type',
+            'confidence',
+            'created_at',
+            'updated_at',
+            'metadata'
+        ];
+        for (const column of requiredRelationColumns) {
+            if (!relationColumnNames.includes(column)) {
+                throw new Error(`Column ${column} was not created in memory_relation table`);
+            }
+        }
+        // Verify relation_type_registry table structure (check columns)
+        const registryColumns = db.prepare(`PRAGMA table_info(relation_type_registry)`).all();
+        const registryColumnNames = registryColumns.map(col => col.name);
+        const requiredRegistryColumns = [
+            'type_name',
+            'category',
+            'description',
+            'applicable_types',
+            'default_confidence',
+            'search_boost',
+            'created_at'
+        ];
+        for (const column of requiredRegistryColumns) {
+            if (!registryColumnNames.includes(column)) {
+                throw new Error(`Column ${column} was not created in relation_type_registry table`);
+            }
+        }
+        // Verify indexes were created
+        const requiredIndexes = [
+            'idx_memory_relation_source',
+            'idx_memory_relation_target',
+            'idx_memory_relation_type',
+            'idx_memory_relation_confidence',
+            'idx_memory_relation_source_type',
+            'idx_memory_relation_target_type',
+            'idx_relation_type_registry_category'
+        ];
+        for (const index of requiredIndexes) {
+            if (!this.indexExists(db, index)) {
+                throw new Error(`Index ${index} was not created`);
+            }
+        }
+        // Verify initial relation types were inserted
+        const relationTypes = db.prepare(`
+      SELECT type_name FROM relation_type_registry
+    `).all();
+        const expectedTypes = ['CAUSES', 'DEPENDS_ON', 'FOLLOWS', 'CONTRASTS_WITH', 'REFERENCES', 'BELONGS_TO'];
+        const actualTypes = relationTypes.map(r => r.type_name);
+        for (const expectedType of expectedTypes) {
+            if (!actualTypes.includes(expectedType)) {
+                throw new Error(`Relation type ${expectedType} was not inserted into registry`);
+            }
+        }
+        // Verify UNIQUE constraint exists on memory_relation
+        const uniqueCheck = db.prepare(`
+      SELECT sql FROM sqlite_master 
+      WHERE type='table' AND name='memory_relation'
+    `).get();
+        if (!uniqueCheck || !uniqueCheck.sql.includes('UNIQUE(source_id, target_id, relation_type)')) {
+            throw new Error('UNIQUE constraint on (source_id, target_id, relation_type) was not created');
+        }
+        // Verify foreign key constraints
+        const tableInfo = db.prepare(`
+      SELECT sql FROM sqlite_master 
+      WHERE type='table' AND name='memory_relation'
+    `).get();
+        if (!tableInfo || !tableInfo.sql.includes('FOREIGN KEY') || !tableInfo.sql.includes('ON DELETE CASCADE')) {
+            throw new Error('Foreign key constraint with ON DELETE CASCADE was not created');
+        }
+        // Verify existing dependencies are intact using DependencyValidator
+        const dependencyReport = await DependencyValidator.validateAll(db);
+        if (!dependencyReport.success) {
+            const errors = dependencyReport.results
+                .filter(r => !r.success)
+                .map(r => `${r.name}: ${r.error}`)
+                .join('; ');
+            throw new Error(`Dependency validation failed: ${errors}`);
+        }
+    }
+}
+//# sourceMappingURL=005-relation-engine-schema.js.map

package/dist/database/migration/migrations/005-relation-engine-schema.js.map

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

package/dist/database/migration/migrations/005-relation-engine-schema.sql

@@ -0,0 +1,64 @@
+-- Migration: 005 - Relation Engine Schema
+-- Description: Create memory_relation and relation_type_registry tables for semantic relation engine
+-- Version: 5.0
+-- Date: 2025-01-XX
+
+-- 1. Create memory_relation table
+CREATE TABLE IF NOT EXISTS memory_relation (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  source_id TEXT NOT NULL,
+  target_id TEXT NOT NULL,
+  relation_type TEXT NOT NULL,
+  confidence REAL NOT NULL DEFAULT 0.7 CHECK (confidence >= 0.0 AND confidence <= 1.0),
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  metadata TEXT, -- JSON: extraction method, timestamp, cyclic flag, refinement history
+  FOREIGN KEY (source_id) REFERENCES memory_item(id) ON DELETE CASCADE,
+  FOREIGN KEY (target_id) REFERENCES memory_item(id) ON DELETE CASCADE,
+  UNIQUE(source_id, target_id, relation_type)
+);
+
+-- 2. Create relation_type_registry table
+CREATE TABLE IF NOT EXISTS relation_type_registry (
+  type_name TEXT PRIMARY KEY,
+  category TEXT NOT NULL, -- 'Causal', 'Temporal', 'Structural', 'Semantic'
+  description TEXT,
+  applicable_types TEXT, -- JSON array: ['episodic', 'semantic'] etc.
+  default_confidence REAL DEFAULT 0.7,
+  search_boost REAL DEFAULT 1.0, -- Search ranking weight
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 3. Create indexes for memory_relation table
+CREATE INDEX idx_memory_relation_source ON memory_relation(source_id);
+CREATE INDEX idx_memory_relation_target ON memory_relation(target_id);
+CREATE INDEX idx_memory_relation_type ON memory_relation(relation_type);
+CREATE INDEX idx_memory_relation_confidence ON memory_relation(confidence);
+CREATE INDEX idx_memory_relation_source_type ON memory_relation(source_id, relation_type);
+CREATE INDEX idx_memory_relation_target_type ON memory_relation(target_id, relation_type);
+
+-- 4. Create index for relation_type_registry table
+CREATE INDEX idx_relation_type_registry_category ON relation_type_registry(category);
+
+-- 5. Insert initial relation types into registry
+-- Causal (인과 관계군)
+INSERT INTO relation_type_registry (type_name, category, description, applicable_types, default_confidence, search_boost)
+VALUES ('CAUSES', 'Causal', '인과 관계: 한 기억이 다른 기억의 원인이 되는 관계', '["episodic", "semantic"]', 0.7, 1.2);
+
+-- Temporal (시간 관계군)
+INSERT INTO relation_type_registry (type_name, category, description, applicable_types, default_confidence, search_boost)
+VALUES ('FOLLOWS', 'Temporal', '시간적 순서: 한 기억이 다른 기억 이후에 발생하는 관계', '["episodic", "procedural"]', 0.7, 1.0);
+
+-- Structural (구조 관계군)
+INSERT INTO relation_type_registry (type_name, category, description, applicable_types, default_confidence, search_boost)
+VALUES ('DEPENDS_ON', 'Structural', '의존 관계: 한 기억이 다른 기억에 의존하는 관계', '["semantic", "procedural"]', 0.7, 1.1);
+
+INSERT INTO relation_type_registry (type_name, category, description, applicable_types, default_confidence, search_boost)
+VALUES ('BELONGS_TO', 'Structural', '포함 관계: 한 기억이 다른 기억에 속하는 관계', '["semantic", "episodic"]', 0.7, 1.0);
+
+-- Semantic (의미 관계군)
+INSERT INTO relation_type_registry (type_name, category, description, applicable_types, default_confidence, search_boost)
+VALUES ('CONTRASTS_WITH', 'Semantic', '대조 관계: 한 기억이 다른 기억과 대조되는 관계', '["semantic", "episodic"]', 0.7, 0.9);
+
+INSERT INTO relation_type_registry (type_name, category, description, applicable_types, default_confidence, search_boost)
+VALUES ('REFERENCES', 'Semantic', '참조 관계: 한 기억이 다른 기억을 참조하는 관계', '["working", "episodic", "semantic", "procedural"]', 0.7, 0.8);

package/dist/services/anchor/anchor-interfaces.d.ts

@@ -27,6 +27,7 @@ export interface SearchOptions {
     vector_weight?: number;
     text_weight?: number;
     autoMoveEnabled?: boolean;
+    use_relations?: boolean;
 }
 /**
  * 국소 검색 결과

package/dist/services/anchor/anchor-interfaces.d.ts.map

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

package/dist/services/anchor/anchor-interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"anchor-interfaces.js","sourceRoot":"","sources":["../../../src/services/anchor/anchor-interfaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkJH;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,QAAgB;QAC1B,KAAK,CAAC,mBAAmB,QAAQ,aAAa,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}
+{"version":3,"file":"anchor-interfaces.js","sourceRoot":"","sources":["../../../src/services/anchor/anchor-interfaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmJH;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,QAAgB;QAC1B,KAAK,CAAC,mBAAmB,QAAQ,aAAa,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

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

@@ -7,6 +7,7 @@ import type Database from 'better-sqlite3';
 import type { HybridSearchEngine } from '../../algorithms/hybrid-search-engine.js';
 import type { VectorSearchEngine } from '../../algorithms/vector-search-engine.js';
 import type { IAnchorCacheService, IAnchorSearchService, IAnchorManager, SearchOptions, SearchResult, AnchorSlot } from './anchor-interfaces.js';
+import { RelationGraph } from '../relation-graph.js';
 /**
  * Anchor Search Service 구현
  */
@@ -16,10 +17,15 @@ export declare class AnchorSearchService implements IAnchorSearchService {
     private hybridSearchEngine;
     private vectorSearchEngine;
     private queryEmbeddingService;
+    private relationGraph;
     /**
      * 생성자
      */
     constructor(cacheService: IAnchorCacheService);
+    /**
+     * RelationGraph 설정 (선택적)
+     */
+    setRelationGraph(relationGraph: RelationGraph): void;
     /**
      * 데이터베이스 설정
      */
@@ -59,9 +65,19 @@ export declare class AnchorSearchService implements IAnchorSearchService {
     /**
      * memory_link 테이블을 활용한 직접 연결된 메모리 조회
      */
+    /**
+     * 연결된 메모리 조회
+     * 관계 그래프가 있으면 우선 사용, 없으면 memory_link 사용
+     */
     private getLinkedMemories;
+    /**
+     * 관계 유형별 부스트 가중치 반환
+     */
+    private getRelationTypeBoost;
     /**
      * 검색 결과 랭킹 점수 계산
+     * 관계 그래프와 벡터 유사도를 결합한 하이브리드 hop 점수 계산
+     * 관계가 있는 기억에 우선순위 부여
      */
     private calculateRankingScore;
     /**

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

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