abapgit-agent 1.4.0 → 1.6.0

package/CLAUDE_MEM.md

@@ -1,88 +0,0 @@
-# claude-mem for ABAP Knowledge Management
-
-claude-mem is a Claude Code plugin that stores memories across sessions. Use it to retain ABAP knowledge learned from the reference repositories.
-
-## Setup
-
-1. Install the plugin:
-   ```bash
-   /plugin marketplace add thedotmack/claude-mem
-   /plugin install claude-mem
-   ```
-
-## Quick Start: Explore All Reference Docs at Once
-
-Use `claude-mem:make-plan` to bulk explore the abap-reference folder and save all knowledge:
-
-1. In Claude Code, invoke the skill:
-   ```
-   /claude-mem:make-plan
-   ```
-
-2. Provide instructions to explore all reference repos:
-   ```
-   Explore the abap-reference folder at /Users/i045696/Documents/code/abap-reference
-
-   It contains:
-   - abapGit: ABAP file format patterns for abapGit deployment
-   - styleguides: Clean ABAP coding standards
-   - abap-cheat-sheets: Code snippets and examples
-
-   Save all ABAP patterns and conventions to claude-mem memory:
-   - ABAP class file format (ZCL_*.clas.abap, XML metadata)
-   - Clean ABAP naming conventions
-   - Authorization check patterns
-   - Dynamic method calls
-   - Syntax check via Code Inspector
-
-   Focus on copy-ready patterns and code examples.
-   ```
-
-3. The subagent will:
-   - Explore each repository
-   - Extract patterns and examples
-   - **Automatically save memories** to claude-mem
-   - Create a plan document for reference
-
-## Manual Knowledge Saving
-
-When you discover specific ABAP patterns, save them:
-
-```
-/claude-mem:do
-```
-
-This launches a subagent to implement your task and **automatically save memories**.
-
-## Retrieving Knowledge
-
-When you need to recall previously learned ABAP patterns:
-
-```
-/claude-mem:mem-search
-```
-
-Then search for topics like:
-- "ABAP class structure"
-- "Clean ABAP naming"
-- "Authorization check"
-- "Dynamic method call"
-- "abapGit syntax check"
-
-## Key Memory Topics
-
-| Topic | What to Save |
-|-------|-------------|
-| abapGit format | `ZCL_*.clas.abap`, XML metadata pattern |
-| Clean ABAP | Naming conventions, patterns, anti-patterns |
-| Authorization | `AUTHORITY-CHECK` syntax, activity values |
-| Dynamic calls | `CALL METHOD (class)=>(method)` |
-| Syntax check | `zcl_abapgit_code_inspector=>run()` |
-
-## Workflow
-
-1. **First time**: Use `claude-mem:make-plan` to explore and save all reference docs
-2. **During work**: Use `claude-mem:do` to save new discoveries
-3. **When needed**: Use `claude-mem:mem-search` to recall patterns
-
-claude-mem persists across sessions - your learned knowledge is saved.

package/ERROR_HANDLING.md

@@ -1,30 +0,0 @@
-# Error Handling
-
-## Error Types
-
-| Error Type | Response | Handling |
-|------------|----------|----------|
-| Syntax Error | `success=""`, `error_detail` contains object names | Claude fixes and repulls |
-| Activation Error | `success=""`, `error_detail` contains inactive objects | Check TADIR for details |
-| Network Timeout | HTTP timeout | Retry request |
-| Repository Not Found | `success=""`, message="Repository not found" | Verify URL |
-
-## Troubleshooting
-
-### REST API not accessible
-
-1. Check SICF activation: `sap/bc/z_abapgit_agent`
-2. Verify handler class: `ZCL_ABAPGIT_AGENT_HANDLER`
-3. Check authorization
-
-### Agent cannot connect to ABAP
-
-1. Verify REST API URL in .abapGitAgent
-2. Check credentials in .abapGitAgent
-3. Test REST API directly with curl
-
-### Activation errors not shown
-
-1. Check TADIR for inactive objects in the package
-2. Verify abapGit settings for activation
-3. Check SE80 for object activation status

package/INSTALL.md

