abapgit-agent 1.1.6 → 1.2.0

package/.github/workflows/release.yml

@@ -40,8 +40,10 @@ jobs:
         id: release_notes
         run: |
           if [ -f "RELEASE_NOTES.md" ]; then
+            # Extract only the current release (first section until --- separator)
+            content=$(awk '/^---$/{exit}1' RELEASE_NOTES.md)
             echo "CONTENT<<EOF" >> $GITHUB_OUTPUT
-            cat RELEASE_NOTES.md >> $GITHUB_OUTPUT
+            echo "$content" >> $GITHUB_OUTPUT
             echo "EOF" >> $GITHUB_OUTPUT
           else
             echo "CONTENT=No release notes" >> $GITHUB_OUTPUT

package/CLAUDE.md

@@ -38,6 +38,7 @@ ABAP REST Handler (ZCL_ABGAGT_REST_HANDLER)
 Resource: ZCL_ABGAGT_RESOURCE_PULL → ZCL_ABGAGT_CMD_FACTORY → ZCL_ABGAGT_COMMAND_PULL → ZCL_ABGAGT_AGENT
 Resource: ZCL_ABGAGT_RESOURCE_INSPECT → ZCL_ABGAGT_CMD_FACTORY → ZCL_ABGAGT_COMMAND_INSPECT → ZCL_ABGAGT_AGENT
 Resource: ZCL_ABGAGT_RESOURCE_UNIT → ZCL_ABGAGT_CMD_FACTORY → ZCL_ABGAGT_COMMAND_UNIT → ZCL_ABGAGT_AGENT
+Resource: ZCL_ABGAGT_RESOURCE_TREE → ZCL_ABGAGT_CMD_FACTORY → ZCL_ABGAGT_COMMAND_TREE → ZCL_ABGAGT_AGENT
 ```
 
 ### ABAP Objects
@@ -49,6 +50,7 @@ Resource: ZCL_ABGAGT_RESOURCE_UNIT → ZCL_ABGAGT_CMD_FACTORY → ZCL_ABGAGT_COM
 | `ZCL_ABGAGT_COMMAND_PULL` | Pull command - implements ZIF_ABGAGT_COMMAND |
 | `ZCL_ABGAGT_COMMAND_INSPECT` | Inspect command - implements ZIF_ABGAGT_COMMAND |
 | `ZCL_ABGAGT_COMMAND_UNIT` | Unit command - implements ZIF_ABGAGT_COMMAND |
+| `ZCL_ABGAGT_COMMAND_TREE` | Tree command - displays package hierarchy |
 | `ZIF_ABGAGT_COMMAND` | Command interface with constants |
 | `ZIF_ABGAGT_CMD_FACTORY` | Factory interface |
 
@@ -73,6 +75,14 @@ abapgit-agent inspect --files abap/zcl_my_class.clas.abap
 # Run unit tests for ABAP test classes
 abapgit-agent unit --files abap/zcl_my_test.clas.testclasses.abap
 
+# Display package hierarchy tree
+abapgit-agent tree --package $MY_PACKAGE
+
+# View ABAP object definitions from ABAP system
+abapgit-agent view --objects ZCL_MY_CLASS
+abapgit-agent view --objects ZIF_MY_INTERFACE --type INTF
+abapgit-agent view --objects ZCL_CLASS1,ZCL_CLASS2 --json
+
 # Health check
 abapgit-agent health
 
@@ -85,6 +95,22 @@ abapgit-agent status
 ### Description
 Pull and activate ABAP objects from git repository.
 
+### Rule: Pull All Changed Files Together
+
+**CRITICAL**: When multiple ABAP files are changed, pull them ALL together in a single command:
+
+```bash
+# WRONG - Pull files one by one (may cause activation issues)
+abapgit-agent pull --files zcl_class1.clas.abap
+abapgit-agent pull --files zcl_class2.clas.abap
+abapgit-agent pull --files zif_interface1.intf.abap
+
+# CORRECT - Pull all changed files together
+abapgit-agent pull --files zcl_class1.clas.abap,zcl_class2.clas.abap,zif_interface1.intf.abap
+```
+
+**Why?** ABAP objects often have dependencies on each other. Pulling separately can cause activation errors if dependent objects haven't been activated yet. Pulling together ensures the ABAP system processes all changes atomically.
+
 ### Usage
 ```bash
 # Auto-detect git remote and branch from current directory
