abapgit-agent 1.2.0 → 1.4.0

package/CLAUDE.md

@@ -2,6 +2,36 @@
 
 This is the **abapgit-agent** CLI tool project - a Node.js application for pulling and activating ABAP code from git repositories.
 
+## Quick Reference
+
+```bash
+# Quick commands
+abapgit-agent pull                              # Pull and activate all
+abapgit-agent pull --files file.clas.abap      # Pull specific file(s)
+abapgit-agent inspect --files file.clas.abap    # Syntax check
+abapgit-agent unit --files test.clas.testclasses.abap  # Run tests
+abapgit-agent preview --objects TABLE           # Preview table data
+abapgit-agent view --objects OBJ               # View object definition
+abapgit-agent tree --package $PACKAGE          # Show package hierarchy
+```
+
+## Common Tasks
+
+**Making code changes:**
+```bash
+1. Edit ABAP file(s)
+2. git add && git commit && git push
+3. abapgit-agent pull --files file.clas.abap
+4. Check for errors in output
+5. If "Error updating where-used list" → use inspect for details
+```
+
+**Exploring unknown tables:**
+```bash
+abapgit-agent preview --objects SFLIGHT              # See sample data
+abapgit-agent view --objects SFLIGHT --type TABL    # See structure
+```
+
 ## Project Structure
 
 ```
@@ -83,6 +113,14 @@ 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
 
+# Preview table/CDS view data
+abapgit-agent preview --objects SFLIGHT
+abapgit-agent preview --objects ZC_MY_CDS_VIEW --type DDLS
+abapgit-agent preview --objects SFLIGHT --columns CARRID,CONNID,PRICE --limit 20
+abapgit-agent preview --objects SFLIGHT --where "CARRID = 'AA'"
+abapgit-agent preview --objects SFLIGHT --vertical
+abapgit-agent preview --objects SFLIGHT --compact
+
 # Health check
 abapgit-agent health
 
@@ -181,6 +219,75 @@ abapgit-agent health
 }
 ```
 
+## Inspect Command
+
+### Description
+Run syntax check for ABAP objects. Supports both regular ABAP objects (classes, interfaces, programs) and CDS views (DDLS).
+
+### Usage
+```bash
+# Inspect single file
+abapgit-agent inspect --files abap/zcl_my_class.clas.abap
+
+# Inspect multiple files
+abapgit-agent inspect --files abap/zcl_class1.clas.abap,abap/zcl_class2.clas.abap
+
+# Inspect CDS view
+abapgit-agent inspect --files abap/zc_my_view.ddls.asddls
+
+# Inspect mixed file types (DDLS + CLAS)
+abapgit-agent inspect --files abap/zc_my_view.ddls.asddls,abap/zcl_my_class.clas.abap
+```
+
+### Supported Object Types
+
+| Type | Description | Validation Method |
+|------|-------------|------------------|
+| CLAS | Class | Code Inspector (SCI) |
+| INTF | Interface | Code Inspector (SCI) |
+| PROG | Program | Code Inspector (SCI) |
+| FUGR | Function Group | Code Inspector (SCI) |
+| DDLS | CDS View/Entity | DDL Handler (CL_DD_DDL_HANDLER_FACTORY) |
+
+### Output
+
+**Passed:**
+```
+✅ CLAS ZCL_MY_CLASS - Syntax check passed
+```
+
+**With Warnings:**
+```
+⚠️  DDLS ZC_MY_VIEW - Syntax check passed with warnings (4):
+
+Warnings:
+────────────────────────────────────────────────────────────
+  Line 9 : ParentPackage
+  Line 11 : SoftwareComponent
+```
+
+**Failed:**
+```
+❌ DDLS ZC_MY_VIEW - Syntax check failed (1 error(s)):
+
+Errors:
+────────────────────────────────────────────────────────────
+  Line 21, Column 12: Error message text
+```
+
+### Key Behaviors
+
+1. **Multiple files in one request** - All files are sent in a single API call for better performance
+2. **CDS View validation** - Uses `CL_DD_DDL_HANDLER_FACTORY` to validate CDS views
+3. **Check inactive version first** - For CDS views, checks the inactive version first (`get_state = 'M'`), then falls back to active version
+4. **Detailed error messages** - Uses `get_errors()` and `get_warnings()` methods from the exception to get detailed information
+5. **Per-object results** - Returns results for each object individually
+
+### File Format
+Files are parsed to extract `(obj_type, obj_name)`:
+- `zcl_my_class.clas.abap` → CLAS, ZCL_MY_CLASS
+- `zc_my_view.ddls.asddls` → DDLS, ZC_MY_VIEW
+
 ## Unit Command
 
 ### Description
