Skip to content

Release v0.10.0: Add GQL Write Support - #11

Merged
bhensley5 merged 1 commit into
mainfrom
release/v0.10.0
May 28, 2026
Merged

Release v0.10.0: Add GQL Write Support#11
bhensley5 merged 1 commit into
mainfrom
release/v0.10.0

Conversation

@bhensley5

@bhensley5 bhensley5 commented May 28, 2026

Copy link
Copy Markdown
Owner

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

[0.10.0] - 2026-05-27

Added

GQL Beta Mutations

  • Executable GQL writes across Rust, Node.js, and Python. Added keyed CREATE, SET, REMOVE, DELETE r, and DETACH DELETE n execution to execute_gql / executeGql, using the same write-transaction machinery and durability path as the structured APIs.
  • Mutation RETURN support. CREATE, SET, and REMOVE statements can now return object rows or compact rows with aliases, scalar expressions, ordering, SKIP / OFFSET, LIMIT, vector opt-in, and embedded explain/profile output.
  • Mutation result and explain surfaces. GQL execution now returns unified mutation result payloads with mutation_stats, and explain_gql can describe mutation plans without side effects.

Changed

GQL Execution

  • Reads and writes now share one public GQL surface. GQL Beta is no longer limited to read queries; read prefixes, mutation staging, caps, and result shaping now flow through one execution contract across all three language connectors.
  • Connector docs and getting-started guidance now cover writes. README, getting-started, API reference, and docs/gql-subset.md now document mutation syntax, limits, ReadOnly mode, and the supported mutation RETURN behavior.

Fixed

  • Mutation planner and runtime parity. GQL mutations now preserve native semantics for cap enforcement, optional-null handling, delete deduplication, replacement ordering, conflict detection, cursor rejection, and truthful profiling.
  • Connector parity and validation. Node.js and Python now match the Rust core for mutation options, error surfaces, compact-row output, vector opt-in, and mutation RETURN ORDER BY guardrails.

## What's New
- Add executable GQL Beta mutations across Rust, Node.js, and Python.
- Support mutation RETURN rows, mutation stats, and side-effect-free mutation explain output.

## Improvements
- Unify GQL reads and writes on the native graph-row and write-transaction substrates.
- Harden mutation caps, ordering validation, connector parity, and profiling behavior.

## Documentation
- Update README, getting started, GQL subset docs, and API reference for GQL write support.
- Finalize 0.10.0 versioning and changelog entries across the published packages.
@bhensley5
bhensley5 marked this pull request as ready for review May 28, 2026 02:52
@bhensley5
bhensley5 merged commit 6faebcc into main May 28, 2026
3 checks passed
@bhensley5
bhensley5 deleted the release/v0.10.0 branch May 28, 2026 02:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant