v0.2.1

Released 2026-09-29. v0.2.0 added evaluations, costs and budgets, OCR and SSO groups; a review by role found that they had piled up in the admin sidebar, the money pages and the evaluation screens. This release moves, merges and explains what exists (it adds no new features) and finishes per-claim verification. A release candidate, v0.2.1-rc.1, ran on the reference install first; v0.2.1 is the same code apart from documentation.

HighlightsCopy Anchor Link

• A shorter admin sidebar. Seven collapsible groups (People, Content, Models, Usage & spend, Safety, Records, Operations) under Overview, that fit a laptop screen, with the current page always visible. Legal holds is now a tab of Retention, and Profile migrations a tab of Embedding profiles. Old addresses redirect.
• What's switched on, at a glance. The admin Overview has a Features card with each optional feature's state and a link to where it's set. The evaluations switch lives there now.
• The team Overview answers "how are we doing?" Each evaluation set's latest score and trend and, for owners and admins, this month's spend against the budget. A new Evaluations item in the team sidebar lists every set in the team, with a Regressions filter.
• Spend and limits apart. Team settings' Usage & spend shows spend in one line, with the breakdown folded away. Crawl domains moved to a tab of Data sources, so Team settings has five tabs. The Costs Overview is about half as tall, with one "Top spenders" card.
• A simpler agent editor. Six tabs: Build · Evaluations · Appearance · Share · Analytics · Settings. Version history, compare and revert are in the header's version badge.
• Per-claim verification. With SystemOne citation checks on, each factual sentence of an answer is a claim with one verdict (supported, not supported or uncited), shown with its text in the citation card, with a summary such as "9 of 10 claims supported". Evaluations count the same claims, so chat and results agree. The API adds claims[], including on the OpenAI-compatible endpoint (additive). See Claims and verdicts.
• Chat. Sources start collapsed. A citation chip opens its claim card (Enter or Space from the keyboard), with "Show source" to jump to the passage.
• Fixes from the walkthrough. Editors no longer see budget entries in the team audit log; evaluation trends skip runs that have no score; Compare versions includes SystemOne settings; the first Tab reaches "Skip to content" again; ⌘K opens moved tabs directly; and many smaller copy, keyboard and phone-layout fixes.

RequirementsCopy Anchor Link

Unchanged from v0.2.0.

Upgrading from v0.2.0Copy Anchor Link

A rolling upgrade with no downtime and no database migrations (the schema stays at version 34). Take a backup as for any upgrade, then change every ?ref=v0.2.0 in your overlay to ?ref=v0.2.1 and pin the new digests of ghcr.io/ncecere/grounded and, if you run OCR, ghcr.io/ncecere/grounded-ocr. See Upgrades.

Things people will notice:

• Moved pages: Admin → Legal holds and Admin → Profile migrations are tabs of Retention and Embedding profiles; a team's Crawl domains is a tab of Data sources; an agent's Versions tab is the header's version badge. Old links and bookmarks redirect.
• The evaluations switch moved from Admin → Limits → Evaluations to Admin → Overview → Features.
• Clicking a citation chip opens the claim card instead of jumping straight to the source.
• Answers stored before v0.2.1 keep showing a verdict per citation marker; new answers show claims.

API changesCopy Anchor Link

All additive:

• claims[] on chat answers, message_end, citations_checked, conversation messages, evaluation results and the OpenAI-compatible response (next to citations, and in a stream's final chunk).
• Evaluation scores gain supportedClaims and claimsScored; EvaluationSet.previousRun.
• SystemOneSettings.agents; analytics' CitationTotals gain supportedClaims, notSupportedClaims, uncitedClaims and claimSupportRate.

Known limitationsCopy Anchor Link

The v0.2.0 limitations still apply. Editors can't withdraw their own domain request yet, and a few shared-component refinements (chart axis ticks, a visible label on table search boxes, breadcrumbs that collapse only when they overflow) are on the roadmap.

Verifying the imagesCopy Anchor Link

As for v0.2.0, with the tag v0.2.1: docker run --rm ghcr.io/ncecere/grounded@sha256:<digest> version prints grounded v0.2.1 (<commit>), and the release has SPDX SBOMs, digest files and a checksums.txt.