abapgit-agent 1.14.5 → 1.15.1

package/abap/CLAUDE.md

@@ -96,7 +96,7 @@ Never assume Z/Y prefix without checking.
 ```
 ❌ WRONG: Only write the .abap source file
 ✅ CORRECT: Every object needs both a source file AND an XML metadata file
-           XML-only objects (TABL, STRU, DTEL, TTYP) need ONLY the XML file
+           XML-only objects (TABL, STRU, DTEL, TTYP, DOMA, MSAG) need ONLY the XML file
 ```
 
 Use the object name from `objects.local.md` (or `objects.md` as fallback) in place of `<name>`:
@@ -107,10 +107,14 @@ Use the object name from `objects.local.md` (or `objects.md` as fallback) in pla
 | Interface (INTF) | `<name>.intf.abap` | `<name>.intf.xml` |
 | Program (PROG) | `<name>.prog.abap` | `<name>.prog.xml` |
 | CDS View (DDLS) | `<name>.ddls.asddls` | `<name>.ddls.xml` |
+| CDS Access Control (DCLS) | `<name>.dcls.asdcls` | `<name>.dcls.xml` |
+| Function Group (FUGR) | `<name>.fugr.abap` + includes | `<name>.fugr.xml` |
 | Table (TABL) | *(none)* | `<name>.tabl.xml` |
 | Structure (STRU) | *(none)* | `<name>.stru.xml` |
 | Data Element (DTEL) | *(none)* | `<name>.dtel.xml` |
 | Table Type (TTYP) | *(none)* | `<name>.ttyp.xml` |
+| Domain (DOMA) | *(none)* | `<name>.doma.xml` |
+| Message Class (MSAG) | *(none)* | `<name>.msag.xml` |
 
 **Package assignment — determine the package, then follow the confirmation rule below:**
 
@@ -155,7 +159,7 @@ Anything else (SAP namespace object, or SAP-delivered package)?
 > **Tip for project setup**: Add package rules to `objects.local.md` so Claude never
 > needs to ask. See `guidelines/objects.md` for examples.
 
-→ For exact XML templates: `abapgit-agent ref --topic abapgit`
+→ For exact XML templates: `abapgit-agent ref --topic abapgit` (CLAS/INTF/PROG/DDLS/DCLS/FUGR) or `abapgit-agent ref --topic abapgit-xml-only` (TABL/STRU/DTEL/TTYP/DOMA/MSAG)
 → For local helper/test-double class files: `abapgit-agent ref --topic object-creation`
 
 ---
@@ -288,6 +292,23 @@ abapgit-agent view --objects ZCL_UNKNOWN_CLASS --full
 # View FULL source with dual line numbers (for setting breakpoints)
 # G [N]  code — G = global line for debug set, [N] = include-relative
 abapgit-agent view --objects ZCL_UNKNOWN_CLASS --full --lines
+
+# View table/structure fields
+abapgit-agent view --objects SFLIGHT --type TABL
+abapgit-agent view --objects MY_STRUC --type STRU
+
+# View data element or domain
+abapgit-agent view --objects S_CARR_ID --type DTEL
+abapgit-agent view --objects XFELD --type DOMA
+
+# View message class (all messages)
+abapgit-agent view --objects SY --type MSAG
+
+# View function group (function module list)
+abapgit-agent view --objects SUSR --type FUGR
+
+# View CDS access control source
+abapgit-agent view --objects SEPM_E_SALESORDER --type DCLS
 ```
 
 **Example workflow for AI:**
@@ -447,6 +468,12 @@ abapgit-agent view --objects ZCL_FOO --full --lines
   * ---- Method: ZIF_BAR~DO_IT — breakpoint: debug set --objects ZCL_FOO:5 --include locals_imp ----
 ```
 
