abapgit-agent 1.5.0 → 1.6.1

package/docs/pull-command.md

@@ -1,202 +0,0 @@
-# pull Command Requirements
-
-## Overview
-
-Pull and activate ABAP objects from git repository.
-
-## Command
-
-```bash
-# Auto-detect git remote and branch from current directory
-abapgit-agent pull
-
-# Pull specific files only (fast)
-abapgit-agent pull --files zcl_my_class.clas.abap,zcl_other.clas.abap
-
-# Pull from specific branch
-abapgit-agent pull --branch develop
-
-# Pull from specific URL
-abapgit-agent pull --url https://github.com/org/repo.git
-
-# With transport request
-abapgit-agent pull --transport DEVK900001
-
-# Combined options
-abapgit-agent pull --branch develop --files src/zcl_my_class.clas.abap --transport DEVK900001
-
-# Using transport from config/environment (no --transport flag needed)
-abapgit-agent pull
-```
-
-## Prerequisite
-
-- Current folder is git repo root (unless `--url` specified)
-- Git remote is configured (unless `--url` specified)
-- `.abapGitAgent` exists with valid credentials
-
-## Parameters
-
-| Parameter | Required | Description |
-|-----------|----------|-------------|
-| `--url` | No | Git repository URL (auto-detected if not specified) |
-| `--branch` | No | Branch name (default: current branch) |
-| `--files` | No | Comma-separated list of files to pull |
-| `--transport` | No | Transport request (config/env takes priority if not specified) |
-
-## Transport Request Precedence
-
-The transport request is determined in this order:
-
-| Priority | Source | Example |
-|----------|--------|---------|
-| 1 | CLI `--transport` argument | `--transport DEVK900001` |
-| 2 | Config file `transport` | `"transport": "DEVK900001"` in `.abapGitAgent` |
-| 3 | Environment variable `ABAP_TRANSPORT` | `export ABAP_TRANSPORT="DEVK900001"` |
-| 4 (default) | Not set | abapGit creates/uses default |
-
----
-
-## Tasks
-
-### 1. Detect Git Remote URL
-
-```bash
-git remote get-url origin
-```
-
-### 2. Detect Current Branch
-
-```bash
-git branch --show-current
-```
-
-Or from `.git/HEAD`
-
-### 3. Load Configuration
-
-Read `.abapGitAgent` for credentials
-
-### 4. Fetch CSRF Token
-
-```bash
-GET /health (with X-CSRF-Token: fetch)
-```
-
-### 5. Make Pull Request
-
-**Endpoint:** `POST /pull`
-
-**Request Body:**
-```json
-{
-  "url": "https://github.com/org/repo.git",
-  "branch": "main",
-  "username": "git-user",
-  "password": "git-token",
-  "files": ["zcl_my_class.clas.abap"],
-  "transport_request": "DEVK900001"
-}
-```
-
-### 6. Display Results
-
----
-
-## Output
-
-### Success
-
-```
-✅ Pull completed successfully!
-   Job ID: CAIS20260208115649
-   Message: Pull completed successfully
-
-📋 Pull Log (N messages):
-────────────────────────────────────────────────────────────────────────────────
-Icon │Object                      │Message
-─────┼────────────────────────────┼─────────────────────────────────────────
-✅   │CLAS ZCL_MY_CLASS          │Object ZCL_MY_CLASS imported
-...
-
-📦 Activated Objects (N):
-────────────────────────────────────────────────────────────────────────────────
-✅ CLAS ZCL_MY_CLASS
-...
-```
-
-### With Errors
-
-```
-❌ Pull completed with errors!
-   Job ID: CAIS20260208115649
-   Message: Pull completed with errors
-
-📋 Error Details:
-────────────────────────────────────────────────────────────────────────────────
-CLAS ZCL_MY_CLASS: Error updating where-used list
-
-📋 Pull Log (N messages):
-...
-
-❌ Failed Objects Log (M entries):
-────────────────────────────────────────────────────────────────────────────────
-❌ CLAS ZCL_MY_CLASS: Error message text
-Exception: Exception details
-```
-
----
-
-## File Format
-
-Files are parsed to extract `(obj_type, obj_name)`:
-
-| File Pattern | Object Type | Object Name |
-|--------------|-------------|-------------|
-| `zcl_my_class.clas.abap` | CLAS | ZCL_MY_CLASS |
-| `zif_my_intf.intf.abap` | INTF | ZIF_MY_INTF |
-| `src/zcl_my_class.clas.abap` | CLAS | ZCL_MY_CLASS |
-
----
-
-## Response Structure
-
-```json
-{
-  "success": "X",
-  "job_id": "CAIS20260208115649",
-  "message": "Pull completed successfully",
-  "activated_count": 15,
-  "failed_count": 1,
-  "activated_objects": [
-    { "obj_type": "CLAS", "obj_name": "ZCL_MY_CLASS" }
-  ],
-  "failed_objects": [
-    { "obj_type": "CLAS", "obj_name": "ZCL_OTHER", "text": "Error message" }
-  ],
-  "log_messages": [...]
-}
-```
-
----
-
-## Key Behaviors
-
-1. **Activated Objects** - Only includes objects that completed successfully (no errors in log)
-2. **Failed Objects Log** - Shows all error messages (duplicates allowed for multiple errors per object)
-3. **Error Details** - When errors occur, displays error detail section at the top
-
----
-
-## Example
-
-```bash
-# Full pull
-abapgit-agent pull
-
-# Fast pull - specific files
-abapgit-agent pull --files abap/zcl_my_class.clas.abap
-
-# With transport
-abapgit-agent pull --files abap/zcl_my_class.clas.abap --transport DEVK900001
-```