@@ -371,6 +478,9 @@ abapgit-agent view --objects ZMY_STRUCT --type STRU
 # View data element type information
 abapgit-agent view --objects ZMY_DTEL --type DTEL
 
+# View CDS view definition
+abapgit-agent view --objects ZC_MY_CDS_VIEW --type DDLS
+
 # View class interface and methods
 abapgit-agent view --objects ZCL_UNKNOWN_CLASS
 
@@ -378,6 +488,24 @@ abapgit-agent view --objects ZCL_UNKNOWN_CLASS
 abapgit-agent view --objects ZIF_UNKNOWN_INTERFACE
 ```
 
+### When to Use View Command
+
+AI assistant SHOULD call `view` command when:
+
+- User asks to "check", "look up", or "explore" an unfamiliar object
+- Working with a table/structure and you don't know the field names/types
+- Calling a class/interface method and you don't know the parameters
+- User provides an object name that may not exist in the git repository
+- You need to verify an object exists before using it
+
+**Example workflow:**
+```
+User: "Check if SFLIGHT table has a PRICE field"
+
+Assistant: <calls `abapgit-agent view --objects SFLIGHT --type TABL`>
+→ Shows table structure with all fields including PRICE
+```
+
 ### Usage
 ```bash
 # View single object (auto-detect type from TADIR)
@@ -401,29 +529,37 @@ abapgit-agent view --objects ZCL_MY_CLASS --json
 | 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 |
+| `--type` | No | Object type (CLAS, INTF, TABL, STRU, DTEL, TTYP, DDLS). Auto-detected from TADIR 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_* |
+| Type | Description |
+|------|-------------|
+| CLAS | Class |
+| INTF | Interface |
+| TABL | Table |
+| STRU | Structure |
+| DTEL | Data Element |
+| TTYP | Table Type |
+| DDLS | CDS View/Entity |
+
+**Note:** Object type is automatically detected from TADIR. Use `--type` only when you know the type and want to override auto-detection.
 
 ### Output
 
 **Human-readable:**
 ```
 📖 ZCL_MY_CLASS (Class)
-   My Custom Configuration Class
-   Methods: 3
-     - PUBLIC CONSTRUCTOR
-     - PUBLIC GET_CONFIG
-     - PUBLIC SET_CONFIG
+   Class ZCL_MY_CLASS in $PACKAGE
+
+CLASS zcl_my_class DEFINITION PUBLIC.
+
+  PUBLIC SECTION.
+    INTERFACES: zif_my_interface.
+    METHODS: constructor,
+      get_value RETURNING VALUE(rv_result) TYPE string.
+ENDCLASS.
 ```
 
 **JSON Output:**
