abapgit-agent 1.16.3 → 1.17.1

package/abap/CLAUDE.md

@@ -123,6 +123,7 @@ Use the object name from `objects.local.md` (or `objects.md` as fallback) in pla
 | 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` |
+| Enhancement (ENHO) | `<name>.enho.<hash>.abap` (one per hook) | `<name>.enho.xml` |
 | Table (TABL) | *(none)* | `<name>.tabl.xml` |
 | Structure (STRU) | *(none)* | `<name>.tabl.xml` ⚠️ NOT `.stru.xml` |
 | Data Element (DTEL) | *(none)* | `<name>.dtel.xml` |
@@ -786,6 +787,11 @@ Modified ABAP files?
    ├─ DCLS (CDS access control)?
    │  └─ ✅ Use: skip syntax → [abaplint] → commit → push → pull --files abap/zc_view.dcls.xml --sync-xml
    │         ⚠️  Pass the .xml file — pull --files does NOT accept .asdcls extensions
+   ├─ ENHO (Enhancement)?
+   │  └─ ✅ Use: syntax (optional) → [abaplint] → commit → push → pull --files abap/<name>.enho.xml --sync-xml
+   │         ⚠️  syntax checks basic errors in the hook body; semantic checks require pull
+   │         ⚠️  Pass the .enho.xml file to pull — hash .abap files also work but xml is preferred
+   │         → see: abapgit-agent ref --topic enho
    └─ Other complex objects?
       └─ ✅ Use: skip syntax → [abaplint] → commit → push → pull --sync-xml → (if errors: inspect)
 
@@ -818,6 +824,7 @@ Modified ABAP files?
 | `ref --topic abapgit` | abapGit XML Metadata — **use for CDS/DDLS XML**, also CLAS, INTF, PROG, DCLS, FUGR |
 | `ref --topic abapgit-xml-only` | abapGit XML Metadata — XML-only objects (TABL, STRU, DTEL, TTYP, DOMA, MSAG) |
 | `ref --topic abapgit-fugr` | abapGit XML Metadata — Function Group (FUGR) details |
+| `ref --topic enho` | Enhancement Objects (ENHO) — workflow, hash algorithm, creation guide |
 | `ref --topic abaplint` | abaplint Rule Guidelines (prefer_inline trap, safe patterns) |
 | `ref --topic debug-session` | Debug Session Guide |
 | `ref --topic debug-dump` | Dump Analysis Guide |

package/abap/CLAUDE.slim.md

@@ -42,3 +42,7 @@ The `ref` command uses bundled guidelines automatically — no local `guidelines
 ## Project-Specific Naming Conventions
 
 See `guidelines/objects.local.md` for this project's naming convention overrides.
+
+## CLI Commands
+
+Run `abapgit-agent --help` to see all available commands (pull, customize, transport, preview, and more).

package/abap/guidelines/abapgit.md

@@ -22,7 +22,8 @@ Interface          | zif_*.intf.abap              | zif_*.intf.xml
 Program            | z*.prog.abap                 | z*.prog.xml
 CDS View (DDLS)    | zc_*.ddls.asddls             | zc_*.ddls.xml
 CDS Access Control | zc_*.dcls.asdcls             | zc_*.dcls.xml
