Trust module

The assertion as a first-class entity: subject, predicate and object together with their source, evidence and confirmation. The module has its own namespace and its own version; it extends the L1 core rather than replacing it.

IRIhttps://mef.dev/kg/assertion
Version1.3.1.0 (module kga)
owl:importshttps://mef.dev/kg/core specification 2.14.1.0

Classes (6)

TermParentDefinition
kga:Annulmentprov:ActivityAn act that revokes a confirmation: who, when, by which method and on what grounds. The chain is the same as a confirmation's; the confirmation itself stays in the history.
kga:Assertionprov:EntityA single dataset statement: subject, predicate and object taken as an entity. The base triple stays materialised in the graph; an Assertion does not replace it but names it, so that a source, evidence and a confirmation can be attached.
kga:Confirmationprov:ActivityAn act of confirmation: who, when and by which method. The method is a concept of the kgp:confirmationMethods scheme; the performer is a prov:Agent by IRI, so self-confirmation is decided by comparing identities, not strings.
kga:Evidenceprov:EntityEvidence supporting an assertion, described by dimensions: authenticity, authority, freshness, corroboration, validation status. A single rank does not substitute for them.
kga:ReleaseApprovalkga:ConfirmationA decision about one version of a dataset: this state may be taken, or may not, or no decision exists yet. It is stated on the dataset node and names the version, the role and the method — the same chain as the confirmation of an assertion.
kga:SourceFragmentprov:EntityA fragment of a source: the document, a selector and a content digest. An assertion's freshness is checked against the fragment digest, not the whole source revision — an edit on page 200 does not stale a fact from page 5.

Properties (19)

TermKindDefinition
kga:annulmentReasonvalueThe grounds for the annulment, in the words of whoever decided it. Without them the act states that the confirmation is withdrawn and not why — which is the first question asked.
kga:annulsreferenceThe confirmation this act revokes.
kga:approvalStatereferenceThe approval state of a dataset version. The value is a concept of the kga:approvalStates scheme.
kga:approvedVersionvalueThe dataset version the decision applies to. A decision applies to a state, not to a branch: the next version needs its own.
kga:auditRefvalueA trace in the execution journal: a token jti, a passportId or a Trusted Layer audit eventId. The journal holds the proof itself; the graph carries the reference.
kga:authenticityreferenceThe evidence's authenticity: what attests that the artifact is what it claims to be. The value is a concept of the kga:authenticities scheme.
kga:authorityreferenceThe authority of the evidence's source over the assertion's subject matter. The value is a concept of the kga:authorities scheme.
kga:contentDigestvalueThe digest of the fragment's content, with the algorithm named. Freshness derives from comparing the digest and is never set by hand.
kga:corroborationCountvalueHow many independent sources corroborate the same fact.
kga:freshnessStatusreferenceThe evidence's freshness relative to the source fragment. Derived from comparing the fragment digest; the value is a concept of the kga:freshnesses scheme.
kga:groundingreferenceWhat to do with a state. The value is a concept of the kga:groundings scheme; it is declared on the state concept, not on every assertion.
kga:objectannotationThe object of the named assertion: a reference or a literal.
kga:predicatereferenceThe predicate of the named assertion.
kga:selectorvalueThe fragment's address inside the document: an anchor, a table row, a range.
kga:sourceDocumentreferenceThe document the fragment is taken from.
kga:subjectreferenceThe subject of the named assertion.
kga:supportedByreferenceThe evidence that supports the assertion. An assertion may have several independent pieces of evidence, including contradictory ones: which version is in force is a policy decision, not an overwrite by the last value.
kga:tenantreferenceThe isolation boundary the assertion belongs to. A description, not enforcement: isolation is done by the runtime — the gateway and partitioned graphs.
kga:validationStatusreferenceThe evidence's validation status. The value is a concept of the kga:validations scheme.

Evidence dimensions

Release approval state kga:approvalStates

approved
The version is approved: this state of the dataset may be taken.
pending
No decision about the version has been taken yet.
withdrawn
The approval is withdrawn: the state stays in the history but may not be taken.

Evidence authenticity kga:authenticities

platform-attested
Attested by the platform: a detached JWS and a signed Secure Passport, single-use by jti (the A2A-T Trusted Layer).
stated
Stated without an artifact: a person's or an agent's word.
system-recorded
Recorded by a system: a journal or registry entry kept by someone other than the assertion's author.

Source authority kga:authorities

secondary
A secondary source: a retelling, a copy, documentation.
system-of-record
The system of record this fact belongs to by design.
unknown
Authority not established.

Evidence freshness kga:freshnesses

current
The fragment digest matches the current source.
stale
The fragment has changed: the evidence needs review.
unknown
Nothing to compare against: the digest or the source is missing.

Grounding policy kga:groundings

assert
May be presented as fact, citing the confirmation.
attribute
Present only with attribution to the source: "according to document X". It is not yet a fact.
exclude
Do not present at all: the confirmation was revoked, or evidence for the contrary exists.

Validation status kga:validations

annulled
A confirmation existed and was revoked by a kga:Annulment act. This state may not be taken; the confirmation act itself stays in the history.
confirmed
Confirmed by a kga:Confirmation act.
disputed
Evidence for a contradictory assertion exists.
kga:valid-node-level-legacy
Carried over from L1 node-level provenance without re-binding to the individual assertion.
unconfirmed
A candidate: not yet confirmed.

Validation profiles

ShapeTermDefinition
kga:AgentIdentityShape—Author identity — an IRI in the mef.dev/id pattern
kga:AnnulledEvidenceShapekga:EvidenceAn annulled confirmation leaves a trace in the evidence status
kga:AnnulmentShapekga:AnnulmentAn annulment names what is revoked, by whom and on what grounds
kga:ConfirmationShapekga:ConfirmationA confirmation names the performer and the method
kga:EvidenceShapekga:EvidenceEvidence dimensions come from their vocabularies
kga:IngestAssertionShapekga:AssertionRaw ingest is visible and nothing is blocked
kga:MaterialisedTripleShapekga:AssertionThe assertion's triple is materialised
kga:PerformerIdentityShape—Performer identity — an IRI in the mef.dev/id pattern
kga:ReleaseApprovalShapekga:ReleaseApprovalAn approval names the version, the state and the role
kga:SelfConfirmationShapekga:AssertionThe asserter is not the confirmer
kga:SourceFragmentShapekga:SourceFragmentA fragment carries a digest
kga:TrustedAssertionShapekga:AssertionA trusted assertion is complete and closed