Files
kebab/crates/kebab-store-vector/src
altair823 ee39cfb387 chore: PR #234 회차 2 리뷰 반영 — doctor hint 노출 + 압축 가드
2회차 리뷰가 1회차 지적 3건을 모두 해결됐다고 확인하고 승인했다. 남은
MEDIUM 1건과 LOW 2건 중 값이 있는 것을 반영한다.

1) doctor hint 가 사람 눈에 안 보였다 (MEDIUM)

   렌더러가 `if let (false, Some(hint))` 로 실패한 체크의 hint 만 찍는다.
   회차 1 에서 `vector_store` 를 정보성(`ok: true`)으로 낮추면서, 정작 그
   경고를 전달할 유일한 경로를 막아 버렸다 — 문자열은 만들어지지만 `--json`
   에만 실리고 `kebab doctor` 를 그냥 돌린 사용자는 영영 못 본다.

   hint 가 있으면 항상 찍는다. 정보성 경고는 `✓` 도 `✗` 도 아닌 `!` 로
   표시해 실패와 구분한다.

2) `version_before` 읽기 실패 시 압축이 매번 걸렸다 (LOW)

   `table.version()` 실패는 `unwrap_or(0)` 이라, 버전이 압축 간격을 넘은
   스토어에서는 `after / n > 0` 이 항상 참이 되어 그 호출마다 압축이 돈다.
   `version_after` 쪽에만 있던 0 가드를 `version_before` 에도 넣었다.
   멱등이라 정합성 문제는 없지만 압축이 무거운 연산이라 비대칭을 남길
   이유가 없다.

3) 테스트 주석이 실제보다 한 단계 과장돼 있었다 (LOW)

   "modulo 트리거가 놓치는 경우" 라고 적었는데, modulo 로 되돌렸을 때
   실패하는지는 압축이 만드는 버전 수까지 얽힌 산술에 달려 있어 보장되지
   않는다. 이 테스트가 확실히 잡는 것은 "삭제 경로에 압축이 아예 없음"
   이므로 그렇게 고쳐 적었다.

미반영(후속): `flush_vector_deletes` 가 `crate::ingest::` 에 있어 reset 이
거기서 부르는 구조(호출부가 셋이 되면 옮긴다), `purge_deleted_workspace_path`
가 트랜잭션을 안 써서 남는 잔여 고아 창(이 PR 이 만든 문제도, 이 계층에서
닫을 수 있는 문제도 아니다).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017c9JwQq8ZkGvYjpKXMiDhF
2026-08-16 17:44:18 +09:00
..