Installing Veritas

Veritas is a registered WarmHub component — a packaged set of shapes, subscriptions, and credentials you install into any repo where you want reputation-weighted consensus over subjective-logic opinions.

Prerequisites

• An existing WarmHub repo to install into.
• A wh CLI authenticated against the org that owns the repo. See Getting access if you have not set this up yet.

Install

wh component install warmhub/veritas --repo [your-org]/[your-repo]

After the command returns, your repo has the four Veritas shapes and three subscriptions watching for new opinions. The CLI tracks the install so you can manage and tear it down later. (One prerequisite worth knowing: the four shape names Certainty, Support, Opposition, and Consensus must be absent or already owned by the Veritas component (warmhub/veritas) — a pre-existing user-owned shape under any of those names will fail the install with a shape-ownership error. Retract or rename the conflicting shape and rerun if you hit that.)

Confirm the install succeeded:

wh component list --repo [your-org]/[your-repo]
wh component view warmhub/veritas --repo [your-org]/[your-repo]

Every wh component lifecycle command — install, view, doctor, teardown — addresses Veritas by its registered <org>/<name> ref, warmhub/veritas. The manifest’s reverse-DNS component.id (com.warmhub.Veritas) is manifest metadata, not a CLI argument.

What gets installed

Shapes

Shape	Purpose	About target
Certainty	A source’s opinion about an assertion. The primitive bet that wagers source reputation.	An assertion (binary proposition).
Support	The belief that one assertion is evidence for another.	A Pair collection of two assertions, first → second.
Opposition	The belief that one assertion is evidence against another.	A Pair collection of two assertions, first → second.
Consensus	Veritas’s consolidated readout. Written by Veritas only.	An assertion (consolidating its Certainty opinions) or a Pair (consolidating its Support / Opposition opinions).

All four shapes carry belief, disbelief, uncertainty, and optional alpha. Certainty, Support, and Opposition additionally require a source wref — the thing whose reputation is wagered — and accept an optional rationale string. Consensus has no source or rationale; it is Veritas’s own consolidated readout, not a wager. See Writing opinions for examples.

Subscriptions

Veritas subscribes to changes on the three input shapes so it can re-solve whenever a new opinion lands:

Subscription	Triggers on
veritas-certainty	Add, revise, or retract of any Certainty assertion.
veritas-support	Add, revise, or retract of any Support assertion.
veritas-opposition	Add, revise, or retract of any Opposition assertion.

Webhook delivery is provisioned automatically — no setup required on your end.

Verifying health

Run health checks any time to confirm all declared resources are present and active:

wh component doctor warmhub/veritas --repo [your-org]/[your-repo]

A successful wh component install should land Veritas in ready — setup provisions the webhook signing secret for you, so you do not need to populate any credential keys yourself. If doctor reports degraded, something went wrong during setup or a resource has drifted; if it reports uninstalled, Veritas has been torn down. See Component lifecycle for the full state machine and recovery guidance — these are generic component states, not Veritas-specific. For credential-set inspection and key management specifically, see the wh credential commands.

Tearing down

Tear Veritas down without removing its shapes or assertions:

wh component teardown warmhub/veritas --repo [your-org]/[your-repo]

Teardown pauses Veritas’s subscriptions — incoming Certainty, Support, and Opposition changes will no longer trigger a re-solve — revokes the install’s tokens, and marks the component uninstalled. It is non-destructive: existing Consensus, Certainty, Support, and Opposition assertions and the four shapes remain in place (only a repo hard-delete removes those).

To bring Veritas back, reinstall it; the install record is revived. Because subscriptions are left paused, re-enable each one with wh sub resume <subscription-name> — reinstalling does not unpause them.

Next steps

• Writing opinions — how to author Certainty, Support, and Opposition, and how to read Consensus.
• Overview — the conceptual model behind the four shapes.