+**Function module (FUGR) methods:** use `--full --fm <name> --lines` — the hint uses the include name as the object:
+```bash
+abapgit-agent view --objects SUSR --type FUGR --full --fm AUTHORITY_CHECK --lines
+# Output:  * ---- FM: AUTHORITY_CHECK (LSUSRU04) — breakpoint: debug set --objects LSUSRU04:50 ----
+```
+
 ```bash
 # Regular method:
 abapgit-agent debug set --objects ZCL_FOO:90
@@ -454,6 +481,8 @@ abapgit-agent debug set --objects ZCL_FOO:90
 abapgit-agent debug set --objects ZCL_FOO:12 --include testclasses
 # Local class method:
 abapgit-agent debug set --objects ZCL_FOO:5 --include locals_imp
+# Function module (use include name, no --include flag needed):
+abapgit-agent debug set --objects LSUSRU04:50
 ```
 
 Minimal correct sequence:
@@ -677,7 +706,7 @@ Modified ABAP files?
 │  └─ Dependent files (interface + class, class uses class)?
 │     └─ ✅ Use: skip syntax → [abaplint] → commit → push → pull --sync-xml
 └─ Other types (FUGR, TABL, STRU, DTEL, TTYP, etc.)?
-   ├─ XML-only objects (TABL, STRU, DTEL, TTYP)?
+   ├─ XML-only objects (TABL, STRU, DTEL, TTYP, DOMA, MSAG)?
    │  └─ ✅ Use: skip syntax → [abaplint] → commit → push → pull --files abap/ztable.tabl.xml --sync-xml
    └─ FUGR and other complex objects?
       └─ ✅ Use: skip syntax → [abaplint] → commit → push → pull --sync-xml → (if errors: inspect)
@@ -713,7 +742,8 @@ Detailed guidelines are available in the `guidelines/` folder:
 | `guidelines/objects.md` | Object Naming Conventions (defaults) |
 | `guidelines/objects.local.md` | **Project** Naming Conventions — overrides `objects.md` (created by `init`, never overwritten) |
 | `guidelines/json.md` | JSON Handling |
-| `guidelines/abapgit.md` | abapGit XML Metadata Templates |
+| `guidelines/abapgit.md` | abapGit XML Metadata Templates — CLAS, INTF, PROG, DDLS, DCLS, FUGR |
+| `guidelines/abapgit-xml-only.md` | abapGit XML Metadata Templates — XML-only objects (TABL, STRU, DTEL, TTYP, DOMA, MSAG) |
 | `guidelines/unit-testable-code.md` | Unit Testable Code Guidelines (Dependency Injection) |
 | `guidelines/common-errors.md` | Common ABAP Errors - Quick Fixes |
 | `guidelines/debug-session.md` | Debug Session Guide |

package/abap/guidelines/abapgit-fugr.md