package/docs/status-command.md

@@ -1,68 +0,0 @@
-# status Command Requirements
-
-## Overview
-
-Check if ABAP integration is configured for the current repository.
-
-## Command
-
-```bash
-abapgit-agent status
-```
-
-## Tasks
-
-### 1. Check Configuration File
-
-Check if `.abapGitAgent` exists in current directory:
-
-```bash
-test -f .abapGitAgent
-```
-
-### 2. Display Status
-
-| Status | Output |
-|--------|--------|
-| Configured | `✅ ABAP Git Agent is ENABLED` with config location |
-| Not configured | `❌ ABAP Git Agent is NOT configured` |
-
----
-
-## Output Examples
-
-### Configured
-
-```
-✅ ABAP Git Agent is ENABLED
-   Config location: /path/to/repo/.abapGitAgent
-```
-
-### Not Configured
-
-```
-❌ ABAP Git Agent is NOT configured
-```
-
----
-
-## Used By
-
-- `create` command - validates configuration exists before creating repo
-
-## Related Files
-
-| File | Description |
-|------|-------------|
-| `.abapGitAgent` | Configuration file with ABAP connection details |
-| `.abapGitAgent.sample` | Template file |
-
----
-
-## Example
-
-```bash
-$ abapgit-agent status
-✅ ABAP Git Agent is ENABLED
-   Config location: /Users/user/project/.abapGitAgent
-```

package/docs/tree-command.md

