Repository navigation
Released: 2026-11-16 · Branch: dev · Previous: v0.5.0 (2026-10-23)
v0.5.0 was the security release. v0.6.0 prepares the repository for its open-source release (#1500), lands the first batch of fixes for the pre-launch security review (#1388), and makes score and explain work on segmentation models.
This release was not planned with a release epic. It carries the pull requests merged into dev since v0.5.0. The epic #1500 is its tracking issue.
14 pull requests since v0.5.0:
- 4 security fixes;
- 1 build fix;
- 1 machine-learning fix;
- 5 release-readiness changes;
- 2 docs;
- 1 test.
The generated OpenAPI still has 190 /v1 paths, and no capability was added or removed.
Upgrade: read this first
- A rolling upgrade is fine. Nothing in this release changes replication, the peer protocol or a replicated record's shape. A
v0.5.0node and av0.6.0node can share a cluster. - Clerk now needs its authorized parties (#1423, in #1503). A node with a Clerk issuer set accepts a Clerk token only when the token carries an integer
expand anazplisted inZETTA_CLERK_AUTHORIZED_PARTIES, a comma-separated list of this node's Studio origins. With an issuer and no list, every Clerk token is refused. Bearer and session tokens are unaffected. No deployment sets a Clerk issuer today. - An inbox needs its own grant (#1432, in #1505). A topic-prefix grant no longer reaches an inbox. A grant meant to open an inbox must name
inbox:<name>. - The Studio web app is no longer in the repository (#1527).
webapp/was removed because it needs a rebuild from its source (#1526). A node started without--webapp-dirserves its built-in server-rendered UI at/, as before. A deployment that bakeswebapp/into its image must stop copying it. TheDockerfileadded here handles both cases.
Behaviour changes
- Cookie routes check the session before reading the body (#1395, in #1502).
- A request with no session is answered without its body being read, and the connection is closed.
POST /login,POST /sessionandPOST /blob/deleteaccept at most 64 KiB, and answer 413 above that.- A blob upload checks
sql:writebefore reading the file.
- Redirects (#1503):
list_datasetslists only what the caller may read (#1439, in #1503). The rule is the same assystem.datasets: an administrator or the local session sees every dataset, and anyone else only the tables it holdssql:readon.storage_usageshows a caller who is not an administrator only the buckets it may read (#1430, in #1505). Per-kind totals are 0 for such a caller.- The web shell runs as the signed-in user (#1434, in #1505): statements are authorized, executed and audited under the user, not the local session.
- Parsers of untrusted input are bounded (#1504):
- Thrift metadata nests at most 64 levels (#1424).
- Parquet counts are checked against the bytes present, and
read_parquet_rowsrefuses a footer claiming more than 10,000,000 rows (#1425). A Parquet file over 10 million rows uploaded throughadd_datasetis now refused. - A tokenizer vocabulary whose ids run far past its size is refused (#1431).
- A JPEG with a second frame is refused (#1418).
- A Python pipeline expression nests at most 200 levels (#1427).
Added
scoreandexplainon segmentation (M-3) models (#1497, in #1499).scoreplaces each row in its nearest segment:kind: "segmentation"andassignments.explainnames the segment, the runner-up, and each column's contribution to the choice.
- The image
Dockerfileis in this repository (#1530). It was in zetta-bridge. Build from the repository root:docker buildx build --platform linux/amd64 -t <registry>/zetta:<version> .. Seedocs/build.md. - Licensing (#1524):
- MIT
LICENSEandCOPYRIGHT(OramaSearch, Inc.). SPDX-License-Identifier: MITin every source file.THIRD_PARTY_LICENSES, with 15 components and none incompatible with MIT.- An SBOM in SPDX and CycloneDX form, regenerated with
tools/sbom.py. CONTRIBUTING.md, with contributions under a copyright-assignment CLA (CLA.md).CODE_OF_CONDUCT.md.
- MIT
SECURITY.md(#1506): report vulnerabilities privately to security@orama.com.
Build and repository
- Every
FetchContentsource is pinned by commit or hash (#1508): SDL3, Dear ImGui, json-schema-validator and GoogleTest by commit, and the Boost archive by SHA-256. - Submodule remotes are https (#1530). Every submodule repository is public, so an anonymous
git clone --recurse-submodulesworks. - Schema
$ids use one namespace,https://oramasearch.github.io/zetta/schemas/(#1530). Nothing resolves or compares them. - Client and internal material is out of the tree (#1523, #1525, #1527). The churn fixture's company is now the invented Contoso, and the demo data generators describe an invented business. The agent files are rewritten for the public repository, and finding ids and private links are removed.
docs/full-context.mdanddocs/architecture/code-audit.mdare gone. - An object-log test's hooks now outlive the log they are installed in (#1491, in #1492). The v0.5.0 notes record the image digest and the AddressSanitizer result (#1493).
Not in this release
These pull requests are open and were held back as high risk. Their issues are closed as in-pr, but their fixes do not ship in v0.6.0:
-
- read-only SQL enforced by the engine (#1501);
- the identity root for burst nodes (#1343);
- feedback bundles scoped to the caller (#1455);
- bounded pipeline graphs (#1426);
- the audit surface and the background actor (#1328, #1327);
- study trials run as their caller (#1322);
- action delivery off the owner loop (#1406).
It moves the audit protocol to 3.
-
- an index keeps its source database (#1428);
- a default bucket quota (#1421);
- bounded invalid-token work (#1417);
- discovery docs per caller (#1357);
- a grant per saved connection (#1339);
- the connection root secret outside
data_dir(#1314); - delivery credentials only to approved endpoints (#1453);
- egress refusals naming the run principal (#1323);
- the decided audit, principal and credential follow-ups.
-
#1510: re-reading the egress allowlist without a restart (#1332).
-
Backup routes for the operator's backup system: #1521 and #1522.
-
The Studio web app, until it is rebuilt from a cleaned source (#1526).
Known issues
Security-relevant first.
- The security fixes listed under Not in this release are not in this tag. They are tracked under #1388 and the epic #1500.
- The repository and the image
oramasearch/zettawere made public on 2026-11-16, with the full history and every earlier image tag. GitHub private vulnerability reporting is on, and security@orama.com also takes reports. - The new cookie-route bounds (#1531) and Parquet count bounds (#1532) have no tests of their own yet.
scoreover a table on a multi-member cluster scores only the rows the answering member owns (#1533).- An intermittent segfault in
Uc1Journey.ARunWithoutADatasetReadsItsPipelinesTable(#1485). - Latency-budget tests fail on a loaded host (#1256).
WHERE NOT (x = 5)matches rows wherexis null (#1473).- Pending outbox and report rows from before
v0.5.0's outbox change are not delivered after the upgrade (#1474).
Where it has run
Not on any cluster, and not on the dev environment. This release was cut without a dev environment run first, on Steve's decision (2026-11-16), and the image is built but not deployed. The image oramasearch/zetta:v0.6.0 is built from the tag on the cluster BuildKit (linux/amd64) with this repository's Dockerfile, from a detached checkout of the tag (b2861be5) with every submodule at its pin:
oramasearch/zetta:v0.6.0 sha256:97fa856e5a2c7e920498ecdd0cce3dbac2a2b05f5055b28210007fde18a72215
oramasearch/zetta:main-b2861be5 (the same digest)
Verification
Full test suite, run serially (ctest --test-dir build, no -j) on the release branch at 072a21ad (dev at 9ea9f3a8 plus the version move), macOS 14.6.1 arm64, Homebrew LLVM Clang, static Release build. Submodules were cloned fresh over their https remotes. The run took 1,098 s, on a host with a virtual machine running (load average 25 to 60):
3,475 registered · 3,474 run · 3,450 passed · 1 failed · 23 skipped · 1 disabled · 0 crashes
| Check | Result |
|---|---|
ReleaseVersion.* (the version in version.hpp, CMakeLists.txt, openapi.json and this page) |
3/3 passed |
zetta-refused-start-exit, zetta-startup-log-redaction (the built binary) |
2/2 passed |
CommsDemoDataset.TrainsAndExplainsWithTreeShap (the rewritten demo generator, #1523), skipped in the suite because it needs generated data |
passed, run alone after python3 scripts/gen_comms_demo_dataset.py --out data/demo/comms --accounts 1500 |
The one failure:
| Failure | Cause | State |
|---|---|---|
SmallConnectionCacheFixture.FiveHundredHeldPollsLeaveTwentyFreshConnectionsFast |
a wall-clock budget: fresh connections took 38 to 55 ms against 5 ms on the loaded host | passed in each of three runs alone (0.26 s); known, #1256 |
The 23 skipped tests need a service, a checkpoint or generated data that the suite does not provide. They were not run. That is a gap, not a pass.
- Live services:
LakeSqlLive,MysqlLiveandTidbLive(eachRunsAgainstAReal…WhenConfigured), andAgentApiFixture.ChatWithARealModel. - Model checkpoints:
QwenRealCheckpoint(2 tests);LanguageEmbed.RealMiniLmCheckpoint;ViT.RealCheckpointLoadsWhenExplicitlyConfigured;WhisperCheckpoint.RealPinnedCheckpointIsSkippedByDefault;OcrDocumentExtraction.RealPinnedCheckpointRunsWhenConfigured;SftDeviceAgnostic.FineTunesTheBaseAgentOnAnyComputeDevice;SftCudaResident.TrainsTheInteractionCorpusOnTheGpu(needs CUDA);AgentApiFixture.AgentRunBuildsAPlanAndRunsItOnlyOnceApproved.
- Generated corpora or data:
CorpusNativeGate.GeneratedCorpusLoadsAndPassesTheGate;SolutionGraph.EveryCorpusTaskBecomesAGradeableAction;InteractionContract(2 tests);CommsDemoDataset.TrainsAndExplainsWithTreeShap(run alone, above).
- Opt-in chaos and measurement:
Chaos.MeshLoadStallProbe;Chaos.SeededSchedulesHeal;ChaosSmoke.ThreeNodeMtlsMeshHealsFromEveryFaultClass;GossipBandwidth.Measure.
OramaCoreFulltextIndex.DegradesGracefullyWithoutEngineapplies only to a build withoutoramacore-cpp, and this build has it.
PubSubDispatcherBenchmark.ThroughputOneAndFourThreads is disabled, as in v0.5.0.
Not run for this page: the dev environment, and any cluster deployment. The Linux image build from the tag is recorded under Where it has run.