abapgit-agent 1.5.0 → 1.6.0

package/abap/zif_abgagt_cmd_factory.intf.xml

@@ -1,15 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<abapGit version="v1.0.0" serializer="LCL_OBJECT_INTF" serializer_version="v1.0.0">
- <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
-  <asx:values>
-   <VSEOINTERF>
-    <CLSNAME>ZIF_ABGAGT_CMD_FACTORY</CLSNAME>
-    <LANGU>E</LANGU>
-    <DESCRIPT>Command Factory Interface for ABAP Git Agent</DESCRIPT>
-    <EXPOSURE>2</EXPOSURE>
-    <STATE>1</STATE>
-    <UNICODE>X</UNICODE>
-   </VSEOINTERF>
-  </asx:values>
- </asx:abap>
-</abapGit>

package/abap/zif_abgagt_command.intf.abap

@@ -1,26 +0,0 @@
-"* Use this source text module for the interface definition
-"! <p class="shorttext synchronized">Command Interface for ABAP Git Agent</p>
-INTERFACE zif_abgagt_command PUBLIC.
-
-  CONSTANTS:
-    gc_pull TYPE string VALUE 'PULL',
-    gc_inspect TYPE string VALUE 'INSPECT',
-    gc_unit TYPE string VALUE 'UNIT',
-    gc_create TYPE string VALUE 'CREATE',
-    gc_import TYPE string VALUE 'IMPORT',
-    gc_tree TYPE string VALUE 'TREE',
-    gc_view TYPE string VALUE 'VIEW',
-    gc_preview TYPE string VALUE 'PREVIEW'.
-
-  " Get command name
-  METHODS get_name
-    RETURNING VALUE(rv_name) TYPE string.
-
-  " Execute command with optional parameters
-  " @parameter is_param | Generic parameters (structure varies by command)
-  " @parameter rv_result | JSON result string
-  METHODS execute
-    IMPORTING is_param TYPE data OPTIONAL
-    RETURNING VALUE(rv_result) TYPE string.
-
-ENDINTERFACE.

package/abap/zif_abgagt_command.intf.xml

@@ -1,15 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<abapGit version="v1.0.0" serializer="LCL_OBJECT_INTF" serializer_version="v1.0.0">
- <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
-  <asx:values>
-   <VSEOINTERF>
-    <CLSNAME>ZIF_ABGAGT_COMMAND</CLSNAME>
-    <LANGU>E</LANGU>
-    <DESCRIPT>Command Interface for ABAP Git Agent</DESCRIPT>
-    <EXPOSURE>2</EXPOSURE>
-    <STATE>1</STATE>
-    <UNICODE>X</UNICODE>
-   </VSEOINTERF>
-  </asx:values>
- </asx:abap>
-</abapGit>

package/abap/zif_abgagt_util.intf.abap

@@ -1,28 +0,0 @@
-"* Use this source text module for the interface definition
-"! <p class="shorttext synchronized">Utility Interface for ABAP Git Agent</p>
-INTERFACE zif_abgagt_util PUBLIC.
-
-  "! Parse file name to extract object type and name
-  "! @parameter iv_file | File name (e.g., 'zcl_my_class.clas.abap')
-  "! @parameter ev_obj_type | Object type (e.g., 'CLAS')
-  "! @parameter ev_obj_name | Object name (e.g., 'ZCL_MY_CLASS')
-  METHODS parse_file_to_object
-    IMPORTING
-      iv_file TYPE string
-    EXPORTING
-      ev_obj_type TYPE string
-                ev_obj_name TYPE string.
-
-  "! Check activation log for errors
-  "! @return rv_has_error | ABAP_TRUE if errors found
-  METHODS check_log_for_errors
-    RETURNING
-      VALUE(rv_has_error) TYPE abap_bool.
-
-  "! Get detailed log information
-  "! @return rv_detail | Detailed log message
-  METHODS get_log_detail
-    RETURNING
-      VALUE(rv_detail) TYPE string.
-
-ENDINTERFACE.

