FirmVault 検索
FirmVaultケースコーパスから文書を意味的類似性と構造化フィルターで取得します。qmd queryとPythonラッパーをベースに、フロントマターベースのフィルターとケーススコープの自動検出を追加しています。
使用タイミング
- 「Whaley v. Acmeケース内のDr. Smithの診療記録を見つけて」
- 「2025年10月の医療記録をすべて表示して」
- 「先月、保険調整官は何と言った?」
- 「回旋腱板の手術記録を複数ケース横断で検索」
- 「アクティブケース内のState Farmとのすべての通信を見つけて」
- 「Acme案件の法務提出書類を取得して」
呼び出し方法
uv run firmvault_search "<検索テキスト>" \
[--scope all|case|<スラッグ>] \
[--category medical|legal|insurance|communication] \
[--case <スラッグ>] \
[--date 2025-10-15] \
[--date-range 2025-10-01..2025-10-31] \
[--provider <名前>] \
[--limit 10]
出力はJSON配列です。各ヒットは1つのオブジェクトとして返されます:
{
"file_path": "/Users/.../FirmVault/cases/<スラッグ>/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/<スラッグ>/を探します。見つかれば、検索スコープは自動的にそのスラッグに制限されます。 - そのような祖先が存在しない場合、検索は全ケース横断(all cases)にフォールバックします。
--scope=allを渡すと強制的に全ケース横断検索になります。--scope=<スラッグ>を渡すと特定のケースを明示的にターゲットにできます。
フィルター
--category—document_categoryの完全一致(medical|legal|insurance|communication)--case—case_slugの完全一致(--scope=<スラッグ>の代替)--date—document_dateの完全一致(YYYY-MM-DD)--date-range START..END—document_dateの包括範囲--provider—provider/sender/recipientに対する大文字小文字を区別しない部分一致--limit— 返される最大ヒット数(デフォルト10)
フィルターはPython側でマークダウンフロントマターに対して後処理で適用されるため、インデックス化されていないフィールドでも機能します。
ヒント
- 先頭ヒットの
file_pathをReadツールで読み取り、ユーザーに詳細を提示してください。 - 「すべてのXを検索」のようなクエリでは、
--limit 25以上に設定して要約してください。 snippetは一目でのスキャンに使い、必要な場合のみReadで完全なファイルを読み取ってください。- ケースディレクトリ内にいる場合は、
--scopeを省略すると自動的にケーススコープに制限された結果が得られます。