Meta son registros que tratan del documento, no de contenido sobre el mundo. Salvo los registros de estructura del documento (DOC, BODY, END), todos van en el HEAD del documento. En el HEAD, además de los Meta, también van el Edge de fundamento de todo el documento SOURCE y sus QUALIFIER.
Layout
TAG WORD 000K KKKC CCCC LLLL secciones 14·15 (0x1C0L~0x1FFL)
[TAG de extensión de Length]
Payload valor en bruto o registros Value·Reference incorporados
- Meta no tiene formato de Issuer. Meta es una especificación común que siguen todos los Issuer y solo la define GEUL.
LLLLes el número total de WORD, incluido el TAG WORD, menos 1. Los Codec que no están en la tabla son Reserved.
Formato del Payload
| Formato | Cuándo | Ejemplo |
|---|---|---|
| valor en bruto | Cuando el formato queda fijado en uno solo. No se apoya en el Codec de otros registros | longitud de DOC-*, SPEC-VERSION, ISSUER-KEY |
| Value incorporado | Cuando se elige entre varios formatos. El TAG de Value indica el formato | PROFILE, EFFECTIVE-*, momentos, hash de contenido |
| Reference incorporado | Cuando se señala un objetivo como una persona, organización, herramienta o documento | DOC-ID, AUTHOR, CO-AUTHOR, RECORDED-BY, SIGNED-OFF, el firmante de SIGNATURE |
| ninguno | Marca de 1 WORD | BODY, END |
- Los registros incorporados no son registros independientes sino que pertenecen a su Meta. Cada uno encuentra su límite con su propio Length, y la posición tras leer el último registro debe coincidir exactamente con el final del Meta.
- Qué Meta pueden ponerse solo uno por documento y cuáles varios lo fija la «cantidad» de cada documento de Codec.
Clases
Los números de Meta continúan desde 0x1C0L sin Reserved. Los bits del número no indican la clase. La clase se conoce por la tabla de intervalos siguiente.
| Clase | Código directo | Qué trata |
|---|---|---|
| estructura | 0x1C0L~0x1C4L | Límites y longitud del documento |
| definición | 0x1C5L~0x1CAL | Declaraciones de interpretación |
| procedencia | 0x1CBL~0x1D0L | Quién, cuándo, dónde |
| linaje | 0x1D1L~0x1DDL | De qué y cómo surgió |
| política | 0x1DEL~0x1E3L | Cómo se trata |
| IMPORT | 0x1E4L | Importa un documento externo |
| verificación | 0x1E5L~0x1E9L | Si es fiable |
| Reserved (solo verificación) | 0x1EAL~0x1FFL |
- La clase de verificación son los registros de la sección 15 con
C >= 5, es decir,w >= 0x1E50. Con esto se reconoce la clase de verificación sin libro de códigos y se excluye del hash de contenido. - El Reserved final
0x1EAL~0x1FFLes solo para verificación. Un Meta nuevo ajeno a la verificación no puede insertarse antes de la verificación, y si se pone en el Reserved final queda fuera del hash de contenido. - Las clases de estructura, definición e IMPORT no se leen por bits. El decodificador las conoce por su tabla de números incorporada.
- Meta necesarios para la interpretación: estructura, definición, IMPORT. Si se borran, no se pueden leer los registros o cambia la interpretación. Todo decodificador debe procesarlos. Estos Codec pertenecen al libro de códigos central de GEUL.
- Meta que no cambian la interpretación: procedencia, linaje, verificación, política. Aunque se borren, el contenido de los enunciados sigue igual. Solo desaparece el material para juzgar la confianza y el tratamiento.
- El fundamento no se escribe con Meta sino con el Edge de fundamento SOURCE y QUALIFIER. El fundamento de cada registro va en el BODY, y el origen de todo el documento va en el HEAD como SOURCE con Target
0(documento).
Estructura
La clase de estructura de Meta (Codec 0x1C0L~0x1C4L) fija los límites y la longitud del documento. La unidad de los datos GEUL es un documento.
DOC-* ← inicio del HEAD
Meta de definición·procedencia·linaje·verificación·política·IMPORT
SOURCE de todo el documento y su QUALIFIER
BODY ← inicio del BODY
Reference, Value, Edge
END ← cierra el documento
- Todo documento se abre con
DOC-1WORD/2WORD/4WORD, que fija la longitud total. El decodificador puede saltar el documento entero de una vez con esta longitud. BODYyENDson registros de 1 WORD sin Payload.ENDes obligatorio.- Los documentos no se anidan. Los demás documentos se señalan con IMPORT.
- Si el HEAD (Meta, SOURCE de todo el documento y su QUALIFIER) está vacío, se omite
BODY.BODYsolo puede ponerse una vez por documento.
La estructura completa del documento está en documento.
| Codec | Nombre | Significado |
|---|---|---|
0x1C0L~0x1C2L | DOC-1WORD / 2WORD / 4WORD | Abre el documento fijando la longitud total |
0x1C3L | BODY | Termina el HEAD y abre el BODY |
0x1C4L | END | Cierra el documento |
Las reglas detalladas están en documento.
Definición
La clase de definición de Meta (Codec 0x1C5L~0x1CAL) son declaraciones de interpretación. Como las declaraciones cambian las reglas de interpretación, todo decodificador debe procesarlas. El alcance de una declaración es ese documento.
SPEC-VERSIONfija cómo se leen los demás registros, por lo que lleva solo un entero, sin Value incorporado. GEUL v1 es0x0001(registro1C51 0001).DOC-IDes elDOC-POINTER(Issuer, ID de documento, versión0) que señala al propio documento. Un documento de Codec usaCODEC-POINTER(Issuer, Codec ID, versión0). Si falta, es un documento sin nombre y solo se le puede señalar por hash de contenido.- No existe dirección por nombre de documento. El título legible por personas se pone con el
LABELde enunciado (direcciones de publicación y lista de versiones).
| Codec | Nombre | Significado |
|---|---|---|
0x1C5L | SPEC-VERSION | Edición de la especificación a la que se ajusta. Un solo entero |
0x1C6L | PROFILE | Perfil aplicado |
0x1C7L | DOC-ID | Identificador de este documento. DOC-POINTER (versión 0) que se señala a sí mismo. Un documento de Codec usa CODEC-POINTER (versión 0) |
0x1C8L | EFFECTIVE-FROM | Fecha de entrada en vigor de esta versión. Si falta, el momento de publicación |
0x1C9L | EFFECTIVE-UNTIL | Fin del período de vigencia de esta versión (ley temporal). Si falta, hasta que entre en vigor la versión siguiente |
0x1CAL | DEFAULT-LANGUAGE | Idioma por defecto |
- No existe dirección por nombre de documento (direcciones de publicación y lista de versiones). El título legible por personas se pone con el LABEL del BODY.
Procedencia
La clase de procedencia de Meta (Codec 0x1CBL~0x1D0L) indica quién creó y registró el documento, y cuándo.
- El autor, el registrador y sus momentos siguen el modelo de author y committer de git (
AUTHOR·CREATED-AT,RECORDED-BY·RECORDED-AT). - Aunque se borre la procedencia, el contenido de los enunciados no cambia. Solo desaparece el material para juzgar la confianza.
- Los materiales de origen no están en esta clase. El origen de todo el documento se escribe en el HEAD y el de cada registro en el BODY, con el Edge de fundamento SOURCE. El rango correspondiente en el original, el momento de obtención y el hash del original son QUALIFIER que se añaden a ese SOURCE (página P304·sección P958, fecha de consulta P813, suma de comprobación P4092).
- Si las propiedades propias del origen (rango del original, momento de obtención) se pusieran como Meta, cuando hubiera varios orígenes no se podría decidir de cuál son. Por eso se escriben como QUALIFIER cuyo Target es el SOURCE.
| Codec | Nombre | Significado |
|---|---|---|
0x1CBL | AUTHOR | Autor (Reference) |
0x1CCL | CO-AUTHOR | Coautor |
0x1CDL | CREATED-AT | Momento de redacción |
0x1CEL | MODIFIED-AT | Momento de modificación |
0x1CFL | RECORDED-BY | Sujeto que registró |
0x1D0L | RECORDED-AT | Momento del registro |
- El material de origen no se escribe como Meta sino como el Edge de fundamento SOURCE del HEAD (Target
0), y el rango del original, el momento de obtención y el hash del original se escriben como QUALIFIER que se añaden a ese SOURCE.
Linaje
La clase de linaje de Meta (Codec 0x1D1L~0x1DDL) indica de qué y cómo surgió el documento. El linaje sigue el modelo de commit de git, y la unidad equivalente al commit es el documento.
- El hash de contenido señala el contenido de un ejemplar del documento (git commit id). Es el SHA-256 desde el registro de apertura (
DOC-*) hasta justo antes deEND, y los registros de la clase de verificación (sección 15 conC >= 5,w >= 0x1E50) se excluyen del cálculo. - El ID de versión es un entero de 2 WORD que se numera desde 1 en orden de publicación dentro de un documento con nombre.
0significa que no se ha anotado la versión. - Los Meta de linaje señalan versiones por hash de contenido. Como el
PARENTdentro del documento también entra en el hash, el hash de contenido se convierte en una cadena de hashes que enlaza todo el historial. - El historial no se borra. Lo corregido se publica como una nueva versión. Los punteros cambiantes, como las branch, no se ponen en el documento.
DELTA-BASEyDELTA-REMOVEson el formato que guarda una versión como diff respecto de una versión base. La versión siempre se define como instantánea.
Las reglas de revisión están en documento.
El linaje sigue el modelo de commit de git. La unidad equivalente al commit es el documento.
| Codec | Nombre | Significado |
|---|---|---|
0x1D1L | PARENT | Hash de contenido de la versión inmediatamente anterior. Si hay varios, fusión |
0x1D2L | DERIVED-FROM | Derivado de materiales de otro linaje |
0x1D3L | GENERATED-BY | Sujeto generador (persona, modelo, motor de reglas) |
0x1D4L | TRANSFORMED-BY | Herramienta de conversión y la versión de su fuente (resumen del commit) |
0x1D5L | CHERRY-PICKED-FROM | Versión original del cambio tomado |
0x1D6L | REVERTS | Versión objetivo que se revirtió |
0x1D7L | REPLACES | Versión objetivo que se reescribió. La versión original no se borra |
0x1D8L | SQUASHED-FROM | Versiones originales fusionadas en una |
0x1D9L | MESSAGE | Motivo del cambio. Uno por idioma |
0x1DAL | TAG | Nombre inmutable asignado a una versión |
0x1DBL | DELTA-BASE | Este archivo es un diff respecto de una versión base |
0x1DCL | DELTA-REMOVE | Lista de LOCAL ID que el diff quita |
0x1DDL | NEXT-LOCAL-ID | Próximo LOCAL ID a asignar. Se pone en el documento de la lista de versiones |
- El historial no se borra. Lo corregido se publica como una nueva versión.
- Los punteros cambiantes, como las branch, no se ponen en el documento. Los gestionan el repositorio y el índice.
Verificación
La clase de verificación de Meta (Codec 0x1E5L~0x1E9L) contiene el material para juzgar si el documento es fiable: la clave pública de un Issuer de emisión propia, la firma, la confirmación del derecho de contribución, la confianza y el resultado del veredicto de todo el documento.
- La clase de verificación queda fuera del cálculo del hash de contenido. Por eso, aunque se ponga la firma dentro del documento o se añadan varias firmas, el hash de contenido no cambia (igual que
gpgsigde git). - La clase de verificación son los registros de la sección 15 con
C >= 5, es decir,w >= 0x1E50, así que el hash puede calcularse sin libro de códigos. El Reserved final0x1EAL~0x1FFLtambién es solo para verificación y queda fuera del hash. - El veredicto a nivel de nodo o registro lo asume el Edge
VERDICTde TOULMIN (0x118L).
| Codec | Nombre | Significado |
|---|---|---|
0x1E5L | ISSUER-KEY | Algoritmo de firma y clave pública de un Issuer de emisión propia |
0x1E6L | SIGNATURE | Firma del hash de contenido. Algoritmo, firmante, firma |
0x1E7L | SIGNED-OFF | Confirmación del derecho de contribución |
0x1E8L | CONFIDENCE | Confianza |
0x1E9L | VERDICT | Resultado del veredicto de todo el documento (Pass, Review, Fail) |
- La clase de verificación queda fuera del cálculo del hash de contenido. Por eso, aunque se ponga la firma dentro del documento o se añadan varias firmas, el hash de contenido no cambia.
Política
La clase de política de Meta (Codec 0x1DEL~0x1E3L) fija cómo se trata el documento: licencia, alcance de divulgación, nivel de datos personales, plazo de conservación, consentimiento y restricciones de uso.
- La política no cambia la interpretación; fija cómo se trata.
- La licencia original de las obras contenidas en la secuencia de bytes se registra con
LICENSE.
| Codec | Nombre | Significado |
|---|---|---|
0x1DEL | LICENSE | Licencia |
0x1DFL | ACCESS | Alcance de divulgación |
0x1E0L | PRIVACY | Nivel de datos personales |
0x1E1L | RETENTION | Plazo de conservación |
0x1E2L | CONSENT | Alcance del consentimiento y su fundamento |
0x1E3L | USAGE | Restricciones de uso |
- La política no cambia la interpretación; fija cómo se trata.
IMPORT
La clase IMPORT de Meta (Codec 0x1E4L) importa un documento externo mediante un IMPORT ID. El Codec es uno solo: IMPORT-DOC (0x1E4L).
- IMPORT solo importa documentos. Los objetivos dentro del documento importado se señalan con el Reference
EXTERNAL-POINTER-*(IMPORT ID, LOCAL ID) del BODY (Reference). - Si se escribe un ID de versión, se vincula a esa edición; con
0, a la última edición en el momento de la interpretación. Los documentos publicados anotan la versión. - No se importa el HEAD del documento importado. Los registros Reference y Value no se importan sino que se copian.
TAG WORD 0001 1110 0100 LLLL IMPORT-DOC (0x1E4L)
[TAG de extensión de Length]
Documento registro DOC-POINTER (Issuer, ID de documento, ID de versión). Un documento de Codec usa CODEC-POINTER
IMPORT ID el resto. Entero del ancho más corto
- Solo se usa IMPORT-DOC (
0x1E4L). IMPORT solo importa documentos. Los objetivos dentro del documento importado se señalan conEXTERNAL-POINTER-*(IMPORT ID, LOCAL ID) del BODY. - Si se escribe un ID de versión, se vincula a esa edición; con
0, a la última edición en el momento de la interpretación. Los documentos publicados anotan la versión. - En un documento no se asigna dos veces el mismo IMPORT ID.
- No se importa el HEAD del documento importado. Los objetivos de ese documento se interpretan según las declaraciones de ese documento.
Ejemplo: se importa con IMPORT ID 1 la última versión del documento 0x0000000000000002 del Issuer 0x00000002.
1E4A 0418 0000 0002 0000 0000 0000 0002 0000 0000 0001