@@ -431,20 +567,49 @@ abapgit-agent view --objects ZCL_MY_CLASS --json
 {
   "success": true,
   "command": "VIEW",
-  "message": "Retrieved 1 object(s)",
+  "message": "Retrieved object(s)",
   "objects": [
     {
       "name": "ZCL_MY_CLASS",
       "type": "CLAS",
       "type_text": "Class",
-      "description": "My Custom Configuration Class",
-      "methods": [...]
+      "description": "Class ZCL_MY_CLASS in $PACKAGE",
+      "source": "CLASS zcl_my_class DEFINITION PUBLIC...",
+      "not_found": false
     }
   ],
   "summary": { "total": 1 }
 }
 ```
 
+**Table Type Output:**
+```
+📖 ZMY_TTYP (Table Type)
+   Table Type ZMY_TTYP in $PACKAGE
+
+   Line Type: ZMY_STRUCTURE
+   Access Mode: STANDARD
+   Key Definition: WITH KEY
+```
+
+**CDS View Output:**
+```
+📖 ZC_MY_CDS_VIEW (CDS View)
+   CDS View ZC_MY_CDS_VIEW in $PACKAGE
+
+@AbapCatalog.sqlViewName: 'ZCMYVIEW'
+@AbapCatalog.compiler.compareFilter: true
+@AccessControl.authorizationCheck: #NOT_REQUIRED
+@EndUserText.label: 'My CDS View'
+define view ZC_MY_CDS_VIEW as select from tdevc
+{
+  key devclass as Devclass,
+      parentcl as ParentPackage,
+      ctext    as Description
+}
+where devclass not like '$%'
+```
+
 ### Error Handling
 
 | Error | Message |
@@ -452,6 +617,148 @@ abapgit-agent view --objects ZCL_MY_CLASS --json
 | Object not found | `Object <name> not found` |
 | Invalid object type | `Unsupported object type: <type>` |
 
+## Preview Command
+
+### Description
+Preview data from ABAP tables or CDS views directly from the ABAP system. This command retrieves sample data rows to help developers understand table/view contents without needing to query manually.
+
+**This is the PRIMARY way to explore table and CDS view DATA.**
+
+### Usage
+```bash
+# Preview table data (auto-detect type)
+abapgit-agent preview --objects SFLIGHT
+
+# Preview CDS view data
+abapgit-agent preview --objects ZC_MY_CDS_VIEW --type DDLS
+
+# Preview with explicit type
+abapgit-agent preview --objects SFLIGHT --type TABL
+
+# Preview with row limit
+abapgit-agent preview --objects SFLIGHT --limit 20
+
+# Preview with WHERE clause filter
+abapgit-agent preview --objects SFLIGHT --where "CARRID = 'AA'"
+
+# Preview specific columns only
+abapgit-agent preview --objects SFLIGHT --columns CARRID,CONNID,FLDATE,PRICE
+
+# Vertical format (for wide tables)
+abapgit-agent preview --objects SFLIGHT --vertical
+
+# JSON output (for scripting/AI processing)
+abapgit-agent preview --objects SFLIGHT --json
+```
+
+### Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--objects` | Yes | Comma-separated list of table/view names |
+| `--type` | No | Object type (TABL, DDLS). Auto-detected from TADIR if not specified |
+| `--limit` | No | Maximum rows to return (default: 10, max: 100) |
+| `--where` | No | WHERE clause filter (e.g., `CARRID = 'AA'`) |
+| `--columns` | No | Comma-separated column names to display |
+| `--vertical` | No | Show data in vertical format (one field per line) |
+| `--compact` | No | Truncate values to fit columns |
+| `--json` | No | Output raw JSON only |
+
+### Output
+
+**Default (first 6 columns shown with indicator):**
+```
+📊 Preview: SFLIGHT (Table)
+
+┌──────────┬────────┬──────────┬───────────┬─────────┬─────────┐
+│ CARRID   │ CONNID │ FLDATE   │ PRICE     │ CURRENCY│ PLANETYPE│
+├──────────┼────────┼──────────┼───────────┼─────────┼─────────┤
+│ AA       │ 0017   │ 20240201 │    422.94 │ USD     │ 747-400 │
+│ AA       │ 0017   │ 20240202 │    422.94 │ USD     │ 747-400 │
+└──────────┴────────┴──────────┴───────────┴─────────┴─────────┘
+
+Showing 2 of 10 rows
+⚠️  Note: 3 more columns hidden (SEATSMAX, SEATSOCC, PAYMENTSUM)
+   Use --columns to select specific columns
+   Use --json for full data
+```
+
+**With WHERE Filter:**
+```
+📊 Preview: SFLIGHT (filtered)
+
+┌──────────┬────────┬──────────┬─────────┐
+│ CARRID   │ CONNID │ FLDATE   │ PRICE   │
+├──────────┼────────┼──────────┼─────────┤
+│ AA       │ 0017   │ 20240201 │  422.94 │
+│ AA       │ 0017   │ 20240202 │  422.94 │
+└──────────┴────────┴──────────┴─────────┘
+
+WHERE: CARRID = 'AA'
+```
+
+**Vertical Format (for wide tables):**
+```
+📊 Preview: SFLIGHT (1 of 10 rows, vertical)
+
+Row 1:
+────────────────────────────────────────────────────────────
+  CARRID:      AA
+  CONNID:      0017
+  FLDATE:      20240201
+  PRICE:       422.94
+  CURRENCY:    USD
+  PLANETYPE:   747-400
+  SEATSMAX:    400
+  SEATSOCC:    350
+  PAYMENTSUM:  145000
+────────────────────────────────────────────────────────────
+```
+
+### JSON Output
+```json
+{
+  "SUCCESS": true,
+  "COMMAND": "PREVIEW",
+  "OBJECTS": [
+    {
+      "NAME": "SFLIGHT",
+      "TYPE": "TABL",
+      "TYPE_TEXT": "Table",
+      "ROW_COUNT": 2,
+      "TOTAL_ROWS": 10,
+      "ROWS": [
+        { "CARRID": "AA", "CONNID": "0017", "FLDATE": "20240201", "PRICE": "422.94", ... }
+      ],
+      "FIELDS": [
+        { "FIELD": "CARRID", "TYPE": "CHAR", "LENGTH": 3 },
+        { "FIELD": "PRICE", "TYPE": "CURR", "LENGTH": 16 }
+      ],
+      "COLUMNS_DISPLAYED": 6,
+      "COLUMNS_HIDDEN": ["SEATSMAX", "SEATSOCC", "PAYMENTSUM"]
+    }
+  ],
+  "SUMMARY": { "TOTAL_OBJECTS": 1, "TOTAL_ROWS": 2 },
+  "ERROR": ""
+}
+```
+
+### Error Handling
+
+| Error | Message |
+|-------|---------|
+| Table not found | `Table not found: Z_NONEXISTENT` |
+| CDS View not found | `CDS View not found: Z_NONEXISTENT` |
+| Access denied | `Access denied to table: SFLIGHT` |
+| Invalid WHERE clause | `Invalid WHERE clause: <reason>` |
+
+### Auto-Detection Rules
+
+| Object Name Pattern | Default Type |
+|---------------------|--------------|
+| `ZC_*` or `zc_*` | DDLS (CDS View) |
+| Other | TABL (Table) |
+
 ## Status Check
 
 ### Description