package/abap/zif_abgagt_util.intf.xml

@@ -1,15 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<abapGit version="v1.0.0" serializer="LCL_OBJECT_INTF" serializer_version="v1.0.0">
- <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
-  <asx:values>
-   <VSEOINTERF>
-    <CLSNAME>ZIF_ABGAGT_UTIL</CLSNAME>
-    <LANGU>E</LANGU>
-    <DESCRIPT>Utility Interface for ABAP Git Agent</DESCRIPT>
-    <EXPOSURE>2</EXPOSURE>
-    <STATE>1</STATE>
-    <UNICODE>X</UNICODE>
-   </VSEOINTERF>
-  </asx:values>
- </asx:abap>
-</abapGit>

package/abap/zif_abgagt_viewer.intf.abap

@@ -1,12 +0,0 @@
-*"* Use this source text module for the interface definition
-INTERFACE zif_abgagt_viewer PUBLIC.
-
-  " Get detailed information about an ABAP object
-  " @parameter iv_name | Object name (e.g., ZCL_MY_CLASS)
-  " @parameter rs_info | Object information structure
-  METHODS get_info
-    IMPORTING iv_name        TYPE string
-    RETURNING VALUE(rs_info) TYPE zcl_abgagt_command_view=>ty_view_object
-    RAISING   cx_dd_ddl_read.
-
-ENDINTERFACE.

package/abap/zif_abgagt_viewer.intf.xml

@@ -1,15 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<abapGit version="v1.0.0" serializer="LCL_OBJECT_INTF" serializer_version="v1.0.0">
- <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
-  <asx:values>
-   <VSEOINTERF>
-    <CLSNAME>ZIF_ABGAGT_VIEWER</CLSNAME>
-    <LANGU>E</LANGU>
-    <DESCRIPT>Viewer Interface for ABAP Object Types</DESCRIPT>
-    <EXPOSURE>2</EXPOSURE>
-    <STATE>1</STATE>
-    <UNICODE>X</UNICODE>
-   </VSEOINTERF>
-  </asx:values>
- </asx:abap>
-</abapGit>

package/docs/commands.md

