sapbuddy-dsh 0.0.6 → 0.0.8

package/skills/sap-abap-skills/references/sap-luw.md

@@ -1,203 +1,203 @@
-# SAP Logical Unit of Work (LUW) - Complete Reference
-
-**Source**: [https://github.com/SAP-samples/abap-cheat-sheets/blob/main/17_SAP_LUW.md](https://github.com/SAP-samples/abap-cheat-sheets/blob/main/17_SAP_LUW.md)
-
----
-
-## Overview
-
-SAP LUW ensures transactional consistency through all-or-nothing commits: either all changes commit together or all rollback.
-
----
-
-## COMMIT and ROLLBACK
-
-### COMMIT WORK
-
-```abap
-COMMIT WORK.              " Asynchronous - returns immediately
-COMMIT WORK AND WAIT.     " Synchronous - waits for completion
-```
-
-Effects:
-- Closes current SAP LUW, opens new one
-- Commits all change requests
-- Processes registered update function modules
-- Triggers database commit
-
-### ROLLBACK WORK
-
-```abap
-ROLLBACK WORK.
-```
-
-Effects:
-- Closes current SAP LUW, opens new one
-- Undoes all changes within current SAP LUW
-- Removes previous registrations
-- Triggers database rollback
-
----
-
-## Update Function Modules
-
-### Calling Update Functions
-
-```abap
-" Asynchronous (default)
-CALL FUNCTION 'Z_UPDATE_FUNC' IN UPDATE TASK
-  EXPORTING values = data.
-
-COMMIT WORK.  " Returns immediately
-
-" Synchronous
-CALL FUNCTION 'Z_UPDATE_FUNC' IN UPDATE TASK
-  EXPORTING values = data.
-
-COMMIT WORK AND WAIT.  " Waits for completion
-
-" Local update
-SET UPDATE TASK LOCAL.
-
-CALL FUNCTION 'Z_UPDATE_FUNC' IN UPDATE TASK
-  EXPORTING values = data.
-
-COMMIT WORK.  " Executes immediately in current work process
-```
-
-### Update Function Implementation
-
-```abap
-FUNCTION z_update_func
-  IMPORTING
-    VALUE(values) TYPE some_dbtab.
-
-  MODIFY some_dbtab FROM @values.
-
-ENDFUNCTION.
-```
-
----
-
-## Background RFC (bgRFC)
-
-```abap
-CALL FUNCTION 'Z_REMOTE_FUNC' IN BACKGROUND UNIT
-  EXPORTING param1 = value1.
-```
-
-Enables asynchronous execution in same or different ABAP systems.
-
----
-
-## Subroutines (Deprecated)
-
-```abap
-" Register for commit
-PERFORM some_subroutine ON COMMIT.
-
-" Register for rollback
-PERFORM some_subroutine ON ROLLBACK.
-
-" Data transfer via ABAP memory
-EXPORT data_var TO MEMORY ID 'KEY'.
-IMPORT data_var FROM MEMORY ID 'KEY'.
-```
-
----
-
-## Implicit Database Commits
-
-Triggered automatically by:
-- Dialog step completion (dynpro PAI/PBO)
-- Synchronous/asynchronous RFC calls
-- HTTP/HTTPS/SMTP communication
-- WAIT statements
-- Sending messages (error, information, warning)
-
----
-
-## ABAP Cloud Behavior
-
-```abap
-" Both behave identically in ABAP Cloud
-COMMIT WORK.
-COMMIT WORK AND WAIT.
-```
-
-In ABAP Cloud:
-- Local updates always enforced implicitly
-- Updates occur in same work process
-- Always synchronous
-
----
-
-## RAP Integration
-
-```abap
-" RAP-specific commit
-COMMIT ENTITIES.        " Implicitly triggers COMMIT WORK
-
-" RAP-specific rollback
-ROLLBACK ENTITIES.      " Resets all changes
-```
-
----
-
-## Controlled SAP LUW
-
-Enhanced transactional phase management:
-
-```abap
-" Activate modify phase
-cl_abap_tx=>modify( ).
-
-" Database modifications NOT allowed here
-" Would throw BEHAVIOR_ILLEGAL_STMT_IN_CALL
-
-" Activate save phase
-cl_abap_tx=>save( ).
-
-" Database modifications allowed here
-MODIFY zdemo_table FROM TABLE @itab.
-```
-
----
-
-## Transactional Phases
-
-| Phase | Database Modifications |
-|-------|----------------------|
-| Modify | Not allowed |
-| Save | Allowed |
-
----
-
-## Lock Objects
-
-```abap
-" Enqueue (lock)
-CALL FUNCTION 'ENQUEUE_EZLOCK'
-  EXPORTING
-    mode_table = 'E'
-    key = value
-  EXCEPTIONS
-    foreign_lock = 1.
-
-" Dequeue (unlock)
-CALL FUNCTION 'DEQUEUE_EZLOCK'
-  EXPORTING
-    mode_table = 'E'
-    key = value.
-```
-
----
-
-## Best Practices
-
-1. **Use COMMIT WORK AND WAIT** when immediate confirmation needed
-2. **Avoid implicit commits** in transaction-critical code
-3. **Use RAP** for modern transactional scenarios
-4. **Bundle modifications** for consistency
-5. **Handle locks** appropriately
-6. **Test rollback scenarios** thoroughly
+# SAP Logical Unit of Work (LUW) - Complete Reference
+
+**Source**: [https://github.com/SAP-samples/abap-cheat-sheets/blob/main/17_SAP_LUW.md](https://github.com/SAP-samples/abap-cheat-sheets/blob/main/17_SAP_LUW.md)
+
+---
+
+## Overview
+
+SAP LUW ensures transactional consistency through all-or-nothing commits: either all changes commit together or all rollback.
+
+---
+
+## COMMIT and ROLLBACK
+
+### COMMIT WORK
+
+```abap
+COMMIT WORK.              " Asynchronous - returns immediately
+COMMIT WORK AND WAIT.     " Synchronous - waits for completion
+```
+
+Effects:
+- Closes current SAP LUW, opens new one
+- Commits all change requests
+- Processes registered update function modules
+- Triggers database commit
+
+### ROLLBACK WORK
+
+```abap
+ROLLBACK WORK.
+```
+
+Effects:
+- Closes current SAP LUW, opens new one
+- Undoes all changes within current SAP LUW
+- Removes previous registrations
+- Triggers database rollback
+
+---
+
+## Update Function Modules
+
+### Calling Update Functions
+
+```abap
+" Asynchronous (default)
+CALL FUNCTION 'Z_UPDATE_FUNC' IN UPDATE TASK
+  EXPORTING values = data.
+
+COMMIT WORK.  " Returns immediately
+
+" Synchronous
+CALL FUNCTION 'Z_UPDATE_FUNC' IN UPDATE TASK
+  EXPORTING values = data.
+
+COMMIT WORK AND WAIT.  " Waits for completion
+
+" Local update
+SET UPDATE TASK LOCAL.
+
+CALL FUNCTION 'Z_UPDATE_FUNC' IN UPDATE TASK
+  EXPORTING values = data.
+
+COMMIT WORK.  " Executes immediately in current work process
+```
+
+### Update Function Implementation
+
+```abap
+FUNCTION z_update_func
+  IMPORTING
+    VALUE(values) TYPE some_dbtab.
+
+  MODIFY some_dbtab FROM @values.
+
+ENDFUNCTION.
+```
+
+---
+
+## Background RFC (bgRFC)
+
+```abap
+CALL FUNCTION 'Z_REMOTE_FUNC' IN BACKGROUND UNIT
+  EXPORTING param1 = value1.
+```
+
+Enables asynchronous execution in same or different ABAP systems.
+
+---
+
+## Subroutines (Deprecated)
+
+```abap
+" Register for commit
+PERFORM some_subroutine ON COMMIT.
+
+" Register for rollback
+PERFORM some_subroutine ON ROLLBACK.
+
+" Data transfer via ABAP memory
+EXPORT data_var TO MEMORY ID 'KEY'.
+IMPORT data_var FROM MEMORY ID 'KEY'.
+```
+
+---
+
+## Implicit Database Commits
+
+Triggered automatically by:
+- Dialog step completion (dynpro PAI/PBO)
+- Synchronous/asynchronous RFC calls
+- HTTP/HTTPS/SMTP communication
+- WAIT statements
+- Sending messages (error, information, warning)
+
+---
+
+## ABAP Cloud Behavior
+
+```abap
+" Both behave identically in ABAP Cloud
+COMMIT WORK.
+COMMIT WORK AND WAIT.
+```
+
+In ABAP Cloud:
+- Local updates always enforced implicitly
+- Updates occur in same work process
+- Always synchronous
+
+---
+
+## RAP Integration
+
+```abap
+" RAP-specific commit
+COMMIT ENTITIES.        " Implicitly triggers COMMIT WORK
+
+" RAP-specific rollback
+ROLLBACK ENTITIES.      " Resets all changes
+```
+
+---
+
+## Controlled SAP LUW
+
+Enhanced transactional phase management:
+
+```abap
+" Activate modify phase
+cl_abap_tx=>modify( ).
+
+" Database modifications NOT allowed here
+" Would throw BEHAVIOR_ILLEGAL_STMT_IN_CALL
+
+" Activate save phase
+cl_abap_tx=>save( ).
+
+" Database modifications allowed here
+MODIFY zdemo_table FROM TABLE @itab.
+```
+
+---
+
+## Transactional Phases
+
+| Phase | Database Modifications |
+|-------|----------------------|
+| Modify | Not allowed |
+| Save | Allowed |
+
+---
+
+## Lock Objects
+
+```abap
+" Enqueue (lock)
+CALL FUNCTION 'ENQUEUE_EZLOCK'
+  EXPORTING
+    mode_table = 'E'
+    key = value
+  EXCEPTIONS
+    foreign_lock = 1.
+
+" Dequeue (unlock)
+CALL FUNCTION 'DEQUEUE_EZLOCK'
+  EXPORTING
+    mode_table = 'E'
+    key = value.
+```
+
+---
+
+## Best Practices
+
+1. **Use COMMIT WORK AND WAIT** when immediate confirmation needed
+2. **Avoid implicit commits** in transaction-critical code
+3. **Use RAP** for modern transactional scenarios
+4. **Bundle modifications** for consistency
+5. **Handle locks** appropriately
+6. **Test rollback scenarios** thoroughly

package/skills/sap-abap-skills/references/skill-reference-guide.md

@@ -1,98 +1,98 @@
-# SAP ABAP Skill Reference Guide
-
-This document provides a comprehensive guide to all reference materials available for the SAP ABAP skill.
-
-## Core Language References
-
-### Data Types and Declarations
-- **Internal Tables**: `references/internal-tables.md` - Complete table operations, keys, grouping, table expressions
-- **ABAP Dictionary**: `references/abap-dictionary.md` - Data elements, domains, structures, table types
-- **Date and Time**: `references/date-time.md` - Type d, t, utclong, timestamps, XCO library
-- **Numeric Operations**: `references/numeric-operations.md` - Math functions, big integers, decimal floating points
-- **Bits and Bytes**: `references/bits-bytes.md` - Binary operations, CASTING, bit manipulation
-- **String Processing**: `references/string-processing.md` - String functions, templates, FIND, REPLACE, regex
-
-### Program Flow and Control
-- **Program Flow**: `references/program-flow.md` - IF, CASE, LOOP, DO, WHILE, control statements
-- **Constructor Expressions**: `references/constructor-expressions.md` - VALUE, NEW, CONV, CORRESPONDING, COND, REDUCE
-- **Built-in Functions**: `references/builtin-functions.md` - String, numeric, table, logical functions
-
-### ABAP SQL and Database Access
-- **ABAP SQL**: `references/abap-sql.md` - SELECT, INSERT, UPDATE, DELETE, JOINs, CTEs, aggregate functions
-- **SQL Hierarchies**: `references/sql-hierarchies.md` - CTE hierarchies, HIERARCHY descendants/ancestors
-- **WHERE Conditions**: `references/where-conditions.md` - SQL and table WHERE patterns, operators
-- **SAP LUW**: `references/sap-luw.md` - Logical Unit of Work, COMMIT, ROLLBACK, database transactions
-
-### Object-Oriented Programming
-- **Object Orientation**: `references/object-orientation.md` - Classes, interfaces, inheritance, polymorphism
-- **Design Patterns**: `references/design-patterns.md` - Factory, Singleton, Strategy, Observer patterns
-- **Dynamic Programming**: `references/dynamic-programming.md` - RTTI, RTTC, field symbols, data references
-
-### Modern ABAP and RAP
-- **RAP and EML**: `references/rap-eml.md` - RESTful Application Programming Model, EML statements
-- **CDS Views**: `references/cds-views.md` - Core Data Services, view entities, associations
-- **ABAP Cloud**: `references/cloud-development.md` - Cloud-ready development, released APIs
-- **Released Classes**: `references/released-classes.md` - Released API catalog for ABAP Cloud
-- **AMDP**: `references/amdp.md` - ABAP Managed Database Procedures, SQLScript integration
-
-### Testing and Error Handling
-- **Unit Testing**: `references/unit-testing.md` - ABAP Unit framework, test classes, assertions
-- **Exception Handling**: `references/exceptions.md` - TRY/CATCH, exception classes, error handling
-- **Authorization**: `references/authorization.md` - AUTHORITY-CHECK, DCL, access control
-
-### Performance and Optimization
-- **Performance**: `references/performance.md` - Database access optimization, internal table performance
-- **Table Grouping**: `references/table-grouping.md` - GROUP BY loops, aggregation patterns
-
-### Data Exchange and Integration
-- **XML/JSON Processing**: `references/xml-json.md` - iXML, sXML, CALL TRANSFORMATION
-- **Generative AI**: `references/generative-ai.md` - AI SDK, LLM integration, Joule
-
-## Source Documentation
-
-All content based on official SAP ABAP Cheat Sheets:
-- **Repository**: [https://github.com/SAP-samples/abap-cheat-sheets](https://github.com/SAP-samples/abap-cheat-sheets)
-- **SAP Help**: [https://help.sap.com/doc/abapdocu_latest_index_htm/latest/en-US/index.htm](https://help.sap.com/doc/abapdocu_latest_index_htm/latest/en-US/index.htm)
-
-## How to Use This Guide
-
-1. **Quick Reference**: Look at SKILL.md for commonly used patterns
-2. **Detailed Information**: Navigate to specific reference files using this guide
-3. **Examples**: Each reference file contains practical code examples
-4. **Best Practices**: All references include performance tips and common pitfalls
-
-## Skill Structure
-
-```
-sap-abap/
-├── SKILL.md                        # Quick reference and common patterns
-├── README.md                       # Skill overview and auto-trigger keywords
-└── references/                     # Detailed reference files (28 files)
-    ├── skill-reference-guide.md    # This file - complete guide to references
-    ├── internal-tables.md         # Table operations (562 lines)
-    ├── abap-sql.md                # SQL reference (563 lines)
-    ├── string-processing.md       # String functions (563 lines)
-    ... and 25 more specialized references
-```
-
-## Last Updated
-
-- **Skill Version**: 1.1.0
-- **Last Updated**: 2026-04-02
-- **ABAP Release**: 7.40 SP08+ / 7.50+ / ABAP Cloud
-- **Reference Files**: 28
-- **Total Lines**: ~25,000 across all reference files
-
-## Version Compatibility
-
-This skill targets ABAP 7.40 SP08 and above. Features requiring higher releases are
-annotated in individual reference files. Key boundaries:
-
-- **7.40 SP02**: Inline declarations, constructor expressions, table expressions, string templates
-- **7.40 SP05**: `@` host variables, comma syntax, SQL expressions, `CORRESPONDING`, `LET`, `FOR`
-- **7.40 SP08**: `REDUCE`, `FILTER`, `BASE`, `GROUP BY` for internal tables, CDS parameters
-- **7.50**: `FINAL(...)`, host expressions `@(...)`, `UNION`, `IS INSTANCE OF`, CDS table functions
-- **7.51**: CTEs (`WITH`), `OFFSET`, `UPPER`/`LOWER` in SQL, enumerated types
-- **7.52**: `FROM @itab`, `WITH PRIVILEGED ACCESS`, virtual sort
-
-See the Version Compatibility table in SKILL.md for the complete feature matrix.
+# SAP ABAP Skill Reference Guide
+
+This document provides a comprehensive guide to all reference materials available for the SAP ABAP skill.
+
+## Core Language References
+
+### Data Types and Declarations
+- **Internal Tables**: `references/internal-tables.md` - Complete table operations, keys, grouping, table expressions
+- **ABAP Dictionary**: `references/abap-dictionary.md` - Data elements, domains, structures, table types
+- **Date and Time**: `references/date-time.md` - Type d, t, utclong, timestamps, XCO library
+- **Numeric Operations**: `references/numeric-operations.md` - Math functions, big integers, decimal floating points
+- **Bits and Bytes**: `references/bits-bytes.md` - Binary operations, CASTING, bit manipulation
+- **String Processing**: `references/string-processing.md` - String functions, templates, FIND, REPLACE, regex
+
+### Program Flow and Control
+- **Program Flow**: `references/program-flow.md` - IF, CASE, LOOP, DO, WHILE, control statements
+- **Constructor Expressions**: `references/constructor-expressions.md` - VALUE, NEW, CONV, CORRESPONDING, COND, REDUCE
+- **Built-in Functions**: `references/builtin-functions.md` - String, numeric, table, logical functions
+
+### ABAP SQL and Database Access
+- **ABAP SQL**: `references/abap-sql.md` - SELECT, INSERT, UPDATE, DELETE, JOINs, CTEs, aggregate functions
+- **SQL Hierarchies**: `references/sql-hierarchies.md` - CTE hierarchies, HIERARCHY descendants/ancestors
+- **WHERE Conditions**: `references/where-conditions.md` - SQL and table WHERE patterns, operators
+- **SAP LUW**: `references/sap-luw.md` - Logical Unit of Work, COMMIT, ROLLBACK, database transactions
+
+### Object-Oriented Programming
+- **Object Orientation**: `references/object-orientation.md` - Classes, interfaces, inheritance, polymorphism
+- **Design Patterns**: `references/design-patterns.md` - Factory, Singleton, Strategy, Observer patterns
+- **Dynamic Programming**: `references/dynamic-programming.md` - RTTI, RTTC, field symbols, data references
+
+### Modern ABAP and RAP
+- **RAP and EML**: `references/rap-eml.md` - RESTful Application Programming Model, EML statements
+- **CDS Views**: `references/cds-views.md` - Core Data Services, view entities, associations
+- **ABAP Cloud**: `references/cloud-development.md` - Cloud-ready development, released APIs
+- **Released Classes**: `references/released-classes.md` - Released API catalog for ABAP Cloud
+- **AMDP**: `references/amdp.md` - ABAP Managed Database Procedures, SQLScript integration
+
+### Testing and Error Handling
+- **Unit Testing**: `references/unit-testing.md` - ABAP Unit framework, test classes, assertions
+- **Exception Handling**: `references/exceptions.md` - TRY/CATCH, exception classes, error handling
+- **Authorization**: `references/authorization.md` - AUTHORITY-CHECK, DCL, access control
+
+### Performance and Optimization
+- **Performance**: `references/performance.md` - Database access optimization, internal table performance
+- **Table Grouping**: `references/table-grouping.md` - GROUP BY loops, aggregation patterns
+
+### Data Exchange and Integration
+- **XML/JSON Processing**: `references/xml-json.md` - iXML, sXML, CALL TRANSFORMATION
+- **Generative AI**: `references/generative-ai.md` - AI SDK, LLM integration, Joule
+
+## Source Documentation
+
+All content based on official SAP ABAP Cheat Sheets:
+- **Repository**: [https://github.com/SAP-samples/abap-cheat-sheets](https://github.com/SAP-samples/abap-cheat-sheets)
+- **SAP Help**: [https://help.sap.com/doc/abapdocu_latest_index_htm/latest/en-US/index.htm](https://help.sap.com/doc/abapdocu_latest_index_htm/latest/en-US/index.htm)
+
+## How to Use This Guide
+
+1. **Quick Reference**: Look at SKILL.md for commonly used patterns
+2. **Detailed Information**: Navigate to specific reference files using this guide
+3. **Examples**: Each reference file contains practical code examples
+4. **Best Practices**: All references include performance tips and common pitfalls
+
+## Skill Structure
+
+```
+sap-abap/
+├── SKILL.md                        # Quick reference and common patterns
+├── README.md                       # Skill overview and auto-trigger keywords
+└── references/                     # Detailed reference files (28 files)
+    ├── skill-reference-guide.md    # This file - complete guide to references
+    ├── internal-tables.md         # Table operations (562 lines)
+    ├── abap-sql.md                # SQL reference (563 lines)
+    ├── string-processing.md       # String functions (563 lines)
+    ... and 25 more specialized references
+```
+
+## Last Updated
+
+- **Skill Version**: 1.1.0
+- **Last Updated**: 2026-04-02
+- **ABAP Release**: 7.40 SP08+ / 7.50+ / ABAP Cloud
+- **Reference Files**: 28
+- **Total Lines**: ~25,000 across all reference files
+
+## Version Compatibility
+
+This skill targets ABAP 7.40 SP08 and above. Features requiring higher releases are
+annotated in individual reference files. Key boundaries:
+
+- **7.40 SP02**: Inline declarations, constructor expressions, table expressions, string templates
+- **7.40 SP05**: `@` host variables, comma syntax, SQL expressions, `CORRESPONDING`, `LET`, `FOR`
+- **7.40 SP08**: `REDUCE`, `FILTER`, `BASE`, `GROUP BY` for internal tables, CDS parameters
+- **7.50**: `FINAL(...)`, host expressions `@(...)`, `UNION`, `IS INSTANCE OF`, CDS table functions
+- **7.51**: CTEs (`WITH`), `OFFSET`, `UPPER`/`LOWER` in SQL, enumerated types
+- **7.52**: `FROM @itab`, `WITH PRIVILEGED ACCESS`, virtual sort
+
+See the Version Compatibility table in SKILL.md for the complete feature matrix.