Meta est un enregistrement qui porte non sur le contenu du monde mais sur le document. À l’exception des enregistrements de structure du document (DOC, BODY, END), tous se placent dans le HEAD du document. Le HEAD contient aussi, outre les Meta, l’Edge de fondement du document entier SOURCE et son QUALIFIER.

Disposition

TAG WORD          000K KKKC CCCC LLLL      sections 14 et 15 (0x1C0L~0x1FFL)
[TAG d'extension Length]
Payload           Valeur brute ou enregistrement Value ou Reference intégré
  • Meta n’a pas de format d’Issuer. Meta est une spécification commune que suivent tous les Issuer, et seul GEUL la définit.
  • LLLL est le nombre total de WORD, TAG WORD compris, moins 1. Un Codec absent du tableau est Reserved.

Format du Payload

FormatQuandExemple
valeur bruteQuand le format est unique. Ne s’appuie pas sur un autre Codec d’enregistrementlongueur de DOC-*, SPEC-VERSION, ISSUER-KEY
Value intégréeQuand on choisit parmi plusieurs formats. Le TAG de Value indique le formatPROFILE, EFFECTIVE-*, instants, hachage du contenu
Reference intégréeQuand on désigne un objet tel qu’une personne, une organisation, un outil ou un documentDOC-ID, AUTHOR, CO-AUTHOR, RECORDED-BY, SIGNED-OFF, signataire de SIGNATURE
aucunMarqueur de 1 WORDBODY, END
  • Un enregistrement intégré n’est pas un enregistrement indépendant ; il appartient à son Meta. Chacun trouve ses limites par sa propre Length, et la position atteinte après la lecture du dernier enregistrement doit coïncider exactement avec la fin du Meta.
  • Les Meta qu’on ne peut placer qu’une fois par document et ceux qu’on peut placer plusieurs fois sont fixés par le « Nombre » de chaque document de Codec.

Classes

Les numéros de Meta se suivent à partir de 0x1C0L sans Reserved. Les bits du numéro n’indiquent pas la classe. On connaît la classe par le tableau des intervalles ci-dessous.

ClasseCode directCe qu’elle traite
structure0x1C0L~0x1C4LLimites et longueur du document
définition0x1C5L~0x1CALDéclarations d’interprétation
provenance0x1CBL~0x1D0LQui, quand, où
lignée0x1D1L~0x1DDLD’où et comment il provient
politique0x1DEL~0x1E3LComment on le traite
IMPORT0x1E4LImporte un document externe
vérification0x1E5L~0x1E9LPeut-on s’y fier
Reserved (réservé à la vérification)0x1EAL~0x1FFL
  • La classe vérification est constituée des enregistrements de la section 15 avec C >= 5, c’est-à-dire w >= 0x1E50. Sans livre de codes, on reconnaît ainsi la classe vérification et on l’exclut du hachage du contenu.
  • Le Reserved final 0x1EAL~0x1FFL est réservé à la vérification. Un nouveau Meta hors vérification ne peut être inséré avant la vérification, et s’il est placé dans le Reserved final, il est exclu du hachage du contenu.
  • Les classes structure, définition et IMPORT ne se lisent pas par les bits. Le décodeur les connaît par le tableau de numéros intégré.
  • Meta nécessaires à l’interprétation : structure, définition, IMPORT. Si on les supprime, on ne peut plus lire les enregistrements ou l’interprétation change. Tous les décodeurs doivent les traiter. Ces Codec appartiennent au livre de codes noyau de GEUL.
  • Meta qui ne changent pas l’interprétation : provenance, lignée, vérification, politique. Même supprimés, le contenu des énoncés reste le même. Seuls disparaissent les éléments du jugement de confiance et du traitement.
  • Le fondement s’écrit non par un Meta mais par l’Edge de fondement SOURCE et son QUALIFIER. Le fondement d’un enregistrement donné va dans le BODY ; l’origine du document entier va dans le HEAD, sous forme d’un SOURCE de Target 0 (document).

Structure

La classe structure de Meta (Codec 0x1C0L~0x1C4L) fixe les limites et la longueur du document. L’unité des données GEUL est un document.

DOC-*                  ← début du HEAD
  Meta de définition, provenance, lignée, vérification, politique, IMPORT
  SOURCE du document entier et son QUALIFIER
BODY                   ← début du BODY
  Reference, Value, Edge
END                    ← ferme le document
  • Tout document s’ouvre par DOC-1WORD/2WORD/4WORD, qui indique la longueur totale. Le décodeur peut sauter tout le document d’un coup grâce à cette longueur.
  • BODY et END sont des enregistrements de 1 WORD sans Payload. END est obligatoire.
  • Les documents ne s’imbriquent pas. Un autre document se désigne par IMPORT.
  • Si le HEAD (Meta, SOURCE du document entier et son QUALIFIER) est vide, on omet BODY. BODY ne peut être placé qu’une fois par document.

La structure complète du document figure dans document.

CodecNomSens
0x1C0L~0x1C2LDOC-1WORD / 2WORD / 4WORDOuvre le document en indiquant sa longueur totale
0x1C3LBODYTermine le HEAD et ouvre le BODY
0x1C4LENDFerme le document

Les règles détaillées figurent dans document.

Définition

La classe définition de Meta (Codec 0x1C5L~0x1CAL) regroupe les déclarations d’interprétation. Une déclaration change les règles d’interprétation, donc tous les décodeurs doivent la traiter. La portée d’une déclaration est son document.

  • SPEC-VERSION détermine comment lire les autres enregistrements ; on y place donc un simple entier, sans Value intégrée. GEUL v1 est 0x0001 (enregistrement 1C51 0001).
  • DOC-ID est le DOC-POINTER (Issuer, ID de document, version 0) qui désigne le document lui-même. Pour un document de codec, c’est le CODEC-POINTER (Issuer, Codec ID, version 0). En son absence, le document est anonyme et ne peut être désigné que par le hachage de son contenu.
  • Il n’existe pas d’adresse par nom de document. Le titre lisible par l’humain s’attache par le LABEL d’énoncé (adresses de publication et liste des versions).
CodecNomSens
0x1C5LSPEC-VERSIONVersion de la spécification suivie. Un seul entier
0x1C6LPROFILEProfil appliqué
0x1C7LDOC-IDIdentifiant de ce document. DOC-POINTER (version 0) qui se désigne lui-même. CODEC-POINTER (version 0) pour un document de codec
0x1C8LEFFECTIVE-FROMDate d’entrée en vigueur de cette version. En son absence, l’instant de publication
0x1C9LEFFECTIVE-UNTILFin de la période de validité de cette version (loi temporaire). En son absence, jusqu’à l’entrée en vigueur de la version suivante
0x1CALDEFAULT-LANGUAGELangue par défaut

Provenance

La classe provenance de Meta (Codec 0x1CBL~0x1D0L) consigne qui a créé et consigné le document, et quand.

  • L’auteur, le responsable de l’enregistrement et leurs instants suivent le modèle author et committer de git (AUTHOR et CREATED-AT, RECORDED-BY et RECORDED-AT).
  • Même supprimée, la provenance ne change pas le contenu des énoncés. Seuls disparaissent les éléments du jugement de confiance.
  • Les sources ne figurent pas dans cette classe. L’origine du document entier s’écrit dans le HEAD, celle d’un enregistrement donné dans le BODY, par l’Edge de fondement SOURCE. La portée correspondante dans le texte original, l’instant d’acquisition et le hachage du texte original sont des QUALIFIER joints à ce SOURCE (page P304, section P958, date de consultation P813, somme de contrôle P4092).
  • Si l’on faisait des propriétés propres à une source (portée dans le texte original, instant d’acquisition) des Meta, on ne pourrait déterminer de quelle source elles relèvent quand il y en a plusieurs. On les écrit donc comme QUALIFIER ayant le SOURCE pour Target.
CodecNomSens
0x1CBLAUTHORAuteur (Reference)
0x1CCLCO-AUTHORCoauteur
0x1CDLCREATED-ATInstant de rédaction
0x1CELMODIFIED-ATInstant de modification
0x1CFLRECORDED-BYEntité qui a consigné
0x1D0LRECORDED-ATInstant de consignation
  • Les sources s’écrivent non par un Meta mais par l’Edge de fondement SOURCE du HEAD (Target 0), et la portée dans le texte original, l’instant d’acquisition et le hachage du texte original s’écrivent comme QUALIFIER joints à ce SOURCE.

Lignée

La classe lignée de Meta (Codec 0x1D1L~0x1DDL) consigne d’où et comment provient le document. La lignée suit le modèle de commit de git, l’unité correspondant au commit étant le document.

  • Le hachage du contenu désigne le contenu d’un exemplaire du document (git commit id). C’est le SHA-256 allant de l’enregistrement d’ouverture (DOC-*) jusque juste avant END ; les enregistrements de la classe vérification (section 15 avec C >= 5, w >= 0x1E50) sont exclus du calcul.
  • L’ID de version est un entier de 2 WORD numéroté à partir de 1 dans l’ordre de publication au sein d’un document nommé. 0 signifie que la version n’est pas indiquée.
  • Les Meta de lignée désignent une version par son hachage du contenu. Le PARENT du document entrant lui aussi dans le hachage, le hachage du contenu forme une chaîne de hachages qui relie tout l’historique.
  • L’historique n’est pas effacé. Le contenu corrigé est publié comme nouvelle version. Un pointeur qui change, comme une branche, n’est pas placé dans le document.
  • DELTA-BASE et DELTA-REMOVE sont le format qui stocke une version comme diff par rapport à une version de base. Une version est toujours définie comme un instantané.

Les règles de révision figurent dans document.

La lignée suit le modèle de commit de git. L’unité correspondant au commit est le document.

CodecNomSens
0x1D1LPARENTHachage du contenu de la version précédente. S’il y en a plusieurs, fusion
0x1D2LDERIVED-FROMDérivé de matériaux d’une autre lignée
0x1D3LGENERATED-BYEntité génératrice (personne, modèle, moteur de règles)
0x1D4LTRANSFORMED-BYOutil de conversion et version de sa source (condensat de commit)
0x1D5LCHERRY-PICKED-FROMVersion d’origine du changement repris
0x1D6LREVERTSVersion annulée
0x1D7LREPLACESVersion remplacée par une réécriture. La version d’origine n’est pas effacée
0x1D8LSQUASHED-FROMVersions d’origine fusionnées en une seule
0x1D9LMESSAGERaison du changement. Un par langue
0x1DALTAGNom immuable attribué à une version
0x1DBLDELTA-BASECe fichier est un diff par rapport à une version de base
0x1DCLDELTA-REMOVEListe des LOCAL ID à retirer dans le diff
0x1DDLNEXT-LOCAL-IDLOCAL ID à attribuer ensuite. Placé dans le document de liste des versions
  • L’historique n’est pas effacé. Le contenu corrigé est publié comme nouvelle version.
  • Un pointeur qui change, comme une branche, n’est pas placé dans le document. Le dépôt et l’index le gèrent.

Vérification

La classe vérification de Meta (Codec 0x1E5L~0x1E9L) consigne les éléments permettant de juger si l’on peut se fier au document : clé publique d’un Issuer à émission autonome, signature, confirmation du droit de contribuer, degré de confiance, résultat du verdict sur le document entier.

  • La classe vérification est exclue du calcul du hachage du contenu. Ainsi, qu’on place la signature dans le document ou qu’on en ajoute plusieurs, le hachage du contenu ne change pas (même principe que le gpgsig de git).
  • Comme la classe vérification est constituée des enregistrements de la section 15 avec C >= 5, c’est-à-dire w >= 0x1E50, on peut calculer le hachage sans livre de codes. Le Reserved final 0x1EAL~0x1FFL est lui aussi réservé à la vérification et exclu du hachage.
  • Le verdict au niveau du nœud ou de l’enregistrement relève de l’Edge VERDICT (0x118L) de TOULMIN.
CodecNomSens
0x1E5LISSUER-KEYAlgorithme de signature et clé publique d’un Issuer à émission autonome
0x1E6LSIGNATURESignature du hachage du contenu. Algorithme, signataire, signature
0x1E7LSIGNED-OFFConfirmation du droit de contribuer
0x1E8LCONFIDENCEDegré de confiance
0x1E9LVERDICTRésultat du verdict sur le document entier (Pass, Review, Fail)
  • La classe vérification est exclue du calcul du hachage du contenu. Ainsi, qu’on place la signature dans le document ou qu’on en ajoute plusieurs, le hachage du contenu ne change pas.

Politique

La classe politique de Meta (Codec 0x1DEL~0x1E3L) fixe comment le document est traité : licence, étendue de diffusion, niveau de données personnelles, durée de conservation, consentement, restrictions d’usage.

  • La politique ne change pas l’interprétation ; elle fixe la manière de traiter.
  • La licence d’origine de l’œuvre contenue dans la suite d’octets est consignée par LICENSE.
CodecNomSens
0x1DELLICENSELicence
0x1DFLACCESSÉtendue de diffusion
0x1E0LPRIVACYNiveau de données personnelles
0x1E1LRETENTIONDurée de conservation
0x1E2LCONSENTÉtendue du consentement et fondement
0x1E3LUSAGERestrictions d’usage
  • La politique ne change pas l’interprétation ; elle fixe la manière de traiter.

IMPORT

La classe IMPORT de Meta (Codec 0x1E4L) importe un document externe au moyen d’un IMPORT ID. Il n’y a qu’un Codec : IMPORT-DOC (0x1E4L).

  • IMPORT n’importe que des documents. Les objets du document importé se désignent dans le BODY par la Reference EXTERNAL-POINTER-* (IMPORT ID, LOCAL ID) (Reference).
  • Si l’on indique un ID de version, la liaison se fait à cette édition ; avec 0, à la dernière édition au moment de l’interprétation. Un document publié indique la version.
  • Le HEAD du document importé n’est pas importé. Les enregistrements Reference et Value ne sont pas importés mais copiés.
TAG WORD          0001 1110 0100 LLLL      IMPORT-DOC (0x1E4L)
[TAG d'extension Length]
Document          Enregistrement DOC-POINTER (Issuer, ID de document, ID de version). CODEC-POINTER pour un document de codec
IMPORT ID         Le reste. Entier de la largeur la plus courte
  • On n’emploie que IMPORT-DOC (0x1E4L). IMPORT n’importe que des documents. Les objets du document importé se désignent dans le BODY par EXTERNAL-POINTER-* (IMPORT ID, LOCAL ID).
  • Si l’on indique un ID de version, la liaison se fait à cette édition ; avec 0, à la dernière édition au moment de l’interprétation. Un document publié indique la version.
  • Dans un même document, on n’attribue pas deux fois le même IMPORT ID.
  • Le HEAD du document importé n’est pas importé. Les objets de ce document s’interprètent selon les déclarations de ce document.

Exemple : on importe, avec l’IMPORT ID 1, la dernière version du document 0x0000000000000002 de l’Issuer 0x00000002.

1E4A 0418 0000 0002 0000 0000 0000 0002 0000 0000 0001