docgraph_search
Destructive
Full-text search across indexed documents. Returns matching documents and headings with snippets. Filter by governance, research, audience, or entity.
Instructions
Full-text search across all indexed Markdown documents. Returns matching documents and headings with snippets. For topic-level context, prefer docgraph_context which combines search with structure. Use governance and research filters to constrain retrieval without adding separate tools. Result paths carry a '#heading:line' suffix and (in workspace mode) a '[project/]' prefix — strip these to the bare file path before passing a path to docgraph_node / docgraph_graph / docgraph_context (a heading result also prints its bare 'parent document:' path for this).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| allowed_audience | No | Filter to documents available to an audience label. Public documents are included. | |
| analyst_status | No | Filter by research analyst_status. Requires metadata reindex. | |
| as_of_date | No | Evaluate effective_date and valid_until against YYYY-MM-DD. | |
| canonical_source | No | Filter by canonical source marker or value. Requires metadata reindex. | |
| claim_id | No | Filter by research claim_id. Requires metadata reindex. | |
| confidence | No | Filter by research confidence (e.g. high, medium, low). Requires metadata reindex. | |
| entity_id | No | Filter to documents that mention a specific entity UUID. | |
| entity_type | No | Filter to documents that mention entities of this type (e.g. person, organization). | |
| include_code | No | Include code_file results from the code_doc pack alongside documentation. Default false (docs only). | |
| kind | No | Filter by node kind: document, heading, definition, tag. Code files (code_doc pack) are excluded by default; pass kind=code_file or include_code=true to surface them. | |
| limit | No | Max results (default 10) | |
| project | No | Workspace mode only: scope results to a single project by name (the directory name shown in docgraph_status). Omit to query all projects. No-op in single-store mode. | |
| query | Yes | Search terms | |
| sensitivity | No | Filter by sensitivity (e.g. public, internal, confidential, restricted). Requires metadata reindex. | |
| source_type | No | Filter by research source_type (e.g. primary, secondary, internal). Requires metadata reindex. | |
| status | No | Filter by governance status (e.g. approved, draft, superseded). Requires metadata reindex. |