@@ -515,10 +822,37 @@ export GIT_USERNAME="git-username"
 export GIT_PASSWORD="git-token"
 ```
 
+## Troubleshooting
+
+**Pull fails with "Error updating where-used list":**
+- This means SYNTAX ERROR in the object
+- Run `abapgit-agent inspect --files <file>` for detailed errors
+
+**Pull shows "Failed Objects" > 0:**
+- Objects failed to activate - check the error messages
+- Fix syntax errors and pull again
+
+**Preview/View command fails:**
+- Check table/view exists in the ABAP system
+- Verify credentials in `.abapGitAgent`
+
+**"Table or view not found":**
+- Table may not exist or may have different name
+- Use `view` command to check available tables
+
+**Terminal width issues with preview:**
+- Use `--columns` to specify exact columns
+- Use `--vertical` for wide tables
+
 ## Development Workflow
 
 ### Exploring Unknown ABAP Objects
 
+**Check package structure:**
+```bash
+abapgit-agent tree --package $MY_PACKAGE
+```
+
 **Before working with an unfamiliar table, structure, class, or interface:**
 
 ```bash
@@ -573,6 +907,10 @@ For quick ABAP code changes:
 4. Verify activation results
 5. Repeat until done
 
+## Creating CDS Views
+
+For guidelines on creating CDS views and CDS view entities, see **ABAP Code Generation** below.
+
 ## For ABAP Code Generation
 
 **NOTE**: This file is for developing the CLI tool itself. For guidelines on **generating ABAP code** for abapGit repositories, see `/abap/CLAUDE.md`. Copy that file to your ABAP repository root when setting up new projects.

package/INSTALL.md

@@ -12,17 +12,12 @@ Claude (VS Code) → CLI Tool → ABAP System (REST/HTTP)
 
 ### ABAP Side - REST Implementation
 
