Expand description
Juridical capacity & state-transition (§18, legal_logic.md).
Obligations and stipulations are only valid if the asserting agent had the legal/cognitive
capacity to form them. This module is a conservative engine over the existing
guardianship ontology vocabulary (values:juridicalCapacity, CoercedConsentFlag,
VoidableStipulation, values:guardian, survivesDeath) — it wires terms Timothy already
coined; it does not invent new sensitive vocabulary.
Handled with gravity, two deliberate semantic choices (both from the spec, both the legally-careful reading — flagged here, not silently assumed):
- Duress → VOIDABLE, not void. A stipulation made under coercion is voidable at the
victim’s election — it is NOT automatically nullified. Auto-nullifying would strip the
victim of the choice to keep or undo it. (
◇Void, notVoid.) - Guardianship carries the dependent’s weight, it does not replace the dependent. A guardian acts on behalf of the dependent; the legal weight is the dependent’s.
Structs§
- Graduated
Competence - Graduated competence evaluation parameters for an agent facing a specific act. Models Gillick competence where capacity is dynamic and decision-relative rather than an absolute binary toggle.
- Kinship
Endorsement - Endorsement from a kinship circle, elder, parent, or trusted decision-making advocate.
- Succession
Event - Attested succession/mortality event from a mortality oracle or civil registry.
- Testamentary
Clause - Testamentary delegation terms specifying successor rights upon mortality event.
Enums§
- Capacity
Status - An agent’s juridical capacity for an act.
Functions§
- authorized_
after_ revocation - Authority after cascading revocation: a guardian may act in
requested_domainiff it is authorized AND not present in therevoked_domainsset (revocation withdraws it immediately). - capacity_
from_ age - Derive capacity from age against a jurisdiction threshold: below majority →
Impaired(minority); at/above →Intact. Coercion is layered separately (capacity_under_pressure). - capacity_
under_ pressure - Capacity under relational pressure: an otherwise-
Intactagent whose act is coerced becomesUnderDuress(voidable). Duress never upgrades an already-Impairedcapacity. - chain_
authorizes - A multi-link delegation chain authorizes
requested_domainiff: the root holds it, every link attenuates its predecessor (subset), and the domain survives at every level (no link silently re-broadens authority).chain[0]is the root delegation; each later link is a sub-delegation. Zero-heap (slice of slices). - decayed_
impairment - A transient impairment decaying linearly toward zero — a conservative clearance model
(e.g. intoxication).
initialis the level in[0,1]at t0;rateis decay per elapsed time unit. Returns the clamped residual level atelapsedunits. - delegation_
attenuates - Attenuation: a sub-delegation’s
child_domainsare valid only if a SUBSET of the delegator’sparent_domains— a delegatee never receives more authority than the delegator holds. (Empty child set trivially attenuates.) - detect_
duress - Map a relational power-imbalance signal to a duress finding.
imbalanceis a normalised[0,1]measure of relational asymmetry (dependency / authority / economic capture); anexplicit_threatforces duress regardless. At/abovethreshold, or under an explicit threat, the act is coerced → the resulting stipulation is voidable (never auto-void; the election stays with the victim — see module header). - effective_
principal - Guardianship / delegation: when a guardianship relation holds, a guardian’s act carries the
dependent’s legal weight (
values:actsOnBehalfOf). Returns the identity whose weight the act bears — the dependent under guardianship, else the actor themselves. - effective_
principal_ scoped - Domain-scoped effective principal: a guardian’s act carries the dependent’s weight ONLY within a delegated domain; outside the delegated set the guardian cannot bind the dependent (the act falls back to the actor’s own weight).
- eval_
graduated_ capacity - Evaluate graduated capacity under Gillick competence and supported decision-making.
- eval_
succession_ standing - Evaluates whether a successor holds standing to exercise authority in a requested domain under a testamentary clause and verified succession event.
- filter_
surviving_ claims - Filters an input stream of Quins for claims that survive the decedent’s death.
Matches Quins whose predicate equals
values:survivesDeathor subject equalsdecedent. - guardianship_
authorized - Selective delegation:
authorized_domainsenumerate exactly the domains of agency delegated to a guardian. The guardian may act inrequested_domainiff it is among them — no domain ⇒ no authority (selective, never plenary). - meets_
age_ of_ majority - Does
age_yearsmeet a jurisdiction’smajority_age? The threshold is supplied by the caller (jurisdiction-specific — 18 in most, 21 in some, mental-health-act variations) so the engine never bakes one jurisdiction’s law in as universal. - posthumous_
standing - Posthumous standing: a representative may prosecute the surviving claims of a deceased
agent (
BreachRecord(survivesDeath)+ representative standing). True iff the agent is deceased AND a representative stands for them. - stipulation_
binding - A stipulation by the agent is binding only when capacity is
Intact. - stipulation_
voidable - A stipulation made
UnderDuressis voidable at the victim’s election (CoercedConsentFlag → VoidableStipulation). Returns true iff the agent may elect to void it — NOT that it is already void (that choice stays with the victim). - survives_
death_ predicate - Predicate URI hash for claims surviving death (
values:survivesDeath). - testamentary_
successor_ predicate - Predicate URI hash for testamentary successor (
values:testamentarySuccessor). - transient_
capacity - Capacity under a transient impairment: while the decayed level is at/above
thresholdthe agent isImpaired; once it decays below, capacity self-clears toIntact. Distinct from durable incapacity (which does not decay).