@@ -230,6 +256,202 @@ The unit command uses `CL_SUT_AUNIT_RUNNER` to execute AUnit tests:
 - `tab_objects` - Get detailed results with nested structure:
   - `TAB_TESTCLASSES` → `TAB_METHODS` → `STR_ERROR` → `STR_ERROR_CORE`
 
+## Tree Command
+
+### Description
+Display the package hierarchy tree from an ABAP system, showing parent packages, sub-packages, and object counts.
+
+### Usage
+```bash
+# Basic usage
+abapgit-agent tree --package $MY_PACKAGE
+
+# With object breakdown by type
+abapgit-agent tree --package $MY_PACKAGE --include-objects
+
+# Limit depth (default: 3, max: 10)
+abapgit-agent tree --package $MY_PACKAGE --depth 2
+
+# JSON output for scripting
+abapgit-agent tree --package $MY_PACKAGE --json
+```
+
+### Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--package` | Yes | ABAP package name (e.g., `$ZMY_PACKAGE`, `ZMY_PACKAGE`) |
+| `--depth` | No | Maximum depth to traverse (default: 3, max: 10) |
+| `--include-objects` | No | Include object counts breakdown by type |
+| `--json` | No | Output raw JSON only (for scripting) |
+
+### Output
+
+**Human-readable with AI metadata:**
+```
+🌳 Package Tree: $ZMAIN_PACKAGE
+
+📦 $ZMAIN_PACKAGE (Main Package)
+   ├─ 📦 $ZMAIN_SUB1 (Sub Package 1)
+   │    ├─ 📦 $ZMAIN_SUB1_A (Sub Package 1A)
+   │    └─ 📦 $ZMAIN_SUB1_B (Sub Package 1B)
+   └─ 📦 $ZMAIN_SUB2 (Sub Package 2)
+
+📊 Summary
+PACKAGES: 4
+OBJECTS: 127
+
+<!-- AI_METADATA_START -->
+{"package":"$ZMAIN_PACKAGE","parent":"$ZSAP_BASE","total_packages":4,"total_objects":127}
+<!-- AI_METADATA_END -->
+```
+
+**With object breakdown:**
+```
+📊 Summary
+PACKAGES: 4
+OBJECTS: 127
+TYPES: CLAS=10 INTF=2 PROG=11 FUGR=1 TABL=3
+```
+
+### JSON Output
+```json
+{
+  "SUCCESS": true,
+  "COMMAND": "TREE",
+  "PACKAGE": "$ZMAIN_PACKAGE",
+  "PARENT_PACKAGE": "$ZSAP_BASE",
+  "NODES": [
+    {
+      "PACKAGE": "$ZMAIN_PACKAGE",
+      "PARENT": "",
+      "DESCRIPTION": "$ZMAIN_PACKAGE",
+      "DEPTH": 0,
+      "OBJECT_COUNT": 11
+    }
+  ],
+  "TOTAL_PACKAGES": 4,
+  "TOTAL_OBJECTS": 127,
+  "OBJECTS": [
+    { "OBJECT": "CLAS", "COUNT": 10 },
+    { "OBJECT": "INTF", "COUNT": 2 },
+    { "OBJECT": "PROG", "COUNT": 11 },
+    { "OBJECT": "FUGR", "COUNT": 1 },
+    { "OBJECT": "TABL", "COUNT": 3 }
+  ],
+  "ERROR": ""
+}
+```
+
+### Error Handling
+
+| Error | Message |
+|-------|---------|
+| Package not found | `Package <name> does not exist in the system` |
+| Invalid package name | `Invalid package name: <name>` |
+| Access denied | `Access denied to package information` |
+| Depth too large | `Depth value too large (max: 10)` |
+
+## View Command
+
+### Description
+View ABAP object definitions directly from the ABAP system without pulling from git. **This is the PRIMARY way to explore unfamiliar ABAP objects** - tables, structures, classes, interfaces, and data elements.
+
+**When you encounter an unknown table or structure, use this command instead of guessing!**
+
+### Explore Unknown Tables/Structures
+
+```bash
+# View table fields - see all columns, keys, and descriptions
+abapgit-agent view --objects ZMY_TABLE --type TABL
+
+# View structure components
+abapgit-agent view --objects ZMY_STRUCT --type STRU
+
+# View data element type information
+abapgit-agent view --objects ZMY_DTEL --type DTEL
+
+# View class interface and methods
+abapgit-agent view --objects ZCL_UNKNOWN_CLASS
+
+# View interface definition
+abapgit-agent view --objects ZIF_UNKNOWN_INTERFACE
+```
+
+### Usage
+```bash
+# View single object (auto-detect type from TADIR)
+abapgit-agent view --objects ZCL_MY_CLASS
+abapgit-agent view --objects ZIF_MY_INTERFACE
+
+# View with explicit type
+abapgit-agent view --objects ZCL_MY_CLASS --type CLAS
+abapgit-agent view --objects ZIF_MY_INT --type INTF
+abapgit-agent view --objects ZMY_TABLE --type TABL
+
+# View multiple objects
+abapgit-agent view --objects ZCL_CLASS1,ZCL_CLASS2,ZIF_INTERFACE1
+
+# JSON output (for scripting/AI processing)
+abapgit-agent view --objects ZCL_MY_CLASS --json
+```
+
+### Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--objects` | Yes | Comma-separated list of object names (e.g., `ZCL_MY_CLASS,ZIF_MY_INTERFACE`) |
+| `--type` | No | Object type for all objects (CLAS, INTF, TABL, STRU, DTEL, FUGR, PROG). Auto-detected from name prefix if not specified |
+| `--json` | No | Output raw JSON only (for scripting) |
+
+### Supported Object Types
+
+| Type | Description | Detection Pattern |
+|------|-------------|-------------------|
+| CLAS | Class | ZCL_* |
+| INTF | Interface | ZIF_* |
+| TABL | Table | Z* (from DD02L) |
+| STRU | Structure | Z* (from DD02L) |
+| DTEL | Data Element | ZTY_*, ZS_* |
+
+### Output
+
+**Human-readable:**
+```
+📖 ZCL_MY_CLASS (Class)
+   My Custom Configuration Class
+   Methods: 3
+     - PUBLIC CONSTRUCTOR
+     - PUBLIC GET_CONFIG
+     - PUBLIC SET_CONFIG
+```
+
+**JSON Output:**
+```json
+{
+  "success": true,
+  "command": "VIEW",
+  "message": "Retrieved 1 object(s)",
+  "objects": [
+    {
+      "name": "ZCL_MY_CLASS",
+      "type": "CLAS",
+      "type_text": "Class",
+      "description": "My Custom Configuration Class",
+      "methods": [...]
+    }
+  ],
+  "summary": { "total": 1 }
+}
+```
+
+### Error Handling
+
+| Error | Message |
+|-------|---------|
+| Object not found | `Object <name> not found` |
+| Invalid object type | `Unsupported object type: <type>` |
+
 ## Status Check
 
 ### Description
