Function dataviewQuery

dataviewQuery(
vault: Vault,
args: { query: string },
): Promise<{ query: string; rows: Record<string, unknown>[] }>
Run a Dataview-style DQL query against the vault.

Parses the input with the project's DQL frontend (see src/dql.ts) and executes against the live vault index. Supports a subset of Dataview's syntax: TABLE / LIST projections, WHERE clauses, FROM "folder" / FROM #tag sources, SORT, LIMIT, GROUP BY. No formula evaluator — pure field projection + boolean filters (formula evaluator deferred per v3.6.0 non-goals).
Parameters
- vault: Vault
  The vault to query.
- args: { query: string }
  query is the DQL string.
Returns Promise<{ query: string; rows: Record<string, unknown>[] }>
{ query, rows } — rows is an array of objects keyed by the projected fields.
Throws
If the DQL fails to parse or references an unknown source.
Example
```
const r = await dataviewQuery(vault, {
  query: 'TABLE status, mtime FROM "Posts" WHERE status = "draft" SORT mtime DESC'
});
for (const row of r.rows) console.log(row);
```
- Defined in tools/read.ts:476