Skip to main content

Module trigger

Module trigger 

Source
Expand description

The Trigger algebra (ADR §7.1) — when a delegated authority activates.

A Trigger is a bounded boolean expression over primitive predicates. Authority can activate on cryptographic / temporal conditions (a verifiable event, a time window, a deadman/liveness switch) AND / OR on subjective human consensus (e.g. two registered physicians attest incapacity), composed freely with All / Any / Not.

This is deliberately both, composed (ADR §7.1): purely-cryptographic predicates cannot capture clinical judgement, and purely-subjective attestation is not accountable. HumanConsensus requires signed attestations carrying a role/capacity credential, so subjective judgement becomes part of the evidence chain — accountable and contestable — rather than a black box.

Load-bearing philosophy (this crate is supported agency, not a warden model): a Trigger only ever governs the activation of a delegation over personhood (socio-legal agency). It amplifies a person’s agency (an accountant, a clinical psychologist, a work-peer, or — when someone is isolated — a declared software source of truth). Selfhood is inherent to the person and is never delegated, so nothing here can be used to trigger control over it. Higher-stakes / selfhood-adjacent domains simply demand higher m-of-n thresholds.

evaluate is a bounded, deterministic recursion over the tree: given a TriggerContext (the current time, which events have occurred, the collected attestations, and the last liveness ping) it returns whether the trigger has fired. It never allocates unboundedly and has no side effects.

Structs§

Attestation
A single human attestation: the role/capacity it was made under (a taxonomy TermId, kept as an optional String here so the vocabulary stays open) and whether it is cryptographically signed.
TriggerContext
The evaluation context — the observable world state a Trigger is tested against. All fields are data the delegation infrastructure already collects (event log, liveness pings, the attestation queue); evaluate reads them without mutation.

Enums§

Trigger
A composable activation condition for a delegated authority (ADR §7.1).

Functions§

evaluate
Evaluate a Trigger against a TriggerContext. Deterministic, side-effect-free, and bounded by the size of the trigger tree (recursion depth = tree depth).