find_evidence
Search vault docs for a concept title and get ranked matches with prose excerpts, showing where the concept appears in code or docs.
Instructions
Find vault docs that mention a given concept by title. Useful when an AI agent asks where a capability is realized in code or docs. Each match includes a prose excerpt (max 200 chars, headings/tables/code skipped) so agents see what the matching doc says without an extra get_concept call. Matches are RANKED by a deterministic relevance score (title match > frontmatter ref > body, plus a title token-overlap tiebreaker), then by whether the doc is a graph node, then slug — best-first. A vault holds ordinary markdown too (meeting notes, memos, drafts have no kind: and are not graph nodes); every row says which it is via isNode, non-nodes rank below nodes of equal relevance, and nodesOnly: true filters them out. Do not cite a non-node as graph evidence without saying so. Pass limit for the top-N. When zero docs mention the title, the response includes a growthHint — near-titled vault nodes to check first, or an add_concept scaffold if the concept looks genuinely new.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Return only the top-N highest-scoring matches. Omit for all matches (still ranked). | |
| title | Yes | Concept title to search for (case-insensitive substring match). | |
| nodesOnly | No | Return only graph nodes (docs with a `kind:`). Default false — ordinary markdown in the same folder is included and marked `isNode: false`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| matches | Yes | ||
| bodyHint | No | Only present when at least one match returned a partial excerpt — names the get_concepts({ body: "full" }) call that returns the rest. | |
| growthHint | No | Only present when matches is empty — near-titled vault node(s) to check, or an add_concept scaffold, derived from the real vault title set. | |
| nonNodeHint | No |