erpl-adt: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Git Commits and Pull Requests

Do NOT include Co-Authored-By, 🤖 Generated with Claude Code, or any AI attribution lines in commit messages or pull request bodies.

Project Overview

erpl-adt is a CLI and MCP server for the SAP ADT REST API — a single C++ binary that talks the same HTTP endpoints Eclipse ADT uses. It enables AI coding agents and human developers to search, read/write source code, run tests, manage transports, and more against ABAP systems. No Eclipse, no SAP NW RFC SDK, no JVM.

Part of the Datazoo ERPL family. Shares build conventions with flapi and library choices with erpl-web.

Build Commands

make release          # Full release build (CMake + Ninja + vcpkg)
make test             # Run unit tests (Catch2, no SAP system needed)
make clean            # Remove the build directory

For faster rebuilds during development:

cmake --build build --target erpl_adt_tests   # Rebuild tests only
ctest --test-dir build --output-on-failure     # Run tests only

Build requires: CMake, Ninja, vcpkg (git submodule at vcpkg/). Checkout with --recurse-submodules.

Architecture

main.cpp -> command_router -> {group handlers}
                                    |
         +---------+---------+------+------+---------+---------+
         v         v         v      v      v         v         v
      search    object    source  test   check   transport   mcp
      locking    ddic    packages abapgit activation  deploy_workflow
         |         |         |      |      |         |         |
         +---------+---------+------+------+---------+---------+
                                    v
                             i_adt_session <-- adt_session (cpp-httplib)
                                    |
                             i_xml_codec  <-- xml_codec   (tinyxml2)

All arrows point downward. No cycles. Every horizontal boundary is a pure abstract interface (abstract base class).