Repository navigation
v0.1.0
Release notes
Highlights
-
One binary, one file, nothing to deploy — Relate is an embedded, in-memory property-graph engine that answers Cypher; a graph is a
.rlfile, a directory, or pure memory, and there is no server to babysit. Example:relate "RETURN 1 + 2 AS sum" -
Durable by construction — every committed write rides a fsync'd WAL, with Parquet checkpoints for fast reopens;
clonepacks a store into a single portable file for backup or transfer. Example:relate clone ./friends ./friends-backup.rl -
One engine, every front door — the same engine sits behind each of these, so a query that works in the shell works everywhere:
- the
relateCLI shell, interactive or one-shot - Python, Node.js, browser WASM, Rust, Java, Go, and Swift bindings over one typed C ABI
relate serve— one process speaking Bolt, the HTTP Query API v2, and MCP
- the
Other changes
- openCypher is the language contract:
MATCH/MERGE, subqueries, schema DDL, 80+ built-in functions, quantified path patterns — the openCypher TCK is the measured dialect floor. - Vector search:
vector()properties,vector.similarity.*scoring,CREATE VECTOR INDEX, and theSEARCHclause for index-backed top-K. - Geospatial: WGS-84 and Cartesian points,
point.distance(), bounding-box predicates, and R-tree point indexes. EXPLAINandPROFILErender the plan tree with per-operator rows and timing.--read-only=livelets a second process follow a store's WAL while another writes it.pullandpushmirror subgraphs between Relate and a Neo4j/Aura instance over the Query API v2.relate skill installdrops a skill bundle into detected AI agents so they drive the CLI correctly the first time.- Userland extensions mount as
relate run <name>; first-party packages import a filesystem tree or a git history as a graph. - Anonymous usage metrics are on by default with a layered opt-out (
relate telemetry off); query text and paths are structurally never collected.
What's Changed
- docs: add ADR writing guidance (scope + line budget) to AGENTS.md by @oskarhane in #2
- ci(spec-harness): flip the harness checkout to the relatedb home by @oskarhane in #3
- fix(temporal,pattern): live-Neo4j error classes for CIP-223 format patterns and CIP-190 where-variable patterns by @jexp in #7
- fix(build): release artifacts stop shipping DWARF and LTO bitcode — FFI tarball 69 -> ~22 MB by @jexp in #10
- feat(dialect): graduate the FOR clause from the gql-for preview gate (ADR-0533) by @jexp in #11
- fix(functions): coll.max returns null on any null element, matching live Neo4j by @jexp in #14
- feat(notifications): the 03N95 dynamic-property notification (ADR-0363) by @jexp in #15
- Add initial contribution guidance for AI tooling by @linyaru in #16
- feat(test-support): deterministic synthetic pokec-shaped in-memory fixture by @jexp in #12
- fix(executor): count-style aggregates over a repeated node variable count only self-loops by @jexp in #13
- docs(design): capture the kernel-composition design direction by @jexp in #18
- Add a pull-request gate for memory controls by @triha74 in #4
- docs(adr): ADR-0536 — the frontier NFA over the regular-pattern space by @jexp in #19
- docs(design): capture the kernel coverage inventory and candidate roadmap by @jexp in #21
- fix(executor): fold aggregates under unary/IS TYPE/chrono-compare positions (LABS-744) by @jexp in #26
- feat(notifications): the 01N31/01N30 planner-hint notifications (ADR-0535) by @jexp in #20
- fix(swift): roll back when commit() throws inside transaction(_:) (LABS-957) by @jexp in #27
- fix(java): polish LABS-839 stellar review nits (zip.stream listing, IT mode enum, user.home sentinel) by @jexp in #33
- fix(scripts): resolve LABS-1081 deferred stellar findings (pom.py, ADR check, release-bump) by @jexp in #31
- test(scripts): consolidate the scripts/tests child-env scrub policy (LABS-784) by @jexp in #34
- fix(executor): price unlabeled and untyped hops in the chain kernel's cost gate (LABS-991) by @jexp in #41
- perf(executor): hoist the projection row's names and schema out of the per-row path by @jexp in #24
- feat(profile): report the traversal rung and pattern-engine mode by @jexp in #25
- perf(executor): FxHash used-sets and per-statement label interning for the expansion hot loop by @jexp in #35
- refactor(parser,front): Expr::children enumeration shared by the front walkers by @jexp in #30
- refactor(core,executor): typed invalid-argument constructors and the one unary-arity contract (LABS-727) by @jexp in #37
- refactor(scripts): one sink, one dedent, one inventory (LABS-1071) by @jexp in #38
- feat(storage): experimental rkyv and fjall snapshot codecs, default off (ADR-0537) by @jexp in #23
- refactor(parser,front): one element tail, one property lowering (LABS-1115) by @jexp in #49
- ci(release): prepare the first release from this repository (v0.1.0) by @oskarhane in #44
- perf(cli): telemetry delivery off the exit path — spool locally, drain on the next run (ADR-0545, LABS-1155) by @oskarhane in #45
- feat(observability): fine phase split and plan-cache outcome in every machine envelope (ADR-0540) by @jexp in #32
- refactor(executor): NodeTarget::unfiltered, drop dead pool conjunct (LABS-1098) by @jexp in #48
- fix(clients): refuse unknown query_type/namespace in JS/Java/Swift (LABS-956) by @jexp in #50
- refactor(scripts): shared perf_skip/perf_announce wording, unmask perf stderr in 03/05 (LABS-881) by @jexp in #51
- refactor(core,notifications): split the pattern module; dedup shape detectors (LABS-762) by @jexp in #39
- feat(executor): hidden engine-only bar() text-bar function (ADR-0542) by @jexp in #46
- test(planner): pin OPTIONAL-first FINISH as a read; extensions spec OPTIONAL MATCH clause (LABS-894) by @jexp in #52
- ci(tests): exempt relate-codec-lab from the shard-coverage guard by @jexp in #62
- Inline single-version rows and dense id stores for the memory floor by @triha74 in #22
- feat(cli): hidden dot-command seam (relate-eggs), Archie banner and prompt glyph (ADR-0543) by @jexp in #47
- test(planner): one endpoint-estimate spelling in the seek tests (LABS-875) by @jexp in #63
- feat(extensions): relate-ideas, a linked idea store seeded from the maintainer's vault by @jexp in #56
- feat(eggs): .matrix, .cowsay and .fortune hidden dot commands by @jexp in #55
- feat(eggs): .lolwut and .graph with a braille canvas and force layout by @jexp in #54
- fix(executor): reserve the match-sink row to its column count by @triha74 in #68
- Wide-column Parquet checkpoint shards as an opt-in (ADR-0534) by @jexp in #40
- chore(cookbook): move the cookbook to relate-web (ADR-0528) by @johnymontana in #6
- chore(playground): move the playground to relate-web (ADR-0530) by @johnymontana in #8
- fix(ffi): bind the empty STRING from a NULL zero-length buffer (LABS-1198) by @jexp in #72
- fix(functions): path toString and null string indexes match live Neo4j by @jexp in #59
- fix(storage): writes_wide is Parquet-gated again (LABS-1134) by @jexp in #73
- docs(adr): ADR-0541 — resolve token names to ids once per plan (proposed) by @jexp in #29
- refactor(http): import GQLSTATUS constants from relate-error (LABS-910) by @jexp in #53
- refactor(storage): drop the experimental fjall snapshot codec, keep rkyv (ADR-0537) by @jexp in #69
- fix(ci): authenticate GitHub release downloads by @triha74 in #78
- feat(eggs): .explain-art, a text flame graph of the query plan by @jexp in #58
- test(executor): split exec test_support into family modules (LABS-897) by @jexp in #67
- refactor(test-support): split fetch into pins, download and ensure (LABS-883) by @jexp in #64
- fix(relate,bolt): observable commit-worker fallback; recording test-fixture slot (LABS-927) by @jexp in #66
- docs: PR description template, linked from AGENTS.md by @oskarhane in #84
- Re-freeze loadtest baselines (CI envelope) by @triha74 in #75
- fix(executor): stream grouped aggregates through constant-size accumulators (LABS-1187) by @jexp in #65
- Make the query engine and the write engine swappable by @triha74 in #5
- fix(show): reference name order and role columns for SHOW FUNCTIONS/PROCEDURES by @jexp in #60
- ci(release): offline (GitHub-only) release mode by @oskarhane in #79
New Contributors
- @oskarhane made their first contribution in #2
- @jexp made their first contribution in #7
- @linyaru made their first contribution in #16
- @johnymontana made their first contribution in #6
Full Changelog: https://github.com/relatedb/relate/commits/v0.1.0