@mcp-abap-adt/core 2.2.5 → 2.2.7

package/docs/user-guide/AVAILABLE_TOOLS_READONLY.md

@@ -0,0 +1,405 @@
+# Read-Only Tools - MCP ABAP ADT Server
+
+Generated from code in `src/handlers/**` (not from docs).
+
+- Level: Read-Only
+- Total tools: 27
+
+## Navigation
+
+- [Read-Only Group](#read-only-group)
+  - [Enhancement](#read-only-enhancement)
+    - [GetEnhancementImpl](#getenhancementimpl-read-only-enhancement)
+    - [GetEnhancements](#getenhancements-read-only-enhancement)
+    - [GetEnhancementSpot](#getenhancementspot-read-only-enhancement)
+  - [Function](#read-only-function)
+    - [GetFunction](#getfunction-read-only-function)
+  - [Include](#read-only-include)
+    - [GetInclude](#getinclude-read-only-include)
+    - [GetIncludesList](#getincludeslist-read-only-include)
+  - [Package](#read-only-package)
+    - [GetPackageContents](#getpackagecontents-read-only-package)
+  - [Program](#read-only-program)
+    - [GetProgFullCode](#getprogfullcode-read-only-program)
+  - [Search](#read-only-search)
+    - [GetObjectsByType](#getobjectsbytype-read-only-search)
+    - [GetObjectsList](#getobjectslist-read-only-search)
+    - [SearchObject](#searchobject-read-only-search)
+  - [System](#read-only-system)
+    - [DescribeByList](#describebylist-read-only-system)
+    - [GetAbapAST](#getabapast-read-only-system)
+    - [GetAbapSemanticAnalysis](#getabapsemanticanalysis-read-only-system)
+    - [GetAbapSystemSymbols](#getabapsystemsymbols-read-only-system)
+    - [GetAdtTypes](#getadttypes-read-only-system)
+    - [GetInactiveObjects](#getinactiveobjects-read-only-system)
+    - [GetObjectInfo](#getobjectinfo-read-only-system)
+    - [GetObjectNodeFromCache](#getobjectnodefromcache-read-only-system)
+    - [GetObjectStructure](#getobjectstructure-read-only-system)
+    - [GetSession](#getsession-read-only-system)
+    - [GetSqlQuery](#getsqlquery-read-only-system)
+    - [GetTransaction](#gettransaction-read-only-system)
+    - [GetTypeInfo](#gettypeinfo-read-only-system)
+    - [GetWhereUsed](#getwhereused-read-only-system)
+  - [Table](#read-only-table)
+    - [GetTableContents](#gettablecontents-read-only-table)
+  - [Transport](#read-only-transport)
+    - [GetTransport](#gettransport-read-only-transport)
+
+---
+
+<a id="read-only-group"></a>
+## Read-Only Group
+
+<a id="read-only-enhancement"></a>
+### Read-Only / Enhancement
+
+<a id="getenhancementimpl-read-only-enhancement"></a>
+#### GetEnhancementImpl (Read-Only / Enhancement)
+**Description:** [read-only] Retrieve source code of a specific enhancement implementation by its name and enhancement spot.
+
+**Source:** `src/handlers/enhancement/readonly/handleGetEnhancementImpl.ts`
+
+**Parameters:**
+- `enhancement_name` (string, required) - [read-only] Name of the enhancement implementation
+- `enhancement_spot` (string, required) - Name of the enhancement spot
+
+---
+
+<a id="getenhancements-read-only-enhancement"></a>
+#### GetEnhancements (Read-Only / Enhancement)
+**Description:** [read-only] Retrieve a list of enhancements for a given ABAP object.
+
+**Source:** `src/handlers/enhancement/readonly/handleGetEnhancements.ts`
+
+**Parameters:**
+- `object_name` (string, required) - Name of the ABAP object
+- `object_type` (string, required) - [read-only] Type of the ABAP object
+
+---
+
+<a id="getenhancementspot-read-only-enhancement"></a>
+#### GetEnhancementSpot (Read-Only / Enhancement)
+**Description:** [read-only] Retrieve metadata and list of implementations for a specific enhancement spot.
+
+**Source:** `src/handlers/enhancement/readonly/handleGetEnhancementSpot.ts`
+
+**Parameters:**
+- `enhancement_spot` (string, required) - Name of the enhancement spot
+
+---
+
+<a id="read-only-function"></a>
+### Read-Only / Function
+
+<a id="getfunction-read-only-function"></a>
+#### GetFunction (Read-Only / Function)
+**Description:** [read-only] Retrieve ABAP Function Module source code.
+
+**Source:** `src/handlers/function/readonly/handleGetFunction.ts`
+
+**Parameters:**
+- None
+
+---
+
+<a id="read-only-include"></a>
+### Read-Only / Include
+
+<a id="getinclude-read-only-include"></a>
+#### GetInclude (Read-Only / Include)
+**Description:** [read-only] Retrieve source code of a specific ABAP include file.
+
+**Source:** `src/handlers/include/readonly/handleGetInclude.ts`
+
+**Parameters:**
+- None
+
+---
+
+<a id="getincludeslist-read-only-include"></a>
+#### GetIncludesList (Read-Only / Include)
+**Description:** [read-only] Recursively discover and list ALL include files within an ABAP program or include.
+
+**Source:** `src/handlers/include/readonly/handleGetIncludesList.ts`
+
+**Parameters:**
+- `detailed` (boolean, optional (default: false)) - [read-only] If true, returns structured JSON with metadata and raw XML.
+- `object_name` (string, required) - Name of the ABAP program or include
+- `object_type` (string, required) - [read-only] ADT object type (e.g. PROG/P, PROG/I, FUGR, CLAS/OC)
+- `timeout` (number, optional) - [read-only] Timeout in ms for each ADT request.
+
+---
+
+<a id="read-only-package"></a>
+### Read-Only / Package
+
+<a id="getpackagecontents-read-only-package"></a>
+#### GetPackageContents (Read-Only / Package)
+**Description:** [read-only] Retrieve objects inside an ABAP package as a flat list. Supports recursive traversal of subpackages.
+
+**Source:** `src/handlers/package/readonly/handleGetPackageContents.ts`
+
+**Parameters:**
+- None
+
+---
+
+<a id="read-only-program"></a>
+### Read-Only / Program
+
+<a id="getprogfullcode-read-only-program"></a>
+#### GetProgFullCode (Read-Only / Program)
+**Description:** [read-only] Returns the full code for a program or function group, including all includes, in tree traversal order.
+
+**Source:** `src/handlers/program/readonly/handleGetProgFullCode.ts`
+
+**Parameters:**
+- `name` (string, required) - [read-only] Technical name of the program or function group (e.g., 
+- `type` (string, required) - [read-only] 
+
+---
+
+<a id="read-only-search"></a>
+### Read-Only / Search
+
+<a id="getobjectsbytype-read-only-search"></a>
+#### GetObjectsByType (Read-Only / Search)
+**Description:** [read-only] Retrieves all ABAP objects of a specific type under a given node.
+
+**Source:** `src/handlers/search/readonly/handleGetObjectsByType.ts`
+
+**Parameters:**
+- `node_id` (string, required) - [read-only] Node ID
+- `parent_name` (string, required) - [read-only] Parent object name
+- `parent_tech_name` (string, required) - [read-only] Parent technical name
+- `parent_type` (string, required) - [read-only] Parent object type
+- `with_short_descriptions` (boolean, optional) - [read-only] Include short descriptions
+
+---
+
+<a id="getobjectslist-read-only-search"></a>
+#### GetObjectsList (Read-Only / Search)
+**Description:** [read-only] Recursively retrieves all valid ABAP repository objects for a given parent (program, function group, etc.) including nested includes.
+
+**Source:** `src/handlers/search/readonly/handleGetObjectsList.ts`
+
+**Parameters:**
+- `parent_name` (string, required) - [read-only] Parent object name
+- `parent_tech_name` (string, required) - [read-only] Parent technical name
+- `parent_type` (string, required) - [read-only] Parent object type (e.g. PROG/P, FUGR)
+- `with_short_descriptions` (boolean, optional (default: true))) - [read-only] Include short descriptions (default: true)
+
+---
+
+<a id="searchobject-read-only-search"></a>
+#### SearchObject (Read-Only / Search)
+**Description:** [read-only] Search for ABAP objects by name pattern. Parameters: object_name (with or without mask), object_type (optional), maxResults (optional). If object_type is specified, results are filtered by type.
+
+**Source:** `src/handlers/search/readonly/handleSearchObject.ts`
+
+**Parameters:**
+- `maxResults` (number, optional (default: 100)) - [read-only] Maximum number of results to return
+- `object_name` (string, required) - [read-only] Object name or mask (e.g. 
+- `object_type` (string, optional) - [read-only] Optional ABAP object type (e.g. 
+
+---
+
+<a id="read-only-system"></a>
+### Read-Only / System
+
+<a id="describebylist-read-only-system"></a>
+#### DescribeByList (Read-Only / System)
+**Description:** [read-only] Batch description for a list of ABAP objects. Input: objects: Array<{ name: string, type?: string }>. Each object may be of type: PROG/P, FUGR, PROG/I, CLAS/OC, FUGR/FC, INTF/OI, TABLE, STRUCTURE, etc.
+
+**Source:** `src/handlers/system/readonly/handleDescribeByList.ts`
+
+**Parameters:**
+- `objects` (array, required) - [read-only] Object name (required, must be valid ABAP object name or mask)
+- `type` (string, optional) - [read-only] Optional type (e.g. PROG/P, CLAS/OC, etc.)
+
+---
+
+<a id="getabapast-read-only-system"></a>
+#### GetAbapAST (Read-Only / System)
+**Description:** [read-only] Parse ABAP code and return AST (Abstract Syntax Tree) in JSON format.
+
+**Source:** `src/handlers/system/readonly/handleGetAbapAST.ts`
+
+**Parameters:**
+- `code` (string, required) - ABAP source code to parse
+- `filePath` (string, optional) - Optional file path to write the result to
+
+---
+
+<a id="getabapsemanticanalysis-read-only-system"></a>
+#### GetAbapSemanticAnalysis (Read-Only / System)
+**Description:** [read-only] Perform semantic analysis on ABAP code and return symbols, types, scopes, and dependencies.
+
+**Source:** `src/handlers/system/readonly/handleGetAbapSemanticAnalysis.ts`
+
+**Parameters:**
+- `code` (string, required) - ABAP source code to analyze
+- `filePath` (string, optional) - Optional file path to write the result to
+
+---
+
+<a id="getabapsystemsymbols-read-only-system"></a>
+#### GetAbapSystemSymbols (Read-Only / System)
+**Description:** [read-only] Resolve ABAP symbols from semantic analysis with SAP system information including types, scopes, descriptions, and packages.
+
+**Source:** `src/handlers/system/readonly/handleGetAbapSystemSymbols.ts`
+
+**Parameters:**
+- `code` (string, required) - ABAP source code to analyze and resolve symbols for
+- `filePath` (string, optional) - Optional file path to write the result to
+
+---
+
+<a id="getadttypes-read-only-system"></a>
+#### GetAdtTypes (Read-Only / System)
+**Description:** [read-only] Retrieve all valid ADT object types.
+
+**Source:** `src/handlers/system/readonly/handleGetAllTypes.ts`
+
+**Parameters:**
+- `validate_type` (string, optional) - Type name to validate (optional)
+
+---
+
+<a id="getinactiveobjects-read-only-system"></a>
+#### GetInactiveObjects (Read-Only / System)
+**Description:** [read-only] Get a list of inactive ABAP objects (objects that have been modified but not activated).
+
+**Source:** `src/handlers/system/readonly/handleGetInactiveObjects.ts`
+
+**Parameters:**
+- None
+
+---
+
+<a id="getobjectinfo-read-only-system"></a>
+#### GetObjectInfo (Read-Only / System)
+**Description:** [read-only] Return ABAP object tree: root, group nodes, and terminal leaves up to maxDepth. Enrich each node via SearchObject if enrich=true. Group nodes are included for hierarchy. Each node has node_type: root, point, end.
+
+**Source:** `src/handlers/system/readonly/handleGetObjectInfo.ts`
+
+**Parameters:**
+- `enrich` (boolean, optional (default: true)) - [read-only] Whether to add description and package via SearchObject (default true)
+- `maxDepth` (integer, optional (default: 1)) - [read-only] Maximum tree depth (default depends on type)
+- `parent_name` (string, required) - [read-only] Parent object name
+- `parent_type` (string, required) - [read-only] Parent object type (e.g. DEVC/K, CLAS/OC, PROG/P)
+
+---
+
+<a id="getobjectnodefromcache-read-only-system"></a>
+#### GetObjectNodeFromCache (Read-Only / System)
+**Description:** [read-only] Returns a node from the in-memory objects list cache by OBJECT_TYPE, OBJECT_NAME, TECH_NAME, and expands OBJECT_URI if present.
+
+**Source:** `src/handlers/system/readonly/handleGetObjectNodeFromCache.ts`
+
+**Parameters:**
+- None
+
+---
+
+<a id="getobjectstructure-read-only-system"></a>
+#### GetObjectStructure (Read-Only / System)
+**Description:** [read-only] Retrieve ADT object structure as a compact JSON tree.
+
+**Source:** `src/handlers/system/readonly/handleGetObjectStructure.ts`
+
+**Parameters:**
+- `objectname` (string, required) - ADT object name (e.g. /CBY/ACQ_DDL)
+- `objecttype` (string, required) - ADT object type (e.g. DDLS/DF)
+
+---
+
+<a id="getsession-read-only-system"></a>
+#### GetSession (Read-Only / System)
+**Description:** [read-only] Get a new session ID and current session state (cookies, CSRF token) for reuse across multiple ADT operations. Use this to maintain the same session and lock handle across multiple requests.
+
+**Source:** `src/handlers/system/readonly/handleGetSession.ts`
+
+**Parameters:**
+- `force_new` (boolean, optional) - Force creation of a new session even if one exists. Default: false
+
+---
+
+<a id="getsqlquery-read-only-system"></a>
+#### GetSqlQuery (Read-Only / System)
+**Description:** [read-only] Execute freestyle SQL queries via SAP ADT Data Preview API.
+
+**Source:** `src/handlers/system/readonly/handleGetSqlQuery.ts`
+
+**Parameters:**
+- `row_number` (number, optional (default: 100)) - [read-only] Maximum number of rows to return
+- `sql_query` (string, required) - SQL query to execute
+
+---
+
+<a id="gettransaction-read-only-system"></a>
+#### GetTransaction (Read-Only / System)
+**Description:** [read-only] Retrieve ABAP transaction details.
+
+**Source:** `src/handlers/system/readonly/handleGetTransaction.ts`
+
+**Parameters:**
+- `transaction_name` (string, required) - Name of the ABAP transaction
+
+---
+
+<a id="gettypeinfo-read-only-system"></a>
+#### GetTypeInfo (Read-Only / System)
+**Description:** [read-only] Retrieve ABAP type information.
+
+**Source:** `src/handlers/system/readonly/handleGetTypeInfo.ts`
+
+**Parameters:**
+- `type_name` (string, required) - Name of the ABAP type
+
+---
+
+<a id="getwhereused-read-only-system"></a>
+#### GetWhereUsed (Read-Only / System)
+**Description:** [read-only] Retrieve where-used references for ABAP objects via ADT usageReferences. Returns parsed list of referencing objects with their types and packages.
+
+**Source:** `src/handlers/system/readonly/handleGetWhereUsed.ts`
+
+**Parameters:**
+- `enable_all_types` (boolean, optional (default: false)) - If true, searches in all available object types (Eclipse 
+- `object_name` (string, required) - Name of the ABAP object
+- `object_type` (string, required) - Type of the ABAP object (class, interface, program, table, etc.)
+
+---
+
+<a id="read-only-table"></a>
+### Read-Only / Table
+
+<a id="gettablecontents-read-only-table"></a>
+#### GetTableContents (Read-Only / Table)
+**Description:** [read-only] Retrieve contents of an ABAP table.
+
+**Source:** `src/handlers/table/readonly/handleGetTableContents.ts`
+
+**Parameters:**
+- None
+
+---
+
+<a id="read-only-transport"></a>
+### Read-Only / Transport
+
+<a id="gettransport-read-only-transport"></a>
+#### GetTransport (Read-Only / Transport)
+**Description:** [read-only] Retrieve ABAP transport request information including metadata, included objects, and status from SAP system.
+
+**Source:** `src/handlers/transport/readonly/handleGetTransport.ts`
+
+**Parameters:**
+- `include_objects` (boolean, optional (default: true))) - Include list of objects in transport (default: true)
+- `include_tasks` (boolean, optional (default: true))) - Include list of tasks in transport (default: true)
+- `transport_number` (string, required) - Transport request number (e.g., E19K905635, DEVK905123)
+
+---
+
+*Last updated: 2026-02-12*

package/docs/user-guide/CLIENT_CONFIGURATION.md

@@ -126,17 +126,19 @@ The server supports destination-based authentication using service keys stored l
 
 The server uses auth-broker (service keys) in the following cases:
 
-1. **By default** (when `--env` is not specified AND no `.env` file exists in current directory): Auth-broker is used automatically
+1. **By default** (when no explicit env file/destination is provided and no `.env` exists in current directory): Auth-broker is used automatically
 2. **When `--auth-broker` flag is specified**: Forces use of auth-broker, ignoring any `.env` file (even if it exists in current directory)
 3. **When `--mcp` parameter is specified**: Uses auth-broker with the specified destination, `.env` file is not loaded automatically
-4. **When `--env` is specified**: Uses the specified `.env` file instead of auth-broker
+4. **When `--env=<destination>` is specified**: Uses destination env file from sessions store
+5. **When `--env-path=<path|file>` is specified**: Uses explicit `.env` file instead of auth-broker
 
 **Priority:**
-1. `--env=<path>` - explicit .env file (highest priority)
-2. `--mcp=<destination>` - uses auth-broker, skips .env file loading
-3. `.env` in current directory - used automatically if exists (default behavior)
-4. `--auth-broker` - force auth-broker, ignore .env
-5. Auth-broker - used if no .env found (fallback)
+1. `--env-path=<path|file>` (or `MCP_ENV_PATH`) - explicit `.env` file (highest priority)
+2. `--env=<destination>` - destination env from sessions store
+3. `--mcp=<destination>` - uses auth-broker, skips automatic `.env` loading
+4. `.env` in current directory - used automatically if exists (default behavior)
+5. `--auth-broker` - force auth-broker, ignore `.env`
+6. Auth-broker - used if no `.env` found (fallback)
 
 **Examples:**
 ```bash
@@ -149,8 +151,11 @@ mcp-abap-adt --auth-broker
 # Uses auth-broker with --mcp parameter (skips .env file)
 mcp-abap-adt --transport=stdio --mcp=TRIAL
 
-# Uses .env file from custom path
-mcp-abap-adt --env=/path/to/.env
+# Uses destination env from sessions store
+mcp-abap-adt --env=trial
+
+# Uses explicit .env file from custom path
+mcp-abap-adt --env-path=/path/to/.env
 ```
 
 ### How It Works
@@ -427,13 +432,13 @@ mcp-abap-adt --auth-broker
 # Forces use of auth-broker with custom path (creates service-keys and sessions subdirectories)
 mcp-abap-adt --auth-broker --auth-broker-path=~/prj/tmp/
 
-# Uses .env file from current directory (must be explicitly specified)
-mcp-abap-adt --env=.env
-mcp-abap-adt --env .env
+# Uses destination env from sessions store
+mcp-abap-adt --env=trial
+mcp-abap-adt --env trial
 
-# Uses .env file from custom path
-mcp-abap-adt --env=/path/to/.env
-mcp-abap-adt --env /path/to/.env
+# Uses explicit .env file from custom path
+mcp-abap-adt --env-path=/path/to/.env
+mcp-abap-adt --env-path /path/to/.env
 ```
 
 **Behavior:**
@@ -449,7 +454,10 @@ mcp-abap-adt --env /path/to/.env
   - With `--unsafe`, session tokens are saved to `.env` files in the sessions directory
   - Can be set via environment variable: `MCP_UNSAFE=true`
   - Use only if you need session persistence across server restarts
-- **`--env=<path>` or `--env <path>`**: Uses specified `.env` file, auth-broker is not used
+- **`--env=<destination>` or `--env <destination>`**: Uses destination env file from sessions store
+  - Unix: `~/.config/mcp-abap-adt/sessions/<destination>.env`
+  - Windows: `%USERPROFILE%\Documents\mcp-abap-adt\sessions\<destination>.env`
+- **`--env-path=<path|file>`**: Uses specified `.env` file directly, auth-broker is not used
   - Relative paths are resolved from current working directory
   - Absolute paths are used as-is
 

package/docs/user-guide/CLI_OPTIONS.md

@@ -46,27 +46,33 @@ Command-line arguments always override YAML values, allowing you to use YAML as
 
 ### Environment File Configuration
 
-**--env=\<path\>** or **--env \<path\>**
+**--env=\<destination\>** or **--env \<destination\>**
 
-Specify path to .env file containing SAP connection details.
+Use destination-style env lookup from platform sessions store.
+
+**--env-path=\<path|file\>**
+
+Use an explicit `.env` file path (or relative file name).
 
 ```bash
-# Absolute path
-mcp-abap-adt --env=/opt/config/sap-prod.env
+# Destination name -> sessions/<destination>.env
+mcp-abap-adt --env=trial
 
-# Relative path (resolved from current directory)
-mcp-abap-adt --env=../configs/dev.env
+# Explicit path
+mcp-abap-adt --env-path=/opt/config/sap-prod.env
 
-# Space-separated syntax
-mcp-abap-adt --env ~/sap-configs/production.env
+# Relative file name/path (resolved from current directory)
+mcp-abap-adt --env-path=../configs/dev.env
 ```
 
 **Environment File Priority:**
 
-The server looks for .env file in this order:
-1. Path specified via `--env` argument
-2. `.env` in current working directory (`process.cwd()`)
-3. `.env` in package installation directory
+The server resolves env file in this order:
+1. `--env-path=<path|file>` (or `MCP_ENV_PATH`)
+2. `--env=<destination>` -> platform sessions path:
+   - Unix: `~/.config/mcp-abap-adt/sessions/<destination>.env`
+   - Windows: `%USERPROFILE%\\Documents\\mcp-abap-adt\\sessions\\<destination>.env`
+3. `.env` in current working directory (`process.cwd()`)
 
 This allows you to:
 - Have different .env files per project
@@ -92,7 +98,7 @@ EOF
 mcp-abap-adt  # Uses ~/projects/abap-prod/.env
 
 # Override for testing
-mcp-abap-adt --env=/tmp/test.env
+mcp-abap-adt --env-path=/tmp/test.env
 ```
 
 ## Transport Selection
@@ -255,7 +261,7 @@ mcp-abap-adt --transport=http \
   --http-host=0.0.0.0 \
   --http-allowed-origins=http://localhost:3000,https://myapp.com \
   --http-enable-dns-protection \
-  --env=~/configs/sap-prod.env
+  --env-path=~/configs/sap-prod.env
 ```
 
 ## SSE Server Options
@@ -331,7 +337,7 @@ mcp-abap-adt --transport=sse \
   --sse-host=0.0.0.0 \
   --sse-allowed-origins=http://localhost:3000 \
   --sse-enable-dns-protection \
-  --env=~/configs/sap-dev.env
+  --env-path=~/configs/sap-dev.env
 ```
 
 ## Environment Variables
@@ -340,7 +346,7 @@ Alternative to command line arguments. Environment variables can be set in shell
 
 ### General
 
-- `MCP_ENV_PATH` - Path to .env file
+- `MCP_ENV_PATH` - Explicit path to `.env` file (same as `--env-path`)
 - `MCP_SKIP_ENV_LOAD` - Skip automatic .env loading (true|false)
 - `MCP_SKIP_AUTO_START` - Skip automatic server start (true|false, for testing)
 - `MCP_TRANSPORT` - Default transport type (stdio|http|sse)
@@ -415,7 +421,7 @@ MCP_HTTP_PORT=8080
 MCP_HTTP_ALLOWED_ORIGINS=http://localhost:3000,https://myapp.com
 
 # Use it
-mcp-abap-adt --transport=http --env ~/.mcp-abap-adt.env
+mcp-abap-adt --transport=http --env-path ~/.mcp-abap-adt.env
 ```
 
 ## Priority Order
@@ -466,7 +472,7 @@ EOF
 
 # Run with explicit config
 mcp-abap-adt --transport=http \
-  --env=/etc/mcp-abap-adt/prod.env \
+  --env-path=/etc/mcp-abap-adt/prod.env \
   --http-port=8080 \
   --http-enable-dns-protection
 ```
@@ -481,9 +487,9 @@ mcp-abap-adt --transport=http \
 └── prod.env
 
 # Quick switch
-alias mcp-dev='mcp-abap-adt --env=~/sap-configs/dev.env'
-alias mcp-test='mcp-abap-adt --env=~/sap-configs/test.env'
-alias mcp-prod='mcp-abap-adt --transport=http --env=~/sap-configs/prod.env --http-port=8080'
+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'
 
 # Use
 mcp-dev
@@ -539,7 +545,7 @@ Check which .env is being used:
 [MCP-ENV] ✓ Successfully loaded: /home/user/project/.env
 
 # Or use explicit path
-mcp-abap-adt --env=/correct/path/.env
+mcp-abap-adt --env-path=/correct/path/.env
 ```
 
 ## See Also

package/docs/user-guide/HANDLERS_MANAGEMENT.md

@@ -49,16 +49,16 @@ V2 server supports flexible handler set configuration through the `--exposition`
 
 ```bash
 # Default: readonly + high (+ search + system always included)
-node bin/mcp-abap-adt-v2.js --transport=stdio --env=.env
+node bin/mcp-abap-adt-v2.js --transport=stdio --env-path=.env
 
 # Only read-only operations (safest)
-node bin/mcp-abap-adt-v2.js --transport=stdio --env=.env --exposition=readonly
+node bin/mcp-abap-adt-v2.js --transport=stdio --env-path=.env --exposition=readonly
 
 # Read-only + high-level writes (recommended)
-node bin/mcp-abap-adt-v2.js --transport=stdio --env=.env --exposition=readonly,high
+node bin/mcp-abap-adt-v2.js --transport=stdio --env-path=.env --exposition=readonly,high
 
 # All operations (dangerous, for development only)
-node bin/mcp-abap-adt-v2.js --transport=stdio --env=.env --exposition=readonly,high,low
+node bin/mcp-abap-adt-v2.js --transport=stdio --env-path=.env --exposition=readonly,high,low
 ```
 
 ### Config File
@@ -79,7 +79,7 @@ Set `MCP_EXPOSITION`:
 
 ```bash
 export MCP_EXPOSITION=readonly,high
-node bin/mcp-abap-adt-v2.js --transport=stdio --env=.env
+node bin/mcp-abap-adt-v2.js --transport=stdio --env-path=.env
 ```
 
 ## Generating Handler Documentation

package/docs/user-guide/README.md

@@ -56,7 +56,10 @@ See [Installation Guide](../installation/INSTALLATION.md) for full instructions.
 ## Documentation Files
 
 - **[CLIENT_CONFIGURATION.md](CLIENT_CONFIGURATION.md)** - Guide for configuring MCP clients to connect to the server, including HTTP header configuration for dynamic SAP connection setup
-- **[AVAILABLE_TOOLS.md](AVAILABLE_TOOLS.md)** - Complete list of all available MCP tools with descriptions and usage examples (auto-generated from handler definitions)
+- **[AVAILABLE_TOOLS_READONLY.md](AVAILABLE_TOOLS_READONLY.md)** - Read-only tools (auto-generated)
+- **[AVAILABLE_TOOLS_HIGH.md](AVAILABLE_TOOLS_HIGH.md)** - High-level tools (auto-generated)
+- **[AVAILABLE_TOOLS_LOW.md](AVAILABLE_TOOLS_LOW.md)** - Low-level tools (auto-generated)
+- **[AVAILABLE_TOOLS.md](AVAILABLE_TOOLS.md)** - Full combined tools reference (auto-generated)
 - **[AUTHENTICATION.md](AUTHENTICATION.md)** - Destination-based auth, service key locations, and header-based auth
 - **[TERMINOLOGY.md](TERMINOLOGY.md)** - Project-specific terminology
 - **[HANDLERS_MANAGEMENT.md](HANDLERS_MANAGEMENT.md)** - Enable/disable handler groups and exposure
@@ -67,7 +70,10 @@ See [Installation Guide](../installation/INSTALLATION.md) for full instructions.
 2. **Configure your client**:
    - **Auto (recommended)**: Use the configurator (`@mcp-abap-adt/configurator`, repo: `mcp-abap-adt-conf`)
    - **Manual**: See [CLIENT_CONFIGURATION.md](CLIENT_CONFIGURATION.md) for JSON/TOML examples
-3. **Explore available tools**: See [AVAILABLE_TOOLS.md](AVAILABLE_TOOLS.md) for a complete list of tools you can use
+3. **Explore available tools**:
+   - [Read-only tools](AVAILABLE_TOOLS_READONLY.md)
+   - [High-level tools](AVAILABLE_TOOLS_HIGH.md)
+   - [Low-level tools](AVAILABLE_TOOLS_LOW.md)
 
 ## Package Tree Output
 
@@ -85,19 +91,19 @@ After installing from package, these commands are available:
 
 ### `mcp-abap-adt` - Default HTTP transport
 ```bash
-mcp-abap-adt [--env /path/to/.env]
+mcp-abap-adt [--env <destination>] [--env-path /path/to/.env]
 ```
 Use with MCP clients like Claude Desktop, VSCode extensions.
 
 ### `mcp-abap-adt --transport=http` - HTTP server
 ```bash
-mcp-abap-adt --transport=http [--port 3000] [--host localhost] [--env /path/to/.env]
+mcp-abap-adt --transport=http [--port 3000] [--host localhost] [--env <destination>] [--env-path /path/to/.env]
 ```
 Starts HTTP server with StreamableHTTP transport.
 
 ### `mcp-abap-adt --transport=sse` - SSE server
 ```bash
-mcp-abap-adt --transport=sse [--port 3000] [--host localhost] [--env /path/to/.env]
+mcp-abap-adt --transport=sse [--port 3000] [--host localhost] [--env <destination>] [--env-path /path/to/.env]
 ```
 Starts HTTP server with Server-Sent Events transport.
 
@@ -115,5 +121,5 @@ mcp-abap-adt --transport=sse --host 0.0.0.0 --port 3000
 
 ### Example 3: Custom Environment File
 ```bash
-mcp-abap-adt --transport=http --env /opt/config/.env.production --port 8080
+mcp-abap-adt --transport=http --env-path /opt/config/.env.production --port 8080
 ```