diff --git a/docs/releases/v0.13.0-overview.md b/docs/releases/v0.13.0-overview.md new file mode 100644 index 000000000..6d342a1de --- /dev/null +++ b/docs/releases/v0.13.0-overview.md @@ -0,0 +1,49 @@ +# OmniGraph v0.13.0 + +Released 2026-10-07. + +0.13 closes the server configuration gaps in 0.12. The previous release +introduced breaking storage, query and API changes, but shipped with incomplete +cluster configuration support. Cluster configuration now covers live updates to +existing graphs, graph creation and graph deletion through one plan/apply workflow. + +**Upgrading from 0.11 or earlier requires migration planning; older +cluster-managed graphs require export and rebuild.** See +[Upgrading to 0.13](#upgrading-to-013) below. + +## What's in 0.13 + +- **Live configuration updates:** change schemas, stored queries, authorization + policies, embedding providers and Blob access rules without restarting the + server. +- **Graph lifecycle through configuration:** add graphs or remove them through + `cluster apply`. Removing a graph permanently deletes its managed storage and + retained history. +- **Deployment previews and tracking:** preview changes with + `cluster plan --server`, submit with `--no-wait`, and track completion by + deployment ID—even after a client disconnect or timeout. +- **Simpler CLI:** consistent `query`, `mutate`, `load` and `lint` commands, with + managed service operations selected through `cluster … --managed`. + +## Upgrading to 0.13 + +If you're upgrading from 0.11 or earlier, plan for breaking storage, query and +API changes. Replacing the executable alone does not upgrade an older graph. + +- **Older cluster-managed graphs require export and rebuild.** Export using the + old executable, create a replacement cluster with 0.13, and import the data. + Previous commit IDs, snapshots and branch history are not carried over. +- **Supported standalone graphs can be upgraded offline**, preserving data, + branches and retained commit history. Follow the + [upgrade guide](../user/operations/upgrade.md) for your source version. +- **Existing 0.12 graphs need no additional storage-format migration.** Cluster + ledger conversion may still be necessary; see + [cluster conversion](../user/clusters/index.md#direct-deployments-and-conversion). + +Preserve a verified backup and the old executable. Upgrade the CLI, server and +HTTP integrations together, and verify the replacement before switching +application traffic. + +See the [upgrade guide](../user/operations/upgrade.md) for migration steps and +the [0.12](v0.12.0.md) and [0.13](v0.13.0.md) release notes for the complete +breaking-change list and detailed changes. diff --git a/docs/user/index.md b/docs/user/index.md index ebf863f11..901c1f7eb 100644 --- a/docs/user/index.md +++ b/docs/user/index.md @@ -48,5 +48,7 @@ deployment. ## Releases and internals User-visible changes are recorded in the [release notes](../releases/). +See [0.13 highlights and upgrade requirements](../releases/v0.13.0-overview.md) +for a short overview of the release. Contributors should start with the [developer guide](../dev/index.md). Design decisions and proposals live in [RFCs](../rfcs/).