Releases

[4.6.0] - 2026-06-16

Added

• -벡터 검색 HNSW 인덱스 강제 옵션·토글: ORDER BY embedding <=> v LIMIT 트랜잭션에 enable_seqscan=off·enable_bitmapscan=off·hnsw.iterative_scan 힌트를 적용해 HNSW 인덱스 경로를 강제.
• -batch_remember 비동기(파이어앤포겟) 모드 opt-in: async: true 지정 시 선검증 후 Redis 큐 적재, {async, accepted, rejected, jobId} 즉시 반환. BatchRememberWorker가 본처리. 기본 async: false로 기존 동기 동작 불변. Redis 비활성 환경에서는 동기 폴백.
• -배치 작업 전용 연결 풀(getBatchPool, application_name='memento-mcp:batch') 및 배치 풀 통계 메트릭 수집.

Changed

• -HNSW 인덱스 정의의 ef_construction 정합화, L3 형태소 보강 검색 병렬 실행, RRF 병합 후보에 importance 하한 컷오프 적용.
• -reflect 항목 자기완결성 게이트 및 한글 하한 강화.
• -키 스코프 조회를 keyScopeClause 공용 헬퍼로 통일: getById·findCaseIdBySessionTopic·findErrorFragmentsBySessionTopic·GraphLinker 공유. GraphLinker 키 필터를 파라미터 바인딩·text 타입 정합으로 정리.
• -피드백 importance 보정 계수를 feedbackFactor 순수 함수로 단일화(라이브 계수 0.85/1.1/0.95 유지).
• -tools/call 메트릭 중복 집계 제거.
• -내부 중복 정리: 요청 컨텍스트 추출·키워드 정규화·도구 감사 래퍼·검색 SELECT 상수·affect 조건·Bearer 추출·환경변수 리스트 파싱·공통 파라미터 스키마 각각 단일 위치로 통합.
• -대형 메서드 분해: remember·handleMcpPost·buildAdminPaths·dispatchJsonRpc·ContextBuilder.build·검색 RRF·컨솔리데이션/분해/압축.

Fixed

• -getUnreflectedSessions의 Redis SCAN 순회에 상한(최대 20라운드)을 두어 대용량 keyspace에서 context 응답이 지연되던 문제 해결.

파편 분해 단계(splitLongFragments)에 two-phase gate-then-commit, 분할 자식 품질 게이트(최소 길이·CJK 혼입·대명사 reject), 분할 전용 provider 체인(MEMENTO_SPLIT_LLM_*), 분할 실패 backoff(split_attempt_failed_at, migration-036), FragmentGC split 자식 정리(branch-2)를 추가. 전체 변경은 CHANGELOG [4.5.0] 참조.

보조 조회 도구(graph_explore·search_traces·reconstruct_history)가 그룹 공유 키 범위의 파편을 조회하도록 키 격리 절을 keyScopeClause 공용 헬퍼로 통합. FragmentReader.getByIds에 groupKeyIds 인자 추가. recall stale 판정에 verified_at 부재 시 created_at 폴백 적용.

전체 변경: CHANGELOG [4.4.0] 참조.

형태소 토크나이저 로컬 전환

• -L3 형태소 토크나이저를 LLM 서브프로세스에서 로컬 CPU 분석기로 전환: 한글 garu-ko, 영어 PorterStemmer, 중국어 @node-rs/jieba, 일본어 kuromoji
• -환경변수 MEMENTO_MORPHEME_TOKENIZER(local|llm), MEMENTO_ENABLE_KUROMOJI(true|false)
• -서버 기동 시 한글·영어 분석기 프리로드
• -Docker 베이스 이미지 node:24-alpine

reflect 최적화

• -episode 저장 경로 충돌 감지 생략 옵션(skipConflictDetection)으로 저장 지연 단축

테스트

• -jest 제거 및 node:test 단일화

변경 요약

ProactiveRecall · autoLinkSessionFragments · MemoryConsolidator 세 층위의 자동 후처리에 schema-fit gate를 결합하고, tool_reflect 응답에 _meta 블록을 신설했다.

Added

• -config/memory.js proactiveRecall 블록: mode (off/auto/legacy), keywordOverlapMin, requireSameWorkspace, caseIdPolicy (both-required/strict-or-adjacent/loose), adjacencyWindowMs, requireSameTopicOrType.
• -config/memory.js consolidate.schemaFit: pendingCaseFragmentsMin 5, recentRelatedLinksMin 20, fragmentsSinceLastRunMin 30, mode (all/any/off).
• -config/memory.js consolidate.enableRiskyStages: splitLongFragments, detectContradictions, compressOldFragments 플래그.
• -lib/symbolic/rules/v1/proactive-gate.js workspace_mismatch·case_policy 차단 사유.
• -lib/scheduler.js evaluateSchemaFitGate 함수 (DB COUNT 3종 기반).
• -신규 unit 테스트 4종 (36개 시나리오).

Changed

• -lib/memory/SessionLinker.js autoLinkSessionFragments: 카르테시안 곱집합 → 1:1 top-1 schema-fit 매칭. 게이트 미통과 후보는 linkSuggestions[] 반환.
• -lib/memory/RememberPostProcessor.js _proactiveRecall: proactiveRecall.mode 분기 wrap.
• -lib/memory/consolidate/MemoryConsolidator.js: LLM 재작성 stage 3종에 enableRiskyStages 분기.
• -lib/tools/memory.js tool_reflect 응답: _meta 블록 신설 (searchEventId, hints, suggestion, link_suggestions, serverTime).
• -lib/scheduler.js: CONSOLIDATE_INTERVAL_MS 처리를 MEMORY_CONFIG.consolidateIntervalMs 단일 진입점으로 교체.
• -config/memory.js consolidateIntervalMs 기본값 1h → 6h (scheduler 실제 동작값 일치).

호환성: 기존 DB 스키마·외부 API 호환, _meta.link_suggestions[] 추가 필드만 신규 노출.