@oomkapwn/enquire-mcp 0.7.4

package/README.md

@@ -0,0 +1,358 @@
+<div align="center">
+
+<a href="https://github.com/oomkapwn/enquire-mcp"><img src="./assets/social-preview.png" alt="enquire — MCP server for Obsidian vaults. Wikilinks, frontmatter, backlinks, Dataview, MCP resources & prompts. Named after Tim Berners-Lee's 1980 prototype of the WWW." width="100%"></a>
+
+# enquire
+
+### MCP server for Obsidian vaults
+
+**Give Claude Code, Cursor, Codex, and Devin first-class access to your Obsidian vault — wikilinks resolved, frontmatter typed, backlinks indexed, Dataview queries, MCP resources, and read-only safety by default.**
+
+[![CI](https://github.com/oomkapwn/enquire-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/oomkapwn/enquire-mcp/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@oomkapwn/enquire-mcp.svg)](https://www.npmjs.com/package/@oomkapwn/enquire-mcp)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](./LICENSE)
+[![Node](https://img.shields.io/badge/node-%E2%89%A520-brightgreen.svg)](#develop)
+[![MCP](https://img.shields.io/badge/MCP-1.29-8A2BE2.svg)](https://modelcontextprotocol.io/)
+[![tests](https://img.shields.io/badge/tests-140%20passing-brightgreen.svg)](#develop)
+[![coverage](https://img.shields.io/badge/coverage-82%25%20lines-brightgreen.svg)](#develop)
+[![lint](https://img.shields.io/badge/lint-biome-60a5fa.svg)](https://biomejs.dev/)
+
+</div>
+
+> **enquire** is an [MCP](https://modelcontextprotocol.io/) server purpose-built for **[Obsidian](https://obsidian.md/) vaults**. Drop it in front of any vault and your AI assistant stops guessing at filesystem paths and starts reasoning about your notes the way you do — following `[[wikilinks]]`, respecting frontmatter, walking backlinks, running Dataview-style queries, all over stdio MCP.
+>
+> Named after [**ENQUIRE**](https://en.wikipedia.org/wiki/ENQUIRE) — the program Tim Berners-Lee wrote at CERN in 1980 to track «the complex web of relationships between people, programs, machines and ideas». ENQUIRE was the direct prototype of the World Wide Web. enquire-mcp brings the same idea to your AI: hyperlinked notes, structured access, no plugin required.
+
+```text
+You:    "What was I working on yesterday in the Apollo project?"
+Claude: → obsidian_get_recent_edits({ since_minutes: 1440, folder: "01_Projects" })
+        → obsidian_read_note({ title: "Apollo" })
+        → obsidian_get_backlinks({ title: "Apollo" })
+        "You shipped the v0.3 spec, opened 3 open questions in [[Apollo/Open Threads]],
+        and 2 daily notes link back to it. Top blocker: the auth review."
+```
+
+---
+
+## Why enquire exists (vs other Obsidian-MCP options)
+
+There are several Obsidian-MCP servers out there. enquire differentiates on three axes — **standalone**, **read-rich**, and **safe-by-default**:
+
+| Capability (✅ = good for you) | Most Obsidian-MCPs | enquire |
+|---|:---:|:---:|
+| Works with `.md` files | ✅ | ✅ |
+| **Standalone** — runs without Obsidian's Local REST API plugin | ❌ usually requires it | ✅ direct vault read |
+| Resolves `[[Wikilink]]` with alias, section, block, `../` relative | partial | ✅ full |
+| Surfaces `![[Embed]]` separately from links | ❌ | ✅ |
+| Finds every note linking to X (**backlinks**) | rare | ✅ ranked + snippets |
+| Finds every **broken `[[wikilink]]`** in the vault | ❌ | ✅ vault-hygiene tool |
+| Lists **outbound links** for one note with resolution status | ❌ | ✅ |
+| Built-in **Dataview-style queries** (`LIST` / `TABLE`, `AND`/`OR`, `LIKE`) | only via Obsidian plugin | ✅ first-class |
+| **MCP resources** for browsing the vault as a tree | ❌ | ✅ |
+| **MCP prompts** (`summarize_recent`, `weekly_review`, `find_orphans`, `extract_todos`, `process_inbox`) | ❌ | ✅ 6 prompts |
+| **Read-only by default** (write tools require explicit flag) | ❌ usually write-default | ✅ `--enable-write` |
+| Symlink-escape safety, realpath-checked reads & writes | rare | ✅ |
+| Persistent on-disk cache for warm cold-starts | ❌ | ✅ `--persistent-cache` |
+| TypeScript strict + Biome lint + 140 unit tests | varies | ✅ |
+
+That's the gap. enquire closes it in ~2000 lines of TypeScript and four runtime dependencies.
+
+> **Not affiliated with Obsidian.md.** Obsidian and the Obsidian logo are trademarks of Dynalist Inc. enquire-mcp is an independent open-source project that reads Obsidian-format vaults. The name «enquire» is a tribute to Tim Berners-Lee's 1980 hypertext system, not a trademark claim against any party.
+
+---
+
+## Who is this for?
+
+- **Obsidian users on Claude Code / Cursor / Codex / Devin** (or any MCP-compatible client) who want the assistant to draft notes that actually link properly, follow `[[…]]`, and respect frontmatter.
+- **Agentic workflow builders** who need a structured layer over a markdown vault — `dataview_query`, `get_backlinks`, `list_tags` are the kind of primitives that compose into real automations.
+- **Tinkerers** who want to wire their PKM into LLM pipelines without writing a parser. We did the parsing.
+
+---
+
+## Quick start
+
+```bash
+# 1. Get the code
+git clone https://github.com/oomkapwn/enquire-mcp
+cd enquire-mcp && npm install && npm run build
+
+# 2. Wire into Claude Code (~/.claude.json or .mcp.json)
+```
+
+```json
+{
+  "mcpServers": {
+    "obsidian": {
+      "command": "node",
+      "args": [
+        "/absolute/path/to/enquire-mcp/dist/index.js",
+        "serve",
+        "--vault", "/Users/you/Documents/Obsidian Vault"
+      ]
+    }
+  }
+}
+```
+
+<details>
+<summary><b>Or use <code>npx</code> (no global install)</b></summary>
+
+```json
+{
+  "mcpServers": {
+    "obsidian": {
+      "command": "npx",
+      "args": ["-y", "@oomkapwn/enquire-mcp", "serve", "--vault", "/Users/you/Documents/Obsidian Vault"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><b>Or install globally</b></summary>
+
+```bash
+npm install -g @oomkapwn/enquire-mcp
+enquire-mcp serve --vault ~/Documents/Obsidian\ Vault
+```
+
+</details>
+
+Restart your client. The server logs `enquire <version> ready (read-only, vault=…)` on stderr — that's your "it's connected" signal.
+
+---
+
+## What you get
+
+### 10 read tools (always on)
+
+| Tool | What it does |
+|---|---|
+| `obsidian_list_notes` | Filter by tag / folder / modified-since. Returns title, path, frontmatter, tags, mtime — newest first. |
+| `obsidian_read_note` | Body + frontmatter + wikilinks + embeds + tags for a note (by path or title). |
+| `obsidian_resolve_wikilink` | `[[Note]]`, `[[Note#Heading]]`, `[[Folder/Note\|alias]]`, `![[Embed]]`, `[[../relative/path]]` — all resolved to a real file. |
+| `obsidian_search_text` | Ranked case-insensitive substring search with snippets and line numbers. |
+| `obsidian_get_recent_edits` | Newest-first stream, optional time window. |
+| `obsidian_get_backlinks` | Every note linking the target, ranked by hit count, with snippets. Distinguishes wikilink vs embed vs mixed. |
+| `obsidian_get_outbound_links` | Symmetric counterpart to backlinks — every link a note points to, with resolution status. |
+| `obsidian_get_unresolved_wikilinks` | Vault-hygiene: every `[[broken]]` link in the vault. |
+| `obsidian_list_tags` | Every unique tag with frontmatter / inline counts. |
+| `obsidian_dataview_query` | `LIST` / `TABLE` with `FROM`, `WHERE`, `SORT`, `LIMIT`. Supports `AND` / `OR` / `=` / `!=` / `contains` / `like`. |
+
+### 2 write tools (opt-in via `--enable-write`)
+
+| Tool | What it does |
+|---|---|
+| `obsidian_create_note` | Create a note with optional frontmatter. Refuses to overwrite by default. |
+| `obsidian_append_to_note` | Append a markdown block to an existing note. Configurable separator. |
+
+### MCP resources
+
+- `obsidian://vault/info` — root, note count, write flag, byte/cache limits, server version.
+- `obsidian://note/{path}` — every note as a first-class browsable resource. Compatible clients show your vault as a tree.
+
+### MCP prompts
+
+| Prompt | Args | What it scaffolds |
+|---|---|---|
+| `summarize_recent_edits` | `since_minutes?` | "What was I working on?" workflow. |
+| `review_tag` | `tag` | Pull every note for a tag, surface open threads. |
+| `find_orphans` | `folder?` | Notes with zero inbound links — archive candidates. |
+| `weekly_review` | `folder?` | Last 7 days of edits, grouped by tag — shipped / open / stuck. |
+| `extract_todos` | `folder?`, `tag?` | Every TODO / FIXME / QUESTION, grouped by note. |
+| `process_inbox` | `folder` | Move / Merge / Promote / Archive proposals for an inbox folder. |
+
+---
+
+## Example workflows
+
+### 1. Scan tagged ideas
+> "Show me notes tagged `#idea` from the last two weeks."
+
+`obsidian_list_notes({ tag: "idea", since_date: "2026-04-18" })`
+
+### 2. Follow wikilinks
+> "Read [[Project Apollo]] and summarise the open questions."
+
+`obsidian_resolve_wikilink({ wikilink: "Project Apollo" })` → walk any `[[…]]` inside the result.
+
+### 3. Pick up where you left off
+> "What was I editing today?"
+
+`obsidian_get_recent_edits({ since_minutes: 720 })`
+
+### 4. Audit a hub note
+> "Which notes link to [[Project Apollo]]?"
+
+`obsidian_get_backlinks({ title: "Project Apollo" })` → ranked list with snippets.
+
+### 5. Run a Dataview-style query
+> "List active ideas, sorted by mtime."
+
+```text
+TABLE status FROM #idea WHERE status = "active" SORT file.mtime DESC
+```
+
+### 6. Daily journaling (write mode)
+> "Append a 'shipped today' bullet to today's daily note."
+
+With `--enable-write`: `obsidian_append_to_note({ title: "2026-05-03", content: "- Shipped enquire v0.7.1" })`
+
+---
+
+## Architecture
+
+```
+┌─────────────────┐     stdio JSON-RPC     ┌─────────────────────┐
+│  Claude Code /  │ ◄────────────────────► │   enquire           │
+│  Cursor / Codex │   tools/resources/     │  (this server)      │
+└─────────────────┘   prompts                └─────────┬───────────┘
+                                                      │
+                                          ┌───────────┼────────────┐
+                                          │           │            │
+                                          ▼           ▼            ▼
+                                    ┌─────────┐ ┌──────────┐ ┌──────────┐
+                                    │ Vault   │ │  Parser  │ │   DQL    │
+                                    │ walker  │ │  (gray-  │ │  engine  │
+                                    │ + cache │ │  matter) │ │          │
+                                    └────┬────┘ └──────────┘ └──────────┘
+                                         │
+                                         ▼
+                                ┌─────────────────────┐
+                                │  ~/Documents/       │
+                                │  Obsidian Vault/    │
+                                │  *.md *.md *.md ... │
+                                └─────────────────────┘
+```
+
+- **Vault walker** — recursive, skips `.git` / `.obsidian` / `.trash` / dot-dirs / symlinks. Realpath-checks every read and write to prevent symlink-escape attacks.
+- **Cache** — mtime-keyed, LRU-evicted. Default cap 1024 entries.
+- **Parser** — `gray-matter` for YAML, hand-rolled regex for wikilinks / embeds / tags. Fenced code blocks are stripped before tag extraction.
+- **DQL engine** — quote-aware tokenizer for keywords (`FROM`, `WHERE`, `SORT`, `LIMIT`, `AND`); won't mis-split on `WHERE x = "foo SORT bar"`.
+
+---
+
+## Configuration
+
+| Flag | Default | What it does |
+|---|---|---|
+| `--vault <path>` | (required) | Path to the Obsidian vault root. |
+| `--enable-write` | off | Register the two write tools. Server is otherwise strictly read-only. |
+| `--max-file-bytes <n>` | 5 MB | Refuse to read or write any file larger. |
+| `--cache-size <n>` | 1024 | LRU cap for the parsed-note cache. |
+| `--persistent-cache` | off | Persist parsed-note cache to disk; warm cold-starts on large vaults. **Privacy: full note bodies are written to the cache file. See "Cache & privacy" below.** |
+| `--cache-file <path>` | auto | Override persistent-cache file location. |
+
+### Cache & privacy
+
+When `--persistent-cache` is on, parsed notes are serialized to disk so subsequent server restarts skip re-parsing. By default the file lives at `~/Library/Caches/enquire/<sha1>.json` on macOS, `~/.cache/enquire/<sha1>.json` on Linux. Important caveats:
+
+- **Full note bodies are stored**, not just metadata. Anyone who can read your home cache directory can read your vault.
+- **File mode is `0600`** (user-read/write only) and the parent directory is `0700`. We don't trust shared home directories.
+- **Deleted notes are purged** on the next server start: when enquire sees a cached entry whose source file no longer exists, it drops the entry from memory and rewrites the cache file without it on shutdown.
+- **Stale entries** (file mtime changed since cache write) are silently dropped on load; the source file is re-parsed.
+- **Manual purge:** run `enquire-mcp clear-cache --vault <path>` to delete the cache file for a specific vault.
+- The cache file is **never read or written for vaults other than the one whose realpath matches the cache file's `root` field** — protects against cross-vault content leaks if you share a cache dir.
+
+The server logs `WRITE-ENABLED` to stderr on boot when the flag is on, so you can verify the mode at a glance.
+
+---
+
+## Security
+
+- **Read-only by default.** Write tools are not even registered unless `--enable-write` is passed.
+- **Path traversal blocked.** Every resolved path is checked against the vault root via `realpath`.
+- **Symlink-escape blocked.** Symlinks inside the vault that resolve outside (file or directory) are skipped on listing and rejected on read/write.
+- **DoS guard.** Default 5 MB cap on any single file read or write; bounded LRU cache.
+- **YAML.** Parsed via `gray-matter` (`js-yaml` `safeLoad` under the hood) — no code execution.
+
+Found a security issue? See [SECURITY.md](./SECURITY.md).
+
+---
+
+## FAQ
+
+**Does it support Roam / Logseq / TiddlyWiki?**
+No. Obsidian's wikilink semantics, frontmatter conventions, and folder structure are baked in. Other tools are out of scope.
+
+**Will it modify my vault?**
+Not unless you start it with `--enable-write`. By default the server is strictly read-only. With write enabled, the two write tools refuse to overwrite existing notes (`obsidian_create_note` requires `overwrite=true`) and refuse to write outside the vault even if a parent dir is symlinked away.
+
+**Does it work over the network?**
+No. It's a local stdio MCP server, designed for one client process per vault. There's no HTTP transport, no auth, no rate limiting — and that's intentional.
+
+**My DQL query returned nothing.**
+Verify the source. `LIST FROM "01_Projects"` matches notes whose path starts with `01_Projects/`. `LIST FROM #idea` matches notes carrying the `idea` tag. Mix them with `WHERE`. See [docs/api.md](./docs/api.md) for the supported subset and grammar.
+
+**What about the full Dataview plugin?**
+We implement a deliberately small subset (`LIST` / `TABLE`, `FROM "folder" | #tag`, `WHERE pred (AND|OR pred)*`, `SORT`, `LIMIT`; ops `=`, `!=`, `contains`, `like`). No arithmetic / functions / `FLATTEN` / `GROUP BY` / joins / parenthesized precedence. PRs that close those gaps are welcome — see [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+**How big a vault can it handle?**
+Tested daily against a 117-note vault. The walker is O(notes) per call; the cache makes repeat reads O(1). For 10k+ vaults a persistent index would help — that's on the Phase 3 roadmap.
+
+**Why scoped npm name (`@oomkapwn/enquire-mcp`)?**
+A scoped name protects the brand and side-steps the very crowded `obsidian-mcp` / `mcp-obsidian` namespace on npm. The CLI binary is `enquire-mcp` to match the npm package name.
+
+---
+
+## Develop
+
+```bash
+npm test              # 130+ unit tests
+npm run test:coverage # vitest --coverage (v8 provider)
+npm run lint          # biome check
+npm run lint:fix      # biome check --write (auto-fixes)
+npm run dev           # tsc --watch
+node scripts/smoke.mjs [vault-path]   # end-to-end JSON-RPC smoke
+```
+
+Coverage on the latest release: **82% lines · 78% statements · 73% branches**. CI uploads the full HTML report as a workflow artifact (`coverage-report`).
+
+Build runs `tsc` and marks `dist/index.js` executable. CI tests Node 20 / 22 / 24, runs the smoke against a synthetic vault, generates a coverage report, and runs `npm audit --audit-level=high`.
+
+---
+
+## Troubleshooting
+
+- **"Vault not found" on boot** — pass an absolute path or `~`-prefixed shell-expanded path to `--vault`. Relative paths resolve against the process cwd.
+- **"Path escapes vault root"** — the path you passed (or a wikilink resolved to) leaves the vault, often via a symlink. The server intentionally refuses these reads.
+- **"File too large" on a `.md` you didn't expect** — usually a sync conflict or binary accidentally renamed `.md`. Bump `--max-file-bytes` if you really want it ingested.
+- **Write tool not visible to the client** — start the server with `--enable-write`, *after* the `serve` subcommand.
+- **Russian / non-ASCII titles** — supported. Both inline `#тег` and YAML `tags: [идея]` are picked up.
+
+---
+
+## Versioning & releases
+
+Semantic versioning. See [CHANGELOG.md](./CHANGELOG.md) for the full history.
+
+- **0.7.x** — current. Renamed twice (`obsidian-mcp` → `memex` → `enquire-mcp`) to escape the crowded `obsidian-mcp` namespace and to land on a name with a clear historical referent — Tim Berners-Lee's 1980 ENQUIRE prototype of the Web. 10 read tools, 2 opt-in write tools, MCP resources + prompts, persistent on-disk cache (opt-in), DQL with `AND`/`OR`/`LIKE`, hardened security.
+- **Roadmap** — graph queries (multi-hop, hub/orphan detection); refactoring tools (`rename_note`, `rename_tag` with wikilink rewrite); DQL expressions / parentheses / `FLATTEN` / `GROUP BY`; performance benchmarks against 10k+ vaults.
+
+---
+
+## Contributing
+
+Bug fixes welcome. New tools should pass the bar of "useful against an Obsidian vault on day 1." See [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+---
+
+## Support the project
+
+If enquire-mcp saves you keystrokes or makes your AI assistant smarter about your vault, **consider [starring the repo](https://github.com/oomkapwn/enquire-mcp) to show your ❤️ and support.** Stars help other Obsidian users find the project, and they tell us where to invest the next cycle.
+
+Other ways to help:
+- 🐛 **File a bug** — the more concrete the repro (vault shape, exact tool call, server stderr), the faster the fix. Use [the bug template](https://github.com/oomkapwn/enquire-mcp/issues/new?template=bug_report.yml).
+- 💡 **Propose a feature** — open a [feature request](https://github.com/oomkapwn/enquire-mcp/issues/new?template=feature_request.yml) and we'll align on scope before any code is written.
+- 🔧 **Send a PR** — bug fixes always welcome. New tools should pass the «useful against an Obsidian vault on day 1» bar. See [CONTRIBUTING.md](./CONTRIBUTING.md).
+- 💬 **Tell us how you use it** — open a thread in [Discussions](https://github.com/oomkapwn/enquire-mcp/discussions) and we'll figure out what to build next from real workflows.
+
+---
+
+## License & credits
+
+[MIT](./LICENSE). Built by [@OomkaBear](https://github.com/oomkapwn). Powered by [Model Context Protocol](https://modelcontextprotocol.io/), [`gray-matter`](https://github.com/jonschlinkert/gray-matter), [`commander`](https://github.com/tj/commander.js), and the patience of one specific Obsidian vault that didn't deserve to be parsed by hand.
+
+Named after [ENQUIRE](https://en.wikipedia.org/wiki/ENQUIRE) — the program Tim Berners-Lee wrote at CERN in 1980 to track «the complex web of relationships between people, programs, machines and ideas». ENQUIRE was the direct prototype of the World Wide Web. enquire-mcp brings the same idea to your AI: hyperlinked notes, structured access, no plugin required.

package/SECURITY.md

@@ -0,0 +1,49 @@
+# Security policy
+
+## Reporting a vulnerability
+
+If you've found a security issue in enquire, **please don't open a public GitHub issue**. Instead:
+
+1. Email the maintainer at `oomkapwn@gmail.com` with the subject `enquire security`.
+2. Include a reproducer if you have one — vault layout, exact CLI flags, the operation that triggered the issue.
+3. Expect an acknowledgement within 72 hours.
+
+I'll work on a fix in private, cut a patch release, and then publicly disclose with credit (or anonymously, your call).
+
+## Scope
+
+In scope:
+- Path traversal, symlink-escape, or any way to read/write files outside the configured vault root
+- Resource exhaustion (DoS) via crafted markdown, frontmatter, or DQL input
+- Unintended code execution via YAML, regex, or input parsing
+- Cache or memory issues that grow unbounded under attacker-controlled input
+
+Out of scope (won't accept reports):
+- Behavior controlled by `--enable-write` — yes, write tools can write notes; that's the point. Reports here need to show writes outside the vault or other privilege escalation.
+- Issues that require a malicious MCP client (the client is the trusted party; if it's compromised, all bets are off).
+- Vulnerabilities in dependencies — please report those upstream first.
+
+## Supported versions
+
+Only the latest minor release receives security patches. We bump the patch version for security fixes and call them out clearly in [CHANGELOG.md](./CHANGELOG.md).
+
+## Hardening already in place
+
+- Realpath-based check on every read and write target — symlinks inside the vault that resolve outside are rejected.
+- Walker skips symlinks entirely.
+- Default 5 MB cap on any single file read or write (configurable via `--max-file-bytes`). Persistent-cache load enforces the same per-entry cap.
+- Bounded parsed-note cache (default 1024 entries, LRU eviction). Persistent cache file is bounded at 50 MB by default.
+- Read-only by default; write tools require an explicit CLI flag.
+- YAML parsed via `gray-matter` (`js-yaml` safeLoad) — no code execution.
+- DQL parser respects quoted strings; no shell, no `eval`, no template expansion. Empty `OR`/`AND` groups and empty `FROM #` / `FROM ""` are rejected to prevent silently-overbroad queries.
+
+## Persistent cache: privacy posture
+
+When `--persistent-cache` is enabled, full note bodies are written to a JSON file under `~/Library/Caches/enquire/` (macOS) or `~/.cache/enquire/` (Linux).
+
+- File mode is **`0600`**, parent directory mode is **`0700`** — restricted to the user account.
+- Cache file is rejected if its `root` field doesn't match the current vault realpath (cross-vault protection).
+- Cache file is rejected if its declared `version` doesn't match the current schema version.
+- Deleted notes: on load, entries whose source file no longer exists are dropped from memory AND the cache is marked dirty so the next save rewrites the file without those entries.
+- Manual purge: `enquire-mcp clear-cache --vault <path>` deletes the cache file.
+- **Caveat:** anyone with read access to your user account can read the cache file. If your threat model includes other local users on the same machine, do not use `--persistent-cache`.

package/dist/dql.d.ts

@@ -0,0 +1,37 @@
+import type { Vault } from "./vault.js";
+export type Source = {
+    type: "all";
+} | {
+    type: "folder";
+    path: string;
+} | {
+    type: "tag";
+    tag: string;
+};
+export type Op = "=" | "!=" | "contains" | "like";
+export interface Predicate {
+    field: string;
+    op: Op;
+    value: string | number | boolean | null;
+}
+/** A WHERE clause is a disjunction of conjunctions: (A AND B) OR (C AND D). */
+export type WhereGroups = Predicate[][];
+export interface DataviewQuery {
+    kind: "LIST" | "TABLE";
+    columns: string[];
+    source: Source;
+    where: WhereGroups;
+    sort?: {
+        field: string;
+        dir: "ASC" | "DESC";
+    };
+    limit?: number;
+}
+export declare class DqlParseError extends Error {
+}
+export declare function parseDql(input: string): DataviewQuery;
+export declare const DEFAULT_DQL_ROW_LIMIT = 1000;
+export declare function runDql(vault: Vault, query: DataviewQuery, opts?: {
+    defaultLimit?: number;
+}): Promise<Array<Record<string, unknown>>>;
+//# sourceMappingURL=dql.d.ts.map

package/dist/dql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dql.d.ts","sourceRoot":"","sources":["../src/dql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,MAAM,MAAM,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvG,MAAM,MAAM,EAAE,GAAG,GAAG,GAAG,IAAI,GAAG,UAAU,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,EAAE,CAAC;IACP,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CACzC;AAED,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GAAG,SAAS,EAAE,EAAE,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,aAAc,SAAQ,KAAK;CAAG;AAI3C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CA8BrD;AA+KD,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,wBAAsB,MAAM,CAC1B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAoCzC"}