@@ -1,155 +0,0 @@
-# Installation & Setup
-
-## Architecture
-
-```
-Claude (VS Code) → CLI Tool → ABAP System (REST/HTTP)
-                                  ↓
-                    Result + Error Feedback
-```
-
-## Components
-
-### ABAP Side - REST Implementation
-
-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
-- Configuration management (reads from cwd/.abapGitAgent)
-- Auto-detects git remote URL and branch from current directory
-- Cookie-based session management
-
-## Why REST API?
-
-The REST API approach provides several advantages:
-- **No OData/Gateway needed** - Simpler setup
-- **Standard HTTP** - Easy to debug and test
-- **No SEGW required** - Direct ICF handler
-- **No native dependencies** - Works on any OS
-
-## ABAP System Setup
-
-### Prerequisites
-
-The developer version of abapGit is required to deploy the REST handler. Follow the [abapGit developer version installation guide](https://docs.abapgit.org/user-guide/getting-started/install.html#install-developer-version).
-
-### Deploy ABAP Objects
-
-Deploy ABAP objects using abapGit:
-
-1. Use abapGit to deploy the ABAP objects in `/abap` folder
-2. Create SICF handler:
-   - Run transaction `SICF`
-   - Navigate to: `sap/bc/z_abapgit_agent`
-   - Create if doesn't exist:
-     - Right-click on `sap/bc` → **Create Element**
-     - **Service Name**: `Z_ABAPGIT_AGENT`
-     - **Handler Class**: `ZCL_ABGAGT_REST_HANDLER`
-   - Activate the service
-
-## CLI Installation
-
-```bash
-# Option A: Install globally for system-level integration
-sudo npm install -g abapgit-agent
-
-# Option B: For local development, use npm link instead
-cd abapgit-agent
-sudo npm link
-```
-
-## Configuration
-
-Copy `.abapGitAgent.example` to `.abapGitAgent` in your repository root:
-
-```bash
-cp .abapGitAgent.example .abapGitAgent
-```
-
-### Configuration Options
-
-**File-based** (.abapGitAgent):
-```json
-{
-  "host": "your-sap-system.com",
-  "sapport": 443,
-  "client": "100",
-  "user": "TECH_USER",
-  "password": "your-password",
-  "language": "EN",
-  "gitUsername": "github-username",
-  "gitPassword": "github-token"
-}
-```
-
-**Environment variables**:
-- `ABAP_HOST`, `ABAP_PORT`, `ABAP_CLIENT`, `ABAP_USER`, `ABAP_PASSWORD`
-
-## System-Level Integration
-
-This package supports **system-level integration**, meaning any ABAP git repository can use it without cloning this repository:
-
-1. **Install globally**: `sudo npm install -g abapgit-agent`
-2. **Configure**: Add `.abapGitAgent` to your ABAP repo
-3. **Use**: Run `abapgit-agent` from your repo directory
-
-## Creating New ABAP Projects
-
-### 1. Create Project Structure
-
-```bash
-# Create new ABAP repository
-mkdir my-abap-repo
-cd my-abap-repo
-
-# Copy CLAUDE.md (tells Claude how to work with ABAP)
-cp /path/to/abapgit-agent/abap/CLAUDE.md .
-
-# Initialize git
-git init
-```
-
-### 2. Add ABAP Objects
-
-Copy your ABAP objects to the repo:
-
-```bash
-# Copy individual objects
-cp /path/to/abapgit-agent/abap/zcl_*.abap ./
-```
-
-### 3. Configure and Push
-
-```bash
-# Create .abapGitAgent config
-cp .abapGitAgent.example .abapGitAgent
-# Edit .abapGitAgent with your SAP system details
-
-# Initial commit
-git add .
-git commit -m "Initial ABAP project"
-
-# Add remote and push
-git remote add origin https://github.com/user/my-abap-repo.git
-git push -u origin main
-```
-
-### 4. Deploy to SAP
-
-Use abapGit in your SAP system to pull the repository.
-
-## Claude Code Integration
-
-Claude Code automatically reads `CLAUDE.md` in your project root for context:
-
-1. **No local syntax validation** - Claude knows ABAP needs SAP system
-2. **Use `abapgit-agent pull`** - For validation after code generation
-3. **Reference local docs** - See CLAUDE_MEM.md for knowledge management
-
-See `abap/CLAUDE.md` for detailed ABAP project guidelines.

package/RELEASE_NOTES.md

@@ -1,143 +0,0 @@
-# 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
-
-#### 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
-- Updated commands documentation