-| File | Type | Description |
-|------|------|-------------|
-| `zif_abgagt_agent.intf.abap` | Interface | Type definitions and method signatures |
-| `zcl_abgagt_agent.clas.abap` | Class | Main agent with `pull`, `inspect`, `run_tests` methods |
-| `zcl_abgagt_rest_handler.clas.abap` | Class | REST router for endpoints |
-| `zcl_abgagt_resource_pull.clas.abap` | Class | POST /pull handler |
-| `zcl_abgagt_resource_inspect.clas.abap` | Class | POST /inspect handler |
-| `zcl_abgagt_resource_unit.clas.abap` | Class | POST /unit handler |
-| `zcl_abgagt_resource_health.clas.abap` | Class | GET /health handler |
-
-**Note:** Error details are returned directly in the REST response via `error_detail` field.
+The ABAP backend consists of:
+- **Main agent** - Core logic for pull, inspect, unit operations
+- **REST handler** - Routes HTTP requests to appropriate resources
+- **Resource handlers** - Individual endpoints (/pull, /inspect, /unit, /tree, /view, /preview, /health)
+
+Deploy all ABAP objects using abapGit from the `/abap` folder.
 
 ### CLI Tool (Node.js)
 - REST client for ABAP communication

package/README.md

@@ -104,6 +104,15 @@ abapgit-agent tree --package $MY_PACKAGE
 abapgit-agent view --objects ZCL_MY_CLASS
 abapgit-agent view --objects SFLIGHT --type TABL
 abapgit-agent view --objects S_CARR_ID --type DTEL
+
+# Preview table or CDS view data
+abapgit-agent preview --objects SFLIGHT
+abapgit-agent preview --objects ZC_MY_CDS_VIEW --type DDLS
+abapgit-agent preview --objects SFLIGHT --limit 20
+abapgit-agent preview --objects SFLIGHT --where "CARRID = 'AA'"
+abapgit-agent preview --objects SFLIGHT --columns CARRID,CONNID,PRICE
+abapgit-agent preview --objects SFLIGHT --vertical
+abapgit-agent preview --objects SFLIGHT --compact
 ```
 
 ### Utility Commands
@@ -143,6 +152,7 @@ npm run pull -- --url <git-url> --branch main
 | 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) |
+| preview Command | [docs/preview-command.md](docs/preview-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,5 +1,62 @@
 # Release Notes
 
+## v1.4.0
+
+### New Features
+
+#### preview Command
+Preview data from ABAP tables or CDS views directly from the ABAP system:
+
+```bash
+# Preview table data (auto-detect type)
+abapgit-agent preview --objects SFLIGHT
+
+# Preview CDS view data
+abapgit-agent preview --objects ZC_MY_CDS_VIEW --type DDLS
+
+# Preview with row limit
+abapgit-agent preview --objects SFLIGHT --limit 20
+
+# Preview with WHERE clause filter
+abapgit-agent preview --objects SFLIGHT --where "CARRID = 'AA'"
+
+# Preview specific columns only
+abapgit-agent preview --objects SFLIGHT --columns CARRID,CONNID,PRICE
+
+# Vertical format (for wide tables)
+abapgit-agent preview --objects SFLIGHT --vertical
+
+# Compact mode (truncated values)
+abapgit-agent preview --objects SFLIGHT --compact
+
+# JSON output
+abapgit-agent preview --objects SFLIGHT --json
+```
+
+### Documentation
+
+- Added comprehensive docs/preview-command.md
+- Updated API.md with /preview endpoint
+- Updated IMPLEMENTATION_PLAN.md with tree, view, preview commands
+- Simplified INSTALL.md ABAP components section
+- Updated README.md with preview command examples
+- Improved CLAUDE.md files with best practices
+
+---
+
+## v1.3.0
+
+### New Features
+
+- **view Command**: Now supports TTYP (Table Type) and DDLS (CDS View)
+
+### Bug Fixes
+
+- Fixed CDS view source display in view command
+- Fixed interface exception handling
+
+---
+
 ## v1.2.0
 
 ### New Features