abapgit-agent 1.4.0 → 1.6.0

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.
-```

package/docs/unit-command.md

@@ -1,167 +0,0 @@
-# unit Command Requirements
-
-## Overview
-
-Run AUnit tests for ABAP test classes and display detailed results.
-
-## Command
-
-```bash
-# Single test class file
-abapgit-agent unit --files zcl_my_test.clas.testclasses.abap
-
-# Multiple test class files
-abapgit-agent unit --files zcl_test1.clas.testclasses.abap,zcl_test2.clas.testclasses.abap
-
-# With path
-abapgit-agent unit --files abap/zcl_my_test.clas.testclasses.abap
-```
-
-## Prerequisite
-
-- `.abapGitAgent` exists with valid credentials
-- Files must be test class files (`.testclasses.abap`)
-
-## Parameters
-
-| Parameter | Required | Description |
-|-----------|----------|-------------|
-| `--files` | Yes | Comma-separated list of test class files |
-
----
-
-## Tasks
-
-### 1. Validate Parameters
-
-- `--files` must be specified
-- Files must be `.testclasses.abap` format
-
-### 2. Load Configuration
-
-Read `.abapGitAgent` for credentials
-
-### 3. Fetch CSRF Token
-
-```bash
-GET /health (with X-CSRF-Token: fetch)
-```
-
-### 4. Make Unit Request
-
-**Endpoint:** `POST /unit`
-
-**Request Body:**
-```json
-{
-  "files": ["ZCL_MY_TEST.CLASS.TESTCLASSES.ABAP"]
-}
-```
-
-### 5. Display Results
-
----
-
-## Output
-
-### All Tests Passed
-
-```
-  Running unit tests for 2 file(s)
-
-  ✅ ZCL_MY_TEST - All tests passed
-     Tests: 10 | Passed: 10 | Failed: 0
-
-  ✅ ZCL_OTHER_TEST - All tests passed
-     Tests: 5 | Passed: 5 | Failed: 0
-```
-
-### With Failures
-
-```
-  Running unit tests for 1 file(s)
-
-  ❌ ZCL_MY_TEST - Tests failed
-     Tests: 10 | Passed: 8 | Failed: 2
-     ✗ ZCL_MY_TEST=>TEST_METHOD_1: Error description
-     ✗ ZCL_MY_TEST=>TEST_METHOD_2: Another error
-
-Failed Tests:
-────────────────────────────────────────────────────────────────────────────────
-   ✗ ZCL_MY_TEST=>TEST_METHOD_1
-     Error: Expected X but got Y
-```
-
----
-
-## Response Structure
-
-```json
-{
-  "success": "X",
-  "message": "2 of 10 tests failed",
-  "test_count": 10,
-  "passed_count": 8,
-  "failed_count": 2,
-  "errors": [
-    {
-      "class_name": "ZCL_MY_TEST",
-      "method_name": "TEST_METHOD_1",
-      "error_kind": "ERROR",
-      "error_text": "Expected X but got Y"
-    }
-  ]
-}
-```
-
----
-
-## Error Handling
-
-| Error | Message |
-|-------|---------|
-| File not found | `File not found: <path>` |
-| Invalid format | `Invalid file format: <file>` |
-| No --files specified | `Error: --files parameter required` |
-| No tests found | `➖ <class> - No unit tests` |
-
----
-
-## File Format
-
-Test class files must end with `.testclasses.abap`:
-
-| File | Test Class |
-|------|------------|
-| `zcl_my_test.clas.testclasses.abap` | ZCL_MY_TEST |
-| `src/tests/zcl_my_test.clas.testclasses.abap` | ZCL_MY_TEST |
-
----
-
-## Error Details
-
-When a test fails, output includes:
-- **Class**: The test class name
-- **Method**: Failed test method name (with `=>` notation)
-- **Error Kind**: Type of error (ERROR, FAILURE, etc.)
-- **Error Text**: Detailed error message from AUnit
-
----
-
-## Example
-
-```bash
-# Run tests
-abapgit-agent unit --files zcl_my_test.clas.testclasses.abap
-
-# Multiple
-abapgit-agent unit --files abap/zcl_test1.clas.testclasses.abap,abap/zcl_test2.clas.testclasses.abap
-```
-
-## Implementation
-
-Uses `CL_SUT_AUNIT_RUNNER` to execute tests:
-- `S_CREATE` - Create test runner
-- `run()` - Execute tests
-- `str_results` - Get test statistics
-- `tab_objects` - Get detailed results