Skip to content

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.

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.

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 about ref 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.

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 about target (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.

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.

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.

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.

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 summary field 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 about target, when it has one.
  • Referenced by — Things that store this assertion’s wref in one of their fields.

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.

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”.

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”.

The tab shows a BDU meter for these common opinion formats:

  • An opinion value with b, d, u, and optional a fields.
  • A separate opinion assertion whose payload contains b, d, u, and optional a, as described in modeling patterns.
  • A Veritas opinion with belief, disbelief, uncertainty, and optional alpha fields.
  • A named assessment such as relevance with b, d, u, and optional a fields.

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.

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 --all to 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 the data payload 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.