memento-mcp-server 1.6.0 → 1.7.2

package/src/database/schema.sql

@@ -1,159 +1,234 @@
--- Memento MCP Server SQLite 스키마
--- M1 단계: 개인용 SQLite 임베디드 데이터베이스
-
--- 메인 기억 테이블
-CREATE TABLE IF NOT EXISTS memory_item (
-  id TEXT PRIMARY KEY,
-  type TEXT CHECK (type IN ('working','episodic','semantic','procedural')) NOT NULL,
-  content TEXT NOT NULL,
-  importance REAL CHECK (importance >= 0 AND importance <= 1) DEFAULT 0.5,
-  privacy_scope TEXT CHECK (privacy_scope IN ('private','team','public')) DEFAULT 'private',
-  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-  last_accessed TIMESTAMP,
-  pinned BOOLEAN DEFAULT FALSE,
-  tags TEXT, -- JSON 배열로 저장
-  source TEXT,
-  view_count INTEGER DEFAULT 0,
-  cite_count INTEGER DEFAULT 0,
-  edit_count INTEGER DEFAULT 0
-);
-
--- 태그 테이블
-CREATE TABLE IF NOT EXISTS memory_tag (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  name TEXT NOT NULL UNIQUE,
-  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
-);
-
--- 메모리-태그 관계 테이블 (N:N)
-CREATE TABLE IF NOT EXISTS memory_item_tag (
-  memory_id TEXT NOT NULL,
-  tag_id INTEGER NOT NULL,
-  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-  FOREIGN KEY (memory_id) REFERENCES memory_item(id) ON DELETE CASCADE,
-  FOREIGN KEY (tag_id) REFERENCES memory_tag(id) ON DELETE CASCADE,
-  PRIMARY KEY (memory_id, tag_id)
-);
-
--- 기억 간 관계 테이블
-CREATE TABLE IF NOT EXISTS memory_link (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  source_id TEXT NOT NULL,
-  target_id TEXT NOT NULL,
-  relation_type TEXT CHECK (relation_type IN ('cause_of', 'derived_from', 'duplicates', 'contradicts')) NOT NULL,
-  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-  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)
-);
-
--- 피드백 이벤트 테이블
-CREATE TABLE IF NOT EXISTS feedback_event (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  memory_id TEXT NOT NULL,
-  event TEXT CHECK (event IN ('used', 'edited', 'neglected', 'helpful', 'not_helpful')) NOT NULL,
-  score REAL,
-  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-  FOREIGN KEY (memory_id) REFERENCES memory_item(id) ON DELETE CASCADE
-);
-
--- 작업기억 버퍼 테이블 (세션별)
-CREATE TABLE IF NOT EXISTS wm_buffer (
-  session_id TEXT PRIMARY KEY,
-  items TEXT NOT NULL, -- JSON 배열로 저장
-  token_budget INTEGER DEFAULT 4000,
-  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-  expires_at TIMESTAMP NOT NULL
-);
-
--- 인덱스 생성
-CREATE INDEX IF NOT EXISTS idx_memory_item_type ON memory_item(type);
-CREATE INDEX IF NOT EXISTS idx_memory_item_created_at ON memory_item(created_at);
-CREATE INDEX IF NOT EXISTS idx_memory_item_last_accessed ON memory_item(last_accessed);
-CREATE INDEX IF NOT EXISTS idx_memory_item_pinned ON memory_item(pinned);
-CREATE INDEX IF NOT EXISTS idx_memory_item_privacy_scope ON memory_item(privacy_scope);
-CREATE INDEX IF NOT EXISTS idx_memory_item_importance ON memory_item(importance);
-CREATE INDEX IF NOT EXISTS idx_memory_item_user_id ON memory_item(id); -- user_id 대신 id 사용
-CREATE INDEX IF NOT EXISTS idx_memory_item_project_id ON memory_item(id); -- project_id 대신 id 사용
-
-CREATE INDEX IF NOT EXISTS idx_memory_tag_memory_id ON memory_item_tag(memory_id);
-CREATE INDEX IF NOT EXISTS idx_memory_tag_tag_id ON memory_item_tag(tag_id);
-
-CREATE INDEX IF NOT EXISTS idx_memory_link_source ON memory_link(source_id);
-CREATE INDEX IF NOT EXISTS idx_memory_link_target ON memory_link(target_id);
-
-CREATE INDEX IF NOT EXISTS idx_feedback_memory_id ON feedback_event(memory_id);
-CREATE INDEX IF NOT EXISTS idx_feedback_event ON feedback_event(event);
-CREATE INDEX IF NOT EXISTS idx_feedback_created_at ON feedback_event(created_at);
-
-CREATE INDEX IF NOT EXISTS idx_wm_buffer_expires_at ON wm_buffer(expires_at);
-
--- FTS5 가상 테이블 (전문 검색)
-CREATE VIRTUAL TABLE IF NOT EXISTS memory_item_fts USING fts5(
-  content,
-  tags,
-  source,
-  content='memory_item',
-  content_rowid='rowid'
-);
-
--- FTS5 트리거 (자동 동기화)
-CREATE TRIGGER IF NOT EXISTS memory_item_fts_insert AFTER INSERT ON memory_item BEGIN
-  INSERT INTO memory_item_fts(rowid, content, tags, source)
-  VALUES (new.rowid, new.content, new.tags, new.source);
-END;
-
-CREATE TRIGGER IF NOT EXISTS memory_item_fts_delete AFTER DELETE ON memory_item BEGIN
-  INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags, source)
-  VALUES('delete', old.rowid, old.content, old.tags, old.source);
-END;
-
-CREATE TRIGGER IF NOT EXISTS memory_item_fts_update AFTER UPDATE ON memory_item BEGIN
-  INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags, source)
-  VALUES('delete', old.rowid, old.content, old.tags, old.source);
-  INSERT INTO memory_item_fts(rowid, content, tags, source)
-  VALUES (new.rowid, new.content, new.tags, new.source);
-END;
-
--- 임베딩 저장 테이블
-CREATE TABLE IF NOT EXISTS memory_embedding (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  memory_id TEXT NOT NULL,
-  embedding TEXT NOT NULL, -- JSON 배열로 저장
-  dim INTEGER NOT NULL, -- 벡터 차원
-  model TEXT, -- 사용된 모델명
-  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-  FOREIGN KEY (memory_id) REFERENCES memory_item(id) ON DELETE CASCADE,
-  UNIQUE(memory_id)
-);
-
--- 임베딩 테이블 인덱스
-CREATE INDEX IF NOT EXISTS idx_memory_embedding_memory_id ON memory_embedding(memory_id);
-CREATE INDEX IF NOT EXISTS idx_memory_embedding_dim ON memory_embedding(dim);
-CREATE INDEX IF NOT EXISTS idx_memory_embedding_model ON memory_embedding(model);
-
--- VEC 가상 테이블 (벡터 검색) - sqlite-vec 확장 필요
--- 주의: sqlite-vec 확장이 설치되어 있어야 함
--- 테스트 환경에서는 이 부분을 건너뛰도록 조건부 처리
--- CREATE VIRTUAL TABLE IF NOT EXISTS memory_item_vec USING vec0(embedding float[1536]);
-
--- VEC 테이블 트리거 (임베딩이 생성될 때 자동으로 VEC 테이블에 추가)
--- 테스트 환경에서는 이 부분을 건너뛰도록 조건부 처리
--- CREATE TRIGGER IF NOT EXISTS memory_embedding_vec_insert AFTER INSERT ON memory_embedding BEGIN
---   INSERT INTO memory_item_vec(rowid, embedding) 
---   VALUES (NEW.memory_id, json_extract(NEW.embedding, '$'));
--- END;
-
--- CREATE TRIGGER IF NOT EXISTS memory_embedding_vec_update AFTER UPDATE ON memory_embedding BEGIN
---   UPDATE memory_item_vec 
---   SET embedding = json_extract(NEW.embedding, '$') 
---   WHERE rowid = NEW.memory_id;
--- END;
-
--- CREATE TRIGGER IF NOT EXISTS memory_embedding_vec_delete AFTER DELETE ON memory_embedding BEGIN
---   DELETE FROM memory_item_vec WHERE rowid = OLD.memory_id;
--- END;
-
--- 초기 데이터 삽입 (선택사항)
--- INSERT OR IGNORE INTO memory_item (id, type, content, importance, privacy_scope, pinned)
--- VALUES ('welcome', 'semantic', 'Memento MCP Server에 오신 것을 환영합니다!', 1.0, 'private', TRUE);
+-- Memento MCP Server SQLite 스키마
+-- M1 단계: 개인용 SQLite 임베디드 데이터베이스
+
+-- 메인 기억 테이블
+CREATE TABLE IF NOT EXISTS memory_item (
+  id TEXT PRIMARY KEY,
+  type TEXT CHECK (type IN ('working','episodic','semantic','procedural')) NOT NULL,
+  content TEXT NOT NULL,
+  importance REAL CHECK (importance >= 0 AND importance <= 1) DEFAULT 0.5,
+  privacy_scope TEXT CHECK (privacy_scope IN ('private','team','public')) DEFAULT 'private',
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  last_accessed TIMESTAMP,
+  pinned BOOLEAN DEFAULT FALSE,
+  tags TEXT, -- JSON 배열로 저장
+  source TEXT,
+  view_count INTEGER DEFAULT 0,
+  cite_count INTEGER DEFAULT 0,
+  edit_count INTEGER DEFAULT 0
+);
+
+-- 태그 테이블
+CREATE TABLE IF NOT EXISTS memory_tag (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL UNIQUE,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 메모리-태그 관계 테이블 (N:N)
+CREATE TABLE IF NOT EXISTS memory_item_tag (
+  memory_id TEXT NOT NULL,
+  tag_id INTEGER NOT NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (memory_id) REFERENCES memory_item(id) ON DELETE CASCADE,
+  FOREIGN KEY (tag_id) REFERENCES memory_tag(id) ON DELETE CASCADE,
+  PRIMARY KEY (memory_id, tag_id)
+);
+
+-- 기억 간 관계 테이블
+CREATE TABLE IF NOT EXISTS memory_link (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  source_id TEXT NOT NULL,
+  target_id TEXT NOT NULL,
+  relation_type TEXT CHECK (relation_type IN ('cause_of', 'derived_from', 'duplicates', 'contradicts')) NOT NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  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)
+);
+
+-- 피드백 이벤트 테이블
+CREATE TABLE IF NOT EXISTS feedback_event (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  memory_id TEXT NOT NULL,
+  event TEXT CHECK (event IN ('used', 'edited', 'neglected', 'helpful', 'not_helpful')) NOT NULL,
+  score REAL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (memory_id) REFERENCES memory_item(id) ON DELETE CASCADE
+);
+
+-- 작업기억 버퍼 테이블 (세션별)
+CREATE TABLE IF NOT EXISTS wm_buffer (
+  session_id TEXT PRIMARY KEY,
+  items TEXT NOT NULL, -- JSON 배열로 저장
+  token_budget INTEGER DEFAULT 4000,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  expires_at TIMESTAMP NOT NULL
+);
+
+-- 인덱스 생성
+CREATE INDEX IF NOT EXISTS idx_memory_item_type ON memory_item(type);
+CREATE INDEX IF NOT EXISTS idx_memory_item_created_at ON memory_item(created_at);
+CREATE INDEX IF NOT EXISTS idx_memory_item_last_accessed ON memory_item(last_accessed);
+CREATE INDEX IF NOT EXISTS idx_memory_item_pinned ON memory_item(pinned);
+CREATE INDEX IF NOT EXISTS idx_memory_item_privacy_scope ON memory_item(privacy_scope);
+CREATE INDEX IF NOT EXISTS idx_memory_item_importance ON memory_item(importance);
+CREATE INDEX IF NOT EXISTS idx_memory_item_user_id ON memory_item(id); -- user_id 대신 id 사용
+CREATE INDEX IF NOT EXISTS idx_memory_item_project_id ON memory_item(id); -- project_id 대신 id 사용
+
+CREATE INDEX IF NOT EXISTS idx_memory_tag_memory_id ON memory_item_tag(memory_id);
+CREATE INDEX IF NOT EXISTS idx_memory_tag_tag_id ON memory_item_tag(tag_id);
+
+CREATE INDEX IF NOT EXISTS idx_memory_link_source ON memory_link(source_id);
+CREATE INDEX IF NOT EXISTS idx_memory_link_target ON memory_link(target_id);
+
+CREATE INDEX IF NOT EXISTS idx_feedback_memory_id ON feedback_event(memory_id);
+CREATE INDEX IF NOT EXISTS idx_feedback_event ON feedback_event(event);
+CREATE INDEX IF NOT EXISTS idx_feedback_created_at ON feedback_event(created_at);
+
+CREATE INDEX IF NOT EXISTS idx_wm_buffer_expires_at ON wm_buffer(expires_at);
+
+-- FTS5 가상 테이블 (전문 검색)
+CREATE VIRTUAL TABLE IF NOT EXISTS memory_item_fts USING fts5(
+  content,
+  tags,
+  source,
+  content='memory_item',
+  content_rowid='rowid'
+);
+
+-- FTS5 트리거 (자동 동기화)
+CREATE TRIGGER IF NOT EXISTS memory_item_fts_insert AFTER INSERT ON memory_item BEGIN
+  INSERT INTO memory_item_fts(rowid, content, tags, source)
+  VALUES (new.rowid, new.content, new.tags, new.source);
+END;
+
+CREATE TRIGGER IF NOT EXISTS memory_item_fts_delete AFTER DELETE ON memory_item BEGIN
+  INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags, source)
+  VALUES('delete', old.rowid, old.content, old.tags, old.source);
+END;
+
+CREATE TRIGGER IF NOT EXISTS memory_item_fts_update AFTER UPDATE ON memory_item BEGIN
+  INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags, source)
+  VALUES('delete', old.rowid, old.content, old.tags, old.source);
+  INSERT INTO memory_item_fts(rowid, content, tags, source)
+  VALUES (new.rowid, new.content, new.tags, new.source);
+END;
+
+-- 임베딩 저장 테이블 (다중 제공자/차원 지원)
+CREATE TABLE IF NOT EXISTS memory_embedding (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  memory_id TEXT NOT NULL,
+  embedding_provider TEXT NOT NULL DEFAULT 'tfidf',
+  projection_type TEXT NOT NULL DEFAULT 'native',
+  embedding TEXT NOT NULL, -- JSON 배열로 저장
+  dim INTEGER NOT NULL, -- 원본 벡터 차원
+  dimensions INTEGER DEFAULT 0, -- 저장된 벡터 차원 (패딩/축소 적용 후)
+  model TEXT, -- 사용된 모델명
+  precision INTEGER DEFAULT 32, -- 벡터 정밀도 (float32 등)
+  normalized BOOLEAN DEFAULT FALSE, -- 정규화 여부
+  version INTEGER DEFAULT 1, -- 임베딩 버전
+  created_by TEXT DEFAULT 'system',
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (memory_id) REFERENCES memory_item(id) ON DELETE CASCADE,
+  UNIQUE(memory_id, embedding_provider, projection_type)
+);
+
+-- 임베딩 테이블 인덱스
+CREATE INDEX IF NOT EXISTS idx_memory_embedding_memory_id ON memory_embedding(memory_id);
+CREATE INDEX IF NOT EXISTS idx_memory_embedding_memory_provider ON memory_embedding(memory_id, embedding_provider);
+CREATE INDEX IF NOT EXISTS idx_memory_embedding_provider_projection ON memory_embedding(embedding_provider, projection_type);
+CREATE INDEX IF NOT EXISTS idx_memory_embedding_dimensions ON memory_embedding(dimensions);
+CREATE INDEX IF NOT EXISTS idx_memory_embedding_model ON memory_embedding(model);
+CREATE INDEX IF NOT EXISTS idx_memory_embedding_version ON memory_embedding(version);
+
+-- 임베딩 모델 레지스트리 (제공자별 차원 및 메타데이터)
+CREATE TABLE IF NOT EXISTS embedding_model_registry (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  provider TEXT NOT NULL,
+  model TEXT NOT NULL,
+  projection_type TEXT NOT NULL DEFAULT 'native',
+  dimensions INTEGER NOT NULL,
+  vec_table TEXT, -- sqlite-vec 테이블명
+  priority INTEGER DEFAULT 100,
+  status TEXT CHECK (status IN ('active','inactive','deprecated')) DEFAULT 'active',
+  last_checked TIMESTAMP,
+  metadata TEXT,
+  UNIQUE(provider, projection_type),
+  UNIQUE(provider, model),
+  UNIQUE(vec_table)
+);
+
+-- VEC 가상 테이블 (벡터 검색) - sqlite-vec 확장 필요
+-- 주의: sqlite-vec 확장이 설치되어 있어야 함
+CREATE VIRTUAL TABLE IF NOT EXISTS memory_item_vec USING vec0(embedding float[384]);
+
+-- 제공자별 VEC 테이블들
+CREATE VIRTUAL TABLE IF NOT EXISTS memory_item_vec_tfidf USING vec0(embedding float[384]);
+CREATE VIRTUAL TABLE IF NOT EXISTS memory_item_vec_minilm USING vec0(embedding float[384]);
+CREATE VIRTUAL TABLE IF NOT EXISTS memory_item_vec_openai USING vec0(embedding float[1536]);
+CREATE VIRTUAL TABLE IF NOT EXISTS memory_item_vec_gemini USING vec0(embedding float[768]);
+
+-- VEC 테이블 트리거 (임베딩이 생성될 때 자동으로 VEC 테이블에 추가)
+-- 제공자별 테이블에 저장하도록 수정
+CREATE TRIGGER IF NOT EXISTS memory_embedding_vec_insert AFTER INSERT ON memory_embedding BEGIN
+  INSERT INTO memory_item_vec(rowid, embedding) 
+  SELECT NEW.id, json_extract(NEW.embedding, '$')
+  WHERE NEW.dimensions = 384;
+  
+  INSERT INTO memory_item_vec_tfidf(rowid, embedding) 
+  SELECT NEW.id, json_extract(NEW.embedding, '$')
+  WHERE NEW.embedding_provider = 'tfidf' AND NEW.dimensions = 384 AND NEW.projection_type = 'native';
+  
+  INSERT INTO memory_item_vec_minilm(rowid, embedding) 
+  SELECT NEW.id, json_extract(NEW.embedding, '$')
+  WHERE NEW.embedding_provider = 'minilm' AND NEW.dimensions = 384 AND NEW.projection_type = 'native';
+  
+  INSERT INTO memory_item_vec_openai(rowid, embedding) 
+  SELECT NEW.id, json_extract(NEW.embedding, '$')
+  WHERE NEW.embedding_provider = 'openai' AND NEW.dimensions = 1536 AND NEW.projection_type = 'native';
+  
+  INSERT INTO memory_item_vec_gemini(rowid, embedding) 
+  SELECT NEW.id, json_extract(NEW.embedding, '$')
+  WHERE NEW.embedding_provider = 'gemini' AND NEW.dimensions = 768 AND NEW.projection_type = 'native';
+END;
+
+CREATE TRIGGER IF NOT EXISTS memory_embedding_vec_update AFTER UPDATE ON memory_embedding BEGIN
+  DELETE FROM memory_item_vec WHERE rowid = NEW.id;
+  DELETE FROM memory_item_vec_tfidf WHERE rowid = NEW.id;
+  DELETE FROM memory_item_vec_minilm WHERE rowid = NEW.id;
+  DELETE FROM memory_item_vec_openai WHERE rowid = NEW.id;
+  DELETE FROM memory_item_vec_gemini WHERE rowid = NEW.id;
+
+  INSERT INTO memory_item_vec(rowid, embedding) 
+  SELECT NEW.id, json_extract(NEW.embedding, '$')
+  WHERE NEW.dimensions = 384;
+  
+  INSERT INTO memory_item_vec_tfidf(rowid, embedding) 
+  SELECT NEW.id, json_extract(NEW.embedding, '$')
+  WHERE NEW.embedding_provider = 'tfidf' AND NEW.dimensions = 384 AND NEW.projection_type = 'native';
+  
+  INSERT INTO memory_item_vec_minilm(rowid, embedding) 
+  SELECT NEW.id, json_extract(NEW.embedding, '$')
+  WHERE NEW.embedding_provider = 'minilm' AND NEW.dimensions = 384 AND NEW.projection_type = 'native';
+  
+  INSERT INTO memory_item_vec_openai(rowid, embedding) 
+  SELECT NEW.id, json_extract(NEW.embedding, '$')
+  WHERE NEW.embedding_provider = 'openai' AND NEW.dimensions = 1536 AND NEW.projection_type = 'native';
+  
+  INSERT INTO memory_item_vec_gemini(rowid, embedding) 
+  SELECT NEW.id, json_extract(NEW.embedding, '$')
+  WHERE NEW.embedding_provider = 'gemini' AND NEW.dimensions = 768 AND NEW.projection_type = 'native';
+END;
+
+CREATE TRIGGER IF NOT EXISTS memory_embedding_vec_delete AFTER DELETE ON memory_embedding BEGIN
+  DELETE FROM memory_item_vec WHERE rowid = OLD.id;
+  DELETE FROM memory_item_vec_tfidf WHERE rowid = OLD.id;
+  DELETE FROM memory_item_vec_minilm WHERE rowid = OLD.id;
+  DELETE FROM memory_item_vec_openai WHERE rowid = OLD.id;
+  DELETE FROM memory_item_vec_gemini WHERE rowid = OLD.id;
+END;
+
+-- 초기 데이터 삽입 (선택사항)
+-- INSERT OR IGNORE INTO memory_item (id, type, content, importance, privacy_scope, pinned)
+-- VALUES ('welcome', 'semantic', 'Memento MCP Server에 오신 것을 환영합니다!', 1.0, 'private', TRUE);