-Function Group     | z*fugr*.abap (6 files)       | z*.fugr.xml
+Function Group     | z*fugr*.abap (1 per FM + includes) | z*.fugr.xml
+Enhancement (ENHO) | z*.enho.<hash>.abap (N files)| z*.enho.xml
 ```
 
 > **XML-only objects** (TABL, STRU, DTEL, TTYP, DOMA, MSAG) have **no ABAP source file** and are not covered here.
@@ -302,6 +303,16 @@ FUGR serializes as multiple files (main XML + TOP include + SAPL include + one s
 
 ---
 
+### Enhancement (ENHO)
+
+**Files**: `src/<name>.enho.xml` + `src/<name>.enho.<hash>.abap` (one per hook)
+
+ENHO is a rare, specialized object type. For the full XML template, hash algorithm, and workflow:
+
+→ `abapgit-agent ref --topic enho`
+
+---
+
 ## Important Notes
 
 1. **ALWAYS push to git BEFORE running pull** - abapGit reads from git

package/abap/guidelines/debug-session.md

@@ -42,6 +42,27 @@ The output varies by section type:
 
 The hint already points to the first **executable** line, skipping `METHOD`, blank lines, comments, and all declaration forms (`DATA`, `DATA:`, `DATA(`).
 
+**Classes with active ENHO hook enhancements** — `view --full --lines` injects the ENHO hook lines into the CM section so you can see the runtime code layout. The `G` numbers for injected lines are shown for reference, but the BP hint uses **base-source coordinates** (subtracting the injected ENHO lines) because ADT validates breakpoints against the non-injected `/source/main`:
+
+```
+  * ---- Method: COMPUTE (CM001) — breakpoint: debug set --objects ZCL_CAIS_DBG_TRIGGER:33 ----
+    29 [  1]    METHOD compute.
+    30 [  2]  *"* ENHO: ZCAIS_DBG_ENHO (BEGIN)
+    31 [  3]    DATA lv_enho_marker TYPE i.
+    32 [  4]    lv_enho_marker = iv_a * iv_b.
+    33 [  5]  *"* ENHO END
+    34 [  6]      " compute: add two integers...
+    35 [  7]      DATA lv_sum TYPE i.
+    36 [  8]
+    37 [  9]      lv_sum = iv_a + iv_b.       ← lives at G=37 in runtime layout
+    38 [ 10]      rv_result = lv_sum.
+    39 [ 11]    ENDMETHOD.
+```
+
+The first executable original line is `lv_sum = iv_a + iv_b.` at runtime G=37, but its position in ADT's base source (without the 4 injected ENHO lines) is G=33 (37 − 4). The hint says `:33`, not `:37`. ADT accepts `:33` and the breakpoint fires correctly inside the ENHO-affected method.
+
+> **ENHO body lines (G 30–32 in the example) cannot be used as breakpoints.** Setting a BP at those G numbers returns "Not registered on server" — ADT's base source has no ENHO lines. The BP hint already points past the ENHO block to the first original executable line.
+
 **Two scenarios for CM* methods:**
 
 | Scenario | Command |

package/abap/guidelines/enho.md

@@ -0,0 +1,193 @@
+---
+layout: default
+title: Enhancement Objects (ENHO)
+nav_order: 15
+parent: ABAP Coding Guidelines
+grand_parent: ABAP Development
+---
+
+# Enhancement Objects (ENHO) — Workflow Guide
+
+ENHO (Hook Enhancements) let you inject ABAP code into specific spots of existing methods without modifying the original class. Use them sparingly — only when you cannot subclass or use dependency injection.
+
+**Searchable keywords**: enho, enhancement, hook, hook implementation, enhancements, hook_impl
+
+---
+
+## Creating Brand-New ENHOs
+
+**abapGit pull can create brand-new ENHOs headlessly** — write the XML and ABAP files, push, and pull as normal.
+
+This works because abapGit's ENHO hook deserializer passes `dark = abap_true` to `cl_enh_factory=>create_enhancement`, which suppresses the Modification Assistant dialog (`SAPLSTRD 0353`) that would otherwise require a GUI session. The `save()` call also uses `run_dark = abap_true`.
+
+### Workflow for new ENHOs
+
+1. Write `<name>.enho.xml` (see XML Template section below)
+2. For each hook: compute `hash = SHA1(full_name)[0:8]` → write `<name>.enho.<hash>.abap`
+3. Commit, push, then pull:
+   ```bash
+   abapgit-agent pull --files src/<name>.enho.xml --sync-xml
+   ```
+
+The `--sync-xml` flag is important for new objects — abapGit's serializer may rewrite the XML during the first pull.
+
+Once the ENHO exists in the system, abapGit's full-replace deserialization (delete + recreate) works correctly via REST.
+
+---
+
+## File Naming Pattern
+
+An ENHO object produces **multiple** files:
+
+```
+<name>.enho.xml                 ← object metadata (describes all hooks)
+<name>.enho.<hash>.abap         ← hook source code (one file per hook)
+<name>.enho.<hash2>.abap        ← second hook source (if multiple hooks)
+```
+
+### Hash Computation
+
+The `<hash>` is the first 8 hex characters of SHA1(`full_name`):
+
+```js
+// Node.js
+const crypto = require('crypto');
+const fullName = '\\TY:ZCL_TARGET_CLASS\\ME:GET_VALUE\\SE:BEGIN\\EI';
+const hash = crypto.createHash('sha1').update(fullName).digest('hex').substring(0, 8);
+// → 'd639f45c'
+```
+
+### `full_name` Format
+
+```
+\TY:<CLASS>\ME:<METHOD>\SE:<SECTION>\EI
+```
+
+| Part | Value | Meaning |
+|------|-------|---------|
+| `\TY:` | class name (uppercase) | Target class |
+| `\IN:` | interface name (uppercase) | Interface (only when method is from an interface) |
+| `\ME:` | method name (uppercase) | Target method |
+| `\SE:` | `BEGIN` or `END` | Hook point |
+| `\EI` | *(fixed suffix)* | End of identifier |
+
+Examples:
+```
+\TY:ZCL_TARGET\ME:GET_VALUE\SE:BEGIN\EI
+\TY:CL_MPC_EXT\IN:/IWBEP/IF_MGW_APPL_SRV_RUNTIME\ME:GET_ENTITYSET\SE:BEGIN\EI
+```
+
+The `full_name` and its hash are stored in the XML `<FILES>/<item>/<FILE>` element — read them directly from the `.enho.xml` file when the ENHO already exists in git.
+
+---
+
+## Pull Behavior
+
+ENHO deserialization is **full replace**: abapGit deletes the entire ENHO object and recreates all its hooks from git. This is the same as for classes and interfaces.
+
+- Passing the `.enho.xml` file targets the whole ENHO (preferred)
+- Passing any `.enho.<hash>.abap` file also targets the whole ENHO (resolves to same object)
+- **Other ENHO objects are NOT affected** — the object filter is at the ENHO name level
+
+```bash
+# Both commands activate the whole ZFOO_ENH (all hooks)
+abapgit-agent pull --files src/zfoo_enh.enho.xml
+abapgit-agent pull --files src/zfoo_enh.enho.d639f45c.abap
+```
+
+---
+
+## Workflow — Editing an Existing ENHO
+
+When an ENHO already exists in both git and the ABAP system:
+
+```bash
+# Edit the hook source
+vi src/zfoo_enh.enho.d639f45c.abap
+
+# Syntax check (optional — catches basic errors before commit)
+abapgit-agent syntax --files src/zfoo_enh.enho.d639f45c.abap
+
+# Commit, push, pull
+git add src/zfoo_enh.enho.d639f45c.abap
+git commit -m "fix: update enhancement hook"
+git push
+abapgit-agent pull --files src/zfoo_enh.enho.xml --sync-xml
+```
+
+---
+
+## Note on Syntax Command
+
+The `syntax` command supports ENHO `.enho.<hash>.abap` files. It extracts the code between `ENHANCEMENT`/`ENDENHANCEMENT`, wraps it in a minimal program skeleton, and runs `SYNTAX-CHECK` with the target class pool's uccheck/unicode settings.
+
+```bash
+abapgit-agent syntax --files src/zfoo_enh.enho.d639f45c.abap
+```
+
+**Limitation**: Because the code is checked outside the real class pool context, instance variables and class-specific types from the target class are not visible. The check catches basic syntax errors (undefined keywords, missing periods, etc.) but not semantic errors like unknown field names from the enhanced class.
+
+---
+
+## XML Template
+
+This is the format abapGit actually serializes. Use a real abapGit export as the source of truth — copy from an existing ENHO in your project.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<abapGit version="v1.0.0" serializer="LCL_OBJECT_ENHO" serializer_version="v1.0.0">
+ <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
+  <asx:values>
+   <TOOL>HOOK_IMPL</TOOL>
+   <SHORTTEXT>My enhancement description</SHORTTEXT>
+   <ORIGINAL_OBJECT>
+    <PGMID>R3TR</PGMID>
+    <ORG_OBJ_TYPE>CLAS</ORG_OBJ_TYPE>
+    <ORG_OBJ_NAME>ZCL_TARGET_CLASS</ORG_OBJ_NAME>
+    <ORG_MAIN_TYPE>CLAS</ORG_MAIN_TYPE>
+    <ORG_MAIN_NAME>ZCL_TARGET_CLASS</ORG_MAIN_NAME>
+    <PROGRAMNAME>ZCL_TARGET_CLASS================CP</PROGRAMNAME>
+   </ORIGINAL_OBJECT>
+   <ENHANCEMENTS>
+    <ENH_HOOK_IMPL>
+     <PROGRAMNAME>ZCL_TARGET_CLASS================CP</PROGRAMNAME>
+     <ENHMODE>D</ENHMODE>
+     <FULL_NAME>\TY:ZCL_TARGET_CLASS\ME:GET_VALUE\SE:BEGIN\EI</FULL_NAME>
+    </ENH_HOOK_IMPL>
+   </ENHANCEMENTS>
+   <FILES>
+    <item>
+     <NAME>\TY:ZCL_TARGET_CLASS\ME:GET_VALUE\SE:BEGIN\EI</NAME>
+     <FILE>d639f45c</FILE>
+    </item>
+   </FILES>
+  </asx:values>
+ </asx:abap>
+</abapGit>
+```
+
+Key elements:
+- `<TOOL>HOOK_IMPL</TOOL>` — always `HOOK_IMPL` for hook enhancements
+- `<SHORTTEXT>` — short description text
+- `<ORIGINAL_OBJECT>` — the class being enhanced
+- `<PROGRAMNAME>` — class pool name: classname padded to 30 chars with `=`, then `CP` (total 32 chars)
+  - Example: `ZCL_MY_CLASS` (12 chars) → `ZCL_MY_CLASS==================CP`
+- `<ENHANCEMENTS>/<ENH_HOOK_IMPL>/<FULL_NAME>` — the full_name identifier
+- `<ENHMODE>D` — Draft mode (standard value)
+- `<FILES>/<item>/<NAME>` — same full_name as in ENHANCEMENTS
+- `<FILES>/<item>/<FILE>` — first 8 hex chars of SHA1(full_name)
+
+For multiple hooks: add additional `<ENH_HOOK_IMPL>` blocks in `<ENHANCEMENTS>` and additional `<item>` blocks in `<FILES>`.
+
+### Hash file format (`.enho.<hash>.abap`)
+
+```abap
+"Name: \TY:ZCL_TARGET_CLASS\ME:GET_VALUE\SE:BEGIN\EI
+ENHANCEMENT 0 ZFOO_ENH.
+  " Your ABAP code goes here
+  DATA lv_result TYPE string.
+  lv_result = 'modified'.
+ENDENHANCEMENT.
+```
+
+The first line is a comment with the `full_name`. `ENHANCEMENT 0 <ENHNAME>.` and `ENDENHANCEMENT.` are the wrapper statements — the actual code goes between them.

package/abap/guidelines/index.md

@@ -22,7 +22,11 @@ This folder contains detailed ABAP coding guidelines that can be searched using
 | `objects.md` | Object Naming Conventions |
 | `naming-limits.md` | Naming Length Limits (30/16/40 char rules per type) |
 | `json.md` | JSON Handling |
-| `abapgit.md` | abapGit XML Metadata Templates |
+| `string-template.md` | String Templates — syntax, escaping `\{` `\}`, JSON payloads |
+| `abapgit.md` | abapGit XML Metadata — CLAS, INTF, PROG, CDS/DDLS, DCLS, FUGR |
+| `abapgit-xml-only.md` | abapGit XML Metadata — XML-only objects (TABL, STRU, DTEL, TTYP, DOMA, MSAG) |
+| `abapgit-fugr.md` | abapGit XML Metadata — Function Group (FUGR) details |
+| `enho.md` | Enhancement Objects (ENHO) — workflow, hash algorithm, creation guide |
 | `unit-testable-code.md` | Unit Testable Code Guidelines (Dependency Injection) |
 | `common-errors.md` | Common ABAP Errors - Quick Fixes |
 | `debug-session.md` | Debug Session Guide |
@@ -33,6 +37,8 @@ This folder contains detailed ABAP coding guidelines that can be searched using
 | `cds-testing.md` | CDS Testing (Test Double Framework) |
 | `abaplint.md` | abaplint Rule Guidelines (prefer_inline trap, safe patterns) |
 | `comments.md` | Documentation Comments (ABAP DOC, shorttext, @parameter, CDS //) |
+| `run-probe-classes.md` | run Command — AI Guidelines (probe classes, scratchWorkspace) |
+| `probe-poc.md` | Probe and PoC — Full Decision Flow |
 
 ## Usage
 

package/abap/guidelines/object-creation.md

@@ -23,6 +23,7 @@ Replace `<name>` with the actual object name from this project's naming conventi
 | CDS View Entity (DDLS) | `<name>.ddls.asddls` | `<name>.ddls.xml` | **Use by default** — `ref --topic abapgit` |
 | CDS Access Control (DCLS) | `<name>.dcls.asdcls` | `<name>.dcls.xml` | `ref --topic abapgit` |
 | Function Group (FUGR) | `<name>.fugr.abap` + includes | `<name>.fugr.xml` | `ref --topic abapgit` |
+| Enhancement (ENHO) | `<name>.enho.<hash>.abap` (one per hook) | `<name>.enho.xml` | `ref --topic enho` |
 | Table (TABL) | *(none — XML-only)* | `<name>.tabl.xml` | `ref --topic abapgit-xml-only` |
 | Structure (STRU) | *(none — XML-only)* | `<name>.tabl.xml` ⚠️ NOT `.stru.xml` | `ref --topic abapgit-xml-only` |
 | Data Element (DTEL) | *(none — XML-only)* | `<name>.dtel.xml` | `ref --topic abapgit-xml-only` |

package/abap/guidelines/workflow-detailed.md

@@ -18,9 +18,9 @@ grand_parent: ABAP Development
 3. Write code → place in correct folder (e.g., src/zcl_*.clas.abap)
        │
        ▼
-4. Syntax check (for CLAS, INTF, PROG, DDLS only)
+4. Syntax check (for CLAS, INTF, PROG, DDLS, ENHO only)
        │
-       ├─► CLAS/INTF/PROG/DDLS → abapgit-agent syntax --files <file>
+       ├─► CLAS/INTF/PROG/DDLS/ENHO → abapgit-agent syntax --files <file>
        │       │
        │       ├─► Errors? → Fix locally (no commit needed), re-run syntax
        │       │
@@ -31,7 +31,7 @@ grand_parent: ABAP Development
                ▼
 4b. abaplint (OPTIONAL — only if .abaplint.json exists in repo root)
        │
-       ├─► .abaplint.json exists → npx @abaplint/cli .abaplint.json
+       ├─► .abaplint.json exists → abapgit-agent lint
        │       │
        │       ├─► Issues? → Fix locally, re-run abaplint
        │       │   ⚠️  Before applying any quickfix: run abapgit-agent ref --topic abaplint
@@ -45,7 +45,7 @@ grand_parent: ABAP Development
 5. Commit and push → git add . && git commit && git push
        │
        ▼
-6. Activate → abapgit-agent pull --files src/file.clas.abap
+6. Activate → abapgit-agent pull --files src/file.clas.abap --sync-xml
        │         (behaviour depends on .abapgit-agent.json — see AI Tool Guidelines)
        │
        ▼
@@ -67,6 +67,7 @@ grand_parent: ABAP Development
 | INTF (interfaces) | ✅ Supported | Run `syntax` before commit |
 | PROG (programs) | ✅ Supported | Run `syntax` before commit |
 | DDLS (CDS views) | ✅ Supported | Run `syntax` before commit (requires annotations) |
+| ENHO (enhancements) | ✅ Supported | Run `syntax` before commit (basic errors only — no target class context) |
 | FUGR (function groups) | ❌ Not supported | Skip syntax, use `pull` then `inspect` |
 | TABL/DTEL/DOMA/MSAG/SHLP | ❌ Not supported | Skip syntax, just `pull` |
 | All other types | ❌ Not supported | Skip syntax, just `pull` |
@@ -90,7 +91,7 @@ abapgit-agent syntax --files src/zif_my_interface.intf.abap  # ✅ Works (no dep
 git add src/zif_my_interface.intf.abap src/zif_my_interface.intf.xml
 git commit -m "feat: add interface"
 git push
-abapgit-agent pull --files src/zif_my_interface.intf.abap   # Interface now activated
+abapgit-agent pull --files src/zif_my_interface.intf.abap --sync-xml   # Interface now activated
 
 # Step 2: Create class, syntax check, commit, activate
 vim src/zcl_my_class.clas.abap
@@ -98,7 +99,7 @@ abapgit-agent syntax --files src/zcl_my_class.clas.abap     # ✅ Works (interfa
 git add src/zcl_my_class.clas.abap src/zcl_my_class.clas.xml
 git commit -m "feat: add class implementing interface"
 git push
-abapgit-agent pull --files src/zcl_my_class.clas.abap
+abapgit-agent pull --files src/zcl_my_class.clas.abap --sync-xml
 ```
 
 **Benefits:**
@@ -123,7 +124,7 @@ git commit -m "feat: add interface and implementing class"
 git push
 
 # Pull both together
-abapgit-agent pull --files src/zif_my_interface.intf.abap,src/zcl_my_class.clas.abap
+abapgit-agent pull --files src/zif_my_interface.intf.abap,src/zcl_my_class.clas.abap --sync-xml
 
 # Use inspect if errors occur
 abapgit-agent inspect --files src/zcl_my_class.clas.abap
@@ -150,7 +151,7 @@ git commit -m "feat: add class and CDS view"
 git push
 
 # Pull all files together
-abapgit-agent pull --files src/zcl_my_class.clas.abap,src/zc_my_view.ddls.asddls
+abapgit-agent pull --files src/zcl_my_class.clas.abap,src/zc_my_view.ddls.asddls --sync-xml
 ```
 
 **When to use syntax vs abaplint vs inspect vs view**:
@@ -169,6 +170,7 @@ abapgit-agent pull --files src/zcl_my_class.clas.abap,src/zc_my_view.ddls.asddls
    ├─ .intf.abap → INTF ✅ syntax supported
    ├─ .prog.abap → PROG ✅ syntax supported
    ├─ .ddls.asddls → DDLS ✅ syntax supported (requires proper annotations)
+   ├─ .enho.<hash>.abap → ENHO ✅ syntax supported (basic errors; no target class context)
    └─ All other extensions → ❌ syntax not supported
 
 2. Check for dependencies:
@@ -177,25 +179,25 @@ abapgit-agent pull --files src/zcl_my_class.clas.abap,src/zc_my_view.ddls.asddls
    ├─ CDS view uses table? → INDEPENDENT (table already exists)
    └─ Unrelated bug fixes across files? → INDEPENDENT
 
-3. For SUPPORTED types (CLAS/INTF/PROG/DDLS):
-   ├─ INDEPENDENT files → Run syntax → [abaplint if enabled] → Fix errors → Commit → Push → Pull
+3. For SUPPORTED types (CLAS/INTF/PROG/DDLS/ENHO):
+   ├─ INDEPENDENT files → Run syntax → [abaplint if enabled] → Fix errors → Commit → Push → Pull --sync-xml
    │
    └─ DEPENDENT files (NEW objects):
        ├─ RECOMMENDED: Create underlying object first (interface, base class, etc.)
-       │   1. Create underlying object → Syntax → [abaplint] → Commit → Push → Pull
-       │   2. Create dependent object → Syntax (works!) → [abaplint] → Commit → Push → Pull
+       │   1. Create underlying object → Syntax → [abaplint] → Commit → Push → Pull --sync-xml
+       │   2. Create dependent object → Syntax (works!) → [abaplint] → Commit → Push → Pull --sync-xml
        │   ✅ Benefits: Both syntax checks work, cleaner workflow
        │
        └─ ALTERNATIVE: If interface design uncertain, commit both together
-           → Skip syntax → [abaplint] → Commit both → Push → Pull → (if errors: inspect)
+           → Skip syntax → [abaplint] → Commit both → Push → Pull --sync-xml → (if errors: inspect)
 
 4. For UNSUPPORTED types (FUGR, TABL, etc.):
-   Write code → Skip syntax → [abaplint] → Commit → Push → Pull → (if errors: inspect)
+   Write code → Skip syntax → [abaplint] → Commit → Push → Pull --sync-xml → (if errors: inspect)
 
 5. For MIXED types (some supported + some unsupported):
-   Write all code → Run syntax on independent supported files ONLY → [abaplint] → Commit ALL → Push → Pull ALL
+   Write all code → Run syntax on independent supported files ONLY → [abaplint] → Commit ALL → Push → Pull ALL --sync-xml
 
-[abaplint] = run npx @abaplint/cli .abaplint.json only if .abaplint.json exists in repo root
+[abaplint] = run abapgit-agent lint only if .abaplint.json exists in repo root
              before applying any quickfix: run abapgit-agent ref --topic abaplint
 ```
 
@@ -207,13 +209,13 @@ abapgit-agent pull --files src/zcl_my_class.clas.abap,src/zc_my_view.ddls.asddls
 vim src/zif_calculator.intf.abap
 abapgit-agent syntax --files src/zif_calculator.intf.abap  # ✅ Works
 git commit -am "feat: add calculator interface" && git push
-abapgit-agent pull --files src/zif_calculator.intf.abap    # Interface activated
+abapgit-agent pull --files src/zif_calculator.intf.abap --sync-xml    # Interface activated
 
 # Step 2: Class next
 vim src/zcl_calculator.clas.abap
 abapgit-agent syntax --files src/zcl_calculator.clas.abap  # ✅ Works (interface exists!)
 git commit -am "feat: implement calculator" && git push
-abapgit-agent pull --files src/zcl_calculator.clas.abap
+abapgit-agent pull --files src/zcl_calculator.clas.abap --sync-xml
 ```
 
 **Scenario 2: Multiple independent classes**
@@ -222,7 +224,7 @@ abapgit-agent pull --files src/zcl_calculator.clas.abap
 vim src/zcl_class1.clas.abap src/zcl_class2.clas.abap
 abapgit-agent syntax --files src/zcl_class1.clas.abap,src/zcl_class2.clas.abap
 git commit -am "feat: add utility classes" && git push
-abapgit-agent pull --files src/zcl_class1.clas.abap,src/zcl_class2.clas.abap
+abapgit-agent pull --files src/zcl_class1.clas.abap,src/zcl_class2.clas.abap --sync-xml
 ```
 
 **Error indicators after pull:**
@@ -240,10 +242,10 @@ abapgit-agent syntax --files src/zc_my_view.ddls.asddls
 abapgit-agent syntax --files src/zcl_class1.clas.abap,src/zif_intf1.intf.abap,src/zc_view.ddls.asddls
 
 # 2. Pull/activate AFTER pushing to git
-abapgit-agent pull --files src/zcl_class1.clas.abap,src/zcl_class2.clas.abap
+abapgit-agent pull --files src/zcl_class1.clas.abap,src/zcl_class2.clas.abap --sync-xml
 
 # Override conflict detection for a single pull (e.g. deliberate branch switch)
-abapgit-agent pull --files src/zcl_class1.clas.abap --conflict-mode ignore
+abapgit-agent pull --files src/zcl_class1.clas.abap --conflict-mode ignore --sync-xml
 
 # 3. Inspect AFTER pull (for errors or unsupported types)
 abapgit-agent inspect --files src/zcl_class1.clas.abap

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "abapgit-agent",
-  "version": "1.16.3",
+  "version": "1.17.1",
   "description": "ABAP Git Agent - Pull and activate ABAP code via abapGit from any git repository",
   "files": [
     "bin/",
@@ -37,6 +37,7 @@
     "test:cmd:tree": "node tests/run-all.js --cmd --command=tree",
     "test:cmd:dump": "node tests/run-all.js --cmd --command=dump",
     "test:drop": "node tests/run-all.js --drop",
+    "test:customize": "node tests/run-all.js --customize",
     "test:cmd:debug": "node tests/run-all.js --cmd --command=debug",
     "test:debug": "node tests/run-all.js --debug",
     "test:debug:scenarios": "bash tests/integration/debug-scenarios.sh",

package/src/commands/customize.js

@@ -0,0 +1,157 @@
+/**
+ * Customize command — write a single row to a SAP customizing table (delivery class C/E).
+ *
+ * Usage:
+ *   abapgit-agent customize <table> --set <field=value> [<field=value>...]
+ *                                   [--transport <TRKORR>] [--no-transport] [--json]
+ */
+
+const { printHttpError } = require('../utils/format-error');
+
+module.exports = {
+  name: 'customize',
+  description: 'Write a row to a SAP customizing table (delivery class C/E)',
+  requiresAbapConfig: true,
+  requiresVersionCheck: false,
+
+  async execute(args, context) {
+    const { loadConfig, AbapHttp, getTransport, getTransportSettings } = context;
+
+    const jsonOutput = args.includes('--json');
+    const verbose    = args.includes('--verbose');
+    const noTransport = args.includes('--no-transport');
+
+    // First positional arg (not starting with '-' and not following --set/--transport) = table name
+    const skipNext = new Set();
+    for (let i = 0; i < args.length; i++) {
+      if (args[i] === '--transport' || args[i] === '-t') {
+        if (i + 1 < args.length) skipNext.add(i + 1);
+      } else if (args[i] === '--set') {
+        let j = i + 1;
+        while (j < args.length && !args[j].startsWith('-')) {
+          skipNext.add(j);
+          j++;
+        }
+      }
+    }
+    const tableName = args.find((a, idx) => !a.startsWith('-') && !skipNext.has(idx));
+    if (!tableName) {
+      console.error('❌ Error: table name is required');
+      console.error('   Usage: abapgit-agent customize <table> --set <field=value> [...]');
+      process.exit(1);
+    }
+
+    // Collect all --set values (one or more field=value pairs after the flag)
+    const fieldValues = [];
+    for (let i = 0; i < args.length; i++) {
+      if (args[i] === '--set') {
+        // Consume all following positional tokens as field=value pairs
+        let j = i + 1;
+        while (j < args.length && !args[j].startsWith('-')) {
+          const pair = args[j];
+          const eqIdx = pair.indexOf('=');
+          if (eqIdx === -1) {
+            console.error(`❌ Error: --set value '${pair}' must be in field=value format`);
+            process.exit(1);
+          }
+          fieldValues.push({
+            field: pair.substring(0, eqIdx).toUpperCase(),
+            value: pair.substring(eqIdx + 1)
+          });
+          j++;
+        }
+      }
+    }
+
+    if (fieldValues.length === 0) {
+      console.error('❌ Error: at least one --set field=value pair is required');
+      console.error('   Example: abapgit-agent customize ZTABLE_CONFIG --set KEY=APP VALUE=active');
+      process.exit(1);
+    }
+
+    // Transport resolution: CLI --transport > config/env > auto-selection
+    let transportRequest = null;
+    const transportArgIndex = args.indexOf('--transport');
+    if (transportArgIndex !== -1 && transportArgIndex + 1 < args.length) {
+      transportRequest = args[transportArgIndex + 1];
+    } else if (!noTransport) {
+      transportRequest = getTransport ? getTransport() : null;
+    }
+
+    // When no transport is determined yet and we are not in JSON mode, use the
+    // selector (hook / interactive picker) with type='customizing'
+    if (!transportRequest && !noTransport && !jsonOutput) {
+      const { selectTransport, isNonInteractive, _getTransportHookConfig } = require('../utils/transport-selector');
+
+      const config = loadConfig();
+      const http = new AbapHttp(config);
+      transportRequest = await selectTransport(config, http, loadConfig, AbapHttp, getTransportSettings, 'customizing');
+
+      if (transportRequest === null) {
+        const hookConfig = _getTransportHookConfig();
+        if (hookConfig && hookConfig.hook) {
+          if (isNonInteractive()) {
+            console.error('❌ Error: transport hook returned no transport request.');
+            console.error(`   Hook: ${hookConfig.hook}`);
+            if (hookConfig.description) console.error(`   ${hookConfig.description}`);
+            process.exit(1);
+          } else {
+            process.stderr.write(`⚠️  Transport hook returned no transport request (${hookConfig.hook}).\n`);
+            process.stderr.write('   Please select one manually:\n');
+            const { interactivePicker } = require('../utils/transport-selector');
+            transportRequest = await interactivePicker(http, 'customizing');
+          }
+        }
+      }
+    }
+
+    const config = loadConfig();
+    const http = new AbapHttp(config);
+
+    try {
+      const csrfToken = await http.fetchCsrfToken();
+      const payload = {
+        table_name:   tableName.toUpperCase(),
+        field_values: fieldValues,
+        transport:    transportRequest || '',
+        no_transport: noTransport ? 'X' : ''
+      };
+
+      const result = await http.post(
+        '/sap/bc/z_abapgit_agent/customize',
+        payload,
+        { csrfToken }
+      );
+
+      if (jsonOutput) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      const success       = result.SUCCESS === true || result.success === true ||
+                            result.SUCCESS === 'X'  || result.success === 'X';
+      const error         = result.ERROR         || result.error         || '';
+      const message       = result.MESSAGE       || result.message       || '';
+      const action        = result.ACTION        || result.action        || '';
+      const transport     = result.TRANSPORT     || result.transport     || '';
+      const deliveryCls   = result.DELIVERY_CLASS || result.delivery_class || '';
+
+      if (!success) {
+        console.error(`❌ Error: ${error || message || 'customize command failed'}`);
+        process.exit(1);
+      }
+
+      console.log(`\n✅ Customizing entry written to ${tableName.toUpperCase()}`);
+      if (action)      console.log(`   Action:    ${action}`);
+      if (transport)   console.log(`   Transport: ${transport} (recorded)`);
+      else if (deliveryCls) console.log(`   Transport: none (delivery class ${deliveryCls})`);
+      else             console.log(`   Transport: none`);
+      if (message)     console.log(`   ${message}`);
+      console.log('');
+
+    } catch (error) {
+      printHttpError(error, { verbose });
+      process.exit(1);
+    }
+  }
+};

package/src/commands/drop.js

@@ -8,7 +8,7 @@ const { printHttpError } = require('../utils/format-error');
 const EXT_TO_TYPE = {
   clas: 'CLAS', intf: 'INTF', prog: 'PROG', fugr: 'FUGR',
   tabl: 'TABL', dtel: 'DTEL', ttyp: 'TTYP', doma: 'DOMA',
-  ddls: 'DDLS', dcls: 'DCLS', msag: 'MSAG', stru: 'STRU'
+  ddls: 'DDLS', dcls: 'DCLS', msag: 'MSAG', stru: 'STRU', enho: 'ENHO'
 };
 
 /**

package/src/commands/help.js

@@ -66,6 +66,9 @@ Commands:
     List and manage SAP transport requests.
     Subcommands: list, create, release
 
+  customize <table> --set <field>=<value> [<field>=<value> ...] [--transport <TRKORR>] [--no-transport] [--json]
+    Write a row (insert-or-update) into a SAP customizing table (delivery class C or E).
+
   tree --package <package> [--depth <n>] [--include-types] [--json]
     Display package hierarchy tree from ABAP system
 
@@ -147,6 +150,7 @@ Examples:
   abapgit-agent view --objects ZCL_MY_CLASS                  # View class definition
   abapgit-agent preview --objects SFLIGHT                    # Preview table data
   abapgit-agent where --objects ZCL_MY_CLASS                 # Find where class is used
+  abapgit-agent customize ZAPP_CONFIG --set KEY=X VALUE=Y --no-transport  # Write customizing entry
   abapgit-agent dump --date TODAY                            # Recent short dumps
   abapgit-agent dump --user DEVELOPER --detail 1             # Full detail of first result
   abapgit-agent ref "CORRESPONDING"                          # Search for pattern

package/src/commands/index.js

@@ -31,5 +31,6 @@ module.exports = {
   upgrade:   require('./upgrade'),
   transport: require('./transport'),
   lint:      require('./lint'),
-  drop:      require('./drop')
+  drop:      require('./drop'),
+  customize: require('./customize')
 };

package/src/commands/pull.js

@@ -153,8 +153,9 @@ Examples:
         console.error('❌ Error: --files only accepts ABAP source files (.abap, .asddls) or XML-only object files (name.type.xml).');
         console.error('   The following file(s) are not recognised:');
         nonSourceFiles.forEach(f => console.error(`     ${f}`));
-        console.error('   Tip: for source objects pass the .abap file; for XML-only objects (TABL, STRU, DTEL, TTYP)');
-        console.error('   pass the .xml file, e.g. --files abap/ztable.tabl.xml');
+        console.error('   Tip: for source objects pass the .abap file (e.g. zcl_foo.clas.abap or zcl_foo.enho.28bbfe2f.abap);');
+        console.error('   for XML-only objects (TABL, STRU, DTEL, TTYP) or enhancement metadata,');
+        console.error('   pass the .xml file, e.g. --files abap/ztable.tabl.xml or abap/zfoo.enho.xml');
         process.exit(1);
       }
 

package/src/commands/syntax.js

@@ -24,7 +24,7 @@ Description:
   Reads source from local files and checks directly in the ABAP system.
 
 Parameters:
-  --files <file1,...>  Comma-separated ABAP source files (required). Accepts CLAS, INTF, PROG.
+  --files <file1,...>  Comma-separated ABAP source files (required). Accepts CLAS, INTF, PROG, ENHO.
   --cloud              Use ABAP Cloud (BTP) stricter syntax check.
   --json               Output as JSON.
 
@@ -103,6 +103,9 @@ Examples:
       } else if (baseName.includes('.prog.')) {
         objType = 'PROG';
         objName = baseName.split('.')[0].toUpperCase();
+      } else if (/\.enho\.[0-9a-f]{8}\.abap$/i.test(baseName)) {
+        objType = 'ENHO';
+        objName = baseName.split('.')[0].toUpperCase();
       } else if (baseName.includes('.ddls.asddls')) {
         objType = 'DDLS';
         objName = baseName.split('.')[0].toUpperCase();

package/src/commands/transport.js

@@ -81,7 +81,16 @@ module.exports = {
       process.exit(1);
     }
 
-    const result = await http.get(`/sap/bc/z_abapgit_agent/transport?scope=${scope}`);
+    const typeIdx = args.indexOf('--type');
+    const type = typeIdx !== -1 ? args[typeIdx + 1] : null;
+
+    if (type && !VALID_TYPES.includes(type)) {
+      console.error(`❌ Error: Invalid type '${type}'. Valid values: ${VALID_TYPES.join(', ')}`);
+      process.exit(1);
+    }
+
+    const typeParam = type ? `&type=${type}` : '';
+    const result = await http.get(`/sap/bc/z_abapgit_agent/transport?scope=${scope}${typeParam}`);
 
     if (jsonOutput) {
       console.log(JSON.stringify(result, null, 2));
@@ -90,8 +99,9 @@ module.exports = {
 
     const transports = result.TRANSPORTS || result.transports || [];
     const scopeLabel = { mine: 'mine', task: 'task — where I own or have a task', all: 'all' }[scope];
+    const typeLabel = type ? ` (${type})` : '';
 
-    console.log(`\n📋 Open Transport Requests (${scopeLabel})\n`);
+    console.log(`\n📋 Open Transport Requests (${scopeLabel}${typeLabel})\n`);
 
     if (transports.length === 0) {
       console.log('  No open transport requests found.');

package/src/commands/view.js

@@ -156,9 +156,21 @@ function findFirstExecutableLine(lines) {
   const commentPattern = /^\s*[*"]/;
   // Program-level header/declaration keywords that are not executable statements
   const progDeclPattern = /^\s*(report|program|parameters|tables|selection-screen|select-options|class-pool|function-pool|interface-pool|type-pool|include)\b/i;
+  // ENHO injected block marker: *"* ENHO: ... through *"* ENHO END
+  const enhoStartPattern = /^\s*\*"\* ENHO:/;
+  const enhoEndPattern = /^\s*\*"\* ENHO END/;
   let inDeclBlock = false; // true while inside a multi-line DATA:/TYPES:/PARAMETERS: block
+  let inEnhoBlock = false; // true while inside an injected ENHO block
   for (let i = 0; i < lines.length; i++) {
     const trimmed = lines[i].trim();
+    if (inEnhoBlock) {
+      if (enhoEndPattern.test(trimmed)) inEnhoBlock = false;
+      continue;
+    }
+    if (enhoStartPattern.test(trimmed)) {
+      inEnhoBlock = true;
+      continue;
+    }
     if (inDeclBlock) {
       // continuation line — skip until the block closes with a period
       if (trimmed.endsWith('.')) inDeclBlock = false;
@@ -182,6 +194,34 @@ function findFirstExecutableLine(lines) {
   return 0;
 }
 
+/**
+ * Count the number of injected ENHO lines in `lines[0..upToIndex-1]`.
+ * An ENHO block spans from a `*"* ENHO:` marker line through (and including) the
+ * `*"* ENHO END` marker line.  All lines in these blocks are injected by the ABAP
+ * backend and do not exist in the base class source that ADT uses for BP validation.
+ *
+ * Subtracting this count from the execOffset returned by findFirstExecutableLine
+ * converts the injected-array index back to the base-source line offset, which is
+ * the coordinate system ADT accepts for breakpoints.
+ */
+function countEnhoLines(lines, upToIndex) {
+  const enhoStartPattern = /^\s*\*"\* ENHO:/;
+  const enhoEndPattern = /^\s*\*"\* ENHO END/;
+  let count = 0;
+  let inEnhoBlock = false;
+  for (let i = 0; i < upToIndex && i < lines.length; i++) {
+    const trimmed = lines[i].trim();
+    if (inEnhoBlock) {
+      count++;
+      if (enhoEndPattern.test(trimmed)) inEnhoBlock = false;
+    } else if (enhoStartPattern.test(trimmed)) {
+      inEnhoBlock = true;
+      count++;
+    }
+  }
+  return count;
+}
+
 module.exports = {
   name: 'view',
   description: 'View ABAP object definitions from ABAP system',
@@ -189,6 +229,7 @@ module.exports = {
   requiresVersionCheck: true,
   _buildMethodLineMap: buildMethodLineMap,
   _findFirstExecutableLine: findFirstExecutableLine,
+  _countEnhoLines: countEnhoLines,
 
   async execute(args, context) {
     const { loadConfig, AbapHttp } = context;
@@ -339,7 +380,8 @@ Examples:
             const file = section.FILE || section.file || '';
             const lines = section.LINES || section.lines || [];
             const isCmSection = suffix.startsWith('CM') && methodName;
-            const isFugrFmSection = !isCmSection && !!methodName;
+            const isEnhoSection = /^[0-9a-f]{8}$/i.test(suffix);
+            const isFugrFmSection = !isCmSection && !isEnhoSection && !!methodName;
 
             if (linesMode) {
               // --full --lines: dual line numbers (G [N]) for debugging
@@ -359,7 +401,10 @@ Examples:
                 let bpHint;
                 if (globalStart) {
                   const execOffset = findFirstExecutableLine(lines);
-                  const execLine = globalStart + execOffset;
+                  // Subtract injected ENHO lines that appear before execOffset so
+                  // the BP hint uses base-source coordinates (what ADT validates against)
+                  const enhoCount = countEnhoLines(lines, execOffset);
+                  const execLine = globalStart + execOffset - enhoCount;
                   bpHint = `debug set --objects ${objName}:${execLine}`;
                 } else {
                   bpHint = `debug set --objects ${objName}:<global_line>`;
@@ -390,6 +435,10 @@ Examples:
                 }
                 const bpHint = `debug set --objects ${suffix}:${firstExecLine}`;
                 console.log(`  * ---- FM: ${methodName} (${suffix}) — breakpoint: ${bpHint} ----`);
+              } else if (isEnhoSection) {
+                const desc = section.DESCRIPTION || section.description || '';
+                console.log(`  * ---- Hook: ${methodName} (${suffix}) ----`);
+                if (desc && desc !== methodName) console.log(`  *      full_name: ${desc}`);
               } else if (file) {
                 console.log(`  * ---- Section: ${section.DESCRIPTION || section.description} (from .clas.${file}.abap) ----`);
               } else if (suffix) {
@@ -453,6 +502,10 @@ Examples:
                 console.log(`  * ---- Method: ${methodName} (${suffix}) ----`);
               } else if (isFugrFmSection) {
                 console.log(`  * ---- FM: ${methodName} (${suffix}) ----`);
+              } else if (isEnhoSection) {
+                const desc = section.DESCRIPTION || section.description || '';
+                console.log(`  * ---- Hook: ${methodName} (${suffix}) ----`);
+                if (desc && desc !== methodName) console.log(`  *      full_name: ${desc}`);
               } else if (file) {
                 console.log(`  * ---- Section: ${section.DESCRIPTION || section.description} (from .clas.${file}.abap) ----`);
               } else if (suffix) {

package/src/utils/transport-selector.js

@@ -38,11 +38,13 @@ async function runHook(hookPath, context) {
  *
  * @param {object} http
  * @param {string} scope - 'mine' | 'task' | 'all'
+ * @param {string} [type] - 'workbench' (default) | 'customizing'
  * @returns {Promise<Array>}
  */
-async function fetchTransports(http, scope = 'mine') {
+async function fetchTransports(http, scope = 'mine', type = 'workbench') {
   try {
-    const result = await http.get(`/sap/bc/z_abapgit_agent/transport?scope=${scope}`);
+    const typeParam = type === 'customizing' ? '&type=customizing' : '';
+    const result = await http.get(`/sap/bc/z_abapgit_agent/transport?scope=${scope}${typeParam}`);
     const raw = result.TRANSPORTS || result.transports || [];
     return raw.map(t => ({
       number:      t.NUMBER      || t.number      || '',
@@ -59,13 +61,14 @@ async function fetchTransports(http, scope = 'mine') {
  * Create a new transport request.
  * @param {object} http
  * @param {string} description
+ * @param {string} [type] - 'workbench' (default) | 'customizing'
  * @returns {Promise<string|null>} transport number or null
  */
-async function createTransport(http, description) {
+async function createTransport(http, description, type = 'workbench') {
   try {
     const result = await http.post(
       '/sap/bc/z_abapgit_agent/transport',
-      { action: 'CREATE', description: description || '' },
+      { action: 'CREATE', description: description || '', type },
       {}
     );
     return result.NUMBER || result.number || null;
@@ -79,9 +82,10 @@ async function createTransport(http, description) {
  * Presents a numbered menu; supports scope switching, create, and skip.
  *
  * @param {object} http
+ * @param {string} [type] - 'workbench' (default) | 'customizing'
  * @returns {Promise<string|null>}
  */
-async function interactivePicker(http) {
+async function interactivePicker(http, type = 'workbench') {
   const readline = require('readline');
 
   let scope = 'mine';
@@ -92,11 +96,12 @@ async function interactivePicker(http) {
   const ask = (q) => new Promise(resolve => rl.question(q, resolve));
 
   const fetchAndDisplay = async () => {
-    transports = await fetchTransports(http, scope);
+    transports = await fetchTransports(http, scope, type);
     fetchError = transports.length === 0;
 
     const scopeLabel = { mine: 'my transports', task: 'transports where I have a task', all: 'all open transports' }[scope];
-    process.stderr.write(`\nSelect a transport request (showing: ${scopeLabel}):\n\n`);
+    const typeLabel = type === 'customizing' ? ' (customizing)' : '';
+    process.stderr.write(`\nSelect a transport request (showing: ${scopeLabel}${typeLabel}):\n\n`);
 
     if (transports.length > 0) {
       transports.forEach((t, i) => {
@@ -144,7 +149,7 @@ async function interactivePicker(http) {
     if (answer === 'c') {
       const desc = (await ask('Description: ')).trim();
       rl.close();
-      const number = await createTransport(http, desc);
+      const number = await createTransport(http, desc, type);
       if (number) {
         process.stderr.write(`\n✅ Created transport ${number}\n`);
         return number;
@@ -173,18 +178,30 @@ async function interactivePicker(http) {
  *
  * Splits on whitespace, forces --json, captures output, returns parsed JSON.
  *
+ * When `type` is set, `transport list` calls automatically get `--type <type>`
+ * injected (unless the hook already passes --type explicitly). This means hooks
+ * written generically as `run('transport list ...')` automatically see only the
+ * right kind of transport (workbench or customizing) without any hook changes.
+ *
  * @param {object}   config               - Loaded ABAP config
  * @param {object}   http                 - Pre-built AbapHttp instance
  * @param {Function} loadConfig           - Config factory (from pull context)
  * @param {Function} AbapHttp             - AbapHttp constructor (from pull context)
  * @param {Function} getTransportSettings - Transport settings getter (from pull context)
+ * @param {string}   [type]               - 'workbench' (default) | 'customizing'
  * @returns {Function|undefined}          - The run helper, or undefined if factories are missing
  */
-function buildRun(config, http, loadConfig, AbapHttp, getTransportSettings) {
+function buildRun(config, http, loadConfig, AbapHttp, getTransportSettings, type = 'workbench') {
   if (!loadConfig || !AbapHttp) return undefined;
 
   return async function run(command) {
-    const [commandName, ...args] = command.trim().split(/\s+/);
+    let [commandName, ...args] = command.trim().split(/\s+/);
+
+    // Auto-inject --type for "transport list" so the hook gets the right request type
+    // without needing to know about the transport type explicitly.
+    if (commandName === 'transport' && args[0] === 'list' && !args.includes('--type') && type) {
+      args = [...args, '--type', type];
+    }
     const cmdModule = require(`../commands/${commandName}`);
 
     // Always force --json so output is parseable
@@ -220,7 +237,7 @@ function buildRun(config, http, loadConfig, AbapHttp, getTransportSettings) {
 }
 
 /**
- * Main export — selects a transport request for use in the pull command.
+ * Main export — selects a transport request for use in the pull/customize command.
  * Returns the transport number, or null to proceed without one.
  *
  * @param {object}   config               - Loaded ABAP config
@@ -228,16 +245,21 @@ function buildRun(config, http, loadConfig, AbapHttp, getTransportSettings) {
  * @param {Function} [loadConfig]         - Config factory (enables run helper in hook context)
  * @param {Function} [AbapHttp]           - AbapHttp constructor (enables run helper in hook context)
  * @param {Function} [getTransportSettings] - Transport settings getter
+ * @param {string}   [type]               - 'workbench' (default) | 'customizing'
+ *                                          Passed to hook as context.type and auto-injected into
+ *                                          run('transport list ...') calls so hooks work correctly
+ *                                          for both ABAP objects and customizing entries without
+ *                                          needing to handle type explicitly.
  * @returns {Promise<string|null>}
  */
-async function selectTransport(config, http, loadConfig, AbapHttp, getTransportSettings) {
+async function selectTransport(config, http, loadConfig, AbapHttp, getTransportSettings, type = 'workbench') {
   // Hook takes precedence over the interactive picker — runs in both TTY and non-TTY mode
   const hookConfig = module.exports._getTransportHookConfig();
   if (hookConfig && hookConfig.hook) {
     const hookPath = path.resolve(process.cwd(), hookConfig.hook);
-    const run = buildRun(config, http, loadConfig, AbapHttp, getTransportSettings);
+    const run = buildRun(config, http, loadConfig, AbapHttp, getTransportSettings, type);
     try {
-      return await module.exports.runHook(hookPath, { config, http, run });
+      return await module.exports.runHook(hookPath, { config, http, run, type });
     } catch {
       return null;
     }
@@ -249,7 +271,7 @@ async function selectTransport(config, http, loadConfig, AbapHttp, getTransportS
   }
 
   // Manual mode: interactive picker
-  return interactivePicker(http);
+  return interactivePicker(http, type);
 }
 
 /**