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.
| IRI | https://mef.dev/kg/assertion |
|---|---|
| Version | 1.3.1.0 (module kga) |
| owl:imports | https://mef.dev/kg/core specification 2.14.1.0 |
Classes (6)
| Term | Parent | Definition |
|---|---|---|
kga:Annulment | prov:Activity | An 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:Assertion | prov:Entity | A 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:Confirmation | prov:Activity | An 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:Evidence | prov:Entity | Evidence supporting an assertion, described by dimensions: authenticity, authority, freshness, corroboration, validation status. A single rank does not substitute for them. |
kga:ReleaseApproval | kga:Confirmation | A 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:SourceFragment | prov:Entity | A 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)
| Term | Kind | Definition |
|---|---|---|
kga:annulmentReason | value | The 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:annuls | reference | The confirmation this act revokes. |
kga:approvalState | reference | The approval state of a dataset version. The value is a concept of the kga:approvalStates scheme. |
kga:approvedVersion | value | The dataset version the decision applies to. A decision applies to a state, not to a branch: the next version needs its own. |
kga:auditRef | value | A 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:authenticity | reference | The 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:authority | reference | The authority of the evidence's source over the assertion's subject matter. The value is a concept of the kga:authorities scheme. |
kga:contentDigest | value | The digest of the fragment's content, with the algorithm named. Freshness derives from comparing the digest and is never set by hand. |
kga:corroborationCount | value | How many independent sources corroborate the same fact. |
kga:freshnessStatus | reference | The 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:grounding | reference | What 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:object | annotation | The object of the named assertion: a reference or a literal. |
kga:predicate | reference | The predicate of the named assertion. |
kga:selector | value | The fragment's address inside the document: an anchor, a table row, a range. |
kga:sourceDocument | reference | The document the fragment is taken from. |
kga:subject | reference | The subject of the named assertion. |
kga:supportedBy | reference | The 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:tenant | reference | The isolation boundary the assertion belongs to. A description, not enforcement: isolation is done by the runtime — the gateway and partitioned graphs. |
kga:validationStatus | reference | The 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
| Shape | Term | Definition |
|---|---|---|
kga:AgentIdentityShape | — | Author identity — an IRI in the mef.dev/id pattern |
kga:AnnulledEvidenceShape | kga:Evidence | An annulled confirmation leaves a trace in the evidence status |
kga:AnnulmentShape | kga:Annulment | An annulment names what is revoked, by whom and on what grounds |
kga:ConfirmationShape | kga:Confirmation | A confirmation names the performer and the method |
kga:EvidenceShape | kga:Evidence | Evidence dimensions come from their vocabularies |
kga:IngestAssertionShape | kga:Assertion | Raw ingest is visible and nothing is blocked |
kga:MaterialisedTripleShape | kga:Assertion | The assertion's triple is materialised |
kga:PerformerIdentityShape | — | Performer identity — an IRI in the mef.dev/id pattern |
kga:ReleaseApprovalShape | kga:ReleaseApproval | An approval names the version, the state and the role |
kga:SelfConfirmationShape | kga:Assertion | The asserter is not the confirmer |
kga:SourceFragmentShape | kga:SourceFragment | A fragment carries a digest |
kga:TrustedAssertionShape | kga:Assertion | A trusted assertion is complete and closed |