@@ -295,6 +517,32 @@ export GIT_PASSWORD="git-token"
 
 ## Development Workflow
 
+### Exploring Unknown ABAP Objects
+
+**Before working with an unfamiliar table, structure, class, or interface:**
+
+```bash
+# Don't guess! Use view command to explore:
+
+# Check table structure
+abapgit-agent view --objects ZMY_TABLE --type TABL
+
+# Check structure components
+abapgit-agent view --objects ZMY_STRUCT --type STRU
+
+# Check class methods and interface
+abapgit-agent view --objects ZCL_UNKNOWN_CLASS
+
+# Check interface definition
+abapgit-agent view --objects ZIF_UNKNOWN_INTERFACE
+
+# Check data element type
+abapgit-agent view --objects ZMY_DTEL --type DTEL
+
+# JSON output for programmatic use
+abapgit-agent view --objects ZMY_TABLE --type TABL --json
+```
+
 ### CLI Tool Development
 
 1. Make changes to CLI code (JavaScript)

package/README.md

@@ -25,7 +25,7 @@ git clone https://github.com/user/abap-project.git
 cd abap-project
 
 # 3. Initialize configuration
-abapgit-agent init --folder /abap --package ZMY_PACKAGE
+abapgit-agent init --folder /abap/ --package ZMY_PACKAGE
 
 # 4. Edit .abapGitAgent with credentials
 
