From d18b38f56c9ed54afc35dfc572a416e4b17214e6 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 db31056a5d..cd787330be 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -224,7 +224,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 9cdbbf92b8..a1aced9279 100644 --- a/README.md +++ b/README.md @@ -115,7 +115,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? @@ -140,10 +140,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). @@ -162,7 +162,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 @@ -190,15 +190,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 @@ -213,7 +213,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 @@ -228,7 +228,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 acc1d93d03..5dbfdceecb 100644 --- a/docs/ERROR_REFERENCE.md +++ b/docs/ERROR_REFERENCE.md @@ -216,7 +216,7 @@ with no `CodedError` anywhere in its chain. 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 @@ -260,7 +260,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 @@ -432,7 +432,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 @@ -449,7 +449,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 @@ -465,7 +465,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 @@ -481,7 +481,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 @@ -497,7 +497,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 @@ -513,7 +513,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 @@ -530,7 +530,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 @@ -546,7 +546,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 @@ -564,7 +564,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 @@ -582,7 +582,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 @@ -599,7 +599,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 @@ -616,7 +616,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 @@ -633,7 +633,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 @@ -650,7 +650,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 @@ -667,7 +667,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 @@ -684,7 +684,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 @@ -718,7 +718,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 @@ -735,7 +735,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 @@ -752,7 +752,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 @@ -769,7 +769,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 @@ -786,7 +786,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 @@ -803,7 +803,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 @@ -820,7 +820,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 @@ -837,7 +837,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 @@ -854,7 +854,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 @@ -871,7 +871,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 @@ -1025,7 +1025,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 @@ -1043,7 +1043,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 @@ -1060,7 +1060,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 @@ -1077,7 +1077,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 @@ -1094,7 +1094,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 @@ -1111,7 +1111,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 @@ -1128,7 +1128,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 @@ -1146,7 +1146,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 @@ -1164,7 +1164,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 @@ -1181,7 +1181,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 @@ -1198,7 +1198,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 @@ -1216,7 +1216,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 @@ -1232,7 +1232,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 @@ -1249,7 +1249,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 @@ -1267,7 +1267,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 @@ -1285,7 +1285,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 @@ -1302,7 +1302,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 @@ -1320,7 +1320,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 @@ -1337,7 +1337,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 @@ -1354,7 +1354,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 @@ -1372,7 +1372,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 @@ -2029,7 +2029,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