@@ -1,303 +0,0 @@
-# tree Command Requirements
-
-## Overview
-
-Display the package hierarchy tree from an ABAP system, showing parent packages, sub-packages, and object counts.
-
-## Command
-
-```bash
-# Basic usage
-abapgit-agent tree --package $ZMY_PACKAGE
-
-# With object breakdown
-abapgit-agent tree --package $ZMY_PACKAGE --include-objects
-
-# Limit depth
-abapgit-agent tree --package $ZMY_PACKAGE --depth 3
-
-# JSON output for scripting (pure machine-readable)
-abapgit-agent tree --package $ZMY_PACKAGE --json
-```
-
-## Prerequisite
-
-- `.abapGitAgent` exists with valid credentials
-- Package must exist in the ABAP system
-
-## Parameters
-
-| Parameter | Required | Description |
-|-----------|----------|-------------|
-| `--package` | Yes | ABAP package name (e.g., `$ZMY_PACKAGE`, `ZMY_PACKAGE`) |
-| `--depth` | No | Maximum depth to traverse (default: 3) |
-| `--include-objects` | No | Include object counts breakdown |
-| `--json` | No | Output raw JSON only (for scripting) |
-
----
-
-## Tasks
-
-### 1. Validate Parameters
-
-- `--package` must be specified
-- Package name must be valid (1-30 characters, start with letter or `$`)
-
-### 2. Load Configuration
-
-Read `.abapGitAgent` for credentials
-
-### 3. Fetch CSRF Token
-
-```bash
-GET /health (with X-CSRF-Token: fetch)
-```
-
-### 4. Make Tree Request
-
-**Endpoint:** `POST /tree`
-
-**Request Body:**
-```json
-{
-  "package": "$ZMY_PACKAGE",
-  "depth": 3,
-  "include_objects": true
-}
-```
-
-### 5. Display Results
-
----
-
-## Output
-
-### Basic Tree
-
-```
-🌳 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)
-        └─ 📦 $ZMAIN_SUB2_A (Sub Package 2A)
-
-📊 Summary
-PACKAGES: 6
-OBJECTS: 127
-```
-
-### With Object Counts
-
-```
-🌳 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)
-        └─ 📦 $ZMAIN_SUB2_A (Sub Package 2A)
-
-📊 Summary
-PACKAGES: 6
-OBJECTS: 127
-TYPES: CLAS=10 INTF=2 PROG=11 FUGR=1 TABL=3
-```
-
-### With Parent Package
-
-```
-🌳 Package Tree: $ZMAIN_PACKAGE
-
-⬆️  Parent: $ZSAP_BASE (SAP Base Package)
-
-📦 $ZMAIN_PACKAGE (Main Package)
-   └─ 📦 $ZMAIN_SUB1 (Sub Package 1)
-
-📊 Summary
-PACKAGES: 2
-OBJECTS: 15
-TYPES: CLAS=5 PROG=10
-```
-
-### JSON Output
-
-```json
-{
-  "SUCCESS": true,
-  "COMMAND": "TREE",
-  "PACKAGE": "$ZMAIN_PACKAGE",
-  "MESSAGE": "Tree retrieved successfully",
-  "PARENT_PACKAGE": "$ZSAP_BASE",
-  "NODES": [
-    {
-      "PACKAGE": "$ZMAIN_PACKAGE",
-      "PARENT": "",
-      "DESCRIPTION": "$ZMAIN_PACKAGE",
-      "DEPTH": 0,
-      "OBJECT_COUNT": 11
-    },
-    {
-      "PACKAGE": "$ZMAIN_SUB1",
-      "PARENT": "$ZMAIN_PACKAGE",
-      "DESCRIPTION": "Sub Package 1",
-      "DEPTH": 1,
-      "OBJECT_COUNT": 10
-    },
-    {
-      "PACKAGE": "$ZMAIN_SUB1_A",
-      "PARENT": "$ZMAIN_SUB1",
-      "DESCRIPTION": "Sub Package 1A",
-      "DEPTH": 2,
-      "OBJECT_COUNT": 3
-    }
-  ],
-  "TOTAL_PACKAGES": 6,
-  "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": ""
-}
-```
-
-**Response Fields:**
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `SUCCESS` | boolean | Whether the request succeeded |
-| `COMMAND` | string | Command name ("TREE") |
-| `PACKAGE` | string | Root package name |
-| `MESSAGE` | string | Status message |
-| `PARENT_PACKAGE` | string | Parent package (empty if root) |
-| `NODES` | array | Flat list of all packages with parent refs |
-| `TOTAL_PACKAGES` | number | Total packages in tree |
-| `TOTAL_OBJECTS` | number | Total objects in tree |
-| `OBJECTS` | array | Object counts by type [{OBJECT, COUNT}] |
-| `ERROR` | string | Error message (empty if success) |
-
-**Node Structure:**
-
-Each entry in `NODES` array:
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `PACKAGE` | string | Package name |
-| `PARENT` | string | Parent package name |
-| `DESCRIPTION` | string | Package description |
-| `DEPTH` | number | Depth in tree (0 = root) |
-| `OBJECT_COUNT` | number | Objects in this package |
-
-**Note:** The `NODES` array is flat - children are identified by `PARENT` reference. The CLI builds the tree display by grouping nodes by depth and parent.
-
----
-
-## Response Structure
-
-### JSON Mode
-
-```json
-{
-  "SUCCESS": true,
-  "COMMAND": "TREE",
-  "PACKAGE": "$ZMAIN_PACKAGE",
-  "MESSAGE": "Tree retrieved successfully",
-  "PARENT_PACKAGE": "$ZSAP_BASE",
-  "NODES": [...],
-  "TOTAL_PACKAGES": 6,
-  "TOTAL_OBJECTS": 127,
-  "OBJECTS": [
-    { "OBJECT": "CLAS", "COUNT": 10 },
-    { "OBJECT": "INTF", "COUNT": 2 }
-  ],
-  "ERROR": ""
-}
-```
-
-See [JSON Output](#json-output-pure-scripting) for full schema.
-
----
-
-## 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)` |
-
-### Error Output
-
-```
-❌ Package not found: $ZNONEXISTENT
-
-Error: Package $ZNONEXISTENT does not exist in the system.
-```
-
----
-
-## Example
-
-```bash
-# Basic usage
-abapgit-agent tree --package $ZMY_PACKAGE
-
-# With object breakdown
-abapgit-agent tree --package $ZMY_PACKAGE --include-objects
-
-# Shallow tree (depth 1)
-abapgit-agent tree --package $ZMY_PACKAGE --depth 1
-
-# JSON for scripting
-abapgit-agent tree --package $ZMY_PACKAGE --json > tree.json
-
-# CI/CD usage with jq
-COUNT=$(abapgit-agent tree --package $ZMY_PACKAGE --json | jq '.TOTAL_OBJECTS')
-echo "Package contains $COUNT objects"
-```
-
----
-
-## Implementation
-
-### ABAP Tables Used
-
-| Table | Purpose |
-|-------|---------|
-| **TDEVC** | Package definitions (contains `PARENTCL` for hierarchy) |
-| **TADIR** | Object directory (for object counts per package) |
-
-### Query Logic
-
-```abap
-" Get root package with parent
-SELECT SINGLE devclass parentcl FROM tdevc
-  INTO ls_package
- WHERE devclass = lv_package.
-
-" Get direct sub-packages recursively (up to depth)
-SELECT devclass parentcl FROM tdevc
-  INTO TABLE lt_direct_subs
- WHERE parentcl = iv_parent.
-
-" Get object count per package
-SELECT COUNT(*) FROM tadir
-  INTO lv_count
- WHERE devclass = iv_package
-   AND object NOT IN ('DEVC', 'PACK').
-
-" Get object counts by type
-SELECT object COUNT(*) AS count FROM tadir
-  INTO TABLE lt_counts
- WHERE devclass = iv_package
-   AND object NOT IN ('DEVC', 'PACK')
- GROUP BY object.
-```