@mcp-abap-adt/core 6.3.1 → 6.4.1

package/docs/superpowers/plans/2026-04-17-enrich-tool-descriptions.md

@@ -1,671 +0,0 @@
-# Enrich Tool Descriptions with Operation Context
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Prepend structured Operation/Subject fields to all CRUD tool descriptions so RAG-based tool selection discovers related tools (e.g., searching "create class" also matches ReadClass and UpdateClass).
-
-**Architecture:** Each TOOL_DEFINITION.description gets a structured prefix: `Operation: {ops}. Subject: {Type}. Will be useful for {context}.` followed by a unified existing description. 52 files across 13 object types x 4 operations. No logic changes — description strings only.
-
-**Tech Stack:** TypeScript (string literals in TOOL_DEFINITION objects)
-
----
-
-## File Map
-
-All files are under `src/handlers/`. Directory names vary per object type:
-
-| Object Type | Dir (Create/Update/Activate) | Dir (Read) |
-|---|---|---|
-| Class | `class` | `class` |
-| Program | `program` | `program` |
-| Table | `table` | `table` |
-| View | `view` | `view` |
-| Domain | `domain` | `domain` |
-| DataElement | `data_element` | `data_element` |
-| Interface | `interface` | `interface` |
-| FunctionModule | `function` | `function_module` |
-| BehaviorDefinition | `behavior_definition` | `behavior_definition` |
-| MetadataExtension | `ddlx` | `metadata_extension` |
-| ServiceDefinition | `service_definition` | `service_definition` |
-| ServiceBinding | `service_binding` | `service_binding` |
-| Structure | `structure` | `structure` |
-
----
-
-## Templates
-
-### Create
-```
-Operation: Create. Subject: {Type}. Will be useful for creating {type}. Create a new ABAP {type} in SAP system. Creates the {type} object in initial state.
-```
-
-### Read (prepend to existing, keep Answers/Returns)
-```
-Operation: Read, Create, Update. Subject: {Type}. Will be useful for reading, creating, or updating {type}. {existing description}
-```
-
-### Update
-```
-Operation: Update, Create. Subject: {Type}. Will be useful for updating or creating {type}. Update {type-specific content} of an existing ABAP {type}. Locks, updates, unlocks, and optionally activates.
-```
-
-### Activate (prepend to existing)
-```
-Operation: Activate, Create, Update. Subject: {Type}. Will be useful for activating, creating, or updating {type}. {existing description}
-```
-
----
-
-## Special Cases
-
-- **UpdateDomain**: Has multiline workflow description. Replace with one-liner: `Update an existing ABAP domain. Locks, updates with provided parameters (complete replacement), unlocks, and optionally activates.`
-- **UpdateDataElement**: Has multiline workflow + type_kind docs. Replace with one-liner: `Update an existing ABAP data element. Locks, updates with provided parameters (complete replacement), unlocks, and optionally activates.`
-- **UpdateServiceBinding**: Not source code — keep specific: `Update publication state of an existing ABAP service binding.`
-- **CreateServiceBinding**: Keep specific: `Create ABAP service binding via ADT Business Services endpoint. XML is generated from high-level parameters.`
-- **CreateDomain/CreateDataElement/CreateStructure**: Remove workflow details ("lock, create, check, unlock, activate, and verify"), unify to standard template.
-- **CreateBehaviorDefinition/CreateMetadataExtension/CreateServiceDefinition**: Keep domain-specific details after the standard prefix.
-
----
-
-### Task 1: Update Class descriptions (4 files)
-
-**Files:**
-- Modify: `src/handlers/class/high/handleCreateClass.ts`
-- Modify: `src/handlers/class/readonly/handleReadClass.ts`
-- Modify: `src/handlers/class/high/handleUpdateClass.ts`
-- Modify: `src/handlers/class/low/handleActivateClass.ts`
-
-- [ ] **Step 1: Update CreateClass description**
-
-In `src/handlers/class/high/handleCreateClass.ts`, replace the description:
-```typescript
-// FROM:
-description: 'Create a new ABAP class in SAP system. Creates the class object in initial state. Use UpdateClass to set source code afterwards.',
-// TO:
-description: 'Operation: Create. Subject: Class. Will be useful for creating class. Create a new ABAP class in SAP system. Creates the class object in initial state.',
-```
-
-- [ ] **Step 2: Update ReadClass description**
-
-In `src/handlers/class/readonly/handleReadClass.ts`, replace the description:
-```typescript
-// FROM:
-description: '[read-only] Read ABAP class source code and metadata. Answers: ...',
-// TO:
-description: 'Operation: Read, Create, Update. Subject: Class. Will be useful for reading, creating, or updating class. [read-only] Read ABAP class source code and metadata. Answers: ...',
-```
-
-- [ ] **Step 3: Update UpdateClass description**
-
-In `src/handlers/class/high/handleUpdateClass.ts`, replace the description:
-```typescript
-// FROM:
-description: 'Update source code of an existing ABAP class. Locks, checks, updates, unlocks, and optionally activates.',
-// TO:
-description: 'Operation: Update, Create. Subject: Class. Will be useful for updating or creating class. Update source code of an existing ABAP class. Locks, updates, unlocks, and optionally activates.',
-```
-
-- [ ] **Step 4: Update ActivateClassLow description**
-
-In `src/handlers/class/low/handleActivateClass.ts`, replace the description:
-```typescript
-// FROM:
-description: '[low-level] Activate an ABAP class. Returns activation status and any warnings/errors. Can use session_id and session_state from GetSession to maintain the same session.',
-// TO:
-description: 'Operation: Activate, Create, Update. Subject: Class. Will be useful for activating, creating, or updating class. [low-level] Activate an ABAP class. Returns activation status and any warnings/errors. Can use session_id and session_state from GetSession to maintain the same session.',
-```
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/handlers/class/high/handleCreateClass.ts src/handlers/class/readonly/handleReadClass.ts src/handlers/class/high/handleUpdateClass.ts src/handlers/class/low/handleActivateClass.ts
-git commit -m "feat: enrich Class tool descriptions with operation context (#66)"
-```
-
----
-
-### Task 2: Update Program descriptions (4 files)
-
-**Files:**
-- Modify: `src/handlers/program/high/handleCreateProgram.ts`
-- Modify: `src/handlers/program/readonly/handleReadProgram.ts`
-- Modify: `src/handlers/program/high/handleUpdateProgram.ts`
-- Modify: `src/handlers/program/low/handleActivateProgram.ts`
-
-- [ ] **Step 1: Update CreateProgram description**
-
-```typescript
-// FROM:
-description: 'Create a new ABAP program (report) in SAP system. Creates the program object in initial state. Use UpdateProgram to set source code afterwards.',
-// TO:
-description: 'Operation: Create. Subject: Program. Will be useful for creating program. Create a new ABAP program (report) in SAP system. Creates the program object in initial state.',
-```
-
-- [ ] **Step 2: Update ReadProgram description**
-
-Prepend to existing:
-```typescript
-// PREPEND:
-'Operation: Read, Create, Update. Subject: Program. Will be useful for reading, creating, or updating program. '
-```
-
-- [ ] **Step 3: Update UpdateProgram description**
-
-```typescript
-// FROM:
-description: 'Update source code of an existing ABAP program. Locks the program, checks new code, uploads new source code, and unlocks. Optionally activates after update. Use this to modify existing programs without re-creating metadata.',
-// TO:
-description: 'Operation: Update, Create. Subject: Program. Will be useful for updating or creating program. Update source code of an existing ABAP program. Locks, updates, unlocks, and optionally activates.',
-```
-
-- [ ] **Step 4: Update ActivateProgramLow description**
-
-Prepend to existing:
-```typescript
-// PREPEND:
-'Operation: Activate, Create, Update. Subject: Program. Will be useful for activating, creating, or updating program. '
-```
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/handlers/program/high/handleCreateProgram.ts src/handlers/program/readonly/handleReadProgram.ts src/handlers/program/high/handleUpdateProgram.ts src/handlers/program/low/handleActivateProgram.ts
-git commit -m "feat: enrich Program tool descriptions with operation context (#66)"
-```
-
----
-
-### Task 3: Update Table descriptions (4 files)
-
-**Files:**
-- Modify: `src/handlers/table/high/handleCreateTable.ts`
-- Modify: `src/handlers/table/readonly/handleReadTable.ts`
-- Modify: `src/handlers/table/high/handleUpdateTable.ts`
-- Modify: `src/handlers/table/low/handleActivateTable.ts`
-
-- [ ] **Step 1: Update CreateTable description**
-
-```typescript
-// FROM:
-description: 'Create a new ABAP table via the ADT API. Creates the table object in initial state. Use UpdateTable to set DDL code afterwards.',
-// TO:
-description: 'Operation: Create. Subject: Table. Will be useful for creating table. Create a new ABAP table in SAP system. Creates the table object in initial state.',
-```
-
-- [ ] **Step 2: Update ReadTable description**
-
-Prepend: `'Operation: Read, Create, Update. Subject: Table. Will be useful for reading, creating, or updating table. '`
-
-- [ ] **Step 3: Update UpdateTable description**
-
-```typescript
-// FROM:
-description: 'Update DDL source code of an existing ABAP table. Locks the table, uploads new DDL source, and unlocks. Optionally activates after update. Use this to modify existing tables without re-creating metadata.',
-// TO:
-description: 'Operation: Update, Create. Subject: Table. Will be useful for updating or creating table. Update DDL source code of an existing ABAP table. Locks, updates, unlocks, and optionally activates.',
-```
-
-- [ ] **Step 4: Update ActivateTableLow description**
-
-Prepend: `'Operation: Activate, Create, Update. Subject: Table. Will be useful for activating, creating, or updating table. '`
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/handlers/table/high/handleCreateTable.ts src/handlers/table/readonly/handleReadTable.ts src/handlers/table/high/handleUpdateTable.ts src/handlers/table/low/handleActivateTable.ts
-git commit -m "feat: enrich Table tool descriptions with operation context (#66)"
-```
-
----
-
-### Task 4: Update View descriptions (4 files)
-
-**Files:**
-- Modify: `src/handlers/view/high/handleCreateView.ts`
-- Modify: `src/handlers/view/readonly/handleReadView.ts`
-- Modify: `src/handlers/view/high/handleUpdateView.ts`
-- Modify: `src/handlers/view/low/handleActivateView.ts`
-
-- [ ] **Step 1: Update CreateView description**
-
-```typescript
-// FROM:
-description: 'Create CDS View or Classic View in SAP. Creates the view object in initial state. Use UpdateView to set DDL source code afterwards.',
-// TO:
-description: 'Operation: Create. Subject: View. Will be useful for creating view. Create a new CDS View or Classic View in SAP system. Creates the view object in initial state.',
-```
-
-- [ ] **Step 2: Update ReadView description**
-
-Prepend: `'Operation: Read, Create, Update. Subject: View. Will be useful for reading, creating, or updating view. '`
-
-- [ ] **Step 3: Update UpdateView description**
-
-```typescript
-// FROM:
-description: 'Update DDL source code of an existing CDS View or Classic View. Locks the view, checks new code, uploads new DDL source, unlocks, and optionally activates.',
-// TO:
-description: 'Operation: Update, Create. Subject: View. Will be useful for updating or creating view. Update DDL source code of an existing CDS View or Classic View. Locks, updates, unlocks, and optionally activates.',
-```
-
-- [ ] **Step 4: Update ActivateViewLow description**
-
-Prepend: `'Operation: Activate, Create, Update. Subject: View. Will be useful for activating, creating, or updating view. '`
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/handlers/view/high/handleCreateView.ts src/handlers/view/readonly/handleReadView.ts src/handlers/view/high/handleUpdateView.ts src/handlers/view/low/handleActivateView.ts
-git commit -m "feat: enrich View tool descriptions with operation context (#66)"
-```
-
----
-
-### Task 5: Update Domain descriptions (4 files)
-
-**Files:**
-- Modify: `src/handlers/domain/high/handleCreateDomain.ts`
-- Modify: `src/handlers/domain/readonly/handleReadDomain.ts`
-- Modify: `src/handlers/domain/high/handleUpdateDomain.ts`
-- Modify: `src/handlers/domain/low/handleActivateDomain.ts`
-
-- [ ] **Step 1: Update CreateDomain description**
-
-```typescript
-// FROM:
-description: 'Create a new ABAP domain in SAP system with all required steps: lock, create, check, unlock, activate, and verify.',
-// TO:
-description: 'Operation: Create. Subject: Domain. Will be useful for creating domain. Create a new ABAP domain in SAP system. Creates the domain object in initial state.',
-```
-
-- [ ] **Step 2: Update ReadDomain description**
-
-Prepend: `'Operation: Read, Create, Update. Subject: Domain. Will be useful for reading, creating, or updating domain. '`
-
-- [ ] **Step 3: Update UpdateDomain description**
-
-Replace multiline description with:
-```typescript
-description: 'Operation: Update, Create. Subject: Domain. Will be useful for updating or creating domain. Update an existing ABAP domain. Locks, updates with provided parameters (complete replacement), unlocks, and optionally activates.',
-```
-
-- [ ] **Step 4: Update ActivateDomainLow description**
-
-Prepend: `'Operation: Activate, Create, Update. Subject: Domain. Will be useful for activating, creating, or updating domain. '`
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/handlers/domain/high/handleCreateDomain.ts src/handlers/domain/readonly/handleReadDomain.ts src/handlers/domain/high/handleUpdateDomain.ts src/handlers/domain/low/handleActivateDomain.ts
-git commit -m "feat: enrich Domain tool descriptions with operation context (#66)"
-```
-
----
-
-### Task 6: Update DataElement descriptions (4 files)
-
-**Files:**
-- Modify: `src/handlers/data_element/high/handleCreateDataElement.ts`
-- Modify: `src/handlers/data_element/readonly/handleReadDataElement.ts`
-- Modify: `src/handlers/data_element/high/handleUpdateDataElement.ts`
-- Modify: `src/handlers/data_element/low/handleActivateDataElement.ts`
-
-- [ ] **Step 1: Update CreateDataElement description**
-
-```typescript
-// FROM:
-description: 'Create a new ABAP data element in SAP system with all required steps: create, activate, and verify.',
-// TO:
-description: 'Operation: Create. Subject: DataElement. Will be useful for creating data element. Create a new ABAP data element in SAP system. Creates the data element object in initial state.',
-```
-
-- [ ] **Step 2: Update ReadDataElement description**
-
-Prepend: `'Operation: Read, Create, Update. Subject: DataElement. Will be useful for reading, creating, or updating data element. '`
-
-- [ ] **Step 3: Update UpdateDataElement description**
-
-Replace multiline description with:
-```typescript
-description: 'Operation: Update, Create. Subject: DataElement. Will be useful for updating or creating data element. Update an existing ABAP data element. Locks, updates with provided parameters (complete replacement), unlocks, and optionally activates.',
-```
-
-- [ ] **Step 4: Update ActivateDataElementLow description**
-
-Prepend: `'Operation: Activate, Create, Update. Subject: DataElement. Will be useful for activating, creating, or updating data element. '`
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/handlers/data_element/high/handleCreateDataElement.ts src/handlers/data_element/readonly/handleReadDataElement.ts src/handlers/data_element/high/handleUpdateDataElement.ts src/handlers/data_element/low/handleActivateDataElement.ts
-git commit -m "feat: enrich DataElement tool descriptions with operation context (#66)"
-```
-
----
-
-### Task 7: Update Interface descriptions (4 files)
-
-**Files:**
-- Modify: `src/handlers/interface/high/handleCreateInterface.ts`
-- Modify: `src/handlers/interface/readonly/handleReadInterface.ts`
-- Modify: `src/handlers/interface/high/handleUpdateInterface.ts`
-- Modify: `src/handlers/interface/low/handleActivateInterface.ts`
-
-- [ ] **Step 1: Update CreateInterface description**
-
-```typescript
-// FROM:
-description: 'Create a new ABAP interface in SAP system. Creates the interface object in initial state. Use UpdateInterface to set source code afterwards.',
-// TO:
-description: 'Operation: Create. Subject: Interface. Will be useful for creating interface. Create a new ABAP interface in SAP system. Creates the interface object in initial state.',
-```
-
-- [ ] **Step 2: Update ReadInterface description**
-
-Prepend: `'Operation: Read, Create, Update. Subject: Interface. Will be useful for reading, creating, or updating interface. '`
-
-- [ ] **Step 3: Update UpdateInterface description**
-
-```typescript
-// FROM:
-description: 'Update source code of an existing ABAP interface. Uses stateful session with proper lock/unlock mechanism. Lock handle and transport number are passed in URL parameters.',
-// TO:
-description: 'Operation: Update, Create. Subject: Interface. Will be useful for updating or creating interface. Update source code of an existing ABAP interface. Locks, updates, unlocks, and optionally activates.',
-```
-
-- [ ] **Step 4: Update ActivateInterfaceLow description**
-
-Prepend: `'Operation: Activate, Create, Update. Subject: Interface. Will be useful for activating, creating, or updating interface. '`
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/handlers/interface/high/handleCreateInterface.ts src/handlers/interface/readonly/handleReadInterface.ts src/handlers/interface/high/handleUpdateInterface.ts src/handlers/interface/low/handleActivateInterface.ts
-git commit -m "feat: enrich Interface tool descriptions with operation context (#66)"
-```
-
----
-
-### Task 8: Update FunctionModule descriptions (4 files)
-
-**Files:**
-- Modify: `src/handlers/function/high/handleCreateFunctionModule.ts`
-- Modify: `src/handlers/function_module/readonly/handleReadFunctionModule.ts`
-- Modify: `src/handlers/function/high/handleUpdateFunctionModule.ts`
-- Modify: `src/handlers/function/low/handleActivateFunctionModule.ts`
-
-- [ ] **Step 1: Update CreateFunctionModule description**
-
-```typescript
-// FROM:
-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.',
-// TO:
-description: 'Operation: Create. Subject: FunctionModule. Will be useful for creating function module. Create a new ABAP function module within an existing function group. Creates the function module in initial state.',
-```
-
-- [ ] **Step 2: Update ReadFunctionModule description**
-
-Prepend: `'Operation: Read, Create, Update. Subject: FunctionModule. Will be useful for reading, creating, or updating function module. '`
-
-- [ ] **Step 3: Update UpdateFunctionModule description**
-
-```typescript
-// FROM:
-description: 'Update source code of an existing ABAP function module. Locks the function module, uploads new source code, and unlocks. Optionally activates after update. Use this to modify existing function modules without re-creating metadata.',
-// TO:
-description: 'Operation: Update, Create. Subject: FunctionModule. Will be useful for updating or creating function module. Update source code of an existing ABAP function module. Locks, updates, unlocks, and optionally activates.',
-```
-
-- [ ] **Step 4: Update ActivateFunctionModuleLow description**
-
-Prepend: `'Operation: Activate, Create, Update. Subject: FunctionModule. Will be useful for activating, creating, or updating function module. '`
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/handlers/function/high/handleCreateFunctionModule.ts src/handlers/function_module/readonly/handleReadFunctionModule.ts src/handlers/function/high/handleUpdateFunctionModule.ts src/handlers/function/low/handleActivateFunctionModule.ts
-git commit -m "feat: enrich FunctionModule tool descriptions with operation context (#66)"
-```
-
----
-
-### Task 9: Update BehaviorDefinition descriptions (4 files)
-
-**Files:**
-- Modify: `src/handlers/behavior_definition/high/handleCreateBehaviorDefinition.ts`
-- Modify: `src/handlers/behavior_definition/readonly/handleReadBehaviorDefinition.ts`
-- Modify: `src/handlers/behavior_definition/high/handleUpdateBehaviorDefinition.ts`
-- Modify: `src/handlers/behavior_definition/low/handleActivateBehaviorDefinition.ts`
-
-- [ ] **Step 1: Update CreateBehaviorDefinition description**
-
-```typescript
-// FROM:
-description: 'Create a new ABAP Behavior Definition (BDEF) in SAP system. Defines RAP business object behavior: CRUD operations, validations, determinations, actions, and draft handling.',
-// TO:
-description: 'Operation: Create. Subject: BehaviorDefinition. Will be useful for creating behavior definition. Create a new ABAP Behavior Definition (BDEF) in SAP system. Creates the behavior definition object in initial state.',
-```
-
-- [ ] **Step 2: Update ReadBehaviorDefinition description**
-
-Prepend: `'Operation: Read, Create, Update. Subject: BehaviorDefinition. Will be useful for reading, creating, or updating behavior definition. '`
-
-- [ ] **Step 3: Update UpdateBehaviorDefinition description**
-
-```typescript
-// FROM:
-description: 'Update source code of an ABAP Behavior Definition (BDEF). Modifies RAP business object behavior: CRUD operations, validations, determinations, actions, and draft handling.',
-// TO:
-description: 'Operation: Update, Create. Subject: BehaviorDefinition. Will be useful for updating or creating behavior definition. Update source code of an existing ABAP Behavior Definition (BDEF). Locks, updates, unlocks, and optionally activates.',
-```
-
-- [ ] **Step 4: Update ActivateBehaviorDefinitionLow description**
-
-Prepend: `'Operation: Activate, Create, Update. Subject: BehaviorDefinition. Will be useful for activating, creating, or updating behavior definition. '`
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/handlers/behavior_definition/high/handleCreateBehaviorDefinition.ts src/handlers/behavior_definition/readonly/handleReadBehaviorDefinition.ts src/handlers/behavior_definition/high/handleUpdateBehaviorDefinition.ts src/handlers/behavior_definition/low/handleActivateBehaviorDefinition.ts
-git commit -m "feat: enrich BehaviorDefinition tool descriptions with operation context (#66)"
-```
-
----
-
-### Task 10: Update MetadataExtension descriptions (4 files)
-
-**Files:**
-- Modify: `src/handlers/ddlx/high/handleCreateMetadataExtension.ts`
-- Modify: `src/handlers/metadata_extension/readonly/handleReadMetadataExtension.ts`
-- Modify: `src/handlers/ddlx/high/handleUpdateMetadataExtension.ts`
-- Modify: `src/handlers/ddlx/low/handleActivateMetadataExtension.ts`
-
-- [ ] **Step 1: Update CreateMetadataExtension description**
-
-```typescript
-// FROM:
-description: 'Create a new ABAP Metadata Extension (DDLX) in SAP system. Defines Fiori UI annotations, field labels, search help, and list/object page layout for CDS views.',
-// TO:
-description: 'Operation: Create. Subject: MetadataExtension. Will be useful for creating metadata extension. Create a new ABAP Metadata Extension (DDLX) in SAP system. Creates the metadata extension object in initial state.',
-```
-
-- [ ] **Step 2: Update ReadMetadataExtension description**
-
-Prepend: `'Operation: Read, Create, Update. Subject: MetadataExtension. Will be useful for reading, creating, or updating metadata extension. '`
-
-- [ ] **Step 3: Update UpdateMetadataExtension description**
-
-```typescript
-// FROM:
-description: 'Update source code of an ABAP Metadata Extension (DDLX). Modifies Fiori UI annotations, field labels, search help, and list/object page layout for CDS views.',
-// TO:
-description: 'Operation: Update, Create. Subject: MetadataExtension. Will be useful for updating or creating metadata extension. Update source code of an existing ABAP Metadata Extension (DDLX). Locks, updates, unlocks, and optionally activates.',
-```
-
-- [ ] **Step 4: Update ActivateMetadataExtensionLow description**
-
-Prepend: `'Operation: Activate, Create, Update. Subject: MetadataExtension. Will be useful for activating, creating, or updating metadata extension. '`
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/handlers/ddlx/high/handleCreateMetadataExtension.ts src/handlers/metadata_extension/readonly/handleReadMetadataExtension.ts src/handlers/ddlx/high/handleUpdateMetadataExtension.ts src/handlers/ddlx/low/handleActivateMetadataExtension.ts
-git commit -m "feat: enrich MetadataExtension tool descriptions with operation context (#66)"
-```
-
----
-
-### Task 11: Update ServiceDefinition descriptions (4 files)
-
-**Files:**
-- Modify: `src/handlers/service_definition/high/handleCreateServiceDefinition.ts`
-- Modify: `src/handlers/service_definition/readonly/handleReadServiceDefinition.ts`
-- Modify: `src/handlers/service_definition/high/handleUpdateServiceDefinition.ts`
-- Modify: `src/handlers/service_definition/low/handleActivateServiceDefinition.ts`
-
-- [ ] **Step 1: Update CreateServiceDefinition description**
-
-```typescript
-// FROM:
-description: 'Create a new ABAP service definition for OData services. Service definitions define the structure and behavior of OData services. Uses stateful session for proper lock management.',
-// TO:
-description: 'Operation: Create. Subject: ServiceDefinition. Will be useful for creating service definition. Create a new ABAP service definition in SAP system. Creates the service definition object in initial state.',
-```
-
-- [ ] **Step 2: Update ReadServiceDefinition description**
-
-Prepend: `'Operation: Read, Create, Update. Subject: ServiceDefinition. Will be useful for reading, creating, or updating service definition. '`
-
-- [ ] **Step 3: Update UpdateServiceDefinition description**
-
-```typescript
-// FROM:
-description: 'Update source code of an existing ABAP service definition. Uses stateful session with proper lock/unlock mechanism.',
-// TO:
-description: 'Operation: Update, Create. Subject: ServiceDefinition. Will be useful for updating or creating service definition. Update source code of an existing ABAP service definition. Locks, updates, unlocks, and optionally activates.',
-```
-
-- [ ] **Step 4: Update ActivateServiceDefinitionLow description**
-
-Prepend: `'Operation: Activate, Create, Update. Subject: ServiceDefinition. Will be useful for activating, creating, or updating service definition. '`
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/handlers/service_definition/high/handleCreateServiceDefinition.ts src/handlers/service_definition/readonly/handleReadServiceDefinition.ts src/handlers/service_definition/high/handleUpdateServiceDefinition.ts src/handlers/service_definition/low/handleActivateServiceDefinition.ts
-git commit -m "feat: enrich ServiceDefinition tool descriptions with operation context (#66)"
-```
-
----
-
-### Task 12: Update ServiceBinding descriptions (4 files)
-
-**Files:**
-- Modify: `src/handlers/service_binding/high/handleCreateServiceBinding.ts`
-- Modify: `src/handlers/service_binding/readonly/handleReadServiceBinding.ts`
-- Modify: `src/handlers/service_binding/high/handleUpdateServiceBinding.ts`
-- Modify: `src/handlers/service_binding/low/handleActivateServiceBinding.ts`
-
-- [ ] **Step 1: Update CreateServiceBinding description**
-
-```typescript
-// FROM:
-description: 'Create ABAP service binding via ADT Business Services endpoint. XML is generated from high-level parameters.',
-// TO:
-description: 'Operation: Create. Subject: ServiceBinding. Will be useful for creating service binding. Create a new ABAP service binding in SAP system. Creates the service binding object in initial state.',
-```
-
-- [ ] **Step 2: Update ReadServiceBinding description**
-
-Prepend: `'Operation: Read, Create, Update. Subject: ServiceBinding. Will be useful for reading, creating, or updating service binding. '`
-
-- [ ] **Step 3: Update UpdateServiceBinding description**
-
-```typescript
-// FROM:
-description: 'Update publication state for ABAP service binding via AdtServiceBinding workflow.',
-// TO:
-description: 'Operation: Update, Create. Subject: ServiceBinding. Will be useful for updating or creating service binding. Update publication state of an existing ABAP service binding.',
-```
-
-- [ ] **Step 4: Update ActivateServiceBindingLow description**
-
-Prepend: `'Operation: Activate, Create, Update. Subject: ServiceBinding. Will be useful for activating, creating, or updating service binding. '`
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/handlers/service_binding/high/handleCreateServiceBinding.ts src/handlers/service_binding/readonly/handleReadServiceBinding.ts src/handlers/service_binding/high/handleUpdateServiceBinding.ts src/handlers/service_binding/low/handleActivateServiceBinding.ts
-git commit -m "feat: enrich ServiceBinding tool descriptions with operation context (#66)"
-```
-
----
-
-### Task 13: Update Structure descriptions (4 files)
-
-**Files:**
-- Modify: `src/handlers/structure/high/handleCreateStructure.ts`
-- Modify: `src/handlers/structure/readonly/handleReadStructure.ts`
-- Modify: `src/handlers/structure/high/handleUpdateStructure.ts`
-- Modify: `src/handlers/structure/low/handleActivateStructure.ts`
-
-- [ ] **Step 1: Update CreateStructure description**
-
-```typescript
-// FROM:
-description: 'Create a new ABAP structure in SAP system with fields and type references. Includes create, activate, and verify steps.',
-// TO:
-description: 'Operation: Create. Subject: Structure. Will be useful for creating structure. Create a new ABAP structure in SAP system. Creates the structure object in initial state.',
-```
-
-- [ ] **Step 2: Update ReadStructure description**
-
-Prepend: `'Operation: Read, Create, Update. Subject: Structure. Will be useful for reading, creating, or updating structure. '`
-
-- [ ] **Step 3: Update UpdateStructure description**
-
-```typescript
-// FROM:
-description: 'Update DDL source code of an existing ABAP structure. Locks the structure, uploads new DDL source, and unlocks. Optionally activates after update. Use this to modify existing structures without re-creating metadata.',
-// TO:
-description: 'Operation: Update, Create. Subject: Structure. Will be useful for updating or creating structure. Update DDL source code of an existing ABAP structure. Locks, updates, unlocks, and optionally activates.',
-```
-
-- [ ] **Step 4: Update ActivateStructureLow description**
-
-Prepend: `'Operation: Activate, Create, Update. Subject: Structure. Will be useful for activating, creating, or updating structure. '`
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/handlers/structure/high/handleCreateStructure.ts src/handlers/structure/readonly/handleReadStructure.ts src/handlers/structure/high/handleUpdateStructure.ts src/handlers/structure/low/handleActivateStructure.ts
-git commit -m "feat: enrich Structure tool descriptions with operation context (#66)"
-```
-
----
-
-### Task 14: Verify build passes
-
-- [ ] **Step 1: Run TypeScript build**
-
-```bash
-npm run build
-```
-
-Expected: No errors. Only description strings changed — no type or logic changes.
-
-- [ ] **Step 2: Run linter**
-
-```bash
-npm run lint
-```
-
-Expected: No new warnings/errors.
-
-- [ ] **Step 3: Verify description format with grep**
-
-```bash
-grep -r "Operation:" src/handlers/*/high/handleCreate*.ts src/handlers/*/high/handleUpdate*.ts src/handlers/*/readonly/handleRead*.ts src/handlers/*/low/handleActivate*.ts | wc -l
-```
-
-Expected: 52 matches (13 types x 4 operations).