[5.6.2] - 2026-08-13
임베딩 차원 마이그레이션 판정 결함(#54)과 운영 와치독 재시작 폭풍을 정비한 패치.
Fixed
- 임베딩 차원 마이그레이션 스킵 판정을 (타입, 선언 차원) 쌍 비교로 교체한다 (#54). pgvector는
vector(1536)·vector(384)를 모두udt_name='vector'로 보고하므로 타입 이름 단독 비교가 실제 차원 변경을 스킵했고, transformers 384차원 전환 환경에서 임베딩 쓰기 전량 실패·시맨틱 검색 무력화로 이어졌다. 선언 차원은pg_attribute.atttypmod에서 읽으며 무차원 선언(-1)도 변환 대상으로 판정한다. - 기동 게이트(check-embedding-consistency)가 임베딩 데이터 전량 NULL 상태의 선언 차원 불일치를 통과시키던 공백을 막는다. 행 표본 검사 전에 선언 차원 검사를 수행해, 불일치 상태로 서버가 기동해 NULL을 양산하기 전에 차단한다.
- 와치독 스크립트에 기동 유예 120초를 도입한다. 유예 없이는 부팅(모델 로드 등)이 헬스체크 주기를 넘는 순간 매분 강제 재시작이 반복되는 재시작 폭풍이 된다.
Added
- 차원 마이그레이션 스크립트에
--dry-run(변환 대상 미리보기), 테이블별 트랜잭션(중간 실패 시 롤백으로 "임베딩 전량 NULL + 인덱스 없음" 중간 상태 방지), 변환 후 검증 출력(NULL 수·pg_index.indisvalid)을 추가한다. halfvec 목표 시 실행 경로 호환 미검증 경고를 출력한다. - (타입, 차원) 판정 로직을
lib/memory/embedding/column-spec.js로 분리해 마이그레이션 스크립트와 기동 게이트가 공유한다.
Changed
- 마이그레이션의 HNSW 인덱스 재생성 파라미터를 기본 스키마와 동일한
ef_construction=128로 정합한다(기존 64는 재생성 시 검색 품질 회귀 요인).