Releases

Fixed

• -keywords-only recall에서 시맨틱 보조(L3kw) 결과가 정확 키워드 일치 파편을 랭킹에서 밀어내거나 tokenBudget 절단으로 소실시킬 수 있던 문제 수정 (#30). 정확 일치 파편에 절단 이전 랭킹 가산(ranking.exactKeywordBoost, 기본 0.35)을 적용하고, 절단을 슬롯 보장 방식(정확 일치 예산 50% 선점, 시맨틱 보조 25% 몫 보장, 잔여 경쟁)으로 확장했다. text/mixed 쿼리의 절단 동작은 변경 없다.
• -explanations의 semantic_similarity 사유가 L3kw 세그먼트 회수 파편에도 부여된다.

Changed

• -L3kw 보조 질의를 정규화(소문자·중복 제거·정렬, contextText 제외)해 임베딩 캐시 적중률을 높이고, 이 경로의 형태소 보조 검색을 생략한다. 실측 기준 L3kw 발동 지연 p50이 약 2.5초에서 0.5~1.1초로 감소.
• -L3kw 실행 상한 도입: MEMENTO_KEYWORD_FALLBACK_TIMEOUT_MS(기본 1500ms, 100~60000 클램프). 초과 시 보조 없이 즉시 반환하며 searchPath에 L3kw:timeout을 남긴다.

Added

• -text 없는 keywords-only recall에 L3 시맨틱 보조 경로. keywords(+contextText) 합성 텍스트 임베딩이 L2와 병렬 수행되어 저장 keywords 배열에 없는 용어도 content 기반으로 회수된다. searchPath에 L3kw:N 세그먼트가 남으며 semanticSearch.keywordFallback(env MEMENTO_KEYWORD_SEMANTIC_FALLBACK=false)로 비활성화할 수 있다.
• -reflect에 workspace 파라미터 노출. 생성되는 모든 reflect 파편에 적용되며, 미지정 시 API 키의 default_workspace → 전역(NULL) 순으로 폴백한다.

Fixed

• -서버 재기동 후 Redis에서 복원된 세션이 이전 협상값(negotiatedVersion)을 그대로 되살려 이후 모든 요청이 400으로 거부되던 문제 수정. 협상값과 헤더가 달라도 지원 목록에 있는 값이면 헤더 값으로 재앵커링해 통과시키며(mcp_protocol_version_reanchored_total 카운터로 관측), 미지원 버전에 대한 400 거부는 유지된다. initialize 시 협상값을 Redis에 즉시 영속한다. (#26)

Changed

• -batch_remember의 fragments가 JSON 인코딩 문자열로 전달된 경우 원인을 명시하는 별도 오류 메시지를 반환한다.
• -JSON body 파싱 실패(-32700) 응답 message에 파서 위치 정보를 보존한다. 대량 배열 요청에서 손상 지점을 특정할 수 있다.
• -search_events의 l3_count가 keywords 폴백 보조 세그먼트(L3kw:N)도 집계한다.

Changed

• -semanticSearch.minSimilarity 기본값 0.5→0.4. 12쿼리 골드셋 실측에서 상위5 유용 결과 수가 최대인 지점으로, 어휘 중첩이 낮은 회상형 질의의 무응답을 줄인다(0.35는 노이즈 유입이 이득을 상쇄해 기각). SearchParamAdaptor 기존 학습 행도 0.4 상한으로 동기화됐다.

Fixed

• -text/mixed recall의 RRF importance 컷오프가 기준값 미지정 시 모든 후보를 탈락시키던 문제 수정. 기준 미지정 시 no-op으로 동작하며, rrfSearch.candidateMinImportance(기본 0.1)를 정책값으로 명시한다.
• -extractKeywords가 한글 토큰의 조사 접미를 제거하고, 카멜/스네이크 케이스 코드 식별자를 소문자화 없이 원형 보존한다.

Added

• -morpheme_indexed 백필 잡: 5분 주기로 미인덱싱 파편을 배치(기본 500) 처리해 형태소 L3 커버리지를 회복한다. embedding-consistency 경고에 백필 잡 상태가 병기된다.
• -마이그레이션 스크립트 3종(dryRun 기본): reflect 파편 keywords 재추출(scripts/reextract-reflect-keywords.js), reflect permanent TTL 강등, SearchParamAdaptor min_similarity 리셋.
• -recall 품질 검증 지표 SQL과 스모크 절차 문서(docs/operations/recall-quality-verification.md, scripts/recall-quality-metrics.sql).

Changed

• -reflect decision 파편 importance 0.8→0.7, reflectionPolicy.maxImportance 0.3→0.55 — reflect 파편의 permanent 승격을 차단하고 정리 주기가 실제로 동작하게 한다.

Fixed

• -recall의 fields sparse 목록이 응답에 적용되지 않던 문제 수정. 필드 선택이 응답 프로젝션에서 최종 적용되며, 파생 키(confidence, age_days)와 keywords(이 경우 includeKeywords 없이도 포함)·valid_to·affect·ema_activation도 요청 시 반환된다.
• -key_id가 includeKeyName 미지정 시에도 recall 응답에 포함되던 문제 수정. key_id·key_name 모두 includeKeyName=true일 때만 포함된다.