FirmVault 검색
FirmVault 사건 말뭉치에서 의미적 유사도 + 구조적 필터를 통해 문서를 검색합니다. qmd query와 프론트매터 기반 필터 및 사건 범위 자동 감지를 추가하는 Python 래퍼로 구동됩니다.
사용 시기
- "Whaley v. Acme 사건에서 Dr. Smith의 노트를 찾아줘"
- "2025년 10월 의료 기록을 모두 보여줘"
- "보험 조정관이 지난달에 뭐라고 했지?"
- "회전근개 관련 수술 기록을 여러 사건에서 검색해줘"
- "능동 사건에서 State Farm과의 모든 통신문을 찾아줘"
- "Acme 사건의 법률 서류를 불러와"
호출 방법
uv run firmvault_search "<검색어>" \
[--scope all|case|<slug>] \
[--category medical|legal|insurance|communication] \
[--case <slug>] \
[--date 2025-10-15] \
[--date-range 2025-10-01..2025-10-31] \
[--provider <이름>] \
[--limit 10]
출력은 JSON 배열입니다 — 각 결과는 하나의 객체입니다:
{
"file_path": "/Users/.../FirmVault/cases/<slug>/medical/2025-10-15-dr-smith-visit.md",
"score": 0.87,
"snippet": "환자는 ...으로 내원했습니다.",
"frontmatter_excerpt": {
"case_slug": "whaley-v-acme",
"document_category": "medical",
"document_date": "2025-10-15",
"provider": "Dr. Smith Clinic",
"document_type": "office_visit_note"
}
}
범위 자동 감지
--scope가 제공되지 않거나 --scope=case인 경우:
- CLI는 현재 작업 디렉토리에서 상위로 이동하며
FirmVault/cases/<slug>/를 찾습니다. 발견되면 해당 slug로 검색 범위가 자동 설정됩니다. - 그러한 상위 디렉토리가 없으면 검색은 모든 사건을 대상으로 합니다 (cross-case).
--scope=all을 전달하면 모든 사건으로 강제 검색합니다. --scope=<slug>을 전달하면 특정 사건을 명시적으로 대상으로 합니다.
필터
--category—document_category정확히 일치 (medical|legal|insurance|communication)--case—case_slug정확히 일치 (--scope=<slug>의 대안)--date—document_date정확히 일치 (YYYY-MM-DD)--date-range START..END— 포함하는document_date범위--provider—provider/sender/recipient에 대한 대소문자 구분 없는 부분 문자열 일치--limit— 반환되는 최대 결과 수 (기본값10)
필터는 마크다운 프론트매터에 대해 Python 측 후처리로 적용되므로, 인덱싱되지 않은 필드도 작동합니다.
팁
- 상위 결과의
file_path를 읽기 도구로 열어 사용자에게 세부 정보를 보여주세요. - "모든 X 찾기" 질의의 경우
--limit 25이상으로 설정하고 요약하세요. snippet을 한눈에 훑어보는 데 사용하고, 필요한 경우에만 전체 파일을 읽으세요.- 사건 디렉토리 내부에 있을 때는
--scope를 생략하면 자동으로 사건 범위 내 결과가 반환됩니다.