Repository navigation
Conversation
정상 삭제 뒤 STALE Vector만 남은 문서에 MISSING_EMBEDDINGS가 열리던 오탐을 막는다. 삭제 잔여물은 DELETED_DOCUMENT_RESIDUE가 계속 보고한다. Refs #518
|
Important
This repository does not receive automatic reviews because it has fewer than 10 stars. ⚙️ Run configuration
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
1 of 4 tasks
This was referenced Oct 16, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
🔍️ 작업 내용
정상 삭제된 문서에 해소되지 않는
MISSING_EMBEDDINGS(CRITICAL) 정합성 Issue가 남던 오탐을 고쳤습니다.같은 단위 시험으로 수정 전 실패 2건, 수정 후 통과 5건을 확인했습니다. 격리 DB의 전체 백엔드
clean build는 1,497건 중 실패·오류 0건이었습니다.✨ 상세 설명
DOCUMENT_DELETEDOutbox가 Vector를 모두ACTIVE → STALE로 바꿉니다. 그런데SyncConsistencyInspector.inspectChunksAndEmbeddings는 문서 상태를 보지 않고 "현재 INDEXED 버전의 Chunk 수 > ACTIVE Vector 수"만 비교했습니다. 그 결과 삭제가 정상으로 끝난 문서도 Vector 누락으로 보고됐습니다.repairable=true로 분류했습니다(단위 시험으로 확인).document.status != DELETED한 줄을 추가했습니다(Javadoc 한 줄 포함). 같은 분기의MISSING_EMBEDDINGS·MODEL_MISMATCH가 삭제 문서에서 빠집니다.DELETED_DOCUMENT_RESIDUE가 그대로 보고합니다. 다른 검사, DB 스키마, 설정, API 형식은 바꾸지 않았습니다.RESOLVED가 됩니다(실제 경로로 확인).🧪 실제 검증 결과
환경: 로컬 macOS arm64·Temurin 17.0.18, 새 격리 PostgreSQL 17.8·pgvector 0.8.1·Valkey 컨테이너(사용자 로컬 DB 미사용).
실행: 2026-10-16 16:21:22–16:27:40 +09:00. 기준은 당시 develop
f238caf이고, 커밋은 그 뒤 develop8971989위에 올렸습니다. 그 사이 병합된 #514는 RAG 파일 3개만 바꿔 이번 변경 파일과 겹치지 않습니다.MISSING_EMBEDDINGS(0/5/5, #517 실시험과 같음), 일부 ACTIVE면MISSING_EMBEDDINGS(repairable=true)가 잔여물과 함께 보고됨clean build, 251개 묶음. 건너뜀 5건은 기존과 같음RESOLVED·OPEN 0건REPAIR가 예약했을 Event가 실패한다는 것은 코드 분석입니다.🛠️ 추후 리팩토링 및 고도화 계획
MISSING_CHUNKS·MODEL_MISMATCH·INVALID_CURRENT_VERSION·ORPHANED_DATA는 유형 이름으로 찾히는 자동 시험이 없습니다([Test] 정합성 점검기 복구·보고 경로 격리 시험과 문서화 #517 설계 문서 참고).MISSING_JOB·STALLED_VERSION은 이번에 판단하지 않았습니다.💬 리뷰 요구사항
MISSING_EMBEDDINGS·MODEL_MISMATCH만,MISSING_CHUNKS는 유지)가 적절한지 확인해 주세요.