Meta — это записи не о содержимом мира, а о документе. Все они, кроме записей структуры документа (DOC, BODY, END), ставятся в HEAD документа. В HEAD, помимо Meta, находятся также Edge основания для всего документа SOURCE и его QUALIFIER.
Раскладка
TAG WORD 000K KKKC CCCC LLLL разделы 14, 15 (0x1C0L~0x1FFL)
[Length — расширяющий TAG]
Payload простое значение либо встроенные записи Value и Reference
- У Meta нет формата Issuer. Meta — общая спецификация, которой следуют все Issuer, и определяет её только GEUL.
LLLL— общее число WORD, включая TAG WORD, минус 1. Codec, которых нет в таблице, являются Reserved.
Формат Payload
| Формат | Когда | Пример |
|---|---|---|
| простое значение | когда формат определён однозначно. Не опирается на другие Codec записей | длина DOC-*, SPEC-VERSION, ISSUER-KEY |
| встроенный Value | когда формат выбирается из нескольких. Формат сообщает TAG Value | PROFILE, EFFECTIVE-*, моменты времени, хеш содержимого |
| встроенный Reference | когда указывается объект вроде человека, организации, инструмента или документа | DOC-ID, AUTHOR, CO-AUTHOR, RECORDED-BY, SIGNED-OFF, подписывающий в SIGNATURE |
| нет | маркер в 1 WORD | BODY, END |
- Встроенные записи — не самостоятельные записи, а часть своей Meta. Каждая находит свою границу по Length, и позиция после чтения последней записи должна точно совпадать с концом Meta.
- Какие Meta могут стоять в документе только по одной, а какие — по нескольку, определяет пункт «Количество» в документе каждого Codec.
Классы
Номера Meta идут подряд от 0x1C0L без Reserved. Биты номера класса не обозначают. Класс определяется по таблице диапазонов ниже.
| Класс | Прямой код | Что охватывает |
|---|---|---|
| структура | 0x1C0L~0x1C4L | границы и длина документа |
| объявление | 0x1C5L~0x1CAL | объявления интерпретации |
| происхождение | 0x1CBL~0x1D0L | кто, когда, где |
| родословная | 0x1D1L~0x1DDL | от чего и как произошло |
| политика | 0x1DEL~0x1E3L | как с этим обращаться |
| IMPORT | 0x1E4L | импорт внешнего документа |
| проверка | 0x1E5L~0x1E9L | можно ли доверять |
| Reserved (только для проверки) | 0x1EAL~0x1FFL |
- Класс проверки — это записи раздела 15 с
C >= 5, то естьw >= 0x1E50. По этому признаку без кодбука определяется класс проверки, и такие записи исключаются из хеша содержимого. - Последний Reserved
0x1EAL~0x1FFLпредназначен только для проверки. Новую Meta вне проверки перед проверкой поставить нельзя, а если поставить в последний Reserved, она будет исключена из хеша содержимого. - Классы структуры, объявления и IMPORT по битам не читаются. Декодер узнаёт их по встроенной таблице номеров.
- Meta, необходимые для интерпретации: структура, объявление, IMPORT. Если их удалить, записи нельзя прочитать или интерпретация изменится. Обрабатывать их должен каждый декодер. Эти Codec входят в базовый кодбук GEUL.
- Meta, не меняющие интерпретацию: происхождение, родословная, проверка, политика. Если их удалить, содержимое высказываний останется прежним. Пропадает только материал для оценки доверия и порядка обращения.
- Основание записывается не Meta, а Edge основания SOURCE и QUALIFIER. Основание отдельной записи ставится в BODY, а источник документа в целом — в HEAD как SOURCE с Target
0(Документ).
Структура
Класс структуры Meta (Codec 0x1C0L~0x1C4L) определяет границы и длину документа. Единица данных GEUL — один документ.
DOC-* ← начало HEAD
Meta объявления, происхождения, родословной, проверки, политики, IMPORT
SOURCE для всего документа и его QUALIFIER
BODY ← начало BODY
Reference, Value, Edge
END ← закрытие документа
- Каждый документ открывается записью
DOC-1WORD/2WORD/4WORDс заданием общей длины. По этой длине декодер может пропустить весь документ за один шаг. BODYиEND— записи в 1 WORD без Payload.ENDобязательна.- Документы не вкладываются. Другие документы указываются через IMPORT.
- Если HEAD (Meta, SOURCE для всего документа и его QUALIFIER) пуст,
BODYопускается.BODYможет стоять в документе только один раз.
Полная структура документа описана в Документе.
| Codec | Имя | Значение |
|---|---|---|
0x1C0L~0x1C2L | DOC-1WORD / 2WORD / 4WORD | открывает документ, задавая общую длину |
0x1C3L | BODY | завершает HEAD и открывает BODY |
0x1C4L | END | закрывает документ |
Подробные правила — в Документе.
Объявление
Класс объявления Meta (Codec 0x1C5L~0x1CAL) — это объявления интерпретации. Объявление меняет правила интерпретации, поэтому обрабатывать его должен каждый декодер. Область действия объявления — этот документ.
SPEC-VERSIONопределяет, как читать остальные записи, поэтому в ней стоит просто целое число, без встроенного Value. GEUL v1 —0x0001(запись1C51 0001).DOC-ID— этоDOC-POINTER(Issuer, ID документа, версия0), указывающий на сам этот документ. Для документа Codec —CODEC-POINTER(Issuer, Codec ID, версия0). Если его нет, документ безымянный, и указать на него можно только по хешу содержимого.- Адреса по имени документа нет. Заголовок для чтения человеком добавляется Edge-высказыванием
LABEL(Адреса публикации и список версий).
| Codec | Имя | Значение |
|---|---|---|
0x1C5L | SPEC-VERSION | версия спецификации, которой следуют. Одно целое число |
0x1C6L | PROFILE | применяемый профиль |
0x1C7L | DOC-ID | идентификатор этого документа. DOC-POINTER (версия 0), указывающий на сам документ. Для документа Codec — CODEC-POINTER (версия 0) |
0x1C8L | EFFECTIVE-FROM | дата вступления этой версии в силу. Если нет — момент публикации |
0x1C9L | EFFECTIVE-UNTIL | конец срока действия этой версии (временный закон). Если нет — до вступления в силу следующей версии |
0x1CAL | DEFAULT-LANGUAGE | язык по умолчанию |
- Адреса по имени документа нет (Адреса публикации и список версий). Заголовок для чтения человеком добавляется LABEL в BODY.
Происхождение
Класс происхождения Meta (Codec 0x1CBL~0x1D0L) записывает, кто и когда создал и зафиксировал документ.
- Автор и фиксирующий, а также их моменты времени следуют модели author и committer в git (
AUTHORиCREATED-AT,RECORDED-BYиRECORDED-AT). - Если происхождение удалить, содержимое высказываний не изменится. Пропадает только материал для оценки доверия.
- Первоисточников в этом классе нет. Источник документа в целом записывается в HEAD, а источник отдельной записи — в BODY как Edge основания SOURCE. Соответствующий диапазон в оригинале, момент получения и хеш оригинала — это QUALIFIER, прикрепляемые к этому SOURCE (страница P304, раздел P958, дата обращения P813, контрольная сумма P4092).
- Если свойства, относящиеся к источнику (диапазон в оригинале, момент получения), хранить как Meta, при нескольких источниках нельзя определить, к какому из них они относятся. Поэтому они записываются как QUALIFIER, у которого Target — SOURCE.
| Codec | Имя | Значение |
|---|---|---|
0x1CBL | AUTHOR | автор (Reference) |
0x1CCL | CO-AUTHOR | соавтор |
0x1CDL | CREATED-AT | момент создания |
0x1CEL | MODIFIED-AT | момент изменения |
0x1CFL | RECORDED-BY | субъект, зафиксировавший документ |
0x1D0L | RECORDED-AT | момент фиксации |
- Первоисточники записываются не Meta, а Edge основания SOURCE в HEAD (Target
0), а диапазон в оригинале, момент получения и хеш оригинала — как QUALIFIER, прикрепляемые к этому SOURCE.
Родословная
Класс родословной Meta (Codec 0x1D1L~0x1DDL) записывает, от чего и как произошёл документ. Родословная следует модели коммитов git, где единица, соответствующая коммиту, — документ.
- Хеш содержимого указывает содержимое одного экземпляра документа (git commit id). Это SHA-256 от открывающей записи (
DOC-*) до записи непосредственно передEND, причём записи класса проверки (раздел 15,C >= 5,w >= 0x1E50) при вычислении исключаются. - ID версии — 2-WORD целое число, нумеруемое от 1 в порядке публикации внутри именованного документа.
0означает, что версия не указана. - Meta родословной указывает версию по хешу содержимого.
PARENTвнутри документа тоже входит в хеш, поэтому хеш содержимого становится цепочкой хешей, связывающей всю историю. - История не удаляется. Исправленное выпускается как новая версия. Изменяемые указатели вроде branch в документе не ставятся.
DELTA-BASEиDELTA-REMOVE— формат, в котором версия хранится как diff относительно базовой версии. Версия всегда определяется как снимок.
Правила редакции — в Документе.
Родословная следует модели коммитов git. Единица, соответствующая коммиту, — документ.
| Codec | Имя | Значение |
|---|---|---|
0x1D1L | PARENT | хеш содержимого предыдущей версии. Если несколько — слияние |
0x1D2L | DERIVED-FROM | произведено от материала другой родословной |
0x1D3L | GENERATED-BY | субъект-создатель (человек, модель, движок правил) |
0x1D4L | TRANSFORMED-BY | инструмент преобразования и версия его исходного кода (дайджест коммита) |
0x1D5L | CHERRY-PICKED-FROM | исходная версия перенесённого изменения |
0x1D6L | REVERTS | версия, изменение которой отменено |
0x1D7L | REPLACES | переписанная версия. Исходная версия не удаляется |
0x1D8L | SQUASHED-FROM | исходные версии, объединённые в одну |
0x1D9L | MESSAGE | причина изменения. По одному на язык |
0x1DAL | TAG | неизменяемое имя, присвоенное версии |
0x1DBL | DELTA-BASE | этот файл — diff относительно базовой версии |
0x1DCL | DELTA-REMOVE | список LOCAL ID, убираемых в diff |
0x1DDL | NEXT-LOCAL-ID | LOCAL ID, назначаемый следующим. Ставится в документ списка версий |
- История не удаляется. Исправленное выпускается как новая версия.
- Изменяемые указатели вроде branch в документе не ставятся. Ими управляют хранилище и индекс.
Проверка
Класс проверки Meta (Codec 0x1E5L~0x1E9L) записывает материал для оценки того, можно ли доверять документу. Это открытый ключ Issuer с самостоятельной выдачей, подпись, подтверждение права на вклад, степень доверия и результат вердикта по документу в целом.
- Класс проверки исключается из вычисления хеша содержимого. Поэтому ни помещение подписи в документ, ни добавление нескольких подписей хеш содержимого не меняют (так же, как
gpgsigв git). - Класс проверки — это записи раздела 15 с
C >= 5, то естьw >= 0x1E50, поэтому хеш можно вычислить без кодбука. Последний Reserved0x1EAL~0x1FFLтоже предназначен только для проверки и исключается из хеша. - Вердикт на уровне узла или записи берёт на себя Edge TOULMIN
VERDICT(0x118L).
| Codec | Имя | Значение |
|---|---|---|
0x1E5L | ISSUER-KEY | алгоритм подписи и открытый ключ Issuer с самостоятельной выдачей |
0x1E6L | SIGNATURE | подпись хеша содержимого. Алгоритм, подписывающий, подпись |
0x1E7L | SIGNED-OFF | подтверждение права на вклад |
0x1E8L | CONFIDENCE | степень доверия |
0x1E9L | VERDICT | результат вердикта по документу в целом (Pass, Review, Fail) |
- Класс проверки исключается из вычисления хеша содержимого. Поэтому ни помещение подписи в документ, ни добавление нескольких подписей хеш содержимого не меняют.
Политика
Класс политики Meta (Codec 0x1DEL~0x1E3L) определяет, как обращаться с документом. Это лицензия, степень открытости, уровень персональных данных, срок хранения, согласие и ограничения использования.
- Политика не меняет интерпретацию, а определяет порядок обращения.
- Исходная лицензия произведений внутри байтовой последовательности записывается в
LICENSE.
| Codec | Имя | Значение |
|---|---|---|
0x1DEL | LICENSE | лицензия |
0x1DFL | ACCESS | степень открытости |
0x1E0L | PRIVACY | уровень персональных данных |
0x1E1L | RETENTION | срок хранения |
0x1E2L | CONSENT | объём и основание согласия |
0x1E3L | USAGE | ограничения использования |
- Политика не меняет интерпретацию, а определяет порядок обращения.
IMPORT
Класс IMPORT Meta (Codec 0x1E4L) импортирует внешний документ под IMPORT ID. Codec только один — IMPORT-DOC (0x1E4L).
- IMPORT импортирует только документ. Объекты внутри импортированного документа указываются в BODY через Reference
EXTERNAL-POINTER-*(IMPORT ID, LOCAL ID) (Reference). - Если указан ID версии, привязка идёт к этой редакции, если
0— к последней на момент интерпретации. Опубликованные документы указывают версию. - HEAD импортированного документа не импортируется. Записи Reference и Value не импортируются, а копируются.
TAG WORD 0001 1110 0100 LLLL IMPORT-DOC (0x1E4L)
[Length — расширяющий TAG]
Документ запись DOC-POINTER (Issuer, ID документа, ID версии). Для документа Codec — CODEC-POINTER
IMPORT ID остаток. Целое число наименьшей ширины
- Используется только IMPORT-DOC (
0x1E4L). IMPORT импортирует только документ. Объекты внутри импортированного документа указываются в BODY черезEXTERNAL-POINTER-*(IMPORT ID, LOCAL ID). - Если указан ID версии, привязка идёт к этой редакции, если
0— к последней на момент интерпретации. Опубликованные документы указывают версию. - В одном документе один и тот же IMPORT ID дважды не назначается.
- HEAD импортированного документа не импортируется. Объекты этого документа интерпретируются по его собственным объявлениям.
Пример: последняя версия документа 0x0000000000000002 Issuer 0x00000002 импортируется под IMPORT ID 1.
1E4A 0418 0000 0002 0000 0000 0000 0002 0000 0000 0001