Meta são registros sobre o documento, não conteúdo sobre o mundo. Exceto os registros de estrutura do documento (DOC, BODY, END), todos ficam no HEAD do documento. No HEAD, além de Meta, também vêm o Edge de fundamento SOURCE do documento inteiro e o seu QUALIFIER.
Layout
TAG WORD 000K KKKC CCCC LLLL Seções 14 e 15 (0x1C0L~0x1FFL)
[TAG de extensão de Length]
Payload valor bruto, ou registros Value·Reference embutidos
- Meta não tem formato Issuer. Meta é uma especificação comum que todos os Issuers seguem, e só o GEUL a define.
LLLLé o número total de WORDs, incluindo a TAG WORD, menos 1. Os Codecs que não constam da tabela são Reserved.
Formato do Payload
| Formato | Quando | Exemplo |
|---|---|---|
| valor bruto | Quando o formato é único. Não depende do Codec de outro registro | comprimento de DOC-*, SPEC-VERSION, ISSUER-KEY |
| Value embutido | Quando se escolhe entre vários formatos. A TAG do Value indica o formato | PROFILE, EFFECTIVE-*, instantes, hash de conteúdo |
| Reference embutida | Quando se aponta para um alvo como pessoa, organização, ferramenta ou documento | DOC-ID, AUTHOR, CO-AUTHOR, RECORDED-BY, SIGNED-OFF, o signatário de SIGNATURE |
| nenhum | Marca de 1 WORD | BODY, END |
- Um registro embutido não é um registro independente; pertence ao seu Meta. Cada um encontra a sua fronteira pelo próprio Length, e a posição após a leitura do último registro deve coincidir exatamente com o fim do Meta.
- Quais Meta podem aparecer uma só vez no documento e quais podem aparecer várias vezes é definido pela «Quantidade» no documento de cada Codec.
Classes
Os números de Meta continuam sem Reserved a partir de 0x1C0L. Os bits do número não indicam a classe. A classe se conhece pela tabela de intervalos abaixo.
| Classe | Código direto | O que trata |
|---|---|---|
| estrutura | 0x1C0L~0x1C4L | Fronteira e comprimento do documento |
| definição | 0x1C5L~0x1CAL | Declarações de interpretação |
| proveniência | 0x1CBL~0x1D0L | Quem, quando, onde |
| linhagem | 0x1D1L~0x1DDL | De onde e como surgiu |
| política | 0x1DEL~0x1E3L | Como é tratado |
| IMPORT | 0x1E4L | Importa um documento externo |
| verificação | 0x1E5L~0x1E9L | É confiável |
| Reserved (exclusivo de verificação) | 0x1EAL~0x1FFL |
- A classe de verificação é formada pelos registros da seção 15 com
C >= 5, isto é,w >= 0x1E50. Com isso, sem livro de Codecs, sabe-se qual é a classe de verificação e ela é excluída do hash de conteúdo. - O Reserved final
0x1EAL~0x1FFLé exclusivo de verificação. Um novo Meta fora de verificação não pode ser inserido antes de verificação, e se for colocado no Reserved final fica de fora do hash de conteúdo. - As classes de estrutura, definição e IMPORT não se leem por bits. O decodificador as conhece pela tabela de números embutida.
- Meta necessários à interpretação: estrutura, definição, IMPORT. Se apagados, não se consegue ler os registros ou a interpretação muda. Todo decodificador deve tratá-los. Esses Codecs pertencem ao livro de Codecs central do GEUL.
- Meta que não alteram a interpretação: proveniência, linhagem, verificação, política. Mesmo apagados, o conteúdo dos enunciados permanece. Somem apenas os materiais do juízo de confiança e do tratamento.
- O fundamento não é escrito como Meta, e sim com o Edge de fundamento SOURCE e QUALIFIER. O fundamento de cada registro vai no BODY, e a origem do documento inteiro vai no HEAD como SOURCE com Target
0(documento).
Estrutura
A classe de estrutura de Meta (Codecs 0x1C0L~0x1C4L) define a fronteira e o comprimento do documento. A unidade dos dados GEUL é um documento.
DOC-* ← início do HEAD
Meta de definição, proveniência, linhagem, verificação, política e IMPORT
SOURCE do documento inteiro e seu QUALIFIER
BODY ← início do BODY
Reference, Value, Edge
END ← fecha o documento
- Todo documento é aberto com
DOC-1WORD/2WORD/4WORD, que indica o comprimento total. O decodificador pode saltar o documento inteiro de uma vez usando esse comprimento. BODYeENDsão registros de 1 WORD sem Payload.ENDé obrigatório.- Documentos não se aninham. Outros documentos são apontados por IMPORT.
- Se o HEAD (Meta, SOURCE do documento inteiro e seu QUALIFIER) estiver vazio, omite-se o
BODY. OBODYsó pode aparecer uma vez por documento.
A estrutura completa do documento está em documento.
| Codec | Nome | Significado |
|---|---|---|
0x1C0L~0x1C2L | DOC-1WORD / 2WORD / 4WORD | Abre o documento indicando o comprimento total |
0x1C3L | BODY | Encerra o HEAD e abre o BODY |
0x1C4L | END | Fecha o documento |
As regras detalhadas estão em documento.
Definição
A classe de definição de Meta (Codecs 0x1C5L~0x1CAL) reúne declarações de interpretação. Como as declarações alteram as regras de interpretação, todo decodificador deve tratá-las. O escopo de uma declaração é o seu documento.
SPEC-VERSIONdetermina como ler os demais registros, por isso usa apenas um inteiro, sem Value embutido. O GEUL v1 é0x0001(registro1C51 0001).DOC-IDé oDOC-POINTER(Issuer, ID do documento, versão0) que aponta para o próprio documento. Documentos de Codec usamCODEC-POINTER(Issuer, Codec ID, versão0). Se ausente, é um documento sem nome, que só pode ser apontado pelo hash de conteúdo.- Não existe endereço por nome de documento. O título legível por pessoas é posto como
LABELde enunciado (endereço de publicação e lista de versões).
| Codec | Nome | Significado |
|---|---|---|
0x1C5L | SPEC-VERSION | Edição da especificação seguida. Um só inteiro |
0x1C6L | PROFILE | Perfil aplicado |
0x1C7L | DOC-ID | Identificador deste documento. DOC-POINTER que aponta para si mesmo (versão 0). Documentos de Codec usam CODEC-POINTER (versão 0) |
0x1C8L | EFFECTIVE-FROM | Data de entrada em vigor desta versão. Se ausente, o instante de publicação |
0x1C9L | EFFECTIVE-UNTIL | Fim do período de vigência desta versão (lei temporária). Se ausente, até que a próxima versão entre em vigor |
0x1CAL | DEFAULT-LANGUAGE | Idioma padrão |
- Não existe endereço por nome de documento (endereço de publicação e lista de versões). O título legível por pessoas é posto como LABEL no BODY.
Proveniência
A classe de proveniência de Meta (Codecs 0x1CBL~0x1D0L) registra quem criou e registrou o documento, e quando.
- O autor, o registrador e seus instantes seguem o modelo author e committer do git (
AUTHOReCREATED-AT,RECORDED-BYeRECORDED-AT). - Mesmo que a proveniência seja apagada, o conteúdo dos enunciados não muda. Somem apenas os materiais do juízo de confiança.
- O material de origem não está nesta classe. A origem do documento inteiro vai no HEAD, e a de cada registro vai no BODY, com o Edge de fundamento SOURCE. A faixa correspondente no original, o instante de obtenção e o hash do original são QUALIFIER anexados a esse SOURCE (página P304 e seção P958, data de consulta P813, soma de verificação P4092).
- Se as propriedades que acompanham a origem (faixa no original, instante de obtenção) fossem postas como Meta, não se poderia determinar de qual origem são quando há várias. Por isso são escritas como QUALIFIER que tem o SOURCE como Target.
| Codec | Nome | Significado |
|---|---|---|
0x1CBL | AUTHOR | Autor (Reference) |
0x1CCL | CO-AUTHOR | Coautor |
0x1CDL | CREATED-AT | Instante de redação |
0x1CEL | MODIFIED-AT | Instante de modificação |
0x1CFL | RECORDED-BY | Agente do registro |
0x1D0L | RECORDED-AT | Instante do registro |
- O material de origem não é escrito como Meta, e sim como Edge de fundamento SOURCE do HEAD (Target
0); a faixa no original, o instante de obtenção e o hash do original são escritos como QUALIFIER anexados a esse SOURCE.
Linhagem
A classe de linhagem de Meta (Codecs 0x1D1L~0x1DDL) registra de onde e como o documento surgiu. A linhagem segue o modelo de commit do git, e a unidade equivalente ao commit é o documento.
- O hash de conteúdo aponta para o conteúdo de um exemplar do documento (git commit id). É o SHA-256 desde o registro de abertura (
DOC-*) até imediatamente antes deEND, e os registros da classe de verificação (C >= 5na seção 15,w >= 0x1E50) são excluídos do cálculo. - O ID de versão é um inteiro de 2 WORDs numerado a partir de 1 na ordem de publicação dentro de um documento com nome.
0significa que a versão não foi indicada. - Os Meta de linhagem apontam para versões pelo hash de conteúdo. Como o
PARENTdentro do documento também entra no hash, o hash de conteúdo forma uma cadeia de hashes que liga todo o histórico. - O histórico não é apagado. O conteúdo corrigido sai como nova versão. Ponteiros mutáveis como branch não são postos no documento.
DELTA-BASEeDELTA-REMOVEsão o formato que armazena uma versão como diff em relação a uma versão-base. A versão é sempre definida como snapshot.
As regras de revisão estão em documento.
A linhagem segue o modelo de commit do git. A unidade equivalente ao commit é o documento.
| Codec | Nome | Significado |
|---|---|---|
0x1D1L | PARENT | Hash de conteúdo da versão imediatamente anterior. Se vários, é mesclagem |
0x1D2L | DERIVED-FROM | Derivado de material de outra linhagem |
0x1D3L | GENERATED-BY | Agente gerador (pessoa, modelo, motor de regras) |
0x1D4L | TRANSFORMED-BY | Ferramenta de conversão e sua versão-fonte (digest do commit) |
0x1D5L | CHERRY-PICKED-FROM | Versão original da alteração trazida |
0x1D6L | REVERTS | Versão revertida |
0x1D7L | REPLACES | Versão reescrita. A versão original não é apagada |
0x1D8L | SQUASHED-FROM | Versões originais fundidas em uma só |
0x1D9L | MESSAGE | Motivo da alteração. Um por idioma |
0x1DAL | TAG | Nome imutável atribuído a uma versão |
0x1DBL | DELTA-BASE | Este arquivo é um diff em relação à versão-base |
0x1DCL | DELTA-REMOVE | Lista de LOCAL ID a retirar do diff |
0x1DDL | NEXT-LOCAL-ID | Próximo LOCAL ID a atribuir. Fica no documento de lista de versões |
- O histórico não é apagado. O conteúdo corrigido sai como nova versão.
- Ponteiros mutáveis como branch não são postos no documento. Quem os gerencia são o repositório e o índice.
Verificação
A classe de verificação de Meta (Codecs 0x1E5L~0x1E9L) registra os materiais para julgar se o documento é confiável: a chave pública de um Issuer autoemitido, assinaturas, confirmação do direito de contribuir, grau de confiança e o resultado do julgamento do documento inteiro.
- A classe de verificação é excluída do cálculo do hash de conteúdo. Assim, mesmo que a assinatura seja posta dentro do documento, ou que várias assinaturas sejam acrescentadas, o hash de conteúdo não muda (como o
gpgsigdo git). - A classe de verificação é formada pelos registros da seção 15 com
C >= 5, isto é,w >= 0x1E50, de modo que o hash pode ser calculado sem livro de Codecs. O Reserved final0x1EAL~0x1FFLtambém é exclusivo de verificação e fica fora do hash. - O julgamento por nó ou registro cabe ao Edge
VERDICT(0x118L) de TOULMIN.
| Codec | Nome | Significado |
|---|---|---|
0x1E5L | ISSUER-KEY | Algoritmo de assinatura e chave pública de um Issuer autoemitido |
0x1E6L | SIGNATURE | Assinatura sobre o hash de conteúdo. Algoritmo, signatário, assinatura |
0x1E7L | SIGNED-OFF | Confirmação do direito de contribuir |
0x1E8L | CONFIDENCE | Grau de confiança |
0x1E9L | VERDICT | Resultado do julgamento do documento inteiro (Pass, Review, Fail) |
- A classe de verificação é excluída do cálculo do hash de conteúdo. Assim, mesmo que a assinatura seja posta dentro do documento, ou que várias assinaturas sejam acrescentadas, o hash de conteúdo não muda.
Política
A classe de política de Meta (Codecs 0x1DEL~0x1E3L) define como o documento é tratado: licença, nível de divulgação, nível de dados pessoais, prazo de conservação, consentimento e restrição de uso.
- A política não altera a interpretação; define o modo de tratamento.
- A licença original de uma obra contida na sequência de bytes é registrada com
LICENSE.
| Codec | Nome | Significado |
|---|---|---|
0x1DEL | LICENSE | Licença |
0x1DFL | ACCESS | Nível de divulgação |
0x1E0L | PRIVACY | Nível de dados pessoais |
0x1E1L | RETENTION | Prazo de conservação |
0x1E2L | CONSENT | Escopo e fundamento do consentimento |
0x1E3L | USAGE | Restrição de uso |
- A política não altera a interpretação; define o modo de tratamento.
IMPORT
A classe IMPORT de Meta (Codec 0x1E4L) importa um documento externo por IMPORT ID. O Codec é um só: IMPORT-DOC (0x1E4L).
- O IMPORT importa apenas documentos. Os alvos dentro do documento importado são apontados no BODY pela Reference
EXTERNAL-POINTER-*(IMPORT ID, LOCAL ID) (Reference). - Se um ID de versão for indicado, liga-se a essa edição; se for
0, liga-se à edição mais recente no momento da interpretação. Documentos publicados indicam a versão. - O HEAD do documento importado não é importado. Os registros Reference e Value não são importados, mas copiados.
TAG WORD 0001 1110 0100 LLLL IMPORT-DOC (0x1E4L)
[TAG de extensão de Length]
Documento Registro DOC-POINTER (Issuer, ID do documento, ID de versão). Documentos de Codec usam CODEC-POINTER
IMPORT ID Restante. Inteiro na menor largura
- Usa-se apenas IMPORT-DOC (
0x1E4L). O IMPORT importa apenas documentos. Os alvos dentro do documento importado são apontados no BODY porEXTERNAL-POINTER-*(IMPORT ID, LOCAL ID). - Se um ID de versão for indicado, liga-se a essa edição; se for
0, liga-se à edição mais recente no momento da interpretação. Documentos publicados indicam a versão. - Num mesmo documento, não se atribui o mesmo IMPORT ID duas vezes.
- O HEAD do documento importado não é importado. Os alvos desse documento são interpretados conforme as declarações desse documento.
Exemplo: importa-se a versão mais recente do documento 0x0000000000000002 do Issuer 0x00000002 com o IMPORT ID 1.
1E4A 0418 0000 0002 0000 0000 0000 0002 0000 0000 0001