Meta הוא רשומה על המסמך, לא על תוכן על העולם. מלבד רשומות מבנה המסמך (DOC, BODY, END), כולן מוצבות ב-HEAD של המסמך. ב-HEAD מופיעים, מלבד Meta, גם ה-Edge של ראיות SOURCE של המסמך כולו וה-QUALIFIER שלו.
פריסה
TAG WORD 000K KKKC CCCC LLLL קטעים 14 ו-15 (0x1C0L~0x1FFL)
[TAG הרחבה של Length]
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-*, זמן, hash תוכן |
| Reference מובנה | כשמצביעים על פריט כמו אדם, ארגון, כלי או מסמך | DOC-ID, AUTHOR, CO-AUTHOR, RECORDED-BY, SIGNED-OFF, החותם של SIGNATURE |
| אין | סימן של 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. בלי ספר Codec אפשר לזהות בכך את מחלקת האימות ולהוציא אותה מ-hash התוכן. - ה-Reserved האחורי
0x1EAL~0x1FFLהוא לאימות בלבד. Meta חדש שאינו אימות אי אפשר להציב לפני האימות, ואם מציבים אותו ב-Reserved האחורי הוא יוצא מ-hash התוכן. - מחלקות המבנה, ההצהרה ו-IMPORT אינן נקראות לפי ביטים. המפענח מכיר אותן מטבלת המספרים המובנית.
- Meta הנחוץ לפירוש: מבנה, הצהרה, IMPORT. אם מוחקים אותם אי אפשר לקרוא את הרשומות או שהפירוש משתנה. כל מפענח חייב לטפל בהם. ה-Codec האלה שייכים לספר ה-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הן רשומות של 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). אם אין, זה מסמך בלי שם שאפשר להצביע עליו רק ב-hash התוכן.- אין כתובת לפי שם מסמך. את הכותרת שאדם קורא מצמידים כ-
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. טווח ההתאמה בנוסח המקורי, מועד ההשגה ו-hash הנוסח המקורי הם QUALIFIER שמוצמדים ל-SOURCE הזה (עמוד P304, סעיף P958, תאריך גישה P813, checksum 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), וטווח הנוסח המקורי, מועד ההשגה ו-hash הנוסח המקורי נכתבים כ-QUALIFIER שמוצמדים ל-SOURCE הזה.
שושלת
מחלקת השושלת של Meta (Codec 0x1D1L~0x1DDL) רושמת ממה ואיך הגיע המסמך. השושלת נשענת על מודל ה-commit של git, והיחידה המקבילה ל-commit היא המסמך.
- hash התוכן מצביע על תוכן עותק אחד של המסמך (git commit id). זה SHA-256 מהרשומה הפותחת (
DOC-*) ועד רגע לפניEND, ורשומות מחלקת האימות (בקטע 15 עםC >= 5,w >= 0x1E50) מוצאות מהחישוב. - מזהה הגרסה הוא מספר שלם של 2 WORD שממספרים מ-1 בסדר הפרסום בתוך מסמך בעל שם.
0פירושו שלא נרשמה גרסה. - Meta של שושלת מצביע על גרסה לפי hash התוכן. גם
PARENTשבתוך המסמך נכלל ב-hash, ולכן hash התוכן הופך לשרשרת hash שקושרת את כל ההיסטוריה. - ההיסטוריה אינה נמחקת. תיקון יוצא כגרסה חדשה. מצביע משתנה כמו branch אינו מוצב במסמך.
DELTA-BASEו-DELTA-REMOVEהם הפורמט לאחסון גרסה כ-diff ביחס לגרסת בסיס. גרסה מוגדרת תמיד כ-snapshot.
כללי התיקון נמצאים במסמך.
השושלת נשענת על מודל ה-commit של git. היחידה המקבילה ל-commit היא המסמך.
| Codec | שם | משמעות |
|---|---|---|
0x1D1L | PARENT | hash התוכן של הגרסה הקודמת. אם כמה, זה מיזוג |
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 שהונפק עצמית, חתימה, אישור זכות תרומה, מידת אמינות ותוצאת פסק דין של המסמך כולו.
- מחלקת האימות יוצאת מחישוב hash התוכן. לכן גם אם מציבים את החתימה בתוך המסמך, וגם אם מוסיפים כמה חתימות, hash התוכן אינו משתנה (באותה דרך כמו
gpgsigשל git). - מחלקת האימות היא רשומות בקטע 15 עם
C >= 5, כלומרw >= 0x1E50, ולכן אפשר לחשב את ה-hash בלי ספר Codec. גם ה-Reserved האחורי0x1EAL~0x1FFLהוא לאימות בלבד ולכן יוצא מה-hash. - פסק דין ברמת צומת או רשומה הוא תפקידו של TOULMIN ב-Edge
VERDICT(0x118L).
| Codec | שם | משמעות |
|---|---|---|
0x1E5L | ISSUER-KEY | אלגוריתם החתימה והמפתח הציבורי של Issuer שהונפק עצמית |
0x1E6L | SIGNATURE | חתימה על hash התוכן. אלגוריתם, חותם, חתימה |
0x1E7L | SIGNED-OFF | אישור זכות תרומה |
0x1E8L | CONFIDENCE | מידת אמינות |
0x1E9L | VERDICT | תוצאת פסק הדין של המסמך כולו (Pass, Review, Fail) |
- מחלקת האימות יוצאת מחישוב hash התוכן. לכן גם אם מציבים את החתימה בתוך המסמך, וגם אם מוסיפים כמה חתימות, hash התוכן אינו משתנה.
מדיניות
מחלקת המדיניות של 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)
[TAG הרחבה של Length]
מסמך רשומת 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