Assertions
The assertion browsing surface pairs an assertion list with a detail panel and filter controls. Assertions with an opinion render a belief/disbelief/uncertainty (BDU) meter; other assertions show No opinion in the same place. See When BDU Meters Appear for the accepted opinion formats. Graphs with Veritas installed can additionally show calibrated source reputation recorded in Veritas.
Calibrated Source Reputation Panel
Section titled “Calibrated Source Reputation Panel”For signed-in viewers with read access, the tab can lead with a collapsible Calibrated source reputation panel. It appears when a compatible Veritas installation has at least one recorded source reputation for the graph. These values come from Veritas; the browser does not calculate them from the assertions currently on screen.
The panel header shows a shield icon and a count of source-scope rows. Expanded, each row shows:
- The source wref and the reputation scope in which the value applies.
- An inline BDU meter showing the recorded belief, disbelief, and uncertainty.
Rows remain separate by source and scope, so the same source can appear more than once. Sources without a recorded reputation are not listed, and loading more assertions does not change the panel.
When calibrated reputation is unavailable or empty, the panel stays hidden.
Filter Bar
Section titled “Filter Bar”Six filter controls sit above the assertion list:
-
Search — free-text match against assertion name, wref, shape name, and about target.
-
Shape — restrict to a single shape, populated from shapes present in the loaded assertions.
-
Belief band — narrows the list by how confident an assertion is:
- All assertions — no filter.
- High belief — strong belief, low uncertainty.
- Moderate belief — middling belief, low uncertainty.
- Low belief — weak belief, low uncertainty.
- High uncertainty — uncertain enough that the belief level is unreliable, regardless of where it sits.
Any assertion in the high-uncertainty zone is grouped under High uncertainty rather than the matching belief band.
-
Sort — Strongest belief (default), Most uncertain, Alphabetical, or Highest version. Belief- and uncertainty-based sorts tie-break on the opposite axis, then by name.
-
About — restrict to assertions whose
aboutref contains the chosen target string (substring match, case-insensitive). The selector is searchable and is populated from the about refs present in the loaded assertions; selecting one target can also match assertions whose about-ref includes that string as a substring. -
Group by — No grouping (default), Source, Shape, or Target.
A Clear filters button appears when any filter is active.
Assertions without a valid opinion do not match any specific belief band and receive no belief-band pill. They sort after assertions with present opinions in belief- and uncertainty-based orders; alphabetical sorting remains alphabetical. Version sorting orders equal versions by opinion presence, then stronger belief, then name. An explicit (0, 0, 1) opinion is present and remains eligible for High uncertainty.
Assertion List
Section titled “Assertion List”The center column lists assertions matching the current filters. The header shows the loaded result count and a (loading...) indicator while a requested page is being fetched.
- All viewers: When more loaded matches remain, Show more (N remaining) reveals the next slice.
- Signed-in viewers: After all loaded matches are visible, Load more assertions requests another server page when one is available.
- Anonymous viewers: The tab automatically loads up to its two-page cap. After those loaded matches are revealed, a sign-in footer appears when more assertions exist.
Each row shows:
- Name with a belief band pill (when an opinion is present).
- Shape name, an arrow, and a link to the
abouttarget (when set). - Source attribution (
by <source>) when the assertion declares a source. - Inline opinion slot on medium screens and above — a BDU bar when an opinion is present, or No opinion otherwise.
- Version pill (e.g.
v2).
Click any row to select the assertion — the detail panel opens and the selection is reflected in the URL via the thing query parameter (as the assertion’s wref), so links are shareable.
Grouping
Section titled “Grouping”When Group by is set to Source, Shape, or Target, sticky group headers separate the list. A source-grouped header shows the source name and the number of assertions in that displayed group; it does not calculate or display reputation averages.
Anonymous viewing
Section titled “Anonymous viewing”Unauthenticated viewers see a capped result set. When more assertions exist than the anonymous viewing limit allows, the list footer reads “Showing the first N assertions” with a sign-in prompt.
Detail Panel
Section titled “Detail Panel”Selecting an assertion opens the detail panel on the right. The header shows the kind (assertion), the assertion’s name, its wref with a copy button, and a version pill (e.g. v2). Below the header, the panel has four tabs: Detail, Assertions, Raw Data, and History. It opens on Detail.
Detail tab
Section titled “Detail tab”The Detail tab shows, from top to bottom:
- Opinion — a full-width BDU meter with its numeric values and the base rate (
a), when the assertion carries an opinion. An assertion without one shows nothing here. - Summary — the assertion’s
summaryfield as a line of text, when it has one. - File — the linked file and its download, when the assertion has one.
- Fields — the shape name as a heading (or no Shape for an unshaped assertion), then each field of the payload with its name and value. A field the shape describes shows that description under its name. The assertion’s Durable ID comes last, with a copy button.
- What this is about — a link to the assertion’s
abouttarget, when it has one. - Referenced by — Things that store this assertion’s wref in one of their fields.
Assertions tab
Section titled “Assertions tab”The Assertions tab in the detail panel lists assertions that target the selected assertion itself — that is, assertions whose about ref points to this assertion’s own wref. Each entry shows the assertion name, shape badge, version, and either a full-width BDU meter or No opinion.
Raw Data tab
Section titled “Raw Data tab”The Raw Data tab pretty-prints the selected assertion’s data payload — just the payload, not the wrapping name, shape, version, or about ref already shown above. If the assertion has no payload, the tab reads “No data”.
History tab
Section titled “History tab”The History tab lists the assertion’s versions. Each row shows the version number, the operation that made it (such as add or revise), a link to that version’s pinned wref, who committed it, and the date. When there are more versions, signed-in viewers can load the next page; anonymous viewers see the first page with a sign-in prompt. An assertion with no recorded history shows “No history available”.
When BDU Meters Appear
Section titled “When BDU Meters Appear”The tab shows a BDU meter for these common opinion formats:
- An
opinionvalue withb,d,u, and optionalafields. - A separate opinion assertion whose payload contains
b,d,u, and optionala, as described in modeling patterns. - A Veritas opinion with
belief,disbelief,uncertainty, and optionalalphafields. - A named assessment such as
relevancewithb,d,u, and optionalafields.
In every format, each BDU value must be a number from 0 through 1, and the three values must total about 1. Assertions without one supported, valid opinion display No opinion.
Absence and vacuity are distinct. A missing opinion produces no belief-band pill and displays No opinion where the layout reserves an opinion meter. An explicit (0, 0, 1) is a valid present opinion and renders its fully uncertain meter. The Raw Data tab shows the payload returned by the read surface, including the read-time rendering of typed wrefs.
From the terminal
Section titled “From the terminal”To do the same kinds of things from the terminal that this surface supports in the browser:
- Browse every assertion in a graph —
wh thing list --shape Assertion --all --graph <org/graph>. The default page size is 50; use--allto walk every page at once. In the browser, signed-in viewers load each additional page explicitly, while anonymous viewers automatically load up to their capped result set. - Inspect a single assertion —
wh thing view <wref>. Returns the full thing record, including thedatapayload that the browser pretty-prints in the Raw Data tab. - Find assertions targeting a specific thing —
wh thing about <target-wref>. To find assertions that target the selected assertion itself (matching what the Assertions tab in the detail panel shows), pass the selected assertion’s own wref. - Trace a single assertion’s history —
wh thing history <wref>.
See Assertions for the underlying data model and CLI reference for the full command surface.