Skip to content

docs(release): foreground v0.10 vocabulary break #590

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
aaltshuler wants to merge 1 commit into
base: main
Choose a base branch
from
+8 −12
Open

docs(release): foreground v0.10 vocabulary break #590

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 8 additions & 12 deletions docs/releases/v0.10.0.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,12 @@ It upgrades the storage substrate from v0.9.0's Lance 9 to **Lance 11.0.0** whil
retaining graph storage format **v6**, recovery sidecars **v9**, and Lance
**V2_2** data files. Existing v0.9 graphs do not require entity export/import.

**Coordinated upgrade required.** CLI/HTTP JSON and public Rust vocabulary have
changed; upgrade the CLI, server, and client integrations together. Stop the old
fleet before opening the store with the new one. Do not mix Lance 9/10 binaries
with Lance 11 readers or writers.
**Coordinated upgrade required.** Public graph-facing APIs now describe nodes,
edges, types, entities, and properties; ambiguous table/row names are removed.
CLI/HTTP JSON and public Rust vocabulary have changed, so upgrade the CLI,
server, and client integrations together. Stop the old fleet before opening the
store with the new one. Do not mix Lance 9/10 binaries with Lance 11 readers or
writers.

**Rebuild full-text indexes on every branch that needs search.** Old indexes
without compatible analyzer proof now fail explicitly instead of silently
Expand Down Expand Up @@ -109,7 +111,8 @@ verified whole-root backup for rollback and follow the

### CLI, HTTP, and embedded API

- Graph-facing names now distinguish nodes/edges, types, entities, properties,
- **Breaking graph vocabulary.** Graph-facing names now distinguish nodes/edges,
types, entities, properties,
graph-manifest versions, and published dataset versions. Legacy aliases such
as `table_key`, `row_id`, ambiguous `manifest_version`, `rows_loaded`, and
`export --table` are removed rather than dual-emitted. Update consumers to
Expand Down Expand Up @@ -183,10 +186,3 @@ and compaction continue normally. See [maintenance](../user/operations/maintenan
packages are frozen at 0.8.0 and are not this release. Binaries ship through
GitHub Releases, the installer, Homebrew, and Docker. See
[distribution policy](../dev/versioning.md#registry-publication-status).

## Development-line note

An earlier unreleased experiment also used 0.10.0 while exploring manifest
formats v7–v19. Those abandoned formats remain refused. This release continues
from released v0.9.0 on v6; see [ingestion](../dev/ingestion.md) and
[RFC 0026](../rfcs/0026-memwal-streaming-ingest.md).