Function frontmatterSearch

frontmatterSearch(
    vault: Vault,
    args: FrontmatterSearchArgs,
): Promise<
    {
        key: string;
        matches: { mtime: string; path: string; value: unknown }[];
        total_matches: number;
    },
>
Find every note whose frontmatter matches a predicate.

Useful as a precursor to bulk operations like frontmatterSet: "find all notes with status: draft and set their status to published", or "find notes whose aliases array contains a typo". Single predicate per call by design — combine with multiple calls if you need AND/OR logic.
Parameters
- vault: Vault
  The vault to scan.
- args: FrontmatterSearchArgs
  FrontmatterSearchArgs. key is required and exactly one of equals / exists / contains must be set.
Returns Promise<
    {
        key: string;
        matches: { mtime: string; path: string; value: unknown }[];
        total_matches: number;
    },
>
{ key, total_matches, matches } — total_matches equals matches.length (counts the truncated result, not the full count).
Throws
If key is empty or the predicate count is not exactly 1.

Throws
If folder resolves outside the vault.
Example
```
// Find every draft
const drafts = await frontmatterSearch(vault, {
  key: "status",
  equals: "draft",
  limit: 50
});

// Find every note whose `aliases` array contains "RAG"
const rag = await frontmatterSearch(vault, {
  key: "aliases",
  contains: "RAG"
});
```
- Defined in tools/read.ts:1103