Meta سجلات تخص المستند نفسه لا مضمون العالم. وتوضع كلها في HEAD الخاص بالمستند باستثناء سجلات بنية المستند (DOC وBODY وEND). ويأتي في HEAD إلى جانب Meta أيضاً Edge الدليل SOURCE للمستند كله مع QUALIFIER الخاص به.
التخطيط
TAG WORD 000K KKKC CCCC LLLL القسمان 14 و15 (0x1C0L~0x1FFL)
[Length TAG ممتد]
Payload قيمة خام، أو سجلات Value وReference مضمّنة
- ليست لـ Meta صيغة Issuer. فهي مواصفة مشتركة يتبعها كل 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 تماماً.
- ما يجوز وضع واحد منه فقط في المستند وما يجوز وضع عدة منه، يحدده «العدد» في مستند كل Codec.
الفئات
تتتابع أرقام Meta من 0x1C0L بلا Reserved. ولا تدل بتات الرقم على الفئة. وتُعرف الفئة من جدول النطاقات أدناه.
| الفئة | الرمز المباشر | ما تتناوله |
|---|---|---|
| البنية | 0x1C0L~0x1C4L | حدود المستند وطوله |
| التعريف | 0x1C5L~0x1CAL | تصريحات التفسير |
| المصدر | 0x1CBL~0x1D0L | من وفي أي وقت وأين |
| النسب | 0x1D1L~0x1DDL | مما جاء وكيف |
| السياسة | 0x1DEL~0x1E3L | كيف يُعامل |
| IMPORT | 0x1E4L | استيراد مستند خارجي |
| التحقق | 0x1E5L~0x1E9L | هل يمكن الوثوق به |
| Reserved (للتحقق فقط) | 0x1EAL~0x1FFL |
- فئة التحقق هي السجلات التي
C >= 5في القسم 15، أيw >= 0x1E50. وبهذا تُعرف فئة التحقق دون codebook وتُستثنى من تجزئة المحتوى. - الـ Reserved اللاحق
0x1EAL~0x1FFLللتحقق فقط. فأي Meta جديد خارج التحقق لا يمكن وضعه قبل التحقق، وإن وُضع في الـ Reserved اللاحق استُثني من تجزئة المحتوى. - لا تُقرأ فئات البنية والتعريف وIMPORT بالبتات. فيعرفها المفكك من جدول الأرقام المضمّن.
- Meta اللازم للتفسير: البنية والتعريف وIMPORT. فبحذفه لا يمكن قراءة السجلات أو يتغير التفسير. ويجب أن يعالجه كل مفكك. وهذه الـ Codec ضمن codebook 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، معرّف المستند، الإصدار0) الذي يشير إلى المستند نفسه. ومستند Codec يستخدمCODEC-POINTER(Issuer، Codec ID، الإصدار0). وإذا غاب فالمستند بلا اسم ولا يمكن الإشارة إليه إلا بتجزئة المحتوى.- لا يوجد عنوان باسم المستند. والعنوان الذي يقرأه الإنسان يُلحق بـ
LABELمن نوع العبارة (عناوين النشر وقوائم الإصدارات).
| Codec | الاسم | المعنى |
|---|---|---|
0x1C5L | SPEC-VERSION | إصدار المواصفة المتبَع. عدد صحيح واحد |
0x1C6L | PROFILE | الـ 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 يكون SOURCE هو Target لها.
| Codec | الاسم | المعنى |
|---|---|---|
0x1CBL | AUTHOR | المؤلف (Reference) |
0x1CCL | CO-AUTHOR | المؤلف المشارك |
0x1CDL | CREATED-AT | وقت التأليف |
0x1CEL | MODIFIED-AT | وقت التعديل |
0x1CFL | RECORDED-BY | الجهة المسجِّلة |
0x1D0L | RECORDED-AT | وقت التسجيل |
- المادة المصدرية لا تُكتب بـ Meta بل بـ Edge الدليل SOURCE (Target
0) في HEAD، ونطاق النص الأصلي ووقت الحصول وتجزئة النص الأصلي تُكتب بـ QUALIFIER تُلحق بذلك SOURCE.
النسب
فئة النسب في Meta (Codec 0x1D1L~0x1DDL) تكتب مم جاء المستند وكيف. ويتبع النسب نموذج commit في git، والوحدة المقابلة لـ commit هي المستند.
- تجزئة المحتوى تشير إلى محتوى نسخة واحدة من المستند (git commit id). وهي SHA-256 من السجل الفاتح (
DOC-*) إلى ما قبلENDمباشرة، وتُستثنى من الحساب سجلات فئة التحقق (C >= 5في القسم 15، أيw >= 0x1E50). - معرّف الإصدار عدد صحيح من 2 WORD يُرقَّم من 1 بترتيب النشر داخل المستند ذي الاسم. و
0تعني أن الإصدار لم يُكتب. - يشير Meta النسب إلى الإصدار بتجزئة المحتوى. و
PARENTداخل المستند يدخل في التجزئة أيضاً، فتصير تجزئة المحتوى سلسلة تجزئات تصل التاريخ كله. - لا يُحذف التاريخ. وما عُدّل يُصدر إصداراً جديداً. ولا يوضع في المستند مؤشر متغير مثل branch.
DELTA-BASEوDELTA-REMOVEصيغة لحفظ الإصدار بوصفه diff بالنسبة إلى إصدار أساس. ويُعرَّف الإصدار دائماً بوصفه snapshot.
قواعد التعديل في المستند.
يتبع النسب نموذج commit في git. والوحدة المقابلة لـ commit هي المستند.
| Codec | الاسم | المعنى |
|---|---|---|
0x1D1L | PARENT | تجزئة محتوى الإصدار السابق مباشرة. وإذا تعدد فهو دمج |
0x1D2L | DERIVED-FROM | مشتق من مادة في نسب آخر |
0x1D3L | GENERATED-BY | الجهة المنتِجة (إنسان أو نموذج أو محرك قواعد) |
0x1D4L | TRANSFORMED-BY | أداة التحويل وإصدار مصدرها (digest الـ commit) |
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 ذاتي الإصدار، والتوقيع، والإقرار بحق المساهمة، والموثوقية، ونتيجة الحكم على المستند كله.
- تُستثنى فئة التحقق من حساب تجزئة المحتوى. ولذلك فوضع التوقيع داخل المستند، أو إضافة عدة توقيعات، لا يغيّر تجزئة المحتوى (بالطريقة نفسها لـ git
gpgsig). - فئة التحقق هي السجلات التي
C >= 5في القسم 15، أيw >= 0x1E50، فيمكن حساب التجزئة دون codebook. والـ Reserved اللاحق0x1EAL~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). - إذا كُتب معرّف الإصدار فالربط بتلك النسخة، وإذا كان
0فالربط بأحدث نسخة وقت التفسير. والمستند المنشور يكتب الإصدار. - لا يُستورد HEAD للمستند المستورَد. ولا تُستورد سجلات Reference وValue بل تُنسخ.
TAG WORD 0001 1110 0100 LLLL IMPORT-DOC (0x1E4L)
[Length TAG ممتد]
المستند سجل DOC-POINTER (Issuer، معرّف المستند، معرّف الإصدار). ومستند Codec يستخدم CODEC-POINTER
IMPORT ID الباقي. عدد صحيح بأقصر عرض
- يُستخدم IMPORT-DOC (
0x1E4L) وحده. يستورد IMPORT المستند فقط. أما الأهداف داخل المستند المستورَد فيُشار إليها في BODY بـEXTERNAL-POINTER-*(IMPORT ID، LOCAL ID). - إذا كُتب معرّف الإصدار فالربط بتلك النسخة، وإذا كان
0فالربط بأحدث نسخة وقت التفسير. والمستند المنشور يكتب الإصدار. - لا يُعيَّن IMPORT ID نفسه مرتين في مستند واحد.
- لا يُستورد HEAD للمستند المستورَد. وتُفسَّر أهداف ذلك المستند وفق تصريحاته هو.
مثال: استيراد أحدث إصدار من المستند 0x0000000000000002 لدى Issuer 0x00000002 بـ IMPORT ID 1.
1E4A 0418 0000 0002 0000 0000 0000 0002 0000 0000 0001