@@ -47,7 +47,7 @@ See [Creating New ABAP Projects](INSTALL.md#creating-new-abap-projects) to set u
 
 ```bash
 # Initialize local configuration for existing git repo
-abapgit-agent init --folder /abap --package ZMY_PACKAGE
+abapgit-agent init --folder /abap/ --package ZMY_PACKAGE
 
 # Create online repository in ABAP
 abapgit-agent create
@@ -94,6 +94,18 @@ abapgit-agent unit --files abap/zcl_my_test.clas.testclasses.abap
 abapgit-agent unit --files abap/zcl_test1.clas.testclasses.abap,abap/zcl_test2.clas.testclasses.abap
 ```
 
+### Explore Commands
+
+```bash
+# Display package hierarchy tree
+abapgit-agent tree --package $MY_PACKAGE
+
+# View object definitions from ABAP system (classes, interfaces, tables, data elements)
+abapgit-agent view --objects ZCL_MY_CLASS
+abapgit-agent view --objects SFLIGHT --type TABL
+abapgit-agent view --objects S_CARR_ID --type DTEL
+```
+
 ### Utility Commands
 
 ```bash
@@ -129,6 +141,8 @@ npm run pull -- --url <git-url> --branch main
 | pull Command | [docs/pull-command.md](docs/pull-command.md) |
 | inspect Command | [docs/inspect-command.md](docs/inspect-command.md) |
 | unit Command | [docs/unit-command.md](docs/unit-command.md) |
+| tree Command | [docs/tree-command.md](docs/tree-command.md) |
+| view Command | [docs/view-command.md](docs/view-command.md) |
 | REST API Reference | [API.md](API.md) |
 | Error Handling | [ERROR_HANDLING.md](ERROR_HANDLING.md) |
 | ABAP Coding Guidelines | [abap/CLAUDE.md](abap/CLAUDE.md) |

package/RELEASE_NOTES.md

@@ -1,14 +1,86 @@
-## What's New
+# Release Notes
+
+## v1.2.0
+
+### New Features
+
+#### tree Command
+Display package hierarchy tree from ABAP system:
+```bash
+# Basic usage
+abapgit-agent tree --package $MY_PACKAGE
+
+# With object counts
+abapgit-agent tree --package $MY_PACKAGE --include-objects
+
+# Limit depth
+abapgit-agent tree --package $MY_PACKAGE --depth 2
+
+# JSON output for scripting
+abapgit-agent tree --package $MY_PACKAGE --json
+```
+
+#### view Command
+View ABAP object definitions directly from ABAP system without pulling from git:
+
+```bash
+# View class definition
+abapgit-agent view --objects ZCL_MY_CLASS
+
+# View interface
+abapgit-agent view --objects ZIF_MY_INTERFACE
+
+# View table structure
+abapgit-agent view --objects SFLIGHT --type TABL
+
+# View data element
+abapgit-agent view --objects S_CARR_ID --type DTEL
+
+# View multiple objects
+abapgit-agent view --objects ZCL_CLASS1,ZIF_INTERFACE1,ZMY_TABLE
+
+# Auto-detect type from TADIR
+abapgit-agent view --objects SFLIGHT
+
+# JSON output for scripting
+abapgit-agent view --objects ZCL_MY_CLASS --json
+```
+
+**Supported Object Types:**
+- CLAS - Global ABAP class
+- INTF - Global interface
+- TABL - Database table
+- STRU - Structure type
+- DTEL - Data element
+
+### Improvements
+
+- **Auto-detection**: view command now queries TADIR to automatically detect object types (no need to specify `--type` for most objects)
+- **Lowercase support**: Object names and types are case-insensitive
+- **Error handling**: Non-existent objects now display clear error messages
+- **Cleaner output**: Removed AI metadata block from tree command output
+
+### Bug Fixes
+
+- Fixed non-existent object detection in view command
+- Fixed source code display for class/interface definitions
+- Fixed table and structure field display formatting
+- Fixed data element output with domain information
+
+### Documentation
+
+- Added comprehensive docs/tree-command.md
+- Added comprehensive docs/view-command.md
+- Updated README.md with tree and view command examples
+- Updated CLAUDE.md with view command usage for exploring ABAP objects
+
+---
+
+## v1.1.6
 
 - Added `create` command to create online repository in ABAP system
 - Added `import` command to import objects from ABAP package to git
 - Added unit tests for create and import commands
 - Added GitHub Actions workflow for automated npm releases
-- Improved .gitignore handling in init command (adds .abapGitAgent and cookies file)
+- Improved .gitignore handling in init command
 - Updated commands documentation
-
-## Installation
-
-```bash
-npm install -g abapgit-agent
-```

package/abap/CLAUDE.md

@@ -29,10 +29,10 @@ For quick ABAP code changes:
 
 ```bash
 # 1. Make small change to ABAP file
-# 2. Commit and push
+# 2. Commit and push to git
 git add abap/zcl_my_class.clas.abap
 git commit -m "fix: ..."
-git push
+git push    # CRITICAL: Push BEFORE pulling!
 
 # 3. Pull only changed file (seconds, not minutes)
 abapgit-agent pull --files abap/zcl_my_class.clas.abap
@@ -66,6 +66,51 @@ abapgit-agent inspect --files abap/zcl_my_class.clas.abap
 ```
 This will show detailed syntax errors including line numbers and error messages.
 
+## View ABAP Object Definitions
+
+Use the `view` command to inspect ABAP object definitions (classes, interfaces, tables, data elements) directly from the ABAP system. **Very useful when working with unfamiliar tables** - shows complete structure including fields, types, and descriptions.
+
+```bash
+# View a table definition
+abapgit-agent view --objects ZMY_TABLE --type TABL
+
+# View a data element definition
+abapgit-agent view --objects ZMY_DTEL --type DTEL
+
+# View a class definition
+abapgit-agent view --objects ZCL_MY_CLASS
+
+# View multiple objects
+abapgit-agent view --objects ZCL_CLASS1,ZCL_CLASS2,ZIF_INTERFACE1
+
+# JSON output for scripting
+abapgit-agent view --objects ZMY_TABLE --type TABL --json
+```
+
+**Table Output Example:**
+```
+TABLE ZCAIS_D1:
+|----------------+-----+----------------+----------+----------------+----------------------|
+| Field          | Key | Type           |   Length | Data Elem      | Description          |
+|----------------+-----+----------------+----------+----------------+----------------------|
+| CLIENT         | X   | CLNT           |        3 | MANDT          | Client               |
+| ID             | X   | NUMC           |        4 | NUMC4          | Count parameters     |
+| NAME           |     | CHAR           |       50 | CHAR50         | Comment              |
+|----------------+-----+----------------+----------+----------------+----------------------|
+```
+
+**Data Element Output Example:**
+```
+DATA ELEMENT ZMY_DTEL:
+|----------------+----------------+----------+----------------+----------------------|
+| Field          | Type           |   Length | Domain         | Description          |
+|----------------+----------------+----------+----------------+----------------------|
+| DOMAIN         | CHAR           |       20 | ZMY_DOMAIN     | Domain: ZMY_DOMAIN   |
+| DATA_TYPE      | CHAR           |       10 |                | ABAP Type: CHAR      |
+| LENGTH         | NUMC           |        5 |                | Length: 20           |
+|----------------+----------------+----------+----------------+----------------------|
+```
+
 ## JSON Handling - ALWAYS Use /ui2/cl_json
 
 **CRITICAL**: Always use `/ui2/cl_json` for JSON serialization and deserialization.
@@ -138,7 +183,16 @@ ENDCLASS.
 
 ## Creating New ABAP Objects - XML Metadata Required
 
-**IMPORTANT**: When creating new ABAP objects in abapGit format, you MUST create XML metadata files alongside the `.clas.abap` and `.intf.abap` files.
+**CRITICAL CHECKLIST - Never Forget!**
+
+When creating ANY new ABAP object file, you MUST also create its XML metadata file:
+
+| ABAP File | Required XML File |
+|-----------|------------------|
+| `zcl_my_class.clas.abap` | `zcl_my_class.clas.xml` |
+| `zif_my_intf.intf.abap` | `zif_my_intf.intf.xml` |
+
+**Without XML files**, abapGit will NOT recognize the objects during pull, and they won't be activated.
 
 ### XML Metadata Format for CLAS
 
@@ -184,15 +238,27 @@ For `zif_abgagt_util.intf.abap`, create `zif_abgagt_util.intf.xml`:
 </abapGit>
 ```
 
-**Without XML files**, abapGit will NOT recognize the objects during pull, and they won't be activated in the ABAP system.
+### Important Notes
+
+1. **CRITICAL: Push to git BEFORE pulling into ABAP**
+   - Always commit and push ABAP files to git first
+   - Then run `abapgit-agent pull` to activate in ABAP
+   - Never run `abapgit-agent pull` without pushing changes first
+
+2. **Only pull ABAP files** - The XML metadata stays in git:
+   ```bash
+   abapgit-agent pull --files zcl_my_class.clas.abap
+   ```
+2. abapGit reads the XML from git to deserialize the ABAP code
+3. XML files are NOT activated in ABAP - they are only for abapGit
 
 ```bash
 # After making changes to ABAP files
 git add .
 git commit -m "Describe changes"
-git push
+git push    # CRITICAL: Push BEFORE pulling
 
-# Validate in ABAP system (single file - fast)
+# Then validate in ABAP system (single file - fast)
 abapgit-agent pull --files abap/zcl_my_class.clas.abap
 
 # Or validate all files

package/abap/copilot-instructions.md

@@ -0,0 +1,51 @@
+# ABAP Development with abapGit
+
+You are working on an ABAP project using abapGit for version control.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `abapgit-agent pull` | Pull and activate all ABAP objects |
+| `abapgit-agent pull --files <file>` | Pull and activate specific file only |
+| `abapgit-agent inspect --files <file>` | Syntax check ABAP source |
+| `abapgit-agent unit --files <file>` | Run AUnit tests |
+
+## Key ABAP Rules
+
+1. **Global classes MUST use `PUBLIC`**:
+   ```abap
+   CLASS zcl_my_class DEFINITION PUBLIC.  " <- REQUIRED
+   ```
+
+2. **Use `/ui2/cl_json` for JSON**:
+   ```abap
+   DATA ls_data TYPE ty_request.
+   ls_data = /ui2/cl_json=>deserialize( json = lv_json ).
+   lv_json = /ui2/cl_json=>serialize( data = ls_response ).
+   ```
+
+3. **Test class name max 30 chars**: `ltcl_util` (not `ltcl_abgagt_util_test`)
+
+4. **Interface method implementation**: Use prefix `zif_interface~method_name`
+
+5. **abapGit files need XML metadata**: `.clas.xml`, `.intf.xml` alongside `.clas.abap`, `.intf.abap`
+
+## Workflow
+
+1. Edit ABAP file in `/abap/`
+2. `git add <file> && git commit -m "..." && git push`
+3. `abapgit-agent pull --files <file>` (seconds, not minutes)
+
+## Error Handling
+
+- Activation fails with "Error updating where-used list" = **syntax error**
+- Use `abapgit-agent inspect --files <file>` for detailed error messages
+
+## Object Naming
+
+| Pattern | Type |
+|---------|------|
+| `ZCL_*` | Class |
+| `ZIF_*` | Interface |
+| `Z*` | Other objects |

package/abap/zcl_abgagt_cmd_factory.clas.abap

@@ -27,6 +27,8 @@ CLASS zcl_abgagt_cmd_factory IMPLEMENTATION.
       ( command = zif_abgagt_command=>gc_unit   class_name = 'ZCL_ABGAGT_COMMAND_UNIT' )
       ( command = zif_abgagt_command=>gc_create class_name = 'ZCL_ABGAGT_COMMAND_CREATE' )
       ( command = zif_abgagt_command=>gc_import class_name = 'ZCL_ABGAGT_COMMAND_IMPORT' )
+      ( command = zif_abgagt_command=>gc_tree   class_name = 'ZCL_ABGAGT_COMMAND_TREE' )
+      ( command = zif_abgagt_command=>gc_view   class_name = 'ZCL_ABGAGT_COMMAND_VIEW' )
     ).
   ENDMETHOD.