Módulo de confianza
La aserción como entidad de primer nivel: sujeto, predicado y objeto junto con su fuente, su evidencia y su confirmación. El módulo tiene su propio espacio de nombres y su propia versión; amplía el núcleo L1 en lugar de sustituirlo.
| IRI | https://mef.dev/kg/assertion |
|---|---|
| Versión | 1.3.1.0 (módulo kga) |
| owl:imports | https://mef.dev/kg/core especificación 2.14.1.0 |
Clases (6)
| Término | Padre | Definición |
|---|---|---|
kga:Annulment | prov:Activity | Un acto que revoca una confirmación: quién, cuándo, con qué método y por qué motivos. La cadena es la misma que la de una confirmación; la confirmación en sí permanece en el historial. |
kga:Assertion | prov:Entity | Una única declaración del conjunto de datos: sujeto, predicado y objeto tomados como una entidad. La tripleta base permanece materializada en el grafo; una Assertion no la sustituye sino que le da nombre, para poder adjuntarle una fuente, una evidencia y una confirmación. |
kga:Confirmation | prov:Activity | Un acto de confirmación: quién, cuándo y con qué método. El método es un concepto del esquema kgp:confirmationMethods; el ejecutor es un prov:Agent identificado por IRI, de modo que la autoconfirmación se decide comparando identidades, no cadenas. |
kga:Evidence | prov:Entity | Evidencia que respalda una aserción, descrita mediante dimensiones: autenticidad, autoridad, vigencia, corroboración, estado de validación. Un rango único no las sustituye. |
kga:ReleaseApproval | kga:Confirmation | Una decisión sobre una versión de un conjunto de datos: este estado puede tomarse, o no puede, o aún no existe ninguna decisión. Se declara en el nodo del conjunto de datos y nombra la versión, el rol y el método — la misma cadena que la confirmación de una aserción. |
kga:SourceFragment | prov:Entity | Un fragmento de una fuente: el documento, un selector y una huella del contenido. La vigencia de una aserción se comprueba contra la huella del fragmento, no contra la revisión de toda la fuente — una edición en la página 200 no deja desactualizado un hecho de la página 5. |
Propiedades (19)
| Término | Tipo | Definición |
|---|---|---|
kga:annulmentReason | valor | Los motivos de la anulación, en palabras de quien la decidió. Sin ellos, el acto indica que la confirmación se ha retirado pero no por qué — que es la primera pregunta que se plantea. |
kga:annuls | referencia | La confirmación que revoca este acto. |
kga:approvalState | referencia | El estado de aprobación de una versión de un conjunto de datos. El valor es un concepto del esquema kga:approvalStates. |
kga:approvedVersion | valor | La versión del conjunto de datos a la que se aplica la decisión. Una decisión se aplica a un estado, no a una rama: la versión siguiente necesita la suya propia. |
kga:auditRef | valor | Una traza en el diario de ejecución: un jti de token, un passportId o un eventId de auditoría de la Trusted Layer. El diario conserva la prueba en sí; el grafo lleva la referencia. |
kga:authenticity | referencia | La autenticidad de la evidencia: qué atestigua que el artefacto es lo que dice ser. El valor es un concepto del esquema kga:authenticities. |
kga:authority | referencia | La autoridad de la fuente de la evidencia sobre la materia de la aserción. El valor es un concepto del esquema kga:authorities. |
kga:contentDigest | valor | La huella del contenido del fragmento, con el algoritmo indicado. La vigencia deriva de comparar la huella y nunca se fija a mano. |
kga:corroborationCount | valor | Cuántas fuentes independientes corroboran el mismo hecho. |
kga:freshnessStatus | referencia | La vigencia de la evidencia respecto del fragmento de la fuente. Se deriva de comparar la huella del fragmento; el valor es un concepto del esquema kga:freshnesses. |
kga:grounding | referencia | Qué hacer con un estado. El valor es un concepto del esquema kga:groundings; se declara en el concepto de estado, no en cada aserción. |
kga:object | anotación | El objeto de la aserción con nombre: una referencia o un literal. |
kga:predicate | referencia | El predicado de la aserción con nombre. |
kga:selector | valor | La dirección del fragmento dentro del documento: un ancla, una fila de tabla, un rango. |
kga:sourceDocument | referencia | El documento del que se toma el fragmento. |
kga:subject | referencia | El sujeto de la aserción con nombre. |
kga:supportedBy | referencia | La evidencia que respalda la aserción. Una aserción puede tener varias evidencias independientes, incluso contradictorias: qué versión prevalece es una decisión de política, no una sobrescritura con el último valor. |
kga:tenant | referencia | El límite de aislamiento al que pertenece la aserción. Una descripción, no un mecanismo de aplicación: el aislamiento lo realiza el entorno de ejecución — la pasarela y los grafos particionados. |
kga:validationStatus | referencia | El estado de validación de la evidencia. El valor es un concepto del esquema kga:validations. |
Dimensiones de la evidencia
Estado de aprobación de la publicación kga:approvalStates
approved- La versión está aprobada: este estado del conjunto de datos puede tomarse.
pending- Aún no se ha tomado ninguna decisión sobre la versión.
withdrawn- La aprobación se ha retirado: el estado permanece en el historial pero no puede tomarse.
Autenticidad de la evidencia kga:authenticities
platform-attested- Atestiguado por la plataforma: un JWS separado y un Secure Passport firmado, de un solo uso por jti (la Trusted Layer de A2A-T).
stated- Afirmado sin artefacto: la palabra de una persona o de un agente.
system-recorded- Registrado por un sistema: una entrada de diario o de registro mantenida por alguien distinto del autor de la aserción.
Autoridad de la fuente kga:authorities
secondary- Una fuente secundaria: una paráfrasis, una copia, documentación.
system-of-record- El sistema de registro al que este hecho pertenece por diseño.
unknown- Autoridad no establecida.
Vigencia de la evidencia kga:freshnesses
current- La huella del fragmento coincide con la fuente actual.
stale- El fragmento ha cambiado: la evidencia debe revisarse.
unknown- Nada con qué comparar: falta la huella o la fuente.
Política de fundamentación kga:groundings
assert- Puede presentarse como un hecho, citando la confirmación.
attribute- Presentar solo con atribución a la fuente: "según el documento X". Todavía no es un hecho.
exclude- No presentar en absoluto: la confirmación fue revocada, o existe evidencia de lo contrario.
Estado de validación kga:validations
annulled- Existió una confirmación y fue revocada por un acto kga:Annulment. Este estado no puede tomarse; el acto de confirmación en sí permanece en el historial.
confirmed- Confirmado por un acto kga:Confirmation.
disputed- Existe evidencia de una aserción contradictoria.
kga:valid-node-level-legacy- Trasladado de la procedencia a nivel de nodo de L1 sin volver a vincularse a la aserción individual.
unconfirmed- Un candidato: aún no confirmado.
Perfiles de validación
| Forma | Término | Definición |
|---|---|---|
kga:AgentIdentityShape | — | Identidad del autor — un IRI según el patrón mef.dev/id |
kga:AnnulledEvidenceShape | kga:Evidence | Una confirmación anulada deja rastro en el estado de la evidencia |
kga:AnnulmentShape | kga:Annulment | Una anulación nombra qué se revoca, por quién y por qué motivos |
kga:ConfirmationShape | kga:Confirmation | Una confirmación nombra al ejecutor y el método |
kga:EvidenceShape | kga:Evidence | Las dimensiones de la evidencia provienen de sus vocabularios |
kga:IngestAssertionShape | kga:Assertion | La ingesta en bruto es visible y nada se bloquea |
kga:MaterialisedTripleShape | kga:Assertion | La tripleta de la aserción está materializada |
kga:PerformerIdentityShape | — | Identidad del ejecutor — un IRI según el patrón mef.dev/id |
kga:ReleaseApprovalShape | kga:ReleaseApproval | Una aprobación nombra la versión, el estado y el rol |
kga:SelfConfirmationShape | kga:Assertion | Quien afirma no es quien confirma |
kga:SourceFragmentShape | kga:SourceFragment | Un fragmento lleva una huella |
kga:TrustedAssertionShape | kga:Assertion | Una aserción de confianza es completa y cerrada |