Skip to content

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 09 Nov 13:44
· 438 commits to main since this release

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 .rl file, 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; clone packs 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 relate CLI 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

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 the SEARCH clause for index-backed top-K.
  • Geospatial: WGS-84 and Cartesian points, point.distance(), bounding-box predicates, and R-tree point indexes.
  • EXPLAIN and PROFILE render the plan tree with per-operator rows and timing.
  • --read-only=live lets a second process follow a store's WAL while another writes it.
  • pull and push mirror subgraphs between Relate and a Neo4j/Aura instance over the Query API v2.
  • relate skill install drops 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

Full Changelog: https://github.com/relatedb/relate/commits/v0.1.0