@mcp-abap-adt/core 3.1.0 → 4.0.0

package/docs/installation/RFC_SETUP.md

@@ -0,0 +1,101 @@
+# RFC Connection Setup (Legacy Systems)
+
+RFC connections are required for legacy SAP systems (BASIS < 7.50) where HTTP stateful sessions are not supported. Without RFC, lock handles are lost between requests, causing update/unlock operations to fail.
+
+## Prerequisites
+
+### 1. SAP NW RFC SDK
+
+Download from [SAP Support Portal](https://support.sap.com/en/product/connectors/nwrfcsdk.html) (requires S-user).
+
+Extract to a local directory, e.g. `C:\nwrfcsdk\nwrfcsdk` (Windows) or `~/nwrfcsdk` (Linux/macOS).
+
+### 2. Environment Variables
+
+The SDK requires two shell-level environment variables. These **must** be set in the shell before starting Node.js — `.env` files do not work for this.
+
+**Windows (PowerShell profile — persistent):**
+
+Add to `$PROFILE` (usually `~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1`):
+
+```powershell
+$env:SAPNWRFC_HOME = "C:\nwrfcsdk\nwrfcsdk"
+$env:PATH = "C:\nwrfcsdk\nwrfcsdk\lib;$env:PATH"
+```
+
+**Windows (System Environment Variables — persistent):**
+
+1. Open **System Properties** > **Environment Variables**
+2. Add `SAPNWRFC_HOME` = `C:\nwrfcsdk\nwrfcsdk`
+3. Append `C:\nwrfcsdk\nwrfcsdk\lib` to `PATH`
+
+**Linux/macOS (bash/zsh profile — persistent):**
+
+Add to `~/.bashrc` or `~/.zshrc`:
+
+```bash
+export SAPNWRFC_HOME=~/nwrfcsdk
+export PATH=$SAPNWRFC_HOME/lib:$PATH
+# Linux only:
+export LD_LIBRARY_PATH=$SAPNWRFC_HOME/lib:${LD_LIBRARY_PATH:-}
+```
+
+### 3. node-rfc Package
+
+```bash
+npm install node-rfc
+```
+
+`node-rfc` is loaded dynamically at runtime — it is not a declared dependency.
+
+Verify installation:
+
+```bash
+node -e "try { require('node-rfc'); console.log('OK'); } catch(e) { console.log(e.message); }"
+```
+
+### 4. SAP Authorization
+
+The SAP user needs `S_RFC` authorization for function module `SADT_REST_RFC_ENDPOINT`. See SAP Note 3569684.
+
+## .env Configuration
+
+For RFC connections, use two separate variables — one for authentication, one for connection type:
+
+```env
+SAP_URL=http://saphost:8000
+SAP_USERNAME=DEVELOPER
+SAP_PASSWORD=secret
+SAP_CLIENT=100
+SAP_AUTH_TYPE=basic
+SAP_CONNECTION_TYPE=rfc
+```
+
+- `SAP_AUTH_TYPE` — authentication method (`basic` or `jwt`). RFC uses basic auth with username/password.
+- `SAP_CONNECTION_TYPE` — transport layer (`http` or `rfc`). Set to `rfc` for legacy systems.
+
+## How It Works
+
+1. `SAP_CONNECTION_TYPE=rfc` tells the server to create an `RfcAbapConnection` instead of HTTP
+2. The connection calls SAP function module `SADT_REST_RFC_ENDPOINT` for every ADT request
+3. The RFC session is inherently stateful — lock handles persist across calls
+4. Host and system number are derived from `SAP_URL` (port 80XX -> system number XX)
+
+## Troubleshooting
+
+### "node-rfc is not available"
+
+SAP NW RFC SDK is not installed or not in PATH. Check:
+
+```bash
+echo $SAPNWRFC_HOME
+node -e "require('node-rfc')"
+```
+
+### "The specified module could not be found: sapnwrfc.node"
+
+The native module exists but can't load SDK DLLs. Ensure `SAPNWRFC_HOME/lib` is in PATH **before** starting Node.js. Restart your terminal after setting variables.
+
+### "RFC connection is not open"
+
+The server failed to connect via RFC. Check SAP system availability, credentials, and `S_RFC` authorization.

package/docs/installation/examples/README.md

@@ -176,7 +176,7 @@ Create `.env` file with your SAP credentials:
 ```env
 SAP_URL=https://your-sap-system.com
 SAP_CLIENT=100
-SAP_USER=your-username
+SAP_USERNAME=your-username
 SAP_PASSWORD=your-password
 ```
 

package/docs/roadmaps/LEGACY_SUPPORT.md

@@ -0,0 +1,146 @@
+# Roadmap: Legacy ABAP System Support (BASIS < 7.50)
+
+## Motivation
+
+MCP server currently works only with modern SAP systems (S/4 HANA, BTP ABAP Cloud).
+Many customers run older on-premise systems (BASIS 7.40 and below) where:
+- ADT endpoints are limited (~124 vs ~800+ on modern)
+- HTTP stateful sessions (`x-sap-adt-sessiontype: stateful`) not supported
+- Versioned content types (v2+/v3+/v4+) not supported
+- Group deletion API (`/sap/bc/adt/deletion/`) not available
+
+`@mcp-abap-adt/adt-clients@3.0.0` introduces `AdtClientLegacy` and `createAdtClient()` factory.
+`@mcp-abap-adt/connection@1.4.2` introduces `RfcAbapConnection` for stateful RFC transport.
+
+## Migration Steps
+
+### Step 1: Upgrade dependencies [DONE]
+
+```
+@mcp-abap-adt/adt-clients  ^2.2.2 -> 3.0.0
+@mcp-abap-adt/connection   ^1.1.0 -> 1.4.2
+```
+
+API is backward-compatible. Existing code compiles without changes.
+
+### Step 2: System detection at connection init [DONE]
+
+Detect system type once when connection is established. Cache `isLegacy` flag.
+
+**Where:** `src/lib/utils.ts` — `getOrCreateConnectionForServer()`, after `connection.connect()`.
+
+```typescript
+import { isModernAdtSystem } from '@mcp-abap-adt/adt-clients';
+
+// After connection.connect():
+const isModern = await isModernAdtSystem(connection);
+// Store in module-level cache alongside cachedConnection
+```
+
+**Alternative:** add `isLegacy` to system context (`src/lib/systemContext.ts`).
+
+### Step 3: Switch client factory to use detection [DONE]
+
+**Where:** `src/lib/clients.ts`
+
+Current (sync, always modern):
+```typescript
+export function createAdtClient(connection, logger): AdtClient {
+  return new AdtClient(connection, logger, options);
+}
+```
+
+New (sync, uses cached detection):
+```typescript
+import { AdtClientLegacy } from '@mcp-abap-adt/adt-clients';
+
+export function createAdtClient(connection, logger): AdtClient {
+  const ctx = getSystemContext();
+  const options = { masterSystem: ctx.masterSystem, responsible: ctx.responsible };
+  if (ctx.isLegacy) {
+    return new AdtClientLegacy(connection, logger, options);
+  }
+  return new AdtClient(connection, logger, options);
+}
+```
+
+No handler changes needed — `AdtClientLegacy extends AdtClient`, same interface.
+
+### Step 4: Add RFC auth type support [DONE]
+
+**Where:** `src/lib/config.ts`, `src/lib/utils.ts`
+
+New env vars:
+```
+SAP_AUTH_TYPE=rfc
+SAP_USERNAME=DEVELOPER
+SAP_PASSWORD=secret
+SAP_CLIENT=100
+```
+
+Config builder:
+```typescript
+if (process.env.SAP_AUTH_TYPE === 'rfc') {
+  authType = 'rfc';
+  config.username = process.env.SAP_USERNAME;
+  config.password = process.env.SAP_PASSWORD;
+  config.client = process.env.SAP_CLIENT;
+}
+```
+
+`createAbapConnection()` from connection package already handles `authType: 'rfc'`.
+`node-rfc` is loaded dynamically — no error if not installed and not used.
+
+### Step 5: Launcher CLI support [DONE]
+
+**Where:** `src/server/launcher.ts`, `src/lib/config/ArgumentsParser.ts`
+
+CLI flag `--connection-type=rfc` added. Also reads `SAP_CONNECTION_TYPE` env var.
+Auto-detection from env works via `.env` file hydration in launcher.
+
+### Step 6: Verify handler error handling [DONE]
+
+`BaseMcpServer` filters tools at registration time based on `available_in` vs
+detected system type (`isLegacy` from `systemContext`). Unsupported tools are
+simply not registered — they don't appear in the tool list for the MCP client.
+
+`AdtClientLegacy` also throws on unsupported types as a second safety layer.
+All handlers wrap errors via `return_error()` / `McpError`, no raw stack traces.
+
+### Step 7: Tool descriptions for legacy awareness [DONE]
+
+Every handler TOOL_DEFINITION has `available_in` field with supported environments.
+`BaseMcpServer` uses this + `isLegacy` to filter tools at registration time.
+Unsupported tools are hidden from the client automatically.
+
+### Step 8: Integration tests on legacy system
+
+- Need access to legacy system (E77-class, BASIS ~7.40)
+- Test config with `sap_auth_type: rfc`
+- Tests should auto-skip unsupported operations based on system detection
+- RFC tests need SAP NW RFC SDK installed on test machine
+
+## Object Support Matrix (Legacy)
+
+### Full CRUD
+Program, Class, Interface, FunctionGroup, FunctionModule, View
+
+### Read/Update/Delete only
+Package (no validate, no create)
+
+### Read-only utilities
+Search, NodeStructure, ObjectStructure, Activation, CheckRuns, UnitTest
+
+### Not available
+Domain, DataElement, Structure, Table, TableType, BDEF, BIMP, DDLX,
+ServiceDefinition, ServiceBinding, AccessControl, Enhancement,
+Where-used, Table contents, SQL query, Runtime profiling/dumps
+
+## Risks
+
+| Risk | Mitigation |
+|------|-----------|
+| node-rfc needs SAP NW RFC SDK native lib | Dynamic import; graceful error if not installed; only loaded for `authType: 'rfc'` |
+| Docker images need SDK | Document; provide Dockerfile with SDK layer |
+| Legacy endpoint differences between versions | Discovery-based detection, not hardcoded |
+| One extra HTTP call at startup (core/discovery) | Cached, happens once |

package/docs/user-guide/AVAILABLE_TOOLS.md

@@ -4,9 +4,9 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ## Summary
 
-- Total tools: 276
+- Total tools: 272
 - Read-only tools: 37
-- High-level tools: 117
+- High-level tools: 113
 - Low-level tools: 122
 
 - Compact tools: 22 (included in High-level group)
@@ -81,10 +81,6 @@ Generated from code in `src/handlers/**` (not from docs).
     - [UpdateBehaviorImplementation](#updatebehaviorimplementation-high-level-behavior-implementation)
   - [Class](#high-level-class)
     - [CreateClass](#createclass-high-level-class)
-    - [CreateLocalDefinitions](#createlocaldefinitions-high-level-class)
-    - [CreateLocalMacros](#createlocalmacros-high-level-class)
-    - [CreateLocalTestClass](#createlocaltestclass-high-level-class)
-    - [CreateLocalTypes](#createlocaltypes-high-level-class)
     - [DeleteClass](#deleteclass-high-level-class)
     - [DeleteLocalDefinitions](#deletelocaldefinitions-high-level-class)
     - [DeleteLocalMacros](#deletelocalmacros-high-level-class)
@@ -942,16 +938,14 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="createbehaviorimplementation-high-level-behavior-implementation"></a>
 #### CreateBehaviorImplementation (High-Level / Behavior Implementation)
-**Description:** Create a new ABAP behavior implementation class for a behavior definition. Behavior implementations contain the business logic for RAP entities. Uses stateful session for proper lock management.
+**Description:** Create a new ABAP behavior implementation class for a behavior definition. Creates the object in initial state. Use UpdateBehaviorImplementation to set implementation code afterwards.
 
 **Source:** `src/handlers/behavior_implementation/high/handleCreateBehaviorImplementation.ts`
 
 **Parameters:**
-- `activate` (boolean, optional) - Activate behavior implementation after creation. Default: true.
 - `behavior_definition` (string, required) - Behavior Definition name (e.g., ZI_MY_ENTITY). The behavior definition must exist.
 - `class_name` (string, required) - Behavior Implementation class name (e.g., ZBP_MY_ENTITY). Must follow SAP naming conventions (typically starts with ZBP_ for behavior implementations).
 - `description` (string, optional) - Class description. If not provided, class_name will be used.
-- `implementation_code` (string, optional) - Implementation code for the implementations include (optional). Contains the actual behavior implementation methods.
 - `package_name` (string, required) - Package name (e.g., ZOK_LOCAL, $TMP for local objects)
 - `transport_request` (string, optional) - Transport request number (e.g., E19K905635). Required for transportable packages.
 
@@ -1001,81 +995,22 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="createclass-high-level-class"></a>
 #### CreateClass (High-Level / Class)
-**Description:** Create a new ABAP class with optional activation. Manages validation, lock, check, update, unlock, and optional activation.
+**Description:** Create a new ABAP class in SAP system. Creates the class object in initial state. Use UpdateClass to set source code afterwards.
 
 **Source:** `src/handlers/class/high/handleCreateClass.ts`
 
 **Parameters:**
 - `abstract` (boolean, optional) - Mark class as abstract. Default: false
-- `activate` (boolean, optional) - Activate after creation. Default: true.
 - `class_name` (string, required) - Class name (e.g., ZCL_TEST_CLASS_001).
 - `create_protected` (boolean, optional) - Protected constructor. Default: false
 - `description` (string, optional) - Class description (defaults to class_name).
 - `final` (boolean, optional) - Mark class as final. Default: false
 - `package_name` (string, required) - Package name (e.g., ZOK_LAB, $TMP).
-- `source_code` (string, optional) - Full ABAP class source code. If omitted, a minimal template is generated.
 - `superclass` (string, optional) - Optional superclass name.
 - `transport_request` (string, optional) - Transport request number (required for transportable packages).
 
 ---
 
-<a id="createlocaldefinitions-high-level-class"></a>
-#### CreateLocalDefinitions (High-Level / Class)
-**Description:** Create local definitions in an ABAP class (definitions include). Manages lock, check, update, unlock, and optional activation.
-
-**Source:** `src/handlers/class/high/handleCreateLocalDefinitions.ts`
-
-**Parameters:**
-- `activate_on_create` (boolean, optional (default: false)) - Activate parent class after creating. Default: false
-- `class_name` (string, required) - Parent class name (e.g., ZCL_MY_CLASS).
-- `definitions_code` (string, required) - Source code for local definitions.
-- `transport_request` (string, optional) - Transport request number.
-
----
-
-<a id="createlocalmacros-high-level-class"></a>
-#### CreateLocalMacros (High-Level / Class)
-**Description:** Create local macros in an ABAP class (macros include). Manages lock, check, update, unlock, and optional activation. Note: Macros are supported in older ABAP versions but not in newer ones.
-
-**Source:** `src/handlers/class/high/handleCreateLocalMacros.ts`
-
-**Parameters:**
-- `activate_on_create` (boolean, optional (default: false)) - Activate parent class after creating. Default: false
-- `class_name` (string, required) - Parent class name (e.g., ZCL_MY_CLASS).
-- `macros_code` (string, required) - Source code for local macros.
-- `transport_request` (string, optional) - Transport request number.
-
----
-
-<a id="createlocaltestclass-high-level-class"></a>
-#### CreateLocalTestClass (High-Level / Class)
-**Description:** Create a local test class in an ABAP class. Manages lock, check, update, unlock, and optional activation of parent class.
-
-**Source:** `src/handlers/class/high/handleCreateLocalTestClass.ts`
-
-**Parameters:**
-- `activate_on_create` (boolean, optional (default: false)) - Activate parent class after creating test class. Default: false
-- `class_name` (string, required) - Parent class name (e.g., ZCL_MY_CLASS).
-- `test_class_code` (string, required) - Source code for the local test class.
-- `test_class_name` (string, optional) - Optional test class name (e.g., lcl_test).
-- `transport_request` (string, optional) - Transport request number (required for transportable objects).
-
----
-
-<a id="createlocaltypes-high-level-class"></a>
-#### CreateLocalTypes (High-Level / Class)
-**Description:** Create local types in an ABAP class (implementations include). Manages lock, check, update, unlock, and optional activation.
-
-**Source:** `src/handlers/class/high/handleCreateLocalTypes.ts`
-
-**Parameters:**
-- `activate_on_create` (boolean, optional (default: false)) - Activate parent class after creating. Default: false
-- `class_name` (string, required) - Parent class name (e.g., ZCL_MY_CLASS).
-- `local_types_code` (string, required) - Source code for local types.
-- `transport_request` (string, optional) - Transport request number.
-
----
-
 <a id="deleteclass-high-level-class"></a>
 #### DeleteClass (High-Level / Class)
 **Description:** Delete an ABAP class from the SAP system. Includes deletion check before actual deletion. Transport request optional for $TMP objects.
@@ -1357,7 +1292,7 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="handlercreate-high-level-compact"></a>
 #### HandlerCreate (High-Level / Compact)
-**Description:** Create operation. object_type required: PACKAGE(package_name*), DOMAIN(domain_name*), DATA_ELEMENT(data_element_name*), TABLE(table_name*), STRUCTURE(structure_name*), VIEW(view_name*), SERVICE_DEFINITION(service_definition_name*), SERVICE_BINDING(service_binding_name*), CLASS(class_name*), LOCAL_TEST_CLASS(class_name*), LOCAL_TYPES(class_name*), LOCAL_DEFINITIONS(class_name*), LOCAL_MACROS(class_name*), PROGRAM(program_name*), INTERFACE(interface_name*), FUNCTION_GROUP(function_group_name*), FUNCTION_MODULE(function_module_name*, function_group_name*), BEHAVIOR_DEFINITION(behavior_definition_name*), BEHAVIOR_IMPLEMENTATION(behavior_implementation_name*), METADATA_EXTENSION(metadata_extension_name*), UNIT_TEST(run_id*), CDS_UNIT_TEST(run_id*).
+**Description:** Create operation. object_type required: PACKAGE(package_name*), DOMAIN(domain_name*), DATA_ELEMENT(data_element_name*), TABLE(table_name*), STRUCTURE(structure_name*), VIEW(view_name*), SERVICE_DEFINITION(service_definition_name*), SERVICE_BINDING(service_binding_name*), CLASS(class_name*), PROGRAM(program_name*), INTERFACE(interface_name*), FUNCTION_GROUP(function_group_name*), FUNCTION_MODULE(function_module_name*, function_group_name*), BEHAVIOR_DEFINITION(behavior_definition_name*), BEHAVIOR_IMPLEMENTATION(behavior_implementation_name*), METADATA_EXTENSION(metadata_extension_name*), UNIT_TEST(run_id*), CDS_UNIT_TEST(run_id*).
 
 **Source:** `src/handlers/compact/high/handleHandlerCreate.ts`
 
@@ -1380,7 +1315,6 @@ Generated from code in `src/handlers/**` (not from docs).
 - `program_name` (string, optional) - ABAP program name.
 - `program_type` (string, optional) - ABAP program type.
 - `sign_exists` (boolean, optional) - Allow signed values (domain setting).
-- `source_code` (string, optional) - ABAP source code payload.
 - `transport_request` (string, optional) - Transport request id (if required by system).
 - `value_table` (string, optional) - Foreign key value table.
 
@@ -1876,16 +1810,14 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="createfunctionmodule-high-level-function"></a>
 #### CreateFunctionModule (High-Level / Function)
-**Description:** Create a new ABAP function module within an existing function group. Uses stateful session with LOCK/UNLOCK workflow for source code upload.
+**Description:** Create a new ABAP function module within an existing function group. Creates the function module in initial state. Use UpdateFunctionModule to set source code afterwards.
 
 **Source:** `src/handlers/function/high/handleCreateFunctionModule.ts`
 
 **Parameters:**
-- `activate` (boolean, optional (default: true))) - Whether to activate the function module after creation (default: true)
 - `description` (string, optional) - Optional description for the function module
 - `function_group_name` (string, required) - Parent function group name (e.g., ZTEST_FG_001)
 - `function_module_name` (string, required) - Function module name (e.g., Z_TEST_FUNCTION_001). Must follow SAP naming conventions (start with Z or Y, max 30 chars).
-- `source_code` (string, required) - ABAP source code for the function module including signature (FUNCTION name IMPORTING/EXPORTING ... ENDFUNCTION).
 - `transport_request` (string, optional) - Transport request number (e.g., E19K905635). Required for transportable packages.
 
 ---
@@ -1979,16 +1911,14 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="createinterface-high-level-interface"></a>
 #### CreateInterface (High-Level / Interface)
-**Description:** Create a new ABAP interface in SAP system with source code. Interfaces define method signatures, events, and types for implementation by classes. Uses stateful session for proper lock management.
+**Description:** Create a new ABAP interface in SAP system. Creates the interface object in initial state. Use UpdateInterface to set source code afterwards.
 
 **Source:** `src/handlers/interface/high/handleCreateInterface.ts`
 
 **Parameters:**
-- `activate` (boolean, optional) - Activate interface after creation. Default: true. Set to false for batch operations (activate multiple objects later).
 - `description` (string, optional) - Interface description. If not provided, interface_name will be used.
 - `interface_name` (string, required) - Interface name (e.g., ZIF_TEST_INTERFACE_001). Must follow SAP naming conventions (start with Z or Y).
 - `package_name` (string, required) - Package name (e.g., ZOK_LAB, $TMP for local objects)
-- `source_code` (string, optional) - Complete ABAP interface source code with INTERFACE...ENDINTERFACE section. If not provided, generates minimal template.
 - `transport_request` (string, optional) - Transport request number (e.g., E19K905635). Required for transportable packages.
 
 ---
@@ -2089,18 +2019,16 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="createprogram-high-level-program"></a>
 #### CreateProgram (High-Level / Program)
-**Description:** Create a new ABAP program (report) in SAP system with source code. Supports executable programs, includes, module pools. Uses stateful session for proper lock management.
+**Description:** Create a new ABAP program (report) in SAP system. Creates the program object in initial state. Use UpdateProgram to set source code afterwards.
 
 **Source:** `src/handlers/program/high/handleCreateProgram.ts`
 
 **Parameters:**
-- `activate` (boolean, optional) - Activate program after creation. Default: true. Set to false for batch operations (activate multiple objects later).
 - `application` (string, optional) - Application area (e.g., 
 - `description` (string, optional) - Program description. If not provided, program_name will be used.
 - `package_name` (string, required) - Package name (e.g., ZOK_LAB, $TMP for local objects)
 - `program_name` (string, required) - Program name (e.g., Z_TEST_PROGRAM_001). Must follow SAP naming conventions (start with Z or Y).
 - `program_type` (string, optional) - Program type: 
-- `source_code` (string, optional) - Complete ABAP program source code. If not provided, generates minimal template based on program_type.
 - `transport_request` (string, optional) - Transport request number (e.g., E19K905635). Required for transportable packages.
 
 ---
@@ -2372,13 +2300,11 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="createtable-high-level-table"></a>
 #### CreateTable (High-Level / Table)
-**Description:** Create a new ABAP table via the ADT API using provided DDL. Mirrors Eclipse ADT behaviour with status/check runs, lock handling, activation and verification.
+**Description:** Create a new ABAP table via the ADT API. Creates the table object in initial state. Use UpdateTable to set DDL code afterwards.
 
 **Source:** `src/handlers/table/high/handleCreateTable.ts`
 
 **Parameters:**
-- `activate` (boolean, optional) - Activate table after creation. Default: true. Set to false for batch operations (activate multiple objects later).
-- `ddl_code` (string, required) - Complete DDL code for table creation. Example: 
 - `description` (string, optional) - Table description for validation and creation.
 - `package_name` (string, required) - Package name (e.g., ZOK_LOCAL, $TMP for local objects)
 - `table_name` (string, required) - Table name (e.g., ZZ_TEST_TABLE_001). Must follow SAP naming conventions.
@@ -2446,17 +2372,15 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="createcdsunittest-high-level-unit-test"></a>
 #### CreateCdsUnitTest (High-Level / Unit Test)
-**Description:** Create a CDS unit test class with CDS validation, class template, and local test class source.
+**Description:** Create a CDS unit test class with CDS validation. Creates the test class in initial state.
 
 **Source:** `src/handlers/unit_test/high/handleCreateCdsUnitTest.ts`
 
 **Parameters:**
 - `cds_view_name` (string, required) - CDS view name to validate for unit test doubles.
 - `class_name` (string, required) - Global test class name (e.g., ZCL_CDS_TEST).
-- `class_template` (string, required) - ABAP class template used for CDS unit tests.
 - `description` (string, optional) - Optional description for the global test class.
 - `package_name` (string, required) - Package name (e.g., ZOK_TEST_PKG_01, $TMP).
-- `test_class_source` (string, required) - Local test class ABAP source code.
 - `transport_request` (string, optional) - Transport request number (required for transportable packages).
 
 ---
@@ -2617,13 +2541,11 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="createview-high-level-view"></a>
 #### CreateView (High-Level / View)
-**Description:** Create CDS View or Classic View in SAP using DDL syntax. Both types use the same API workflow, differing only in DDL content (CDS has @AbapCatalog.sqlViewName and other annotations).
+**Description:** Create CDS View or Classic View in SAP. Creates the view object in initial state. Use UpdateView to set DDL source code afterwards.
 
 **Source:** `src/handlers/view/high/handleCreateView.ts`
 
 **Parameters:**
-- `activate` (boolean, optional) - Activate after creation. Default: true.
-- `ddl_source` (string, required) - Complete DDL source code.
 - `description` (string, optional) - Optional description (defaults to view_name).
 - `package_name` (string, required) - Package name (e.g., ZOK_LAB, $TMP for local objects)
 - `transport_request` (string, optional) - Transport request number (required for transportable packages).
@@ -2715,7 +2637,7 @@ Generated from code in `src/handlers/**` (not from docs).
 - `root_entity` (string, required) - Root entity name (e.g., ZI_MY_ENTITY).
 - `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.
-- `transport_request` (string, required) - Transport request number (e.g., E19K905635). Required.
+- `transport_request` (string, optional) - Transport request number (e.g., E19K905635). Required.
 
 ---
 
@@ -3335,7 +3257,7 @@ Generated from code in `src/handlers/**` (not from docs).
 **Source:** `src/handlers/ddlx/low/handleLockMetadataExtension.ts`
 
 **Parameters:**
-- `objName` (string, optional) - MetadataExtension name (e.g., Z_MY_PROGRAM).
+- `name` (string, required) - MetadataExtension name (e.g., ZI_MY_DDLX).
 - `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.
 
@@ -3349,7 +3271,7 @@ Generated from code in `src/handlers/**` (not from docs).
 
 **Parameters:**
 - `lock_handle` (string, required) - Lock handle from LockMetadataExtension operation.
-- `objName` (string, optional) - MetadataExtension name (e.g., Z_MY_PROGRAM).
+- `name` (string, required) - MetadataExtension name (e.g., ZI_MY_DDLX).
 - `session_id` (string, required) - Session ID from LockMetadataExtension operation. Must be the same as used in LockMetadataExtension.
 - `session_state` (object, optional) - Session state from LockMetadataExtension (cookies, csrf_token, cookie_store). Required if session_id is provided.
 
@@ -3377,7 +3299,9 @@ Generated from code in `src/handlers/**` (not from docs).
 **Source:** `src/handlers/ddlx/low/handleValidateMetadataExtension.ts`
 
 **Parameters:**
-- `objName` (string, optional) - MetadataExtension name to validate (e.g., Z_MY_PROGRAM).
+- `description` (string, required) - MetadataExtension description.
+- `name` (string, required) - MetadataExtension name to validate (e.g., ZI_MY_DDLX).
+- `package_name` (string, required) - Package name (e.g., ZOK_LOCAL, $TMP for local objects).
 - `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.
 
@@ -3936,6 +3860,7 @@ Generated from code in `src/handlers/**` (not from docs).
 - `package_name` (string, required) - Package name to validate (e.g., Z_MY_PROGRAM).
 - `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.
+- `super_package` (string, required) - Parent (super) package name. The new package will be created under this package.
 
 ---
 
@@ -4471,4 +4396,4 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
-*Last updated: 2026-02-27*
+*Last updated: 2026-03-13*

package/docs/user-guide/AVAILABLE_TOOLS_COMPACT.md

@@ -52,10 +52,10 @@ Facade dispatch is deterministic by `object_type` and CRUD operation.
 | `FUNCTION_GROUP` | `create`, `get`, `update`, `delete` |
 | `FUNCTION_MODULE` | `create`, `get`, `update`, `delete` |
 | `INTERFACE` | `create`, `get`, `update`, `delete` |
-| `LOCAL_DEFINITIONS` | `create`, `get`, `update`, `delete` |
-| `LOCAL_MACROS` | `create`, `get`, `update`, `delete` |
-| `LOCAL_TEST_CLASS` | `create`, `get`, `update`, `delete` |
-| `LOCAL_TYPES` | `create`, `get`, `update`, `delete` |
+| `LOCAL_DEFINITIONS` | `get`, `update`, `delete` |
+| `LOCAL_MACROS` | `get`, `update`, `delete` |
+| `LOCAL_TEST_CLASS` | `get`, `update`, `delete` |
+| `LOCAL_TYPES` | `get`, `update`, `delete` |
 | `METADATA_EXTENSION` | `create`, `get`, `update`, `delete` |
 | `PACKAGE` | `create`, `get` |
 | `PROGRAM` | `create`, `get`, `update`, `delete` |
@@ -238,7 +238,7 @@ Preferred dedicated compact tools and minimal payloads:
 
 <a id="handlercreate-compact"></a>
 #### HandlerCreate (Compact)
-**Description:** Create operation. object_type required: PACKAGE(package_name*), DOMAIN(domain_name*), DATA_ELEMENT(data_element_name*), TABLE(table_name*), STRUCTURE(structure_name*), VIEW(view_name*), SERVICE_DEFINITION(service_definition_name*), SERVICE_BINDING(service_binding_name*), CLASS(class_name*), LOCAL_TEST_CLASS(class_name*), LOCAL_TYPES(class_name*), LOCAL_DEFINITIONS(class_name*), LOCAL_MACROS(class_name*), PROGRAM(program_name*), INTERFACE(interface_name*), FUNCTION_GROUP(function_group_name*), FUNCTION_MODULE(function_module_name*, function_group_name*), BEHAVIOR_DEFINITION(behavior_definition_name*), BEHAVIOR_IMPLEMENTATION(behavior_implementation_name*), METADATA_EXTENSION(metadata_extension_name*), UNIT_TEST(run_id*), CDS_UNIT_TEST(run_id*).
+**Description:** Create operation. object_type required: PACKAGE(package_name*), DOMAIN(domain_name*), DATA_ELEMENT(data_element_name*), TABLE(table_name*), STRUCTURE(structure_name*), VIEW(view_name*), SERVICE_DEFINITION(service_definition_name*), SERVICE_BINDING(service_binding_name*), CLASS(class_name*), PROGRAM(program_name*), INTERFACE(interface_name*), FUNCTION_GROUP(function_group_name*), FUNCTION_MODULE(function_module_name*, function_group_name*), BEHAVIOR_DEFINITION(behavior_definition_name*), BEHAVIOR_IMPLEMENTATION(behavior_implementation_name*), METADATA_EXTENSION(metadata_extension_name*), UNIT_TEST(run_id*), CDS_UNIT_TEST(run_id*).
 
 **Source:** `src/handlers/compact/high/handleHandlerCreate.ts`
 
@@ -261,7 +261,6 @@ Preferred dedicated compact tools and minimal payloads:
 - `program_name` (string, optional) - ABAP program name.
 - `program_type` (string, optional) - ABAP program type.
 - `sign_exists` (boolean, optional) - Allow signed values (domain setting).
-- `source_code` (string, optional) - ABAP source code payload.
 - `transport_request` (string, optional) - Transport request id (if required by system).
 - `value_table` (string, optional) - Foreign key value table.
 
@@ -552,4 +551,4 @@ Preferred dedicated compact tools and minimal payloads:
 
 ---
 
-*Last updated: 2026-02-27*
+*Last updated: 2026-03-13*