@mcp-abap-adt/core 7.1.1 → 7.1.3

package/docs/user-guide/AVAILABLE_TOOLS_READONLY.md

@@ -3,7 +3,7 @@
 Generated from code in `src/handlers/**` (not from docs).
 
 - Level: Read-Only
-- Total tools: 55
+- Total tools: 59
 
 ## Navigation
 
@@ -24,6 +24,10 @@ Generated from code in `src/handlers/**` (not from docs).
     - [GetEnhancementSpot](#getenhancementspot-read-only-enhancement)
   - [Function Group](#read-only-function-group)
     - [ReadFunctionGroup](#readfunctiongroup-read-only-function-group)
+  - [Function Include](#read-only-function-include)
+    - [ListFunctionGroupIncludes](#listfunctiongroupincludes-read-only-function-include)
+    - [ListFunctionModules](#listfunctionmodules-read-only-function-include)
+    - [ReadFunctionInclude](#readfunctioninclude-read-only-function-include)
   - [Function Module](#read-only-function-module)
     - [ReadFunctionModule](#readfunctionmodule-read-only-function-module)
   - [Include](#read-only-include)
@@ -47,6 +51,7 @@ Generated from code in `src/handlers/**` (not from docs).
   - [Service Definition](#read-only-service-definition)
     - [ReadServiceDefinition](#readservicedefinition-read-only-service-definition)
   - [Structure](#read-only-structure)
+    - [GetStructuresList](#getstructureslist-read-only-structure)
     - [ReadStructure](#readstructure-read-only-structure)
   - [System](#read-only-system)
     - [DescribeByList](#describebylist-read-only-system)
@@ -218,6 +223,44 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
+<a id="read-only-function-include"></a>
+### Read-Only / Function Include
+
+<a id="listfunctiongroupincludes-read-only-function-include"></a>
+#### ListFunctionGroupIncludes (Read-Only / Function Include)
+**Description:** [read-only] List the includes (TOP, custom) of an ABAP function group.
+
+**Source:** `src/handlers/function_include/readonly/handleListFunctionGroupIncludes.ts`
+
+**Parameters:**
+- `function_group_name` (string, required) - Function group name (e.g., Z_MY_FG).
+
+---
+
+<a id="listfunctionmodules-read-only-function-include"></a>
+#### ListFunctionModules (Read-Only / Function Include)
+**Description:** [read-only] List the function modules of an ABAP function group.
+
+**Source:** `src/handlers/function_include/readonly/handleListFunctionModules.ts`
+
+**Parameters:**
+- `function_group_name` (string, required) - Function group name (e.g., Z_MY_FG).
+
+---
+
+<a id="readfunctioninclude-read-only-function-include"></a>
+#### ReadFunctionInclude (Read-Only / Function Include)
+**Description:** [read-only] Read ABAP function group include source code and metadata. Answers: "show function group include code", "display include source", "view include of function group". Returns source code and include metadata.
+
+**Source:** `src/handlers/function_include/readonly/handleReadFunctionInclude.ts`
+
+**Parameters:**
+- `function_group_name` (string, required) - Function group name containing the include (e.g., Z_MY_FG).
+- `include_name` (string, required) - Include name (e.g., LZ_MY_FGTOP, LZ_MY_FGU01).
+- `version` (string, optional (default: active)) - Version to read: "active" (default) or "inactive".
+
+---
+
 <a id="read-only-function-module"></a>
 ### Read-Only / Function Module
 
@@ -411,6 +454,20 @@ Generated from code in `src/handlers/**` (not from docs).
 <a id="read-only-structure"></a>
 ### Read-Only / Structure
 
+<a id="getstructureslist-read-only-structure"></a>
+#### GetStructuresList (Read-Only / Structure)
+**Description:** [read-only] Recursively list the structures embedded in an ABAP structure (.INCLUDE / append), as a tree.
+
+**Source:** `src/handlers/structure/readonly/handleGetStructuresList.ts`
+
+**Parameters:**
+- `include_extensions` (boolean, optional (default: true)) - [read-only] Also find extension (append) structures via where-used (objects that `extend type <this> with …`). Default true. Set false to skip the (slower) where-used lookups and return includes only.
+- `structure_name` (string, required) - Structure name (e.g., Z_MY_STRUCTURE).
+- `timeout` (number, optional) - [read-only] Timeout in ms for each ADT request.
+- `version` (string, optional (default: active)) - Version to read: "active" (default) or "inactive".
+
+---
+
 <a id="readstructure-read-only-structure"></a>
 #### ReadStructure (Read-Only / Structure)
 **Description:** Operation: Read, Create, Update. Subject: Structure. Will be useful for reading, creating, or updating structure. [read-only] Read ABAP structure definition and metadata. Answers: "show structure fields", "display structure X", "view structure definition", "get structure components". Returns field list, package, responsible, description.
@@ -900,4 +957,4 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
-*Last updated: 2026-05-30*
+*Last updated: 2026-06-20*

package/docs/user-guide/CLIENT_CONFIGURATION.md

@@ -8,9 +8,9 @@ If you prefer not to edit JSON/TOML by hand, use the configurator CLI:
 ## Overview
 
 The `mcp-abap-adt` server supports multiple transport modes:
-- **streamable-http** - HTTP-based transport with streaming support (default)
-- **stdio** - Standard input/output (for MCP clients like Cline, Cursor)
-- **sse** - Server-Sent Events transport
+- **stdio** - Standard input/output (default; for MCP clients like Cline, Cursor)
+- **streamable-http** - HTTP-based transport with streaming support (requires `--transport=http`)
+- **sse** - Server-Sent Events transport (requires `--transport=sse`)
 
 For HTTP-based transports (streamable-http and sse), you can configure SAP connection parameters via HTTP headers, allowing dynamic connection configuration per request.
 
@@ -471,7 +471,7 @@ The server can be started in HTTP mode with:
 ```bash
 npm run start:http
 # or
-node dist/index.js --transport streamable-http --http-port 3000
+node dist/index.js --transport streamable-http --port 3000
 ```
 
 ### Environment Variables

package/docs/user-guide/CLI_OPTIONS.md

@@ -29,7 +29,7 @@ Load server configuration from a YAML file instead of command-line arguments. If
 mcp-abap-adt --conf=config.yaml
 
 # Override YAML values with command-line arguments
-mcp-abap-adt --conf=config.yaml --http-port=8080
+mcp-abap-adt --conf=config.yaml --port=8080
 ```
 
 **Benefits:**
@@ -126,7 +126,7 @@ mcp-abap-adt --transport=http
 mcp-abap-adt --transport=sse
 ```
 
-**Note:** You can use shortcuts `--http` or `--sse` instead of `--transport=http` or `--transport=sse`.
+**Note:** The default transport is `stdio`; running bare `mcp-abap-adt` starts stdio. Select the transport explicitly with `--transport=stdio|http|sse`. There are no `--http`/`--sse` standalone shortcuts; configure host and port with the generic `--host`/`--port` flags (and the path flags `--path`/`--sse-path`/`--post-path`).
 
 ## SAP Connection Type
 
@@ -227,17 +227,17 @@ Used with `--transport=http` or `--transport=streamable-http`.
 
 ### Port Configuration
 
-**--http-port=\<port\>**
+**--port=\<port\>**
 
 HTTP server port (default: 3000).
 
 ```bash
-mcp-abap-adt --transport=http --http-port=8080
+mcp-abap-adt --transport=http --port=8080
 ```
 
 ### Host Binding
 
-**--http-host=\<host\>**
+**--host=\<host\>**
 
 HTTP server host address (default: 127.0.0.1, localhost only for security).
 
@@ -247,10 +247,10 @@ HTTP server host address (default: 127.0.0.1, localhost only for security).
 
 ```bash
 # Bind to localhost only (default, secure)
-mcp-abap-adt --transport=http --http-host=127.0.0.1
+mcp-abap-adt --transport=http --host=127.0.0.1
 
 # Bind to all interfaces (less secure, client must provide all headers)
-mcp-abap-adt --transport=http --http-host=0.0.0.0
+mcp-abap-adt --transport=http --host=0.0.0.0
 ```
 
 **When using 0.0.0.0:**
@@ -258,56 +258,32 @@ mcp-abap-adt --transport=http --http-host=0.0.0.0
 - Server acts as a simple proxy - no default destination lookup
 - All responsibility for connection configuration is on the client
 
-### Response Format
+### Path Configuration
 
-**--http-json-response**
+**--path=\<path\>** (alias **--http-path=\<path\>**)
 
-Enable JSON response format.
+HTTP endpoint path (default: /mcp/stream/http).
 
 ```bash
-mcp-abap-adt --transport=http --http-json-response
+mcp-abap-adt --transport=http --path=/mcp/stream/http
 ```
 
-### CORS Configuration
-
-**--http-allowed-origins=\<list\>**
-
-Comma-separated list of allowed origins for CORS.
-
-```bash
-# Single origin
-mcp-abap-adt --transport=http --http-allowed-origins=http://localhost:3000
-
-# Multiple origins
-mcp-abap-adt --transport=http --http-allowed-origins=http://localhost:3000,https://app.example.com
-```
-
-**--http-allowed-hosts=\<list\>**
-
-Comma-separated list of allowed hosts.
-
-```bash
-mcp-abap-adt --transport=http --http-allowed-hosts=localhost,myapp.local
-```
-
-### Security
+### Response Format
 
-**--http-enable-dns-protection**
+**--http-json-response**
 
-Enable DNS rebinding protection.
+Enable JSON response format.
 
 ```bash
-mcp-abap-adt --transport=http --http-enable-dns-protection
+mcp-abap-adt --transport=http --http-json-response
 ```
 
 ### Complete HTTP Example
 
 ```bash
 mcp-abap-adt --transport=http \
-  --http-port=8080 \
-  --http-host=0.0.0.0 \
-  --http-allowed-origins=http://localhost:3000,https://myapp.com \
-  --http-enable-dns-protection \
+  --port=8080 \
+  --host=0.0.0.0 \
   --env-path=~/configs/sap-prod.env
 ```
 
@@ -317,17 +293,17 @@ Used with `mcp-abap-adt --transport=sse` or `--transport=sse`.
 
 ### Port Configuration
 
-**--sse-port=\<port\>**
+**--port=\<port\>**
 
 SSE server port (default: 3001).
 
 ```bash
-mcp-abap-adt --transport=sse --sse-port=8081
+mcp-abap-adt --transport=sse --port=8081
 ```
 
 ### Host Binding
 
-**--sse-host=\<host\>**
+**--host=\<host\>**
 
 SSE server host address (default: 127.0.0.1, localhost only for security).
 
@@ -337,10 +313,10 @@ SSE server host address (default: 127.0.0.1, localhost only for security).
 
 ```bash
 # Bind to localhost only (default, secure)
-mcp-abap-adt --transport=sse --sse-host=127.0.0.1
+mcp-abap-adt --transport=sse --host=127.0.0.1
 
 # Bind to all interfaces (less secure, client must provide all headers)
-mcp-abap-adt --transport=sse --sse-host=0.0.0.0
+mcp-abap-adt --transport=sse --host=0.0.0.0
 ```
 
 **When using 0.0.0.0:**
@@ -348,42 +324,26 @@ mcp-abap-adt --transport=sse --sse-host=0.0.0.0
 - Server acts as a simple proxy - no default destination lookup
 - All responsibility for connection configuration is on the client
 
-### CORS Configuration
-
-**--sse-allowed-origins=\<list\>**
-
-Comma-separated list of allowed origins for CORS.
+### Path Configuration
 
-```bash
-mcp-abap-adt --transport=sse --sse-allowed-origins=http://localhost:3000,https://app.example.com
-```
-
-**--sse-allowed-hosts=\<list\>**
-
-Comma-separated list of allowed hosts.
-
-```bash
-mcp-abap-adt --transport=sse --sse-allowed-hosts=localhost,myapp.local
-```
+**--sse-path=\<path\>**
 
-### Security
+SSE connection path (default: /sse).
 
-**--sse-enable-dns-protection**
+**--post-path=\<path\>**
 
-Enable DNS rebinding protection.
+SSE message post path (default: /messages).
 
 ```bash
-mcp-abap-adt --transport=sse --sse-enable-dns-protection
+mcp-abap-adt --transport=sse --sse-path=/sse --post-path=/messages
 ```
 
 ### Complete SSE Example
 
 ```bash
 mcp-abap-adt --transport=sse \
-  --sse-port=3001 \
-  --sse-host=0.0.0.0 \
-  --sse-allowed-origins=http://localhost:3000 \
-  --sse-enable-dns-protection \
+  --port=3001 \
+  --host=0.0.0.0 \
   --env-path=~/configs/sap-dev.env
 ```
 
@@ -406,17 +366,11 @@ Alternative to command line arguments. Environment variables can be set in shell
 - `MCP_HTTP_PORT` - Default HTTP port
 - `MCP_HTTP_HOST` - Default HTTP host (default: 127.0.0.1)
 - `MCP_HTTP_ENABLE_JSON_RESPONSE` - Enable JSON responses (true|false)
-- `MCP_HTTP_ALLOWED_ORIGINS` - Allowed CORS origins (comma-separated)
-- `MCP_HTTP_ALLOWED_HOSTS` - Allowed hosts (comma-separated)
-- `MCP_HTTP_ENABLE_DNS_PROTECTION` - Enable DNS protection (true|false)
 
 ### SSE Transport
 
 - `MCP_SSE_PORT` - Default SSE port
 - `MCP_SSE_HOST` - Default SSE host
-- `MCP_SSE_ALLOWED_ORIGINS` - Allowed CORS origins (comma-separated)
-- `MCP_SSE_ALLOWED_HOSTS` - Allowed hosts (comma-separated)
-- `MCP_SSE_ENABLE_DNS_PROTECTION` - Enable DNS protection (true|false)
 
 ### SAP Connection
 
@@ -459,7 +413,6 @@ These are typically set in `.env` file:
 **Shell environment:**
 ```bash
 export MCP_HTTP_PORT=8080
-export MCP_HTTP_ALLOWED_ORIGINS=http://localhost:3000
 mcp-abap-adt --transport=http
 ```
 
@@ -467,7 +420,6 @@ mcp-abap-adt --transport=http
 ```bash
 # ~/.mcp-abap-adt.env
 MCP_HTTP_PORT=8080
-MCP_HTTP_ALLOWED_ORIGINS=http://localhost:3000,https://myapp.com
 
 # Use it
 mcp-abap-adt --transport=http --env-path ~/.mcp-abap-adt.env
@@ -477,7 +429,7 @@ mcp-abap-adt --transport=http --env-path ~/.mcp-abap-adt.env
 
 When the same option is specified multiple ways, this is the priority order (highest to lowest):
 
-1. **Command line arguments** (`--http-port=8080`)
+1. **Command line arguments** (`--port=8080`)
 2. **Environment variables** (`MCP_HTTP_PORT=8080`)
 3. **Default values**
 
@@ -485,7 +437,7 @@ Example:
 ```bash
 # Port 9000 wins (command line)
 export MCP_HTTP_PORT=8080
-mcp-abap-adt --transport=http --http-port=9000
+mcp-abap-adt --transport=http --port=9000
 ```
 
 ## Common Usage Patterns
@@ -544,8 +496,7 @@ EOF
 # Run with explicit config
 mcp-abap-adt --transport=http \
   --env-path=/etc/mcp-abap-adt/prod.env \
-  --http-port=8080 \
-  --http-enable-dns-protection
+  --port=8080
 ```
 
 ### Multi-Environment
@@ -560,7 +511,7 @@ mcp-abap-adt --transport=http \
 # Quick switch
 alias mcp-dev='mcp-abap-adt --env-path=~/sap-configs/dev.env'
 alias mcp-test='mcp-abap-adt --env-path=~/sap-configs/test.env'
-alias mcp-prod='mcp-abap-adt --transport=http --env-path=~/sap-configs/prod.env --http-port=8080'
+alias mcp-prod='mcp-abap-adt --transport=http --env-path=~/sap-configs/prod.env --port=8080'
 
 # Use
 mcp-dev
@@ -590,7 +541,7 @@ mcp-abap-adt 2>&1 | grep MCP-ENV
 lsof -i :3000
 
 # Use different port
-mcp-abap-adt --transport=http --http-port=3001
+mcp-abap-adt --transport=http --port=3001
 ```
 
 ### Can't Find .env File

package/docs/user-guide/HANDLERS_MANAGEMENT.md

@@ -62,7 +62,7 @@ V2 server supports flexible handler set configuration through the `--exposition`
    - Object search
    - Code search
 
-6. **system** - Always included automatically  
+6. **system** - Included only when the exposition includes `readonly` (added alongside the read-only group)
    - Where-used analysis (GetWhereUsed)
    - Type information (GetTypeInfo)
    - Object info (GetObjectInfo)
@@ -75,25 +75,25 @@ V2 server supports flexible handler set configuration through the `--exposition`
 
 ## Usage
 
-**Note:** `search` and `system` handler groups are ALWAYS included regardless of `--exposition` setting.
+**Note:** The `search` handler group is ALWAYS included regardless of `--exposition`. The `system` handler group is included only when the exposition contains `readonly` (it is registered together with the read-only group). The default exposition is `readonly,high`, so both are present by default.
 
 ### Command Line
 
 ```bash
-# Default: readonly + high (+ search + system always included)
-node bin/mcp-abap-adt-v2.js --transport=stdio --env-path=.env
+# Default: readonly + high (+ search always; + system because readonly is present)
+node bin/mcp-abap-adt.js --transport=stdio --env-path=.env
 
 # Only read-only operations (safest)
-node bin/mcp-abap-adt-v2.js --transport=stdio --env-path=.env --exposition=readonly
+node bin/mcp-abap-adt.js --transport=stdio --env-path=.env --exposition=readonly
 
 # Read-only + high-level writes (recommended)
-node bin/mcp-abap-adt-v2.js --transport=stdio --env-path=.env --exposition=readonly,high
+node bin/mcp-abap-adt.js --transport=stdio --env-path=.env --exposition=readonly,high
 
 # Compact facade only
-node bin/mcp-abap-adt-v2.js --transport=stdio --env-path=.env --exposition=compact
+node bin/mcp-abap-adt.js --transport=stdio --env-path=.env --exposition=compact
 
 # Low-level writes (use instead of `high`, not together)
-node bin/mcp-abap-adt-v2.js --transport=stdio --env-path=.env --exposition=readonly,low
+node bin/mcp-abap-adt.js --transport=stdio --env-path=.env --exposition=readonly,low
 ```
 
 #### Validation rules
@@ -129,7 +129,7 @@ Set `MCP_EXPOSITION`:
 
 ```bash
 export MCP_EXPOSITION=readonly,high
-node bin/mcp-abap-adt-v2.js --transport=stdio --env-path=.env
+node bin/mcp-abap-adt.js --transport=stdio --env-path=.env
 ```
 
 ## Generating Handler Documentation

package/docs/user-guide/README.md

@@ -14,11 +14,11 @@ Install from a pre-built `.tgz` package:
 
 ```bash
 # Install globally
-npm install -g ./fr0ster-mcp-abap-adt-1.1.0.tgz
+npm install -g ./mcp-abap-adt-core-<version>.tgz
 
 # Available commands:
-mcp-abap-adt          # HTTP transport (default)
-mcp-abap-adt --transport=stdio    # stdio transport (for MCP clients)
+mcp-abap-adt          # stdio transport (default, for MCP clients)
+mcp-abap-adt --transport=http     # HTTP server
 mcp-abap-adt --transport=sse      # SSE server
 ```
 
@@ -33,7 +33,7 @@ SAP_JWT_TOKEN=your-jwt-token
 EOF
 
 # Run HTTP server
-mcp-abap-adt --transport=http --port 3000
+mcp-abap-adt --transport=http --port=3000
 ```
 
 See [Installation Guide](../installation/INSTALLATION.md#package-installation-details) for detailed instructions.
@@ -91,7 +91,7 @@ objects for each package. Each object includes:
 
 After installing from package, these commands are available:
 
-### `mcp-abap-adt` - Default HTTP transport
+### `mcp-abap-adt` - Default stdio transport
 ```bash
 mcp-abap-adt [--env <destination>] [--env-path /path/to/.env]
 ```
@@ -113,15 +113,15 @@ Starts HTTP server with Server-Sent Events transport.
 
 ### Example 1: HTTP Server on Port 8080
 ```bash
-mcp-abap-adt --transport=http --port 8080
+mcp-abap-adt --transport=http --port=8080
 ```
 
 ### Example 2: SSE Server Accessible from Network
 ```bash
-mcp-abap-adt --transport=sse --host 0.0.0.0 --port 3000
+mcp-abap-adt --transport=sse --host=0.0.0.0 --port=3000
 ```
 
 ### Example 3: Custom Environment File
 ```bash
-mcp-abap-adt --transport=http --env-path /opt/config/.env.production --port 8080
+mcp-abap-adt --transport=http --env-path /opt/config/.env.production --port=8080
 ```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mcp-abap-adt/core",
   "mcpName": "io.github.fr0ster/mcp-abap-adt",
-  "version": "7.1.1",
+  "version": "7.1.3",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -50,6 +50,7 @@
     "shared:setup": "jest --testPathPatterns='admin/shared-deps/setup' --testPathIgnorePatterns='[]' --runInBand --passWithNoTests",
     "shared:teardown": "jest --testPathPatterns='admin/shared-deps/teardown' --testPathIgnorePatterns='[]' --runInBand --passWithNoTests",
     "shared:check": "jest --testPathPatterns='admin/shared-deps/check' --testPathIgnorePatterns='[]' --passWithNoTests",
+    "polygon:backup": "adt-backup backup --package ZMCP_SHR_PKG --env-path trial.env --output tests/fixtures/polygon.backup.yaml",
     "lint": "npx biome check --write src",
     "lint:check": "npx biome check src",
     "format": "npx biome format --write src",
@@ -169,8 +170,7 @@
     "CHANGELOG.md"
   ],
   "bin": {
-    "mcp-abap-adt": "./bin/mcp-abap-adt.js",
-    "mcp-abap-adt-v2": "./bin/mcp-abap-adt-v2.js"
+    "mcp-abap-adt": "./bin/mcp-abap-adt.js"
   },
   "jest": {
     "preset": "ts-jest",