Recherche FirmVault
Récupérez des documents du corpus d'affaires FirmVault par similarité sémantique + filtres structurés. Basé sur qmd query et un wrapper Python qui ajoute des filtres frontmatter et la détection automatique du périmètre d'affaire.
Quand l'utiliser
- « Trouvez les notes du Dr. Smith dans l'affaire Whaley c. Acme »
- « Montrez-moi tous les dossiers médicaux d'octobre 2025 »
- « Qu'a dit l'expert en sinistre le mois dernier ? »
- « Recherchez dans toutes les affaires les dossiers chirurgicaux mentionnant la coiffe des rotateurs »
- « Trouvez toute la correspondance avec State Farm dans l'affaire active »
- « Récupérez les pièces juridiques du dossier Acme »
Comment appeler
uv run firmvault_search "<texte de la requête>" \
[--scope all|case|<slug>] \
[--category medical|legal|insurance|communication] \
[--case <slug>] \
[--date 2025-10-15] \
[--date-range 2025-10-01..2025-10-31] \
[--provider <nom>] \
[--limit 10]
La sortie est un tableau JSON — un objet par résultat :
{
"file_path": "/Users/.../FirmVault/cases/<slug>/medical/2025-10-15-dr-smith-visit.md",
"score": 0.87,
"snippet": "Le patient s'est présenté avec...",
"frontmatter_excerpt": {
"case_slug": "whaley-v-acme",
"document_category": "medical",
"document_date": "2025-10-15",
"provider": "Clinique Dr. Smith",
"document_type": "note_de_visite"
}
}
Détection automatique du périmètre
Si --scope n'est pas fourni OU --scope=case :
- La CLI remonte le répertoire courant à la recherche de
FirmVault/cases/<slug>/. Si trouvé, la recherche se limite à ce slug automatiquement. - Si aucun ancêtre de ce type n'existe, la recherche s'étend à toutes les affaires (cross-case).
Passez --scope=all pour forcer la recherche toutes affaires. Passez --scope=<slug> pour cibler explicitement une affaire spécifique.
Filtres
--category— correspondance exacte avecdocument_category(medical|legal|insurance|communication)--case— correspondance exacte aveccase_slug(alternative à--scope=<slug>)--date— correspondance exacte avecdocument_date(YYYY-MM-DD)--date-range DEBUT..FIN— plage inclusive dedocument_date--provider— correspondance partielle insensible à la casse surprovider/sender/recipient--limit— nombre maximum de résultats renvoyés (défaut10)
Les filtres sont appliqués côté Python en post-traitement sur le frontmatter Markdown, ce qui permet de gérer des champs non indexés.
Conseils
- Lisez le chemin
file_pathdu premier résultat avec l'outil Read pour afficher les détails à l'utilisateur. - Pour les requêtes « trouver tous les X », définissez
--limit 25ou plus et résumez. - Utilisez le
snippetpour une vue d'ensemble rapide — ne lisez les fichiers complets que si nécessaire. - Lorsque vous êtes dans un répertoire d'affaire, omettez
--scopepour obtenir automatiquement des résultats limités à cette affaire.