@mcp-abap-adt/core 2.4.2 → 2.5.0

package/docs/user-guide/AVAILABLE_TOOLS_LOW.md

@@ -457,8 +457,14 @@ Generated from code in `src/handlers/**` (not from docs).
 **Source:** `src/handlers/class/low/handleRunClassUnitTests.ts`
 
 **Parameters:**
-- `test_class` (string, required) - Test class name inside the include (e.g., LTCL_MAIN_CLASS).
-- `tests` (array, optional) - List of container/test class pairs to execute.
+- `context` (string, optional) - Optional context string shown in SAP tools.
+- `duration` (object, optional) - 
+- `risk_level` (object, optional) - 
+- `scope` (object, optional) - 
+- `session_id` (string, optional) - Session ID from GetSession. If not provided, a new session will be created.
+- `session_state` (object, optional) - Session state from GetSession (cookies, csrf_token, cookie_store). Required if session_id is provided.
+- `tests` (array, required) - List of container/test class pairs to execute.
+- `title` (string, optional) - Optional title for the ABAP Unit run.
 
 ---
 
@@ -542,7 +548,8 @@ Generated from code in `src/handlers/**` (not from docs).
 **Source:** `src/handlers/common/low/handleActivateObject.ts`
 
 **Parameters:**
-- `objects` (array, optional) - Array of objects to activate. Each object must have 
+- `objects` (array, required) - Array of objects to activate. Each object must have 
+- `preaudit` (boolean, optional) - Request pre-audit before activation. Default: true
 
 ---
 
@@ -1686,9 +1693,11 @@ Generated from code in `src/handlers/**` (not from docs).
 **Source:** `src/handlers/system/low/handleGetVirtualFolders.ts`
 
 **Parameters:**
+- `facet_order` (array, optional (default: ['package)) - Order of facets in response (e.g., [
+- `ignore_short_descriptions` (boolean, optional (default: false)) - Ignore short descriptions in response
 - `object_search_pattern` (string, optional (default: *)) - Object search pattern (e.g., 
 - `preselection` (array, optional) - Optional preselection filters (facet-value pairs for filtering)
-- `values` (array, required) - Array of facet values to filter by
+- `with_versions` (boolean, optional (default: false)) - Include version information in response
 
 ---
 
@@ -1942,4 +1951,4 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
-*Last updated: 2026-02-15*
+*Last updated: 2026-02-21*

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: 32
+- Total tools: 36
 
 ## Navigation
 
@@ -40,11 +40,15 @@ Generated from code in `src/handlers/**` (not from docs).
     - [GetTransaction](#gettransaction-read-only-system)
     - [GetTypeInfo](#gettypeinfo-read-only-system)
     - [GetWhereUsed](#getwhereused-read-only-system)
+    - [RuntimeAnalyzeDump](#runtimeanalyzedump-read-only-system)
+    - [RuntimeAnalyzeProfilerTrace](#runtimeanalyzeprofilertrace-read-only-system)
     - [RuntimeCreateProfilerTraceParameters](#runtimecreateprofilertraceparameters-read-only-system)
     - [RuntimeGetDumpById](#runtimegetdumpbyid-read-only-system)
     - [RuntimeGetProfilerTraceData](#runtimegetprofilertracedata-read-only-system)
     - [RuntimeListDumps](#runtimelistdumps-read-only-system)
     - [RuntimeListProfilerTraceFiles](#runtimelistprofilertracefiles-read-only-system)
+    - [RuntimeRunClassWithProfiling](#runtimerunclasswithprofiling-read-only-system)
+    - [RuntimeRunProgramWithProfiling](#runtimerunprogramwithprofiling-read-only-system)
   - [Table](#read-only-table)
     - [GetTableContents](#gettablecontents-read-only-table)
   - [Transport](#read-only-transport)
@@ -174,6 +178,7 @@ Generated from code in `src/handlers/**` (not from docs).
 **Source:** `src/handlers/search/readonly/handleGetObjectsByType.ts`
 
 **Parameters:**
+- `format` (string, optional) - [read-only] Output format: 
 - `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
@@ -220,7 +225,6 @@ Generated from code in `src/handlers/**` (not from docs).
 
 **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.)
 
 ---
 
@@ -303,7 +307,9 @@ Generated from code in `src/handlers/**` (not from docs).
 **Source:** `src/handlers/system/readonly/handleGetObjectNodeFromCache.ts`
 
 **Parameters:**
-- None
+- `object_name` (string, required) - [read-only] Object name
+- `object_type` (string, required) - [read-only] Object type
+- `tech_name` (string, required) - [read-only] Technical name
 
 ---
 
@@ -378,6 +384,33 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
+<a id="runtimeanalyzedump-read-only-system"></a>
+#### RuntimeAnalyzeDump (Read-Only / System)
+**Description:** [runtime] Read runtime dump by ID and return compact analysis summary with key fields.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeAnalyzeDump.ts`
+
+**Parameters:**
+- `dump_id` (string, required) - Runtime dump ID.
+- `include_payload` (boolean, optional (default: true)) - Include full parsed payload in response.
+- `view` (string, optional (default: default)) - Dump view mode to analyze: default payload, summary section, or formatted long text.
+
+---
+
+<a id="runtimeanalyzeprofilertrace-read-only-system"></a>
+#### RuntimeAnalyzeProfilerTrace (Read-Only / System)
+**Description:** [runtime] Read profiler trace view and return compact analysis summary (totals + top entries).
+
+**Source:** `src/handlers/system/readonly/handleRuntimeAnalyzeProfilerTrace.ts`
+
+**Parameters:**
+- `top` (number, optional) - Number of top rows for summary. Default: 10.
+- `trace_id_or_uri` (string, required) - Profiler trace ID or full trace URI.
+- `view` (string, optional (default: hitlist)) - 
+- `with_system_events` (boolean, optional) - Include system events.
+
+---
+
 <a id="runtimecreateprofilertraceparameters-read-only-system"></a>
 #### RuntimeCreateProfilerTraceParameters (Read-Only / System)
 **Description:** [runtime] Create ABAP profiler trace parameters and return profilerId (URI) for profiled execution.
@@ -385,7 +418,20 @@ Generated from code in `src/handlers/**` (not from docs).
 **Source:** `src/handlers/system/readonly/handleRuntimeCreateProfilerTraceParameters.ts`
 
 **Parameters:**
+- `aggregate` (boolean, optional) - 
+- `all_db_events` (boolean, optional) - 
+- `all_dynpro_events` (boolean, optional) - 
+- `all_internal_table_events` (boolean, optional) - 
+- `all_misc_abap_statements` (boolean, optional) - 
+- `all_procedural_units` (boolean, optional) - 
+- `all_system_kernel_events` (boolean, optional) - 
+- `amdp_trace` (boolean, optional) - 
 - `description` (string, required) - Human-readable trace description.
+- `explicit_on_off` (boolean, optional) - 
+- `max_size_for_trace_file` (number, optional) - 
+- `max_time_for_tracing` (number, optional) - 
+- `sql_trace` (boolean, optional) - 
+- `with_rfc_tracing` (boolean, optional) - 
 
 ---
 
@@ -397,6 +443,7 @@ Generated from code in `src/handlers/**` (not from docs).
 
 **Parameters:**
 - `dump_id` (string, required) - Runtime dump ID (for example: 694AB694097211F1929806D06D234D38).
+- `view` (string, optional (default: default)) - Dump view mode: default payload, summary section, or formatted long text.
 
 ---
 
@@ -442,6 +489,56 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
+<a id="runtimerunclasswithprofiling-read-only-system"></a>
+#### RuntimeRunClassWithProfiling (Read-Only / System)
+**Description:** [runtime] Execute ABAP class with profiler enabled and return created profilerId + traceId.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeRunClassWithProfiling.ts`
+
+**Parameters:**
+- `aggregate` (boolean, optional) - 
+- `all_db_events` (boolean, optional) - 
+- `all_dynpro_events` (boolean, optional) - 
+- `all_internal_table_events` (boolean, optional) - 
+- `all_misc_abap_statements` (boolean, optional) - 
+- `all_procedural_units` (boolean, optional) - 
+- `all_system_kernel_events` (boolean, optional) - 
+- `amdp_trace` (boolean, optional) - 
+- `class_name` (string, required) - ABAP class name to execute.
+- `description` (string, optional) - Profiler trace description.
+- `explicit_on_off` (boolean, optional) - 
+- `max_size_for_trace_file` (number, optional) - 
+- `max_time_for_tracing` (number, optional) - 
+- `sql_trace` (boolean, optional) - 
+- `with_rfc_tracing` (boolean, optional) - 
+
+---
+
+<a id="runtimerunprogramwithprofiling-read-only-system"></a>
+#### RuntimeRunProgramWithProfiling (Read-Only / System)
+**Description:** [runtime] Execute ABAP program with profiler enabled and return created profilerId + traceId.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeRunProgramWithProfiling.ts`
+
+**Parameters:**
+- `aggregate` (boolean, optional) - 
+- `all_db_events` (boolean, optional) - 
+- `all_dynpro_events` (boolean, optional) - 
+- `all_internal_table_events` (boolean, optional) - 
+- `all_misc_abap_statements` (boolean, optional) - 
+- `all_procedural_units` (boolean, optional) - 
+- `all_system_kernel_events` (boolean, optional) - 
+- `amdp_trace` (boolean, optional) - 
+- `description` (string, optional) - Profiler trace description.
+- `explicit_on_off` (boolean, optional) - 
+- `max_size_for_trace_file` (number, optional) - 
+- `max_time_for_tracing` (number, optional) - 
+- `program_name` (string, required) - ABAP program name to execute.
+- `sql_trace` (boolean, optional) - 
+- `with_rfc_tracing` (boolean, optional) - 
+
+---
+
 <a id="read-only-table"></a>
 ### Read-Only / Table
 
@@ -472,4 +569,4 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
-*Last updated: 2026-02-15*
+*Last updated: 2026-02-21*

package/docs/user-guide/HANDLERS_MANAGEMENT.md

@@ -26,11 +26,43 @@ V2 server supports flexible handler set configuration through the `--exposition`
    - System modifications
    - Database operations
 
-4. **search** - Always included automatically
+4. **compact** - Compact facade operations
+   - `HandlerValidate`
+   - `HandlerActivate`
+   - `HandlerLock`
+   - `HandlerUnlock`
+   - `HandlerCheckRun`
+   - `HandlerUnitTestRun`, `HandlerUnitTestStatus`, `HandlerUnitTestResult`
+   - `HandlerCdsUnitTestStatus`, `HandlerCdsUnitTestResult`
+   - `HandlerProfileRun`, `HandlerProfileList`, `HandlerProfileView`
+   - `HandlerDumpList`, `HandlerDumpView`
+   - `HandlerServiceBindingListTypes`, `HandlerServiceBindingValidate`
+   - `HandlerTransportCreate`
+   - `HandlerCreate`
+   - `HandlerGet`
+   - `HandlerUpdate`
+   - `HandlerDelete`
+   - Contract:
+     - CRUD via `HandlerCreate|Get|Update|Delete` + required `object_type`
+     - Lifecycle via `HandlerValidate|Activate|Lock|Unlock|CheckRun`
+     - Runtime/tests/service-binding/transport via dedicated compact handlers
+   - Source of truth for compact route coverage:
+     - `src/handlers/compact/high/compactMatrix.ts`
+     - auto-reflected into `docs/user-guide/AVAILABLE_TOOLS_COMPACT.md`
+   - Current action coverage:
+     - `UNIT_TEST`: `run`, `status`, `result`
+     - `CDS_UNIT_TEST`: `status`, `result`
+     - `SERVICE_BINDING`: `list_types`, `validate`
+     - `TRANSPORT`: `create_transport`
+     - `CLASS` / `PROGRAM`: `runProfiling`
+     - `RUNTIME_PROFILE`: `viewProfiles`, `viewProfile`
+     - `RUNTIME_DUMP`: `viewDumps`, `viewDump`
+
+5. **search** - Always included automatically
    - Object search
    - Code search
 
-5. **system** - Always included automatically  
+6. **system** - Always included automatically  
    - Where-used analysis (GetWhereUsed)
    - Type information (GetTypeInfo)
    - Object info (GetObjectInfo)
@@ -57,8 +89,11 @@ node bin/mcp-abap-adt-v2.js --transport=stdio --env-path=.env --exposition=reado
 # Read-only + high-level writes (recommended)
 node bin/mcp-abap-adt-v2.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
+
 # All operations (dangerous, for development only)
-node bin/mcp-abap-adt-v2.js --transport=stdio --env-path=.env --exposition=readonly,high,low
+node bin/mcp-abap-adt-v2.js --transport=stdio --env-path=.env --exposition=readonly,high,low,compact
 ```
 
 ### Config File
@@ -71,6 +106,7 @@ envFile: .env
 exposition:
   - readonly
   - high
+  - compact
 ```
 
 ### Environment Variable
@@ -90,7 +126,14 @@ node bin/mcp-abap-adt-v2.js --transport=stdio --env-path=.env
 npm run docs:tools
 ```
 
-This generates `docs/user-guide/AVAILABLE_TOOLS.md` with:
+This generates:
+- `docs/user-guide/AVAILABLE_TOOLS.md`
+- `docs/user-guide/AVAILABLE_TOOLS_READONLY.md`
+- `docs/user-guide/AVAILABLE_TOOLS_HIGH.md`
+- `docs/user-guide/AVAILABLE_TOOLS_LOW.md`
+- `docs/user-guide/AVAILABLE_TOOLS_COMPACT.md`
+
+With:
 - All available handlers
 - Parameters and types
 - Usage examples
@@ -165,6 +208,9 @@ if (config.exposition.includes('readonly')) {
 if (config.exposition.includes('high')) {
   handlerGroups.push(new HighLevelHandlersGroup(baseContext));
 }
+if (config.exposition.includes('compact')) {
+  handlerGroups.push(new CompactHandlersGroup(baseContext));
+}
 if (config.exposition.includes('low')) {
   handlerGroups.push(new LowLevelHandlersGroup(baseContext));
 }

package/docs/user-guide/README.md

@@ -59,6 +59,7 @@ See [Installation Guide](../installation/INSTALLATION.md) for full instructions.
 - **[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_COMPACT.md](AVAILABLE_TOOLS_COMPACT.md)** - Compact facade 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
@@ -74,6 +75,7 @@ See [Installation Guide](../installation/INSTALLATION.md) for full instructions.
    - [Read-only tools](AVAILABLE_TOOLS_READONLY.md)
    - [High-level tools](AVAILABLE_TOOLS_HIGH.md)
    - [Low-level tools](AVAILABLE_TOOLS_LOW.md)
+   - [Compact tools](AVAILABLE_TOOLS_COMPACT.md)
 
 ## Package Tree Output
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mcp-abap-adt/core",
   "mcpName": "io.github.fr0ster/mcp-abap-adt",
-  "version": "2.4.2",
+  "version": "2.5.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {