Búsqueda en FirmVault
Recupera documentos del corpus de casos de FirmVault mediante similitud semántica y filtros estructurados. Respaldado por qmd query y un envoltorio en Python que añade filtros basados en frontmatter y detección automática del ámbito del caso.
Cuándo usar
- "Encuentra las notas del Dr. Smith en el caso Whaley v. Acme"
- "Muéstrame todos los registros médicos de octubre de 2025"
- "¿Qué dijo el ajustador de seguros el mes pasado?"
- "Busca en todos los casos registros de cirugía que mencionen manguito rotador"
- "Encuentra toda la correspondencia con State Farm en el caso activo"
- "Trae las presentaciones legales del asunto Acme"
Cómo llamarlo
uv run firmvault_search "<texto de 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 <nombre>] \
[--limit 10]
La salida es un arreglo JSON — un objeto por resultado:
{
"file_path": "/Users/.../FirmVault/cases/<slug>/medical/2025-10-15-dr-smith-visit.md",
"score": 0.87,
"snippet": "El paciente se presentó con...",
"frontmatter_excerpt": {
"case_slug": "whaley-v-acme",
"document_category": "medical",
"document_date": "2025-10-15",
"provider": "Dr. Smith Clinic",
"document_type": "office_visit_note"
}
}
Detección automática del ámbito
Si no se proporciona --scope O se usa --scope=case:
- La CLI sube desde el directorio actual buscando
FirmVault/cases/<slug>/. Si lo encuentra, la búsqueda se limita a ese slug automáticamente. - Si no existe tal ancestro, la búsqueda se realiza en todos los casos.
Usa --scope=all para forzar la búsqueda en todos los casos. Usa --scope=<slug> para apuntar explícitamente a un caso específico.
Filtros
--category— coincidencia exacta condocument_category(medical|legal|insurance|communication)--case— coincidencia exacta concase_slug(alternativa a--scope=<slug>)--date— coincidencia exacta condocument_date(YYYY-MM-DD)--date-range START..END— rango inclusivo dedocument_date--provider— coincidencia de subcadena sin distinción de mayúsculas enprovider/sender/recipient--limit— máximo de resultados devueltos (por defecto10)
Los filtros se aplican del lado de Python como post-filtro sobre el frontmatter de Markdown, por lo que los campos no indexados aún funcionan.
Consejos
- Lee la ruta del archivo del primer resultado con la herramienta Read para mostrar detalles al usuario.
- Para consultas de "encuentra todo X", establece
--limit 25o más y resume. - Usa el
snippetpara un vistazo rápido — solo lee los archivos completos cuando sea necesario. - Cuando estés dentro de un directorio de caso, omite
--scopepara obtener resultados limitados al caso automáticamente.