package/.cursor/rules/cache-management.mdc

@@ -1,171 +0,0 @@
----
-globs: *.ts,*.js
-description: 캐시 서비스 개발 규칙
----
-
-# 캐시 관리 서비스 개발 규칙
-
-## 🗄️ 캐시 서비스 아키텍처
-
-### 핵심 컴포넌트
-
-#### 1. Cache Service (`src/services/cache-service.ts` - 352줄)
-- **LRU 캐시 구현**: 최근 사용 항목 우선 유지
-- **TTL 관리**: 시간 기반 캐시 만료
-- **메모리 효율적 관리**: 캐시 크기 제한 및 정리
-- **통계 수집**: 캐시 성능 메트릭 제공
-
-#### 2. 캐시 타입별 관리
-- **검색 결과 캐시**: 검색 성능 향상
-- **임베딩 캐시**: 임베딩 생성 비용 절약
-- **메타데이터 캐시**: 자주 접근하는 데이터
-- **세션 캐시**: 사용자 세션 정보
-
-## 🔧 캐시 구현 가이드라인
-
-### LRU 캐시 구현
-```typescript
-interface LRUCache<T> {
-  maxSize: number;
-  ttl: number;
-  get(key: string): T | null;
-  set(key: string, value: T): void;
-  delete(key: string): boolean;
-  clear(): void;
-  size(): number;
-}
-```
-
-### TTL 관리
-- **검색 결과**: 1시간 (3600초)
-- **임베딩**: 24시간 (86400초)
-- **메타데이터**: 30분 (1800초)
-- **세션**: 2시간 (7200초)
-
-### 캐시 키 전략
-- **검색 결과**: `search:${hash(query)}`
-- **임베딩**: `embedding:${hash(text)}`
-- **메타데이터**: `meta:${type}:${id}`
-- **세션**: `session:${sessionId}`
-
-## 📊 캐시 성능 메트릭
-
-### 주요 지표
-- **캐시 히트율**: 80% 이상 목표
-- **캐시 크기**: 메모리 사용량 제한
-- **평균 응답 시간**: 캐시된 데이터 접근 시간
-- **캐시 정리 빈도**: 만료된 항목 제거 빈도
-
-### 모니터링
-- **실시간 통계**: 현재 캐시 상태
-- **히스토리 추적**: 성능 변화 추이
-- **알림 설정**: 임계값 초과 시 알림
-- **리포트 생성**: 정기적인 성능 리포트
-
-## 🚀 캐시 최적화 전략
-
-### 메모리 최적화
-1. **크기 제한**: 최대 캐시 크기 설정
-2. **자동 정리**: 만료된 항목 자동 제거
-3. **우선순위**: 중요한 데이터 우선 유지
-4. **압축**: 대용량 데이터 압축 저장
-
-### 성능 최적화
-1. **병렬 처리**: 동시 캐시 접근 처리
-2. **배치 작업**: 대량 캐시 작업 최적화
-3. **지연 로딩**: 필요 시에만 데이터 로드
-4. **예측적 캐싱**: 자주 사용될 데이터 미리 캐싱
-
-### 안정성 보장
-1. **에러 처리**: 캐시 실패 시 대체 방안
-2. **데이터 일관성**: 캐시와 원본 데이터 동기화
-3. **복구 메커니즘**: 캐시 손상 시 자동 복구
-4. **백업 전략**: 중요한 캐시 데이터 백업
-
-## 🔍 캐시 디버깅
-
-### 일반적인 문제
-- **캐시 미스**: 캐시 키 불일치 또는 만료
-- **메모리 누수**: 캐시 크기 제한 초과
-- **성능 저하**: 캐시 히트율 낮음
-- **데이터 불일치**: 캐시와 원본 데이터 차이
-
-### 디버깅 도구
-- **캐시 통계**: 현재 캐시 상태 확인
-- **로그 분석**: 캐시 접근 패턴 분석
-- **프로파일링**: 캐시 성능 측정
-- **모니터링**: 실시간 캐시 상태 추적
-
-## 📋 캐시 정책
-
-### 저장 정책
-- **자동 저장**: 자주 접근하는 데이터 자동 캐싱
-- **수동 저장**: 사용자 요청에 의한 캐싱
-- **조건부 저장**: 특정 조건 만족 시 캐싱
-- **우선순위 저장**: 중요한 데이터 우선 캐싱
-
-### 만료 정책
-- **시간 기반**: TTL 만료 시 자동 삭제
-- **크기 기반**: 캐시 크기 초과 시 오래된 항목 삭제
-- **사용 기반**: 사용하지 않는 항목 우선 삭제
-- **수동 삭제**: 사용자 요청에 의한 삭제
-
-### 동기화 정책
-- **즉시 동기화**: 데이터 변경 시 즉시 캐시 업데이트
-- **지연 동기화**: 주기적으로 캐시 동기화
-- **조건부 동기화**: 특정 조건에서만 동기화
-- **수동 동기화**: 사용자 요청에 의한 동기화
-
-## 🧪 캐시 테스트
-
-### 단위 테스트
-- **기본 기능**: 캐시 저장/조회/삭제 테스트
-- **TTL 테스트**: 시간 기반 만료 테스트
-- **크기 제한**: 최대 크기 초과 시 동작 테스트
-- **에러 처리**: 예외 상황 처리 테스트
-
-### 성능 테스트
-- **부하 테스트**: 높은 부하에서의 캐시 성능
-- **동시성 테스트**: 동시 접근 시 안정성
-- **메모리 테스트**: 메모리 사용량 측정
-- **응답 시간**: 캐시 접근 응답 시간 측정
-
-### 통합 테스트
-- **전체 시스템**: 캐시와 다른 컴포넌트 연동 테스트
-- **데이터 일관성**: 캐시와 원본 데이터 일치성 확인
-- **장애 복구**: 캐시 실패 시 대체 방안 테스트
-- **성능 영향**: 캐시 도입 시 전체 성능 영향 측정
-
-## 📈 캐시 모니터링
-
-### 실시간 모니터링
-- **캐시 크기**: 현재 사용 중인 메모리
-- **히트율**: 캐시 성공률
-- **응답 시간**: 캐시 접근 속도
-- **에러율**: 캐시 관련 에러 발생률
-
-### 알림 설정
-- **히트율 저하**: 70% 미만 시 경고
-- **메모리 사용량**: 90% 초과 시 경고
-- **응답 시간**: 100ms 초과 시 경고
-- **에러율**: 5% 초과 시 경고
-
-### 리포트 생성
-- **일일 리포트**: 캐시 성능 요약
-- **주간 리포트**: 성능 트렌드 분석
-- **월간 리포트**: 장기 성능 변화
-- **특별 리포트**: 문제 발생 시 상세 분석
-
-## 🎯 캐시 목표
-
-### 성능 목표
-- **캐시 히트율**: 80% 이상
-- **평균 응답 시간**: 10ms 이하
-- **메모리 사용량**: 100MB 이하
-- **에러율**: 1% 이하
-
-### 가용성 목표
-- **캐시 가용성**: 99.9% 이상
-- **데이터 일관성**: 99.99% 이상
-- **복구 시간**: 5분 이하
-- **데이터 손실**: 0%