@@ -1,142 +0,0 @@
-# Commands Overview
-
-All available CLI commands for abapGit Agent.
-
-## Command Reference
-
-| Command | Status | Description |
-|---------|--------|-------------|
-| [init](init-command.md) | ✅ | Initialize local configuration |
-| [create](create-command.md) | ✅ | Create online repository in ABAP |
-| [import](import-command.md) | ✅ | Import objects from ABAP package to git |
-| [pull](pull-command.md) | ✅ | Pull and activate objects in ABAP |
-| [inspect](inspect-command.md) | ✅ | Syntax check ABAP source files |
-| [tree](tree-command.md) | ✅ | Display package hierarchy tree |
-| [unit](unit-command.md) | ✅ | Run AUnit tests |
-| [view](view-command.md) | ✅ | View ABAP object source code from system |
-| [preview](preview-command.md) | 🔄 | Preview table/CDS view data |
-| [health](health-command.md) | ✅ | Health check |
-| [status](status-command.md) | ✅ | Status check |
-
----
-
-## Quick Start
-
-### New Project Setup
-
-```bash
-# 1. Initialize local configuration
-abapgit-agent init --folder /src/ --package ZMY_PACKAGE
-
-# 2. Edit .abapGitAgent with credentials
-vim .abapGitAgent
-
-# 3. Commit and push new files to git
-git add . && git commit -m "Initial commit" && git push origin main
-
-# 4. Create online repository in ABAP
-abapgit-agent create
-
-# 5. Import objects from ABAP package to git
-abapgit-agent import
-
-# 6. Pull new objects imported from ABAP package
-git pull origin main
-
-# 7. Activate in ABAP
-abapgit-agent pull
-```
-
----
-
-## Daily Development
-
-```bash
-# Pull changes from git and activate in ABAP (auto-detects git remote)
-abapgit-agent pull
-
-# Pull specific files only (faster for small changes)
-abapgit-agent pull --files abap/zcl_my_class.clas.abap
-
-# Syntax check before commit
-abapgit-agent inspect --files abap/zcl_my_class.clas.abap
-
-# Run unit tests
-abapgit-agent unit --files abap/zcl_my_test.clas.testclasses.abap
-
-# Display package hierarchy
-abapgit-agent tree --package $MY_PACKAGE
-
-# View object definitions (classes, interfaces, tables, data elements)
-abapgit-agent view --objects ZCL_MY_CLASS
-abapgit-agent view --objects SFLIGHT --type TABL
-
-# Preview table/CDS view data
-abapgit-agent preview --objects SFLIGHT
-abapgit-agent preview --objects ZC_MY_CDS_VIEW --type DDLS
-
-# Check configuration
-abapgit-agent status
-
-# Verify ABAP connection
-abapgit-agent health
-```
-
----
-
-## Command Workflow
-
-```
-┌─────────────────────────────────────────────────┐
-│  init                                           │
-│  └── Creates .abapGitAgent, CLAUDE.md, /src/   │
-└─────────────────────────────────────────────────┘
-                        │
-                        ▼
-┌─────────────────────────────────────────────────┐
-│  git add && git commit && git push              │
-│  └── Push initial files to git                  │
-└─────────────────────────────────────────────────┘
-                        │
-                        ▼
-┌─────────────────────────────────────────────────┐
-│  create                                         │
-│  └── Creates online repo in ABAP               │
-└─────────────────────────────────────────────────┘
-                        │
-                        ▼
-┌─────────────────────────────────────────────────┐
-│  import                                         │
-│  └── Stages, commits, pushes objects to git    │
-└─────────────────────────────────────────────────┘
-                        │
-                        ▼
-┌─────────────────────────────────────────────────┐
-│  git pull                                       │
-│  └── Pull imported objects from ABAP package   │
-└─────────────────────────────────────────────────┘
-                        │
-                        ▼
-┌─────────────────────────────────────────────────┐
-│  pull                                          │
-│  └── Activates objects in ABAP                  │
-└─────────────────────────────────────────────────┘
-```
-
----
-
-## Common Options
-
-### Global Parameters
-
-All commands read configuration from:
-- `.abapGitAgent` file in current directory
-- Environment variables (`ABAP_HOST`, `ABAP_USER`, etc.)
-
-### File Patterns
-
-| Pattern | Description |
-|---------|-------------|
-| `zcl_my_class.clas.abap` | ABAP class source |
-| `zif_my_intf.intf.abap` | ABAP interface source |
-| `zcl_my_test.clas.testclasses.abap` | ABAP test class |

package/docs/create-command.md