@@ -0,0 +1,159 @@
+---
+layout: default
+title: abapGit XML Metadata — Function Group (FUGR)
+nav_order: 11
+parent: ABAP Coding Guidelines
+grand_parent: ABAP Development
+---
+
+# abapGit XML Metadata — Function Group (FUGR)
+
+**Searchable keywords**: function group xml, fugr, function module, fm, abapgit, sapl, lzmy
+
+> **CRITICAL: Always write XML files with a UTF-8 BOM (`\ufeff`) as the very first character**, before `<?xml ...`.
+> Without the BOM, abapGit shows the object as **"M" (modified)** after every pull.
+
+---
+
+A FUGR with group name `ZMY_FUGR` and one FM `ZMY_MY_FUNCTION` requires these files:
+
+| File | Purpose |
+|---|---|
+| `zmy_fugr.fugr.xml` | Main XML: group description, includes list, FM interfaces |
+| `zmy_fugr.fugr.lzmy_fugrtop.abap` | TOP include source |
+| `zmy_fugr.fugr.lzmy_fugrtop.xml` | TOP include metadata (`SUBC=I`) |
+| `zmy_fugr.fugr.saplzmy_fugr.abap` | Main include source |
+| `zmy_fugr.fugr.saplzmy_fugr.xml` | Main include metadata (`SUBC=F`) |
+| `zmy_fugr.fugr.zmy_my_function.abap` | FM source (one file per FM, named after FM in lowercase) |
+
+---
+
+### `zmy_fugr.fugr.xml`
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<abapGit version="v1.0.0" serializer="LCL_OBJECT_FUGR" serializer_version="v1.0.0">
+ <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
+  <asx:values>
+   <AREAT>My function group description</AREAT>
+   <INCLUDES>
+    <SOBJ_NAME>LZMY_FUGRTOP</SOBJ_NAME>
+    <SOBJ_NAME>SAPLZMY_FUGR</SOBJ_NAME>
+   </INCLUDES>
+   <FUNCTIONS>
+    <item>
+     <FUNCNAME>ZMY_MY_FUNCTION</FUNCNAME>
+     <SHORT_TEXT>Short description of the FM</SHORT_TEXT>
+     <IMPORT>
+      <RSIMP>
+       <PARAMETER>IV_INPUT</PARAMETER>
+       <TYP>STRING</TYP>
+      </RSIMP>
+      <RSIMP>
+       <PARAMETER>IV_OPTIONAL</PARAMETER>
+       <DEFAULT>&apos;&apos;</DEFAULT>
+       <OPTIONAL>X</OPTIONAL>
+       <TYP>FLAG</TYP>
+      </RSIMP>
+     </IMPORT>
+     <EXPORT>
+      <RSEXP>
+       <PARAMETER>EV_RESULT</PARAMETER>
+       <TYP>STRING</TYP>
+      </RSEXP>
+     </EXPORT>
+     <EXCEPTION>
+      <RSEXC>
+       <EXCEPTION>ERROR</EXCEPTION>
+      </RSEXC>
+     </EXCEPTION>
+    </item>
+   </FUNCTIONS>
+  </asx:values>
+ </asx:abap>
+</abapGit>
+```
+
+### `zmy_fugr.fugr.lzmy_fugrtop.abap`
+
+```abap
+FUNCTION-POOL zmy_fugr.            "MESSAGE-ID ..
+```
+
+### `zmy_fugr.fugr.lzmy_fugrtop.xml`
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<abapGit version="v1.0.0">
+ <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
+  <asx:values>
+   <PROGDIR>
+    <NAME>LZMY_FUGRTOP</NAME>
+    <SUBC>I</SUBC>
+    <FIXPT>X</FIXPT>
+    <UCCHECK>X</UCCHECK>
+   </PROGDIR>
+  </asx:values>
+ </asx:abap>
+</abapGit>
+```
+
+### `zmy_fugr.fugr.saplzmy_fugr.abap`
+
+```abap
+INCLUDE LZMY_FUGRTOP.
+INCLUDE LZMY_FUGRU01.
+```
+
+One `INCLUDE` line per FM (`U01`, `U02`, …), plus `LZMY_FUGRTOP` at the top.
+
+### `zmy_fugr.fugr.saplzmy_fugr.xml`
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<abapGit version="v1.0.0">
+ <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
+  <asx:values>
+   <PROGDIR>
+    <NAME>SAPLZMY_FUGR</NAME>
+    <SUBC>F</SUBC>
+    <RLOAD>E</RLOAD>
+    <FIXPT>X</FIXPT>
+    <UCCHECK>X</UCCHECK>
+   </PROGDIR>
+  </asx:values>
+ </asx:abap>
+</abapGit>
+```
+
+### `zmy_fugr.fugr.zmy_my_function.abap`
+
+```abap
+FUNCTION zmy_my_function.
+*"----------------------------------------------------------------------
+*"*"Local Interface:
+*"  IMPORTING
+*"     VALUE(IV_INPUT) TYPE  STRING
+*"  EXPORTING
+*"     VALUE(EV_RESULT) TYPE  STRING
+*"  EXCEPTIONS
+*"      ERROR
+*"----------------------------------------------------------------------
+
+  " implementation
+
+ENDFUNCTION.
+```
+
+---
+
+## Key Rules
+
+- **Include naming**: TOP = `L<GROUP>TOP`, main = `SAPL<GROUP>` — uppercase in XML and filenames
+- **FM source file**: named after the FM in **lowercase** (`zmy_my_function.abap`, not `ZMY_MY_FUNCTION.abap`)
+- **`INCLUDES` list** in the main XML: only lists TOP and SAPL includes — FM source includes are implicit
+- **`REMOTE_CALL>R`**: add only for RFC-enabled FMs; omit for local FMs
+- **Optional parameters**: include both `<OPTIONAL>X</OPTIONAL>` and `<DEFAULT>...</DEFAULT>`
+- **`DOCUMENTATION` section**: omit entirely if no parameter descriptions needed — missing docs cause no diff
+- **Screens/CUA**: omit `DYNPROS`/`CUA` sections for screenless function groups
+- **Multiple FMs**: add one `<item>` per FM in `FUNCTIONS`; add one `INCLUDE` line per FM in the SAPL source

package/abap/guidelines/abapgit-xml-only.md

@@ -0,0 +1,397 @@
+---
+layout: default
+title: abapGit XML Metadata — XML-Only Objects
+nav_order: 10
+parent: ABAP Coding Guidelines
+grand_parent: ABAP Development
+---
+
+# abapGit XML Metadata — XML-Only Objects (TABL, STRU, DTEL, TTYP, DOMA, MSAG)
+
+XML templates for ABAP Dictionary objects that have no `.abap` source file — TABL, STRU, DTEL, TTYP, DOMA, and message classes (MSAG).
+
+> **CRITICAL: Always write XML files with a UTF-8 BOM (`\ufeff`) as the very first character**, before `<?xml ...`.
+> Without the BOM, abapGit shows the object as **"M" (modified)** after every pull.
+
+> **CRITICAL: Only include fields that abapGit's serializer actually writes. Never add fields with
+> default values.** Extra fields cause a permanent "M" (modified) diff.
+
+> **For CLAS, INTF, PROG, DDLS, DCLS, FUGR** (have source files): see `abapgit-agent ref --topic abapgit`
+> **For DDLS, DCLS** (CDS — have source files): also see `abapgit-agent ref --topic abapgit`
+
+**Searchable keywords**: table xml, structure xml, data element xml, table type xml, domain xml, message class xml, tabl, stru, dtel, ttyp, doma, msag, dictionary
+
+---
+
+### Table (TABL)
+
+**Filename**: `src/zmy_table.tabl.xml`
+
+> Pull with: `pull --files src/zmy_table.tabl.xml`
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<abapGit version="v1.0.0" serializer="LCL_OBJECT_TABL" serializer_version="v1.0.0">
+ <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
+  <asx:values>
+   <DD02V>
+    <TABNAME>ZMY_TABLE</TABNAME>
+    <DDLANGUAGE>E</DDLANGUAGE>
+    <TABCLASS>TRANSP</TABCLASS>
+    <DDTEXT>Description of the table</DDTEXT>
+    <CONTFLAG>A</CONTFLAG>
+   </DD02V>
+  </asx:values>
+ </asx:abap>
+</abapGit>
+```
+
+**Key Fields**:
+- `TABNAME`: Table name
+- `DDTEXT`: Description (**not** `DESCRIPT`)
+- `TABCLASS`: `TRANSP`=Transparent (most common), `POOL`, `CLUSTER`
+- `CONTFLAG`: Delivery class — `A`=Application, `C`=Customizing, `S`=System, `G`=Customizing protected
+
+**Note**: When abapGit serializes a table it also writes `<DD09L>` (technical settings) and `<DD03P_TABLE>` (field definitions). You only need the `<DD02V>` header when creating a new table; the rest is generated on pull.
+
+**`DD03P` field-level rules** (apply when editing an existing table XML that includes `<DD03P_TABLE>`): include `<SHLPORIGIN>D</SHLPORIGIN>` on fields where the Dictionary provides value help (domain with fixed values or search help); omit otherwise. For raw-type fields (no `ROLLNAME`, e.g. `CHAR`, `NUMC`), the serializer writes `<MASK>` **before** `<DDTEXT>`. For fields with a `ROLLNAME`, only `ROLLNAME` appears. Wrong order or missing `SHLPORIGIN` causes a permanent diff.
+
+#### Text Tables and Foreign Keys
+
+A **text table** stores translatable texts for another table (the "main table"). It shares the same key fields plus a language field (`SPRAS`/`LANGU`).
+
+**Recognition markers:** `<DD09L><UEBERSETZ>X</UEBERSETZ>` (text table) and `<DD08V><FRKART>TEXT</FRKART>` (text-table FK). Three required sections: `DD03P_TABLE` (fields), `DD05M_TABLE` (FK field mappings — one per main-table key, all anchored to `MANDT`), `DD08V_TABLE` (FK relationship).
+
+**Example — text table `ZMY_TABLE_T` for main table `ZMY_TABLE` (keys: MANDT, ID1, ID2):**
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<abapGit version="v1.0.0" serializer="LCL_OBJECT_TABL" serializer_version="v1.0.0">
+ <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
+  <asx:values>
+   <DD02V>
+    <TABNAME>ZMY_TABLE_T</TABNAME>
+    <DDLANGUAGE>E</DDLANGUAGE>
+    <TABCLASS>TRANSP</TABCLASS>
+    <CLIDEP>X</CLIDEP>
+    <DDTEXT>My Table: Texts</DDTEXT>
+    <CONTFLAG>C</CONTFLAG>
+   </DD02V>
+   <DD09L>
+    <TABNAME>ZMY_TABLE_T</TABNAME>
+    <AS4LOCAL>A</AS4LOCAL>
+    <TABKAT>0</TABKAT>
+    <TABART>APPL0</TABART>
+    <UEBERSETZ>X</UEBERSETZ>
+    <BUFALLOW>N</BUFALLOW>
+   </DD09L>
+   <DD03P_TABLE>
+    <DD03P>
+     <FIELDNAME>MANDT</FIELDNAME>
+     <KEYFLAG>X</KEYFLAG>
+     <ROLLNAME>MANDT</ROLLNAME>
+     <CHECKTABLE>ZMY_TABLE</CHECKTABLE>
+     <ADMINFIELD>0</ADMINFIELD>
+     <NOTNULL>X</NOTNULL>
+     <SHLPORIGIN>P</SHLPORIGIN>
+     <COMPTYPE>E</COMPTYPE>
+    </DD03P>
+    <DD03P>
+     <FIELDNAME>ID1</FIELDNAME>
+     <KEYFLAG>X</KEYFLAG>
+     <ROLLNAME>ZMY_ID1</ROLLNAME>
+     <ADMINFIELD>0</ADMINFIELD>
+     <NOTNULL>X</NOTNULL>
+     <COMPTYPE>E</COMPTYPE>
+    </DD03P>
+    <DD03P>
+     <FIELDNAME>SPRAS</FIELDNAME>
+     <KEYFLAG>X</KEYFLAG>
+     <ROLLNAME>SPRAS</ROLLNAME>
+     <ADMINFIELD>0</ADMINFIELD>
+     <NOTNULL>X</NOTNULL>
+     <COMPTYPE>E</COMPTYPE>
+    </DD03P>
+    <DD03P>
+     <FIELDNAME>DESCRIPTION</FIELDNAME>
+     <ROLLNAME>ZMY_DESCRIPTION</ROLLNAME>
+     <ADMINFIELD>0</ADMINFIELD>
+     <COMPTYPE>E</COMPTYPE>
+    </DD03P>
+   </DD03P_TABLE>
+   <DD05M_TABLE>
+    <DD05M>
+     <FIELDNAME>MANDT</FIELDNAME>
+     <FORTABLE>ZMY_TABLE_T</FORTABLE>
+     <FORKEY>MANDT</FORKEY>
+     <CHECKTABLE>ZMY_TABLE</CHECKTABLE>
+     <CHECKFIELD>MANDT</CHECKFIELD>
+     <PRIMPOS>0001</PRIMPOS>
+     <DOMNAME>MANDT</DOMNAME>
+     <DATATYPE>CLNT</DATATYPE>
+    </DD05M>
+    <DD05M>
+     <FIELDNAME>MANDT</FIELDNAME>
+     <FORTABLE>ZMY_TABLE_T</FORTABLE>
+     <FORKEY>ID1</FORKEY>
+     <CHECKTABLE>ZMY_TABLE</CHECKTABLE>
+     <CHECKFIELD>ID1</CHECKFIELD>
+     <PRIMPOS>0002</PRIMPOS>
+     <DATATYPE>CHAR</DATATYPE>
+    </DD05M>
+    <!-- repeat for each remaining key field (ID2, etc.) -->
+   </DD05M_TABLE>
+   <DD08V_TABLE>
+    <DD08V>
+     <FIELDNAME>MANDT</FIELDNAME>
+     <CHECKTABLE>ZMY_TABLE</CHECKTABLE>
+     <FRKART>TEXT</FRKART>
+     <CARD>CN</CARD>
+     <CARDLEFT>1</CARDLEFT>
+    </DD08V>
+   </DD08V_TABLE>
+  </asx:values>
+ </asx:abap>
+</abapGit>
+```
+
+**Key rules:**
+- Always activate the main table **before** the text table — foreign key check requires the main table to exist
+- Language field can be `SPRAS` (data element `SPRAS`) or `LANGU` (data element `LANGU`)
+- For an **ordinary foreign key**: same structure, but omit `<FRKART>TEXT</FRKART>` from `DD08V`
+
+---
+
+---
+
+### Data Element (DTEL)
+
+**Filename**: `src/zmy_dtel.dtel.xml`
+
+> Pull with: `pull --files src/zmy_dtel.dtel.xml`
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<abapGit version="v1.0.0" serializer="LCL_OBJECT_DTEL" serializer_version="v1.0.0">
+ <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
+  <asx:values>
+   <DD04V>
+    <ROLLNAME>ZMY_DTEL</ROLLNAME>
+    <DDLANGUAGE>E</DDLANGUAGE>
+    <DDTEXT>Description of data element</DDTEXT>
+    <REPTEXT>Description</REPTEXT>
+    <SCRTEXT_S>Short text</SCRTEXT_S>
+    <SCRTEXT_M>Medium text</SCRTEXT_M>
+    <SCRTEXT_L>Long description text</SCRTEXT_L>
+    <DTELMASTER>E</DTELMASTER>
+    <DATATYPE>CHAR</DATATYPE>
+    <LENG>000010</LENG>
+   </DD04V>
+  </asx:values>
+ </asx:abap>
+</abapGit>
+```
+
+**Key Fields**:
+- `ROLLNAME`: Data element name
+- `DDTEXT`: Description (**not** `DESCRIPT`)
+- `REPTEXT` / `SCRTEXT_S` / `SCRTEXT_M` / `SCRTEXT_L`: Field labels (report heading, short, medium, long)
+- `DTELMASTER`: Language key for label master (`E` for English)
+- `DATATYPE`: Data type (`CHAR`, `NUMC`, `DATS`, `TIMS`, `INT4`, etc.)
+- `LENG`: Length padded to 6 digits (e.g. `000010` for 10 characters)
+
+**Omit `<PARAMID>`** unless you specifically need a SET/GET parameter ID — the serializer omits it when empty.
+
+---
+
+### Structure (STRU)
+
+**Filename**: `src/zmy_struct.stru.xml`
+
+> abapGit uses the same TABL serializer for STRU.
+> Pull with: `pull --files src/zmy_struct.stru.xml`
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<abapGit version="v1.0.0" serializer="LCL_OBJECT_TABL" serializer_version="v1.0.0">
+ <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
+  <asx:values>
+   <DD02V>
+    <TABNAME>ZMY_STRUCT</TABNAME>
+    <DDLANGUAGE>E</DDLANGUAGE>
+    <TABCLASS>INTTAB</TABCLASS>
+    <DDTEXT>Description of the structure</DDTEXT>
+    <CONTFLAG>A</CONTFLAG>
+   </DD02V>
+  </asx:values>
+ </asx:abap>
+</abapGit>
+```
+
+**Key difference from TABL**: `TABCLASS` is `INTTAB` (internal table / structure) instead of `TRANSP`.
+
+**Note**: Like TABL, after the first pull abapGit expands the XML with `<DD03P_TABLE>` field definitions.
+
+---
+
+### Table Type (TTYP)
+
+**Filename**: `src/zmy_ttyp.ttyp.xml`
+
+> Pull with: `pull --files src/zmy_ttyp.ttyp.xml`
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<abapGit version="v1.0.0" serializer="LCL_OBJECT_TTYP" serializer_version="v1.0.0">
+ <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
+  <asx:values>
+   <DD40V>
+    <TYPENAME>ZMY_TTYP</TYPENAME>
+    <DDLANGUAGE>E</DDLANGUAGE>
+    <DDTEXT>Description of table type</DDTEXT>
+    <ROWTYPE>ZMY_STRUCT</ROWTYPE>
+    <ROWKIND>S</ROWKIND>
+    <DATATYPE>TABLE_T</DATATYPE>
+    <ACCESSMODE>T</ACCESSMODE>
+    <KEYDEF>D</KEYDEF>
+    <KEYKIND>N</KEYKIND>
+   </DD40V>
+  </asx:values>
+ </asx:abap>
+</abapGit>
+```
+
+**Key Fields**:
+- `TYPENAME`: Table type name
+- `ROWTYPE`: Row type (a structure or data element name)
+- `ROWKIND`: Row kind — `S`=Structure/Type, `D`=Data element, `R`=Reference
+- `DATATYPE`: Always `TABLE_T` for table types
+- `ACCESSMODE`: Table kind — `T`=Standard, `S`=Sorted, `H`=Hashed
+- `KEYDEF`: Key definition — `D`=Default (standard key), `K`=User-defined
+- `KEYKIND`: Key uniqueness — `N`=Non-unique, `U`=Unique
+
+**Note**: After the first pull abapGit may expand the XML with `<DD42V>` (key field definitions).
+
+---
+
+### Domain (DOMA)
+
+**Filename**: `src/zmy_domain.doma.xml`
+
+> Pull with: `pull --files src/zmy_domain.doma.xml`
+
+abapGit uses the view `DD01V` as the root element (not `DD01L`). The serializer reads from the system view.
+
+**Simple domain (no fixed values):**
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<abapGit version="v1.0.0" serializer="LCL_OBJECT_DOMA" serializer_version="v1.0.0">
+ <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
+  <asx:values>
+   <DD01V>
+    <DOMNAME>ZMY_DOMAIN</DOMNAME>
+    <DDLANGUAGE>E</DDLANGUAGE>
+    <DATATYPE>CHAR</DATATYPE>
+    <LENG>000030</LENG>
+    <OUTPUTLEN>000030</OUTPUTLEN>
+    <DDTEXT>My domain description</DDTEXT>
+   </DD01V>
+  </asx:values>
+ </asx:abap>
+</abapGit>
+```
+
+**Domain with fixed values** (add `<VALEXI>X</VALEXI>` and `<DD07V_TAB>`):
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<abapGit version="v1.0.0" serializer="LCL_OBJECT_DOMA" serializer_version="v1.0.0">
+ <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
+  <asx:values>
+   <DD01V>
+    <DOMNAME>ZMY_STATUS</DOMNAME>
+    <DDLANGUAGE>E</DDLANGUAGE>
+    <DATATYPE>CHAR</DATATYPE>
+    <LENG>000001</LENG>
+    <OUTPUTLEN>000001</OUTPUTLEN>
+    <VALEXI>X</VALEXI>
+    <DDTEXT>Status</DDTEXT>
+   </DD01V>
+   <DD07V_TAB>
+    <DD07V>
+     <VALPOS>0001</VALPOS>
+     <DDLANGUAGE>E</DDLANGUAGE>
+     <DOMVALUE_L>A</DOMVALUE_L>
+     <DDTEXT>Active</DDTEXT>
+    </DD07V>
+    <DD07V>
+     <VALPOS>0002</VALPOS>
+     <DDLANGUAGE>E</DDLANGUAGE>
+     <DOMVALUE_L>I</DOMVALUE_L>
+     <DDTEXT>Inactive</DDTEXT>
+    </DD07V>
+   </DD07V_TAB>
+  </asx:values>
+ </asx:abap>
+</abapGit>
+```
+
+**Key Fields**:
+- `DOMNAME`: Domain name
+- `DDTEXT`: Description (**not** `DESCRIPT`)
+- `DATATYPE`: ABAP data type (`CHAR`, `NUMC`, `DATS`, `TIMS`, `INT4`, `STRG`, etc.)
+- `LENG`: Length padded to 6 digits (omit for `STRG`/`INT4` — no fixed length)
+- `OUTPUTLEN`: Output length (usually same as `LENG`; omit for `STRG`)
+- `LOWERCASE`: `X` if lowercase input is allowed (omit if not)
+- `VALEXI`: `X` if the domain has fixed values — required when `DD07V_TAB` is present
+- `ENTITYTAB`: Value table name (check table for valid values — omit if none)
+
+**Note**: After pull the serializer may add `<I18N_LANGS>`, `<DD01_TEXTS>`, `<DD07_TEXTS>` for translations — do not write these manually.
+
+---
+
+### Message Class (MSAG)
+
+**Filename**: `src/zmy_msgs.msag.xml`
+
+> Pull with: `pull --files src/zmy_msgs.msag.xml`
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<abapGit version="v1.0.0" serializer="LCL_OBJECT_MSAG" serializer_version="v1.0.0">
+ <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
+  <asx:values>
+   <T100A>
+    <ARBGB>ZMY_MSGS</ARBGB>
+    <MASTERLANG>E</MASTERLANG>
+    <STEXT>My message class description</STEXT>
+   </T100A>
+   <T100>
+    <T100>
+     <SPRSL>E</SPRSL>
+     <ARBGB>ZMY_MSGS</ARBGB>
+     <MSGNR>000</MSGNR>
+     <TEXT>Object &1 not found</TEXT>
+    </T100>
+    <T100>
+     <SPRSL>E</SPRSL>
+     <ARBGB>ZMY_MSGS</ARBGB>
+     <MSGNR>001</MSGNR>
+     <TEXT>Operation completed successfully</TEXT>
+    </T100>
+   </T100>
+  </asx:values>
+ </asx:abap>
+</abapGit>
+```
+
+**Key Fields**:
+- `T100A/ARBGB`: Message class name (same as filename stem)
+- `T100A/MASTERLANG`: Master language (`E` for English)
+- `T100A/STEXT`: Short description of the message class
+- `T100/SPRSL`: Language key
+- `T100/MSGNR`: 3-digit message number (`000`–`999`)
+- `T100/TEXT`: Message text — use `&1`–`&4` for placeholders (serialized as `&amp;1`–`&amp;4` in XML)
+
+**Note**: The `<T100>` wrapper contains repeated `<T100>` child elements — one per message.