Pesquisa FirmVault
Recupere documentos do corpus de casos do FirmVault por similaridade semântica + filtros estruturados. Baseado em qmd query e um wrapper Python que adiciona filtros baseados em frontmatter e detecção automática de escopo do caso.
Quando usar
- "Encontrar as anotações do Dr. Smith no caso Whaley v. Acme"
- "Mostre-me todos os registros médicos de outubro de 2025"
- "O que o ajustador de seguros disse no mês passado?"
- "Pesquisar entre casos por registros de cirurgia mencionando manguito rotador"
- "Encontrar toda a correspondência com a State Farm no caso ativo"
- "Abrir arquivos legais do assunto Acme"
Como chamar
uv run firmvault_search "<texto da consulta>" \
[--scope all|case|<slug>] \
[--category medical|legal|insurance|communication] \
[--case <slug>] \
[--date 2025-10-15] \
[--date-range 2025-10-01..2025-10-31] \
[--provider <nome>] \
[--limit 10]
A saída é um array JSON — um objeto por resultado:
{
"file_path": "/Users/.../FirmVault/cases/<slug>/medical/2025-10-15-dr-smith-visit.md",
"score": 0.87,
"snippet": "Paciente apresentou-se com...",
"frontmatter_excerpt": {
"case_slug": "whaley-v-acme",
"document_category": "medical",
"document_date": "2025-10-15",
"provider": "Clínica Dr. Smith",
"document_type": "office_visit_note"
}
}
Detecção automática de escopo
Se --scope não for fornecido OU --scope=case:
- A CLI sobe a partir do diretório de trabalho atual procurando por
FirmVault/cases/<slug>/. Se encontrado, a pesquisa é escopada automaticamente para esse slug. - Se nenhum ancestral desse tipo existir, a pesquisa recai para entre casos (todos os casos).
Passe --scope=all para forçar entre casos. Passe --scope=<slug> para segmentar um caso específico explicitamente.
Filtros
--category— correspondência exatadocument_category(medical|legal|insurance|communication)--case— correspondência exatacase_slug(alternativa a--scope=<slug>)--date— correspondência exatadocument_date(YYYY-MM-DD)--date-range START..END— intervalo inclusivo dedocument_date--provider— correspondência de substring sem distinção entre maiúsculas/minúsculas emprovider/sender/recipient--limit— máximo de resultados retornados (padrão10)
Os filtros são aplicados no lado Python como pós-filtro no frontmatter Markdown, para que campos não indexados ainda funcionem.
Dicas
- Leia o
file_pathdo resultado principal com a ferramenta Read para mostrar detalhes ao usuário. - Para consultas do tipo "encontrar todos os X", defina
--limit 25ou mais e faça um resumo. - Use o
snippetpara uma varredura rápida — só leia os arquivos completos quando necessário. - Quando estiver dentro de um diretório de caso, omita
--scopepara obter resultados automaticamente escopados ao caso.