@@ -1,129 +0,0 @@
-# create Command
-
-Create a new abapGit online repository in the ABAP system.
-
-## Command
-
-```bash
-abapgit-agent create
-```
-
-## Prerequisite
-
-- `init` command has been run successfully
-- `.abapGitAgent` file exists with credentials (host, user, password, gitUsername, gitPassword)
-- Current folder is git repo root
-
-## What It Does
-
-1. **Detect git remote** - Gets URL from `git remote get-url origin`
-2. **Get package** - Reads from `.abapGitAgent`
-3. **Get folder** - Reads from `.abapGitAgent` (default: `/src/`)
-4. **Create repository** - Calls ABAP REST API to create online repository
-5. **Set starting folder** - Configures the folder path in repository settings
-
-## Parameters
-
-None. The command auto-detects all settings from:
-- Git remote URL
-- `.abapGitAgent` configuration
-
-## Output
-
-### Success
-
-```
-🚀 Creating online repository
-   URL: https://github.com/org/repo.git
-   Package: AUD_TAG
-   Folder: /abap/
-   Name: abgagt-import
-   Branch: main
-
-
-✅ Repository created successfully!
-   URL: https://github.com/org/repo.git
-   Package: AUD_TAG
-   Name: abgagt-import
-
-Next steps:
-   abapgit-agent import
-```
-
-### Error - Repository Already Exists
-
-```
-❌ Failed to create repository
-   Error: Repository already exists
-```
-
-### Error - Missing Configuration
-
-```
-❌ Failed to create repository
-   Error: Package not configured
-```
-
-## Post-Create Steps
-
-After creating the repository:
-
-```bash
-# Import objects from ABAP package to git
-abapgit-agent import
-
-# Push to git
-git push origin main
-
-# Activate in ABAP
-abapgit-agent pull
-```
-
-## Full Workflow
-
-```
-1. abapgit-agent init --folder /src/ --package ZMY_PACKAGE
-   └─> Creates .abapGitAgent, CLAUDE.md, /src/, updates .gitignore
-
-2. Edit .abapGitAgent (host, user, password, gitUsername, gitPassword)
-
-3. abapgit-agent create
-   └─> Creates online repository in ABAP
-
-4. abapgit-agent import
-   └─> Stages, commits, and pushes all objects from ZMY_PACKAGE
-
-5. git pull
-   └─> Optionally pull to local folder
-
-6. abapgit-agent pull
-   └─> Activate objects in ABAP
-```
-
-## Example
-
-```bash
-# Initialize
-abapgit-agent init --folder /src/ --package ZMYPROJECT
-
-# Edit config
-vim .abapGitAgent
-
-# Create repo in ABAP
-abapgit-agent create
-
-# Import objects to git
-abapgit-agent import
-
-# Pull to local folder
-git pull origin main
-
-# Activate in ABAP
-abapgit-agent pull
-```
-
-## Related Commands
-
-- [`init`](init-command.md) - Initialize local configuration
-- [`import`](import-command.md) - Import objects from package to git
-- [`pull`](pull-command.md) - Pull and activate objects in ABAP

package/docs/health-command.md

@@ -1,89 +0,0 @@
-# health Command Requirements
-
-## Overview
-
-Check if the ABAP REST API is healthy and accessible.
-
-## Command
-
-```bash
-abapgit-agent health
-```
-
-## Prerequisite
-
-- `.abapGitAgent` file exists with valid credentials, or environment variables are set
-
-## Tasks
-
-### 1. Load Configuration
-
-Read from `.abapGitAgent` or environment variables:
-- `host`
-- `sapport`
-- `client`
-- `user`
-- `password`
-- `language`
-
-### 2. Make Health Check Request
-
-**Endpoint:** `GET /health`
-
-**Response:**
-```json
-{
-  "status": "healthy",
-  "abap": "connected",
-  "version": "1.0.0"
-}
-```
-
-### 3. Display Result
-
-```bash
-$ abapgit-agent health
-{
-  "status": "healthy",
-  "abap": "connected",
-  "version": "1.0.0"
-}
-```
-
----
-
-## Output
-
-| Status | Output |
-|--------|--------|
-| Healthy | JSON response with status |
-| Error | Error message with details |
-
----
-
-## Error Handling
-
-| Error | Message |
-|-------|---------|
-| Connection failed | `Health check failed: <error message>` |
-| Invalid credentials | Authentication error |
-
----
-
-## Example
-
-```bash
-# Check health
-abapgit-agent health
-
-# Output
-{
-  "status": "healthy",
-  "abap": "connected",
-  "version": "1.0.0"
-}
-```
-
-## Used By
-
-- `create` command - validates ABAP connection before creating repo

package/docs/import-command.md

