From 221000d82f13ea5d0d6e61a7df702e6dcea7b11e Mon Sep 17 00:00:00 2001 From: Aditya Mukhopadhyay Date: Thu, 8 Oct 2026 15:43:54 +0530 Subject: [PATCH] docs: point wiki links at the versioned docs site The wiki is replaced by project-minigraf/minigraf-docs, which documents every release from v2.0.0 on, with v3.0.0 next to v2.x. README and ERROR_REFERENCE links now go to the site's latest/ permalinks, and the CLAUDE.md doc-sync step names the site's content files and its @since/@until annotations instead of the wiki. Historical plans and specs under docs/superpowers keep their wiki links. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_012wXxZguv7PgKQjMMH4yJ5h --- CLAUDE.md | 2 +- README.md | 22 ++++----- docs/ERROR_REFERENCE.md | 100 ++++++++++++++++++++-------------------- 3 files changed, 62 insertions(+), 62 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 10e2427405..4cba5ad6c4 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -247,7 +247,7 @@ Applies to all `#[cfg(test)]` modules and all `tests/*.rs` files. 6. **Think SQLite** — would SQLite do this? 7. **Long-term vision** — building for decades 8. **Keep documentation synchronized** — when a release or planned-work item changes, update and cross-check ALL of: `CLAUDE.md` (status line, test count), `ROADMAP.md`, `README.md`, `docs/TEST_COVERAGE.md`, `CHANGELOG.md`. No doc should contradict another. - Also update affected wiki pages in `.wiki/`: `Architecture.md` (module/format/model changes), `Datalog-Reference.md` (new syntax), `Comparison.md` (feature matrix), `Use-Cases.md` (deployment targets). Commit and push the wiki repo separately (`cd .wiki && git add -A && git commit -m "..." && git push`). + Also update the docs site, [project-minigraf/minigraf-docs](https://github.com/project-minigraf/minigraf-docs) (clone at `../minigraf-docs`): `content/architecture.md` (module/format/model changes), `content/datalog-reference.md` (new syntax), `content/comparison.md` (feature matrix), `content/use-cases.md` (deployment targets). It documents every release at once: wrap text that applies only from or until a version in `` / `` … `` rather than rewriting shared text, and add each release to its `site.toml` (`CHANGELOG.md` and `docs/ERROR_REFERENCE.md` are read from this repo per tag, never copied). Open a PR there; its CI checks every link in every version and deploys `main`. The GitHub wiki is retired: its pages only link to the site. 9. **Tag every version bump** — after the final doc-sync commit: `git tag -a v -m " — "` then `git push origin v`. --- diff --git a/README.md b/README.md index 1265eec3b1..7d35475136 100644 --- a/README.md +++ b/README.md @@ -141,7 +141,7 @@ See a working implementation of **temporal reasoning** with Minigraf at [github. The **[time travel visualizer](https://project-minigraf.github.io/minigraf-visualizer/)** runs Minigraf in your browser and draws its history. Step through transactions, move the valid-time cursor, and see each fact version on a bitemporal map. It opens `.graph` files too. For example, see [a salary that was recorded wrong and then corrected](https://project-minigraf.github.io/minigraf-visualizer/#sample=careers&tx=7&e=:alice&view=map). -See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference) wiki page for the complete syntax. +See the [Datalog Reference](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/) for the complete syntax. ## Why Minigraf? @@ -166,10 +166,10 @@ No other database offers this combination: | Browser WASM | 2 (experimental) | `@minigraf/browser` on npm | `npm install @minigraf/browser` | | WASI | 2 (experimental) | `@minigraf/wasi` on npm | `npm install @minigraf/wasi` | | Node.js | 2 (experimental) | `minigraf` on npm | `npm install minigraf` | -| Java/JVM | 2 (experimental) | `io.github.project-minigraf:minigraf-jvm` on Maven Central | see [wiki](https://github.com/project-minigraf/minigraf/wiki/Use-Cases) | -| Android | 2 (experimental) | `io.github.project-minigraf:minigraf-android` (`.aar`) on Maven Central | see [wiki](https://github.com/project-minigraf/minigraf/wiki/Use-Cases) | -| iOS / macOS | 2 (experimental) | `.xcframework` via Swift Package Manager ([minigraf-swift](https://github.com/project-minigraf/minigraf-swift)) | see [wiki](https://github.com/project-minigraf/minigraf/wiki/Use-Cases) | -| C / FFI | 2 (experimental) | header + tarball on [minigraf-c releases](https://github.com/project-minigraf/minigraf-c/releases) | see [wiki](https://github.com/project-minigraf/minigraf/wiki/Use-Cases) | +| Java/JVM | 2 (experimental) | `io.github.project-minigraf:minigraf-jvm` on Maven Central | see [docs](https://project-minigraf.github.io/minigraf-docs/latest/use-cases/) | +| Android | 2 (experimental) | `io.github.project-minigraf:minigraf-android` (`.aar`) on Maven Central | see [docs](https://project-minigraf.github.io/minigraf-docs/latest/use-cases/) | +| iOS / macOS | 2 (experimental) | `.xcframework` via Swift Package Manager ([minigraf-swift](https://github.com/project-minigraf/minigraf-swift)) | see [docs](https://project-minigraf.github.io/minigraf-docs/latest/use-cases/) | +| C / FFI | 2 (experimental) | header + tarball on [minigraf-c releases](https://github.com/project-minigraf/minigraf-c/releases) | see [docs](https://project-minigraf.github.io/minigraf-docs/latest/use-cases/) | **Tier 1** bindings are fully tested and released at the same time as every core release. **Tier 2** bindings are built and smoke-tested, released on a best-effort schedule, and experimental. A binding moves to Tier 1 when real users need it. Tier 1 operating systems and filesystems are Linux (ext4, xfs), macOS (APFS) and Windows (NTFS) on local disk; NFSv4 is supported with caveats, and NFSv3 `nolock` is unsupported for multiple writers. Details: [support tiers](PHILOSOPHY.md#support-tiers). @@ -188,7 +188,7 @@ No other database offers this combination: | iOS/macOS | Swift bindings | [minigraf-swift](https://github.com/project-minigraf/minigraf-swift) | | C | C bindings | [minigraf-c](https://github.com/project-minigraf/minigraf-c) | -See the [Comparison](https://github.com/project-minigraf/minigraf/wiki/Comparison) wiki page for detailed analysis including temporal vs. time-series databases. +See the [Comparison](https://project-minigraf.github.io/minigraf-docs/latest/comparison/) page for detailed analysis including temporal vs. time-series databases. ### For AI Agents @@ -216,15 +216,15 @@ try db.execute(datalog: #"(transact [[:alice :person/name "Alice"] [:alice :pers let json = try db.execute(datalog: "(query [:find ?name :where [?e :person/name ?name]])") ``` -See the [Mobile Integration](https://github.com/project-minigraf/minigraf/wiki/Use-Cases#mobile-apps) wiki section for full setup and usage docs (Gradle config, SPM integration, error handling, threading). +See the [Mobile Integration](https://project-minigraf.github.io/minigraf-docs/latest/use-cases/#mobile-apps) section for full setup and usage docs (Gradle config, SPM integration, error handling, threading). ### For WASM / Browser -Published as [`@minigraf/browser`](https://www.npmjs.com/package/@minigraf/browser) on npm (IndexedDB-backed, `wasm-pack`). WASI build (`wasm32-wasip1`) available as [`@minigraf/wasi`](https://www.npmjs.com/package/@minigraf/wasi) on npm and as a GitHub Releases artifact (Wasmtime / Wasmer). See the [Use Cases wiki](https://github.com/project-minigraf/minigraf/wiki/Use-Cases). The [playground](https://minigraf-playground.vercel.app/) and the [time travel visualizer](https://project-minigraf.github.io/minigraf-visualizer/) are both built on `@minigraf/browser`. +Published as [`@minigraf/browser`](https://www.npmjs.com/package/@minigraf/browser) on npm (IndexedDB-backed, `wasm-pack`). WASI build (`wasm32-wasip1`) available as [`@minigraf/wasi`](https://www.npmjs.com/package/@minigraf/wasi) on npm and as a GitHub Releases artifact (Wasmtime / Wasmer). See the [Use Cases](https://project-minigraf.github.io/minigraf-docs/latest/use-cases/). The [playground](https://minigraf-playground.vercel.app/) and the [time travel visualizer](https://project-minigraf.github.io/minigraf-visualizer/) are both built on `@minigraf/browser`. ### For Python / Node.js / Java / C -Language bindings ship as `minigraf` on PyPI, `minigraf` on npm (Node.js native addon), `io.github.adityamukho:minigraf-jvm` on Maven Central, and a C header + prebuilt shared library on GitHub Releases. See the [Use Cases wiki](https://github.com/project-minigraf/minigraf/wiki/Use-Cases). +Language bindings ship as `minigraf` on PyPI, `minigraf` on npm (Node.js native addon), `io.github.adityamukho:minigraf-jvm` on Maven Central, and a C header + prebuilt shared library on GitHub Releases. See the [Use Cases](https://project-minigraf.github.io/minigraf-docs/latest/use-cases/). ## Scope @@ -239,7 +239,7 @@ Minigraf will **not** be (by design): - **Distributed** — no clustering, no sharding, no replication; each agent instance owns its own `.graph` file - **Client-server** — no network protocol in core - **Billion-node scale** — optimised for <1M nodes (like SQLite) -- **A time-series database** — Minigraf is a *temporal* database; see [Comparison](https://github.com/project-minigraf/minigraf/wiki/Comparison#influxdb--prometheus--timescaledb-time-series-databases) +- **A time-series database** — Minigraf is a *temporal* database; see [Comparison](https://project-minigraf.github.io/minigraf-docs/latest/comparison/#influxdb--prometheus--timescaledb-time-series-databases) ## Roadmap @@ -254,7 +254,7 @@ See [BENCHMARKS.md](docs/BENCHMARKS.md) for the current reproducible local snaps File-backed databases enforce a maximum fact size of **4 080 serialised bytes** per fact. In-memory databases have no limit. -**Durability tuning:** every write is `fsync`'d immediately by default (`SyncMode::Full`). Bulk loaders/migrations that can safely re-run from a checkpoint watermark on failure can trade that for throughput with `OpenOptions::new().synchronous(SyncMode::Normal)` — `checkpoint()` still fsyncs unconditionally in both modes. See the [Performance Tuning wiki page](https://github.com/project-minigraf/minigraf/wiki/Performance-Tuning#configuration-knobs) for the full tradeoff and the write-batching pattern that pairs with it. +**Durability tuning:** every write is `fsync`'d immediately by default (`SyncMode::Full`). Bulk loaders/migrations that can safely re-run from a checkpoint watermark on failure can trade that for throughput with `OpenOptions::new().synchronous(SyncMode::Normal)` — `checkpoint()` still fsyncs unconditionally in both modes. See the [Performance Tuning](https://project-minigraf.github.io/minigraf-docs/latest/performance-tuning/#configuration-knobs) for the full tradeoff and the write-batching pattern that pairs with it. ## Contributing diff --git a/docs/ERROR_REFERENCE.md b/docs/ERROR_REFERENCE.md index abe38e7537..81dfd3c27d 100644 --- a/docs/ERROR_REFERENCE.md +++ b/docs/ERROR_REFERENCE.md @@ -248,7 +248,7 @@ Deprecated codes: STG-003 and STG-004 (pre-v7 header sizes) are deprecated as of Parser errors occur when Minigraf cannot parse the Datalog/EDN input string. They are returned immediately from `db.execute()` before any fact is read or written. -See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference) for syntax guidance. +See the [Datalog Reference](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/) for syntax guidance. ### PRS-001 Unexpected end of input @@ -292,7 +292,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Check surrounding delimiters for balance. -- Consult the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference) for expected syntax at that position. +- Consult the [Datalog Reference](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/) for expected syntax at that position. **Example**: ```datalog @@ -464,7 +464,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Add a value: `:as-of 5` (transaction count) or `:as-of "2024-01-01T00:00:00Z"` (ISO 8601 wall-clock time). -- See the [Datalog Reference — Time Travel](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#bi-temporal-queries). +- See the [Datalog Reference — Time Travel](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#bi-temporal-queries). **Example**: ```datalog @@ -481,7 +481,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use a non-negative integer. - `:as-of 0` returns the database before any transaction; `:as-of 1` returns the state after the first transaction. -- See the [Datalog Reference — Time Travel](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#bi-temporal-queries). +- See the [Datalog Reference — Time Travel](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#bi-temporal-queries). **Example**: ```datalog @@ -497,7 +497,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use `42` (tx-count) or `"2024-01-01T00:00:00Z"` (wall-clock). -- See the [Datalog Reference — Time Travel](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#bi-temporal-queries). +- See the [Datalog Reference — Time Travel](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#bi-temporal-queries). **Example**: ```datalog @@ -513,7 +513,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Add an ISO 8601 timestamp: `:valid-at "2024-06-01T00:00:00Z"`. -- See the [Datalog Reference — Time Travel](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#bi-temporal-queries). +- See the [Datalog Reference — Time Travel](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#bi-temporal-queries). **Example**: ```datalog @@ -529,7 +529,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use `"2024-06-01T00:00:00Z"` or `:any-valid-time`. -- See the [Datalog Reference — Time Travel](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#bi-temporal-queries). +- See the [Datalog Reference — Time Travel](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#bi-temporal-queries). **Example**: ```datalog @@ -545,7 +545,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use `"2024-01-01T00:00:00Z"` format. -- See the [Datalog Reference — Time Travel](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#bi-temporal-queries). +- See the [Datalog Reference — Time Travel](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#bi-temporal-queries). **Example**: ```datalog @@ -562,7 +562,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use `"2024-12-31T23:59:59Z"` format. - To express "forever", omit `:valid-to` (the default is `VALID_TIME_FOREVER`). -- See the [Datalog Reference — Time Travel](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#bi-temporal-queries). +- See the [Datalog Reference — Time Travel](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#bi-temporal-queries). **Example**: ```datalog @@ -578,7 +578,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Add an aggregate to `:find`, or remove `:with` if no aggregation is needed. -- See the [Datalog Reference — Aggregates](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#aggregation). +- See the [Datalog Reference — Aggregates](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#aggregation). **Example**: ```datalog @@ -596,7 +596,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Add a `:where` clause that binds the variable, or remove it from `:with`. -- See the [Datalog Reference — Aggregates](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#aggregation). +- See the [Datalog Reference — Aggregates](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#aggregation). **Example**: ```datalog @@ -614,7 +614,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Add a `:where` clause that binds the variable. -- See the [Datalog Reference — Aggregates](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#aggregation). +- See the [Datalog Reference — Aggregates](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#aggregation). **Example**: ```datalog @@ -631,7 +631,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use `(count ?e)`, `(sum ?amount)`, `(avg ?score)` — one function name, one variable. -- See the [Datalog Reference — Aggregates](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#aggregation). +- See the [Datalog Reference — Aggregates](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#aggregation). **Example**: ```datalog @@ -648,7 +648,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use `sum`, not `:sum`. -- See the [Datalog Reference — Aggregates](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#aggregation). +- See the [Datalog Reference — Aggregates](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#aggregation). **Example**: ```datalog @@ -665,7 +665,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use a `?variable`, not a literal value. -- See the [Datalog Reference — Aggregates](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#aggregation). +- See the [Datalog Reference — Aggregates](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#aggregation). **Example**: ```datalog @@ -682,7 +682,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Add an `:over` clause: `(rank :over (:order-by ?score))`. -- See the [Datalog Reference — Window Functions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#window-functions). +- See the [Datalog Reference — Window Functions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#window-functions). **Example**: ```datalog @@ -699,7 +699,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Provide at least `:order-by` or `:partition-by` inside the `:over` list. -- See the [Datalog Reference — Window Functions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#window-functions). +- See the [Datalog Reference — Window Functions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#window-functions). **Example**: ```datalog @@ -716,7 +716,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use `rank`, not `:rank`. -- See the [Datalog Reference — Window Functions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#window-functions). +- See the [Datalog Reference — Window Functions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#window-functions). **Example**: ```datalog @@ -750,7 +750,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Drop the `:over` clause and use the function as a plain aggregate. -- See the [Datalog Reference — Aggregates](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#aggregation). +- See the [Datalog Reference — Aggregates](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#aggregation). **Example**: ```datalog @@ -767,7 +767,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Add the variable argument before `:over`. -- See the [Datalog Reference — Window Functions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#window-functions). +- See the [Datalog Reference — Window Functions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#window-functions). **Example**: ```datalog @@ -784,7 +784,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Add `:over` after the variable. -- See the [Datalog Reference — Window Functions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#window-functions). +- See the [Datalog Reference — Window Functions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#window-functions). **Example**: ```datalog @@ -801,7 +801,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Remove the variable: `(rank :over (:order-by ?score))`. -- See the [Datalog Reference — Window Functions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#window-functions). +- See the [Datalog Reference — Window Functions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#window-functions). **Example**: ```datalog @@ -818,7 +818,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Always follow `:over` with a list: `(rank :over (:order-by ?score))`. -- See the [Datalog Reference — Window Functions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#window-functions). +- See the [Datalog Reference — Window Functions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#window-functions). **Example**: ```datalog @@ -835,7 +835,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - The window expression must end after the `:over` clause. Remove trailing tokens. -- See the [Datalog Reference — Window Functions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#window-functions). +- See the [Datalog Reference — Window Functions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#window-functions). **Example**: ```datalog @@ -852,7 +852,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use a `?variable`: `(rank :over (:partition-by ?dept :order-by ?score))`. -- See the [Datalog Reference — Window Functions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#window-functions). +- See the [Datalog Reference — Window Functions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#window-functions). **Example**: ```datalog @@ -869,7 +869,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use a `?variable`: `(rank :over (:order-by ?score))`. -- See the [Datalog Reference — Window Functions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#window-functions). +- See the [Datalog Reference — Window Functions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#window-functions). **Example**: ```datalog @@ -886,7 +886,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use only `:order-by` and `:partition-by`. -- See the [Datalog Reference — Window Functions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#window-functions). +- See the [Datalog Reference — Window Functions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#window-functions). **Example**: ```datalog @@ -903,7 +903,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - The `:over` list must contain only `:order-by` / `:partition-by` followed by variables. -- See the [Datalog Reference — Window Functions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#window-functions). +- See the [Datalog Reference — Window Functions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#window-functions). **Example**: ```datalog @@ -1057,7 +1057,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Remove the empty list or replace it with a valid clause. -- See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference). +- See the [Datalog Reference](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/). **Example**: ```datalog @@ -1075,7 +1075,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Double negation is logically equivalent to the positive pattern; use the pattern directly. - For complex negation use `not-join` with explicit join variables. -- See the [Datalog Reference — Negation](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#negation). +- See the [Datalog Reference — Negation](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#negation). **Example**: ```datalog @@ -1092,7 +1092,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Add at least one pattern inside `(not ...)`. -- See the [Datalog Reference — Negation](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#negation). +- See the [Datalog Reference — Negation](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#negation). **Example**: ```datalog @@ -1109,7 +1109,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Add at least one branch. -- See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#disjunction). +- See the [Datalog Reference](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#disjunction). **Example**: ```datalog @@ -1126,7 +1126,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use the form `(or-join [?e] [[?e :a 1]] [[?e :b 2]])`. -- See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#disjunction). +- See the [Datalog Reference](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#disjunction). **Example**: ```datalog @@ -1143,7 +1143,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - The form is `(or-join [?var1 ?var2] ...)`. -- See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#disjunction). +- See the [Datalog Reference](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#disjunction). **Example**: ```datalog @@ -1160,7 +1160,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use `?variable` not `:keyword` or a string. -- See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#disjunction). +- See the [Datalog Reference](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#disjunction). **Example**: ```datalog @@ -1178,7 +1178,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Restructure branches so they all bind the same new variables. - Or use `or-join` to specify exactly which variables to share. -- See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#disjunction). +- See the [Datalog Reference](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#disjunction). **Example**: ```datalog @@ -1196,7 +1196,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Add at least one clause inside `(and ...)`. -- See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#disjunction). +- See the [Datalog Reference](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#disjunction). **Example**: ```datalog @@ -1213,7 +1213,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use `(not-join [?e] [?e :deleted true])`. -- See the [Datalog Reference — Negation](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#negation). +- See the [Datalog Reference — Negation](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#negation). **Example**: ```datalog @@ -1230,7 +1230,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Each `:where` element must be a vector `[e a v]`, a `(not ...)`, `(not-join ...)`, `(or ...)`, `(or-join ...)`, or expression `[(expr) ?out]`. -- See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference). +- See the [Datalog Reference](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/). **Example**: ```datalog @@ -1248,7 +1248,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Valid query map keys are `:find`, `:where`, `:with`, `:as-of`, `:valid-at`. - Check spelling. -- See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference). +- See the [Datalog Reference](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/). **Example**: ```datalog @@ -1264,7 +1264,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Provide a function: `[(+ ?a ?b) ?sum]`. -- See the [Datalog Reference — Expressions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#arithmetic--predicate-expressions). +- See the [Datalog Reference — Expressions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#arithmetic--predicate-expressions). **Example**: ```datalog @@ -1281,7 +1281,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use `+` not `:+`. -- See the [Datalog Reference — Expressions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#arithmetic--predicate-expressions). +- See the [Datalog Reference — Expressions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#arithmetic--predicate-expressions). **Example**: ```datalog @@ -1299,7 +1299,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Check the argument count. - Single-argument operators: `abs`, `not`, `str` (for coercion). -- See the [Datalog Reference — Expressions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#arithmetic--predicate-expressions). +- See the [Datalog Reference — Expressions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#arithmetic--predicate-expressions). **Example**: ```datalog @@ -1317,7 +1317,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Check the argument count. - Two-argument operators: `+`, `-`, `*`, `/`, `mod`, `quot`, `=`, `!=`, `<`, `<=`, `>`, `>=`, `starts-with?`, `ends-with?`, `contains?`, `matches?`. -- See the [Datalog Reference — Expressions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#arithmetic--predicate-expressions). +- See the [Datalog Reference — Expressions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#arithmetic--predicate-expressions). **Example**: ```datalog @@ -1334,7 +1334,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Pass the pattern as a string literal: `[(matches? ?name "alice.*")]`. -- See the [Datalog Reference — Expressions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#arithmetic--predicate-expressions). +- See the [Datalog Reference — Expressions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#arithmetic--predicate-expressions). **Example**: ```datalog @@ -1352,7 +1352,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Check spelling against the supported operator list above. - For missing operators, register a custom predicate via `db.register_predicate()`. -- See the [Datalog Reference — Expressions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#arithmetic--predicate-expressions). +- See the [Datalog Reference — Expressions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#arithmetic--predicate-expressions). **Example**: ```datalog @@ -1369,7 +1369,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Ensure the expression is wrapped in exactly one outer `[...]`. -- See the [Datalog Reference — Expressions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#arithmetic--predicate-expressions). +- See the [Datalog Reference — Expressions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#arithmetic--predicate-expressions). **Example**: ```datalog @@ -1386,7 +1386,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Use a `?variable`: `[(+ ?a ?b) ?sum]`. -- See the [Datalog Reference — Expressions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#arithmetic--predicate-expressions). +- See the [Datalog Reference — Expressions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#arithmetic--predicate-expressions). **Example**: ```datalog @@ -1404,7 +1404,7 @@ See the [Datalog Reference](https://github.com/project-minigraf/minigraf/wiki/Da **Resolution**: - Expressions accept variables (`?x`), integers, floats, strings, booleans, and keywords. - Restructure to avoid passing complex types. -- See the [Datalog Reference — Expressions](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#arithmetic--predicate-expressions). +- See the [Datalog Reference — Expressions](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#arithmetic--predicate-expressions). **Example**: ```datalog @@ -2318,7 +2318,7 @@ The WAL is replayed on open and deleted on checkpoint. - Store large payloads in an external file or object store. - Store the file path or URL as a `Value::String` attribute on the entity. - Or create a dedicated entity for the content and reference it with `Value::Ref`. -- See the [Datalog Reference — Constraints and Limits](https://github.com/project-minigraf/minigraf/wiki/Datalog-Reference#constraints-and-limits) for the size limit. +- See the [Datalog Reference — Constraints and Limits](https://project-minigraf.github.io/minigraf-docs/latest/datalog-reference/#constraints-and-limits) for the size limit. **Example**: ```datalog