@@ -1,195 +0,0 @@
-# import Command
-
-Import existing ABAP objects from a package into an existing abapGit online repository.
-
-## Command
-
-```bash
-abapgit-agent import
-abapgit-agent import --message "Your commit message"
-```
-
-## Prerequisites
-
-- Repository already exists in ABAP (created via abapGit UI or `create` command)
-- Package has objects to import
-- GitHub credentials configured in `.abapGitAgent`
-
-## Parameters
-
-| Parameter | Required | Default | Description |
-|-----------|----------|---------|-------------|
-| `--message` | No | `feat: initial import from ABAP package <package>` | Commit message |
-| `--help` | No | - | Show help |
-
-## Configuration
-
-### .abapGitAgent
-
-Add GitHub credentials to `.abapGitAgent`:
-
-```json
-{
-  "gitUsername": "<your-github-username>",
-  "gitPassword": "ghp_your_github_token"
-}
-```
-
-### Environment Variables
-
-```bash
-export GIT_USERNAME="<your-github-username>"
-export GIT_PASSWORD="ghp_your_github_token"
-```
-
-### GitHub Personal Access Token
-
-1. Create a PAT at:
-   - GitHub.com: https://github.com/settings/tokens
-
-2. Select scopes:
-   - `repo` - Full control of private repositories
-   - Or `public_repo` if your repo is public
-
-## How It Works
-
-1. **Validate** - Check repository URL exists
-2. **Find Repo** - Locate abapGit repository by git URL
-3. **Configure Credentials** - Set git credentials from config
-4. **Refresh** - Get latest local files from package
-5. **Stage** - Create stage with all files
-6. **Commit** - Commit with message
-7. **Push** - Push to remote
-
-## Workflow
-
-### Full Development Cycle
-
-```
-1. Develop in ABAP (SAP GUI, ADT)
-   └─> Create/modify objects in package
-
-2. abapgit-agent import
-   └─> Stages, commits, and pushes to git
-
-3. git pull (optional, in local repo)
-   └─> Get files to local folder
-
-4. Repeat
-```
-
-## Output
-
-### Success
-
-```
-✅ Objects imported successfully!
-   Files staged: 27
-   Commit: feat: initial import from ABAP package AUD_TAG
-```
-
-### With Custom Message
-
-```
-✅ Objects imported successfully!
-   Files staged: 15
-   Commit: My custom import message
-```
-
-### Error - Repository Not Found
-
-```
-❌ Import failed
-   Error: Repository not found. Run "abapgit-agent create" or create in abapGit UI first.
-```
-
-### Error - No Objects Found
-
-```
-❌ Import failed
-   Error: No objects found in package ZMY_PACKAGE
-```
-
-### Error - GitHub Credentials
-
-```
-❌ Import failed
-   Error: Unauthorized access to resource (HTTP 401)
-```
-
-## Troubleshooting
-
-### HTTP 401 Unauthorized
-
-GitHub credentials not configured or invalid:
-
-1. Create a GitHub Personal Access Token
-2. Add to `.abapGitAgent`:
-
-```json
-{
-  "gitUsername": "<your-github-username>",
-  "gitPassword": "ghp_your_token"
-}
-```
-
-### Repository Not Found
-
-The repository must exist in abapGit:
-
-1. Run `abapgit-agent create` to create it, OR
-2. Create manually in abapGit UI: https://<sap>/sap/bc/zabapgit
-
-### No Objects Found
-
-The package may be empty or objects not yet created:
-
-1. Verify package in SAP GUI: `SE21` → Display Package
-2. Ensure objects exist in the package
-
-## Full Workflow
-
-### Option 1: abapgit-agent (Recommended)
-
-```bash
-# Initialize
-abapgit-agent init --folder /abap --package ZMYPROJECT
-
-# Edit config
-vim .abapGitAgent
-
-# Create repository
-abapgit-agent create
-
-# Develop objects in ABAP...
-
-# Import objects to git
-abapgit-agent import
-
-# Pull to local folder
-git pull origin main
-```
-
-### Option 2: abapGit UI for Creation
-
-```bash
-# Initialize
-abapgit-agent init --folder /abap --package ZMYPROJECT
-
-# Edit config
-vim .abapGitAgent
-
-# Create repository in abapGit UI
-# https://<sap>/sap/bc/zabapgit → New → Online → Enter git URL
-
-# Develop objects in ABAP...
-
-# Import objects to git
-abapgit-agent import
-```
-
-## Related Commands
-
-- [`init`](init-command.md) - Initialize local configuration
-- [`create`](create-command.md) - Create online repository in ABAP
-- [`pull`](pull-command.md) - Pull and activate objects in ABAP